Request line

Content Platform Tenant Management Help

Version
9.7.x
File Size
4269 KB
Audience
anonymous
Part Number
MK-95HCPH002-19

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_2019 where the bucket name is included in the hostname:

    PUT /quarterly_rpts/Q4_2019 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_2019 in a bucket named finance where the bucket name is not included in the hostname:

    PUT /finance/quarterly_rpts/Q4_2019 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_2019 where the bucket name is included in the hostname:

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

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