Skip to main content
Uma versão mais recente deste produto está disponível.
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Recuperar um objeto de um bucket no StorageGRID com a solicitação GetObject

PDFs

Você pode usar a solicitação S3 GetObject para recuperar um objeto de um bucket S3.

GetObject e objetos multipartes

Você pode usar o `partNumber`parâmetro de solicitação para recuperar 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. Solicitações GET 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-mode: especificar ENABLED

    O Range`cabeçalho não é compatível com `x-amz-checksum-mode para GetObject. Quando você inclui Range 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 os três cabeçalhos se o objeto estiver criptografado com uma chave exclusiva que você forneceu.

  • x-amz-server-side-encryption-customer-algorithm: Especifique AES256.

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

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

Comportamento de GetObject para objetos do Cloud Storage Pool

Se um objeto foi armazenado em um "Pool de storage em nuvem", o comportamento de uma solicitação GetObject depende do estado do objeto. Veja "HeadObject" para mais detalhes.

Observação Se um objeto estiver armazenado em um Cloud Storage Pool e uma ou mais cópias do objeto também existirem na grid, as solicitações GetObject tentarão recuperar os dados da grid antes de recuperá-los do Cloud Storage Pool.
Estado do objeto Comportamento de GetObject

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

200 OK

Uma cópia do objeto é recuperada.

Objeto no pool de Cloud Storage, mas ainda não foi transferido para um estado não recuperável

200 OK

Uma cópia do objeto é recuperada.

Objeto passou para um estado não recuperável

403 Forbidden, InvalidObjectState

Utilize uma solicitação "RestoreObject" para restaurar o objeto a um estado recuperável.

Objeto em processo de restauração a partir de um estado irrecuperável

403 Forbidden, InvalidObjectState

Aguarde a conclusão da solicitação RestoreObject.

Objeto totalmente restaurado ao pool de storage em nuvem

200 OK

Uma cópia do objeto é recuperada.

Objetos multipartes ou segmentados em um pool de storage em nuvem

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 GetObject pode retornar incorretamente 200 OK 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.

Nesses casos:

  • A solicitação GetObject pode retornar alguns dados, mas ser interrompida no meio da transferência.

  • Uma solicitação GetObject subsequente pode retornar 403 Forbidden.

GetObject 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 pode verificar o status de replicação de um objeto emitindo uma solicitação GetObject. 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

  • CONCLUÍDO: A replicação foi bem-sucedida.

  • PENDENTE: O objeto ainda não foi replicado.

  • FALHA: A replicação falhou com uma falha permanente. Um usuário deve resolver o erro.

Destino

RÉPLICA: O objeto foi replicado da grid de origem.
Observação StorageGRID não suporta o x-amz-replication-status header.