En-têtes de demande communs - Amazon Glacier

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.

Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'acceptera plus de nouveaux clients à compter du 15 décembre 2025, sans aucune incidence sur les clients existants. 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, 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.

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.

En-têtes de demande communs

Les demandes REST Amazon Glacier (Amazon Glacier) incluent des en-têtes contenant des informations de base sur la demande. Le tableau suivant décrit les en-têtes qui peuvent être utilisés par toutes les requêtes REST Amazon Glacier.

Nom de l’en-tête Description Obligatoire
Authorization

En-tête nécessaire à la signature des demandes. Amazon Glacier nécessite la version 4 de Signature. Pour de plus amples informations, veuillez consulter Signature des requêtes.

Type : String

 Oui
Content-Length

Longueur du corps de la demande (sans les en-têtes).

Type : String

Condition : nécessaire uniquement pour l'API Chargement d'archive (POST archive).

Conditionnel
Date

Date qui peut être utilisée pour créer la signature contenue dans l'en-tête Authorization. Si l'en-tête Date doit être utilisé pour la signature, il doit être spécifié au format de base ISO 8601. Dans ce cas, l'en-tête x-amz-date n'est pas nécessaire. Notez que lorsque x-amz-date est présent, il remplace toujours la valeur de l'en-tête Date.

Si l'en-tête Date n'est pas utilisé pour la signature, il peut se présenter sous l'un des formats de date complets spécifiés par RFC 2616, section 3.3. Par exemple, la date/heure suivante Wed, 10 Feb 2017 12:00:00 GMT est un date/time en-tête valide à utiliser avec Amazon Glacier.

Si vous utilisez l'en-tête Date pour la signature, il doit être au format de base ISO 8601YYYYMMDD'T'HHMMSS'Z'.

Type : String

Condition : si Dateest spécifié, mais n'est pas au format de base ISO 8601 base, vous devez également inclure l'en-tête x-amz-date. Si Date est spécifié au format de base ISO 8601, cela suffit pour signer les demandes et l'en-tête x-amz-date n'est pas nécessaire. Pour plus d'informations, consultez la page Gestion des dates dans Signature Version 4 dans le Glossaire Amazon Web Services.

Conditionnel
Host

Cet en-tête spécifie le point de terminaison de service auquel vous envoyez vos demandes. La valeur doit être de la forme glacier.region.amazonaws.com « », region remplacée par une désignation de AWS région telle queus-west-2.

Type : String

 Oui
x-amz-content-sha256

SHA256 Somme de contrôle calculée d'une charge utile complète téléchargée avec ouChargement d'archive (POST archive). Partie chargement (PUT uploadID) Cet en-tête n'est pas identique à l'en-tête x-amz-sha256-tree-hash bien que les valeurs soient identiques pour quelques petites charges utiles. Lorsque x-amz-content-sha256 est obligatoire, aussi bien x-amz-content-sha256 que x-amz-sha256-tree-hash doit être spécifié.

Type : String

Condition : obligatoire pour l'API de streaming, Chargement d'archive (POST archive) et Partie chargement (PUT uploadID).

 Conditionnel
x-amz-date

Date utilisée pour créer la signature dans l'en-tête Authorization. Le format doit correspondre à la norme ISO 8601 de base au format YYYYMMDD'T'HHMMSS'Z'. Par exemple, ce qui suit date/time 20170210T120000Z est valide x-amz-date pour une utilisation avec Amazon Glacier.

Type : String

Condition : x-amz-date est un en-tête facultatif pour toutes les demandes. Il peut être utilisé pour signer les demandes. Si l'en-tête Date est spécifié au format de base ISO 8601, x-amz-date n'est pas nécessaire. Lorsque x-amz-date est présent, il remplace toujours la valeur de l'en-tête Date. Pour plus d'informations, consultez la page Gestion des dates dans Signature Version 4 dans le Glossaire Amazon Web Services.

Conditionnel
x-amz-glacier-version

Version de l'API Amazon Glacier à utiliser. La version actuelle est 2012-06-01.

Type : String

 Oui
x-amz-sha256-tree-hash

Somme de contrôle calculée SHA256 par hachage arborescent pour une archive (Chargement d'archive (POST archive)) ou une partie d'archive () téléchargée. Partie chargement (PUT uploadID) Pour plus d'informations sur le calcul de ce total de contrôle, consultez la section Calcul des totaux de contrôle.

Type : String

Par défaut : aucun

Condition : Obligatoire pour Chargement d'archive (POST archive) et Partie chargement (PUT uploadID).

 Conditionnel