Get Container Properties
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Get Container Properties

 

Die Get Container Properties Operation gibt alle benutzerdefinierten Metadaten und Systemeigenschaften für den angegebenen Container zurück. Die zurückgegebenen Daten enthalten nicht die Liste von BLOBs des Containers.

Die Get Container Properties -Anforderung kann wie folgt erstellt werden. HTTPS wird empfohlen. Ersetzen Sie Myaccount mit dem Namen Ihres Speicherkontos:

Methode

Anforderungs-URI

HTTP-Version

GET/HEAD

https://myaccount.blob.core.windows.net/mycontainer?restype=container

HTTP/1.1

Wenn eine Anforderung für den emulierten Speicherdienst ausführen, geben Sie den emulatorhostnamen und den Port des Blob-Dienst als 127.0.0.1:10000, gefolgt vom Namen emulierten Speicherkontos:

Methode

Anforderungs-URI

HTTP-Version

GET/HEAD

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container

HTTP/1.1

Weitere Informationen finden Sie unter mithilfe der Azure-Speicheremulator für Entwicklungs- und.

Im Anforderungs-URI können die folgenden zusätzlichen Parameter angegeben werden.

Parameter

Beschreibung

timeout

Optional. Die timeout Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Blob-Dienstvorgänge.

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader

Beschreibung

Authorization

Erforderlich. Gibt das Authentifizierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Authentifizierung für die Azure-Speicherdienste.

Date oder x-ms-date

Erforderlich. Gibt die Uhrzeit der Anforderung in koordinierter Weltzeit (UTC) an. Weitere Informationen finden Sie unter Authentifizierung für die Azure-Speicherdienste.

x-ms-lease-id: <ID>

Optional, Version 2012-02-12 und höher. Wenn angegeben, Get Container Properties ist nur erfolgreich, wenn die Lease des Containers aktiv ist und mit dieser ID übereinstimmt. Wenn keine aktive Lease vorhanden ist oder die ID nicht übereinstimmt, 412 (Precondition Failed) zurückgegeben.

x-ms-version

Für alle authentifizierten Anforderungen erforderlich, für anonyme Anforderungen optional. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionskontrolle für Azure-Speicherdienste.

x-ms-client-request-id

Optional. Stellt einen vom Client generierten, nicht transparenten Wert mit einer Zeichenbeschränkung von 1 KB bereit, der bei Aktivierung der Speicheranalyse-Protokollierung in den Analyseprotokollen erfasst wird. Die Verwendung dieses Headers wird dringend empfohlen, um clientseitige Aktivitäten mit den vom Server empfangenen Anforderungen zu korrelieren. Weitere Informationen finden Sie unter Informationen zur Protokollierung durch die Speicheranalyse und Azure-Protokollierung: Mithilfe von Protokollen zur Track-Speicheranforderungen.

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

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

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

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-Protokollspezifikation.

Antwortheader

Beschreibung

x-ms-meta-name:value

Gibt eine Zeichenfolge mit einem Name-Wert-Paar zurück, das dem Container als Metadaten zugeordnet ist.

ETag

Das Entitätstag für den Container. Wenn die Anforderungsversion 2011-08-18 oder höher ist, wird der ETag-Wert in Anführungszeichen eingeschlossen.

Last-Modified

Gibt das Datum und die Uhrzeit der letzten Änderung des Containers zurück. Das Datumsformat entspricht RFC 1123. Weitere Informationen finden Sie unter Darstellung von Datums-/Uhrzeitwerten in Headern.

Bei jedem Vorgang, durch den der Container, seine Eigenschaften oder seine Metadaten geändert werden, wird der Zeitpunkt der letzten Änderung aktualisiert. Vorgänge für BLOBs sind ohne Auswirkung auf den Zeitpunkt der letzten Änderung des Containers.

x-ms-lease-status: <locked | unlocked>

Version 2012-02-12 und höher. Der Leasestatus des Containers.

x-ms-lease-state: <available | leased | expired | breaking | broken>

Version 2012-02-12 und höher. Der Leasezustand des Containers.

x-ms-lease-duration: <infinite | fixed >

Version 2012-02-12 und neuer – nur, wenn der Container geleast ist. Gibt an, ob die Lease eines Containers von unbegrenzter oder fester Dauer ist.

x-ms-request-id

Dieser Header identifiziert die erfolgte Anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung bei API-Vorgänge.

x-ms-version

Version 2009-09-19 und höher. Gibt die Version des Blob-Diensts an, der zum Ausführen der Abfrage verwendet wird.

Wird auch für anonyme Anforderungen ohne Versionsangabe zurückgegeben, wenn der Container mit Version 2009-09-19 des Blob-Diensts für öffentlichen Zugriff markiert wurde.

Date

Ein vom Dienst generierter Datums-/Uhrzeitwert in UTC, der angibt, wann die Antwort initiiert wurde.

Keiner.

Response Status: HTTP/1.1 200 OK Response Headers: Transfer-Encoding: chunked x-ms-meta-Name: StorageSample Date: Sun, 25 Sep 2011 12:43:08 GMT ETag: "0x8CAFB82EFF70C46" Last-Modified: Sun, 25 Sep 2011 10:42:18 GMT x-ms-version: 2011-08-18 Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Wenn die Zugriffssteuerungsliste des Containers anonymen Zugriff auf den Container zulässt, kann dieser Vorgang von jedem Client aufgerufen werden. Wenn der Container privat ist, kann dieser Vorgang vom Kontobesitzer ausgeführt werden.

Keiner.

Anzeigen:
© 2016 Microsoft