Cost Allocation Rules - Check Name Availability

Serviço:

Cost Management

Versão da API:

2024-08-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=2024-08-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
billingAccountId	path	True	string	FaturaçãoID da conta
api-version	query	True	string minLength: 1	A versão da API a ser usada 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 descrevendo por que a operação falhou

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar 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=2024-08-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	A regra de alocação de custos verifica a solicitação de disponibilidade do nome
CostAllocationRuleCheckNameAvailabilityResponse	A regra de alocação de custos verifica a resposta de disponibilidade do nome
ErrorDetails	Os detalhes do erro.
ErrorResponse	A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro. Algumas respostas de erro: 429 TooManyRequests - A solicitação está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiçoIndisponível - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".
Reason	A razão pela qual este nome não está disponível.

CostAllocationRuleCheckNameAvailabilityRequest

Object

A regra de alocação de custos verifica a solicitação de disponibilidade do nome

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

CostAllocationRuleCheckNameAvailabilityResponse

Object

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

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	A razão pela qual este nome não está disponível

ErrorDetails

Object

Os detalhes do erro.

Name	Tipo	Description
code	string	Código de erro.
message	string	Mensagem de erro indicando por que a operação falhou.

ErrorResponse

Object

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Algumas respostas de erro:

• 429 TooManyRequests - A solicitação está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".

• 503 ServiçoIndisponível - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".

Name	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

Reason

Enumeração

A razão pela qual este nome não está disponível.

Valor	Description
AlreadyExists
Invalid
Valid