Cost Allocation Rules - Check Name Availability

Référence

Service:: Cost Management

Version d'API:: 2024-08-01

Vérifie la disponibilité et la correction d’un nom pour une règle d’allocation de coûts

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
billingAccountId	path	True	string	BillingAccount ID
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
name	string	Nom de la règle
type	string	Type de ressource. Il s’agit de Microsoft.CostManagement/costAllocationRules

Réponses

Nom	Type	Description
200 OK	CostAllocationRuleCheckNameAvailabilityResponse	Réponse de la disponibilité du nom de la règle d’allocation de coûts.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant pourquoi l’opération a échoué

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

CostAllocationRuleCheckNameAvailability

Exemple de requête

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

Exemple de réponse

Code d’état:: 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."
}

Définitions

Nom	Description
CostAllocationRuleCheckNameAvailabilityRequest	Demande de disponibilité de la règle d’allocation des coûts
CostAllocationRuleCheckNameAvailabilityResponse	Réponse à la disponibilité de la règle d’allocation des coûts
ErrorDetails	Détails de l’erreur.
ErrorResponse	La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur. Réponses d’erreur : 429 TooManyRequests : la requête est limitée. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ». 503 ServiceUnavailable - Le service est temporairement indisponible. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « Retry-After ».
Reason	Raison pour laquelle ce nom n’est pas disponible.

CostAllocationRuleCheckNameAvailabilityRequest

Demande de disponibilité de la règle d’allocation des coûts

Nom	Type	Description
name	string	Nom de la règle
type	string	Type de ressource. Il s’agit de Microsoft.CostManagement/costAllocationRules

CostAllocationRuleCheckNameAvailabilityResponse

Réponse à la disponibilité de la règle d’allocation des coûts

Nom	Type	Description
message	string	Message d’erreur si le nom n’est pas disponible
nameAvailable	boolean	Indique si ce nom de règle est disponible
reason	Reason	Raison pour laquelle ce nom n’est pas disponible

ErrorDetails

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.

ErrorResponse

La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.

Réponses d’erreur :

429 TooManyRequests : la requête est limitée. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « x-ms-ratelimit-microsoft.consumption-retry-after ».
503 ServiceUnavailable - Le service est temporairement indisponible. Réessayez après avoir attendu l’heure spécifiée dans l’en-tête « Retry-After ».

Nom	Type	Description
error	ErrorDetails	Détails de l’erreur.

Reason

Raison pour laquelle ce nom n’est pas disponible.

Nom	Type	Description
AlreadyExists	string
Invalid	string
Valid	string

Partager via