你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Workspace Collections - check Name Availability
验证指定的 Power BI 工作区集合名称是否有效且尚未使用。
POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.PowerBI/locations/{location}/checkNameAvailability?api-version=2016-01-29URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
location
|
path | True |
string |
Azure 位置 |
|
subscription
|
path | True |
string |
获取唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。 |
|
api-version
|
query | True |
string |
客户端 API 版本。 |
请求正文
| 名称 | 类型 | 说明 |
|---|---|---|
| name |
string |
工作区集合名称 |
| type |
string |
资源类型 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
请求已成功完成 |
|
| Other Status Codes |
默认响应。 它将根据架构中指定的错误定义进行反序列化。 将引发异常。 |
定义
| 名称 | 说明 |
|---|---|
|
Check |
无法使用工作区集合名称的原因。 |
|
Check |
|
|
Check |
|
| Error | |
|
Error |
CheckNameReason
无法使用工作区集合名称的原因。
| 名称 | 类型 | 说明 |
|---|---|---|
| Invalid |
string |
|
| Unavailable |
string |
CheckNameRequest
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| name |
string |
工作区集合名称 |
|
| type |
string |
Microsoft.PowerBI/workspaceCollections |
资源类型 |
CheckNameResponse
| 名称 | 类型 | 说明 |
|---|---|---|
| message |
string |
指示由于冲突而不可用的名称的消息，或违反命名规则的说明。 |
| nameAvailable |
boolean |
指定一个布尔值，该值指示指定的 Power BI 工作区集合名称是否可供使用。 |
| reason |
无法使用工作区集合名称的原因。 |
Error
| 名称 | 类型 | 说明 |
|---|---|---|
| code |
string |
|
| details | ||
| message |
string |
|
| target |
string |
ErrorDetail
| 名称 | 类型 | 说明 |
|---|---|---|
| code |
string |
|
| message |
string |
|
| target |
string |