Scheduled Actions - Check Name Availability

Référence

Service:: Cost Management

Version d'API:: 2024-08-01

Vérifie la disponibilité et la correction du nom pour une action planifiée.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
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 ressource pour laquelle la disponibilité doit être vérifiée.
type	string	Type de ressource.

Réponses

Nom	Type	Description
200 OK	CheckNameAvailabilityResponse	Réponse de la disponibilité du nom d’action planifiée.
Other Status Codes	ErrorResponseWithNestedDetails	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

ScheduledActionCheckNameAvailability

Exemple de requête

HTTP

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

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

Exemple de réponse

Code d’état:: 200

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

Définitions

Nom	Description
CheckNameAvailabilityReason	Raison pour laquelle le nom donné n’est pas disponible.
CheckNameAvailabilityRequest	Corps de la demande de disponibilité de vérification.
CheckNameAvailabilityResponse	Résultat de la vérification de la disponibilité.
ErrorDetailsWithNestedDetails	Détails de l’erreur.
ErrorResponseWithNestedDetails	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 ».

CheckNameAvailabilityReason

Raison pour laquelle le nom donné n’est pas disponible.

Nom	Type	Description
AlreadyExists	string
Invalid	string

CheckNameAvailabilityRequest

Corps de la demande de disponibilité de vérification.

Nom	Type	Description
name	string	Nom de la ressource pour laquelle la disponibilité doit être vérifiée.
type	string	Type de ressource.

CheckNameAvailabilityResponse

Résultat de la vérification de la disponibilité.

Nom	Type	Description
message	string	Raison détaillée pour laquelle le nom donné est disponible.
nameAvailable	boolean	Indique si le nom de la ressource est disponible.
reason	CheckNameAvailabilityReason	Raison pour laquelle le nom donné n’est pas disponible.

ErrorDetailsWithNestedDetails

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
details	ErrorDetailsWithNestedDetails[]	Détails supplémentaires de l’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.

ErrorResponseWithNestedDetails

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	ErrorDetailsWithNestedDetails	Détails de l’erreur.

Partager via