Restauração de objetos em Arquivo
Funções
Para obter o conteúdo de um objeto na classe de armazenamento Arquivo, primeiro você precisa restaurar o objeto e depois baixá-lo. Depois que um objeto é restaurado, uma cópia do objeto é salva na classe de armazenamento Standard. Ao fazer isso, o objeto na classe de armazenamento Arquivo e sua cópia na classe de armazenamento Standard coexistem no bucket. A cópia será excluída automaticamente após a expiração de seu período de retenção.
Controle de versões
Por padrão, esta operação retorna a versão mais recente de um objeto. Se o objeto tiver um marcador de exclusão, o código de status 404 será retornado. Para restaurar um objeto de uma versão especificada, o parâmetro versionId pode ser usado para especificar a versão desejada.
Sintaxe da solicitação
POST /ObjectName?restore&versionId=VersionID HTTP/1.1 Host: bucketname.obs.region.myhuaweicloud.com Date: date Authorization: authorization string Content-MD5: MD5 <RestoreRequest> <Days>NumberOfDays</Days> <RestoreJob> <Tier>RetrievalOption</Tier> </RestoreJob> </RestoreRequest>
Parâmetros de solicitação
Parâmetro |
Descrição |
Obrigatório |
---|---|---|
ID da versão |
ID de versão do objeto Arquivo a ser restaurado Tipo: string |
Não |
Cabeçalhos de solicitação
Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.
Elementos de solicitação
Elemento |
Descrição |
Obrigatório |
---|---|---|
RestoreRequest |
Container para informações de restauração Tipo: recipiente |
Sim |
Days |
Indica a duração do armazenamento do objeto restaurado. O valor mínimo é 1 e o valor máximo é 30. Tipo: inteiro positivo |
Sim |
RestoreJob |
Container para opções de restauração Tipo: recipiente |
Não |
Nível |
Opções de restauração: Expedited | Standard Expedited indica que os dados podem ser restaurados dentro de 1 a 5 minutos. Standard indica que os dados podem ser restaurados dentro de 3 a 5 horas. O valor padrão é Standard. Tipo: string |
Não |
Response Syntax
1
|
HTTP/1.1 status_code Date: date |
Cabeçalhos de resposta
A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.
Elementos de resposta
Esta resposta não envolve elementos.
Respostas de erro
Código de erro |
Descrição |
Código de status HTTP |
---|---|---|
RestoreAlreadyInProgress |
O objeto está sendo restaurado. A solicitação entra em conflito com outra. ErrorMessage: A restauração do objeto já está em andamento |
409 Conflict |
ObjectHasAlreadyRestored |
Os objetos foram restaurados e o período de retenção dos objetos não pode ser reduzido. ErrorMessage: Após restaurar um objeto arquivado, você não pode encurtar o período de restauração do objeto arquivado |
409 Conflict |
MalformedXML |
Valor inválido para o campo Days (não um número inteiro) ErrorMessage: O XML fornecido não foi bem formado ou não foi validado em relação ao nosso esquema publicado |
400 Bad Request |
InvalidArgument |
O valor do campo Days não está dentro do intervalo de 1 a 30. ErrorMessage: dias de restauração deve ser pelo menos 1 e no máximo 30 |
400 Bad Request |
MalformedXML |
Valor inválido para o campo Tier. ErrorMessage: O XML fornecido não foi bem formado ou não foi validado em relação ao nosso esquema publicado |
400 Bad Request |
InvalidObjectState |
O objeto restaurado não é objeto de um arquivo. ErrorMessage: A restauração não é permitida, pois a classe de armazenamento do objeto não é FRIO |
403 Forbidden |
Solicitação de exemplo
1
|
POST /object?restore HTTP/1.1 Host: examplebucket.obs.region.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 04:39:46 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:kaEwOixnSVuS6If3Q0Lnd6kxm5A= Content-Length: 183 <RestoreRequest> <Days>2</Days> <RestoreJob> <Tier>Expedited</Tier> </RestoreJob> </RestoreRequest> |
Resposta de exemplo
1
|
HTTP/1.1 202 Accepted Server: OBS x-obs-request-id: A2F500000163F374CCBB2063F834C6C4 x-obs-id-2: 32AAAUgAIAABAAAQAAEAABAAAQAAEAABCSLbWIs23RR95NVpkbWlJdlm8Dq+wQBw Date: WED, 01 Jul 2015 04:39:46 GMT Content-Length: 0 |