En-têtes de demande communs

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

Nom de l’en-tête	Description	Obligatoire
Authorization	En-tête nécessaire à la signature des demandes. S3 Glacier nécessite Signature Version 4. Pour de plus amples informations, veuillez consulter Signature des requêtes. Type : chaîne	Oui
Content-Length	Longueur du corps de la demande (sans les en-têtes). Type : chaîne 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 Wed, 10 Feb 2017 12:00:00 GMT est un en-tête de date/heure valide à utiliser avec S3 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 : chaîne 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 se présenter sous la forme « glacier.region.amazonaws.com », region étant remplacé par une désignation de région AWS comme us-west-2. Type : chaîne	Oui
x-amz-content-sha256	Total de contrôle SHA256 calculé d'une charge utile entière chargée avec Chargement d'archive (POST archive)ouPartie 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 : chaîne 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, la date/heure 20170210T120000Z est un en-tête x-amz-date valide à utiliser avec S3 Glacier. Type : chaîne 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 d'API S3 Glacier à utiliser. La version actuelle est 2012-06-01. Type : chaîne	Oui
x-amz-sha256-tree-hash	Total de contrôle de hachage d'arborescence SHA256 calculé pour une archive (Chargement d'archive (POST archive)) ou une partie d'archive (Partie chargement (PUT uploadID)) chargée. Pour plus d'informations sur le calcul de ce total de contrôle, consultez la section Calcul des totaux de contrôle. Type : chaîne Par défaut : aucun Condition : Obligatoire pour Chargement d'archive (POST archive) et Partie chargement (PUT uploadID).	Conditionnel