Skip to main content
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

GetObject

Collaboratori
PDF

È 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: Specificare ENABLED

    L' Range`intestazione non è supportata con `x-amz-checksum-mode per GetObject. Quando si include Range nella richiesta con x-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: Specificare AES256.

  • 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.

Avvertenza 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)".

Nota 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

200 OK

Viene recuperata una copia dell'oggetto.

Oggetto nel Cloud Storage Pool ma non ancora passato a uno stato non recuperabile

200 OK

Viene recuperata una copia dell'oggetto.

Oggetto sottoposto a transizione in uno stato non recuperabile

403 Forbidden, InvalidObjectState

Utilizzare una "RestoreObject" richiesta per ripristinare l'oggetto in uno stato recuperabile.

Oggetto in fase di ripristino da uno stato non recuperabile

403 Forbidden, InvalidObjectState

Attendere il completamento della richiesta RestoreObject.

Oggetto completamente ripristinato nel Cloud Storage Pool

200 OK

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

  • COMPLETATO: La replica è riuscita.

  • PENDING: L'oggetto non è stato ancora replicato.

  • ERRORE: La replica non è riuscita con un errore permanente. Un utente deve risolvere l'errore.

Destinazione

REPLICA: L'oggetto è stato replicato dalla griglia di origine.
Nota StorageGRID non supporta la x-amz-replication-status testata.