HCP Tenant Management Help


Request line

The request line for an S3 compatible request specifies the operation to be performed and the version of HTTP on which the S3 compatible API is based. Additionally:

If the target of the request is a tenant or if the target is a bucket and the hostname includes the bucket name, the request line includes a forward slash by itself.

For example, here are the request line and HOST header for a request to create a bucket named finance where the bucket name is included in the hostname:

PUT / HTTP/1.1
HOST: finance.europe.hcp.example.com

If the target of the request is a bucket and the hostname does not include the bucket name, the request line includes the a forward slash followed by the bucket name.

For example, here are the request line and HOST header for a request to create a bucket named finance where the bucket name is not included in the hostname:

PUT /finance HTTP/1.1
HOST: europe.hcp.example.com

If the target of the operation is an object, the request line includes a forward slash followed by the object name either by itself or following the bucket name, depending on whether the hostnames includes the bucket name.

For example, here are the request line and HOST header for a request to create an object named quarterly_rpts/Q4_2018 where the bucket name is included in the hostname:

PUT /quarterly_rpts/Q4_2018 HTTP/1.1
HOST: finance.europe.hcp.example.com

Here are the request line and HOST header for a request to create an object named quarterly_rpts/Q4_2018 in a bucket named finance where the bucket name is not included in the hostname:

PUT /finance/quarterly_rpts/Q4_2018 HTTP/1.1
HOST: europe.hcp.example.com

If the request uses any query parameters, those parameters are appended to the last one of the items listed above.

For example, here are the request line and HOST header for a request to add an ACL to an object named quarterly_rpts/Q4_2018 where the bucket name is included in the hostname:

PUT /quarterly_rpts/Q4_2018?acl HTTP/1.1
HOST: finance.europe.hcp.example.com

If the request includes invalid query parameters, those parameters are ignored.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.