Cost Allocation Rules - Check Name Availability

參考

服務:: Cost Management

API 版本:: 2024-08-01

檢查成本配置規則名稱的可用性和正確性

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

URI 參數

名稱	位於	必要	類型	Description
billingAccountId	path	True	string	BillingAccount 識別符
api-version	query	True	string	要用於這項作業的 API 版本。

要求本文

名稱	類型	Description
name	string	規則名稱
type	string	資源類型。這預期為 Microsoft.CostManagement/costAllocationRules

回應

名稱	類型	Description
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	成本配置規則名稱可用性的回應。
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	模擬您的用戶帳戶

範例

CostAllocationRuleCheckNameAvailability

範例要求

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/100/providers/Microsoft.CostManagement/costAllocationRules/checkNameAvailability?api-version=2024-08-01

{
  "name": "testRule",
  "type": "Microsoft.CostManagement/costAllocationRules"
}

範例回覆

狀態碼:: 200

{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "A cost allocation rule with name testRule is already present for the billing account 100. Please specify a differnt name."
}

定義

名稱	Description
CostAllocationRuleCheckNameAvailabilityRequest	成本配置規則檢查名稱可用性要求
CostAllocationRuleCheckNameAvailabilityResponse	成本配置規則檢查名稱可用性回應
ErrorDetails	錯誤的詳細數據。
ErrorResponse	錯誤回應表示服務無法處理傳入要求。錯誤訊息中會提供原因。某些錯誤回應： 429 TooManyRequests - 要求已節流。等候「x-ms-ratelimit-microsoft.consumption-retry-after」標頭中指定的時間後重試。 503 ServiceUnavailable - 服務暫時無法使用。等候「Retry-After」標頭中指定的時間後重試。
Reason	此名稱無法使用的原因。

CostAllocationRuleCheckNameAvailabilityRequest

成本配置規則檢查名稱可用性要求

名稱	類型	Description
name	string	規則名稱
type	string	資源類型。這預期為 Microsoft.CostManagement/costAllocationRules

CostAllocationRuleCheckNameAvailabilityResponse

成本配置規則檢查名稱可用性回應

名稱	類型	Description
message	string	如果名稱無法使用，則錯誤訊息
nameAvailable	boolean	此規則名稱是否可用
reason	Reason	此名稱無法使用的原因

ErrorDetails

錯誤的詳細數據。

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

ErrorResponse

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

某些錯誤回應：

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

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

Reason

此名稱無法使用的原因。

名稱	類型	Description
AlreadyExists	string
Invalid	string
Valid	string

共用方式為