Returns some or all (up to 1,000) of the objects in a bucket with each request. You can
use the request parameters as selection criteria to return a subset of the objects in a
bucket. A 200 OK response can contain valid or invalid XML. Make sure to
design your application to parse the contents of the response and handle it appropriately.
Objects are returned sorted in an ascending order of the respective key names in the list.
For more information about listing objects, see Listing object keys
programmatically in the Amazon S3 User Guide.
To use this operation, you must have READ access to the bucket.
This section describes the latest revision of this action. We recommend that you use
this revised API operation for application development. For backward compatibility, Amazon S3
continues to support the prior version of this API operation, ListObjects.
Returns some or all (up to 1,000) of the objects in a bucket with each request. You can use the request parameters as selection criteria to return a subset of the objects in a bucket. A
200 OK
response can contain valid or invalid XML. Make sure to design your application to parse the contents of the response and handle it appropriately. Objects are returned sorted in an ascending order of the respective key names in the list. For more information about listing objects, see Listing object keys programmatically in the Amazon S3 User Guide.To use this operation, you must have READ access to the bucket.
To use this action in an Identity and Access Management (IAM) policy, you must have permission to perform the
s3:ListBucket
action. The bucket owner has this permission by default and can grant this permission to others. For more information about permissions, see Permissions Related to Bucket Subresource Operations and Managing Access Permissions to Your Amazon S3 Resources in the Amazon S3 User Guide.This section describes the latest revision of this action. We recommend that you use this revised API operation for application development. For backward compatibility, Amazon S3 continues to support the prior version of this API operation, ListObjects.
To get a list of your buckets, see ListBuckets.
The following operations are related to
ListObjectsV2
:GetObject
PutObject
CreateBucket
Example
Use a bare-bones client and the command you need to make an API call.
Param
ListObjectsV2CommandInput
Returns
ListObjectsV2CommandOutput
See
input
shape.response
shape.config
shape.Throws
NoSuchBucket (client fault)
The specified bucket does not exist.
Throws
S3ServiceException
Base exception class for all service exceptions from S3 service.
Example
To get object list