Skip to main content
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.

RestoreObject

Colaboradores
PDFs

Você pode usar a solicitação S3 RestoreObject para restaurar um objeto armazenado em um pool de armazenamento em nuvem.

Tipo de solicitação suportada

O StorageGRID suporta apenas solicitações de RestoreObject para restaurar um objeto. Não suporta o SELECT tipo de restauração. Selecione Requests Return (retornar solicitações XNotImplemented).

Controle de versão

Opcionalmente, especifique versionId para restaurar uma versão específica de um objeto em um bucket com versão. Se você não especificar versionId, a versão mais recente do objeto será restaurada

Comportamento do RestoreObject em objetos de pool de storage de nuvem

Se um objeto tiver sido armazenado em um "Cloud Storage Pool", uma solicitação de RestoreObject tem o seguinte comportamento, com base no estado do objeto. "HeadObject"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, não haverá necessidade de restaurar o objeto emitindo uma solicitação de RestoreObject. Em vez disso, a cópia local pode ser recuperada diretamente, usando uma solicitação GetObject.
Estado do objeto Comportamento do RestoreObject

Objeto ingerido no StorageGRID, mas ainda não avaliado pelo ILM, ou objeto não está em um pool de storage de nuvem

403 Forbidden, InvalidObjectState

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

200 OK Nenhuma alteração é feita.

Nota: Antes de um objeto ser transferido para um estado não recuperável, não é possível alterar o seu expiry-date.

Objeto transicionado para um estado não recuperável

202 Accepted Restaura uma cópia recuperável do objeto para o pool de armazenamento em nuvem pelo número de dias especificado no corpo da solicitação. No final desse período, o objeto é retornado a um estado não recuperável.

Opcionalmente, use o Tier elemento de solicitação para determinar quanto tempo o trabalho de restauração levará para concluir (Expedited, Standard ou Bulk ). Se você não especificar Tier, o Standard nível será usado.

Importante: Se um objeto tiver sido transferido para o S3 Glacier Deep Archive ou se o Cloud Storage Pool usar o armazenamento Azure Blob, não será possível restaurá-lo usando o Expedited nível. O seguinte erro é retornado 403 Forbidden, InvalidTier: Retrieval option is not supported by this storage class.

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

409 Conflict, RestoreAlreadyInProgress

Objeto totalmente restaurado para o Cloud Storage Pool

200 OK

Nota: se um objeto foi restaurado para um estado recuperável, você pode alterar o mesmo expiry-date reemitindo a solicitação de RestoreObject com um novo valor para Days. A data de restauração é atualizada em relação à hora da solicitação.