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.

  • The following is the request URI:

    https://appliance:443/s3/v1/export/
                         sharename/bucketname/objectname

    The request URI identifies the resources on 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.