GetObject
È possibile utilizzare la richiesta GetObject S3 per recuperare un oggetto da un bucket S3.
Oggetti GetObject e multiparte
È possibile utilizzare il partNumber
parametro di richiesta per recuperare una parte specifica di un oggetto multiparte o segmentato. L' `x-amz-mp-parts-count`elemento di risposta indica il numero di parti dell'oggetto.
È possibile impostare partNumber
su 1 sia per gli oggetti segmentati/multiparte che per gli oggetti non segmentati/non multiparte; tuttavia, l' `x-amz-mp-parts-count`elemento di risposta viene restituito solo per gli oggetti segmentati o multiparte.
UTF-8 caratteri nei metadati dell'utente
StorageGRID non analizza o interpreta i caratteri UTF-8 escapati nei metadati definiti dall'utente. LE richieste di RECUPERO per un oggetto con caratteri UTF-8 di escape nei metadati definiti dall'utente non restituiscono l' `x-amz-missing-meta`intestazione se il nome o il valore della chiave include caratteri non stampabili.
Intestazione richiesta supportata
È supportata la seguente intestazione della richiesta:
-
x-amz-checksum-mode
: SpecificareENABLED
L'
Range`intestazione non è supportata con `x-amz-checksum-mode
per GetObject. Quando si includeRange
nella richiesta conx-amz-checksum-mode
abilitato, StorageGRID non restituisce un valore checksum nella risposta.
Intestazione della richiesta non supportata
La seguente intestazione di richiesta non è supportata e restituisce XNotImplemented
:
-
x-amz-website-redirect-location
Versione
Se non viene specificata una versionId
sottorisorsa, l'operazione recupera la versione più recente dell'oggetto in un bucket con versione. Se la versione corrente dell'oggetto è un marcatore di eliminazione, viene restituito lo stato "non trovato" con l' x-amz-delete-marker`intestazione della risposta impostata su `true
.
Intestazioni delle richieste per la crittografia lato server con chiavi di crittografia fornite dal cliente (SSE-C)
Utilizzare tutte e tre le intestazioni se l'oggetto è crittografato con una chiave univoca fornita dall'utente.
-
x-amz-server-side-encryption-customer-algorithm
: SpecificareAES256
. -
x-amz-server-side-encryption-customer-key
: Specificare la chiave di crittografia per l'oggetto. -
x-amz-server-side-encryption-customer-key-MD5
: Specificare il digest MD5 della chiave di crittografia dell'oggetto.
|
Le chiavi di crittografia fornite non vengono mai memorizzate. Se si perde una chiave di crittografia, si perde l'oggetto corrispondente. Prima di utilizzare le chiavi fornite dal cliente per proteggere i dati degli oggetti, esaminare le considerazioni riportate in "Utilizzare la crittografia lato server". |
Comportamento degli oggetti GetObject per Cloud Storage Pool
Se un oggetto è stato memorizzato in "Pool di cloud storage", il comportamento di una richiesta GetObject dipende dallo stato dell'oggetto. Per ulteriori informazioni, vedere"HeadObject (oggetto intestazione)".
|
Se un oggetto viene memorizzato in un Cloud Storage Pool e sulla griglia esistono anche una o più copie dell'oggetto, le richieste GetObject tenteranno di recuperare i dati dalla griglia, prima di recuperarli da Cloud Storage Pool. |
Stato dell'oggetto | Comportamento di GetObject |
---|---|
Oggetto acquisito in StorageGRID ma non ancora valutato da ILM, o oggetto memorizzato in un pool di storage tradizionale o mediante erasure coding |
Viene recuperata una copia dell'oggetto. |
Oggetto nel Cloud Storage Pool ma non ancora passato a uno stato non recuperabile |
Viene recuperata una copia dell'oggetto. |
Oggetto sottoposto a transizione in uno stato non recuperabile |
Utilizzare una "RestoreObject" richiesta per ripristinare l'oggetto in uno stato recuperabile. |
Oggetto in fase di ripristino da uno stato non recuperabile |
Attendere il completamento della richiesta RestoreObject. |
Oggetto completamente ripristinato nel Cloud Storage Pool |
Viene recuperata una copia dell'oggetto. |
Oggetti multiparte o segmentati in un pool di storage cloud
Se hai caricato un oggetto multiparte o se StorageGRID divide un oggetto di grandi dimensioni in segmenti, StorageGRID determina se l'oggetto è disponibile nel pool di storage cloud campionando un sottoinsieme delle parti o dei segmenti dell'oggetto. In alcuni casi, una richiesta GetObject potrebbe restituire erroneamente 200 OK
quando alcune parti dell'oggetto sono già state trasferite a uno stato non recuperabile o quando alcune parti dell'oggetto non sono state ancora ripristinate.
In questi casi:
-
La richiesta GetObject potrebbe restituire alcuni dati ma interrompersi a metà del trasferimento.
-
Una richiesta GetObject successiva potrebbe restituire
403 Forbidden
.
Replica GetObject e cross-grid
Se si utilizza "federazione di grid" ed "replica cross-grid" è attivato per un bucket, il client S3 può verificare lo stato di replica di un oggetto inviando una richiesta GetObject. La risposta include l'intestazione della risposta specifica di StorageGRID x-ntap-sg-cgr-replication-status
, che avrà uno dei seguenti valori:
Griglia | Stato della replica |
---|---|
Origine |
|
Destinazione |
REPLICA: L'oggetto è stato replicato dalla griglia di origine. |
|
StorageGRID non supporta la x-amz-replication-status testata.
|