jobParameters - Amazon S3 Glacier
Table des matièresPlus d'informations

Cette page s'adresse uniquement aux clients existants du service S3 Glacier utilisant Vaults et l'API REST d'origine datant 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 et Stockage de données à long terme à l'aide des classes de stockage S3 Glacier dans le guide de l'utilisateur Amazon S3. Ces classes de stockage utilisent l'API Amazon S3, sont disponibles dans toutes les régions et peuvent être gérées au sein de la console Amazon S3. Ils offrent des fonctionnalités telles que l'analyse des coûts de stockage, Storage Lens, des fonctionnalités de sécurité, notamment de multiples options de cryptage, etc.

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 : ID d'archive valide que vous avez obtenu à partir d'une demande précédente adressée à Amazon S3 Glacier (S3 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 | 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

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

Obligatoire : oui, pour les tâches select.

RetrievalByteRange

Plage d'octets à extraire pour une archive-retrieval, au format « 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*1024). « Alignée en termes de méga-octets » signifie que le paramètre StartByteValue doit être un multiple de 1 Mo et le paramètre EndByteValue plus 1 doit être un multiple de 1 Mo ou être la fin de l'archive spécifiée comme valeur de taille d'octets d'archive moins 1. Si RetrievalByteRange n'est pas aligné en termes de méga-octets, 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

Obligatoire : non

SNSTopic

Amazon Resource Name (ARN) de la rubrique Amazon SNS à laquelle S3 Glacier envoie une notification lorsque la tâche est terminée et que la sortie est prête à être téléchargée. 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, S3 Glacier ne la crée pas à votre place. 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 de rubrique SNS, consultez CreateTopic dans le document Amazon Simple Notification Service Référence de l'API.

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 | Standard | 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 | archive-retrieval | inventory-retrieval

Type : chaîne

Obligatoire : oui

Plus d'informations