Skip to main content
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

OTTIENI oggetto

Collaboratori
PDF

È possibile utilizzare la richiesta di oggetti GET S3 per recuperare un oggetto da un bucket S3.

OTTIENI oggetti oggetto e multiparte

È possibile utilizzare partNumber parametro di richiesta per recuperare una parte specifica di un oggetto multiparte o segmentato. Il x-amz-mp-parts-count l'elemento response indica il numero di parti dell'oggetto.

È possibile impostare partNumber a 1 per oggetti segmentati/multiparte e non segmentati/non multiparte; tuttavia, il x-amz-mp-parts-count l'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 GET per un oggetto con caratteri UTF-8 escapiti nei metadati definiti dall'utente non restituiscono x-amz-missing-meta intestazione se il nome o il valore della chiave include caratteri non stampabili.

Intestazione della richiesta non supportata

La seguente intestazione di richiesta non è supportata e restituisce XNotImplemented:

  • x-amz-website-redirect-location

Versione

Se si seleziona versionId la sottorisorsa non viene specificata, l'operazione recupera la versione più recente dell'oggetto in un bucket con versione. Se la versione corrente dell'oggetto è un indicatore di eliminazione, viene restituito lo stato “Not Found” (non trovato) con x-amz-delete-marker intestazione 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.

Importante 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 in "Utilizzare la crittografia lato server".

Comportamento di GET Object per gli oggetti Cloud Storage Pool

Se un oggetto è stato memorizzato in "Pool di cloud storage", Il comportamento di una richiesta DI oggetto GET dipende dallo stato dell'oggetto. Vedere "Oggetto TESTA" per ulteriori dettagli.

Nota Se un oggetto viene memorizzato in un Cloud Storage Pool e una o più copie dell'oggetto sono presenti anche nella griglia, LE richieste GET Object tenteranno di recuperare i dati dalla griglia, prima di recuperarli dal Cloud Storage Pool.
Stato dell'oggetto Comportamento dell'oggetto GET

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 un "RIPRISTINO POST-oggetto" richiesta di ripristino dell'oggetto in uno stato recuperabile.

Oggetto in fase di ripristino da uno stato non recuperabile

403 Forbidden, InvalidObjectState

Attendere il completamento della richiesta DI ripristino dell'oggetto POST.

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, la richiesta DI un oggetto GET potrebbe non essere restituita correttamente 200 OK quando alcune parti dell'oggetto sono già state trasferite in uno stato non recuperabile o quando alcune parti dell'oggetto non sono ancora state ripristinate.

In questi casi:

  • La richiesta DELL'oggetto GET potrebbe restituire alcuni dati ma arrestarsi a metà del trasferimento.

  • Potrebbe essere restituita una richiesta successiva di oggetto GET 403 Forbidden.

OTTIENI replica di oggetti e cross-grid

Se si utilizza "federazione di grid" e. "replica cross-grid" È attivato per un bucket, il client S3 può verificare lo stato di replica di un oggetto inviando una richiesta DI oggetto GET. La risposta include lo specifico StorageGRID x-ntap-sg-cgr-replication-status intestazione della risposta, che avrà uno dei seguenti valori:

Griglia Stato della replica

Origine

  • SUCCESSO: 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 x-amz-replication-status intestazione.
Informazioni correlate

"Operazioni S3 monitorate nei registri di audit"