Créer le conteneur
Réduire la table des matières
Développer la table des matières
Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Créer le conteneur

 

Le Create Container opération crée un nouveau conteneur sous le compte spécifié. Si le conteneur portant le même nom existe déjà, l'opération échoue.

La ressource de conteneur inclut les métadonnées et propriétés de ce conteneur. Il n'inclut pas une liste des objets BLOB contenus dans le conteneur.

Le Create Container demande peut être construite comme suit. HTTPS est recommandée. Votre mycontainer valeur peut inclure uniquement des caractères minuscules. Remplacez myaccount avec le nom de votre compte de stockage :

(Méthode)

URI de la demande

Version HTTP

PUT

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

HTTP/1.1

Lorsque vous élaborez une demande au service de stockage émulé, spécifiez le nom d'hôte de l'émulateur et un port de service Blob en tant que 127.0.0.1:10000, suivie du nom de compte de stockage émulé :

(Méthode)

URI de la demande

Version HTTP

PUT

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container

HTTP/1.1

Pour plus d'informations, consultez à l'aide de l'émulateur de stockage Azure pour le développement et le test et différences entre l'émulateur de stockage et les Services de stockage Azure.

Les paramètres supplémentaires suivants peuvent être spécifiés sur l'URI de requête.

Paramètre

Description

timeout

Facultatif. Le timeout paramètre est exprimé en secondes. Pour plus d'informations, consultez Définition de délais d'expiration pour les opérations du service BLOB.

Le tableau suivant décrit les en-têtes de demande obligatoires et facultatifs.

En-tête de demande

Description

Authorization

Requis. Spécifie le schéma d'authentification, le nom de compte et la signature. Pour plus d'informations, consultez Authentification pour les services Azure Storage.

Date ou x-ms-date

Requis. Spécifie la durée de temps universel coordonné (UTC) pour la demande. Pour plus d'informations, consultez Authentification pour les services Azure Storage.

x-ms-version

Obligatoire pour toutes les demandes authentifiées. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez Contrôle de version des Services de stockage Azure.

x-ms-meta-name:value

Facultatif. Une paire nom-valeur à associer avec le conteneur en tant que métadonnées.

Notez que depuis la version 2009-09-19, noms de métadonnées doivent respecter les règles d'affectation de noms identificateurs c#.

x-ms-blob-public-access 

Facultatif. Spécifie si les données dans le conteneur sont accessibles publiquement et le niveau d'accès. Les valeurs possibles sont les suivantes :

  • container: Spécifie un accès en lecture public complet pour le conteneur et les données blob. Les clients peuvent énumérer les objets BLOB du conteneur via une demande anonyme, mais ne peut pas énumérer les conteneurs dans le compte de stockage.

  • blob: Spécifie un accès en lecture public pour les objets BLOB. Les données d'objets BLOB de ce conteneur peuvent être lues via une demande anonyme, mais les données de conteneur ne seront pas disponibles. Les clients ne peuvent pas énumérer les objets BLOB du conteneur via une demande anonyme.

Si cet en-tête n'est pas inclus dans la demande, les données du conteneur sont privées pour le propriétaire du compte.

x-ms-client-request-id

Facultatif. Fournit une valeur opaque générée par le client avec une limite de caractère de 1 Ko qui est enregistrée dans les journaux d'analyse lors de la journalisation storage analytics est activée. À l'aide de cet en-tête est fortement recommandée pour mettre en corrélation des activités côté client avec les requêtes reçues par le serveur. Pour plus d'informations, consultez À propos de la journalisation Storage Analytics et journalisation Azure : à l'aide de journaux pour suivre les demandes de stockage.

Request Syntax: PUT https://myaccount.blob.core.windows.net/mycontainer?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 Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.

Une opération réussie renvoie le code d'état 201 (créé).

Pour plus d'informations sur les codes d'état, consultez Codes d'erreur et d'état.

La réponse pour cette opération inclut les en-têtes suivants. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standards se conforment à la spécification du protocole HTTP/1.1.

En-tête de réponse

Description

ETag

L'ETag du conteneur. Si la version de demande est 2011-08-18 ou ultérieure, la valeur ETag sera entre guillemets.

Last-Modified

Retourne la date et l'heure de que dernière modification du conteneur. Le format de date suit RFC 1123. Pour plus d'informations, consultez Représentation des valeurs Date/Heure dans les en-têtes.

Toute opération qui modifie le conteneur ou de ses propriétés ou métadonnées met à jour l'heure de dernière modification. Opérations sur les objets BLOB n'affectent pas l'heure de dernière modification du conteneur.

x-ms-request-id

Cet en-tête identifie de façon unique la demande qui a été effectuée et peut être utilisée pour résoudre la demande. Pour plus d'informations, consultez Dépannage des opérations d'API 

x-ms-version

Indique la version du service d'objets Blob utilisé pour exécuter la demande. Cet en-tête est renvoyé pour les demandes effectuées avec la version 2009-09-19 et versions ultérieures.

Date

Une valeur de date/heure UTC générée par le service qui indique l'heure à laquelle la réponse a été initiée.

Response Status: HTTP/1.1 201 Created Response Headers: Transfer-Encoding: chunked Date: Sun, 25 Sep 2011 23:00:12 GMT ETag: “0x8CB14C3E29B7E82” Last-Modified: Sun, 25 Sep 2011 23:00:06 GMT x-ms-version: 2011-08-18 Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Seul le propriétaire du compte peut appeler cette opération.

Les conteneurs sont créés immédiatement sous le compte de stockage. Il n'est pas possible d'imbriquer un conteneur sous un autre.

Vous pouvez éventuellement créer un conteneur racine ou par défaut pour votre compte de stockage. Le conteneur racine peut être déduit à partir d'une URL demandant une ressource d'objet blob. Le conteneur racine permet de faire référence à un objet blob dans le niveau supérieur de la hiérarchie de compte de stockage, sans référencer le nom du conteneur.

Pour ajouter le conteneur racine à votre compte de stockage, créez un conteneur nommé $root. Construire la requête comme suit :

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 Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

Vous pouvez spécifier des métadonnées pour un conteneur au moment de que sa création en incluant un ou plusieurs en-têtes de métadonnées sur la demande. Le format de l'en-tête de métadonnées est x-ms-meta-name:value.

Si un conteneur portant le même nom est supprimé lorsque Create Container est appelé, le serveur renvoie le code d'état 409 (conflit), avec des informations d'erreur supplémentaires indiquant que le conteneur est supprimé.

Afficher:
© 2016 Microsoft