你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 REST API 创建 Azure 存储帐户

项目
08/05/2023

此示例演示如何使用 Azure REST API 创建新的 Azure 存储帐户。

生成请求

使用以下 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 订阅的订阅 ID。如果拥有多个订阅，请参阅使用多个订阅。
resourceGroupName	包含该资源的资源组名称。可以从 Azure 资源管理器 API、CLI 或门户获取此值。
accountName	存储帐户的名称。建议遵循命名帐户最佳做法。
api-version	要用于请求的 API 版本。本文档涵盖 API 版本 `2018-02-01`，包含于上述 URL 中。

请求正文

下表描述了请求正文所需的 JSON 属性。使用可选参数进一步自定义存储帐户。

名称	类型	说明
location	字符串	资源位置。使用列出位置操作获取位置的当前列表。
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"
}

通过