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 參數

名稱	位於	必要	類型	Description
location	path	True	string	作業要查閱的區域名稱。
subscriptionId	path	True	string	Microsoft Azure 訂用帳戶的唯一標識符。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。
api-version	query	True	string	用戶端 API 版本。

要求本文

名稱	類型	Description
name	string	檢查可用性的名稱。
type	string	PowerBI 專用的資源類型。

回應

名稱	類型	Description
200 OK	CheckCapacityNameAvailabilityResult	正常。 要求成功。
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

Check name availability of a capacity

範例要求

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

範例回覆

狀態碼:

200

{
  "nameAvailable": true
}

定義

名稱	Description
CheckCapacityNameAvailabilityParameters	容量名稱要求本文的詳細數據。
CheckCapacityNameAvailabilityResult	容量名稱可用性的檢查結果。
Error	錯誤物件
ErrorResponse	描述錯誤回應的格式。

CheckCapacityNameAvailabilityParameters

容量名稱要求本文的詳細數據。

名稱	類型	預設值	Description
name	string		檢查可用性的名稱。
type	string	Microsoft.PowerBIDedicated/capacities	PowerBI 專用的資源類型。

CheckCapacityNameAvailabilityResult

容量名稱可用性的檢查結果。

名稱	類型	Description
message	string	要求無法使用的詳細訊息。
nameAvailable	boolean	容量名稱的可用性指標。
reason	string	無法使用的原因。

Error

錯誤物件

名稱	類型	Description
code	string	錯誤碼
message	string	指出作業失敗原因的錯誤訊息。

ErrorResponse

描述錯誤回應的格式。

名稱	類型	Description
error	Error	錯誤物件