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

설명

데이터 범위는 요청에 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.

유형

컨테이너

필수 항목

제공됨

일

설명

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

유형

정수

필수 항목

없음

년

설명

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

유형

정수

필수 항목

없음

HTTP 응답

400

상태 코드

Malformed XML

설명

XML이 제대로 구성되어 있지 않습니다.

409

상태 코드

InvalidBucketState

설명

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

응답 엔터티

ObjectLockConfiguration

설명

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

유형

컨테이너

필수 항목

제공됨

ObjectLockEnabled

설명

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

유형

문자열

필수 항목

제공됨

Rule

설명

지정된 버킷에 대한 오브젝트 잠금 규칙이 있습니다.

유형

컨테이너

필수 항목

없음

DefaultRetention

설명

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

유형

컨테이너

필수 항목

없음

mode

설명

기본 오브젝트 잠금 보존 모드입니다. 유효한 값: GOVERNANCE/COMPLIANCE.

유형

컨테이너

필수 항목

제공됨

일

설명

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

유형

정수

필수 항목

없음

년

설명

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

유형

정수

필수 항목

없음

요청 엔터티

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

설명

사용할 수 있는 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

설명

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

유형

문자열

부여

설명

Grantee 및 Permission 에 대한 컨테이너입니다.

유형

컨테이너

부여자

설명

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

유형

컨테이너

권한

설명

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

유형

문자열

요청 엔터티

AccessControlPolicy

설명

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

유형

컨테이너

AccessControlList

설명

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

유형

컨테이너

소유자

설명

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

유형

컨테이너

ID

설명

버킷 소유자의 ID입니다.

유형

문자열

DisplayName

설명

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

유형

문자열

부여

설명

Grantee 및 Permission 에 대한 컨테이너입니다.

유형

컨테이너

부여자

설명

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

유형

컨테이너

권한

설명

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

유형

문자열

요청 헤더

x-amz-copy-source

설명

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

유효한 값

버킷 /오브젝트

필수 항목

제공됨

x-amz-acl

설명

사용할 수 있는 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

설명

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

유형

컨테이너

Last Cryostat

설명

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

유형

날짜

etag

설명

새 오브젝트의 ETag입니다.

유형

문자열

요청 헤더

content-md5

설명

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

유효한 값

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

필수 항목

없음

content-type

설명

표준 MIME 유형입니다.

유효한 값

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

필수 항목

없음

x-amz-meta-<…​>

설명

사용자 메타데이터. 오브젝트로 저장됩니다.

유효한 값

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

필수 항목

없음

x-amz-acl

설명

사용할 수 있는 ACL입니다.

유효한 값

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

필수 항목

없음

응답 엔터티

InitiatedMultipartUploadsResult

설명

결과를 위한 컨테이너입니다.

유형

컨테이너

bucket

설명

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

유형

문자열

키

설명

키 요청 매개변수(있는 경우)에서 지정하는 키 입니다.

유형

문자열

UploadId

설명

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

유형

문자열

HTTP 응답

404

상태 코드

NoSuchUpload

설명

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

응답 엔터티

InitiatedMultipartUploadsResult

설명

결과를 위한 컨테이너입니다.

유형

컨테이너

bucket

설명

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

유형

문자열

키

설명

키 요청 매개변수(있는 경우)에서 지정하는 키 입니다.

유형

문자열

UploadId

설명

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

유형

문자열

이니시에이터

설명

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

유형

컨테이너

ID

설명

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

유형

문자열

DisplayName

설명

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

유형

문자열

소유자

설명

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

유형

컨테이너

StorageClass

설명

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

유형

문자열

PartNumberMarker

설명

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

유형

문자열

NextPartNumberMarker

설명

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

유형

문자열

IsTruncated

설명

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

유형

부울

부분

설명

키,Part,InitiatorOwner,StorageClass 및 Initiated 요소에 대한 컨테이너입니다.

유형

컨테이너

Partnumber

설명

키,Part,InitiatorOwner,StorageClass 및 Initiated 요소에 대한 컨테이너입니다.

유형

정수

etag

설명

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

유형

문자열

크기

설명

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

유형

정수

요청 엔터티

CompleteMultipartUpload

설명

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

유형

컨테이너

필수 항목

제공됨

부분

설명

PartNumber 및 ETag 용 컨테이너입니다.

유형

컨테이너

필수 항목

제공됨

Partnumber

설명

부분의 식별자입니다.

유형

정수

필수 항목

제공됨

etag

설명

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

유형

문자열

필수 항목

제공됨

응답 엔터티

CompleteMultipartUploadResult

설명

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

유형

컨테이너

위치

설명

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

유형

URI

bucket

설명

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

유형

문자열

키

설명

오브젝트의 키입니다.

유형

문자열

etag

설명

새 오브젝트의 entity 태그입니다.

유형

문자열

요청 헤더

x-amz-copy-source

설명

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

유효한 값

버킷 /오브젝트

필수 항목

제공됨

x-amz-copy-source-range

설명

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

유효한 값

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

필수 항목

없음

응답 엔터티

CopyPartResult

설명

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

유형

컨테이너

etag

설명

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

유형

문자열

Last Cryostat

설명

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

유형

문자열