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

Capacities - Check Name Availability

参考

Service:: Power BI Embedded

API Version:: 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	操作将查找到的区域名称。
subscriptionId	path	True	string	Microsoft Azure 订阅的唯一标识符。此订阅 ID 是每个服务调用的 URI 的一部分。
api-version	query	True	string	客户端 API 版本。

请求正文

名称	类型	说明
name	string	用于检查可用性的名称。
type	string	PowerBI 专用资源类型。

响应

名称	类型	说明
200 OK	CheckCapacityNameAvailabilityResult	没问题。请求已成功。
Other Status Codes	ErrorResponse	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

Check name availability of a capacity

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "nameAvailable": true
}

定义

名称	说明
CheckCapacityNameAvailabilityParameters	容量名称请求正文的详细信息。
CheckCapacityNameAvailabilityResult	容量名称可用性的检查结果。
Error	错误对象
ErrorResponse	描述错误响应的格式。

CheckCapacityNameAvailabilityParameters

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

名称	类型	默认值	说明
name	string		用于检查可用性的名称。
type	string	Microsoft.PowerBIDedicated/capacities	PowerBI 专用资源类型。

CheckCapacityNameAvailabilityResult

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

名称	类型	说明
message	string	请求不可用的详细消息。
nameAvailable	boolean	容量名称的可用性指示器。
reason	string	不可用的原因。

Error

错误对象

名称	类型	说明
code	string	错误代码
message	string	指示操作失败原因的错误消息。

ErrorResponse

描述错误响应的格式。

名称	类型	说明
error	Error	错误对象

Share via