Creare un account di archiviazione di Azure con l'API REST

Articolo
07/11/2023

Questo esempio illustra come creare un nuovo account di archiviazione di Azure usando l'API REST di Azure.

La documentazione di riferimento completa e altri esempi sono disponibili nella Guida di riferimento all'API REST del provider di risorse di archiviazione.

Compilare la richiesta

Usare la richiesta HTTP PUT seguente per creare un nuovo account di archiviazione di Azure.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}?api-version=2018-02-01

Intestazioni della richiesta

Gli argomenti seguenti sono obbligatori:

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

Parametri URI

Nome	Descrizione
subscriptionId	ID sottoscrizione che identifica una sottoscrizione di Azure. Se si hanno più sottoscrizioni, vedere Uso di più sottoscrizioni.
resourceGroupName	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager, dall'interfaccia della riga di comando o dal portale.
accountName	Nome dell'account di archiviazione. È consigliabile seguire le procedure consigliate per la denominazione degli account .
api-version	Versione dell'API da usare per la richiesta. Questo documento illustra la versione api-version `2018-02-01`, inclusa nell'URL precedente.

Testo della richiesta

La tabella seguente descrive le proprietà JSON necessarie per il corpo della richiesta. Usare i parametri facoltativi per personalizzare ulteriormente l'account di archiviazione.

Nome	Tipo	Descrizione
posizione	string	Percorso della risorsa. Ottenere un elenco aggiornato delle località usando l'operazione List Locations.
kind	Tipologia	Specifica il tipo di account di archiviazione da creare. La scelta per utilizzo `StorageV2` generico è consigliata e usata in questo esempio.
sku	Sku	Definisce le funzionalità dell'account di archiviazione, ad esempio la strategia di ridondanza e la crittografia. Questo esempio usa l'archiviazione con ridondanza geografica.

Esempio di corpo della richiesta

{
  "sku": {
    "name": "Standard_GRS"
  },
  "kind": "StorageV2",
  "location": "eastus2",
}

Gestire la risposta

Le richieste riuscite per creare un nuovo account restituiscono un codice di stato 202 con un corpo di risposta vuoto. L'account di archiviazione viene creato in modo asincrono. Se l'account esiste già o viene eseguito il provisioning, la risposta della richiesta ha un codice restituito 200 con la configurazione dell'account di archiviazione esistente nel corpo della risposta.

Un elenco completo dei codici di risposta, inclusi i codici di errore, è disponibile nella documentazione di riferimento sul codice di errore.

Esempio di codice di risposta 200

{
  "id": "/subscriptions/{subscriptionId}/resourceGroups/res9101/providers/Microsoft.Storage/storageAccounts/{accountName}",
  "kind": "Storage",
  "location": "eastus2",
  "name": "{accountName}",
  "properties": {
    "creationTime": "2017-05-24T13:25:33.4863236Z",
    "primaryEndpoints": {
      "blob": "https://{accountName}.blob.core.windows.net/",
      "file": "https://{accountName}.file.core.windows.net/",
      "queue": "https://{accountName}.queue.core.windows.net/",
      "table": "https://{accountName}.table.core.windows.net/"
    },
    "primaryLocation": "eastus2",
    "provisioningState": "Succeeded",
    "secondaryLocation": "centralus",
    "statusOfPrimary": "available",
    "statusOfSecondary": "available",
    "supportsHttpsTrafficOnly": false
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  },
  "type": "Microsoft.Storage/storageAccounts"
}

Condividi tramite