Udostępnij za pośrednictwem


Praca z kontenerem głównym

Kontener główny służy jako domyślny kontener dla konta magazynu. Konto magazynu może mieć jeden kontener główny. Kontener główny musi zostać jawnie utworzony i musi mieć nazwę $root.

Obiekt blob przechowywany w kontenerze głównym może zostać rozwiązany bez odwoływania się do nazwy kontenera głównego, dzięki czemu obiekt blob może być adresowany na najwyższym poziomie hierarchii konta magazynu. Na przykład można odwołać się do obiektu blob znajdującego się w kontenerze głównym w następujący sposób:

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

Zarządzanie kontenerem głównym

Aby użyć kontenera głównego z kontem magazynu, utwórz nowy kontener o nazwie $root. Następujące przykładowe żądanie pokazuje, jak utworzyć kontener główny:

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=  

Możesz również usunąć kontener główny, jeśli nie jest już potrzebny.

Podobnie jak w przypadku innych kontenerów, kontener główny można udostępnić na potrzeby anonimowego dostępu publicznego. Kontener można ustawić jako publiczny, ustawiając x-ms-blob-public-access nagłówek podczas tworzenia kontenera lub wywołując opcję Ustaw listę kontroli dostępu kontenera po jego utworzeniu. Aby uzyskać więcej informacji, zobacz Ograniczanie dostępu do kontenerów i obiektów blob .

Jeśli kontener główny jest obecny, zostanie wyświetlony podczas wykonywania operacji Wyświetlanie kontenerów na koncie magazynu.

Podczas wykonywania operacji Wyświetlanie listy obiektów blob względem kontenera głównego kontener główny nie jest wyświetlany w zwracanych adresach URL zasobów dla obiektów blob. Następująca składnia żądania pokazuje, jak wywołać metodę List Blobs względem kontenera głównego:

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

Ważne

Obiekt blob w kontenerze głównym nie może zawierać ukośnika (/) w nazwie.

Przykłady

W poniższych przykładach pokazano, jak pracować z zasobami kontenera i obiektów blob, w tym z kontenerem głównym:

Operacje GET

Aby wyświetlić listę kontenerów na koncie magazynu:

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

Aby uzyskać właściwości kontenera:

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

Aby wyświetlić listę obiektów blob w kontenerze o nazwie mycontainer:

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

Aby wyświetlić listę obiektów blob w kontenerze głównym:

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

Aby odczytać obiekt blob o nazwie myfile z kontenera o nazwie mycontainer:

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

Aby odczytać obiekt blob o nazwie myphoto z kontenera głównego:

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

Możesz również jawnie odwołać się do kontenera głównego:

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

Aby odczytać metadane obiektu blob w obiekcie blob w kontenerze głównym:

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

Możesz również jawnie odwołać się do kontenera głównego:

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

Uwaga

Należy zachować ostrożność, aby uniknąć dołączania ukośnika końcowego (/) podczas odwoływania się do obiektu blob w kontenerze głównym. Na przykład adres URL, taki jak poniżej, powoduje teraz kod stanu 400 (nieprawidłowe żądanie):

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

W powyższym przykładzie usługa Blob odczytuje nazwę kontenera jako myblob i oczekuje, że po ukośniku zostanie wyświetlona nazwa obiektu blob. Żądanie jest źle sformułowane z powodu brakującej nazwy obiektu blob.

Następujący adres URL jest prawidłowy dla operacji na obiekcie blob w kontenerze głównym:

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

Operacje PUT

Aby utworzyć kontener o nazwie mycontainer:

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

Aby utworzyć obiekt blob o nazwie myblob w kontenerze głównym:

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

Można również jawnie określić kontener główny:

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

Aby utworzyć obiekt blob o nazwie myblob w kontenerze o nazwie mycontainer:

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

Aby utworzyć obiekt blob o nazwie photos/myphoto w kontenerze o nazwie mycontainer:

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

Aby ustawić metadane obiektu blob o nazwie myblob w kontenerze głównym:

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

Operacje USUWANIA

Aby usunąć kontener o nazwie mycontainer:

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

Aby usunąć kontener główny:

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

Aby usunąć obiekt blob myblob z kontenera głównego:

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

Można również jawnie określić kontener główny:

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

Zobacz też

Operacje HTTP na zasobach usługi Blob Service
Nazewnictwo i odwoływanie się do kontenerów, obiektów blob i metadanych
Przechowywanie wersji dla usług Azure Storage