HeadObject
Você pode usar a solicitação S3 HeadObject para recuperar metadados de um objeto sem retornar o próprio objeto. Se o objeto for armazenado em um pool de armazenamento em nuvem, você poderá usar o HeadObject para determinar o estado de transição do objeto.
Objetos HeadObject e multipart
Você pode usar o partNumber
parâmetro Request para recuperar metadados de uma parte específica de um objeto multipart ou segmentado. O x-amz-mp-parts-count
elemento de resposta indica quantas partes o objeto tem.
Você pode definir partNumber
como 1 para objetos segmentados/multipartes e objetos não segmentados/não multipartes; no entanto, o x-amz-mp-parts-count
elemento de resposta é retornado apenas para objetos segmentados ou multipartes.
UTF-8 carateres em metadados do usuário
O StorageGRID não analisa nem interpreta carateres UTF-8 escapados em metadados definidos pelo usuário. As solicitações HEAD para um objeto com carateres UTF-8 escapados em metadados definidos pelo usuário não retornam o x-amz-missing-meta
cabeçalho se o nome ou valor da chave incluir carateres não imprimíveis.
Cabeçalho de solicitação suportado
O seguinte cabeçalho de solicitação é suportado:
-
x-amz-checksum-mode
O
partNumber
parâmetro eRange
o cabeçalho não são suportados comx-amz-checksum-mode
o HeadObject. Quando você os inclui na solicitação comx-amz-checksum-mode
habilitado, o StorageGRID não retorna um valor de checksum na resposta.
Cabeçalho de pedido não suportado
O seguinte cabeçalho de solicitação não é suportado e retorna XNotImplemented
:
-
x-amz-website-redirect-location
Controle de versão
Se um versionId
sub-recurso não for especificado, a operação busca a versão mais recente do objeto em um bucket com versão. Se a versão atual do objeto for um marcador de exclusão, um status "não encontrado" é retornado com o x-amz-delete-marker
cabeçalho de resposta definido como true
.
Cabeçalhos de solicitação para criptografia no lado do servidor com chaves de criptografia fornecidas pelo cliente (SSE-C)
Use os três cabeçalhos se o objeto for criptografado com uma chave exclusiva que você forneceu.
-
x-amz-server-side-encryption-customer-algorithm
: EspecificarAES256
. -
x-amz-server-side-encryption-customer-key
: Especifique sua chave de criptografia para o objeto. -
x-amz-server-side-encryption-customer-key-MD5
: Especifique o resumo MD5 da chave de criptografia do objeto.
As chaves de criptografia que você fornece nunca são armazenadas. Se você perder uma chave de criptografia, perderá o objeto correspondente. Antes de usar chaves fornecidas pelo cliente para proteger os dados do objeto, revise as considerações no "Use a criptografia do lado do servidor". |
Respostas do HeadObject para objetos Pool de storage de nuvem
Se o objeto for armazenado em a "Cloud Storage Pool", os seguintes cabeçalhos de resposta serão retornados:
-
x-amz-storage-class: GLACIER
-
x-amz-restore
Os cabeçalhos de resposta fornecem informações sobre o estado de um objeto à medida que ele é movido para um pool de armazenamento em nuvem, opcionalmente transferido para um estado não recuperável e restaurado.
Estado do objeto | Resposta ao HeadObject |
---|---|
Objeto ingerido no StorageGRID, mas ainda não avaliado pelo ILM, ou objeto armazenado em um pool de storage tradicional ou usando codificação de apagamento |
|
Objeto no Cloud Storage Pool, mas ainda não transicionado para um estado não recuperável |
Até que o objeto seja transferido para um estado não recuperável, o valor para |
O objeto fez a transição para o estado não recuperável, mas pelo menos uma cópia também existe na grade |
O valor para Nota: Se a cópia na grade não estiver disponível (por exemplo, um nó de armazenamento está inativo), você deve emitir uma "RestoreObject" solicitação para restaurar a cópia do pool de armazenamento em nuvem antes de recuperar o objeto com êxito. |
Objeto transicionado para um estado não recuperável e nenhuma cópia existe na grade |
|
Objeto em processo de restauração a partir de um estado não recuperável |
|
Objeto totalmente restaurado para o Cloud Storage Pool |
O |
Objetos segmentados ou multiparte no Cloud Storage Pool
Se você carregou um objeto multipart ou se o StorageGRID dividir um objeto grande em segmentos, o StorageGRID determina se o objeto está disponível no pool de armazenamento em nuvem amostrando um subconjunto das partes ou segmentos do objeto. Em alguns casos, uma solicitação de HeadObject pode retornar incorretamente x-amz-restore: ongoing-request="false"
quando algumas partes do objeto já tiverem sido transferidas para um estado não recuperável ou quando algumas partes do objeto ainda não tiverem sido restauradas.
Replicação de HeadObject e cross-grid
Se você estiver usando "federação de grade" e "replicação entre grade" estiver habilitado para um bucket, o cliente S3 poderá verificar o status de replicação de um objeto emitindo uma solicitação de HeadObject. A resposta inclui o cabeçalho de resposta específico do StorageGRID x-ntap-sg-cgr-replication-status
, que terá um dos seguintes valores:
Grelha | Estado da replicação |
---|---|
Fonte |
|
Destino |
|
O StorageGRID não suporta o x-amz-replication-status colhedor.
|