Cette page est réservée aux clients existants du service S3 Glacier utilisant Vaults et l'original REST API de 2012.
Si vous recherchez des solutions de stockage d'archives, nous vous conseillons d'utiliser les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour en savoir plus sur ces options de stockage, consultez les sections Classes de stockage S3 Glacier
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Création de coffre (PUT vault)
Description
Cette opération crée un nouveau coffre avec le nom spécifié. Le nom du coffre doit être unique au sein d'une région AWS pour un Compte AWS. Vous pouvez créer jusqu'à 1 000 coffres par compte. Pour en savoir plus sur la création de coffres supplémentaires, accédez à la page d'informations du produit Amazon S3 Glacier
Vous devez utiliser les instructions suivantes pour nommer un coffre.
-
Les noms peuvent comporter entre 1 et 255 caractères.
-
Les caractères autorisés sont a-z, A-Z, 0-9, « _ » (trait de soulignement), « - » (trait d'union) et « . » (point).
Cette opération est idempotente : vous pouvez envoyer la même demande plusieurs fois sans que cela n'ait d'incidence après qu'Amazon S3 Glacier (S3 Glacier) a créé le coffre spécifié.
Requêtes
Syntaxe
Pour créer un coffre, envoyez une demande HTTP PUT à l'URI du coffre à créer.
PUT /
AccountId
/vaults/VaultName
HTTP/1.1 Host: glacier.Region
.amazonaws.com Date:Date
Authorization:SignatureValue
Content-Length:Length
x-amz-glacier-version: 2012-06-01
Note
La valeur de AccountId
est l'ID de Compte AWS. Cette valeur doit correspondre à l'ID de Compte AWS associé aux informations d'identification utilisées pour signer la demande. Vous pouvez spécifier un ID de Compte AWS ou éventuellement un simple « -
» (trait d'union), auquel cas Amazon S3 Glacier utilise l'ID de Compte AWS associé aux informations d'identification utilisées pour signer la demande. Si vous spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.
Paramètres de demande
Cette opération n'utilise pas les paramètres de demande.
En-têtes de demande
Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez En-têtes de demande communs.
Corps de la requête
Le corps de la demande pour cette opération doit être vide (0 octet).
Réponses
Syntaxe
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location
En-têtes de réponse
Une réponse positive comprend les en-têtes de réponse suivants, en plus de ceux communs à toutes les opérations. Pour plus d'informations sur les en-têtes de réponse communs, consultez En-têtes de réponse communs.
Name (Nom) | Description |
---|---|
|
Chemin d'accès par URI relatif du coffre qui a été créé. Type : chaîne |
Corps de la réponse
Cette opération ne renvoie pas de corps de réponse.
Erreurs
Pour en savoir plus sur les exceptions et les messages d'erreur Amazon S3 Glacier, consultez Réponses d'erreur.
Exemples
Exemple de requête
L'exemple suivant envoie une demande HTTP PUT pour créer un coffre nommé examplevault
.
PUT /-/vaults/examplevault HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Content-Length: 0 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Exemple de réponse
S3 Glacier crée le coffre et renvoie le chemin d'URI relatif du coffre dans l'en-tête Location
. L'ID de compte est toujours affiché dans l'en-tête Location
, que la demande spécifie un ID de compte ou un trait d'union ('-
').
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT Location: /111122223333/vaults/examplevault
Sections connexes
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK Amazon propres au langage, consultez la ressource suivante :