Cost Allocation Rules - Check Name Availability

Referência

Serviço:: Cost Management

Versão da API:: 2023-11-01

Verifica a disponibilidade e a correção de um nome para uma regra de alocação de custos

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
billingAccountId	path	True	string	BillingAccount ID
api-version	query	True	string	A versão da API a utilizar para esta operação.

Corpo do Pedido

Name	Tipo	Description
name	string	Nome da regra
type	string	Tipo de recurso. Espera-se que seja Microsoft.CostManagement/costAllocationRules

Respostas

Name	Tipo	Description
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	Resposta da disponibilidade do nome da regra de alocação de custos.
Other Status Codes	ErrorResponse	Resposta de erro que descreve o motivo pela qual a operação falhou

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

CostAllocationRuleCheckNameAvailability

Pedido de amostra

HTTP

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

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

Resposta da amostra

Código de estado:: 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."
}

Definições

Name	Description
CostAllocationRuleCheckNameAvailabilityRequest	O pedido de disponibilidade do nome da regra de alocação de custos
CostAllocationRuleCheckNameAvailabilityResponse	A resposta de disponibilidade do nome da regra de alocação de custos
ErrorDetails	Os detalhes do erro.
ErrorResponse	A resposta de erro indica que o serviço não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro. Algumas Respostas de erro: 429 TooManyRequests – o pedido é limitado. Repita depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable - O serviço está temporariamente indisponível. Tente novamente após aguardar durante o tempo especificado no cabeçalho “Tentar novamente após”.
Reason	O motivo pelo qual este nome não está disponível.

CostAllocationRuleCheckNameAvailabilityRequest

O pedido de disponibilidade do nome da regra de alocação de custos

Name	Tipo	Description
name	string	Nome da regra
type	string	Tipo de recurso. Espera-se que seja Microsoft.CostManagement/costAllocationRules

CostAllocationRuleCheckNameAvailabilityResponse

A resposta de disponibilidade do nome da regra de alocação de custos

Name	Tipo	Description
message	string	Mensagem de erro se o nome não estiver disponível
nameAvailable	boolean	Se este nome de regra está disponível
reason	Reason	O motivo pelo qual este nome não está disponível

ErrorDetails

Os detalhes do erro.

Name	Tipo	Description
code	string	Código de erro.
message	string	Mensagem de erro a indicar o motivo pela qual a operação falhou.

ErrorResponse

A resposta de erro indica que o serviço não consegue processar o pedido recebido. O motivo é fornecido na mensagem de erro.

Algumas Respostas de erro:

429 TooManyRequests – o pedido é limitado. Repita depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable - O serviço está temporariamente indisponível. Tente novamente após aguardar durante o tempo especificado no cabeçalho “Tentar novamente após”.

Name	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

Reason

O motivo pelo qual este nome não está disponível.

Name	Tipo	Description
AlreadyExists	string
Invalid	string
Valid	string

Partilhar via