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
api-version	query	True	string	Версия API, используемая для этой операции.

Текст запроса

Имя	Тип	Описание
name	string	Имя правила
type	string	Тип ресурса. Ожидается, что это будет Microsoft.CostManagement/costAllocationRules

Ответы

Имя	Тип	Описание
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	Ответ на доступность имени правила распределения затрат.
Other Status Codes	ErrorResponse	Ответ на ошибку, описывающий причину сбоя операции

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: 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

Поделиться через