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

Storage Accounts - Check Name Availability

检查存储帐户名称是否有效且尚未使用。

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Storage/checkNameAvailability?api-version=2025-06-01

URI 参数

名称 必需 类型 说明
subscriptionId
path True

string

minLength: 1

目标订阅的 ID。

api-version
query True

string

minLength: 1

要用于此操作的 API 版本。

请求正文

名称 必需 类型 说明
name True

string

存储帐户名称。

type True

Type

资源类型 Microsoft.Storage/storageAccounts

响应

名称 类型 说明
200 OK

CheckNameAvailabilityResult

确定 -- 检查存储帐户名称可用性的作成功。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

StorageAccountCheckNameAvailability

示例请求

POST https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Storage/checkNameAvailability?api-version=2025-06-01

{
  "name": "sto3363",
  "type": "Microsoft.Storage/storageAccounts"
}

示例响应

{
  "nameAvailable": true
}

定义

名称 说明
CheckNameAvailabilityResult

CheckNameAvailability作响应。

Reason

获取无法使用存储帐户名称的原因。 仅当 NameAvailable 为 false 时,才会返回 Reason 元素。

StorageAccountCheckNameAvailabilityParameters

用于检查存储帐户名称可用性的参数。

Type

资源类型 Microsoft.Storage/storageAccounts

CheckNameAvailabilityResult

CheckNameAvailability作响应。

名称 类型 说明
message

string

获取一条错误消息,更详细地解释“原因”值。

nameAvailable

boolean

获取一个布尔值,指示该名称是否可供您使用。 如果为 true,则名称可用。 如果为 false,则该名称已被占用或无效且无法使用。

reason

Reason

获取无法使用存储帐户名称的原因。 仅当 NameAvailable 为 false 时,才会返回 Reason 元素。

Reason

获取无法使用存储帐户名称的原因。 仅当 NameAvailable 为 false 时,才会返回 Reason 元素。

说明
AccountNameInvalid
AlreadyExists

StorageAccountCheckNameAvailabilityParameters

用于检查存储帐户名称可用性的参数。

名称 类型 说明
name

string

存储帐户名称。

type

Type

资源类型 Microsoft.Storage/storageAccounts

Type

资源类型 Microsoft.Storage/storageAccounts

说明
Microsoft.Storage/storageAccounts