Restauration d'un objet à l'aide de l'interface de ligne de commande AWS

Les exemples suivants utilisent des variables d'environnement pour plus de clarté. Ces valeurs doivent être définies sur les valeurs souhaitées, par exemple, $ENDPOINT doit être défini sur https://s3.us.cloud-object-storage.appdomain.cloud, https://s3.eu-de.private.cloud-object-storage.appdomain.cloud ou toute autre valeur requise.

1. Vérifiez le statut de l'objet: aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY La classe de stockage s'affiche sous la forme ("StorageClass": "GLACIER")
2. Restaurez l'objet: aws --endpoint-url $ENDPOINT s3api restore-object ---bucket $BUCKET --key $KEY --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Bulk"}}'
3. Vérifiez le statut : aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY

Création d'une configuration de cycle de vie de compartiment

Cette implémentation de l'opération PUT utilise le paramètre de requête lifecycle pour définir les paramètres de cycle de vie du compartiment. Cette opération permet de créer une définition de règle de cycle de vie unique pour un compartiment donné. La règle est définie comme une règle composée des paramètres suivants : ID, Status et Transition.

L'action de transition permet de faire passer les objets qui seront écrits dans le compartiment à un état Archivé après une période définie. Les modifications apportées à la règle de cycle de vie d'un compartiment sont appliquées uniquement aux nouveaux objets qui sont écrits dans ce compartiment.

Les utilisateurs Cloud IAM doivent disposer au minimum du rôle Writer afin de pouvoir ajouter une règle de cycle de vie au compartiment.

Les utilisateurs d'infrastructure classique doivent disposer des droits d'accès Propriétaire et être en mesure de créer des compartiments dans le compte de stockage afin de pouvoir ajouter une règle de cycle de vie au compartiment.

Cette opération n'utilise pas d'autres paramètres de requête propres aux opérations.

Le corps de la demande doit contenir un bloc XML avec le schéma suivant :

Syntaxe

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>

Exemples

Exemple de requête

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>

Exemple de réponse

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)

Récapitulatif des méthodes

Extraction d'une configuration de cycle de vie de compartiment

Cette implémentation de l'opération GET utilise le paramètre de requête lifecycle pour extraire les paramètres de cycle de vie du compartiment.

Les utilisateurs Cloud IAM doivent disposer au minimum du rôle Reader afin de pouvoir extraire une règle de cycle de vie pour un compartiment.

Les utilisateurs d'infrastructure classique doivent disposer au minimum des droits d'accès Read sur le compartiment afin de pouvoir extraire une règle de cycle de vie pour un compartiment.

Cette opération n'utilise pas d'autres en-têtes, paramètres de requête ou contenu propres aux opérations.

Syntaxe

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

Exemples

Exemple de requête

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

Exemple de réponse

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)

Suppression d'une configuration de cycle de vie de compartiment

Cette implémentation de l'opération DELETE utilise le paramètre de requête lifecycle pour retirer les paramètres de cycle de vie du compartiment. Les transitions définies par les règles ne seront plus effectuées pour les nouveaux objets.

Remarque : les règles de transition existantes seront conservées pour les objets qui avaient déjà été écrits dans le compartiment avant la suppression des règles.

Les utilisateurs Cloud IAM doivent disposer au minimum du rôle Writer afin de pouvoir retirer une règle de cycle de vie d'un compartiment.

Les utilisateurs d'infrastructure classique doivent disposer des droits d'accès Owner sur le compartiment afin de pouvoir retirer une règle de cycle de vie d'un compartiment.

Cette opération n'utilise pas d'autres en-têtes, paramètres de requête ou contenu propres aux opérations.

Syntaxe

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

Exemples

Exemple de requête

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

Exemple de réponse

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)

Restauration temporaire d'un objet archivé

Cette implémentation de l'opération POST utilise le paramètre de requête restore pour demander la restauration temporaire d'un objet archivé. L'utilisateur doit commencer par restaurer un objet archivé avant de le recevoir par téléchargement ou de le modifier. Lorsqu'il restaure un objet, l'utilisateur doit spécifier une période au terme de laquelle la copie temporaire de cet objet sera supprimée. L'objet conserve la classe de stockage du compartiment.

Un délai maximal de 12 heures peut s'écouler avant que la copie restaurée ne soit accessible. Une demande HEAD peut être utilisée pour vérifier si la copie restaurée est disponible.

Pour pouvoir restaurer définitivement l'objet, l'utilisateur doit copier l'objet restauré dans un compartiment qui ne possède pas de configuration de cycle de vie active.

Les utilisateurs Cloud IAM doivent disposer au minimum du rôle Writer afin de pouvoir restaurer un objet.

Les utilisateurs d'infrastructure classique doivent disposer au minimum des droits d'accès Write sur le compartiment et des droits d'accès Read sur l'objet afin de pouvoir restaurer celui-ci.

Cette opération n'utilise pas d'autres paramètres de requête propres aux opérations.

Le corps de la demande doit contenir un bloc XML avec le schéma suivant :

Une réponse réussie renvoie une valeur 202 si l'objet est à l'état Archivé et une valeur 200 si l'objet est déjà à l'état Restauré. Si l'objet est déjà à l'état Restauré et qu'une nouvelle demande de restauration de l'objet est reçue, l'élément Days met à jour le délai d'expiration de l'objet restauré.

Syntaxe

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>

Exemples

Exemple de requête

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>

Exemple de réponse

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)

Récapitulatif des méthodes

Obtention des en-têtes d'un objet

Une demande HEAD avec un chemin d'accès à un objet permet d'extraire les en-têtes de cet objet. Cette opération n'utilise pas de paramètres de requête ou d'éléments de contenu propres aux opérations.

Syntaxe

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

En-têtes de réponse pour les objets archivés

Exemple de demande

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

Exemple de réponse

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

Récapitulatif des méthodes