View a markdown version of this page

Intestazioni di richiesta comuni - Amazon Simple Storage Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Intestazioni di richiesta comuni

La tabella seguente descrive le intestazioni che possono essere utilizzate da vari tipi di richieste REST di Amazon S3.

Header Name (Nome intestazione) Description
Authorization

Le informazioni necessarie per l'autenticazione della richiesta. Per ulteriori informazioni, consulta The Authentication Header nella Amazon Simple Storage Service Developer Guide. Per le richieste anonime questa intestazione non è richiesta.

Access-Control-Request-Method Un elenco di metodi HTTP inviato come richiesta CORS pre-flight. Se la valutazione CORS precedente al flight ha esito positivo, è consentito utilizzare i metodi specificati nella seguente richiesta CORS.
Content-Length

La lunghezza del messaggio (senza le intestazioni) secondo la specifica RFC 2616. Questa intestazione è necessaria per i PUT e le operazioni che caricano XML, come la registrazione e gli ACL.

Content-Type

Il tipo di contenuto della risorsa nel caso in cui la richiesta contenga contenuti nel corpo. Ad esempio: text/plain

Content-MD5

Il digest MD5 a 128 bit codificato in base64 del messaggio (senza le intestazioni) secondo RFC 1864. Questa intestazione può essere utilizzata come controllo dell'integrità del messaggio per verificare che i dati siano gli stessi dati originariamente inviati. Sebbene sia facoltativo, consigliamo di utilizzare il Content-MD5 meccanismo come controllo di integrità end-to-end. Per ulteriori informazioni sull'autenticazione delle richieste REST, consulta la sezione Autenticazione REST nella Amazon Simple Storage Service Developer Guide.

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, date/time Wed, 01 Mar 2006 12:00:00 GMT è un' date/time intestazione valida da utilizzare con Amazon S3.

Se utilizzi l'intestazione Date per la firma, deve essere nel formato di base ISO 8601 YYYYMMDD'T'HHMMSS'Z'.

Se Date è specificata ma non è nel formato base ISO 8601, devi includere anche 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.

Expect

Quando l'applicazione utilizza 100-continue, non invia il corpo della richiesta finché non riceve una conferma. Se, in base alle intestazioni, il messaggio viene rifiutato, il corpo del messaggio non viene inviato. Questa intestazione può essere utilizzata solo se si invia un corpo.

Valori validi: 100-continue

Host

Per le richieste in stile percorso, il valore è. s3.amazonaws.com Per le richieste in stile virtuale, il valore è. BucketName.s3.amazonaws.com Per ulteriori informazioni, consulta Virtual Hosting nella Amazon Simple Storage Service User Guide.

Questa intestazione è obbligatoria per HTTP 1.1 (la maggior parte dei toolkit aggiunge questa intestazione automaticamente); opzionale per le richieste. HTTP/1.0

Origin

Un endpoint che specifica il nome del server del richiedente iniziale.

x-amz-content-sha256

Quando si utilizza la versione 4 della firma per autenticare la richiesta, questa intestazione fornisce un hash del payload della richiesta. Per ulteriori informazioni, consulta Calcolo delle firme per l'intestazione di autorizzazione: trasferimento del payload in un unico blocco (AWS Signature (versione 4). Quando si carica un oggetto in blocchi, si imposta il valore su per indicare che la firma copre solo STREAMING-AWS4-HMAC-SHA256-PAYLOAD le intestazioni e che non è presente alcun payload. Per ulteriori informazioni, consulta Calcoli della firma per l'intestazione dell'autorizzazione: trasferimento del payload in più blocchi (caricamento in blocchi) (AWS Signature (versione 4).

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, date/time 20170210T120000Z è valido x-amz-date per l'uso con Amazon S3.

x-amz-dateè facoltativo per tutte le richieste; può essere utilizzato per sovrascrivere la data utilizzata per la firma delle 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.

x-amz-security-token

Questa intestazione può essere utilizzata nei seguenti scenari:

  • Per fornire token di sicurezza per DevPay le operazioni di Amazon: ogni richiesta che utilizza Amazon DevPay richiede due x-amz-security-token intestazioni: una per il token del prodotto e una per il token utente. Quando Amazon S3 riceve una richiesta autenticata, confronta la firma calcolata con la firma fornita. Le intestazioni multivalore formattate in modo errato utilizzate per calcolare una firma possono causare problemi di autenticazione.

  • Per fornire un token di sicurezza quando si utilizzano credenziali di sicurezza temporanee: quando si effettuano richieste utilizzando le credenziali di sicurezza temporanee ottenute da IAM, è necessario fornire un token di sicurezza utilizzando questa intestazione. Per saperne di più sulle credenziali di sicurezza temporanee, consulta Making Requests. https://docs.aws.amazon.com/AmazonS3/latest/userguide/MakingRequests.html

Questa intestazione è obbligatoria per le richieste che utilizzano Amazon DevPay e le richieste firmate utilizzando credenziali di sicurezza temporanee.