Überprüfen der Verfügbarkeit eines Cloud-Dienstnamens

Artikel
07/19/2023

Der Vorgang Check Hosted Service Name Availability überprüft, ob der angegebene Name des Cloud-Diensts verfügbar ist.

Anforderung

Die Check Hosted Service Name Availability-Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch die Abonnement-ID und <cloudservice-name> durch den Cloud-Dienst-Namen, den Sie verwenden möchten.

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

URI-Parameter

Keine.

Anforderungsheader

In der folgenden Tabelle werden die Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
`x-ms-version`	Erforderlich. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Dieser Header sollte auf `2012-03-01` oder höher festgelegt werden.

Anforderungstext

Keine.

Antwort

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten.

Antwortheader	BESCHREIBUNG
`x-ms-request-id`	Ein Wert, der eine für den Verwaltungsdienst ausgeführte Anforderung eindeutig identifiziert.

Antworttext

Der Antworttext weist das folgende Format auf:

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

In der folgenden Tabelle werden die Elemente im Antworttext beschrieben.

Elementname BESCHREIBUNG

Ergebnis Ein boolescher Wert, der angibt, ob der Name für Sie verfügbar ist. true , wenn der Name verfügbar ist; andernfalls false.

Bei Versionen vor 2013-03-01 gab der Vorgang true für nicht belegte Namen zurück, auch wenn sie reserviert oder profan waren. Mit Versionsheadern ab 2013-03-01 gibt der Vorgang für reservierte oder profane Wörter false.

`Reason` Gibt an, warum der Cloud-Dienst nicht mit dem Namen erstellt werden kann.

Mögliche Werte:

- HostedServiceAlreadyExists – wird zurückgegeben, wenn der Clouddienstname bereits vorhanden ist.
- HostedServiceNameNotValid – wird zurückgegeben, wenn der Clouddienstname nicht unterstützte Zeichen, reservierte Wörter oder profane Wörter verwendet.

Das Reason Element ist nur mit Version 2013-03-01 oder höher verfügbar.

Elementname	BESCHREIBUNG
Ergebnis	Ein boolescher Wert, der angibt, ob der Name für Sie verfügbar ist. `true` , wenn der Name verfügbar ist; andernfalls `false`. Bei Versionen vor 2013-03-01 gab der Vorgang `true` für nicht belegte Namen zurück, auch wenn sie reserviert oder profan waren. Mit Versionsheadern ab 2013-03-01 gibt der Vorgang für reservierte oder profane Wörter `false`.
`Reason`	Gibt an, warum der Cloud-Dienst nicht mit dem Namen erstellt werden kann. Mögliche Werte: - `HostedServiceAlreadyExists` – wird zurückgegeben, wenn der Clouddienstname bereits vorhanden ist. - `HostedServiceNameNotValid` – wird zurückgegeben, wenn der Clouddienstname nicht unterstützte Zeichen, reservierte Wörter oder profane Wörter verwendet. Das `Reason` Element ist nur mit Version 2013-03-01 oder höher verfügbar.

Freigeben über