共用方式為

使用 REST API 建立 Azure 儲存體帳戶

  • 發行項

此範例示範如何使用Azure REST API建立新的Azure 儲存體帳戶。

完整的參考檔和其他範例可在 儲存體資源提供者 REST API 參考中取得。

建立要求

使用下列 HTTP PUT 要求來建立新的 Azure 儲存體帳戶。

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 訂用帳戶的訂用帳戶識別碼。 如果您有多個訂用帳戶，請參閱使用多個訂用帳戶。
resourceGroupName 包含資源的資源群組名稱。 您可以從 Azure Resource Manager API、CLI 或入口網站取得這個值。
accountName 儲存體帳戶的名稱。 建議遵循 命名帳戶最佳做法 。
api-version 要用於要求的 API 版本。

本文件涵蓋 api-version 2018-02-01，內含於上述 URL 中。
   

要求本文

下表描述要求本文的必要 JSON 屬性。 使用 選擇性參數 進一步自訂儲存體帳戶。

名稱 類型 描述
location 字串 資源位置。 使用 List Locations 作業取得目前的位置清單。
kind 種類 指定要建立 的儲存體帳戶類型 。 建議使用一般用途 StorageV2 的選擇，並用於此範例。
sku Sku 定義儲存體帳戶的功能，例如備援策略和加密。 此範例使用 異地備援儲存體。

要求本文範例

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