Ripristino di un oggetto utilizzando la CLI AWS

I seguenti esempi utilizzano le variabili di ambiente per maggiore chiarezza. Questi devono essere impostati sui valori desiderati, ad esempio $ENDPOINT deve essere impostato su https://s3.us.cloud-object-storage.appdomain.cloud, https://s3.eu-de.private.cloud-object-storage.appdomain.cloud o qualsiasi altro valore richiesto.

1. Verifica stato oggetto: aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY La classe di memoria verrà visualizzata come ("StorageClass": "GLACIER")
2. Ripristinare l'oggetto: aws --endpoint-url $ENDPOINT s3api restore-object ---bucket $BUCKET --key $KEY --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Bulk"}}'
3. Controllare lo stato: aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY

Crea la configurazione del ciclo di vita di un bucket

Questa implementazione dell'operazione PUT utilizza il parametro di query lifecycle per configurare le impostazioni di ciclo di vita per il bucket. Questa operazione consente una singola definizione della politica del ciclo di vita per un determinato bucket. La politica viene definita come una regola composta dai seguenti parametri: ID, Status e Transition.

L'azione di transizione consente oggetti futuri scritti nel bucket in uno stato archiviato dopo un determinato periodo di tempo. Le modifiche alla politica del ciclo di vita per un bucket vengono applicate solo ai nuovi oggetti scritti in tale bucket.

Gli utenti Cloud IAM devono disporre almeno del ruolo di scrittore (Writer) per aggiungere una politica del ciclo di vita al bucket.

Gli utenti dell'infrastruttura classica devono disporre delle autorizzazioni di proprietario (Owner) ed essere in grado di creare i bucket nell'account di archiviazione per aggiungere una politica del ciclo di vita al bucket.

Questa operazione non utilizza parametri di query aggiuntivi specifici dell'operazione.

Un'intestazione Content-MD5 o un'intestazione checksum (comprese x-amz-checksum-crc32, x-amz-checksum-crc32c, x-amz-checksum-crc64nvme, x-amz-checksum-sha1, o x-amz-checksum-sha256) è richiesta come controllo di integrità per il payload.

Il corpo della richiesta deve contenere un blocco XML con il seguente schema:

Sintassi

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>

Esempi

Richiesta di esempio

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>

Risposta di esempio

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)

Riepilogo metodo

Richiama la configurazione del ciclo di vita di un bucket

Questa implementazione dell'operazione GET utilizza il parametro di query lifecycle per richiamare le impostazioni del ciclo di vita per il bucket.

Gli utenti Cloud IAM devono disporre almeno del ruolo di lettore (Reader) per richiamare un ciclo di vita per un bucket.

Gli utenti dell'infrastruttura classica devono disporre almeno delle autorizzazioni di lettura (Read) per il bucket per richiamare una politica del ciclo di vita per un bucket.

Questa operazione non utilizza intestazioni, parametri di query o payload aggiuntivi specifici dell'operazione.

Sintassi

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

Esempi

Richiesta di esempio

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

Risposta di esempio

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)

Elimina la configurazione del ciclo di vita di un bucket

Questa implementazione dell'operazione DELETE utilizza il parametro di query lifecycle per rimuovere tutte le impostazioni del ciclo di vita per il bucket. Le transizioni definite dalle regole non verranno più eseguite per i nuovi oggetti.

Nota: le regole di transizione esistenti verranno conservate per gli oggetti che sono stati già scritti nel bucket prima dell'eliminazione delle regole.

Gli utenti Cloud IAM devono disporre almeno del ruolo di scrittore (Writer) per rimuovere una politica del ciclo di vita da un bucket.

Gli utenti dell'infrastruttura classica devono disporre almeno delle autorizzazioni di proprietario (Owner) per il bucket per rimuovere una politica del ciclo di vita da un bucket.

Questa operazione non utilizza intestazioni, parametri di query o payload aggiuntivi specifici dell'operazione.

Sintassi

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

Esempi

Richiesta di esempio

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

Risposta di esempio

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)

Ripristina temporaneamente un oggetto archiviato

Questa implementazione dell'operazione POST utilizza il parametro di query restore per richiedere il ripristino temporaneo di un oggetto archiviato. L'utente deve innanzitutto ripristinare un oggetto archiviato prima di scaricare o modificare l'oggetto. Quando ripristina un oggetto, l'utente deve specificare un periodo trascorso il quale la copia temporanea dell'oggetto verrà eliminata. L'oggetto conserva la classe di archiviazione del bucket.

Può verificarsi un ritardo fino a 12 ore prima che la copia di ripristino sia disponibile per l'accesso. Una richiesta HEAD può controllare se la copia ripristinata è disponibile.

Per ripristinare in modo permanente l'oggetto, l'utente deve copiare l'oggetto ripristinato in un bucket che non ha una configurazione attiva del ciclo di vita.

Gli utenti Cloud IAM devono disporre almeno del ruolo di scrittore (Writer) per ripristinare un oggetto.

Gli utenti dell'infrastruttura classica devono disporre almeno delle autorizzazioni di scrittore (Write) per il bucket e dell'autorizzazione di lettura (Read) per l'oggetto per ripristinarlo.

Questa operazione non utilizza parametri di query aggiuntivi specifici dell'operazione.

Il corpo della richiesta deve contenere un blocco XML con il seguente schema:

Una risposta di esito positivo restituisce un codice 202 se l'oggetto è nello stato archiviato e un codice 200 se l'oggetto è già nello stato ripristinato. Se l'oggetto è già nello stato ripristinato e viene ricevuta una nuova richiesta di ripristino dell'oggetto, l'elemento Days aggiornerà la scadenza dell'oggetto ripristinato.

Sintassi

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>

Esempi

Richiesta di esempio

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>

Risposta di esempio

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)

Riepilogo metodo

Ottieni le intestazioni di un oggetto

Una richiesta HEAD, dato un percorso a un oggetto, richiama le intestazioni di tale oggetto. Questa operazione non utilizza parametri di query o elementi payload specifici dell'operazione.

Sintassi

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

Intestazioni di risposta per gli oggetti archiviati

Richiesta di esempio

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

Risposta di esempio

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()

Riepilogo metodo