你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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 参数

名称	在	必需	类型	说明
billingAccountId	path	True	string	BillingAccount ID
api-version	query	True	string	用于此操作的 API 版本。

请求正文

名称	类型	说明
name	string	规则名称
type	string	资源类型。这预计将Microsoft.CostManagement/costAllocationRules

响应

名称	类型	说明
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	成本分配规则名称可用性的响应。
Other Status Codes	ErrorResponse	描述操作失败原因的错误响应

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
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."
}

定义

名称	说明
CostAllocationRuleCheckNameAvailabilityRequest	成本分配规则检查名称可用性请求
CostAllocationRuleCheckNameAvailabilityResponse	成本分配规则检查名称可用性响应
ErrorDetails	错误的详细信息。
ErrorResponse	错误响应指示服务无法处理传入请求。错误消息中提供了原因。一些错误响应： 429 TooManyRequests - 请求受到限制。等待“x-ms-ratelimit-microsoft.consumption-retry-after”标头中指定的时间后重试。 503 ServiceUnavailable - 服务暂时不可用。在等待“Retry-After”标头中指定的时间后重试。
Reason	此名称不可用的原因。

CostAllocationRuleCheckNameAvailabilityRequest

成本分配规则检查名称可用性请求

名称	类型	说明
name	string	规则名称
type	string	资源类型。这预计将Microsoft.CostManagement/costAllocationRules

CostAllocationRuleCheckNameAvailabilityResponse

成本分配规则检查名称可用性响应

名称	类型	说明
message	string	如果名称不可用，则显示错误消息
nameAvailable	boolean	此规则名称是否可用
reason	Reason	此名称不可用的原因

ErrorDetails

错误的详细信息。

名称	类型	说明
code	string	错误代码。
message	string	指示操作失败的原因的错误消息。

ErrorResponse

错误响应指示服务无法处理传入请求。错误消息中提供了原因。

一些错误响应：

429 TooManyRequests - 请求受到限制。等待“x-ms-ratelimit-microsoft.consumption-retry-after”标头中指定的时间后重试。
503 ServiceUnavailable - 服务暂时不可用。在等待“Retry-After”标头中指定的时间后重试。

名称	类型	说明
error	ErrorDetails	错误的详细信息。

Reason

此名称不可用的原因。

名称	类型	说明
AlreadyExists	string
Invalid	string
Valid	string

通过