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
 
 

Making Requests Using the S3 Object API

To send a request message to Oracle ZFS Storage Appliance using the S3 Object API, the request message should include the following entities:

  • Request Type – The request type states the action to be performed on a resource that is identified in the URI, for example:

    GET https://<appliance>:443/s3/v1/export/<sharename>/<bucketname>/<objectname>

    Where:

    • GET is the action to be performed on the resource identified in the URI. For a list of supported actions on buckets and objects, see Supported and Unsupported S3 API Operations.

    • https://<appliance>:443/s3/v1/export/<share_mountpoint_path>/<bucketname>/<objectname> is the request URI. The request URI identifies the resources upon which to perform actions.

      Where:

      • appliance represents the network address or DNS name of the Oracle ZFS Storage Appliance system.

      • sharename represents the S3 account name of the share mount point upon which the action is to be performed.

      • bucketname represents the name of the bucket upon which the action is to be performed.

      • objectname represents the name of the object upon which the action is to be performed.

  • Request-Header Fields – The request-header fields act as request modifiers that pass additional information to the S3 appliance. The request headers appear after the request line in the message body. For a list of supported request headers, see Supported and Unsupported Header Requests.