Beschikbaarheid van de naam van de cloudservice controleren

Artikel
07/19/2023

De Check Hosted Service Name Availability bewerking controleert op de beschikbaarheid van de opgegeven naam van de cloudservice.

Aanvraag

De Check Hosted Service Name Availability aanvraag kan als volgt worden opgegeven. Vervang door uw abonnements-id <subscription-id> en <cloudservice-name> door de naam van de cloudservice die u wilt gebruiken.

Methode	Aanvraag-URI
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>`

URI-parameters

Geen.

Aanvraagheaders

In de volgende tabel worden de aanvraagheaders beschreven.

Aanvraagkoptekst	Beschrijving
`x-ms-version`	Vereist. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Deze header moet worden ingesteld op `2012-03-01` of hoger.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een antwoordtekst.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK).

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard-HTTP-headers bevatten.

Reactieheader	Beschrijving
`x-ms-request-id`	Een waarde die een aanvraag die is ingediend bij de beheerservice uniek identificeert.

Hoofdtekst van antwoord

De indeling van de hoofdtekst van het antwoord is als volgt:

  
<?xml version="1.0" encoding="utf-8"?>  
<AvailabilityResponse xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <Result>name-availability</Result>  
  <Reason>reason</Reason>  
</AvailabilityResponse>

In de volgende tabel worden de elementen in de hoofdtekst van het antwoord beschreven.

Elementnaam Beschrijving

Resultaat Een booleaanse waarde die aangeeft of de naam beschikbaar is voor gebruik. true als de naam beschikbaar is; anders false.

Voor versies vóór 2013-03-01 werd de bewerking geretourneerd true voor niet-opgenomen namen, zelfs als deze gereserveerd of aansscheldelijk waren. Met versieheaders van 2013-03-01 en hoger wordt de bewerking geretourneerd false voor gereserveerde of grove woorden.

Reden Geeft aan waarom de naam niet kan worden gebruikt om de cloudservice te maken.

Mogelijke waarden zijn:

- HostedServiceAlreadyExists : geretourneerd als de naam van de cloudservice al bestaat.
- HostedServiceNameNotValid : wordt geretourneerd als de naam van de cloudservice niet-ondersteunde tekens, gereserveerde woorden of grove woorden gebruikt.

Het Reason element is alleen beschikbaar in versie 2013-03-01 of hoger.

Elementnaam	Beschrijving
Resultaat	Een booleaanse waarde die aangeeft of de naam beschikbaar is voor gebruik. `true` als de naam beschikbaar is; anders `false`. Voor versies vóór 2013-03-01 werd de bewerking geretourneerd `true` voor niet-opgenomen namen, zelfs als deze gereserveerd of aansscheldelijk waren. Met versieheaders van 2013-03-01 en hoger wordt de bewerking geretourneerd `false` voor gereserveerde of grove woorden.
Reden	Geeft aan waarom de naam niet kan worden gebruikt om de cloudservice te maken. Mogelijke waarden zijn: - `HostedServiceAlreadyExists` : geretourneerd als de naam van de cloudservice al bestaat. - `HostedServiceNameNotValid` : wordt geretourneerd als de naam van de cloudservice niet-ondersteunde tekens, gereserveerde woorden of grove woorden gebruikt. Het `Reason` element is alleen beschikbaar in versie 2013-03-01 of hoger.

Delen via