Práce s kořenovým kontejnerem
Kořenový kontejner slouží jako výchozí kontejner pro váš účet úložiště. Účet úložiště může mít jeden kořenový kontejner. Kořenový kontejner musí být explicitně vytvořený a musí mít název $root.
Objekt blob uložený v kořenovém kontejneru je možné adresovat bez odkazu na název kořenového kontejneru, aby bylo možné objekt blob adresovat na nejvyšší úrovni hierarchie účtu úložiště. Můžete například odkazovat na objekt blob, který se nachází v kořenovém kontejneru, následujícím způsobem:
https://myaccount.blob.core.windows.net/mywebpage.html
Správa kořenového kontejneru
Pokud chcete kořenový kontejner použít se svým účtem úložiště, vytvořte nový kontejner s názvem $root. Následující ukázkový požadavek ukazuje, jak vytvořit kořenový kontejner:
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=
Pokud už kořenový kontejner nepotřebujete, můžete ho odstranit.
Stejně jako jiné kontejnery je možné kořenový kontejner zpřístupnit anonymnímu veřejnému přístupu. Kontejner můžete zveřejnit nastavením x-ms-blob-public-access hlavičky při vytvoření kontejneru nebo zavoláním seznamu ACL nastavit kontejner poté, co už existuje. Další informace najdete v tématu Omezení přístupu ke kontejnerům a objektům blob .
Pokud kořenový kontejner existuje, zobrazí se při provádění operace výpisu kontejnerů s účtem úložiště.
Když provedete operaci výpisu objektů blob s kořenovým kontejnerem, kořenový kontejner se nezobrazí v adresách URL prostředků vrácených objektů blob. Následující syntaxe požadavku ukazuje, jak provést volání List Blobs proti kořenovému kontejneru:
GET https://myaccount.blob.core.windows.net/$root?restype=container&comp=list HTTP/1.1
Důležité
Objekt blob v kořenovém kontejneru nesmí v názvu obsahovat lomítko (/).
Příklady
Následující příklady ukazují, jak pracovat s prostředky kontejneru a objektů blob, včetně kořenového kontejneru:
Operace GET
Výpis kontejnerů v účtu úložiště:
GET https://myaccount.blob.core.windows.net/?comp=list
Získání vlastností kontejneru:
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container
Výpis objektů blob v kontejneru s názvem mycontainer:
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list
Výpis objektů blob v kořenovém kontejneru:
GET https://myaccount.blob.core.windows.net/$root?restype=container&comp=list
Čtení objektu blob s názvem myfile z kontejneru s názvem mycontainer:
GET https://myaccount.blob.core.windows.net/mycontainer/myfile
Čtení objektu blob s názvem myphoto z kořenového kontejneru:
GET https://myaccount.blob.core.windows.net/myphoto
Na kořenový kontejner můžete také explicitně odkazovat:
GET https://myaccount.blob.core.windows.net/$root/myphoto
Čtení metadat objektu blob v objektu blob v kořenovém kontejneru:
GET https://myaccount.blob.core.windows.net/myphoto?comp=metadata
Na kořenový kontejner můžete také explicitně odkazovat:
GET https://myaccount.blob.core.windows.net/$root/myphoto?comp=metadata
Poznámka
Při odkazování na objekt blob pod kořenovým kontejnerem dávejte pozor, abyste se vyhnuli zahrnutí koncového lomítka (/). Například adresa URL, jako je například následující, teď má za následek stavový kód 400 (Chybný požadavek):
https://myaccount.blob.core.windows.net/myblob/
Ve výše uvedeném příkladu služba Blob service přečte název kontejneru jako myblob a očekává, že se za koncovým lomítkem zobrazí název objektu blob. Požadavek je poškozený kvůli chybějícímu názvu objektu blob.
Následující adresa URL je platná pro operaci s objektem blob v kořenovém kontejneru:
https://myaccount.blob.core.windows.net/myblob
Operace PUT
Vytvoření kontejneru s názvem mycontainer:
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container
Vytvoření objektu blob s názvem myblob v kořenovém kontejneru:
PUT https://myaccount.blob.core.windows.net/myblob
Můžete také explicitně zadat kořenový kontejner:
PUT https://myaccount.blob.core.windows.net/$root/myblob
Vytvoření objektu blob s názvem myblob v kontejneru s názvem mycontainer:
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob
Vytvoření objektu blob s názvem photos/myphoto v kontejneru s názvem mycontainer:
PUT https://myaccount.blob.core.windows.net/mycontainer/photos/myphoto
Nastavení metadat pro objekt blob s názvem myblob v kořenovém kontejneru:
PUT https://myaccount.blob.core.windows.net/myblob?comp=metadata
Operace DELETE
Odstranění kontejneru s názvem mycontainer:
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container
Odstranění kořenového kontejneru:
DELETE https://myaccount.blob.core.windows.net/$root?restype=container
Odstranění objektu blob myblob z kořenového kontejneru:
DELETE https://myaccount.blob.core.windows.net/myblob
Můžete také explicitně zadat kořenový kontejner:
DELETE https://myaccount.blob.core.windows.net/$root/myblob
Viz také
Operace HTTP s prostředky služby Blob Service
Pojmenování a odkazování na kontejnery, objekty blob a metadata
Správa verzí pro služby Azure Storage