Object Storage Service:restore-object

Notas de uso

• De forma predeterminada, una cuenta de Alibaba Cloud tiene los permisos necesarios para restaurar objetos. Para restaurar objetos como usuario RAM o mediante Security Token Service (STS), se requiere el permiso oss:RestoreObject. Para obtener más información, consulte Grant a custom policy.

• El comando restore-object solo aplica a objetos Archive o Cold Archive. Este comando no es compatible con objetos Standard ni con objetos de acceso poco frecuente (IA).

• Para leer un objeto Archive o Cold Archive, debe restaurar el objeto previamente. La restauración de un objeto Archive tarda varios minutos, mientras que la de un objeto Cold Archive puede tardar varias horas.

• El estado restaurado de un objeto Archive dura un máximo de 7 días (el valor del parámetro Days oscila entre 1 y 7). Una vez que expira este estado, el objeto vuelve automáticamente al estado congelado. Si planea realizar una migración de datos (como una migración entre cuentas o a gran escala) después de restaurar el objeto y esta tarea podría durar más de 7 días, utilice CopyObject para convertir el objeto Archive a la clase de almacenamiento Standard dentro del periodo de validez de la restauración antes de iniciar la migración. Esto evita fallos en la migración causados por el retorno del objeto al estado congelado tras la expiración del estado restaurado.

Facturación

Al restaurar objetos se generan cargos por almacenamiento, recuperación de datos y llamadas a operaciones de API. Además, se aplican cargos por almacenamiento temporal cuando se restauran objetos Cold Archive y Deep Cold Archive.

• Cargos por almacenamiento: Se le cobra por el almacenamiento según las reglas de facturación para objetos Archive, Cold Archive y Deep Cold Archive durante y después de la restauración. Para obtener más información, consulte Storage fees.

• Se le cobra por la recuperación de datos según el tamaño de los objetos Archive, Cold Archive o Deep Cold Archive restaurados. Para obtener más información, consulte Data processing fees.

• Cargos por llamadas a operaciones de API:

  • Se le cobra por las llamadas a operaciones de API según el número de solicitudes PUT al restaurar objetos Archive. Para obtener más información, consulte Request fees.

  • Se le cobra por las solicitudes de recuperación de datos al restaurar objetos Cold Archive o Deep Cold Archive. Para obtener más información, consulte Request fees.

• Cargos por almacenamiento temporal: Al restaurar un objeto Cold Archive o Deep Cold Archive, se genera una réplica del objeto para acceso temporal. Se le cobra por el almacenamiento temporal de dicha réplica según la clase de almacenamiento Standard hasta que el objeto Cold Archive o Deep Cold Archive vuelva al estado congelado. Para obtener más información, consulte Temporary storage fees.

Proceso de restauración

El proceso de restauración es el mismo para objetos de distintas clases de almacenamiento. El proceso es el siguiente:

1. Inicialmente, el objeto se encuentra en estado congelado.

2. Después de enviar una solicitud de restauración, el objeto pasa al estado de restauración.

3. Una vez completada la tarea del lado del servidor, el objeto entra en estado restaurado. En ese momento ya puede leer el objeto.

4. Si envía otra solicitud de restauración mientras el objeto está en estado restaurado, se extiende la duración de dicho estado. La duración total extendida no puede exceder el límite máximo permitido para la clase de almacenamiento.

5. Cuando finaliza el estado restaurado, el objeto vuelve al estado congelado y su clase de almacenamiento original permanece sin cambios.

Tiempo de restauración

En la siguiente tabla se muestra el tiempo necesario para restaurar objetos de diferentes clases de almacenamiento. Los tiempos reales de restauración pueden variar.

Cuota de restauración

• Para una sola cuenta de Alibaba Cloud en una única región, la cuota de referencia para la restauración de objetos Cold Archive es de 500 objetos por segundo en promedio, y la cuota total entre las tres prioridades de restauración es de 100 TB a 120 TB por día. Si su negocio requiere una cuota de restauración mayor, póngase en contacto con Technical Support.

• Para una sola cuenta de Alibaba Cloud en una única región, la cuota de referencia para la restauración de objetos Deep Cold Archive es de 100 objetos por segundo en promedio, y la cuota total entre las dos prioridades de restauración es de 10 TB a 15 TB por día. Si su negocio requiere una cuota de restauración mayor, póngase en contacto con Technical Support.

Después de superar la cuota de referencia de restauración para objetos Cold Archive o Deep Cold Archive, aún puede enviar solicitudes de restauración. Estas solicitudes se colocan en cola y la restauración puede tardar más que el tiempo asociado a la prioridad especificada.

Duración del estado restaurado

La duración durante la cual los objetos pueden permanecer en estado restaurado varía según la clase de almacenamiento.

Sintaxis del comando

ossutil api restore-object --bucket value --key value [flags]

--restore-request

La opción de configuración --restore-request admite formatos XML y JSON. Si el valor de la opción contiene el prefijo 'file://', los parámetros de configuración se leen del archivo especificado.

• Formato XML:

  <RestoreRequest>
    <Days>integer</Days>
    <JobParameters>
      <Tier>string</Tier>
    </JobParameters>
  </RestoreRequest>

• Formato JSON:

  {
    "Days": integer,
    "JobParameters": {
      "Tier": "string"
    }
  }

Ejemplos

Operación de API relacionada

El comando restore-object corresponde a la operación RestoreObject. Para obtener más información, consulte RestoreObject.