Restauración de objetos de Archive
Funciones
Para obtener el contenido de un objeto en la clase de almacenamiento Archive, primero debe restaurar el objeto y luego puede descargarlo. Después de restaurar un objeto, se guarda una copia del objeto en la clase de almacenamiento Standard. Al hacerlo, el objeto de la clase de almacenamiento Archive y su copia de la clase de almacenamiento Standard coexisten en el bucket. La copia se eliminará automáticamente una vez que expire su período de conservación.
Control de versiones
De forma predeterminada, esta operación devuelve la última versión de un objeto. Si el objeto tiene un marcador de borrado, se devuelve el código de estado 404. Para restaurar un objeto de una versión especificada, el parámetro versionId se puede utilizar para especificar la versión deseada.
Sintaxis de solicitud
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 solicitud
|
Parámetro |
Descripción |
Obligatorio |
|---|---|---|
|
versionId |
ID de versión del objeto de Archive que se va a restaurar Tipo: string |
No |
Encabezados de solicitud
Esta solicitud utiliza encabezados comunes. Para obtener más información, véase Tabla 3.
Elementos de solicitud
|
Elemento |
Descripción |
Obligatorio |
|---|---|---|
|
RestoreRequest |
Contenedor para la información de restauración Tipo: container |
Sí |
|
Days |
Indica la duración de almacenamiento del objeto restaurado. El valor mínimo es 1 y el valor máximo es 30. Tipo: integer |
Sí |
|
RestoreJob |
Contenedor para las opciones de restauración Tipo: container |
No |
|
Tier |
Opciones de restauración: Expedited | Standard Expedited indica que los objetos se pueden restaurar rápidamente desde el almacenamiento de Archive dentro de 1 a 5 minutos. Standard indica que los objetos se pueden restaurar desde el almacenamiento de Archive dentro de 3 a 5 horas.
NOTA:
To restore a large number of objects from the Deep Archive storage class, you are advised to use the standard restore. The restore time spent depends on the object size and data volume restored. El valor predeterminado es Standard. Tipo: string |
No |
Sintaxis de respuesta
1 2 |
HTTP/1.1 status_code Date: date |
Encabezados de respuesta
La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.
Elementos de respuesta
Esta respuesta no contiene elementos.
Respuestas de error
|
Código de error |
Descripción |
Código de estado de HTTP |
|---|---|---|
|
RestoreAlreadyInProgress |
Se está restaurando el objeto. La solicitud entra en el conflicto con otra. ErrorMessage: la restauración de objetos ya está en curso |
409 Conflict |
|
ObjectHasAlreadyRestored |
Los objetos se han restaurado y el período de retención de los objetos no se puede acortar. ErrorMessage Después de restaurar un objeto archivado, no puede acortar el período de restauración del objeto archivado |
409 Conflict |
|
MalformedXML |
Valor no válido para el campo Days (no es un entero) ErrorMessage: El XML que proporcionó no estaba bien formado o no se validó con nuestro esquema publicado |
400 Bad Request |
|
InvalidArgument |
El valor del campo Days no está dentro del rango de 1 a 30. ErrorMessage: los días de restauración deben ser al menos 1 y como máximo 30 |
400 Bad Request |
|
MalformedXML |
Valor no válido para el campo Tier. ErrorMessage: El XML que proporcionó no estaba bien formado o no se validó con nuestro esquema publicado |
400 Bad Request |
|
InvalidObjectState |
El objeto restaurado no se encuentra en el almacenamiento de Archive. ErrorMessage: No se permite la restauración, ya que la clase de almacenamiento del objeto no es COLD ni DEEP_ARCHIVE |
403 Forbidden |
Modelo de solicitud
1 2 3 4 5 6 7 8 9 10 11 12 |
POST /object?restore HTTP/1.1 Host: examplebucket.obs.region.myhuaweicloud.comAccept: */* 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> |
Modelo de respuesta
1 2 3 4 5 6 |
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 |
