VENTES: 1-800-867-1389
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Utilisation du Conteneur racine

 

Un conteneur racine sert de conteneur par défaut à votre compte de stockage. Un compte de stockage peut avoir un seul conteneur racine. Le conteneur racine doit être explicitement créé et doit être nommé $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 en procédant comme suit :

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

Pour utiliser le conteneur racine avec 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 le x-ms-blob-public-access en-tête lorsque le conteneur est créé, ou en appelant Définition de conteneur d'ACL une fois qu'il existe déjà. Voir restreindre l'accès aux conteneurs et objets BLOB pour plus d'informations.

Si le conteneur racine est présent, il apparaît lorsque vous effectuez la List Containers (API REST) opération sur le compte de stockage.

Lorsque vous effectuez une Liste des objets blob opération 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 requête suivant montre comment appeler List Blobs sur le conteneur racine :

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

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

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

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

Liste des 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 à partir 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
System_CAPS_noteRemarque

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 comme 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

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 sur un objet blob nommé myblob dans le conteneur racine :


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

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

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


DELETE https://myaccount.blob.core.windows.net/$root/myblob
Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.
Afficher:
© 2016 Microsoft