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

10/22/2024 Colaboradores

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

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"

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"

Operações em objetos

Creating your file...