Namespaces - Check Name Availability

Service:

Relay

API-versie:

2024-01-01

Controleer de beschikbaarheid van de opgegeven naamruimtenaam.

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

URI-parameters

Name	In	Vereist	Type	Description
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
name	True	string	De naamruimtenaam om te controleren op beschikbaarheid. De naam van de naamruimte mag alleen letters, cijfers en afbreekstreepjes bevatten. De naamruimte moet beginnen met een letter en moet eindigen met een letter of cijfer.

Antwoorden

Name	Type	Description
200 OK	CheckNameAvailabilityResult	De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

RelayCheckNameAvailability

Voorbeeldaanvraag

HTTP

POST https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.Relay/checkNameAvailability?api-version=2024-01-01

{
  "name": "example-RelayNamespace1321"
}

Voorbeeldrespons

Statuscode:

200

{
  "message": "",
  "nameAvailable": true,
  "reason": "None"
}

Definities

Name	Description
CheckNameAvailability	Beschrijving van de eigenschappen van de beschikbaarheidsaanvraag voor de controlenaam.
CheckNameAvailabilityResult	Beschrijving van de eigenschappen van de beschikbaarheidsaanvraag voor de controlenaam.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
UnavailableReason	Geeft de reden op voor de niet-beschikbaarheid van de service.

CheckNameAvailability

Object

Beschrijving van de eigenschappen van de beschikbaarheidsaanvraag voor de controlenaam.

Name	Type	Description
name	string	De naamruimtenaam om te controleren op beschikbaarheid. De naam van de naamruimte mag alleen letters, cijfers en afbreekstreepjes bevatten. De naamruimte moet beginnen met een letter en moet eindigen met een letter of cijfer.

CheckNameAvailabilityResult

Object

Beschrijving van de eigenschappen van de beschikbaarheidsaanvraag voor de controlenaam.

Name	Type	Description
message	string	De gedetailleerde informatie over de reden die aan de naamruimte is gekoppeld.
nameAvailable	boolean	Waarde die aangeeft dat de naamruimte beschikbaar is. Retourneert waar als de naamruimte beschikbaar is; anders, onwaar.
reason	UnavailableReason	De reden voor niet-beschikbaarheid van een naamruimte.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

UnavailableReason

Inventarisatie

Geeft de reden op voor de niet-beschikbaarheid van de service.

Waarde	Description
None
InvalidName
SubscriptionIsDisabled
NameInUse
NameInLockdown
TooManyNamespaceInCurrentSubscription