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 "Container-ACL festlegen" 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 Listencontainervorgang für das Speicherkonto ausführen.

Wenn Sie einen Listen-Blobs-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  

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)