**Cette page est réservée aux clients existants du service Amazon Glacier utilisant Vaults et l'API REST d'origine datant de 2012.** Si vous recherchez des solutions de stockage d'archives, nous vous recommandons d'utiliser les classes de stockage Amazon 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 [classes de stockage Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'accepte plus de nouveaux clients. Amazon Glacier est un service autonome doté de son propre service APIs qui stocke les données dans des coffres-forts et qui se distingue des classes de stockage Amazon S3 et Amazon S3 Glacier. Vos données existantes resteront sécurisées et accessibles indéfiniment dans Amazon Glacier. Aucune migration n'est requise. Pour un stockage d'archivage à long terme et à faible coût AWS , nous [recommandons les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), qui offrent une expérience client supérieure avec des compartiments S3, une Région AWS disponibilité totale APIs, des coûts réduits et AWS une intégration des services. Si vous souhaitez des fonctionnalités améliorées, envisagez de migrer vers les classes de stockage Amazon S3 Glacier en suivant nos [conseils relatifs aux AWS solutions pour le transfert de données depuis les coffres-forts Amazon Glacier vers les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). 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. # Types de données utilisés dans les opérations de tâche Les types de données suivants sont utilisés pour les opérations de travail dans Amazon Glacier. **Topics** + [CSVInput](api-CSVInput.md) + [CSVOutput](api-CSVOutput.md) + [Chiffrement](api-Encryption.md) + [GlacierJobDescription](api-GlacierJobDescription.md) + [Octroi](api-Grant.md) + [Bénéficiaire](api-Grantee.md) + [InputSerialization](api-InputSerialization.md) + [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) + [jobParameters](api-jobParameters.md) + [OutputLocation](api-OutputLocation.md) + [OutputSerialization](api-OutputSerialization.md) + [Emplacement S3](api-S3Location.md) + [SelectParameters](api-SelectParameters.md) # CSVInput Contient des informations sur le fichier CSV (valeurs séparées par des virgules). ## Table des matières **Commentaires** Caractère nique utilisé pour indiquer qu'une ligne doit être ignorée lorsque le caractère est présent au début de cette ligne. *Type :* chaîne *Obligatoire* : non **FieldDelimiter** Caractère unique utilisé pour séparer des champs individuels les uns des autres au sein d'un enregistrement. Le caractère doit être un `\n`, un `\r`, ou un caractère ASCII compris dans la plage 32-126. La valeur par défaut est une virgule (`,`). *Type :* chaîne *Par défaut* : , *Obligatoire* : non **FileHeaderInfo** Valeur décrivant quoi faire avec la première ligne de l'entrée. *Type :* chaîne *Valeurs Valides* : `Use` \$1 `Ignore` \$1 `None` *Obligatoire* : non **QuoteCharacter** Caractère unique utilisé comme caractère d'échappement lorsque le délimiteur de champ fait partie d'une valeur. *Type :* chaîne *Obligatoire* : non **QuoteEscapeCharacter** Caractère unique utilisé pour l'échappement du guillemet à l'intérieur d'une valeur déjà échappée. *Type :* chaîne *Obligatoire* : non **RecordDelimiter** Caractère unique utilisé pour séparer des enregistrements individuels les uns des autres. *Type :* chaîne *Obligatoire* : non ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # CSVOutput Contient des informations sur le format CSV (valeurs séparées par des virgules) dans lequel les résultats des tâches sont stockés. ## Table des matières **FieldDelimiter** Caractère unique utilisé pour séparer des champs individuels les uns des autres au sein d'un enregistrement. *Type :* chaîne *Obligatoire* : non **QuoteCharacter** Caractère unique utilisé comme caractère d'échappement lorsque le délimiteur de champ fait partie d'une valeur. *Type :* chaîne *Obligatoire* : non **QuoteEscapeCharacter** Caractère unique utilisé pour l'échappement du guillemet à l'intérieur d'une valeur déjà échappée. *Type :* chaîne *Obligatoire* : non **QuoteFields** Valeur qui indique si tous les champs de sortie doivent être entourés de guillemets. *Valeurs valides* : `ALWAYS` \$1 `ASNEEDED` *Type :* chaîne *Obligatoire* : non **RecordDelimiter** Caractère unique utilisé pour séparer des enregistrements individuels les uns des autres. *Type :* chaîne *Obligatoire* : non ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # Chiffrement Contient des informations sur le chiffrement utilisé pour stocker les résultats des tâches dans Amazon S3. ## Table des matières **Chiffrement** Algorithme de chiffrement côté serveur utilisé lors du stockage des résultats des tâches dans Amazon S3. La valeur par défaut est sans chiffrement. *Type :* chaîne *Valeurs valides* : `aws:kms` \$1 `AES256` *Obligatoire* : non **KMSContext** Facultatif. Si le type de chiffrement est `aws:kms,` vous pouvez utiliser cette valeur pour spécifier le contexte de chiffrement des résultats des tâches. *Type :* chaîne *Obligatoire* : non **KMSKeyId** L'ID de clé AWS Key Management Service (AWS KMS) à utiliser pour le chiffrement des objets. *Type :* chaîne *Obligatoire* : non ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # GlacierJobDescription Contient la description d'une tâche Amazon Glacier (Amazon Glacier). ## Table des matières **Action** Le type de tâche. Il s'agit de `ArchiveRetrieval`, `InventoryRetrieval` ou `Select`. *Type* : chaîne **ArchiveId** ID d'archive demandé pour une tâche de sélection ou d'extraction d'archive. Sinon, ce champ est `null`. *Type* : chaîne **ArchivageSHA256TreeHash** Le hachage SHA256 arborescent de l'ensemble de l'archive pour une extraction d'archives. Pour les tâches d'extraction d'inventaire, ce champ est `null`. *Type* : chaîne **ArchiveSizeInBytes** Pour une tâche `ArchiveRetrieval`, il s'agit de la taille en octets de l'archive demandée au téléchargement. Pour la tâche `InventoryRetrieval`, la valeur est `null`. *Type* : nombre **Terminé** `true` si la tâche est terminée, sinon, `false`. *Type* : valeur booléenne **CompletionDate** Date à laquelle la tâche s'est terminée. La date UTC lors de la fin de la demande de tâche. Lorsque la tâche est en cours, cette valeur est null. *Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`. **CreationDate** La date UTC du début de la tâche. *Type* : représentation sous forme de chaîne au format de date ISO 8601, par exemple `2013-03-20T17:03:43.221Z`. **InventoryRetrievalParameters** Paramètres d'entrée utilisés pour l'extraction d'un inventaire par plage. *Type* : objet [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) **InventorySizeInBytes** Pour une tâche `InventoryRetrieval`, il s'agit de la taille en octets de l'inventaire dont le téléchargement est demandé. Pour la tâche `ArchiveRetrieval` ou `Select`, la valeur est `null`. *Type* : nombre **JobDescription** Description de tâche que vous avez fournie lorsque vous avez lancé la tâche. *Type* : chaîne **JobId** ID identifiant la tâche dans Amazon Glacier. *Type* : chaîne **JobOutputPath** Contient l'emplacement de la sortie de la tâche. *Type* : chaîne **OutputLocation** Objet qui contient des informations sur l'emplacement auquel les erreurs et résultats de tâches de sélection sont stockés. *Type* : objet [OutputLocation](api-OutputLocation.md) **RetrievalByteRange** La plage d'octets récupérée pour les tâches de récupération d'archives sous la forme « *StartByteValue* - »*EndByteValue*. Si aucune plage n'a été spécifiée lors de la récupération de l'archive, l'archive entière est récupérée et *StartByteValue*vaut 0 et est *EndByteValue*égale à la taille de l'archive moins 1. Pour les tâches d'extraction d'inventaire, ce champ est `null`. *Type* : chaîne **SelectParameters** Objet qui contient les informations sur les paramètres utilisés pour une tâche de sélection. *Type* : objet [SelectParameters](api-SelectParameters.md) **SHA256TreeHash** La valeur de hachage de l' SHA256 arbre pour la plage demandée d'une archive. Si la demande [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) définie pour une archive spécifiait une plage alignée avec le hachage d'arborescence, ce champ renvoie une valeur. Pour plus d'informations sur l'alignement avec le hachage d'arborescence dans le cas d'extractions par plage d'archive, consultez [Réception des totaux de contrôle lors du téléchargement de données](checksum-calculations-range.md). Lorsque la totalité de l'archive est extraite, cette valeur est identique à celle de `ArchiveSHA256TreeHash`. La valeur de ce champ est `null` dans les cas suivants : + Tâches d'extraction d'archive qui spécifient une plage qui n'est pas alignée avec le hachage d'arborescence. + Tâches d'archivage qui spécifient une plage qui correspond à la totalité de l'archive et dont l'état est `InProgress`. + Tâches d'inventaire. + Tâches de sélection. *Type* : chaîne **SNSTopic** Amazon Resource Name (ARN) représentant une rubrique Amazon SNS à laquelle la notification d'achèvement ou d'échec de la tâche est envoyée, si une notification a été configurée lors du lancement de la tâche ([Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)). *Type* : chaîne **StatusCode** Code indiquant l'état de la tâche. *Valeurs Valides* : `InProgress` \$1 `Succeeded` \$1 `Failed` *Type* : chaîne **StatusMessage** Message d'état de la tâche. *Type* : chaîne **Palier** Niveau d'accès aux données à utiliser pour la tâche de sélection ou d'extraction d'archive. *Valeurs Valides* : `Expedited` \$1 `Standard` \$1 `Bulk` *Type* : chaîne **VaultARN** ARN du coffre dont la tâche est une sous-ressource. *Type* : chaîne ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # Octroi Contient des informations à propos d'une attribution. ## Table des matières **Bénéficiaire** Bénéficiaire. *Type* : objet [Bénéficiaire](api-Grantee.md) *Obligatoire* : non **Autorisation** Autorisation donnée au bénéficiaire. *Type :* chaîne *Valeurs Valides*: `FULL_CONTROL` \$1 `WRITE` \$1 `WRITE_ACP` \$1 `READ` \$1 `READ_ACP` *Obligatoire* : non ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # Bénéficiaire Contient des informations à propos d'un bénéficiaire. ## Table des matières **DisplayName** Nom de l'écran du bénéficiaire. *Type :* chaîne *Obligatoire* : non **EmailAddress** Adresse e-mail du bénéficiaire. *Type :* chaîne *Obligatoire* : non **ID** ID d'utilisateur canonique du bénéficiaire. *Type :* chaîne *Obligatoire* : non **Type** Type du bénéficiaire. *Type :* chaîne *Valeurs Valides* : `AmazonCustomerByEmail` \$1 `CanonicalUser` \$1 `Group` *Obligatoire* : non **URI** URI du groupe du bénéficiaire. *Type :* chaîne *Obligatoire* : non ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # InputSerialization Décrit la manière dont l'archive est sérialisée. ## Table des matières **CSV** Objet décrivant la sérialisation d'un objet codé CSV. *Type* : objet [CSVInput](api-CSVInput.md) *Obligatoire* : non ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # InventoryRetrievalJobInput Fournit des options de spécification de tâche d'extraction d'un inventaire par plage. ## Table des matières **EndDate** Fin de la plage de dates au format UTC pour une extraction d'inventaire de coffre qui inclut les archives créées avant cette date. *Valeurs valides* : représentation sous forme de chaîne au format de date ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) en secondes, par exemple `2013-03-20T17:03:43Z`. *Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) en secondes, par exemple `2013-03-20T17:03:43Z`. *Obligatoire* : non **Format** Format de sortie de la liste de l'inventaire du coffre, défini par la demande [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) lors du lancement d'une tâche d'extraction d'un inventaire de coffre. *Valeurs valides* : `CSV` \$1 `JSON` *Obligatoire* : non *Type :* chaîne **Limite** Nombre maximal d'éléments d'inventaire pouvant être renvoyés pour chaque demande d'extraction d'inventaire de coffre. *Valeurs valides* : valeur d'entier supérieure ou égale à 1. *Type :* chaîne *Obligatoire* : non **Marker** Chaîne opaque représentant l'endroit à partir duquel poursuivre la pagination des résultats d'extraction d'inventaire de coffre. Vous utilisez ce marqueur dans une nouvelle demande `Initiate Job` afin d'obtenir des éléments d'inventaire supplémentaires. S'il n'y a pas d'autres éléments d'inventaire, cette valeur est null. *Type :* chaîne *Obligatoire* : non **StartDate** Début de la plage de dates au format UTC pour une extraction d'inventaire de coffre qui inclut les archives créées à cette date ou ultérieurement. *Valeurs valides* : représentation sous forme de chaîne au format de date ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) en secondes, par exemple `2013-03-20T17:03:43Z`. *Type* : chaîne. Représentation sous forme de chaîne au format de date ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) en secondes, par exemple `2013-03-20T17:03:43Z`. *Obligatoire* : non ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # jobParameters Fournit des options de définition d'une tâche. ## Table des matières **ArchiveId** L'ID de l'archive que vous souhaitez. Ce champ est obligatoire uniquement si le champ `Type` est défini sur `select` ou `archive-retrieval`. Une erreur se produit si vous spécifiez ce champ pour une demande de tâche d'extraction d'inventaire. *Valeurs valides* : il doit s'agir d'un identifiant d'archive valide que vous avez obtenu lors d'une précédente demande adressée à Amazon Glacier (Amazon Glacier). *Type* : chaîne *Obligatoire* : Oui lorsque `Type` est défini sur `select` ou `archive-retrieval`. **Description** La description facultative de la tâche. *Valeurs valides* : la description doit être inférieure ou égale à 1 024 octets. Les caractères autorisés sont les caractères ASCII 7 bits sans code de contrôle, plus précisément les valeurs ASCII décimales ou hexadécimales comprises, respectivement, entre 32 et 126 et entre 0x20 et 0x7E. *Type* : chaîne *Obligatoire* : non **Format** (Facultatif) Format de sortie lors du lancement d'une tâche d'extraction d'un inventaire de coffre. Si vous lancez une tâche d'inventaire et que vous ne spécifiez pas de champ `Format`, JSON est le format par défaut. *Valeurs valides* : `CSV` \$1 `JSON` *Type* : chaîne *Obligatoire* : non **InventoryRetrievalParameters** Paramètres d'entrée utilisés pour l'extraction d'un inventaire par plage. *Type* : objet [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) *Obligatoire* : non **OutputLocation** Objet qui contient des informations sur l'emplacement auquel les résultats de tâches de sélection sont stockés. *Type* : objet [OutputLocation](api-OutputLocation.md) *Obligatoire* : oui, pour les tâches `select`. **RetrievalByteRange** La plage d'octets à récupérer pour un`archive-retrieval`, sous la forme « *StartByteValue* - *EndByteValue* ». Si ce champ n'est pas spécifié, l'archive entière est extraite. Si ce champ est spécifié, la plage d'octets doit être alignée en termes de méga-octets (1024\$11024). Aligné par mégaoctet signifie qu'*StartByteValue*il doit être divisible par 1 Mo, et *EndByteValue*plus 1 doit être divisible par 1 Mo ou être la fin de l'archive spécifiée comme valeur de taille d'octet d'archive moins 1. S'il n'**RetrievalByteRange**est pas aligné en mégaoctets, cette opération renvoie une réponse. `400` Une erreur se produit si vous spécifiez ce champ pour une demande de tâche `inventory-retrieval` ou `select`. *Type* : chaîne *Obligatoire* : non **SelectParameters** Objet qui contient les informations sur les paramètres utilisés pour une tâche de sélection. *Type* : objet [SelectParameters](api-SelectParameters.md) *Obligatoire* : non **SNSTopic** Le nom de ressource Amazon (ARN) de la rubrique Amazon SNS dans laquelle Amazon Glacier envoie une notification lorsque le travail est terminé et que le résultat est prêt à être téléchargé. La rubrique spécifiée publie la notification à l'attention des abonnés. La rubrique SNS doit exister. Si ce n'est pas le cas, Amazon Glacier ne le créera pas pour vous. En outre, la rubrique SNS doit avoir une stratégie qui permet au compte ayant créé la tâche de publier des messages dans la rubrique. Pour plus d'informations sur les noms des rubriques SNS, consultez [CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)le manuel *Amazon Simple Notification Service* *API Reference*. *Type* : chaîne *Obligatoire* : non **Palier** Niveau à utiliser pour une tâche de sélection ou d'extraction d'archive. `Standard` est la valeur par défaut utilisée. *Valeurs Valides* : `Expedited` \$1 `Standard` \$1 `Bulk` *Type* : chaîne *Obligatoire* : non **Type** Le type de tâche. Vous pouvez lancer une tâche pour exécuter une requête de sélection sur une archive, d'extraction d'archive ou d'obtention d'un inventaire de coffre. *Valeurs Valides* : `select` \$1 `archive-retrieval` \$1 `inventory-retrieval` *Type* : chaîne *Obligatoire* : oui ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # OutputLocation Contient des informations sur l'emplacement auquel les résultats des tâches et les erreurs sont stockés. ## Table des matières **S3** Objet décrivant l'emplacement Amazon S3 où seront reçus les résultats de la demande de restauration. *Type :* [Emplacement S3](api-S3Location.md) *Obligatoire* : oui ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # OutputSerialization Décrit la manière dont la sortie est sérialisée. ## Table des matières **CSV** Objet décrivant la sérialisation des résultats de la demande codée CSV (valeurs séparées par des virgules). *Type* : objet [CSVOutput](api-CSVOutput.md) *Obligatoire* : non ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # Emplacement S3 Contient des informations sur l'emplacement dans Amazon S3 où sont stockés les résultats de la tâche. ## Table des matières **AccessControlList** Liste des attributions contrôlant l'accès aux résultats stockés. *Type* : tableau d'objets [Octroi](api-Grant.md) *Obligatoire* : non **BucketName** Nom du compartiment Amazon S3 où sont stockés les résultats de la tâche. Le compartiment doit se trouver dans la même AWS région que le coffre contenant l'objet d'archive d'entrée. *Type :* chaîne *Obligatoire* : oui **CannedACL** Liste de contrôle d'accès (ACL) prédéfinie à appliquer aux résultats des tâches. *Type :* chaîne *Valeurs Valides*: `private` \$1 `public-read` \$1 `public-read-write` \$1 `aws-exec-read` \$1 `authenticated-read` \$1 `bucket-owner-read` \$1 `bucket-owner-full-control` *Obligatoire* : non **Chiffrement** Objet qui contient des informations sur le chiffrement utilisé pour stocker les résultats de la tâche dans Amazon S3. *Type* : objet [Chiffrement](api-Encryption.md) *Obligatoire* : non **Préfixe** Préfixe qui précède les résultats de cette demande. La longueur maximale du préfixe est de 512 caractères. *Type :* chaîne *Obligatoire* : oui **StorageClass** Classe de stockage utilisée pour stocker les résultats des tâches. *Type :* chaîne *Valeurs Valides* : `STANDARD` \$1 `REDUCED_REDUNDANCY` \$1 `STANDARD_IA` *Obligatoire* : non **Balisage** Ensemble de balises appliqué aux résultats des tâches. *Type* : mappage chaîne/chaîne *Obligatoire* : non **UserMetadata** Mappage des métadonnées à stocker avec les résultats de la tâche dans Amazon S3. *Type* : mappage chaîne/chaîne *Obligatoire* : non ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md) # SelectParameters Contient les informations sur les paramètres utilisés pour la tâche de sélection. ## Table des matières **Expression** Expression utilisée pour sélectionner l'objet. L'expression ne doit pas dépasser le quota de 128 000 caractères. *Type :* chaîne *Obligatoire* : oui **ExpressionType** Type de l'expression fournie, par exemple, `SQL`. *Valeurs valides* : `SQL` *Type :* chaîne *Obligatoire* : oui **InputSerialization** Décrit le format de sérialisation de l'objet dans la sélection. *Type* : objet [InputSerialization](api-InputSerialization.md) *Obligatoire* : non **OutputSerialization** Décrit la manière dont les résultats de la tâche de sélection sont sérialisés. *Obligatoire* : non *Type* : objet [OutputSerialization](api-OutputSerialization.md) ## Plus d'informations + [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)