ListParts
최신 업데이트：2025-08-18 15:54:07
사용자는 이 인터페이스를 호출하여 멀티파트 업로드 작업의 파트 목록을 조회할 수 있습니다.
한 번의 응답에서 최대 1000개의 파트를 조회할 수 있으며, 파라미터
max-parts로 이 수치를 지정할 수 있습니다(기본값 1000). 만약 멀티파트 업로드 작업에 1000개가 넘는 파트가 있는 경우, 응답에IsTruncated와NextPartNumberMarker가 반환됩니다(IsTruncated값이 True임). 이후 파트 목록의 나머지 부분을 조회하려면, 다음 ListParts 요청에서 파라미터part-number-marker값을NextPartNumberMarker값으로 설정하여 요청하면 됩니다.
요청 문법
GET /ObjectName?uploadId=uploadid&max-parts=max&part-number-marker=marker HTTP/1
Host: Bucket.Endpoint
Date: date
Authorization: authorization
URI 요청 파라미터
| 이름 | 설명 | 필수 여부 |
|---|---|---|
| uploadId | 업로드 작업을 식별하는 upload ID타입: String기본값: 없음 | 예 |
| max-parts | 한 번의 요청에서 조회할 수 있는 최대 파트 수타입: String기본값: 1000 | 아니오 |
| part-number-marker | 리스트 시작 위치를 지정. 이 값보다 파트 번호가 큰 파트만 조회됩니다. 타입: String 예시: 250으로 설정하면 251번부터 반환 |
아니오 |
요청 헤더
Common request headers 를 사용하세요.
요청 본문
없음
응답 문법
HTTP/1.1 status_code
x-wos-request-id: request id
Date: date
Content-Length: length
Connection: state
Server:WS-web-server
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns=" https://www.wangsu.com/document">
<Bucket>BucketName</Bucket>
<Key>object</Key>
<UploadId>uploadid</UploadId>
<Initiator>
<ID>initiatorid</ID>
<DisplayName>displayname</DisplayName>
</Initiator>
<Owner>
<ID>ownerid</ID>
<DisplayName>ownername</DisplayName>
</Owner>
<PartNumberMarker>partNmebermarker</PartNumberMarker>
<NextPartNumberMarker>nextpartnumbermarker</NextPartNumberMarker>
<MaxParts>2</MaxParts>
<IsTruncated>true</IsTruncated>
<Part>
<PartNumber>partnumber1</PartNumber>
<LastModified>modifieddate</LastModified>
<ETag>etag</ETag>
<Size>size</Size>
</Part>
<Part>
<PartNumber>partnumber2</PartNumber>
<LastModified>modifieddate</LastModified>
<ETag>etag</ETag>
<Size>size</Size>
</Part>
...
</ListPartsResult>
응답 헤더
Common response headers 를 사용하세요.
응답 본문
| 이름 | 설명 |
|---|---|
| ListPartsResult | List Part 요청 결과의 컨테이너 타입: XML namespace 자식 노드: Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part 부모: 없음 |
| Bucket | 버킷 이름 타입: String 부모 노드: ListPartsResult |
| Key | 오브젝트 이름 타입: String 부모 노드: ListPartsResult |
| UploadId | 업로드 작업의 ID 타입: String 부모 노드: ListPartsResult |
| Initiator | 업로드 작업의 생성자 정보 타입: XML namespace 자식 노드: ID, DisplayName 부모 노드: ListPartsResult |
| ID | 생성자의 DomainID 타입: String 부모 노드: Initiator, Owner |
| DisplayName | 생성자의 이름 타입: String 부모 노드: Initiator, Owner |
| PartNumberMarker | 이번 요청의 리스트 시작 위치 타입: Integer 부모 노드: ListPartsResult |
| NextPartNumberMarker | 전체 파트가 반환되지 않을 때 응답에 포함되며, 다음 요청의 리스트 시작 위치를 나타냅니다. 타입: Integer 부모 노드: ListPartsResult |
| MaxParts | 한 번의 요청에서 조회한 최대 파트 수, 범위 [1, 1000] 타입: Integer 부모 노드: ListPartsResult |
| IsTruncated | 파트 목록이 잘렸는지 여부 "true"이면 일부만 반환됨, "false"이면 전체 반환됨 타입: Boolean 부모: ListPartsResult |
| Part | 파트 정보 컨테이너 타입: XML namespace 자식 노드: PartNumber, LastModified, ETag, Size 부모: ListPartsResult |
| PartNumber | 업로드된 파트 번호 타입: Integer 부모 노드: ListPartsResult |
| LastModified | 해당 파트가 업로드된 시각 타입: Date 부모 노드: ListPartsResult |
| ETag | 업로드된 파트의 ETag 값 타입: String 부모 노드: ListPartsResult |
| Size | 업로드된 파트의 크기 타입: Integer 부모 노드: ListPartsResult |
특수 에러
| 상황 | HTTP 상태 | 에러 코드 | 메시지 |
|---|---|---|---|
| 지정한 uploadId가 존재하지 않음. upload ID가 잘못됐거나, 해당 멀티파트 업로드가 이미 완료/중단된 경우 | 404 Not Found | NoSuchUpload | The specified upload does not exist. The upload ID may be invalid, or the upload may have been aborted or completed. |
| 지정한 uploadId가 해당 오브젝트와 일치하지 않음 | 404 Not Found | NoSuchUpload | The specified upload does not exist. The upload ID may be invalid, or the upload may have been aborted or completed. |
| max-parts 값이 음수이거나 1000보다 큼 | 400 Bad Request | InvalidArgument | Argument maxParts must be an integer between 0 and 1000. |
| max-parts 값이 정수가 아님 | 400 Bad Request | InvalidArgument | Provided maxParts is not an integer or is out of the integer range. |
| part-number-marker 값이 정수가 아님 | 400 Bad Request | InvalidArgument | Provided part-number-marker is not an integer. |
예시
GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&max-parts=2&part-number-marker=1 HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: WOS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=
HTTP/1.1 200 OK
x-wos-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 985
Connection: keep-alive
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns=" https://www.wangsu.com/document">
<Bucket>example-bucket</Bucket>
<Key>example-object</Key>
<UploadId>XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA</UploadId>
<Initiator>
<ID> 11116a31-17b5-4fb7-9df5-b288870f11xx</ID>
<DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</DisplayName>
</Initiator>
<PartNumberMarker>1</PartNumberMarker>
<NextPartNumberMarker>3</NextPartNumberMarker>
<MaxParts>2</MaxParts>
<IsTruncated>true</IsTruncated>
<Part>
<PartNumber>1</PartNumber>
<LastModified>2020-11-10T20:48:000Z</LastModified>
<ETag>"5678aef83f66abc1fa1e8477fsfsda6d394"</ETag>
<Size>10485760</Size>
</Part>
<Part>
<PartNumber>2</PartNumber>
<LastModified>2020-11-10T20:49:000Z</LastModified>
<ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>
<Size>10485760</Size>
</Part>
<Part>
<PartNumber>3</PartNumber>
<LastModified>2020-11-10T20:50:000Z</LastModified>
<ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>
<Size>10485760</Size>
</Part>
</ListPartsResult>
이 문서의 내용이 도움이 되었습니까?
예
아니오