Cost Allocation Rules - Check Name Availability

Riferimento

Servizio:: Cost Management

Versione API:: 2024-08-01

Verifica la disponibilità e la correttezza di un nome per una regola di allocazione dei costi

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
billingAccountId	path	True	string	BillingAccount ID
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
name	string	Nome regola
type	string	Tipo di risorsa. Dovrebbe trattarsi di Microsoft.CostManagement/costAllocationRules

Risposte

Nome	Tipo	Descrizione
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	Risposta alla disponibilità del nome della regola di allocazione dei costi.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

CostAllocationRuleCheckNameAvailability

Esempio di richiesta

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"
}

Risposta di esempio

Codice di stato:: 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."
}

Definizioni

Nome	Descrizione
CostAllocationRuleCheckNameAvailabilityRequest	Richiesta di disponibilità del controllo del nome della regola di allocazione dei costi
CostAllocationRuleCheckNameAvailabilityResponse	Risposta alla disponibilità del nome del controllo della regola di allocazione dei costi
ErrorDetails	Dettagli dell'errore.
ErrorResponse	La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore. Alcune risposte di errore: 429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".
Reason	Motivo per cui questo nome non è disponibile.

CostAllocationRuleCheckNameAvailabilityRequest

Richiesta di disponibilità del controllo del nome della regola di allocazione dei costi

Nome	Tipo	Descrizione
name	string	Nome regola
type	string	Tipo di risorsa. Dovrebbe trattarsi di Microsoft.CostManagement/costAllocationRules

CostAllocationRuleCheckNameAvailabilityResponse

Risposta alla disponibilità del nome del controllo della regola di allocazione dei costi

Nome	Tipo	Descrizione
message	string	Messaggio di errore se il nome non è disponibile
nameAvailable	boolean	Indica se il nome della regola è disponibile
reason	Reason	Motivo per cui questo nome non è disponibile

ErrorDetails

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Alcune risposte di errore:

429 TooManyRequests - La richiesta è limitata. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable - Il servizio non è temporaneamente disponibile. Riprovare dopo aver aspettato il tempo specificato nell'intestazione "Retry-After".

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore.

Reason

Motivo per cui questo nome non è disponibile.

Nome	Tipo	Descrizione
AlreadyExists	string
Invalid	string
Valid	string

Condividi tramite