Recuperar metadados de um objeto no StorageGRID com a solicitação S3 HeadObject
Sugerir alterações
PDFs
Você pode usar a solicitação S3 HeadObject para recuperar metadados de um objeto sem retornar o próprio objeto. Se o objeto estiver armazenado em um pool de storage em nuvem, você pode usar HeadObject para determinar o estado de transição do objeto.
HeadObject e objetos multipartes
Você pode usar o `partNumber`parâmetro de solicitação 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 possui.
Você pode definir partNumber como 1 tanto para objetos segmentados/multipartes quanto para objetos não segmentados/não multipartes; no entanto, o elemento de resposta x-amz-mp-parts-count só é retornado para objetos segmentados ou multipartes.
Caracteres UTF-8 nos metadados do usuário
StorageGRID não analisa nem interpreta caracteres UTF-8 escapados em metadados definidos pelo usuário. Requisições HEAD para um objeto com caracteres UTF-8 escapados em metadados definidos pelo usuário não retornam o x-amz-missing-meta cabeçalho se o nome da chave ou o valor incluir caracteres não imprimíveis.
Cabeçalho de solicitação compatível
O seguinte cabeçalho de solicitação é compatível:
-
x-amz-checksum-modeO `partNumber`parâmetro e o `Range`cabeçalho não são suportados com `x-amz-checksum-mode`para HeadObject. Quando você os inclui na solicitação com `x-amz-checksum-mode`ativado, StorageGRID não retorna um valor de checksum na resposta.
Cabeçalho de solicitação não suportado
O seguinte cabeçalho de solicitação não é compatível e retorna XNotImplemented:
-
x-amz-website-redirect-location
Controle de versões
Se um versionId subrecurso não for especificado, a operação busca a versão mais recente do objeto em um bucket versionado. Se a versão atual do objeto for um marcador de exclusão, o 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 do lado do servidor com chaves de criptografia fornecidas pelo cliente (SSE-C)
Utilize todos os três cabeçalhos se o objeto estiver criptografado com uma chave exclusiva que você forneceu.
-
x-amz-server-side-encryption-customer-algorithm: EspecifiqueAES256. -
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 dados de objetos, revise as considerações em "Use criptografia do lado do servidor". |
HeadObject respostas para objetos do Cloud Storage Pool
Se o objeto estiver armazenado em um "Pool de storage em nuvem", 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 storage em nuvem, opcionalmente transitado para um estado não recuperável e restaurado.
| Estado do objeto | Resposta a HeadObject |
|---|---|
Objeto inserido 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 pool de Cloud Storage, mas ainda não foi transferido para um estado não recuperável |
Até que o objeto seja levado a um estado irrecuperável, o valor para |
O objeto passou para um estado não recuperável, mas pelo menos uma cópia também existe na grid |
O valor para Nota: Se a cópia na grade não estiver disponível (por exemplo, se um Storage Node estiver inativo), você deve emitir uma "RestoreObject" solicitação para restaurar a cópia do Cloud Storage Pool antes de conseguir recuperar o objeto. |
O objeto passou para um estado não recuperável e não existe nenhuma cópia no grid |
|
Objeto em processo de restauração a partir de um estado irrecuperável |
|
Objeto totalmente restaurado ao pool de storage em nuvem |
O |
Objetos multipartes ou segmentados no Cloud Storage Pool
Se você carregou um objeto multipart ou se StorageGRID dividiu um objeto grande em segmentos, StorageGRID determina se o objeto está disponível no Cloud Storage Pool ao amostrar um subconjunto das partes ou segmentos do objeto. Em alguns casos, uma solicitação HeadObject pode retornar incorretamente x-amz-restore: ongoing-request="false" quando algumas partes do objeto já foram transferidas para um estado não recuperável ou quando algumas partes do objeto ainda não foram restauradas.
HeadObject e replicação entre grades
Se você estiver usando "federação de grid" e "replicação entre grids" estiver habilitado para um bucket, o cliente S3 pode verificar o status de replicação de um objeto emitindo uma solicitação 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:
| Grid | Status de replicação |
|---|---|
Fonte |
|
Destino |
RÉPLICA: O objeto foi replicado da grid de origem. |
|
StorageGRID não suporta o x-amz-replication-status header.
|