Go to main content

Oracle® ZFS Storage Appliance Object API Guide for Amazon S3 Service Support, Release OS8.8.0

Exit Print View

Updated: January 2019
 
 

GET Bucket

The GET Bucket operation returns some or all (up to 1,000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket. For more details about this operation, see the following:

Syntax Example

GET https://<appliance>:443/s3/v1/export/<share_mount_point_path>/<bucket_name>?list-type=2

Request Parameters

For a list of request parameters supported in a request query, see Amazon's official S3 GET Bucket API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html).

Request Headers

The GET Bucket operation uses only request headers that are common to all operations. For more information, see Figure 7, Table 7, Common Supported Request Headers .

Request Elements

The GET Bucket operation does not support the use of request elements.

Response Headers

The GET Bucket operation uses only response headers that are common to most responses. For more information, see Figure 9, Table 9, Supported Response Headers .

Response Elements

For a list of supported elements in the XML response for the GET Bucket operation, see Amazon's official S3 GET Bucket API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html).

Normal Response Code

200

Error Response Code

The GET Bucket operation returns special errors. For general information about S3 errors and a list of error codes, see S3 Client Error Handling Reference.

Example Response

For a list of response examples, see Amazon's official S3 GET Bucket API documentation (https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html).