通过

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

Capacities - Check Name Availability

服务:
Power BI Embedded
API 版本:
2021-01-01

检查目标位置中的名称可用性。

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.PowerBIDedicated/locations/{location}/checkNameAvailability?api-version=2021-01-01

URI 参数

名称 在 必需 类型 说明
location
 path True

string

minLength: 1

Azure 区域的名称。
subscriptionId
 path True

string

minLength: 1

目标订阅的 ID。
api-version
 query True

string

minLength: 1

用于此作的 API 版本。

请求正文

名称 类型 说明
name

string

minLength: 3
maxLength: 63
pattern: ^[a-z][a-z0-9]*$

用于检查可用性的名称。
type

string

PowerBI 专用的资源类型。

响应

名称 类型 说明
200 OK

CheckCapacityNameAvailabilityResult

请求已成功。
Other Status Codes

ErrorResponse

意外的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流程。

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

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

Check name availability of a capacity

示例请求

POST https://management.azure.com/subscriptions/613192d7-503f-477a-9cfe-4efc3ee2bd60/providers/Microsoft.PowerBIDedicated/locations/West US/checkNameAvailability?api-version=2021-01-01

{
  "name": "azsdktest",
  "type": "Microsoft.PowerBIDedicated/capacities"
}

示例响应

状态代码:
200 
{
  "nameAvailable": true
}

定义

名称 说明
CheckCapacityNameAvailabilityParameters

容量名称请求正文的详细信息。
CheckCapacityNameAvailabilityResult

容量名称可用性的检查结果。
Error

错误对象。
ErrorResponse

错误对象

CheckCapacityNameAvailabilityParameters

Object

容量名称请求正文的详细信息。

名称 类型 默认值 说明
name

string

minLength: 3
maxLength: 63
pattern: ^[a-z][a-z0-9]*$

用于检查可用性的名称。
type

string

Microsoft.PowerBIDedicated/capacities

PowerBI 专用的资源类型。

CheckCapacityNameAvailabilityResult

Object

容量名称可用性的检查结果。

名称 类型 说明
message

string

请求不可用的详细消息。
nameAvailable

boolean

容量名称的可用性指示器。
reason

string

不可用的原因。

Error

Object

错误对象。

名称 类型 说明
code

string

错误代码
message

string

指示作失败的原因的错误消息。

ErrorResponse

Object

错误对象

名称 类型 说明
error

Error

错误对象。