Restauración de un objeto utilizando la CLI de AWS

Los ejemplos siguientes utilizan variables de entorno para mayor claridad. Se deben establecer en los valores deseados, por ejemplo, $ENDPOINT se establecería en https://s3.us.cloud-object-storage.appdomain.cloud, o https://s3.eu-de.private.cloud-object-storage.appdomain.cloud, o cualquier otro valor necesario.

1. Comprobar estado de objeto: aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY La clase de almacenamiento se mostrará como ("StorageClass": "GLACIER")
2. Restaure el objeto: aws --endpoint-url $ENDPOINT s3api restore-object ---bucket $BUCKET --key $KEY --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Bulk"}}'
3. Compruebe el estado: aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY

Creación de una configuración de ciclo de vida de un grupo

Esta implementación de la operación PUT utiliza el parámetro de consulta lifecycle para definir valores de ciclo de vida para el grupo. Esta operación permite una sola definición de política de ciclo de vida para un determinado grupo. La política se define como una regla que consta de los parámetros siguientes: ID, Status y Transition.

La acción de transición permite pasar objetos futuros escritos en el grupo a un estado archivado después de un periodo de tiempo definido. Los cambios en la política de ciclo de vida para un grupo solo se aplican a los objetos nuevos escritos en ese grupo.

Los usuarios de Cloud IAM deben tener como mínimo el rol de Writer para poder añadir una política de ciclo de vida al grupo.

Los usuarios de la infraestructura clásica deben tener permisos de Propietario y poder crear grupos en la cuenta de almacenamiento para añadir una política de ciclo de vida al grupo.

Esta operación no utiliza parámetros de consulta adicionales específicos de la operación.

Se requiere un encabezado Content-MD5 o un encabezado checksum (incluyendo x-amz-checksum-crc32, x-amz-checksum-crc32c, x-amz-checksum-crc64nvme, x-amz-checksum-sha1, o x-amz-checksum-sha256) como comprobación de integridad para la carga útil.

El cuerpo de la solicitud debe contener un bloque XML con el esquema siguiente:

Sintaxis

PUT https://{endpoint}/{bucket}?lifecycle # path style
PUT https://{bucket}.{endpoint}?lifecycle # virtual host style

<LifecycleConfiguration>
	<Rule>
		<ID>{string}</ID>
		<Status>Enabled</Status>
		<Filter>
			<Prefix/>
		</Filter>
		<Transition>
			<Days>{integer}</Days>
			<StorageClass>{StorageClass}</StorageClass>
		</Transition>
	</Rule>
</LifecycleConfiguration>

Ejemplos

Solicitud de ejemplo

PUT /images?lifecycle HTTP/1.1
Host: s3.us.cloud-object-storage.appdomain.cloud
Date: Wed, 7 Feb 2018 17:50:00 GMT
Authorization: authorization string
Content-Type: text/plain
Content-MD5: 1B2M2Y8AsgTpgAmY7PhCfg==
Content-Length: 305

<LifecycleConfiguration>
    <Rule>
        <ID>my-archive-policy</ID>
        <Filter>
			<Prefix/>
		</Filter>
        <Status>Enabled</Status>
        <Transition>
            <Days>20</Days>
            <StorageClass>ACCELERATED</StorageClass>
        </Transition>
    </Rule>
</LifecycleConfiguration>

Respuesta de ejemplo

HTTP/1.1 200 OK
Date: Wed, 7 Feb 2018 17:51:00 GMT
Connection: close

var params = {
  Bucket: 'STRING_VALUE', /* required */
  LifecycleConfiguration: {
    Rules: [ /* required */
      {
        Status: 'Enabled', /* required */
        ID: 'STRING_VALUE',
        Filter: '', /* required */
        Prefix: '',
        Transitions: [
          {
            Date: DATE, /* required if Days not specified */
            Days: 0, /* required if Date not specified */
            StorageClass: 'STRING_VALUE' /* required */
          },
        ]
      },
    ]
  }
};

s3.putBucketLifecycleConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

response = client.put_bucket_lifecycle_configuration(
    Bucket='string',
    LifecycleConfiguration={
        'Rules': [
            {
                'ID': 'string',
                'Status': 'Enabled',
                'Filter': '',
                'Prefix': '',
                'Transitions': [
                    {
                        'Date': datetime(2015, 1, 1),
                        'Days': 123,
                        'StorageClass': 'GLACIER'
                    },
                ]
            },
        ]
    }
)

public SetBucketLifecycleConfigurationRequest(String bucketName,
                                              BucketLifecycleConfiguration lifecycleConfiguration)

Resumen de métodos

Recuperación de una configuración de ciclo de vida de un grupo

Esta implementación de la operación GET utiliza el parámetro de consulta lifecycle para recuperar valores de ciclo de vida para el grupo.

Los usuarios de Cloud IAM deben tener como mínimo el rol de Reader para poder recuperar un ciclo de vida para un grupo.

Los usuarios de la infraestructura clásica deben tener como mínimo permisos de Read sobre el grupo para recuperar una política de ciclo de vida para un grupo.

Esta operación no utiliza cabeceras adicionales específicas de la operación, parámetros de consulta ni carga útil.

Sintaxis

GET https://{endpoint}/{bucket}?lifecycle # path style
GET https://{bucket}.{endpoint}?lifecycle # virtual host style

Ejemplos

Solicitud de ejemplo

GET /images?lifecycle HTTP/1.1
Host: s3.us.cloud-object-storage.appdomain.cloud
Date: Wed, 7 Feb 2018 17:50:00 GMT
Authorization: authorization string

Respuesta de ejemplo

HTTP/1.1 200 OK
Date: Wed, 7 Feb 2018 17:51:00 GMT
Connection: close

<LifecycleConfiguration>
    <Rule>
        <ID>my-archive-policy</ID>
        <Filter />
        <Status>Enabled</Status>
        <Transition>
            <Days>20</Days>
            <StorageClass>GLACIER</StorageClass>
        </Transition>
    </Rule>
</LifecycleConfiguration>

var params = {
  Bucket: 'STRING_VALUE' /* required */
};
s3.getBucketLifecycleConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

response = client.get_bucket_lifecycle_configuration(Bucket='string')

public GetBucketLifecycleConfigurationRequest(String bucketName)

Supresión de una configuración de ciclo de vida de un grupo

Esta implementación de la operación DELETE utiliza el parámetro de consulta lifecycle para eliminar valores de ciclo de vida para el grupo. Las transiciones definidas por las reglas dejarán de ejecutarse para los objetos nuevos.

Nota: se mantendrán las reglas de transición existentes para los objetos que ya se habían escrito en el grupo antes de que se suprimieran las reglas.

Los usuarios de Cloud IAM deben tener como mínimo el rol de Writer para poder eliminar una política de ciclo de vida de un grupo.

Los usuarios de la infraestructura clásica deben tener permisos de Owner sobre el grupo para eliminar una política de ciclo de vida de un grupo.

Esta operación no utiliza cabeceras adicionales específicas de la operación, parámetros de consulta ni carga útil.

Sintaxis

DELETE https://{endpoint}/{bucket}?lifecycle # path style
DELETE https://{bucket}.{endpoint}?lifecycle # virtual host style

Ejemplos

Solicitud de ejemplo

DELETE /images?lifecycle HTTP/1.1
Host: s3.us.cloud-object-storage.appdomain.cloud
Date: Wed, 7 Feb 2018 18:50:00 GMT
Authorization: authorization string

Respuesta de ejemplo

HTTP/1.1 204 No Content
Date: Wed, 7 Feb 2018 18:51:00 GMT
Connection: close

var params = {
  Bucket: 'STRING_VALUE' /* required */
};
s3.deleteBucketLifecycle(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

response = client.delete_bucket_lifecycle(Bucket='string')

public DeleteBucketLifecycleConfigurationRequest(String bucketName)

Restauración temporal de un objeto archivado

Esta implementación de la operación POST utiliza el parámetro de consulta restore para solicitar la restauración temporal de un objeto archivado. Primero el usuario debe restaurar un objeto archivado para poder descargar o modificar el objeto. Cuando se restaura un objeto, el usuario debe especificar un periodo después del cual se suprimirá la copia temporal del objeto. El objeto mantiene la clase de almacenamiento del grupo.

Puede haber un retardo de hasta 12 horas antes de que se pueda acceder a la copia restaurada. Una solicitud HEAD puede comprobar si la copia restaurada está disponible.

Para restaurar el objeto de forma permanente, el usuario debe copiar el objeto restaurado en un grupo que no tenga una configuración de ciclo de vida activa.

Los usuarios de Cloud IAM deben tener como mínimo el rol de Writer para poder restaurar un objeto.

Los usuarios de la infraestructura clásica deben tener como mínimo permisos de Write sobre el grupo y el permiso de Read sobre el objeto para restaurarlo.

Esta operación no utiliza parámetros de consulta adicionales específicos de la operación.

El cuerpo de la solicitud debe contener un bloque XML con el esquema siguiente:

Una respuesta correcta devuelve 202 si el objeto se encuentra en el estado archivado y 200 si el objeto ya está en el estado restaurado. Si el objeto ya está en el estado restaurado y se recibe una nueva solicitud para restaurar el objeto, el elemento Days actualizará el tiempo de caducidad del objeto restaurado.

Sintaxis

POST https://{endpoint}/{bucket}/{object}?restore # path style
POST https://{bucket}.{endpoint}/{object}?restore # virtual host style

<RestoreRequest>
	<Days>{integer}</Days>
	<GlacierJobParameters>
		<Tier>Bulk</Tier>
	</GlacierJobParameters>
</RestoreRequest>

Ejemplos

Solicitud de ejemplo

POST /images/backup?restore HTTP/1.1
Host: s3.us.cloud-object-storage.appdomain.cloud
Date: Wed, 7 Feb 2018 19:50:00 GMT
Authorization: {authorization string}
Content-Type: text/plain
Content-MD5: 1B2M2Y8AsgTpgAmY7PhCfg==
Content-Length: 305

<RestoreRequest>
	<Days>3</Days>
	<GlacierJobParameters>
		<Tier>Bulk</Tier>
	</GlacierJobParameters>
</RestoreRequest>

Respuesta de ejemplo

HTTP/1.1 202 Accepted
Date: Wed, 7 Feb 2018 19:51:00 GMT
Connection: close

var params = {
  Bucket: 'STRING_VALUE', /* required */
  Key: 'STRING_VALUE', /* required */
  ContentMD5: 'STRING_VALUE', /* required */
  RestoreRequest: {
   Days: 1, /* days until copy expires */
   GlacierJobParameters: {
     Tier: 'STRING_VALUE' /* required */
   },
  }
 };
 s3.restoreObject(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
});

response = client.restore_object(
    Bucket='string',
    Key='string',
    RestoreRequest={
        'Days': 123,
        'GlacierJobParameters': {
            'Tier': 'string'
        },
    }
)

public RestoreObjectRequest(String bucketName,
                            String key,
                            int expirationInDays)

Resumen de métodos

Obtención de las cabeceras de un objeto

Un mandato HEAD con una vía de acceso a un objeto recupera las cabeceras de ese objeto. Esta operación no utiliza parámetros de consulta ni elementos de carga útil específicos de la operación.

Sintaxis

HEAD https://{endpoint}/{bucket-name}/{object-name} # path style
HEAD https://{bucket-name}.{endpoint}/{object-name} # virtual host style

Cabeceras de respuesta para objetos archivados

Solicitud de ejemplo

HEAD /images/backup HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20160825T183244Z
Host: s3.us.cloud-object-storage.appdomain.cloud

Respuesta de ejemplo

HTTP/1.1 200 OK
Date: Wed, 7 Feb 2018 19:51:00 GMT
X-Clv-Request-Id: da214d69-1999-4461-a130-81ba33c484a6
Accept-Ranges: bytes
Server: 3.x
X-Clv-S3-Version: 2.5
ETag: "37d4c94839ee181a2224d6242176c4b5"
Content-Type: text/plain; charset=UTF-8
Last-Modified: Thu, 25 Aug 2017 17:49:06 GMT
Content-Length: 11
x-ibm-transition: transition="ARCHIVE", date="Mon, 03 Dec 2018 22:28:38 GMT"
x-amz-restore: ongoing-request="false", expiry-date="Thu, 06 Dec 2018 18:28:38 GMT"
x-amz-storage-class: "GLACIER"
x-ibm-restored-copy-storage-class: "Standard"

response = client.head_object(
    Bucket='string',
    Key='string'
)

var params = {
  Bucket: 'STRING_VALUE', /* required */
  Key: 'STRING_VALUE', /* required */
};
s3.headObject(params, function(err,data) {
  if (err) console.log(err, err.stack); // an error occurred
  else
    console.log(data);           // successful response
});

public ObjectMetadata()

Resumen de métodos