S3 Compatible API 사용 방법

S3 Compatible API를 사용하여 오브젝트 스토리지를 사용하는 방법은 아래와 같습니다.

1. S3 Compatible API 사용하기

(1) 지원되는 기능

카페24 클라우드에서 제공하는 오브젝트 스토리지는 Amazon S3 API의 기본 데이터 액세스 모델과 호환되는 RESTful API를 지원합니다.

따라서 지원되는 Amazon S3 기능은 다음과 같습니다.

Feature	Status	Description
List Buckets	Supported
Delete Bucket	Supported
Create Bucket	Supported
Bucket Lifecycle	Supported
Bucket Replication	Partial	Zone 간에만 허용됩니다.
Policy (Buckets, Objects)	Supported
Bucket Website	Supported
Bucket ACLs (Get, Put)	Supported
Bucket Location	Supported
Bucket Notification	Supported
Bucket Object Versions	Supported
Get Bucket Info (HEAD)	Supported
Bucket Request Payment	Supported
Put Object	Supported
Delete Object	Supported
Get Object	Supported
Object ACLs (Get, Put)	Supported
Get Object Info (HEAD)	Supported
POST Object	Supported
Copy Object	Supported
Multipart Uploads	Supported
Object Tagging	Supported
Bucket Tagging	Supported
Storage Class	Supported

(2) 지원되지 않는 헤더

지원되지 않는 헤더 필드는 다음과 같습니다.

Name	Type
Server	Response
x-amz-delete-marker	Response
x-amz-id-2	Response
x-amz-version-id	Response

(3) 접근 방법

버킷에 접근하는 방법은 두 가지가 있습니다.

a. URI에서 버킷을 최상위 디렉터리로 식별

GET /bucketname HTTP/1.1 
Host: kr.cafe24obs.com

b. 가상 버킷 호스트 이름을 통해 버킷을 식별

 GET / HTTP/1.1
 Host: bucketname.kr.cafe24obs.com 

참고사항

가상 버킷 호스트 이름을 통해 버킷을 식별하는 경우, wild card DNS가 필요합니다.

(4) Common Request Headers

Request Header	Description
CONTENT_LENGTH	요청 본문의 길이입니다.
DATE	요청 시간 및 날짜(UTC)입니다.
HOST	호스트 서버의 이름입니다.
AUTHORIZATION	인증 토큰입니다.

(5) Common Response Status

HTTP Status	Response Code
100	Continue
200	Success
201	Created
202	Accepted
204	NoContent
206	Partial content
304	NotModified
400	InvalidArgument
400	InvalidDigest
400	BadDigest
400	InvalidBucketName
400	InvalidObjectName
400	UnresolvableGrantByEmailAddress
400	InvalidPart
400	InvalidPartOrder
400	RequestTimeout
400	EntityTooLarge
403	AccessDenied
403	UserSuspended
403	RequestTimeTooSkewed
404	NoSuchKey
404	NoSuchBucket
404	NoSuchUpload
405	MethodNotAllowed
408	RequestTimeout
409	BucketAlreadyExists
409	BucketNotEmpty
411	MissingContentLength
412	PreconditionFailed
416	InvalidRange
422	UnprocessableEntity
500	InternalError

(6) 인증 방법

오브젝트 스토리지에 대한 요청은 인증되거나 인증되지 않을 수 있으며, 인증되지 않은 요청은 익명의 사용자에 의해 전송된다고 가정합니다.

요청을 인증하려면 아래와 같이 요청에 ACCESS KEY와 HMAC(해시 기반 메시지 인증 코드)를 포함해야 합니다.

HTTP/1.1
PUT /buckets/bucket/object.mpeg
Host: kr.cafe24obs.com
Date: Tue, 6 Dec 2022 15:39:01 +0000
Content-Encoding: mpeg
Content-Length: 9999999

Authorization: AWS {access-key}:{hash-of-header-and-secret}

HMAC을 생성하는 방법은 다음과 같습니다.

a. 헤더 문자열의 값 가져오기

• 요청 헤더 문자열을 표준 형식으로 정규화합니다.

• SHA-1 해싱 알고리즘을 사용하여 HMAC를 생성합니다. 자세한 내용은 RFC 2104 및 HMAC를 참고해 주세요.

• HMAC 결과를 base-64로 인코딩합니다.

b. 헤더를 canonical form으로 정규화하기

• x-amz-로 시작하는 모든 필드를 가져옵니다.

• 필드가 모두 소문자인지 확인합니다.

• 필드를 사전 순으로 정렬합니다.

• 동일한 필드 이름의 여러 인스턴스를 단일 필드로 결합하고 필드 값을 쉼표로 구분합니다.

• 필드 값의 공백과 줄 바꿈을 단일 공백으로 바꿉니다.

• 콜론 전후의 공백을 제거합니다.

• 각 필드 뒤에 새 줄을 추가합니다.

• 필드를 헤더에 다시 병합합니다.

c. base-64로 인코딩된 HMAC 문자열로 바꾸기

2. Access Control List

오브젝트 스토리지는 ACL(Access Control List) 기능을 지원합니다.

ACL은 사용자가 버킷 또는 객체에서 수행할 수 있는 작업을 지정하는 액세스 권한 부여 목록입니다.

각 권한은 아래와 같이 버킷에 적용될 때와 객체에 적용될 때 다른 의미를 갖습니다.

Permission	Bucket	Object
READ	버킷의 객체를 나열할 수 있습니다	객체를 읽을 수 있습니다.
WRITE	버킷의 객체를 쓰거나 삭제할 수 있습니다.	N/A
READ_ACP	버킷 ACL을 읽을 수 있습니다.	객체 ACL을 읽을 수 있습니다.
WRITE_ACP	버킷 ACL을 작성할 수 있습니다.	객체 ACL에 쓸 수 있습니다.
FULL_CONTROL	버킷의 객체에 대한 전체 권한을 갖습니다.	객체 ACL을 읽거나 쓸 수 있습니다.

3. Bucket Operation

(1) List Buckets

생성한 버킷 목록을 반환합니다.

인증된 사용자가 생성한 버킷만 반환하므로 익명 요청을 할 수 없습니다.

a. Syntax

GET / HTTP/1.1
Host: kr.cafe24obs.com

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Response Entities

Name	Type	Description
Buckets	Container	버킷 목록의 컨테이너입니다.
Bucket	Container	버킷 정보의 컨테이너입니다.
Name	String	버킷 이름입니다.
CreationDate	Date	버킷이 생성된 UTC 시간입니다.
ListAllMyBucketsResult	Container	결과 컨테이너입니다.
Owner	Container	버킷 소유자의 ID 및 DisplayName에 대한 컨테이너입니다.
ID	String	버킷 소유자의 ID입니다.
DisplayName	String	버킷 소유자의 표시 이름입니다.

(2) PUT Bucket

새 버킷을 생성합니다.

버킷을 생성하려면 요청을 인증하기 위한 액세스 키가 있어야 하므로, 익명 사용자로는 버킷을 생성할 수 없습니다.

a. Constraints

일반적으로 버킷 이름은 도메인 이름 제약 조건을 따라야 합니다.

- 버킷 이름은 고유해야 합니다.
- 버킷 이름은 소문자로 시작하고 끝나야 합니다.
- 버킷 이름에는 대시(-)가 포함될 수 있습니다.

b. Syntax

PUT /{bucket} HTTP/1.1
Host: kr.cafe24obs.com
x-amz-acl: public-read-write

Authorization: AWS {access-key}:{hash-of-header-and-secret}

c. Parameters

Name	Description	Valid Values	Required
x-amz-acl	미리 제공된 ACL입니다.	private, public-read, public-read-write, authenticated-read	No

d. HTTP Response

- 버킷 이름이 고유하고 제약 조건 내에서 사용되지 않는 경우 작업이 성공합니다.
- 동일한 이름의 버킷이 이미 존재하고 사용자가 버킷 소유자인 경우 작업이 성공합니다.
- 버킷 이름이 이미 사용 중인 경우 작업이 실패합니다.

HTTP Status	Status Code	Description
409	BucketAlreadyExists	버킷이 이미 다른 사용자의 소유권에 있습니다.

(3) DELETE Bucket

버킷을 삭제합니다.

성공적인 버킷 제거 후, 버킷 이름을 재사용할 수 있습니다.

a. Syntax

DELETE /{bucket} HTTP/1.1
Host: kr.cafe24obs.com

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. HTTP Response

HTTP Status	Status Code	Description
204	No Content	버킷을 삭제합니다.

(4) GET Bucket

버킷 개체 목록을 반환합니다.

a. Syntax

GET /{bucket}?max-keys=25 HTTP/1.1
Host: kr.cafe24obs.com

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Parameters

Name	Type	Description
prefix	String	지정된 접두사가 포함된 객체만 반환합니다.
delimiter	String	접두사와 객체 이름의 나머지 부분 사이의 구분 기호입니다.
marker	String	반환된 객체 목록의 시작 인덱스입니다.
max-keys	Integer	반환할 최대 키 수입니다. 기본값은 1000입니다.

c. HTTP Response

HTTP Status	Status Code	Description
200	OK	버킷을 검색합니다.

d. Bucket Response Entities

GET /{bucket}은 다음 필드가 버킷의 컨테이너를 반환합니다.

Name	Type	Description
ListBucketResult	Entity	객체 목록의 컨테이너입니다.
Name	String	컨텐츠가 반환되는 버킷의 이름입니다.
Prefix	String	객체 키의 접두사입니다.
Marker	String	반환된 객체 목록의 시작 인덱스입니다.
MaxKeys	Integer	반환되는 최대 키 수입니다.
Delimiter	String	설정된 경우 동일한 접두사를 가진 객체가 CommonPrefixes 목록에 나타납니다.
IsTruncated	Boolean	true인 경우 버킷 콘텐츠의 하위 집합만 반환됩니다.
CommonPrefixes	Container	여러 개체에 동일한 접두사가 포함된 경우 이 목록에 나타납니다.

e. Object Response Entities

ListBucketResult에는 객체가 포함되어 있으며, 각 객체는 Contents 컨테이너 내에 있습니다.

Name	Type	Description
Contents	Object	객체의 컨테이너입니다.
Key	String	객체의 키입니다.
LastModified	Date	객체의 마지막 수정 날짜/시간입니다.
ETag	String	객체의 MD-5 해시(엔티티 태그)입니다.
Size	Integer	객체의 크기입니다.
StorageClass	String	항상 STANDARD를 반환해야 합니다.

(5) Get Bucket ACL

버킷의 액세스 제어 목록을 검색합니다.

사용자는 버킷 소유자이거나 버킷에 대한 READ_ACP 권한을 부여받아야 합니다.

a. Syntax

GET /{bucket}?acl HTTP/1.1
Host: kr.cafe24obs.com

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Response Entities

Name	Type	Description
AccessControlPolicy	Container	응답에 대한 컨테이너입니다.
AccessControlList	Container	ACL 정보의 컨테이너입니다.
Owner	Container	버킷 소유자의 ID 및 DisplayName에 대한 컨테이너입니다.
ID	String	버킷 소유자의 ID입니다.
DisplayName	String	버킷 소유자의 표시 이름입니다.
Grant	Container	Grantee 및 Permission을 위한 컨테이너입니다.
Grantee	Container	권한 있는 사용자의 DisplayName 및 ID에 대한 컨테이너입니다.
Permission	String	Grantee 버킷에 부여된 권한입니다.

(6) PUT Bucket ACL

기존 버킷에 대한 액세스 제어 목록을 설정합니다.

사용자는 버킷 소유자이거나 버킷에 대한 WRITE_ACP 권한이 부여되어야 합니다.

a. Syntax

PUT /{bucket}?acl HTTP/1.1
Host: kr.cafe24obs.com

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Request Entities

Name	Type	Description
AccessControlPolicy	Container	요청에 대한 컨테이너입니다.
AccessControlList	Container	ACL 정보의 컨테이너입니다.
Owner	Container	버킷 소유자의 ID 및 DisplayName에 대한 컨테이너입니다.
ID	String	버킷 소유자의 ID입니다.
DisplayName	String	버킷 소유자의 표시 이름입니다.
Grant	Container	Grantee 및 Permission을 위한 컨테이너입니다.
Grantee	Container	권한 부여를 받는 사용자의 DisplayName 및 ID에 대한 컨테이너입니다.
Permission	String	Grantee 버킷에 부여된 권한입니다.

(7) List Bucket Multipart Uploads

GET /?uploads는 현재 진행 중인 멀티파트 업로드 목록을 반환합니다.

즉, 애플리케이션이 멀티파트 업로드를 시작했지만, 아직 모든 업로드를 완료하지 않았습니다.

a. Syntax

GET /{bucket}?uploads HTTP/1.1
Host: kr.cafe24obs.com

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Parameters

GET /{bucket}?uploads에 대한 매개변수를 지정할 수 있지만 필수는 아닙니다.

Name	Type	Description
prefix	String	키에 지정된 접두사가 포함된 진행 중인 업로드를 반환합니다.
delimiter	String	접두사와 개체 이름의 나머지 부분 사이의 구분 기호입니다.
key-marker	String	업로드 목록의 시작 마커입니다.
max-keys	Integer	진행 중인 업로드의 최대 수입니다. 기본값은 1000입니다.
max-uploads	Integer	멀티파트 업로드의 최대 수입니다. 범위는 1-1000이며, 기본값은 1000입니다.
upload-id-marker	String	키 마커가 지정되지 않은 경우 무시됩니다. ID 또는 그 뒤에 사전 순으로 나열할 첫 번째 업로드 ID를 지정합니다.

c. Response Entities

Name	Type	Description
ListMultipartUploadsResult	Container	결과 컨테이너입니다.
ListMultipartUploadsResult.Prefix	String	접두사 요청 매개변수로 지정된 접두사입니다.
Bucket	String	버킷 콘텐츠를 수신하는 버킷입니다.
KeyMarker	String	key-marker 요청 매개변수로 지정된 키 마커입니다.
UploadIdMarker	String	upload-id-marker 요청 매개변수로 지정된 마커입니다.
NextKeyMarker	String	IsTruncated가 true인 경우 후속 요청에서 사용할 키 마커입니다.
NextUploadIdMarker	String	IsTruncated가 true인 경우 후속 요청에서 사용할 업로드 ID 마커입니다.
MaxUploads	Integer	max-uploads 요청 매개변수로 지정된 최대 업로드 수입니다.
Delimiter	String	설정된 경우 동일한 접두사를 가진 개체가 CommonPrefixes 목록에 나타납니다.
IsTruncated	Boolean	true인 경우 버킷 업로드 콘텐츠의 하위 집합만 반환됩니다.
Upload	Container	Key, UploadId, InitiatorOwner, StorageClass 및 Initiated 요소의 컨테이너입니다.
Key	String	멀티파트 업로드가 완료되면 객체의 키가 됩니다.
UploadId	String	멀티파트 업로드를 식별하는 ID입니다.
Initiator	Container	업로드를 시작한 사용자의 ID와 DisplayName을 포함합니다.
DisplayName	String	게시자의 Display name입니다.
ID	String	게시자의 ID입니다.
Owner	Container	업로드된 객체를 소유한 사용자의 ID 및 DisplayName에 대한 컨테이너입니다.
StorageClass	String	결과 객체를 저장하는 데 사용되는 메서드로, 표준 또는 REDUCED_REDUNDANCY 입니다.
Initiated	Date	사용자가 업로드를 시작한 날짜와 시간입니다.
CommonPrefixes	Container	여러 객체에 동일한 접두사가 포함된 경우 이 목록에 나타납니다.
CommonPrefixes.Prefix	String	접두사 요청 매개변수로 정의된 접두사 뒤의 키 하위 문자열입니다.

4. Object Operation

(1) Put Object

버킷에 객체를 추가합니다.

이 작업을 수행하려면 버킷에 대한 쓰기 권한이 있어야 합니다.

a. Syntax

PUT /{bucket}/{object} HTTP/1.1
Host: kr.cafe24obs.com 

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Request Headers

Name	Description	Valid Values	Required
content-md5	메시지의 base64로 인코딩된 MD-5 해시입니다.	문자열 (기본값 아님. 제약 조건 없음.)	No
content-type	표준 MIME 유형입니다.	모든 MIME 유형 (기본값: binary/octet-stream)	No
x-amz-meta-<...>	사용자 메타데이터로, 개체와 함께 저장됩니다.	최대 8KB의 문자열 (기본값 아님.)	No
x-amz-acl	이미 사용할 수 있도록 만들어져 있는 ACL입니다.	private, public-read, public-read-write, authenticated-read	No

(2) Copy Object

객체를 복사하기 위해 PUT을 사용하고, 대상 버킷과 객체 이름을 지정합니다.

a. Syntax

PUT /{dest-bucket}/{dest-object} HTTP/1.1
x-amz-copy-source: {source-bucket}/{source-object}
Host: kr.cafe24obs.com
    
Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Request Headers

Name	Description	Valid Values	Required
x-amz-copy-source	소스 버킷 이름과 객체 이름입니다.	{bucket}/{obj}	Yes
x-amz-acl	이미 사용할 수 있도록 만들어져 있는 ACL입니다.	private, public-read, public-read-write, authenticated-read	No
x-amz-copy-if-modified-since	타임스탬프 이후 수정된 경우에만 복사합니다.	Timestamp	No
x-amz-copy-if-unmodified-since	타임스탬프 이후 수정되지 않은 경우에만 복사합니다.	Timestamp	No
x-amz-copy-if-match	객체 ETag가 ETag와 일치하는 경우에만 복사합니다.	Entity Tag	No
x-amz-copy-if-none-match	객체 ETag가 일치하지 않는 경우에만 복사합니다.	Entity Tag	No

c. Response Entities

Name	Type	Description
CopyObjectResult	Container	응답 요소의 컨테이너입니다.
LastModified	Date	원본 객체의 마지막 수정 날짜입니다.
Etag	String	새 객체의 ETag입니다.

(3) Remove Object

개체를 제거합니다.

포함하는 버킷에 설정된 WRITE 권한이 필요합니다.

a. Syntax

DELETE /{bucket}/{object} HTTP/1.1
Host: kr.cafe24obs.com 

Authorization: AWS {access-key}:{hash-of-header-and-secret}

(4) Get Object

버킷에서 객체를 검색합니다.

a. Syntax

GET /{bucket}/{object} HTTP/1.1
Host: kr.cafe24obs.com     

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Request Headers

Name	Description	Valid Values	Required
range	검색할 개체의 범위입니다.	Range: bytes=beginbyte-endbyte	No
if-modified-since	타임스탬프 이후 수정된 경우에만 가져옵니다.	Timestamp	No
if-unmodified-since	타임스탬프 이후 수정되지 않은 경우에만 가져옵니다.	Timestamp	No
if-match	객체 ETag가 ETag와 일치하는 경우에만 가져옵니다.	Entity Tag	No
if-none-match	객체 ETag가 ETag와 일치하는 경우에만 가져옵니다.	Entity Tag	No

c. Response Headers

Name	Description
Content-Range	데이터 범위로, 범위 헤더 필드가 요청에 지정된 경우에만 반환됩니다.

(5) Get Object Info

객체에 대한 정보를 반환합니다.

이 요청은 Get Object 요청과 동일한 헤더 정보를 반환하지만, 객체 데이터 페이로드가 아닌 메타데이터만 포함합니다.

a. Syntax

HEAD /{bucket}/{object} HTTP/1.1
Host: kr.cafe24obs.com     

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Request Headers

Name	Description	Valid Values	Required
range	검색할 개체의 범위입니다.	Range: bytes=beginbyte-endbyte	No
if-modified-since	타임스탬프 이후 수정된 경우에만 가져옵니다.	Timestamp	No
if-unmodified-since	타임스탬프 이후 수정되지 않은 경우에만 가져옵니다.	Timestamp	No
if-match	객체 ETag가 ETag와 일치하는 경우에만 가져옵니다.	Entity Tag	No
if-none-match	객체 ETag가 ETag와 일치하는 경우에만 가져옵니다.	Entity Tag	No

(6) Get Object ACL

객체에 대한 ACL 검색합니다.

a. Syntax

GET /{bucket}/{object}?acl HTTP/1.1
Host: kr.cafe24obs.com     

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Response Entities

Name	Type	Description
AccessControlPolicy	Container	응답 컨테이너입니다.
AccessControlList	Container	ACL 정보의 컨테이너입니다.
Owner	Container	객체 소유자의 ID 및 DisplayName에 대한 컨테이너입니다.
ID	String	객체 소유자의 ID입니다.
DisplayName	String	객체 소유자의 표시 이름입니다.
Grant	Container	Grantee 및 Permission을 위한 컨테이너입니다.
Grantee	Container	권한 있는 사용자의 DisplayName 및 ID에 대한 컨테이너입니다.
Permission	String	Grantee 객체에 부여된 권한입니다.

(7) Set Object ACL

기존 객체에 대한 ACL을 설정합니다.

a. Syntax

PUT /{bucket}/{object}?acl
Host: kr.cafe24obs.com     

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Response Entities

Name	Type	Description
AccessControlPolicy	Container	응답 컨테이너입니다.
AccessControlList	Container	ACL 정보의 컨테이너입니다.
Owner	Container	객체 소유자의 ID 및 DisplayName에 대한 컨테이너입니다.
ID	String	객체 소유자의 ID입니다.
DisplayName	String	객체 소유자의 표시 이름입니다.
Grant	Container	Grantee 및 Permission을 위한 컨테이너입니다.
Grantee	Container	권한 있는 사용자의 DisplayName 및 ID에 대한 컨테이너입니다.
Permission	String	Grantee 객체에 부여된 권한입니다.

(8) Initiate Multipart Upload

멀티파트 업로드 프로세스를 시작합니다.

a. Syntax

POST /{bucket}/{object}?uploads
Host: kr.cafe24obs.com     

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Request Headers

Name	Description	Valid Values	Required
content-md5	메시지의 base64로 인코딩된 MD-5 해시입니다.	문자열 (기본값 아님. 제약 조건 없음.)	No
content-type	표준 MIME 유형입니다.	모든 MIME 유형 (기본값: binary/octet-stream)	No
x-amz-meta-<...>	사용자 메타데이터로, 개체와 함께 저장됩니다.	최대 8KB의 문자열 (기본값 아님.)	No
x-amz-acl	이미 사용할 수 있도록 만들어져 있는 ACL입니다.	private, public-read, public-read-write, authenticated-read	No

c. Response Entities

Name	Type	Description
InitiatedMultipartUploadsResult	Container	결과 컨테이너입니다.
Bucket	String	객체 컨텐츠를 수신하는 버킷입니다.
Key	String	키 요청 매개변수에서 지정한 키입니다.
UploadId	String	멀티파트 업로드를 식별하는 upload-id 요청 매개 변수로 지정된 ID입니다.

(9) Multipart Upload

멀티파트 업로드를 사용하여 객체를 업로드합니다.

a. Syntax

PUT /{bucket}/{object}?partNumber=&uploadId= HTTP/1.1
Host: kr.cafe24obs.com     
                                                    
Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. HTTP Response

HTTP Status	Status Code	Description
404	NoSuchUpload	지정된 업로드 ID가 이 객체에서 시작된 업로드와 일치하지 않습니다.

(10) List Multipart Upload

특정 멀티파트 업로드를 위해 업로드된 파트를 나열합니다.

a. Syntax

GET /{bucket}/{object}?uploadId=123 HTTP/1.1
Host: kr.cafe24obs.com     

Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Response Entities

Name	Type	Description
InitiatedMultipartUploadsResult	Container	결과 컨테이너입니다.
Bucket	String	객체 컨텐츠를 수신하는 버킷입니다.
Key	String	키 요청 매개변수에서 지정한 키입니다.
UploadId	String	멀티파트 업로드를 식별하는 upload-id 요청 매개 변수로 지정된 ID입니다.
Initiator	Container	업로드를 시작한 사용자의 ID와 DisplayName을 포함합니다.
ID	String	게시자의 ID입니다.
DisplayName	String	게시자의 표시 이름입니다.
Owner	Container	업로드된 개체를 소유한 사용자의 ID 및 DisplayName에 대한 컨테이너입니다.
StorageClass	String	결과 객체를 저장하는 데 사용되는 메서드로,STANDARD 또는 REDUCED_REDUNDANCY 입니다.
PartNumberMarker	String	IsTruncated가 true인 경우 후속 요청에서 사용할 파트 마커입니다. 목록에 선행합니다.
NextPartNumberMarker	String	IsTruncated가 true인 경우 후속 요청에서 사용할 다음 파트 마커입니다. 목록의 끝입니다.
MaxParts	Integer	max-parts 요청 매개변수에 지정된 대로 응답에 허용되는 최대 파트입니다.
IsTruncated	Boolean	true인 경우 객체 업로드 컨텐츠의 하위 집합만 반환됩니다.
Part	Container	Key, Part, InitiatorOwner, StorageClass 및 Initiated 요소의 컨테이너입니다.
PartNumber	Integer	파트의 식별 번호입니다.
ETag	String	파트의 엔터티 태그입니다.
Size	Integer	업로드된 파트의 크기입니다.

(11) Complete Multipart Upload

업로드된 부분을 조합하고, 새 개체를 생성하여 멀티파트 업로드를 완료합니다.

a. Syntax

POST /{bucket}/{object}?uploadId= HTTP/1.1
Host: kr.cafe24obs.com     
                                                    
Authorization: AWS {access-key}:{hash-of-header-and-secret}

b. Request Entities

Name	Type	Description	Required
CompleteMultipartUpload	Container	하나 이상의 파트로 구성된 컨테이너입니다.	Yes
Part	Container	PartNumber 및 ETag에 대한 컨테이너입니다.	Yes
PartNumber	Integer	파트의 식별자입니다.	Yes
ETag	String	파트의 엔터티 태그입니다.	Yes

c. Response Entities

Name	Type	Description
CompleteMultipartUploadResult	Container	응답 컨테이너입니다.
Location	URI	새 객체의 리소스 식별자(경로)입니다.
Bucket	String	새 객체가 포함된 버킷의 이름입니다.
Key	String	객체의 키입니다.
ETag	String	새 객체의 엔터티 태그입니다.

(12) Abort Multipart Upload

멀티파트 업로드를 중단합니다.

a. Syntax

DELETE /{bucket}/{object}?uploadId= HTTP/1.1
Host: kr.cafe24obs.com     

Authorization: AWS {access-key}:{hash-of-header-and-secret}