Arbeiten mit dem Stammcontainer

Artikel
08/04/2023

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