Vaults - Check Name Availability
Vérifie que le nom du coffre est valide et qu’il n’est pas déjà utilisé.
POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.KeyVault/checkNameAvailability?api-version=2022-07-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
subscription
|
path | True |
string |
Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service. |
api-version
|
query | True |
string |
Version de l’API cliente. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
name | True |
string |
Nom du coffre. |
type | True |
Type de ressource, Microsoft.KeyVault/vaults |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
OK - L’opération de case activée la disponibilité du nom du coffre a réussi. |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Exemples
Validate a vault name
Sample Request
Sample Response
{
"nameAvailable": true
}
Définitions
Nom | Description |
---|---|
Check |
Réponse de l’opération CheckNameAvailability. |
Cloud |
Réponse d’erreur de Key Vault fournisseur de ressources |
Cloud |
Réponse d’erreur de Key Vault fournisseur de ressources |
Reason |
Raison pour laquelle un nom de coffre n’a pas pu être utilisé. L’élément Reason est retourné uniquement si NameAvailable a la valeur false. |
Type |
Type de ressource, Microsoft.KeyVault/vaults |
Vault |
Les paramètres utilisés pour case activée la disponibilité du nom du coffre. |
CheckNameAvailabilityResult
Réponse de l’opération CheckNameAvailability.
Nom | Type | Description |
---|---|---|
message |
string |
Message d’erreur expliquant plus en détail la valeur Reason. |
nameAvailable |
boolean |
Valeur booléenne qui indique si le nom est disponible pour vous. Si la valeur est true, le nom est disponible. Si la valeur est false, le nom a déjà été pris ou n’est pas valide et ne peut pas être utilisé. |
reason |
Raison pour laquelle un nom de coffre n’a pas pu être utilisé. L’élément Reason est retourné uniquement si NameAvailable a la valeur false. |
CloudError
Réponse d’erreur de Key Vault fournisseur de ressources
Nom | Type | Description |
---|---|---|
error |
Réponse d’erreur de Key Vault fournisseur de ressources |
CloudErrorBody
Réponse d’erreur de Key Vault fournisseur de ressources
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur. Il s’agit d’un mnémonique qui peut être consommé par programmation. |
message |
string |
Message d’erreur convivial. Le message est généralement localisé et peut varier en fonction de la version du service. |
Reason
Raison pour laquelle un nom de coffre n’a pas pu être utilisé. L’élément Reason est retourné uniquement si NameAvailable a la valeur false.
Nom | Type | Description |
---|---|---|
AccountNameInvalid |
string |
|
AlreadyExists |
string |
Type
Type de ressource, Microsoft.KeyVault/vaults
Nom | Type | Description |
---|---|---|
Microsoft.KeyVault/vaults |
string |
VaultCheckNameAvailabilityParameters
Les paramètres utilisés pour case activée la disponibilité du nom du coffre.
Nom | Type | Description |
---|---|---|
name |
string |
Nom du coffre. |
type |
Type de ressource, Microsoft.KeyVault/vaults |