Uso del contenitore radice

Articolo
06/27/2023

Un contenitore radice funge da contenitore predefinito per l'account di archiviazione. Un account di archiviazione può avere un contenitore radice. Il contenitore radice deve essere creato in modo esplicito e denominato $root.

È possibile indirizzare un BLOB archiviato nel contenitore radice senza fare riferimento al nome del contenitore radice, in modo da poter indirizzare un BLOB al livello superiore della gerarchia dell'account di archiviazione. Ad esempio, è possibile fare riferimento a un BLOB che risiede nel contenitore radice nel modo seguente:

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

Gestione del contenitore radice

Per usare il contenitore radice con l'account di archiviazione, creare un nuovo contenitore denominato $root. Nell'esempio di richiesta seguente viene illustrato come creare il contenitore radice:

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=

È anche possibile eliminare il contenitore radice se non è più necessario.

Analogamente ad altri contenitori, il contenitore radice può essere reso disponibile per l'accesso pubblico anonimo. È possibile rendere pubblico il contenitore impostando l'intestazione x-ms-blob-public-access al momento della creazione del contenitore oppure chiamando Set Container ACL dopo che esiste già. Per ulteriori informazioni, vedere Limitare l'accesso a contenitori e Blob .

Se il contenitore radice è presente, verrà visualizzato quando si esegue l'operazione List Containers sull'account di archiviazione.

Quando si esegue un'operazione List BLOBs nel contenitore radice, il contenitore radice non viene visualizzato negli URL delle risorse per i BLOB restituiti. Nella sintassi della richiesta seguente viene mostrato come chiamare List Blobs nel contenitore radice:

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

Importante

Un BLOB nel contenitore radice non può includere una barra (/) nel nome.

Esempio

Negli esempi seguenti viene illustrato come usare le risorse BLOB e contenitore, incluso il contenitore radice:

Operazioni GET

Per elencare i contenitori di un account di archiviazione:

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

Per ottenere le proprietà di un contenitore:

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

Per elencare i BLOB in un contenitore denominato mycontainer:

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

Per elencare i BLOB nel contenitore radice:

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

Per leggere un BLOB denominato myfile da un contenitore denominato mycontainer:

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

Per leggere un BLOB denominato myphoto dal contenitore radice:

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

È anche possibile fare riferimento in modo esplicito al contenitore radice:

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

Per leggere i metadati su un BLOB nel contenitore radice:

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

È anche possibile fare riferimento in modo esplicito al contenitore radice:

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

Nota

Evitare di includere una barra finale (/) quando si fa riferimento a un BLOB nel contenitore radice. Ad esempio, un URL come il seguente restituisce ora il codice di stato 400 (Richiesta non valida):

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

Nell'esempio precedente il servizio BLOB legge il nome del contenitore come myblob e si aspetta di trovare un nome di BLOB dopo la barra finale. Il formato della richiesta non è valido a causa del nome di BLOB mancante.

L'URL seguente è valido per un'operazione su un BLOB nel contenitore radice:

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

Operazioni PUT

Per creare un contenitore denominato mycontainer:

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

Per creare un BLOB denominato myblob nel contenitore radice:

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

È anche possibile specificare in modo esplicito il contenitore radice:

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

Per creare un BLOB denominato myblob in un contenitore denominato mycontainer:

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

Per creare un BLOB denominato photos/myphoto in un contenitore denominato mycontainer:

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

Per impostare metadati su un BLOB denominato myblob nel contenitore radice:

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

Operazioni DELETE

Per eliminare un contenitore denominato mycontainer:

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

Per eliminare il contenitore radice:

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

Per eliminare il BLOB myblob dal contenitore radice:

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