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.

Restaurar um objeto no StorageGRID com a solicitação S3 RestoreObject

PDFs

Você pode usar a solicitação S3 RestoreObject para restaurar um objeto armazenado em um Cloud Storage Pool.

Tipo de solicitação compatível

StorageGRID suporta apenas solicitações RestoreObject para restaurar um objeto. Ele não suporta o tipo de restauração SELECT. As solicitações Select retornam XNotImplemented.

Controle de versões

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

Comportamento de RestoreObject em objetos do Cloud Storage Pool

Se um objeto foi armazenado em um "Pool de storage em nuvem", uma solicitação RestoreObject terá o seguinte comportamento, com base no 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 desse objeto também existirem na grid, não é necessário restaurar o objeto emitindo uma solicitação RestoreObject. Em vez disso, a cópia local pode ser recuperada diretamente, usando uma solicitação GetObject.
Estado do objeto Comportamento de RestoreObject

Objeto ingerido no StorageGRID, mas ainda não avaliado pelo ILM, ou objeto não está em um Cloud Storage Pool

403 Forbidden, InvalidObjectState

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

`200 OK`Nenhuma alteração foi feita.

Nota: Antes que um objeto tenha sido transferido para um estado não recuperável, você não pode alterar seu expiry-date.

Objeto passou para um estado não recuperável

`202 Accepted`Restaura uma cópia recuperável do objeto no Cloud Storage Pool pelo número de dias especificado no corpo da solicitação. Ao final desse período, o objeto retorna a um estado não recuperável.

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

Importante: Se um objeto tiver sido migrado para o S3 Glacier Deep Archive ou se o Cloud Storage Pool usar Azure Blob storage, você não poderá restaurá-lo usando a Expedited camada. 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 irrecuperável

409 Conflict, RestoreAlreadyInProgress

Objeto totalmente restaurado ao pool de storage em nuvem

200 OK

Nota: Se um objeto foi restaurado a um estado recuperável, você pode alterar seu expiry-date reenviando a solicitação RestoreObject com um novo valor para Days. A data de restauração é atualizada em relação ao momento da solicitação.