3.4. S3 개체 작업

요청 헤더

partNumber

설명

읽을 개체의 일부입니다. 이렇게 하면 지정된 부분에 대해 범위가 지정된 GET 요청이 활성화됩니다. 이 요청을 사용하면 오브젝트의 일부만 다운로드하는 데 유용합니다.

유효한 값

1에서 10,000 사이의 양의 정수입니다.

필수 항목

없음

범위

설명

검색할 개체의 범위입니다.

참고

GET 요청당 여러 데이터 범위가 지원되지 않습니다.

유효한 값

Range:bytes=beginbyte-endbyte

필수 항목

없음

if-modified-since

설명

타임스탬프 이후 수정된 경우에만 가져옵니다.

유효한 값

Timestamp

필수 항목

없음

if-unmodified-since

설명

타임스탬프 이후 수정되지 않은 경우에만 가져옵니다.

유효한 값

Timestamp

필수 항목

없음

if-match

설명

ETag 오브젝트가 ETag와 일치하는 경우에만 가져옵니다.

유효한 값

엔터티 태그

필수 항목

없음

if-none-match

설명

ETag 오브젝트가 ETag와 일치하는 경우에만 가져옵니다.

유효한 값

엔터티 태그

필수 항목

없음

응답 헤더

content-Range

설명

데이터 범위(data range)는 헤더 필드가 요청에 지정된 경우에만 반환됩니다.

x-amz-version-id

설명

버전 ID 또는 null을 반환합니다.

요청 헤더

범위

설명

검색할 개체의 범위입니다.

유효한 값

Range:bytes=beginbyte-endbyte

필수 항목

없음

if-modified-since

설명

타임스탬프 이후 수정된 경우에만 가져옵니다.

유효한 값

Timestamp

필수 항목

없음

if-match

설명

ETag 오브젝트가 ETag와 일치하는 경우에만 가져옵니다.

유효한 값

엔터티 태그

필수 항목

없음

if-none-match

설명

ETag 오브젝트가 ETag와 일치하는 경우에만 가져옵니다.

유효한 값

엔터티 태그

필수 항목

없음

응답 헤더

x-amz-version-id

설명

버전 ID 또는 null을 반환합니다.

요청 엔티티

ObjectLockConfiguration

설명

요청에 대한 컨테이너입니다.

유형

컨테이너

필수 항목

제공됨

ObjectLockEnabled

설명

이 버킷에 개체 잠금 구성이 활성화되어 있는지 여부를 나타냅니다.

유형

문자열

필수 항목

제공됨

Rule

설명

지정된 버킷에 대한 개체 잠금 규칙입니다.

유형

컨테이너

필수 항목

없음

DefaultRetention

설명

지정된 버킷에 배치된 새 오브젝트에 적용되는 기본 보존 기간입니다.

유형

컨테이너

필수 항목

없음

mode

설명

기본 개체 잠금 모드입니다. 유효한 값: GOVERNANCE/COMPLIANCE.

유형

컨테이너

필수 항목

제공됨

days

설명

기본 보존 기간에 지정된 일 수입니다.

유형

정수

필수 항목

없음

년

설명

기본 보존 기간에 지정된 연도 수입니다.

유형

정수

필수 항목

없음

HTTP 응답

400

상태 코드

MalformedXML

설명

XML 형식이 올바르지 않습니다.

409

상태 코드

InvalidBucketState

설명

버킷 오브젝트 잠금이 활성화되지 않습니다.

응답 엔티티

ObjectLockConfiguration

설명

요청에 대한 컨테이너입니다.

유형

컨테이너

필수 항목

제공됨

ObjectLockEnabled

설명

이 버킷에 개체 잠금 구성이 활성화되어 있는지 여부를 나타냅니다.

유형

문자열

필수 항목

제공됨

Rule

설명

지정된 버킷에 대한 개체 잠금 규칙이 있습니다.

유형

컨테이너

필수 항목

없음

DefaultRetention

설명

지정된 버킷에 배치된 새 오브젝트에 적용되는 기본 보존 기간입니다.

유형

컨테이너

필수 항목

없음

mode

설명

기본 개체 잠금 모드입니다. 유효한 값: GOVERNANCE/COMPLIANCE.

유형

컨테이너

필수 항목

제공됨

days

설명

기본 보존 기간에 지정된 일 수입니다.

유형

정수

필수 항목

없음

년

설명

기본 보존 기간에 지정된 연도 수입니다.

유형

정수

필수 항목

없음

요청 엔티티

LegalHold

설명

요청에 대한 컨테이너입니다.

유형

컨테이너

필수 항목

제공됨

상태

설명

지정된 개체에 법적 보유가 있는지 여부를 나타냅니다.Indicates whether the specified object has a legal hold in place. 유효한 값: ON/OFF

유형

문자열

필수 항목

제공됨

응답 엔티티

LegalHold

설명

요청에 대한 컨테이너입니다.

유형

컨테이너

필수 항목

제공됨

상태

설명

지정된 개체에 법적 보유가 있는지 여부를 나타냅니다.Indicates whether the specified object has a legal hold in place. 유효한 값: ON/OFF

유형

문자열

필수 항목

제공됨

요청 엔티티

보존

설명

요청에 대한 컨테이너입니다.

유형

컨테이너

필수 항목

제공됨

mode

설명

지정된 오브젝트의 보존 모드입니다. 유효한 값: GOVERNANCE/COMPLIANCE

유형

문자열

필수 항목

제공됨

RetainUntilDate

설명

보존 날짜. 형식: 2020-01-05T00:00:00.000Z

유형

Timestamp

필수 항목

제공됨

응답 엔티티

보존

설명

요청에 대한 컨테이너입니다.

유형

컨테이너

필수 항목

제공됨

mode

설명

지정된 오브젝트의 보존 모드입니다. 유효한 값: GOVERNANCE/COMPLIANCE

유형

문자열

필수 항목

제공됨

RetainUntilDate

설명

보존 날짜. 형식: 2020-01-05T00:00:00.000Z

유형

Timestamp

필수 항목

제공됨

요청 엔티티

태그 지정

설명

요청에 대한 컨테이너입니다.

유형

컨테이너

필수 항목

제공됨

TagSet

설명

태그 세트 컬렉션입니다.

유형

문자열

필수 항목

제공됨

요청 헤더

content-md5

설명

메시지의 base64로 인코딩된 MD-5 해시입니다.

유효한 값

문자열입니다. 기본값 또는 제약 조건이 없습니다.

필수 항목

없음

content-type

설명

표준 MIME 유형.

유효한 값

모든 MIME 유형. 기본값: binary/octet-stream.

필수 항목

없음

x-amz-meta-<…​>*

설명

사용자 메타데이터입니다. 오브젝트와 함께 저장됩니다.

유효한 값

최대 8kb의 문자열입니다. 기본값 없음.

필수 항목

없음

x-amz-acl

설명

A Canned ACL입니다.

유효한 값

private,public-read,public-read-write,authenticated-read

필수 항목

없음

응답 헤더

x-amz-version-id

설명

버전 ID 또는 null을 반환합니다.

응답 헤더

x-amz-version-id

설명

버전 ID 또는 null을 반환합니다.

응답 엔티티

AccessControlPolicy

설명

응답을 위한 컨테이너입니다.

유형

컨테이너

AccessControlList

설명

ACL 정보에 대한 컨테이너입니다.

유형

컨테이너

소유자

설명

버킷 소유자의 ID 및 DisplayName 에 대한 컨테이너입니다.

유형

컨테이너

ID

설명

버킷 소유자의 ID입니다.

유형

문자열

DisplayName

설명

버킷 소유자의 표시 이름입니다.

유형

문자열

grant

설명

Grantee 및 Permission 을 위한 컨테이너입니다.

유형

컨테이너

grantee

설명

권한 부여를 수신하는 사용자의 DisplayName 및 ID 에 대한 컨테이너입니다.

유형

컨테이너

권한

설명

grantee 버킷에 부여된 권한 입니다.

유형

문자열

요청 엔티티

AccessControlPolicy

설명

응답을 위한 컨테이너입니다.

유형

컨테이너

AccessControlList

설명

ACL 정보에 대한 컨테이너입니다.

유형

컨테이너

소유자

설명

버킷 소유자의 ID 및 DisplayName 에 대한 컨테이너입니다.

유형

컨테이너

ID

설명

버킷 소유자의 ID입니다.

유형

문자열

DisplayName

설명

버킷 소유자의 표시 이름입니다.

유형

문자열

grant

설명

Grantee 및 Permission 을 위한 컨테이너입니다.

유형

컨테이너

grantee

설명

권한 부여를 수신하는 사용자의 DisplayName 및 ID 에 대한 컨테이너입니다.

유형

컨테이너

권한

설명

grantee 버킷에 부여된 권한 입니다.

유형

문자열

요청 헤더

x-amz-copy-source

설명

소스 버킷 이름 + 오브젝트 이름입니다.

유효한 값

버킷 /오브젝트

필수 항목

제공됨

x-amz-acl

설명

A Canned ACL입니다.

유효한 값

private,public-read,public-read-write,authenticated-read

필수 항목

없음

x-amz-copy-if-modified-since

설명

타임스탬프 이후 수정된 경우에만 복사합니다.

유효한 값

Timestamp

필수 항목

없음

x-amz-copy-if-unmodified-since

설명

타임스탬프 이후 수정되지 않은 경우에만 복사됩니다.

유효한 값

Timestamp

필수 항목

없음

x-amz-copy-if-match

설명

ETag 오브젝트가 ETag와 일치하는 경우에만 복사합니다.

유효한 값

엔터티 태그

필수 항목

없음

x-amz-copy-if-none-match

설명

ETag 오브젝트가 ETag와 일치하는 경우에만 복사합니다.

유효한 값

엔터티 태그

필수 항목

없음

응답 엔티티

CopyObjectResult

설명

응답 요소에 대한 컨테이너입니다.

유형

컨테이너

LastModified

설명

소스 오브젝트의 마지막으로 수정된 날짜입니다.

유형

날짜

etag

설명

새 오브젝트의 ETag입니다.

유형

문자열

요청 헤더

content-md5

설명

메시지의 base64로 인코딩된 MD-5 해시입니다.

유효한 값

문자열입니다. 기본값 또는 제약 조건이 없습니다.

필수 항목

없음

content-type

설명

표준 MIME 유형.

유효한 값

모든 MIME 유형. 기본값: binary/octet-stream

필수 항목

없음

x-amz-meta-<…​>

설명

사용자 메타데이터입니다. 오브젝트와 함께 저장됩니다.

유효한 값

최대 8kb의 문자열입니다. 기본값 없음.

필수 항목

없음

x-amz-acl

설명

A Canned ACL입니다.

유효한 값

private,public-read,public-read-write,authenticated-read

필수 항목

없음

응답 엔티티

InitiatedMultipartUploadsResult

설명

결과에 대한 컨테이너입니다.

유형

컨테이너

bucket

설명

오브젝트 콘텐츠를 수신할 버킷입니다.

유형

문자열

키

설명

키 요청 매개변수로 지정된 키 (있는 경우)입니다.

유형

문자열

UploadId

설명

다중 파트 업로드를 식별하는 upload-id 요청 매개변수로 지정된 ID입니다(있는 경우).

유형

문자열

HTTP 응답

404

상태 코드

NoSuchUpload

설명

지정된 upload-id가 이 오브젝트에서 시작된 업로드와 일치하지 않습니다.

응답 엔티티

InitiatedMultipartUploadsResult

설명

결과에 대한 컨테이너입니다.

유형

컨테이너

bucket

설명

오브젝트 콘텐츠를 수신할 버킷입니다.

유형

문자열

키

설명

키 요청 매개변수로 지정된 키 (있는 경우)입니다.

유형

문자열

UploadId

설명

다중 파트 업로드를 식별하는 upload-id 요청 매개변수로 지정된 ID입니다(있는 경우).

유형

문자열

이니시에이터

설명

업로드를 시작한 사용자의 ID 및 DisplayName 을 포함합니다.

유형

컨테이너

ID

설명

이니시에이터의 ID입니다.

유형

문자열

DisplayName

설명

이니시에이터의 표시 이름입니다.

유형

문자열

소유자

설명

업로드된 오브젝트를 소유한 사용자의 ID 및 DisplayName 에 대한 컨테이너입니다.

유형

컨테이너

StorageClass

설명

결과 오브젝트를 저장하는 데 사용되는 메서드입니다. STANDARD 또는 REDUCED_REDUNDANCY

유형

문자열

PartNumberMarker

설명

IsTruncated 가 true 인 경우 후속 요청에 사용할 부분 마커입니다. 목록의 우선 순위를 지정합니다.

유형

문자열

NextPartNumberMarker

설명

IsTruncated 가 true 인 경우 후속 요청에 사용할 다음 부분 마커입니다. 목록의 끝입니다.

유형

문자열

IsTruncated

설명

true 인 경우 오브젝트의 업로드 콘텐츠의 하위 집합만 반환되었습니다.

유형

부울

part

설명

Key,Part,InitiatorOwner,StorageClass, Initiated 요소의 컨테이너입니다.

유형

컨테이너

Partnumber

설명

Key,Part,InitiatorOwner,StorageClass, Initiated 요소의 컨테이너입니다.

유형

정수

ETag

설명

해당 부분의 엔터티 태그입니다.

유형

문자열

크기

설명

업로드된 부분의 크기입니다.

유형

정수

요청 엔티티

CompleteMultipartUpload

설명

하나 이상의 부분으로 구성된 컨테이너입니다.

유형

컨테이너

필수 항목

제공됨

part

설명

PartNumber 및 ETag 에 대한 컨테이너입니다.

유형

컨테이너

필수 항목

제공됨

Partnumber

설명

부분 식별자입니다.

유형

정수

필수 항목

제공됨

ETag

설명

해당 부분의 엔터티 태그입니다.

유형

문자열

필수 항목

제공됨

응답 엔티티

CompleteMultipartUploadResult

설명

응답을 위한 컨테이너입니다.

유형

컨테이너

위치

설명

새 오브젝트의 리소스 식별자(path)입니다.

유형

URI

bucket

설명

새 오브젝트가 포함된 버킷의 이름입니다.

유형

문자열

키

설명

오브젝트의 키입니다.

유형

문자열

ETag

설명

새 오브젝트의 엔터티 태그입니다.

유형

문자열

요청 헤더

x-amz-copy-source

설명

소스 버킷 이름과 오브젝트 이름입니다.

유효한 값

BUCKET/OBJECT

필수 항목

제공됨

x-amz-copy-source-range

설명

소스 오브젝트에서 복사할 바이트 범위입니다.

유효한 값

범위: bytes=first-last. 첫 번째 및 마지막은 복사할 0 기반 바이트 오프셋입니다. 예를 들어bytes=0-9 는 소스의 처음 10바이트를 복사하려고 함을 나타냅니다.

필수 항목

없음

응답 엔티티

CopyPartResult

설명

모든 응답 요소에 대한 컨테이너입니다.

유형

컨테이너

ETag

설명

새 부분의 ETag를 반환합니다.

유형

문자열

LastModified

설명

부분이 마지막으로 수정된 날짜를 반환합니다.

유형

문자열