(0) exportieren Drucken
Alle erweitern

Arbeiten mit dem Stammcontainer (REST-API)

Letzte Aktualisierung: November 2013

Ein Stammcontainer dient als Standardcontainer für Ihr Speicherkonto. Ein Speicherkonto kann über einen Stammcontainer verfügen. Der Stammcontainer muss explizit erstellt und als $root benannt werden.

Da ein im Stammcontainer gespeichertes BLOB ohne Verweis auf den Namen des Stammcontainers adressiert werden kann, ist es möglich, ein BLOB auf oberster Ebene der Speicherkontohierarchie zu adressieren. Beispielsweise können Sie jetzt wie folgt auf ein BLOB verweisen, das sich im Stammcontainer befindet:

shttps://myaccount.blob.core.windows.net/mywebpage.html

Um den Stammcontainer mit Ihrem Speicherkonto zu verwenden, erstellen Sie einen neuen Container mit dem Namen $root. Die folgende Beispielanforderung veranschaulicht, wie der Stammcontainer erstellt wird:

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
x-ms-blob-public-access: container
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

Sie können den Stammcontainer auch löschen, wenn dieser nicht mehr erforderlich ist.

Ebenso wie andere Container kann der Stammcontainer für den anonymen öffentlichen Zugriff bereitgestellt werden. Sie können den Container als öffentlich festlegen, indem Sie beim Erstellen des Containers den Header x-ms-blob-public-access festlegen oder indem Sie Set Container ACL (REST-API) aufrufen, wenn der Container bereits vorhanden ist. Weitere Informationen finden Sie unter Beschränken des Zugriffs auf Container und BLOBs.

Wenn der Stammcontainer vorhanden ist, wird dieser angezeigt, wenn Sie den List Containers (REST-API)-Vorgang für das Speicherkonto ausführen.

Wenn Sie einen List Blobs (REST-API)-Vorgang für den Stammcontainer ausführen, wird der Stammcontainer nicht in den Ressourcen-URLs für die zurückgegebenen BLOBs angezeigt. Die folgende Anforderungssyntax zeigt, wie List Blobs für den Stammcontainer aufgerufen wird:

GET https://myaccount.blob.core.windows.net/$root?restype=container&comp=list HTTP/1.1
ImportantWichtig
Der Name eines BLOB im Stammcontainer kann keinen Schrägstrich (/) enthalten.

In den folgenden Beispielen wird das Arbeiten mit Container- und BLOB-Ressourcen, einschließlich des Stammcontainers, gezeigt:

So listen Sie die Container eines Speicherkontos auf

GET https://myaccount.blob.core.windows.net/?comp=list

So rufen Sie die Eigenschaften eines Containers ab

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

So listen Sie die BLOBs in einem Container mit dem Namen mycontainer auf

GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list

So listen Sie die BLOBs im Stammcontainer auf

GET https://myaccount.blob.core.windows.net/$root?restype=container&comp=list

So lesen Sie ein BLOB mit dem Namen myfile aus einem Container mit dem Namen mycontainer

GET https://myaccount.blob.core.windows.net/mycontainer/myfile

So lesen Sie ein BLOB mit dem Namen myphoto aus dem Stammcontainer

GET https://myaccount.blob.core.windows.net/myphoto

Sie können auch explizit auf den Stammcontainer verweisen:

GET https://myaccount.blob.core.windows.net/$root/myphoto

So lesen Sie BLOB-Metadaten für ein BLOB im Stammcontainer

GET https://myaccount.blob.core.windows.net/myphoto?comp=metadata

Sie können auch explizit auf den Stammcontainer verweisen:

GET https://myaccount.blob.core.windows.net/$root/myphoto?comp=metadata
noteHinweis
Achten Sie darauf, keinen nachfolgenden Schrägstrich (/) einzuschließen, wenn Sie auf ein BLOB unter dem Stammcontainer verweisen. Beispielsweise ergibt eine URL wie die folgende nun den Statuscode 400 (Ungültige Anforderung):

https://myaccount.blob.core.windows.net/myblob/

Im obigen Beispiel liest der Blob-Dienst den Containernamen als myblob und erwartet einen BLOB-Namen nach dem nachgestellten Schrägstrich. Da der BLOB-Name fehlt, ist das Format der Anforderung ungültig.

Die folgende URL ist für einen Vorgang für einen BLOB im Stammcontainer gültig:

https://myaccount.blob.core.windows.net/myblob

So erstellen Sie einen Container mit dem Namen mycontainer


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

So erstellen Sie ein BLOB mit dem Namen myblob im Stammcontainer


PUT https://myaccount.blob.core.windows.net/myblob

Sie können den Stammcontainer auch explizit angeben:


PUT https://myaccount.blob.core.windows.net/$root/myblob

So erstellen Sie ein BLOB mit dem Namen myblob in einem Container mit dem Namen mycontainer

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob

So erstellen Sie ein BLOB mit dem Namen photos/myphoto in einem Container mit dem Namen mycontainer

PUT https://myaccount.blob.core.windows.net/mycontainer/photos/myphoto

So legen Sie Metadaten für ein BLOB mit dem Namen myblob im Stammcontainer fest


PUT https://myaccount.blob.core.windows.net/myblob?comp=metadata

So löschen Sie einen Container mit dem Namen mycontainer


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

So löschen Sie den Stammcontainer


DELETE https://myaccount.blob.core.windows.net/$root?restype=container

So löschen Sie das BLOB aus dem myblob-Stammcontainer


DELETE https://myaccount.blob.core.windows.net/myblob

Sie können den Stammcontainer auch explizit angeben:


DELETE https://myaccount.blob.core.windows.net/$root/myblob

Siehe auch

Anzeigen:
© 2014 Microsoft