Creare un insieme di credenziali di Backup di Azure con l'API REST

Questo articolo descrive come creare una cassetta di backup usando l'API REST. È anche possibile creare un caveau di backup usando il portale di Azure.

La nuova piattaforma di protezione dati di Backup di Azure offre funzionalità avanzate per il backup e il ripristino per carichi di lavoro più recenti, ad esempio BLOB negli account di archiviazione, nel disco gestito e nella piattaforma PaaS del server PostgreSQL. Punta a ridurre al minimo il sovraccarico gestionale semplificando l'organizzazione dei backup. Un "insieme di credenziali di backup" rappresenta le fondamenta della piattaforma di protezione dati ed è diverso dall'insieme di credenziali di "Servizi di ripristino".

I passaggi per creare un insieme di credenziali di Backup di Azure con l'API REST sono descritti nella documentazione relativa alla creazione dell'insieme di credenziali dell'API REST. Usare questo documento come riferimento per creare un insieme di credenziali denominato testBkpVault in West US e nel gruppo di risorse TestBkpVaultRG.

Per creare o aggiornare un insieme di credenziali di Backup di Azure, usare l'operazione PUT seguente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-01

Creare una richiesta

Per creare la richiesta PUT è necessario il {subscription-id}. Se sono disponibili più sottoscrizioni, vedere Uso di più sottoscrizioni. Si definiscono {resourceGroupName} e {vaultName} per le risorse, insieme al parametro api-version. Questo articolo usa api-version=2021-01-01.

Gli argomenti seguenti sono obbligatori:

Per altre informazioni su come creare la richiesta, vedere Componenti di una richiesta/risposta dell'API REST.

Creare il corpo della richiesta

Per compilare un corpo della richiesta vengono usate le definizioni comuni seguenti:

Si noti che il nome dell'insieme di credenziali e il nome del gruppo di risorse vengono specificati nell'URI PUT. Il corpo della richiesta definisce la località.

Esempio di corpo della richiesta

Il corpo di esempio riportato di seguito viene usato per creare un insieme di credenziali in "Stati Uniti occidentali". Specificare la località.

{
  "location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "None"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

Se si vuole creare un insieme di credenziali di backup e generare anche un'identità assegnata dal sistema, è necessario specificare il corpo della richiesta seguente.

{
  "location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "systemAssigned"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

Risposte

La creazione di un insieme di credenziali di backup è un'operazione asincrona. Ciò significa che l'operazione consente di creare un'altra operazione che deve essere registrata separatamente. Esistono due risposte che determinano il successo dell'operazione di creazione o aggiornamento di un insieme di credenziali di Backup:

Per altre informazioni sulle risposte dell'API REST, vedere Process the response message (Elaborare il messaggio di risposta).

Risposta di esempio

Una risposta condensata 201 Creata dall'esempio di corpo della richiesta precedente mostra che è stato assegnato un id e che provisioningState è Succeeded:

{
    "eTag": null,
    "id": "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/TestBkpVaultRG/providers/Microsoft.DataProtection/BackupVaults/testBkpVault",
    "identity": {
      "principalId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "tenantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "SystemAssigned"
    },
    "location": "westUS",
    "name": "testBkpVault",
    "properties": {
      "provisioningState": "Succeeded",
      "storageSettings": [
        {
          "datastoreType": "VaultStore",
          "type": "GeoRedundant"
        }
      ]
    },
    "resourceGroup": "TestBkpVaultRG",
    "systemData": null,
    "tags": {},
    "type": "Microsoft.DataProtection/backupVaults"
  }

Passaggi successivi

Creare un criterio di backup per il backup dei BLOB in questo insieme di credenziali.

Per altre informazioni sulle API REST di Azure, vedere i documenti seguenti:

• API REST del provider di protezione dei dati di Azure
• Introduzione all'API REST di Azure