Verfügbarkeit eines Speicherkontonamens prüfen

Artikel
06/07/2016

Veröffentlicht: Februar 2016

Die Speicherverfügbarkeit prüfen -Vorgang überprüft, ob der angegebene speicherkontoname verfügbar ist, oder bereits vergeben ist.

Anforderung

Die Speicherverfügbarkeit prüfen -Anforderung kann wie folgt angegeben werden. Ersetzen Sie <subscription-id> durch Ihre Abonnement-ID und <storage-account-name> durch den Namen, die Sie für das Speicherkonto verwenden möchten.

Methode	Anfrage-URI
ABRUFEN	https://management.core.windows.net/<subscription-id>/services/storageservices/operations/isavailable/<storage-account-name>

Sie müssen sicherstellen, dass die Anforderung, die an den Verwaltungsdienst besteht sicher ist. Weitere Informationen finden Sie unter Authentifizieren von Dienstverwaltungsanforderungen.

URI-Parameter

None.

Anforderungsheader

In der folgenden Tabelle werden die Anforderungsheader beschrieben.

Anforderungsheader	Beschreibung
x-ms-version	Erforderlich. Gibt die Version des Vorgangs, der für diese Anforderung verwendet. Dieser Header sollte festgelegt werden, um 2012-03-01 oder höher. Weitere Informationen zu versionsverwaltungsheadern finden Sie unter Dienstverwaltungs-Versionsverwaltung.

Anforderungstext

None.

Antwort

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

Statuscode

Bei einem erfolgreicher Vorgang gibt den Statuscode 200 (OK) zurück. Informationen zu Statuscodes finden Sie unter Dienstverwaltungsstatus und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikationhttps://go.microsoft.com/fwlink/?linkid=150478.

Antwort-Header	Beschreibung
x-ms-request-id	Ein Wert, der eine für den Verwaltungsdienst ausgeführte Anforderung eindeutig identifiziert.

Antworttext

Das Format des Antworttexts lautet wie folgt:

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

In der folgenden Tabelle werden die Elemente im Antworttext beschrieben.

Elementname	Beschreibung
Ergebnis	Gibt einen booleschen Wert, der angibt, ob der Name für die Verwendung verfügbar ist. Wenn true, der Name verfügbar ist. Wenn false, der Name wird bereits verwendet und kann nicht verwendet werden.
Grund	Gibt den Grund, dass ein speicherkontoname nicht verwendet werden konnte. Der Wert true wenn der Name verwendet werden kann. Die Grund -Element ist nur bei Version 2013-03-01 oder höher.

Ergebnis

Gibt einen booleschen Wert, der angibt, ob der Name für die Verwendung verfügbar ist. Wenn true, der Name verfügbar ist. Wenn false, der Name wird bereits verwendet und kann nicht verwendet werden.

Grund

Gibt den Grund, dass ein speicherkontoname nicht verwendet werden konnte. Der Wert true wenn der Name verwendet werden kann.

Die Grund -Element ist nur bei Version 2013-03-01 oder höher.

Freigeben über