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

메소드 요약