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.

Operações em objetos

Colaboradores netapp-madkat netapp-perveilerk netapp-lhalbert ssantho3
PDFs

Esta seção descreve como o sistema StorageGRID implementa S3 operações de API REST para objetos.

As seguintes condições se aplicam a todas as operações de objetos:

  • Os StorageGRID "controles de consistência"são suportados por todas as operações em objetos, com exceção dos seguintes:

    • OBTER ACL Objeto

    • OPTIONS /

    • COLOCAR guarda legal Objeto

    • COLOCAR retenção Objeto

    • SELECIONE conteúdo do objeto

  • As solicitações de cliente conflitantes, como dois clientes escrevendo para a mesma chave, são resolvidas com base em "vitórias mais recentes". O calendário para a avaliação "últimos ganhos" é baseado em quando o sistema StorageGRID completa uma determinada solicitação e não em quando os clientes S3 começam uma operação.

  • Todos os objetos em um bucket do StorageGRID são de propriedade do proprietário do bucket, incluindo objetos criados por um usuário anônimo ou por outra conta.

  • Os objetos de dados ingeridos para o sistema StorageGRID através do Swift não podem ser acedidos através do S3.

A tabela a seguir descreve como o StorageGRID implementa operações de objetos API REST do S3.

Operação Implementação

Objeto DELETE

Autenticação multifator (MFA) e o cabeçalho de resposta x-amz-mfa não são suportados.

Ao processar uma solicitação DE EXCLUSÃO de objetos, o StorageGRID tenta remover imediatamente todas as cópias do objeto de todos os locais armazenados. Se for bem-sucedido, o StorageGRID retornará uma resposta ao cliente imediatamente. Se todas as cópias não puderem ser removidas dentro de 30 segundos (por exemplo, porque um local está temporariamente indisponível), o StorageGRID coloca as cópias em fila para remoção e, em seguida, indica sucesso para o cliente.

Controle de versão

Para remover uma versão específica, o solicitante deve ser o proprietário do bucket e usar o versionId subrecurso. O uso deste subrecurso exclui permanentemente a versão. Se o versionId corresponder a um marcador de exclusão, o cabeçalho de resposta x-amz-delete-marker será retornado como true.

  • Se um objeto for excluído sem o versionId subrecurso em um bucket habilitado para versão, isso resultará na geração de um marcador de exclusão. O versionId para o marcador de exclusão é retornado usando o x-amz-version-id cabeçalho de resposta e o x-amz-delete-marker cabeçalho de resposta é retornado como true.

  • Se um objeto for excluído sem o versionId sub-recurso em um bucket suspenso de versão, ele resultará em uma exclusão permanente de uma versão 'null' já existente ou um marcador 'null' delete, e a geração de um novo marcador 'null' delete. O x-amz-delete-marker cabeçalho de resposta é retornado definido como true.

    Nota: Em certos casos, vários marcadores de exclusão podem existir para um objeto.

"Use a API REST do S3 para configurar o bloqueio de objetos do S3"Consulte para saber como excluir versões de objetos no MODO DE GOVERNANÇA.

Excluir vários objetos

(DeleteObjects)

Autenticação multifator (MFA) e o cabeçalho de resposta x-amz-mfa não são suportados.

Vários objetos podem ser excluídos na mesma mensagem de solicitação.

"Use a API REST do S3 para configurar o bloqueio de objetos do S3"Consulte para saber como excluir versões de objetos no MODO DE GOVERNANÇA.

ELIMINAR marcação Objeto

Usa o tagging subrecurso para remover todas as tags de um objeto.

Controle de versão

Se o versionId parâmetro de consulta não for especificado na solicitação, a operação excluirá todas as tags da 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 "'MethodNotAllowed'" será retornado com o x-amz-delete-marker cabeçalho de resposta definido como true.

Objeto GET

"Objeto GET"

OBTER ACL Objeto

Se as credenciais de acesso necessárias forem fornecidas para a conta, a operação retornará uma resposta positiva e a ID, DisplayName e permissão do proprietário do objeto, indicando que o proprietário tem acesso total ao objeto.

OBTER retenção legal Objeto

"Use a API REST do S3 para configurar o bloqueio de objetos do S3"

OBTER retenção de objetos

"Use a API REST do S3 para configurar o bloqueio de objetos do S3"

OBTER marcação de objetos

Usa o tagging subrecurso para retornar todas as tags para um objeto.

Controle de versão

Se o versionId parâmetro de consulta não for especificado na solicitação, a operação retornará todas as tags da versão mais recente do objeto em um bucket versionado. Se a versão atual do objeto for um marcador de exclusão, um status "'MethodNotAllowed'" será retornado com o x-amz-delete-marker cabeçalho de resposta definido como true.

Objeto HEAD

"Objeto HEAD"

Restauração PÓS-objeto

"Restauração PÓS-objeto"

Objeto PUT

"Objeto PUT"

COLOCAR Objeto - Copiar

"COLOCAR Objeto - Copiar"

COLOCAR guarda legal Objeto

"Use a API REST do S3 para configurar o bloqueio de objetos do S3"

COLOCAR retenção Objeto

"Use a API REST do S3 para configurar o bloqueio de objetos do S3"

COLOQUE a marcação Objeto

Usa o tagging subrecurso para adicionar um conjunto de tags a um objeto existente.

Limites da etiqueta do objeto

Você pode adicionar tags a novos objetos ao enviá-los ou adicioná-los a objetos existentes. O StorageGRID e o Amazon S3 suportam até 10 tags para cada objeto. Tags associadas a um objeto devem ter chaves de tag exclusivas. Uma chave de tag pode ter até 128 carateres Unicode de comprimento e os valores de tag podem ter até 256 carateres Unicode de comprimento. Chave e valores são sensíveis a maiúsculas e minúsculas.

Tag atualizações e comportamento de ingestão

Quando você usa a marcação "COLOCAR objeto" para atualizar as tags de um objeto, o StorageGRID não reingere o objeto. Isso significa que a opção de comportamento de ingestão especificada na regra ILM correspondente não é usada. Quaisquer alterações no posicionamento de objetos que são acionadas pela atualização são feitas quando o ILM é reavaliado por processos normais de ILM em segundo plano.

Isso significa que se a regra ILM usar a opção estrita para o comportamento de ingestão, nenhuma ação será tomada se os posicionamentos de objeto necessários não puderem ser feitos (por exemplo, porque um local recém-exigido não está disponível). O objeto atualizado mantém seu posicionamento atual até que o posicionamento necessário seja possível.

Resolução de conflitos

As solicitações de clientes conflitantes, como dois clientes escrevendo para a mesma chave, são resolvidas com base em "últimos ganhos". O calendário para a avaliação "últimos ganhos" é baseado em quando o sistema StorageGRID completa uma determinada solicitação e não em quando os clientes S3 começam uma operação.

Controle de versão

Se o versionId parâmetro de consulta não for especificado na solicitação, a operação adicionará tags à 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 "'MethodNotAllowed'" será retornado com o x-amz-delete-marker cabeçalho de resposta definido como true.

Selecione ObjectContent

"Selecione ObjectContent"
Informações relacionadas

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