Bucket operation

GetBucket

Lists the objects in a bucket.

GET200 on successluzon

Request

Request line

GET https://<bucket>-<appid>.cos.luzon.convergecloudcos.com/?prefix&delimiter&marker&max-keys

Addressed at the bucket host, <bucket>-<appid>.cos.luzon.convergecloudcos.com, where <appid> is the account AppId.

Query parameters: prefix, delimiter, marker, max-keys. Every query parameter in the request must also be named in q-url-param-list and covered by the signature.

Behaviour

IsTruncated reports whether the listing is complete. Continue with marker set to the last key returned.

Example

curl

curl -X GET \
  -H "Authorization: q-sign-algorithm=sha1&q-ak=…&q-signature=…" \
  "https://<bucket>-<appid>.cos.luzon.convergecloudcos.com/?prefix&delimiter&marker&max-keys"

Response — 200

<?xml version='1.0' encoding='utf-8' ?>
<ListBucketResult>
	<Name>example-bucket-1250000000</Name>
	<Prefix/>
	<Marker/>
	<MaxKeys>10</MaxKeys>
	<IsTruncated>false</IsTruncated>
	<Contents>
		<Key>hello.txt</Key>
		<LastModified>2026-09-17T11:24:02.000Z</LastModified>
		<ETag>&quot;98bbfb30482012068aa35fec6e0a8fb6&quot;</ETag>
		<Size>15</Size>
		<Owner>
			<ID>1250000000</ID>
		</Owner>
		<StorageClass>STANDARD</StorageClass>
	</Contents>
</ListBucketResult>