Intestazioni di richiesta comuni

Le richieste REST di Amazon S3 Glacier (S3 Glacier) includono intestazioni che contengono informazioni di base sulla richiesta. La tabella seguente descrive le intestazioni che possono essere utilizzate per tutte le richieste REST di S3 Glacier.

Header Name (Nome intestazione)	Descrizione	Obbligatorio
Authorization	L'intestazione necessaria per firmare le richieste. S3 Glacier richiede Signature versione 4. Per ulteriori informazioni, consulta Firmare le richieste. Tipo: string	Sì
Content-Length	La lunghezza del corpo della richiesta (senza intestazioni). Tipo: string Condizione: necessaria solo per l'API Upload Archive (POST archive).	Condizionale
Date	La data che può essere utilizzata per creare la firma contenuta nell'intestazione Authorization. Se per la firma è necessario utilizzare l'intestazione Date, questa deve essere specificata nel formato di base ISO 8601. In questo caso, l'intestazione x-amz-date non è necessaria. Nota che quando x-amz-date è presente, sovrascrive sempre il valore dell'intestazione Date. Se l'intestazione Date non viene utilizzata per la registrazione, può essere uno dei formati di data completa specificati dal protocollo RFC 2616, sezione 3.3. Ad esempio, la seguente combinazione data/ora Wed, 10 Feb 2017 12:00:00 GMT è un'intestazione di data/ora valida da utilizzare con S3 Glacier. Se utilizzi l'intestazione Date per la firma, deve essere nel formato di base ISO 8601 YYYYMMDD'T'HHMMSS'Z'. Tipo: string Condizione: se l'intestazione Date è specificata, ma non è nel formato di base ISO 8601, devi anche includere l'intestazione x-amz-date. Se Date è nel formato di base ISO 8601, è sufficiente per firmare le richieste e l'intestazione x-amz-date non è necessaria. Per ulteriori informazioni, consulta Gestione delle date in Signature Version 4 nel glossario di Amazon Web Services.	Condizionale
Host	Questa intestazione specifica l'endpoint del servizio a cui invii le richieste. Il valore deve essere nel formato "glacier.region.amazonaws.com", dove region viene sostituito da una designazione di regione AWS come us-west-2. Tipo: string	Sì
x-amz-content-sha256	Il checksum SHA256 calcolato di un intero payload caricato con Upload Archive (POST archive) o Upload Part (PUT uploadID). Questa intestazione non è identica all'intestazione x-amz-sha256-tree-hash, anche se per alcuni payload di piccole dimensioni i valori sono gli stessi. Quando l'intestazione x-amz-content-sha256 è richiesta, devi specificare x-amz-content-sha256 e x-amz-sha256-tree-hash. Tipo: string Condizione: necessaria per l'API di streaming, Upload Archive (POST archive) e Upload Part (PUT uploadID).	Condizionale
x-amz-date	Data utilizzata per creare la firma nell'intestazione di autorizzazione. Deve essere nel formato di base ISO 8601 (YYYYMMDD'T'HHMMSS'Z'). Ad esempio, la data/ora 20170210T120000Z è un'intestazione x-amz-date valida da utilizzare con S3 Glacier. Tipo: string Condizione: x-amz-date è facoltativa per tutte le richieste; può essere utilizzata per sovrascrivere la data utilizzata per firmare le richieste. Se l'intestazione Date è specificata nel formato di base ISO 8601, l'intestazione x-amz-datenon è necessaria. Quando x-amz-date è presente, sovrascrive sempre il valore dell'intestazione Date. Per ulteriori informazioni, consulta Gestione delle date in Signature Version 4 nel glossario di Amazon Web Services.	Condizionale
x-amz-glacier-version	La versione dell'API di S3 Glacier da utilizzare. La versione corrente è 2012-06-01. Tipo: string	Sì
x-amz-sha256-tree-hash	Il checksum della struttura hash SHA256 calcolato per un archivio caricato (Upload Archive (POST archive)) o una parte dell'archivio (Upload Part (PUT uploadID)). Per ulteriori informazioni sul calcolo di questo checksum, consulta Calcolo di checksum. Tipo: string Impostazione predefinita: nessuna Condizione: necessaria per Upload Archive (POST archive) e Upload Part (PUT uploadID).	Condizionale