Dela via


Vaults - Check Name Availability

Kontrollerar att valvnamnet är giltigt och inte redan används.

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

URI-parametrar

Name I Obligatorisk Typ Description
subscriptionId
path True

string

Prenumerationsautentiseringsuppgifter som unikt identifierar Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.

api-version
query True

string

Klient-API-version.

Begärandetext

Name Obligatorisk Typ Description
name True

string

Valvnamnet.

type True

Type

Typen av resurs, Microsoft.KeyVault/vaults

Svar

Name Typ Description
200 OK

CheckNameAvailabilityResult

OK – Åtgärden för att kontrollera tillgängligheten för valvnamnet lyckades.

Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Exempel

Validate a vault name

Exempelbegäran

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.KeyVault/checkNameAvailability?api-version=2024-11-01

{
  "name": "sample-vault",
  "type": "Microsoft.KeyVault/vaults"
}

Exempelsvar

{
  "nameAvailable": true
}

Definitioner

Name Description
CheckNameAvailabilityResult

Åtgärdssvaret CheckNameAvailability.

CloudError

Ett felsvar från 密钥保管库 resursprovidern

CloudErrorBody

Ett felsvar från 密钥保管库 resursprovidern

Reason

Anledningen till att ett valvnamn inte kunde användas. Elementet Reason returneras bara om NameAvailable är false.

Type

Typen av resurs, Microsoft.KeyVault/vaults

VaultCheckNameAvailabilityParameters

Parametrarna som används för att kontrollera tillgängligheten för valvnamnet.

CheckNameAvailabilityResult

Åtgärdssvaret CheckNameAvailability.

Name Typ Description
message

string

Ett felmeddelande som förklarar värdet Reason mer detaljerat.

nameAvailable

boolean

Ett booleskt värde som anger om namnet är tillgängligt för dig att använda. Om det är sant är namnet tillgängligt. Om det är falskt har namnet redan tagits eller är ogiltigt och kan inte användas.

reason

Reason

Anledningen till att ett valvnamn inte kunde användas. Elementet Reason returneras bara om NameAvailable är false.

CloudError

Ett felsvar från 密钥保管库 resursprovidern

Name Typ Description
error

CloudErrorBody

Ett felsvar från 密钥保管库 resursprovidern

CloudErrorBody

Ett felsvar från 密钥保管库 resursprovidern

Name Typ Description
code

string

Felkod. Detta är en mnemonik som kan användas programmatiskt.

message

string

Användarvänligt felmeddelande. Meddelandet är vanligtvis lokaliserat och kan variera beroende på tjänstversion.

Reason

Anledningen till att ett valvnamn inte kunde användas. Elementet Reason returneras bara om NameAvailable är false.

Värde Description
AccountNameInvalid
AlreadyExists

Type

Typen av resurs, Microsoft.KeyVault/vaults

Värde Description
Microsoft.KeyVault/vaults

VaultCheckNameAvailabilityParameters

Parametrarna som används för att kontrollera tillgängligheten för valvnamnet.

Name Typ Description
name

string

Valvnamnet.

type

Type

Typen av resurs, Microsoft.KeyVault/vaults