Scheduled Actions - Check Name Availability

Referência

Serviço:: Cost Management

Versão da API:: 2024-08-01

Verifica a disponibilidade e a correção do nome de uma ação agendada.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
api-version	query	True	string	A versão da API a ser usada para esta operação.

Corpo do Pedido

Name	Tipo	Description
name	string	O nome do recurso cuja disponibilidade precisa ser verificada.
type	string	O tipo de recurso.

Respostas

Name	Tipo	Description
200 OK	CheckNameAvailabilityResponse	Resposta da disponibilidade do nome da ação agendada.
Other Status Codes	ErrorResponseWithNestedDetails	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

ScheduledActionCheckNameAvailability

Pedido de amostra

HTTP

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

{
  "name": "testName",
  "type": "Microsoft.CostManagement/ScheduledActions"
}

Resposta da amostra

Código de estado:: 200

{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "A private scheduled action with name 'testName' is already present. Please specify a differnt name."
}

Definições

Name	Description
CheckNameAvailabilityReason	A razão pela qual o nome próprio não está disponível.
CheckNameAvailabilityRequest	O corpo da solicitação de verificação de disponibilidade.
CheckNameAvailabilityResponse	O resultado da verificação da disponibilidade.
ErrorDetailsWithNestedDetails	Os detalhes do erro.
ErrorResponseWithNestedDetails	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".

CheckNameAvailabilityReason

A razão pela qual o nome próprio não está disponível.

Name	Tipo	Description
AlreadyExists	string
Invalid	string

CheckNameAvailabilityRequest

O corpo da solicitação de verificação de disponibilidade.

Name	Tipo	Description
name	string	O nome do recurso cuja disponibilidade precisa ser verificada.
type	string	O tipo de recurso.

CheckNameAvailabilityResponse

O resultado da verificação da disponibilidade.

Name	Tipo	Description
message	string	Razão detalhada pela qual o nome próprio está disponível.
nameAvailable	boolean	Indica se o nome do recurso está disponível.
reason	CheckNameAvailabilityReason	A razão pela qual o nome próprio não está disponível.

ErrorDetailsWithNestedDetails

Os detalhes do erro.

Name	Tipo	Description
code	string	Código de erro.
details	ErrorDetailsWithNestedDetails[]	Os detalhes adicionais do erro.
message	string	Mensagem de erro indicando por que a operação falhou.

ErrorResponseWithNestedDetails

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	ErrorDetailsWithNestedDetails	Os detalhes do erro.

Partilhar via