REST API を使用して Azure Storage アカウントを作成する

[アーティクル]
08/05/2023

このサンプルでは、Azure REST API を使用して新しい Azure Storage アカウントを作成する方法を示します。

完全なリファレンスドキュメントと追加のサンプルについては、「ストレージリソースプロバイダー REST API リファレンス」を参照してください。

要求を作成する

次の HTTP PUT 要求を使用して、新しい Azure Storage アカウントを作成します。

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

要求ヘッダー

次のヘッダーは必須です｡

要求ヘッダー	説明
Content-Type:	必須。 `application/json` を設定します。
Authorization:	必須。有効な `Bearer` アクセストークンを設定します｡

URI パラメーター

名前	説明
subscriptionId	Azure サブスクリプションを識別するサブスクリプション ID。複数のサブスクリプションをお持ちの場合は､Working with multiple subscriptionsを参照してください｡
resourceGroupName	リソースが含まれているリソースグループの名前。この値は、Azure Resource Manager API、CLI、またはポータルから取得できます。
accountName	ストレージアカウントの名前。次の名前付けアカウントのベストプラクティスをお勧めします。
api-version	要求で使用する API のバージョン。このドキュメントでは、api-version `2018-02-01` を使用し、上記の URL に含まれています。

要求本文

次の表では、要求本文に必要な JSON プロパティについて説明します。ストレージアカウントをさらにカスタマイズするには、省略可能なパラメーターを使用します。

名前	Type	説明
location	string	リソースの場所。 List Locations操作を使用して、最新の場所一覧を取得します。
kind	種類	作成するストレージアカウントの種類を指定します。このサンプルでは、 `StorageV2` 汎用の選択肢をお勧めします。
sku	SKU	冗長性戦略や暗号化など、ストレージアカウントの機能を定義します。このサンプルでは、geo 冗長ストレージを使用します。

要求本文の例

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

応答の処理

新しいアカウントを作成する要求が成功すると、応答本文が空の 202 状態コードが返されます。ストレージアカウントは非同期的に作成されます。アカウントが既に存在するか、プロビジョニングされている場合、要求応答には、応答本文で既存のストレージアカウントの構成を含む 200 のリターンコードがあります。

エラーコードを含む応答コードの完全な一覧については、エラーコードリファレンスドキュメントを参照してください。

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

次の方法で共有