Objekt über die AWS-CLI wiederherstellen

In den folgenden Beispielen werden Umgebungsvariablen zur Verdeutlichung verwendet. Diese müssen auf die gewünschten Werte gesetzt werden, z. B. $ENDPOINT auf https://s3.us.cloud-object-storage.appdomain.cloud oder https://s3.eu-de.private.cloud-object-storage.appdomain.cloud oder auf einen anderen erforderlichen Wert.

1. Objektstatus prüfen: aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY Die Speicherklasse wird als ("StorageClass": "GLACIER") angezeigt.
2. Das Objekt zurückschreiben: aws --endpoint-url $ENDPOINT s3api restore-object ---bucket $BUCKET --key $KEY --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Bulk"}}'
3. Überprüfen Sie den Status: aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY

Konfiguration für Bucketlebenszyklus erstellen

Bei dieser Implementierung der PUT-Operation wird der Abfrageparameter lifecycle verwendet, um die Lebenszykluseinstellungen für das Bucket festzulegen. Diese Operation ermöglicht die Verwendung einer einzigen Lebenszyklusrichtliniendefinition für ein bestimmtes Bucket. Die Richtlinie wird als Regel definiert, die die folgenden Parameter umfasst: ID, Status und Transition (Übergang).

Die Übergangsaktion ermöglicht die Überführung von Objekten, die zukünftig in das Bucket geschrieben werden, in den Status 'Archiviert', nachdem ein definierter Zeitraum verstrichen ist. Änderungen an der Lebenszyklusrichtlinie für ein Bucket werden nur auf neue Objekte angewendet, die in dieses Bucket geschrieben werden.

Cloud IAM-Benutzer müssen mindestens über die Rolle Writer verfügen, um eine Lebenszyklusrichtlinie zum Bucket hinzuzufügen.

Benutzer der klassischen Infrastruktur müssen über Eignerberechtigungen verfügen und zum Erstellen von Buckets im Speicherkonto berechtigt sein, um eine Lebenszyklusrichtlinie zum Bucket hinzufügen zu können.

Bei dieser Operation werden keine zusätzlichen operationsspezifischen Abfrageparameter verwendet.

Ein Content-MD5-Header oder ein checksum-Header (einschließlich x-amz-checksum-crc32, x-amz-checksum-crc32c, x-amz-checksum-crc64nvme, x-amz-checksum-sha1 oder x-amz-checksum-sha256) ist als Integritätsprüfung für die Nutzdaten erforderlich.

Der Hauptteil der Anforderung muss einen XML-Block mit dem folgenden Schema enthalten:

Syntax

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>

Beispiele

Beispielanforderung

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>

Beispielantwort

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)

Methodenzusammenfassung

Konfiguration für Bucketlebenszyklus abrufen

Bei dieser Implementierung der GET-Operation wird der Abfrageparameter lifecycle verwendet, um die Lebenszykluseinstellungen für das Bucket abzurufen.

Cloud IAM-Benutzer müssen mindestens über die Rolle Reader verfügen, um einen Lebenszyklus für ein Bucket abzurufen.

Benutzer der klassischen Infrastruktur müssen mindestens über die Berechtigungen zum Read für das Bucket verfügen, um eine Lebenszyklusrichtlinie für ein Bucket abzurufen.

Diese Operation verwendet keine zusätzlichen operationsspezifischen Header, Abfrageparameter oder Nutzdaten.

Syntax

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

Beispiele

Beispielanforderung

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

Beispielantwort

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)

Konfiguration für Bucketlebenszyklus löschen

Bei dieser Implementierung der DELETE-Operation wird der Abfrageparameter lifecycle verwendet, um die Lebenszykluseinstellungen für das Bucket zu entfernen. Übergänge, die anhand der Regeln definiert wurden, werden für neue Objekte nicht mehr angewendet.

Hinweis: Vorhandene Übergangsregeln werden für Objekte beibehalten, die bereits in das Bucket geschrieben wurden, bevor die Regeln gelöscht wurden.

Cloud IAM-Benutzer müssen mindestens über die Rolle Writer verfügen, um eine Lebenszyklusrichtlinie aus dem Bucket zu entfernen.

Benutzer der klassischen Infrastruktur müssen mindestens über die Berechtigungen für Owner für das Bucket verfügen, um eine Lebenszyklusrichtlinie aus einem Bucket zu entfernen.

Diese Operation verwendet keine zusätzlichen operationsspezifischen Header, Abfrageparameter oder Nutzdaten.

Syntax

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

Beispiele

Beispielanforderung

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

Beispielantwort

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)

Archiviertes Objekt vorübergehend wiederherstellen

Bei dieser Implementierung der POST-Operation wird der Abfrageparameter restore verwendet, um die vorübergehende Wiederherstellung eines archivierten Objekts anzufordern. Der Benutzer muss ein archiviertes Objekt zuerst wiederherstellen, bevor es heruntergeladen oder geändert wird. Beim Wiederherstellen eines Objekts muss der Benutzer einen Zeitraum angeben, nach dessen Ablauf die temporäre Kopie des Objekts gelöscht wird. Das Objekt behält die Speicherklasse des Buckets bei.

Es kann zu einer Verzögerung von bis zu 12 Stunden kommen, bevor auf die wiederhergestellte Kopie zugegriffen werden kann. Eine HEAD-Anforderung kann verwendet werden, um zu prüfen, ob die wiederhergestellte Kopie verfügbar ist.

Um das Objekt dauerhaft wiederherzustellen, muss der Benutzer das wiederhergestellte Objekt in ein Bucket kopieren, das keine aktive Lebenszykluskonfiguration hat.

Cloud IAM-Benutzer müssen mindestens über die Rolle Writer verfügen, um ein Objekt wiederherzustellen.

Benutzer der klassischen Infrastruktur müssen mindestens über die Berechtigungen Write für das Bucket und über die Berechtigung Read für das Objekt verfügen, um es wiederherzustellen.

Bei dieser Operation werden keine zusätzlichen operationsspezifischen Abfrageparameter verwendet.

Der Hauptteil der Anforderung muss einen XML-Block mit dem folgenden Schema enthalten:

Eine erfolgreiche Antwort gibt eine Nachricht 202 zurück, wenn das Objekt sich im Status 'Archiviert' befindet, und eine Nachricht 200, wenn sich das Objekt bereits im Status 'Wiederhergestellt' befindet. Wenn sich das Objekt bereits im Status 'Wiederhergestellt' befindet und eine neue Anforderung zum Wiederherstellen des Objekts empfangen wird, dann wird mit dem Element Days die Ablaufzeit des wiederhergestellten Objekts aktualisiert.

Syntax

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>

Beispiele

Beispielanforderung

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>

Beispielantwort

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)

Methodenzusammenfassung

Header eines Objekts abrufen

Mit einer HEAD-Anforderung, in der ein Pfad zu einem Objekt angegeben wurde, werden die Header des betreffenden Objekts abgerufen. Diese Operation verwendet keine operationsspezifischen Abfrageparameter oder Nutzdatenelemente.

Syntax

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

Antwort-Header für archivierte Objekte

Beispielanforderung

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

Beispielantwort

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

Methodenzusammenfassung