VERTRIEB: 1-800-867-1380

Create Container

Letzte Aktualisierung: Februar 2015

Der Create Container-Vorgang erstellt einen neuen Container unter dem angegebenen Konto. Wenn ein Container mit demselben Namen bereits vorhanden ist, schlägt der Vorgang fehl.

Die Containerressource enthält Metadaten und Eigenschaften für den betreffenden Container. Sie schließt keine Liste der BLOBs ein, die im Container enthalten sind.

Die Create Container-Anforderung kann wie folgt erstellt werden. HTTPS wird empfohlen. Der mycontainer-Wert darf nur Kleinbuchstaben enthalten. Ersetzen Sie myaccount durch den Namen Ihres Speicherkontos:

 

Methode Anforderungs-URI HTTP-Version

PUT

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

HTTP/1.1

Wenn Sie eine Anforderung für den emulierten Speicherdienst ausführen, geben Sie den Emulatorhostnamen und den Port des Blob-Diensts mit 127.0.0.1:10000 an, gefolgt vom Namen des emulierten Speicherkontos:

 

Methode Anforderungs-URI HTTP-Version

PUT

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

HTTP/1.1

Weitere Informationen finden Sie unter Einsatz des Azure-Speicheremulators für Entwicklung und Tests und Unterschiede zwischen dem Speicheremulator und den Azure-Speicherdiensten.

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

 

Parameter Beschreibung

timeout

Optional. Der 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-version

Erforderlich für alle authentifizierten Anforderungen. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionsverwaltung für den Blob-Dienst, den Warteschlangendienst und den Tabellendienst in Windows Azure.

x-ms-meta-name:value

Optional. Ein Name-Wert-Paar, das dem Container als Metadaten zugeordnet wird.

Beachten Sie, dass ab Version 2009-09-19 Metadatennamen den Benennungsregeln für C#-Bezeichner entsprechen müssen.

x-ms-blob-public-access

Optional. Gibt an, ob öffentlicher Zugriff auf Daten im Container zulässig ist, und gibt die Zugriffsebene an. Zulässige Werte:

  • container: Gibt vollständigen öffentlichen Lesezugriff für Container- und BLOB-Daten an. Clients können BLOBs innerhalb des Containers über anonyme Anforderungen auflisten, Container innerhalb des Speicherkontos können jedoch nicht aufgelistet werden.

  • blob:: Gibt öffentlichen Lesezugriff für BLOBs an. BLOB-Daten im Container können per anonymer Anforderung gelesen werden, Containerdaten sind jedoch nicht verfügbar. Clients können BLOBs innerhalb des Containers nicht über anonyme Anforderungen auflisten.

Wenn dieser Header nicht in der Anforderung enthalten ist, sind Containerdaten für den Kontobesitzer privat.

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-Speicherprotokollierung: Verwenden von Protokollen zur Nachverfolgung von Speicheranforderungen.

Request Syntax:
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1
Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

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

Bei einem erfolgreichen Vorgang wird der Statuscode 201 (Erstellt) zurückgegeben.

Weitere 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

ETag

Das ETag 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-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 für API-Vorgänge.

x-ms-version

Gibt die Version des Blob-Diensts an, der zum Ausführen der Abfrage verwendet wird. Dieser Header wird für Anforderungen zurückgegeben, die für Version 2009-09-19 und höher erfolgen.

Date

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

Keine.

Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Date: Sun, 25 Sep 2011 23:00:12 GMT
ETag: “0x8CB14C3E29B7E82”
Last-Modified: Sun, 25 Sep 2011 23:00:06 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Dieser Vorgang kann nur vom Kontobesitzer aufgerufen werden.

Container werden direkt unter dem Speicherkonto erstellt. Container können nicht ineinander geschachtelt werden.

Sie können optional einen Standard- oder Stammcontainer für Ihr Speicherkonto erstellen. Der Stammcontainer kann von einer URL abgeleitet sein, die eine BLOB-Ressource anfordert. Der Stammcontainer ermöglicht es, auf ein BLOB von der obersten Ebene der Hierarchie des Speicherkontos zu verweisen, ohne dass dabei auf den Containernamen verwiesen wird.

Erstellen Sie einen Container mit dem Namen $root, um den Stammcontainer dem Speicherkonto hinzuzufügen. Bauen Sie die Anforderung wie folgt auf:

Request Syntax:
PUT https://myaccount.blob.core.windows.net/$root?restype=container HTTP/1.1
Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

Beim Erstellen eines Containers können Sie Metadaten für den Container angeben, indem Sie einen oder mehrere Metadatenheader in die Anforderung einschließen. Das Format für den Metadatenheader ist x-ms-meta-name:value.

Wenn ein Container mit demselben Namen beim Aufruf von Create Container gelöscht wird, gibt der Server Statuscode 409 (Konflikt) zurück, mit zusätzlichen Fehlerinformationen, in denen auf das Löschen des Containers hingewiesen wird.

Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Anzeigen:
© 2015 Microsoft