Accounts - Check Name Availability

Service:

Azure Video Indexer

Version d'API:

2025-01-01

Vérifie que le nom du compte Video Indexer est valide et n’est pas déjà utilisé.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.VideoIndexer/checkNameAvailability?api-version=2025-01-01

Paramètres URI

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

Corps de la demande

Nom	Obligatoire	Type	Description
name	True	string	Nom du compte VideoIndexer.
type	True	Type	Type de ressource, Microsoft.VideoIndexer/accounts

Réponses

Nom	Type	Description
200 OK	CheckNameAvailabilityResult	OK - Opération pour vérifier que la disponibilité du nom du compte Video Indexer a réussi. Ok n’indique pas que le nom est disponible, le corps de la réponse le fait.
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

Check free account name availability

Check taken account name availability

Check free account name availability

Exemple de requête

HTTP

POST https://management.azure.com/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/providers/Microsoft.VideoIndexer/checkNameAvailability?api-version=2025-01-01

{
  "name": "vi1",
  "type": "Microsoft.VideoIndexer/accounts"
}

Exemple de réponse

Code d’état:

200

{
  "nameAvailable": true
}

Check taken account name availability

Exemple de requête

HTTP

POST https://management.azure.com/subscriptions/586d4f48-8f08-4a4e-96b7-e1892d6dba9e/providers/Microsoft.VideoIndexer/checkNameAvailability?api-version=2025-01-01

{
  "name": "vi1",
  "type": "Microsoft.VideoIndexer/accounts"
}

Exemple de réponse

Code d’état:

200

{
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "Resource name already exists"
}

Définitions

Nom	Description
AccountCheckNameAvailabilityParameters	Paramètres utilisés pour vérifier la disponibilité du nom du compte Video Indexer.
CheckNameAvailabilityResult	Réponse de l’opération CheckNameAvailability.
ErrorDefinition	Définition d’erreur.
ErrorResponse	Réponse d’erreur.
Reason	Obtient la raison pour laquelle un nom de compte Video Indexer n’a pas pu être utilisé. L’élément Reason est retourné uniquement si NameAvailable a la valeur false.
Type	Type de ressource, Microsoft.VideoIndexer/accounts

AccountCheckNameAvailabilityParameters

Object

Paramètres utilisés pour vérifier la disponibilité du nom du compte Video Indexer.

Nom	Type	Description
name	string	Nom du compte VideoIndexer.
type	Type	Type de ressource, Microsoft.VideoIndexer/accounts

CheckNameAvailabilityResult

Object

Réponse de l’opération CheckNameAvailability.

Nom	Type	Description
message	string	Obtient un message d’erreur expliquant plus en détail la valeur Motif.
nameAvailable	boolean	Obtient une valeur booléenne qui indique si le nom est disponible pour vous permettre d’utiliser. Si la valeur est true, le nom est disponible. Si la valeur est false, le nom a déjà été pris.
reason	Reason	Obtient la raison pour laquelle un nom de compte Video Indexer n’a pas pu être utilisé. L’élément Reason est retourné uniquement si NameAvailable a la valeur false.

ErrorDefinition

Object

Définition d’erreur.

Nom	Type	Description
code	string	Code d’erreur spécifique au service qui sert de sous-état pour le code d’erreur HTTP.
details	ErrorDefinition[]	Détails de l’erreur interne.
message	string	Description de l’erreur.

ErrorResponse

Object

Réponse d’erreur.

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

Reason

Enumeration

Obtient la raison pour laquelle un nom de compte Video Indexer n’a pas pu être utilisé. L’élément Reason est retourné uniquement si NameAvailable a la valeur false.

Valeur	Description
AlreadyExists

Type

Enumeration

Type de ressource, Microsoft.VideoIndexer/accounts

Valeur	Description
Microsoft.VideoIndexer/accounts