GET Bucket(List Objects)

Last updated: 2021-01-18 18:54:57

    API Description

    The GET Bucket 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.

    Request

    Sample request

    GET / HTTP/1.1
    Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
    Date: GMT Date
    Authorization: Auth String

    Note:

    Authorization: Auth String (see Request Signature for details).

    Request parameters

    Parameter Description Type Required
    prefix Matching prefix for object keys. The response will contain only object keys with the specified prefix. string No
    delimiter A 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. For more information, please see 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.

    Parameter 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 sample 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>
                </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>
                </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 the Container node 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 the Container node CommonPrefixes:

    Node Name (Keyword) Parent Node Description Type
    Prefix ListBucketResult.CommonPrefixes A single common prefix string

    Content of the Container node 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

    Content of the Container node 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, please see Error Codes.

    Samples

    Sample 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>
    </ListBucketResult>

    Sample 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>

    Sample 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>

    Sample 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>

    Sample 5. Obtaining the first page of keys when there are more than one page (this sample 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>

    Sample 6. Obtaining the subsequent pages (a continuity of sample 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>

    Sample 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>

    Sample 8. Obtaining subsequent pages with delimiter specified (a continuity of sample 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>