コールド・データのアーカイブとアクセス

AWS CLI を使用したオブジェクトのリストア

以下の例では、分かりやすくするために環境変数を使用しています。 これらは必要な値に設定する必要があります。例えば、 $ENDPOINT は https://s3.us.cloud-object-storage.appdomain.cloud、 https://s3.eu-de.private.cloud-object-storage.appdomain.cloud、またはその他の必要な値に設定します。

1. オブジェクト状況の確認: aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY ストレージ・クラスは、 ("StorageClass": "GLACIER") として表示されます。
2. オブジェクトを復元します。 aws --endpoint-url $ENDPOINT s3api restore-object ---bucket $BUCKET --key $KEY --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Bulk"}}'
3. 状況を確認します。 aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY

バケットのライフサイクル構成の作成

PUT 操作のこの実装は、lifecycle 照会パラメーターを使用してバケットのライフサイクル設定を設定します。 この操作では、特定のバケットに対して単一のライフサイクル・ポリシー定義が可能です。 ポリシーは、パラメーター ID、Status、および Transition から構成されるルールとして定義されます。

遷移アクションは、バケットに書き込まれる将来のオブジェクトを、定義された期間が過ぎた後にアーカイブ済み状態にすることができます。 バケットのライフサイクル・ポリシーの変更は、バケットに書き込まれた新規オブジェクトにのみ適用されます。

Cloud IAM ユーザーがバケットにライフサイクル・ポリシーを追加するには、最小限 Writer 役割を持っている必要があります。

クラシック・インフラストラクチャーのユーザーがバケットにライフサイクル・ポリシーを追加するには、所有者許可を持っていて、ストレージ・アカウントにバケットを作成できなければなりません。

この操作では、追加の操作固有の照会パラメーターは使用されません。

ペイロードの完全性チェックとして、 Content-MD5 ヘッダーまたは checksum ヘッダー( x-amz-checksum-crc32、 x-amz-checksum-crc32c、 x-amz-checksum-crc64nvme、 x-amz-checksum-sha1、または x-amz-checksum-sha256 を含む)が必要である。

要求の本体には、以下のスキーマの XML ブロックが含まれている必要があります。

構文

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>

例

サンプル要求

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>

サンプル応答

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)

メソッドの要約

バケットのライフサイクル構成の取得

GET 操作のこの実装は、lifecycle 照会パラメーターを使用してバケットのライフサイクル設定を取得します。

Cloud IAM ユーザーがバケットのライフサイクルを取得するには、最小限 Reader 役割を持っている必要があります。

クラシック・インフラストラクチャーのユーザーがバケットのライフサイクル・ポリシーを取得するには、最小限、バケットに対する Read 許可を持っている必要があります。

この操作では、追加の操作固有のヘッダー、照会パラメーター、およびペイロードは使用されません。

構文

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

例

サンプル要求

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

サンプル応答

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)

バケットのライフサイクル構成の削除

DELETE 操作のこの実装は、lifecycle 照会パラメーターを使用してバケットのすべてのライフサイクル設定を削除します。 ルールで定義された遷移は、新規オブジェクトに対しては行われなくなります。

注: 既存の遷移ルールは、ルールが削除される前に既にバケットに書き込まれたオブジェクトのために保持されます。

Cloud IAM ユーザーがバケットからライフサイクル・ポリシーを削除するには、最小限 Writer 役割を持っている必要があります。

クラシック・インフラストラクチャーのユーザーがバケットからライフサイクル・ポリシーを削除するには、バケットに対する「Owner」許可を持っている必要があります。

この操作では、追加の操作固有のヘッダー、照会パラメーター、およびペイロードは使用されません。

構文

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

例

サンプル要求

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

サンプル応答

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)

アーカイブ済みオブジェクトの一時的なリストア

POST 操作のこの実装は、restore 照会パラメーターを使用して、アーカイブ済みオブジェクトの一時的なリストアを要求します。 ユーザーは、まずアーカイブ済みオブジェクトをリストアした後で、オブジェクトをダウンロードまたは変更する必要があります。 ユーザーは、オブジェクトをリストアするときに、オブジェクトの一時コピーが削除されるまでの期間を指定する必要があります。 オブジェクトは、バケットのストレージ・クラスを保持します。

リストアされたコピーがアクセス可能になるまでに、最大 12 時間の遅延が生じることがあります。 リストアされたコピーが使用可能かどうかを HEAD 要求で検査できます。

オブジェクトを永続的にリストアするには、ユーザーは、リストアされるオブジェクトを、アクティブなライフサイクル構成がないバケットにコピーする必要があります。

Cloud IAM ユーザーがオブジェクトをリストアするには、最小限 Writer 役割を持っている必要があります。

クラシック・インフラストラクチャーのユーザーがオブジェクトをリストアするには、最小限、バケットに対する Write 許可と、オブジェクトに対する Read 許可を持っている必要があります。

この操作では、追加の操作固有の照会パラメーターは使用されません。

要求の本体には、以下のスキーマの XML ブロックが含まれている必要があります。

正常な応答では、オブジェクトがアーカイブ済み状態の場合は 202 が返され、オブジェクトが既にリストア済み状態の場合は 200 が返されます。 既にリストア済み状態のオブジェクトをリストアする新しい要求が受信されると、リストアされたオブジェクトの有効期限は Days 要素によって更新されます。

構文

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>

例

サンプル要求

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>

サンプル応答

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)

メソッドの要約

オブジェクトのヘッダーの取得

オブジェクトへのパスが指定された HEAD は、そのオブジェクトのヘッダーを取得します。 この操作では操作固有の照会パラメーターおよびペイロード要素は使用されません。

構文

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

アーカイブ・オブジェクトのレスポンス・ヘッダ

サンプル要求

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

サンプル応答

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

メソッドの要約