Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

En esta página

Funciones
Control de versiones
Sintaxis de solicitud
Parámetros de solicitud
Encabezados de solicitud
Elementos de solicitud
Sintaxis de respuesta
Encabezados de respuesta
Elementos de respuesta
Respuestas de error
Modelo de solicitud
Modelo de respuesta

Mostrar todo

Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Operaciones en objetos/ Restauración de objetos de Archive

Restauración de objetos de Archive

Actualización más reciente 2024-09-18 GMT+08:00

Ver PDF

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

Parámetro

Descripción

Obligatorio

versionId

ID de versión del objeto de Archive que se va a restaurar

Tipo: string

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para obtener más información, véase Tabla 3.

Elementos de solicitud

**Tabla 1** 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

**Tabla 2** Lista de códigos de error de acceso OBS
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

    
       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

    
       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

Tema principal: Operaciones en objetos

Tema anterior: Eliminación de objetos

Tema siguiente: Adición de un objeto

Comentarios

¿Le pareció útil esta página?

Sí No

Deje algún comentario

Muchas gracias por sus comentarios. Seguiremos trabajando para mejorar la documentación.

El sistema está ocupado. Vuelva a intentarlo más tarde.

¿Cuáles de los siguientes problemas se presentaron?

Contenido diferente a la de la IU del producto

Descripciones poco claras

Falta de ejemplos o código

Pasos incorrectos

No puedo encontrar lo que necesito

Falta de prácticas recomendadas

Comentarios (opcional)

0/500

Seleccione al menos un tipo de problema e ingrese sus comentarios o sugerencias.

Ingrese 500 caracteres como máximo.

Enviar Cancelar