Vytvoření účtu služby Azure Storage pomocí rozhraní REST API

Článek
07/11/2023

Tato ukázka ukazuje, jak vytvořit nový účet služby Azure Storage pomocí rozhraní Azure REST API.

Kompletní referenční dokumentace a další ukázky jsou k dispozici v referenčních informacích k rozhraní REST API poskytovatele prostředků úložiště.

Sestavení požadavku

K vytvoření nového účtu služby Azure Storage použijte následující požadavek HTTP PUT.

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

Hlavičky požadavku

Jsou vyžadovány následující hlavičky:

Hlavička požadavku	Popis
Content-Type:	Povinná hodnota. Nastavte na `application/json`.
Authorization:	Povinná hodnota. Nastavte na platný `Bearer`přístupový token.

Parametry identifikátoru URI

Název	Description
subscriptionId	ID předplatného, které identifikuje předplatné Azure. Pokud máte více předplatných, přečtěte si téma Práce s více předplatnými.
resourceGroupName	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager, rozhraní příkazového řádku nebo portálu.
accountName	Název účtu úložiště. Doporučuje se následující osvědčené postupy pro pojmenování účtů .
verze-api	Verze rozhraní API, která se má použít pro požadavek. Tento dokument se zabývá verzí api-version `2018-02-01`, která je součástí výše uvedené adresy URL.

Text požadavku

Následující tabulka popisuje požadované vlastnosti JSON pro text požadavku. K dalšímu přizpůsobení účtu úložiště použijte volitelné parametry .

Název	Typ	Description
location	řetězec	Umístění prostředku. Získejte aktuální seznam umístění pomocí operace Výpis umístění .
Druhu	Druh	Určuje, jaký typ účtu úložiště se má vytvořit. V této ukázce se doporučuje volba pro obecné účely `StorageV2` .
Sku	Sku	Definuje možnosti účtu úložiště, jako je strategie redundance a šifrování. Tato ukázka používá geograficky redundantní úložiště.

Příklad textu požadavku

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

Zpracování odpovědi

Úspěšné žádosti o vytvoření nového účtu vrátí stavový kód 202 s prázdným textem odpovědi. Účet úložiště se vytváří asynchronně. Pokud účet již existuje nebo se zřizuje, má odpověď na žádost návratový kód 200 s konfigurací existujícího účtu úložiště v textu odpovědi.

Úplný seznam kódů odpovědí, včetně kódů chyb, je k dispozici v referenční dokumentaci ke kódům chyb.

Příklad kódu odpovědi 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"
}

Sdílet prostřednictvím