Arbeiten mit dem Stammcontainer
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 wie folgt auf ein Blob verweisen, das sich im Stammcontainer befindet:
https://myaccount.blob.core.windows.net/mywebpage.html
Verwalten des Stammcontainers
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 öffentlich machen, indem Sie den x-ms-blob-public-access Header festlegen, wenn der Container erstellt wird, oder indem Sie Set Container ACL aufrufen, nachdem er bereits vorhanden ist. Weitere Informationen finden Sie unter Beschränken des Zugriffs auf Container und BLOBs .
Wenn der Stammcontainer vorhanden ist, wird er angezeigt, wenn Sie den Vorgang Container auflisten für das Speicherkonto ausführen.
Wenn Sie einen Vorgang zum Auflisten von Blobs 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
Wichtig
Der Name eines BLOB im Stammcontainer kann keinen Schrägstrich (/) enthalten.
Beispiele
In den folgenden Beispielen wird das Arbeiten mit Container- und BLOB-Ressourcen, einschließlich des Stammcontainers, gezeigt:
GET-Vorgänge
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
Hinweis
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
PUT-Vorgänge
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
DELETE-Vorgänge
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
Weitere Informationen
HTTP-Vorgänge für Blob-Dienst-Ressourcen
Benennen von Containern, BLOBs und Metadaten und Verweisen auf diese
Versioning for the Azure Storage Services (Versionsverwaltung für Azure Storage-Dienste)