Een Azure Storage-account maken met de REST API

Artikel
08/05/2023

In dit voorbeeld ziet u hoe u een nieuw Azure Storage-account maakt met behulp van de Azure REST API.

Volledige referentiedocumentatie en aanvullende voorbeelden zijn beschikbaar in de Naslaginformatie over de OPSLAGresourceprovider REST API.

De aanvraag maken

Gebruik de volgende HTTP PUT-aanvraag om een nieuw Azure Storage-account te maken.

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

Aanvraagheaders

De volgende headers zijn vereist:

Aanvraagheader	Beschrijving
Content-Type:	Vereist. Ingesteld op `application/json`.
Authorization:	Vereist. Ingesteld op een geldig `Bearer`toegangstoken.

URI-parameters

Naam	Beschrijving
subscriptionId	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd. Als u meerdere abonnementen hebt, raadpleegt u Werken met meerdere abonnementen.
resourceGroupName	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API, CLI of de portal.
accountName	De naam van het opslagaccount. Het volgen van aanbevolen procedures voor naamgevingsaccounts wordt aanbevolen.
api-versie	De API-versie die moet worden gebruikt voor de aanvraag. In dit document wordt de api-versie `2018-02-01`beschreven, opgenomen in de bovenstaande URL.

Aanvraagbody

In de onderstaande tabel worden de vereiste JSON-eigenschappen voor de aanvraagbody beschreven. Gebruik optionele parameters om het opslagaccount verder aan te passen.

Naam	Type	Beschrijving
location	tekenreeks	Resourcelocatie. Haal een huidige lijst met locaties op met behulp van de bewerking Locaties weergeven .
Soort	Soort	Hiermee geeft u op welk type opslagaccount moet worden gemaakt. De keuze voor algemeen gebruik `StorageV2` wordt aanbevolen en gebruikt in dit voorbeeld.
sku	SKU	Definieert de mogelijkheden van het opslagaccount, zoals redundantiestrategie en versleuteling. In dit voorbeeld wordt geografisch redundante opslag gebruikt.

Voorbeeld van aanvraagbody

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

Het antwoord verwerken

Geslaagde aanvragen voor het maken van een nieuw account retourneren een 202-statuscode met een lege antwoordtekst. Het opslagaccount wordt asynchroon gemaakt. Als het account al bestaat of wordt ingericht, heeft het aanvraagantwoord een retourcode 200 met de configuratie van het bestaande opslagaccount in de antwoordtekst.

Een volledige lijst met antwoordcodes, inclusief foutcodes, is beschikbaar in de naslagdocumentatie voor foutcodes.

Voorbeeld van 200-antwoordcode

{
  "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"
}

Share via