listObjectsV2
- up-to-date version, more convenient to use.listObjectsV1
- previous version.URL
, but it differs in the query parameter. To invoke listObjectsV2
, use the parameter list-type=2
.bucket
continuation-token
NextContinuationToken
from the previous answer.delimiter
delimiter
. In response to the request, the user will see a list of files and directories in the bucket. Files will be displayed in items Contents
, and directories in items CommonPrefixes
.
If a parameter is also specified in the request prefix
, then Object Storage will return a list of files and directories in the directory prefix
.encoding-type
url
.max-keys
Contents
and CommonPrefixes
. This parameter should be used if you need to get less than 1000 items in one response.
If more keys fall under the selection criteria than fit in the search results, then the answer contains <IsTruncated>true</IsTruncated>
.
To get all the elements of the issue, if there are more of them max-keys
, it is necessary to perform several consecutive requests to Object Storage with a parameter continuation-token
, where for each request continuation-token
is equal to the value of the element NextContinuationToken
from the previous response.prefix
prefix
.
It can be used simultaneously with the parameter delimiter
. In this case, the output logic is determined by the parameter delimiter
.start-after
ListBucketResult
IsTruncated
True
- everything. False
- Not all.
Path: /ListBucketResult/IsTruncated
.Contents
Contents
as the keys match the request conditions.
Path: /ListBucketResult/Contents
.ETag
/ListBucketResult/Contents/ETag
.Key
/ListBucketResult/Contents/Key
.LastModified
/ListBucketResult/Contents/LastModified
.Size
/ListBucketResult/Contents/Size
.StorageClass
STANDARD
or COLD
.
Path: /ListBucketResult/Contents/StorageClass
.Name
/ListBucketResult/Name
.Prefix
prefix
.
Path: /ListBucketResult/Prefix
.Delimiter
delimiter
.
Path: /ListBucketResult/Delimiter
.MaxKeys
max-keys
.
Path: /ListBucketResult/MaxKeys
.CommonPrefixes
delimiter
and prefix
.
Path: /ListBucketResult/CommonPrefixes
.EncodingType
encoding-type
.
Path: /ListBucketResult/EncodingType
.KeyCount
MaxKeys
.
Path: /ContinuationToken/KeyCount
.ContinuationToken
continuation-token
.
Path: /ContinuationToken/ContinuationToken
.NextContinuationToken
continuation-token
to get the next part of the list, if the entire list does not fit into the current response.
Refundable only if IsTruncated = true
.
Path: /ListBucketResult/NextContinuationToken
.StartAfter
start-after
.
Path: /ListBucketResult/StartAfter
.bucket
delimiter
delimiter
. In response to the request, the user will see a list of files and directories in the bucket. Files will be displayed in items Contents
, and directories in items CommonPrefixes
.
If a parameter is also specified in the request prefix
, then Object Storage will return a list of files and directories in the directory prefix
.encoding-type
url
.marker
marker
.max-keys
Contents
and CommonPrefixes
. This parameter should be used if you need to get less than 1000 items in one response.
If more keys fall under the selection criteria than fit in the search results, then the answer contains <IsTruncated>true</IsTruncated>
.
To get all the elements of the issue, if there are more of them max-keys
, it is necessary to perform several consecutive requests to Object Storage with a parameter marker
, where for each request marker
is equal to the value of the element NextMarker
from the previous response.prefix
prefix
.
It can be used simultaneously with the parameter delimiter
. In this case, the output logic is determined by the parameter delimiter
.ListBucketResult
IsTruncated
True
- everything. False
- Not all.
Path: /ListBucketResult/IsTruncated
.Marker
marker
.
Path: /ListBucketResult/Marker
.NextMarker
marker
to get the next part of the list, if the entire list does not fit into the current response.
Path: /ListBucketResult/NextMarker
.Contents
Contents
as the keys match the request conditions.
Path: /ListBucketResult/Contents
.ETag
/ListBucketResult/Contents/ETag
.Key
/ListBucketResult/Contents/Key
.LastModified
/ListBucketResult/Contents/LastModified
.Size
/ListBucketResult/Contents/Size
.StorageClass
STANDARD
or COLD
.
Path: /ListBucketResult/Contents/StorageClass
.Name
/ListBucketResult/Name
.Prefix
prefix
.
Path: /ListBucketResult/Prefix
.Delimiter
delimiter
.
Path: /ListBucketResult/Delimiter
.MaxKeys
max-keys
.
Path: /ListBucketResult/MaxKeys
.CommonPrefixes
delimiter
and prefix
.
Path: /ListBucketResult/CommonPrefixes
.EncodingType
encoding-type
.
Path: /ListBucketResult/EncodingType
.