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

HeadObject (oggetto intestazione)

11/07/2024 Collaboratori

PDF

È possibile utilizzare la richiesta HeadObject S3 per recuperare i metadati da un oggetto senza restituire l'oggetto stesso. Se l'oggetto viene memorizzato in un Cloud Storage Pool, è possibile utilizzare HeadObject per determinare lo stato di transizione dell'oggetto.

Oggetti HeadObject e multiparte

È possibile utilizzare il partNumber parametro di richiesta per recuperare i metadati per 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 HEAD 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

Il partNumber parametro e Range l'intestazione non sono supportati con x-amz-checksum-mode per HeadObject. Quando vengono inclusi 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 queste 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.

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

Risposte HeadObject per gli oggetti Cloud Storage Pool

Se l'oggetto è memorizzato in "Pool di cloud storage", vengono restituite le seguenti intestazioni di risposta:

x-amz-storage-class: GLACIER
x-amz-restore

Le intestazioni delle risposte forniscono informazioni sullo stato di un oggetto quando viene spostato in un Cloud Storage Pool, facoltativamente trasferito in uno stato non recuperabile e ripristinato.

Stato dell'oggetto Risposta a HeadObject

Stato dell'oggetto	Risposta a HeadObject
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` (Non viene restituita alcuna intestazione di risposta speciale).
Oggetto nel Cloud Storage Pool ma non ancora passato a uno stato non recuperabile	`200 OK` `x-amz-storage-class: GLACIER` `x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2030 00:00:00 GMT"` Fino a quando l'oggetto non viene spostato in uno stato non recuperabile, il valore per viene impostato su un `expiry-date` tempo lontano in futuro. L'ora esatta della transizione non è controllata dal sistema StorageGRID.
L'oggetto è passato allo stato non recuperabile, ma almeno una copia esiste anche nella griglia	`200 OK` `x-amz-storage-class: GLACIER` `x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2030 00:00:00 GMT"` Il valore per `expiry-date` è impostato su un certo tempo lontano in futuro. Nota: Se la copia nella griglia non è disponibile (ad esempio, un nodo di archiviazione è inattivo), è necessario eseguire una "RestoreObject" richiesta di ripristino della copia dal pool di archiviazione cloud prima di poter recuperare correttamente l'oggetto.
L'oggetto è passato a uno stato non recuperabile e non esiste alcuna copia nella griglia	`200 OK` `x-amz-storage-class: GLACIER`
Oggetto in fase di ripristino da uno stato non recuperabile	`200 OK` `x-amz-storage-class: GLACIER` `x-amz-restore: ongoing-request="true"`
Oggetto completamente ripristinato nel Cloud Storage Pool	`200 OK` `x-amz-storage-class: GLACIER` `x-amz-restore: ongoing-request="false", expiry-date="Sat, 23 July 20 2018 00:00:00 GMT"` `expiry-date`Indica quando l'oggetto nel Cloud Storage Pool verrà riportato a uno stato non recuperabile.

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 (Non viene restituita alcuna intestazione di risposta speciale).

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

200 OK