Resource path line

The resource path line for an HSwift request specifies the operation target, whether it be an account, container, or object.

In the resource path for an HSwift request that uses Keystone authentication, the account name is interchangeable with the Tenant Id Prefix (default is AUTH_) followed by the Keystone Tenant ID. For example:

api.hcp.example.com/swift/v1/AUTH_6b6884ebb6f441cfbb7e740f6a927c9e/finance

In the resource path, the tenant ID prefix and Keystone tenant ID can be replaced with the HSwift account name. For example:

api.hcp.example.com/swift/v1/europe/finance

If the target of the request is a container, the resource path includes a forward slash followed by the container name.

If the target of the operation is an object, the request line includes a forward slash followed by the object name following the container name.

For example, here are the Keystone tenant authentication token and account name resource paths for a request to create an object named Q4_2012.ppt:

api.hcp.example.com/swift/v1/AUTH_6b6884ebb6f441cfbb7e740f6a927c9e/finance/Q4_2012.ppt

api.hcp.example.com/swift/v1/europe/finance/Q4_2012.ppt

If the request uses any query parameters, those parameters are appended to the resource path.

For example, here is a request URL to alphabetically list all containers in the europe account between the letters E and S:

http://api.hcp.example.com/swift/v1/AUTH_6b6884ebb6f441cfbb7e740f6a927c9e?marker=e&end_marker=s

http://api.hcp.example.com/swift/v1/europe?marker=e&end_marker=s

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

© 2015, 2020 Hitachi Vantara LLC. All rights reserved.