Intestazioni comuni e codici di errore

I trasferimenti di dati utilizzano molti protocolli standard e hanno dei requisiti univoci. Tieniti aggiornato con le informazioni sulle intestazioni comuni e su alcuni codici di errore.

Intestazioni della richiesta comuni

La tabella seguente illustra le intestazioni di richiesta comuni supportate. IBM Cloud® Object Storage ignora qualsiasi intestazione comune non elencata di seguito se inviata come parte di una richiesta, sebbene alcune richieste possano supportare intestazioni aggiuntive come definito nel presente documento.

Intestazione Nota
Autorizzazione Obbligatoria per tutte le richieste (token bearer OAuth2).
ibm-service-instance-id Obbligatoria per le richieste per creare o elencare i bucket.
Content-MD5 L'hash MD5 binario a 128 bit con codifica base64 del payload, utilizzato come un controllo dell'integrità per garantire che il payload non è stato modificato in transito. La codifica base64 deve essere eseguita sull'output binario dell'hash MD5, non sulla rappresentazione esadecimale.
x-amz-checksum-crc32 Questa intestazione è il checksum Base64 codificato a 32 bit CRC32 dell'oggetto.
x-amz-checksum-crc32c Questa intestazione è il checksum Base64 codificato a 32 bit CRC32C dell'oggetto.
x-amz-checksum-crc64nvme Questa intestazione è il checksum Base64 codificato a 64 bit CRC64NVME dell'oggetto. Il checksum di CRC64NVME è sempre un checksum completo dell'oggetto.
x-amz-checksum-sha1 Questa intestazione è il digest Base64 codificato a 160 bit SHA1 dell'oggetto.
x-amz-checksum-sha256 Questa intestazione è il digest Base64 codificato a 256 bit SHA256 dell'oggetto.
x-amz-sdk-checksum-algorithm Indica l'algoritmo usato per creare il checksum dell'oggetto quando si usa l'SDK.
Expect Il valore 100-continue attende che il sistema confermi che le intestazioni sono appropriate prima di inviare il payload.
host È possibile utilizzare sia la sintassi dell'endpoint che quella dell'“host virtuale” di {bucket-name}.{endpoint}. Di norma, questa intestazione viene aggiunta automaticamente. Per ulteriori informazioni sugli endpoint, vedi Endpoint e ubicazioni di archiviazione
Cache-Control Può essere utilizzata per specificare il comportamento della memorizzazione nella cache insieme alla catena richiesta/risposta. Per ulteriori informazioni, vai all'indirizzo http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9

Metadati personalizzati

Un vantaggio derivante dall'utilizzo di Object Storage è la capacità di aggiungere metadati personalizzati inviando le coppie chiave-valore come intestazioni. Queste intestazioni prendono la forma di x-amz-meta-{KEY}. Si noti che, a differenza di AWS S3, IBM Cloud Object Storage combina più intestazioni con la stessa chiave di metadati in un elenco di valori separati da virgole.

Intestazioni della risposta comuni

La seguente tabella descrive le intestazioni della risposta comuni.

Intestazione Nota
Content-Length La lunghezza del corpo della richiesta in byte.
Connection Indica se la connessione è aperta o chiusa.
Date Data/ora della richiesta.
ETag Valore hash MD5 della richiesta.
Server Nome del server di risposta.
X-Clv-Request-Id Identificativo univoco generato per richiesta.

Intestazioni della risposta del ciclo di vita

La seguente tabella descrive le intestazioni della risposta per gli oggetti archiviati

Intestazione Nota
x-amz-restore Inclusa se l'oggetto è stato ripristinato o se è in corso un ripristino.
x-amz-storage-class Restituisce " GLACIER " o " ACCELERATED " se il file è stato archiviato o ripristinato temporaneamente.
x-ibm-archive-transition-time Restituisce la data e l'ora in cui è pianificata la transizione dell'oggetto al livello di archivio.
x-ibm-transition Inclusa se l'oggetto contiene metadati di transizione e restituisce il livello e l'ora originale della transizione.
x-ibm-restored-copy-storage-class Inclusa se un oggetto si trova negli stati RestoreInProgress o Restored e restituisce la classe di archiviazione del bucket.

Per un elenco dei codici di errore, consultare la documentazione dell'API