Scheduled Actions - Check Name Availability By Scope

Referência

Serviço:: Cost Management

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

Verifica a disponibilidade e a correção do nome para uma ação agendada dentro do escopo determinado.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
scope	path	True	string	O escopo associado às operações de ação agendadas. Isso inclui 'subscriptions/{subscriptionId}' para o escopo da assinatura, 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' para o escopo resourceGroup, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}' para o escopo da Conta de Cobrança, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/departments/{departmentId}' para o escopo do Departamento, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/enrollmentAccounts/{ enrollmentAccountId}' para o escopo EnrollmentAccount, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}' para o escopo BillingProfile, 'providers/Microsoft.Billing/billingAccounts/{billingAccountId}/invoiceSections/{invoiceSectionId}' para o escopo InvoiceSection, 'providers/Microsoft.CostManagement/externalBillingAccounts/{externalBillingAccountName}' para o escopo da Conta de Cobrança Externa e 'providers/Microsoft. CostManagement/externalSubscriptions/{externalSubscriptionName}' para o âmbito da Subscrição Externa. Observação: os alertas do Insight só estão disponíveis no escopo da assinatura.
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

ScheduledActionCheckNameAvailabilityByScope

Pedido de amostra

HTTP

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

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

Resposta da amostra

Código de estado:: 200

{
  "nameAvailable": true
}

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