Utilisation du conteneur racine

Article
06/27/2023

Un conteneur racine sert de conteneur par défaut pour votre compte de stockage. Un compte de stockage peut avoir un seul conteneur racine. Le conteneur racine doit être explicitement créé et appelé $root.

Un objet blob stocké dans le conteneur racine peut être traité sans référencer le nom du conteneur racine, de cette façon un objet blob peut être traité au niveau supérieur de la hiérarchie du compte de stockage. Par exemple, vous pouvez référencer un objet BLOB qui réside dans le conteneur racine de la manière suivante:

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

Gestion du conteneur racine

Pour utiliser le conteneur racine de votre compte de stockage, créez un nouveau conteneur appelé $root. L'exemple de demande suivant indique comment créer le conteneur racine :

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=

Vous pouvez également supprimer le conteneur racine si vous n'en avez plus besoin.

Comme les autres conteneurs, le conteneur racine peut devenir disponible en accès public anonyme. Vous pouvez rendre le conteneur public en définissant l’en-tête x-ms-blob-public-access lors de la création du conteneur ou en appelant Définir l’ACL du conteneur une fois qu’il existe déjà. Pour plus d’informations, consultez la page Limiter l’accès aux conteneurs et aux objets BLOB .

Si le conteneur racine est présent, il s’affiche lorsque vous effectuez l’opération Répertorier les conteneurs sur le compte de stockage.

Lorsque vous effectuez une opération List Blobs sur le conteneur racine, le conteneur racine n’apparaît pas dans les URL de ressource pour les objets blob retournés. La syntaxe de demande suivante montre comment appeler List Blobs sur le conteneur racine :

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

Important

Un objet blob dans le conteneur racine ne peut pas inclure une barre oblique (/) dans son nom.

Exemples

Les exemples suivants montrent comment utiliser des ressources de conteneur et d'objet blob, notamment le conteneur racine :

Opérations GET

Pour répertorier les conteneurs dans un compte de stockage :

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

Pour obtenir les propriétés d'un conteneur :

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

Pour répertorier les objets blob dans un conteneur nommé mycontainer:

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

Pour répertorier les objets blob dans le conteneur racine :

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

Pour lire un objet blob nommé myfile d'un conteneur nommé mycontainer:

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

Pour lire un objet blob nommé myphoto du conteneur racine :

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

Vous pouvez également explicitement référencer le conteneur racine :

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

Pour lire les métadonnées d'objet blob d'un objet blob dans le conteneur racine :

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

Vous pouvez également explicitement référencer le conteneur racine :

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

Notes

N'incluez pas une barre oblique de fin (/) lors du référencement d'un objet blob sous le conteneur racine. Par exemple, une URL telle que la suivante produira désormais un code d'état 400 (Demande incorrecte) :

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

Dans l'exemple ci-dessus, le service BLOB lit le nom du conteneur sous la forme myblob et attend un nom d'objet blob après la barre oblique de fin. La demande est incorrecte en raison de l'absence du nom de l'objet blob.

L'URL suivante est valide pour une opération sur un objet blob dans le conteneur racine :

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

Opérations PUT

Pour créer un conteneur nommé mycontainer :

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

Pour créer un objet blob nommé myblob dans le conteneur racine :

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

Vous pouvez également explicitement spécifier le conteneur racine :

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

Pour créer un objet blob nommé myblob dans un conteneur nommé mycontainer :

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

Pour créer un objet blob nommé photos/myphoto dans un conteneur nommé mycontainer :

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

Pour définir les métadonnées dans un objet blob nommé myblob dans le conteneur racine :

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

Opérations DELETE

Pour supprimer un conteneur nommé mycontainer :

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

Pour supprimer le conteneur racine :

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

Pour supprimer l'objet blob myblob du conteneur racine :

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