Creare Backup di Azure insieme di credenziali usando l'API REST

  • Articolo

Backup di Azure nuova piattaforma protezione dati 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. Mira a ridurre al minimo il sovraccarico di gestione, semplificando l'organizzazione dei backup. Un insieme di credenziali di backup è l'elemento fondamentale della piattaforma protezione dati e questo è diverso dall'insieme di credenziali dei servizi di ripristino.

I passaggi per creare un insieme di credenziali Backup di Azure usando l'API REST sono descritti nella documentazione dell'API REST dell'insieme di credenziali. Verrà usato questo documento come riferimento per creare un insieme di credenziali denominato "testBkpVault" in "Stati Uniti occidentali" e nel gruppo di risorse "TestBkpVaultRG".

Per creare o aggiornare un insieme di credenziali 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 presenti 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:

Intestazione della richiesta Descrizione
Content-Type: Obbligatorio. Impostare su application/json.
Authorization: Obbligatorio. Impostare su un token di accesso validoBearer.

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:

Nome Obbligatorio Tipo Descrizione
eTag string eTag facoltativo
posizione true string Posizione risorsa
properties true BackupVault Proprietà dell'insieme di credenziali
Identità DPPIdentityDetails Indica l'identificatore di sistema univoco per ogni risorsa di Azure
tags Oggetto Tag delle risorse

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 riuscite per l'operazione per creare o aggiornare un insieme di credenziali di backup:

Nome Tipo Descrizione
200 - OK BackupVaultResource OK
201 Creato BackupVaultResource Data di creazione
Altri codici di stato CloudError

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 criteri di backup per il backup di BLOB in questo insieme di credenziali.

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