**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.
# 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)