tencent cloud

Cloud Object Storage

동향 및 공지
릴리스 노트
제품 공지
제품 소개
제품 개요
기능 개요
적용 시나리오
제품 장점
기본 개념
리전 및 액세스 도메인
규격 및 제한
제품 요금
과금 개요
과금 방식
과금 항목
프리 티어
과금 예시
청구서 보기 및 다운로드
연체 안내
FAQ
빠른 시작
콘솔 시작하기
COSBrowser 시작하기
사용자 가이드
요청 생성
버킷
객체
데이터 관리
일괄 프로세스
글로벌 가속
모니터링 및 알람
운영 센터
데이터 처리
스마트 툴 박스 사용 가이드
데이터 워크플로
애플리케이션 통합
툴 가이드
툴 개요
환경 설치 및 설정
COSBrowser 툴
COSCLI 툴
COSCMD 툴
COS Migration 툴
FTP Server 툴
Hadoop 툴
COSDistCp 툴
HDFS TO COS 툴
온라인 도구 (Onrain Dogu)
자가 진단 도구
실습 튜토리얼
개요
액세스 제어 및 권한 관리
성능 최적화
AWS S3 SDK를 사용하여 COS에 액세스하기
데이터 재해 복구 백업
도메인 관리 사례
이미지 처리 사례
COS 오디오/비디오 플레이어 사례
데이터 다이렉트 업로드
데이터 보안
데이터 검증
빅 데이터 사례
COS 비용 최적화 솔루션
3rd party 애플리케이션에서 COS 사용
마이그레이션 가이드
로컬 데이터 COS로 마이그레이션
타사 클라우드 스토리지 데이터를 COS로 마이그레이션
URL이 소스 주소인 데이터를 COS로 마이그레이션
COS 간 데이터 마이그레이션
Hadoop 파일 시스템과 COS 간 데이터 마이그레이션
데이터 레이크 스토리지
클라우드 네이티브 데이터 레이크
메타데이터 가속
데이터 레이크 가속기 GooseFS
데이터 처리
데이터 처리 개요
이미지 처리
미디어 처리
콘텐츠 조정
파일 처리
문서 미리보기
장애 처리
RequestId 가져오기
공용 네트워크로 COS에 파일 업로드 시 속도가 느린 문제
COS 액세스 시 403 에러 코드 반환
리소스 액세스 오류
POST Object 자주 발생하는 오류
보안 및 컴플라이언스
데이터 재해 복구
데이터 보안
액세스 관리
자주 묻는 질문
인기 질문
일반 문제
과금
도메인 규정 준수 문제
버킷 설정 문제
도메인 및 CDN 문제
파일 작업 문제
로그 모니터링 문제
권한 관리
데이터 처리 문제
데이터 보안 문제
사전 서명 URL 관련 문제
SDK FAQ
툴 관련 문제
API 관련 문제
Agreements
Service Level Agreement
개인 정보 보호 정책
데이터 처리 및 보안 계약
연락처
용어집
문서Cloud Object Storage

GET Bucket (List Objects)

포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-12-09 11:36:01

Overview

This API is equivalent to the List Objects API and can be used to list some or all objects in a bucket. To call this API, you need to have permission to read the bucket.
Note:
If you upload an object to the bucket and call the GET Bucket API immediately, due to the eventual consistency characteristic of this API, the response may not include the newly uploaded object.


Requests

Request example

GET / HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Note:
In Host: <BucketName-APPID>.cos.<Region>.myqcloud.com, <BucketName-APPID> is the bucket name followed by the APPID, such as examplebucket-1250000000 (see Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions), and <Region> is a COS region (see Regions and Access Endpoints).
Authorization: Auth String (See Request Signature for details.)

Request fields

Field
Description
Type
Required
prefix
Key prefix to query objects by
String
No
delimiter
Character delimiter used to group object keys. Keys that contain identical paths between the prefix (or, if no prefix is specified, the beginning of the string) and the first delimiter are grouped and defined as a Prefix node under CommonPrefixes. The grouped object keys will no longer appear in the subsequent object list. For specific scenarios and usage, see the samples below.
String
No
encoding-type
Encoding type of the returned value. Valid value: url, meaning that the returned object keys are URL-encoded (percent-encoded) values. For example, "Tencent Cloud" will be encoded to %E8%85%BE%E8%AE%AF%E4%BA%91.
String
No
marker
Marker for the starting object key. Object key entries will be returned in UTF-8 lexicographical order, starting from the first object key after the marker.
string
No
max-keys
The maximum number (up to 1,000) of keys returned in the response. Defaults to 1000.
Note: This parameter limits the maximum number of keys (the sum of CommonPrefixes and Contents) COS can return in each List Objects response. If not all objects are listed in a single response, COS will return the NextMarker node, the value of which can be used to specify marker so that the remaining objects can be listed in your next request.
integer
No

Request headers

This API only uses Common Request Headers.

Request body

This API does not have a request body.

Response

Response headers

In addition to common response headers, this API also returns the following response headers. For more information about common response headers, please see Common Response Headers.
Header
Description
Type
x-cos-bucket-region
Bucket region, such as ap-beijing, ap-hongkong, and eu-frankfurt. For the enumerated values, please see Regions and Access Endpoints.
Enum

Response body

A successful query returns application/xml data, which contains information about objects in the bucket. For the response bodies of different scenarios, see the examples below.
<?xml version='1.0' encoding='utf-8' ?>
<ListBucketResult>
            <Name>string</Name>
            <EncodingType>string</EncodingType>
            <Prefix>string</Prefix>
            <Marker>string</Marker>
            <MaxKeys>integer</MaxKeys>
            <Delimiter>string</Delimiter>
            <IsTruncated>boolean</IsTruncated>
            <NextMarker>string</NextMarker>
            <CommonPrefixes>
                <Prefix>string</Prefix>
            </CommonPrefixes>
            <CommonPrefixes>
                <Prefix>string</Prefix>
            </CommonPrefixes>
            <Contents>
                <Key>string</Key>
                <LastModified>date</LastModified>
                <ETag>string</ETag>
                <Size>integer</Size>
                <Owner>
                    <ID>string</ID>
                    <DisplayName>string</DisplayName>
                </Owner>
                <StorageClass>Enum</StorageClass>
                <StorageTier>Enum</StorageTier>
                <RestoreStatus>Enum</RestoreStatus>
            </Contents>
            <Contents>
                <Key>string</Key>
                <LastModified>date</LastModified>
                <ETag>string</ETag>
                <Size>integer</Size>
                <Owner>
                    <ID>string</ID>
                    <DisplayName>string</DisplayName>
                </Owner>
                <StorageClass>Enum</StorageClass>
                <StorageTier>Enum</StorageTier>
                <RestoreStatus>Enum</RestoreStatus>
            </Contents>
</ListBucketResult>
The nodes are described as follows:
Node Name (Keyword)
Parent Node
Description
Type
ListBucketResult
None
Stores the result of the GET Bucket request.
Container
Content of ListBucketResult:
Node Name (Keyword)
Parent Node
Description
Type
Name
ListBucketResult
Bucket name, formatted as <BucketName-APPID>, such as examplebucket-1250000000
string
EncodingType
ListBucketResult
Encoding type, which corresponds to the encoding-type parameter in the request. This node will be returned only when the encoding-type parameter is specified in the request.
string
Prefix
ListBucketResult
Matching prefix to filter object keys. This node corresponds to the Prefix parameter in the request.
string
Marker
ListBucketResult
Marks the object key to start with. Object keys after the marker will be returned in UTF-8 lexicographical order. This node corresponds to the marker parameter in the request.
string
MaxKeys
ListBucketResult
Maximum number of keys returned in a single response. This node corresponds to the max-keys parameter in the request.
integer
Delimiter
ListBucketResult
Delimiter, which corresponds to the delimiter parameter in the request and will be returned only if the delimiter parameter is specified in the request.
string
IsTruncated
ListBucketResult
Indicates whether the returned list is truncated. Valid values: true, false
boolean
NextMarker
ListBucketResult
This node will be returned only if the returned list is truncated (i.e., the value of IsTruncated is true). The value of this node is the last object key in the current response. If you need to request subsequent entries, the value can be passed in as the value of the marker parameter in the next request.
string
CommonPrefixes
ListBucketResult
The identical paths between the prefix (or, if no prefix is specified, the beginning of the string) and the first delimiter are grouped and defined as a common prefix. This node will be returned only if the delimiter parameter is specified in the request
Container
Contents
ListBucketResult
Object entries
Container
Content of CommonPrefixes:
Node Name (Keyword)
Parent Node
Description
Type
Prefix
ListBucketResult.CommonPrefixes
A single common prefix
string
Content of Contents:
Node Name (Keyword)
Parent Node
Description
Type
Key
ListBucketResult.Contents
Object key
string
LastModified
ListBucketResult.Contents
Time the object was last modified, in ISO 8601 format (for example, 2019-05-24T10:56:40Z)
date
ETag
ListBucketResult.Contents
Entity tag of the object. It indicates the content of the object when it is created and can be used to verify whether the object content is changed. Example: "8e0b617ca298a564c3331da28dcb50df" The value of ETag is not necessarily the MD5 checksum of the object. The value will be different if the uploaded object is encrypted.
string
Size
ListBucketResult.Contents
Object size, in bytes
integer
Owner
ListBucketResult.Contents
Information of the object owner
Container
StorageClass
ListBucketResult.Contents
Object storage class, such as STANDARD_IA or ARCHIVE. For enumerated values, please see Storage Class Overview
Enum
StorageTier
ListBucketResult.Contents
Access tier (for INTELLIGENT TIERING) the object is currently stored in. Enumerated values: FREQUENT, INFREQUENT. This node is returned only when StorageClass is set to INTELLIGENT_TIERING.
Enum
RestoreStatus
ListBucketResult.Contents
When the object storage class is ARCHIVE or DEEP ARCHIVE, this field indicates the restoration status of the object. Valid values: ONGOING, DONE, FAILED. If no restoration request is initiated to the object, this field is null. After a restoration request is initiated, the value is ONGOING, DONE, and FAILED respectively if the restoration is in progress, completed, or failed. This node is returned only when StorageClass is ARCHIVE or DEEP_ARCHIVE.
Enum
Content of Contents.Owner:
Node Name (Keyword)
Parent Node
Description
Type
ID
ListBucketResult.Contents.Owner
APPID of the object owner
string
DisplayName
ListBucketResult.Contents.Owner
Name of the object owner
string

Error codes

This API returns common error responses and error codes. For more information, see Error Codes.

Examples

Example 1: simple use case

Request

GET / HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Thu, 10 Dec 2020 03:37:41 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1607571461;1607578661&q-key-time=1607571461;1607578661&q-header-list=date;host&q-url-param-list=&q-signature=918fd2e0149edf8982bebaab2956ec81ede1****
Connection: close

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 2931
Connection: close
Date: Thu, 10 Dec 2020 03:37:41 GMT
Server: tencent-cos
x-cos-bucket-region: ap-beijing
x-cos-request-id: NWZkMTk4MDVfNjViODJhMDlfNDZkYl8xNzU0****

<?xml version='1.0' encoding='utf-8' ?>
<ListBucketResult>
      <Name>examplebucket-1250000000</Name>
      <Prefix/>
      <Marker/>
      <MaxKeys>1000</MaxKeys>
      <IsTruncated>false</IsTruncated>
      <Contents>
          <Key>example-folder-1/example-object-1.jpg</Key>
          <LastModified>2020-12-10T03:37:30.000Z</LastModified>
          <ETag>&quot;f173c1199e3d3b53dd91223cae16fb42&quot;</ETag>
          <Size>37</Size>
          <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
          </Owner>
          <StorageClass>STANDARD</StorageClass>
      </Contents>
      <Contents>
          <Key>example-folder-1/example-object-2.jpg</Key>
          <LastModified>2020-12-10T03:37:30.000Z</LastModified>
          <ETag>&quot;c9d28698978bb6fef6c1ed1c439a17d3&quot;</ETag>
          <Size>37</Size>
          <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
          </Owner>
                <StorageClass>INTELLIGENT_TIERING</StorageClass>
                <StorageTier>FREQUENT</StorageTier>
      </Contents>
                ...
      <Contents>
          <Key>example-object-2.jpg</Key>
          <LastModified>2020-12-10T03:37:30.000Z</LastModified>
          <ETag>&quot;51370fc64b79d0d3c7c609635be1c41f&quot;</ETag>
          <Size>20</Size>
          <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
          </Owner>
          <StorageClass>STANDARD_IA</StorageClass>
      </Contents>
      <Contents>
          <Key>example-object-3.jpg</Key>
          <LastModified>2020-12-10T04:37:30.000Z</LastModified>
          <ETag>&quot;51370fc64b79d0d3c7c609635be1c41f&quot;</ETag>
          <Size>20</Size>
          <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
          </Owner>
          <StorageClass>ARCHIVE</StorageClass>
          <RestoreStatus>DONE</RestoreStatus>
      </Contents>
</ListBucketResult>

Example 2. Specifying the encoding-type parameter (object keys are URL-encoded)

Request

GET /?encoding-type=url HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Tue, 08 Dec 2020 13:54:16 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1607435656;1607442856&q-key-time=1607435656;1607442856&q-header-list=date;host&q-url-param-list=encoding-type&q-signature=ccbffb70b38430c4b6bc2d1b16ec9c1c8b6f****
Connection: close

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1220
Connection: close
Date: Wed, 09 Dec 2020 15:28:29 GMT
Server: tencent-cos
x-cos-bucket-region: ap-beijing
x-cos-request-id: NWZkMGVkMWRfZjdjNzJhMDlfMjJhYTlfYmJk****

<?xml version='1.0' encoding='utf-8' ?>
<ListBucketResult>
      <Name>examplebucket-1250000000</Name>
      <EncodingType>url</EncodingType>
      <Prefix/>
      <Marker/>
      <MaxKeys>1000</MaxKeys>
      <IsTruncated>false</IsTruncated>
      <Contents>
                <Key>Tencent%20Cloud.jpg</Key>
                <LastModified>2020-12-09T15:28:19.000Z</LastModified>
                <ETag>&quot;ee8de918d05640145b18f70f4c3aa602&quot;</ETag>
                <Size>16</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
      </Contents>
      <Contents>
                <Key>%E7%85%A7%E7%89%87/2020%E5%B9%B4/IMG0001.jpg</Key>
                <LastModified>2020-12-09T15:28:19.000Z</LastModified>
                <ETag>&quot;ee8de918d05640145b18f70f4c3aa602&quot;</ETag>
                <Size>16</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
      </Contents>
      <Contents>
                <Key>%E8%85%BE%E8%AE%AF%E4%BA%91.jpg</Key>
                <LastModified>2020-12-09T15:28:19.000Z</LastModified>
                <ETag>&quot;ee8de918d05640145b18f70f4c3aa602&quot;</ETag>
                <Size>16</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
            </Contents>
</ListBucketResult>

Example 3. Specifying the delimiter parameter (listing objects and subdirectories in the root directory)

Request

GET /?delimiter=%2F HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Thu, 10 Dec 2020 03:37:41 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1607571461;1607578661&q-key-time=1607571461;1607578661&q-header-list=date;host&q-url-param-list=delimiter&q-signature=5984c14f29df90235f4c507e7fbf68ad775e****
Connection: close

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1011
Connection: close
Date: Thu, 10 Dec 2020 03:37:41 GMT
Server: tencent-cos
x-cos-bucket-region: ap-beijing
x-cos-request-id: NWZkMTk4MDVfNjRiMDJhMDlfOTZjZV8xOTgw****

<?xml version='1.0' encoding='utf-8' ?>
<ListBucketResult>
            <Name>examplebucket-1250000000</Name>
            <Prefix/>
            <Marker/>
            <MaxKeys>1000</MaxKeys>
            <Delimiter>/</Delimiter>
            <IsTruncated>false</IsTruncated>
            <CommonPrefixes>
                <Prefix>example-folder-1/</Prefix>
            </CommonPrefixes>
            <CommonPrefixes>
                <Prefix>example-folder-2/</Prefix>
            </CommonPrefixes>
            <Contents>
                <Key>example-object-1.jpg</Key>
                <LastModified>2020-12-10T03:37:30.000Z</LastModified>
                <ETag>&quot;0f0cd12c48979d1bf3f95255a36cb861&quot;</ETag>
                <Size>20</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
            </Contents>
            <Contents>
                <Key>example-object-2.jpg</Key>
                <LastModified>2020-12-10T03:37:30.000Z</LastModified>
                <ETag>&quot;51370fc64b79d0d3c7c609635be1c41f&quot;</ETag>
                <Size>20</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD_IA</StorageClass>
            </Contents>
</ListBucketResult>

Example 4. Specifying the prefix and delimiter parameters (listing objects and subdirectories in a specified subdirectory)

Request

GET /?prefix=example-folder-1%2F&delimiter=%2F HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Thu, 10 Dec 2020 03:37:41 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1607571461;1607578661&q-key-time=1607571461;1607578661&q-header-list=date;host&q-url-param-list=delimiter;prefix&q-signature=96b4c558ed02a6e6652427fb91b8d22f2107****
Connection: close

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1142
Connection: close
Date: Thu, 10 Dec 2020 03:37:41 GMT
Server: tencent-cos
x-cos-bucket-region: ap-beijing
x-cos-request-id: NWZkMTk4MDVfZGZjNzJhMDlfMzJiMjRfMTY0****

<?xml version='1.0' encoding='utf-8' ?>
<ListBucketResult>
            <Name>examplebucket-1250000000</Name>
            <Prefix>example-folder-1/</Prefix>
            <Marker/>
            <MaxKeys>1000</MaxKeys>
            <Delimiter>/</Delimiter>
            <IsTruncated>false</IsTruncated>
            <CommonPrefixes>
                <Prefix>example-folder-1/sub-folder-1/</Prefix>
            </CommonPrefixes>
            <CommonPrefixes>
                <Prefix>example-folder-1/sub-folder-2/</Prefix>
            </CommonPrefixes>
            <Contents>
                <Key>example-folder-1/example-object-1.jpg</Key>
                <LastModified>2020-12-10T03:37:30.000Z</LastModified>
                <ETag>&quot;f173c1199e3d3b53dd91223cae16fb42&quot;</ETag>
                <Size>37</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
            </Contents>
            <Contents>
                <Key>example-folder-1/example-object-2.jpg</Key>
                <LastModified>2020-12-10T03:37:30.000Z</LastModified>
                <ETag>&quot;c9d28698978bb6fef6c1ed1c439a17d3&quot;</ETag>
                <Size>37</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>INTELLIGENT_TIERING</StorageClass>
                <StorageTier>FREQUENT</StorageTier>
            </Contents>
</ListBucketResult>

Example 5. Obtaining the first page of keys when there are more than one page (this example specifies the value of max-keys. If not specified, the value 1000 is used by default)

Request

GET /?max-keys=3 HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Tue, 08 Dec 2020 12:05:10 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1607429110;1607436310&q-key-time=1607429110;1607436310&q-header-list=date;host&q-url-param-list=max-keys&q-signature=a08797232c663110139c878400339bc5b4f4****
Connection: close

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1195
Connection: close
Date: Tue, 08 Dec 2020 12:05:10 GMT
Server: tencent-cos
x-cos-bucket-region: ap-beijing
x-cos-request-id: NWZjZjZiZjZfZGRjODJhMDlfMWFjZDVfMTlmZTY5****

<?xml version='1.0' encoding='utf-8' ?>
<ListBucketResult>
            <Name>examplebucket-1250000000</Name>
            <Prefix/>
            <Marker/>
            <MaxKeys>3</MaxKeys>
            <IsTruncated>true</IsTruncated>
            <NextMarker>example-object-3.jpg</NextMarker>
            <Contents>
                <Key>example-object-1.jpg</Key>
                <LastModified>2020-12-08T12:05:00.000Z</LastModified>
                <ETag>&quot;0f0cd12c48979d1bf3f95255a36cb861&quot;</ETag>
                <Size>20</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
            </Contents>
            <Contents>
                <Key>example-object-2.jpg</Key>
                <LastModified>2020-12-08T12:05:00.000Z</LastModified>
                <ETag>&quot;51370fc64b79d0d3c7c609635be1c41f&quot;</ETag>
                <Size>20</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
            </Contents>
            <Contents>
                <Key>example-object-3.jpg</Key>
                <LastModified>2020-12-08T12:05:00.000Z</LastModified>
                <ETag>&quot;b2f1d893c5fde000ee8ea6eca18ed81f&quot;</ETag>
                <Size>20</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
            </Contents>
</ListBucketResult>

Example 6. Obtaining the subsequent pages (a continuity of example 5)

Request

GET /?max-keys=3&marker=example-object-3.jpg HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Tue, 08 Dec 2020 12:05:11 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1607429111;1607436311&q-key-time=1607429111;1607436311&q-header-list=date;host&q-url-param-list=marker;max-keys&q-signature=b9613747aa1047ec4d72e63123340e88e1c0****
Connection: close

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 859
Connection: close
Date: Tue, 08 Dec 2020 12:05:11 GMT
Server: tencent-cos
x-cos-bucket-region: ap-beijing
x-cos-request-id: NWZjZjZiZjdfMjRhZjJhMDlfMjc2NV8xYmE2****

<?xml version='1.0' encoding='utf-8' ?>
<ListBucketResult>
            <Name>examplebucket-1250000000</Name>
            <Prefix/>
            <Marker>example-object-3.jpg</Marker>
            <MaxKeys>3</MaxKeys>
            <IsTruncated>false</IsTruncated>
            <Contents>
                <Key>example-object-4.jpg</Key>
                <LastModified>2020-12-08T12:05:00.000Z</LastModified>
                <ETag>&quot;e9ec8bcb980d2e4d8526c346eb3b2585&quot;</ETag>
                <Size>20</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
            </Contents>
            <Contents>
                <Key>example-object-5.jpg</Key>
                <LastModified>2020-12-08T12:05:00.000Z</LastModified>
                <ETag>&quot;201669a14bdf051d8a9d6f9828d3f4c4&quot;</ETag>
                <Size>20</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
            </Contents>
</ListBucketResult>

Example 7. Obtaining the first page of keys when there are more than one page (with delimiter specified and the sum of CommonPrefixes and Contents not exceeding the value of max-keys)

Request

GET /?delimiter=%2F&max-keys=3 HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 09 Dec 2020 03:22:38 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1607484158;1607491358&q-key-time=1607484158;1607491358&q-header-list=date;host&q-url-param-list=delimiter;max-keys&q-signature=42f6307ea77293c7a507760430bcad255991****
Connection: close

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 486
Connection: close
Date: Wed, 09 Dec 2020 03:22:38 GMT
Server: tencent-cos
x-cos-bucket-region: ap-beijing
x-cos-request-id: NWZkMDQyZmVfYTJjMjJhMDlfYmQwOF8xYjkw****

<?xml version='1.0' encoding='utf-8' ?>
<ListBucketResult>
            <Name>examplebucket-1250000000</Name>
            <Prefix/>
            <Marker/>
            <MaxKeys>3</MaxKeys>
            <Delimiter>/</Delimiter>
            <IsTruncated>true</IsTruncated>
            <NextMarker>example-folder-3/</NextMarker>
            <CommonPrefixes>
                <Prefix>example-folder-1/</Prefix>
            </CommonPrefixes>
            <CommonPrefixes>
                <Prefix>example-folder-2/</Prefix>
            </CommonPrefixes>
            <CommonPrefixes>
                <Prefix>example-folder-3/</Prefix>
            </CommonPrefixes>
</ListBucketResult>

Example 8. Obtaining subsequent pages with delimiter specified (a continuity of example 7)

Request

GET /?delimiter=%2F&max-keys=3&marker=example-folder-3%2F HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 09 Dec 2020 03:22:39 GMT
Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1607484159;1607491359&q-key-time=1607484159;1607491359&q-header-list=date;host&q-url-param-list=delimiter;marker;max-keys&q-signature=921a0e42ac17b3d95c7bf7e68696a489c9e0****
Connection: close

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 956
Connection: close
Date: Wed, 09 Dec 2020 03:22:39 GMT
Server: tencent-cos
x-cos-bucket-region: ap-beijing
x-cos-request-id: NWZkMDQyZmZfZmNhODBiMDlfZmM4N19jYmQz****

<?xml version='1.0' encoding='utf-8' ?>
<ListBucketResult>
            <Name>examplebucket-1250000000</Name>
            <Prefix/>
            <Marker>example-folder-3/</Marker>
            <MaxKeys>3</MaxKeys>
            <Delimiter>/</Delimiter>
            <IsTruncated>false</IsTruncated>
            <CommonPrefixes>
                <Prefix>example-folder-4/</Prefix>
            </CommonPrefixes>
            <Contents>
                <Key>example-object-1.jpg</Key>
                <LastModified>2020-12-09T03:22:28.000Z</LastModified>
                <ETag>&quot;0f0cd12c48979d1bf3f95255a36cb861&quot;</ETag>
                <Size>20</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
            </Contents>
            <Contents>
                <Key>example-object-2.jpg</Key>
                <LastModified>2020-12-09T03:22:28.000Z</LastModified>
                <ETag>&quot;51370fc64b79d0d3c7c609635be1c41f&quot;</ETag>
                <Size>20</Size>
                <Owner>
                    <ID>1250000000</ID>
                    <DisplayName>1250000000</DisplayName>
                </Owner>
                <StorageClass>STANDARD</StorageClass>
            </Contents>
</ListBucketResult>

다음 주제: 릴리스 노트

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백