Workspace Collections - check Name Availability
Verify the specified Power BI Workspace Collection name is valid and not already in use.
POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.PowerBI/locations/{location}/checkNameAvailability?api-version={api-version}
URI Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
subscriptionId
|
path | True |
|
Gets subscription credentials which uniquely identify a Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
|
location
|
path | True |
|
Azure location |
|
api-version
|
query | True |
|
Client Api Version. |
Request Body
| Name | Required | Type | Description |
|---|---|---|---|
| name |
|
Workspace collection name |
|
| type |
|
Resource type |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK |
Request completed successfully |
|
| Other Status Codes |
Default Response. It will be deserialized as per the Error defintion specified in the schema. Exception will be thrown. |
Definitions
| CheckNameResponse | |
| Error | |
| ErrorDetail |
| Name | Type | Description |
|---|---|---|
| message |
|
Message indicating an unavailable name due to a conflict, or a description of the naming rules that are violated. |
| nameAvailable |
|
Specifies a Boolean value that indicates whether the specified Power BI Workspace Collection name is available to use. |
| reason |
|
Reason why the workspace collection name cannot be used. |
| Name | Type | Description |
|---|---|---|
| code |
|
|
| details | ||
| message |
|
|
| target |
|
| Name | Type | Description |
|---|---|---|
| code |
|
|
| message |
|
|
| target |
|