GetBucket

지정한 버킷의 객체 목록을 조회하려면 IAM wos:GetBucket 권한이 필요합니다.

요청 문법

GET /?prefix=Prefix&marker=Marker&max-keys=Max-Keys&delimiter=Delimiter&start-time=Start-Time&end-time=End-Time
Host: BucketName.Endpoint
Date: Date
Authorization: <Authorization>

요청 파라미터

참고: 파라미터 이름은 대/소문자를 구분합니다. 예를 들어 PREFIX=abc로 설정해도 권한에는 포함되지만 실제로는 동작하지 않습니다.

요청 헤더

common request headers 만 사용하세요.

요청 본문

없음

응답 문법

HTTP/1.1 StatusCode
x-wos-request-id: RequestId
Date: Date
Content-Type: type
Content-Length: length
Server: WS-web-server

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult xmlns="https://www.wangsu.com/document">
  <IsTruncated>boolean</IsTruncated>
  <Marker>string</Marker>
  <NextMarker>string</NextMarker>
  <Contents>
    <ETag>string</ETag>
    <Key>string</Key>
    <LastModified>timestamp</LastModified>
    <ExpirationDate>timestamp</ExpirationDate>
    <Owner>
      <DisplayName>string</DisplayName>
      <ID>string</ID>
    </Owner>
    <Size>integer</Size>
    <StorageClass>string</StorageClass>
  </Contents>
  ...
  <Name>string</Name>
  <Prefix>string</Prefix>
  <Delimiter>string</Delimiter>
  <MaxKeys>integer</MaxKeys>
  <CommonPrefixes>
    <Prefix>string</Prefix>
  </CommonPrefixes>
  ...
  <EncodingType>string</EncodingType>
</ListBucketResult>

응답 헤더

common response headers 만 사용하세요.

응답 본문

응답은 XML 형식으로 반환되며, 사용자의 버킷 내 객체 목록이 포함되어 있습니다. 각 요소의 의미는 다음과 같습니다:

오류 시나리오