Creare un insieme di credenziali di Servizi di ripristino di Azure usando l'API REST per Backup di Azure

Articolo
04/10/2024

Questo articolo descrive come creare un insieme di credenziali di Servizi di ripristino di Azure usando l'API REST. Per creare l'insieme di credenziali usando il portale di Azure, vedere questo articolo.

Un insieme di credenziali di Servizi di ripristino è un'entità di archiviazione di Azure che ospita i dati. I dati sono in genere copie di dati o informazioni di configurazione per macchine virtuali, carichi di lavoro, server o workstation. È possibile usare gli insiemi di credenziali di Servizi di ripristino per contenere dati di backup per vari servizi di Azure, ad esempio macchine virtuali IaaS (Linux o Windows) e SQL Server in macchine virtuali di Azure. Gli insiemi di credenziali di Servizi di ripristino supportano System Center DPM, Windows Server, server di Backup di Azure e altro ancora. Gli insiemi di credenziali di Servizi di ripristino semplificano l'organizzazione dei dati di backup, riducendo al minimo l'overhead di gestione.

Prima di iniziare

La creazione di un insieme di credenziali di Servizi di ripristino di Azure con l'API REST è descritta nell'articolo Creare un'API REST dell'insieme di credenziali. Usare questo articolo come riferimento per creare un insieme di credenziali denominato testVault in West US.

Per creare o aggiornare un insieme di credenziali di Servizi di ripristino di Azure, usare l'operazione PUT seguente:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}?api-version=2016-06-01

Crea 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=2016-06-01.

Gli argomenti seguenti sono obbligatori:

Intestazione della richiesta	Descrizione
Content-Type (Tipo di contenuto):	Obbligatorio. Impostare su `application/json`.
Autorizzazione:	Obbligatorio. Impostare un `Bearer` token di accesso valido.

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	Type	Descrizione
eTag		String	eTag facoltativo
location	true	String	Posizione della risorsa
proprietà		VaultProperties	Proprietà dell'insieme di credenziali
sku		Sku	Indica l'identificatore di sistema univoco per ogni risorsa di Azure
tag		Object	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 seguente viene usato per creare un insieme di credenziali in West US. Specificare la località. Lo SKU è sempre Standard.

{
  "properties": {},
  "sku": {
    "name": "Standard"
  },
  "location": "West US"
}

Risposte

Esistono due risposte che indicano l'esito positivo dell'operazione di creazione o aggiornamento di un insieme di credenziali di Servizi di ripristino:

Nome	Tipo	Descrizione
200 OK	Insiemi di credenziali	OK
201 Creato	Insiemi di credenziali	Data di creazione

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

Esempio di risposta

Una risposta ridotta 201 Creata dal corpo della richiesta di esempio precedente mostra che è stato assegnato un ID e provisioningState è Succeeded:

{
  "location": "westus",
  "name": "testVault",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "id": "/subscriptions/77777777-b0c6-47a2-b37c-d8e65a629c18/resourceGroups/Default-RecoveryServices-ResourceGroup/providers/Microsoft.RecoveryServices/vaults/testVault",
  "type": "Microsoft.RecoveryServices/vaults",
  "sku": {
    "name": "Standard"
  }
}

Passaggi successivi

Creare un criterio di backup per il backup di una macchina virtuale di Azure in questo insieme di credenziali.

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

Azure Recovery Services provider REST API (API REST del provider di Servizi di ripristino di Azure)
Introduzione all'API REST di Azure

Condividi tramite