Azure Storage-fiók létrehozása a REST API-val

Ez a minta bemutatja, hogyan hozhat létre új Azure Storage-fiókot az Azure REST API használatával.

A teljes referenciadokumentáció és további minták a Storage-erőforrás-szolgáltató REST API-referenciájában érhetők el.

A kérelem felépítése

Új Azure Storage-fiók létrehozásához használja az alábbi HTTP PUT-kérést.

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

Kérésfejlécek

A következő fejlécek megadása kötelező:

Kérelem fejléce	Leírás
Content-Type (Tartalomtípus):	Kötelező. Állítsa application/json értékre.
Authorization (Engedélyezés):	Kötelező. Állítson be érvényes Bearerhozzáférési jogkivonatot.

URI-paraméterek

Név	Leírás
subscriptionId	Az Azure-előfizetést azonosító előfizetés-azonosító. Ha több előfizetéssel rendelkezik, olvassa el a Több előfizetés használata című témakört.
resourceGroupName	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból, a parancssori felületről vagy a portálról szerezheti be.
accountName	A tárfiók neve. Ajánlott az elnevezési fiókok ajánlott eljárásainak követése.
api-verzió	A kéréshez használni kívánt API-verzió. Ez a dokumentum a fenti URL-címben szereplő API-verziót 2018-02-01ismerteti.

A kérés törzse

Az alábbi táblázat a kérelem törzséhez szükséges JSON-tulajdonságokat ismerteti. A tárfiók további testreszabásához használjon választható paramétereket .

Név	Típus	Description
location	sztring	Erőforrás helye. A Helyek listázása művelettel lekérheti a helyek aktuális listáját.
Fajta	Altípus	Megadja, hogy milyen típusú tárfiókot szeretne létrehozni. Ebben a mintában az általános célú StorageV2 választás ajánlott és használható.
Sku	Sku	Meghatározza a Storage-fiók képességeit, például a redundanciastratégiát és a titkosítást. Ez a minta georedundáns tárolást használ.

Példakérés törzsére

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

A válasz kezelése

Az új fiók létrehozására irányuló sikeres kérések egy üres választörzset tartalmazó 202-s állapotkódot ad vissza. A tárfiók aszinkron módon jön létre. Ha a fiók már létezik vagy ki van építve, a kérés válasza 200 visszaküldési kóddal rendelkezik, amely a válasz törzsében található meglévő tárfiók konfigurációjával rendelkezik.

A hibakódok referenciadokumentációjában elérhető a válaszkódok teljes listája, beleértve a hibakódokat is.

Példa 200-ra válaszkód

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