Skapa ett Azure Storage-konto med REST-API:et

Artikel
07/11/2023

Det här exemplet visar hur du skapar ett nytt Azure Storage-konto med hjälp av Azure REST API.

Fullständig referensdokumentation och ytterligare exempel finns i REST API-referensen för lagringsresursprovidern.

Skapa begäran

Använd följande HTTP PUT-begäran för att skapa ett nytt Azure Storage-konto.

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

Begärandehuvuden

Följande huvuden krävs:

Begärandehuvud	Beskrivning
Content-Type:	Krävs. Ange till `application/json`.
Auktorisering:	Krävs. Ange till en giltig `Bearer`åtkomsttoken.

URI-parametrar

Name	Beskrivning
subscriptionId	Prenumerations-ID:t som identifierar en Azure-prenumeration. Om du har flera prenumerationer kan du läsa Arbeta med flera prenumerationer.
resourceGroupName	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager API, CLI eller portalen.
accountName	Namnet på lagringskontot. Vi rekommenderar att du följer metodtipsen för namngivningskonton .
api-version	DEN API-version som ska användas för begäran. Det här dokumentet beskriver api-version `2018-02-01`, som ingår i url:en ovan.

Begärandetext

I tabellen nedan beskrivs de JSON-egenskaper som krävs för begärandetexten. Använd valfria parametrar för att ytterligare anpassa lagringskontot.

Namn	Typ	Description
location	sträng	Resursplats. Hämta en aktuell lista över platser med hjälp av åtgärden Listplatser .
Typ	Variant	Anger vilken typ av lagringskonto som ska skapas. Det allmänna `StorageV2` valet rekommenderas och används i det här exemplet.
sku	Sku	Definierar funktionerna i lagringskontot, till exempel redundansstrategi och kryptering. Det här exemplet använder geo-redundant lagring.

Exempel på begärandetext

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

Hantera svaret

Lyckade begäranden om att skapa ett nytt konto returnerar en 202-statuskod med en tom svarstext. Lagringskontot skapas asynkront. Om kontot redan finns eller etableras har begärandesvaret en returkod på 200 med konfigurationen av det befintliga lagringskontot i svarstexten.

En fullständig lista över svarskoder, inklusive felkoder, finns i referensdokumentationen för felkod.

Exempel på 200-svarskod

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

Dela via