Scheduled Actions - Check Name Availability By Scope

參考

服務:: Cost Management

API 版本:: 2024-08-01

檢查指定範圍內排程動作的可用性和正確性。

POST https://management.azure.com/{scope}/providers/Microsoft.CostManagement/checkNameAvailability?api-version=2024-08-01

URI 參數

名稱	位於	必要	類型	Description
scope	path	True	string	與排程動作作業相關聯的範圍。這包括訂用帳戶範圍的 'subscriptions/{subscriptionId}'，resourceGroup 範圍的 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' for Billing Account scope， 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' for Department scope， 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{EnrollmentAccount 範圍的 enrollmentAccount 範圍，'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' for BillingProfile scope， 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' for InvoiceSection scope， 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' for External Billing Account scope and 'providers/Microsoft.外部訂用帳戶範圍的 CostManagement/externalSubscriptions/{externalSubscriptionName}'。注意：深入解析警示僅適用於訂用帳戶範圍。
api-version	query	True	string	要用於這項作業的 API 版本。

要求本文

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

回應

名稱	類型	Description
200 OK	CheckNameAvailabilityResponse	排程動作名稱可用性的回應。
Other Status Codes	ErrorResponseWithNestedDetails	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

範圍

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

範例

ScheduledActionCheckNameAvailabilityByScope

範例要求

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/checkNameAvailability?api-version=2024-08-01

{
  "name": "testName",
  "type": "Microsoft.CostManagement/ScheduledActions"
}

範例回覆

狀態碼:: 200

{
  "nameAvailable": true
}

定義

名稱	Description
CheckNameAvailabilityReason	指定名稱無法使用的原因。
CheckNameAvailabilityRequest	檢查可用性要求本文。
CheckNameAvailabilityResponse	檢查可用性結果。
ErrorDetailsWithNestedDetails	錯誤的詳細數據。
ErrorResponseWithNestedDetails	錯誤回應表示服務無法處理傳入要求。錯誤訊息中會提供原因。某些錯誤回應： 429 TooManyRequests - 要求已節流。等候「x-ms-ratelimit-microsoft.consumption-retry-after」標頭中指定的時間後重試。 503 ServiceUnavailable - 服務暫時無法使用。等候「Retry-After」標頭中指定的時間後重試。

CheckNameAvailabilityReason

指定名稱無法使用的原因。

名稱	類型	Description
AlreadyExists	string
Invalid	string

CheckNameAvailabilityRequest

檢查可用性要求本文。

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

CheckNameAvailabilityResponse

檢查可用性結果。

名稱	類型	Description
message	string	提供指定名稱的詳細原因。
nameAvailable	boolean	指出資源名稱是否可用。
reason	CheckNameAvailabilityReason	指定名稱無法使用的原因。

ErrorDetailsWithNestedDetails

錯誤的詳細數據。

名稱	類型	Description
code	string	錯誤碼。
details	ErrorDetailsWithNestedDetails[]	錯誤的其他詳細數據。
message	string	錯誤訊息，指出作業失敗的原因。

ErrorResponseWithNestedDetails

錯誤回應表示服務無法處理傳入要求。錯誤訊息中會提供原因。

某些錯誤回應：

429 TooManyRequests - 要求已節流。等候「x-ms-ratelimit-microsoft.consumption-retry-after」標頭中指定的時間後重試。
503 ServiceUnavailable - 服務暫時無法使用。等候「Retry-After」標頭中指定的時間後重試。

名稱	類型	Description
error	ErrorDetailsWithNestedDetails	錯誤的詳細數據。

共用方式為