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.

Objeto GET

Colaboradores
PDFs

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

OBTER objetos e multipartes

Você pode usar o partNumber parâmetro Request 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 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. Obter solicitações 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 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" será 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 todos os três cabeçalhos se o objeto for criptografado com uma chave exclusiva que você forneceu.

  • x-amz-server-side-encryption-customer-algorithm: Especificar 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.

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

Comportamento DO GET Object para objetos Pool de storage de nuvem

Se um objeto tiver sido armazenado em um "Cloud Storage Pool", o comportamento de uma solicitação GET Object depende do estado do objeto. "Objeto HEAD"Consulte para obter mais detalhes.

Observação Se um objeto for armazenado em um pool de armazenamento em nuvem e uma ou mais cópias do objeto também existirem na grade, as SOLICITAÇÕES DE OBTENÇÃO de objetos tentarão recuperar dados da grade, antes de recuperá-los do pool de armazenamento em nuvem.
Estado do objeto Comportamento de GET Object

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

200 OK

Uma cópia do objeto é recuperada.

Objeto no Cloud Storage Pool, mas ainda não transicionado para um estado não recuperável

200 OK

Uma cópia do objeto é recuperada.

Objeto transicionado para um estado não recuperável

403 Forbidden, InvalidObjectState

Use uma "Restauração PÓS-objeto" solicitação para restaurar o objeto para um estado recuperável.

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

403 Forbidden, InvalidObjectState

Aguarde até que a solicitação de restauração PÓS-objeto seja concluída.

Objeto totalmente restaurado para o Cloud Storage Pool

200 OK

Uma cópia do objeto é recuperada.

Objetos segmentados ou multiparte em um pool de armazenamento em nuvem

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

Nestes casos:

  • A solicitação GET Object pode retornar alguns dados, mas parar no meio da transferência.

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

OBTENHA replicação de objetos e entre grades

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 GET Object. 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

  • SUCESSO: A replicação foi bem-sucedida.

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

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

Destino

  • RÉPLICA*: O objeto foi replicado a partir da grade de origem.
Observação O StorageGRID não suporta o x-amz-replication-status colhedor.
Informações relacionadas

"S3 operações rastreadas em logs de auditoria"