Tworzenie konta usługi Azure Storage przy użyciu interfejsu API REST

Artykuł
08/05/2023

W tym przykładzie pokazano, jak utworzyć nowe konto usługi Azure Storage przy użyciu interfejsu API REST platformy Azure.

Pełna dokumentacja referencyjna i dodatkowe przykłady są dostępne w dokumentacji interfejsu API REST dostawcy zasobów magazynu.

Tworzenie żądania

Użyj następującego żądania HTTP PUT, aby utworzyć nowe konto usługi Azure Storage.

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

Nagłówki żądań

Wymagane są następujące nagłówki:

Nagłówek żądania	Opis
Content-Type:	Wymagany. Ustaw wartość `application/json`.
Authorization:	Wymagany. Ustaw wartość prawidłowego `Bearer`tokenu dostępu.

Parametry identyfikatora URI

Nazwa	Opis
subscriptionId	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure. Jeśli masz wiele subskrypcji, zobacz Praca z wieloma subskrypcjami.
resourceGroupName	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z poziomu interfejsu API usługi Azure Resource Manager, interfejsu wiersza polecenia lub portalu.
accountName	Nazwa konta magazynu. Zalecane jest stosowanie najlepszych rozwiązań dotyczących nazewnictwa kont .
api-version	Wersja interfejsu API do użycia dla żądania. W tym dokumencie omówiono wersję `2018-02-01`interfejsu API w powyższym adresie URL.

Treść żądania

W poniższej tabeli opisano wymagane właściwości JSON dla treści żądania. Użyj opcjonalnych parametrów , aby dodatkowo dostosować konto magazynu.

Nazwa	Typ	Opis
location	ciąg	Lokalizacja zasobu. Pobierz bieżącą listę lokalizacji przy użyciu operacji Lista lokalizacji .
Rodzaju	Rodzaj	Określa typ konta magazynu do utworzenia . Wybór ogólnego przeznaczenia `StorageV2` jest zalecany i używany w tym przykładzie.
sku	Numer jednostki magazynowej	Definiuje możliwości konta magazynu, takie jak strategia nadmiarowości i szyfrowanie. W tym przykładzie jest używany magazyn geograficznie nadmiarowy.

Przykładowa treść żądania

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

Obsługa odpowiedzi

Pomyślne żądania utworzenia nowego konta zwracają kod stanu 202 z pustą treścią odpowiedzi. Konto magazynu jest tworzone asynchronicznie. Jeśli konto już istnieje lub jest aprowizowane, odpowiedź na żądanie ma kod zwrotny 200 z konfiguracją istniejącego konta magazynu w treści odpowiedzi.

Pełna lista kodów odpowiedzi, w tym kodów błędów, jest dostępna w dokumentacji dotyczącej kodu błędu.

Przykładowy kod odpowiedzi 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"
}

Udostępnij za pośrednictwem