Skip to main content

We've Moved!

Product Documentation has moved to docs.hitachivantara.com
Hitachi Vantara Knowledge

Checking service information about your nodes

You can use the HSwift information command to check the service information of a target node in your HCP system. The information command can be performed by any user. It does not require HSwift to be enabled on a tenant in the node or for you to submit any authentication credentials.

Request line

The request to check the service information requires a URL specifying the front-end IP address of the target node. You enter the command in the following format:

http://node-front-end-ip-address/swift/info
Response codes

The table below describes HTTP status codes that can be returned from a node service information request.

CodeHTTP statusDescription
200SuccessNode returns its service information.
Response body

By default, HCP returns the node service information in a plain text format. This is the response body, in plain text format:

{
"container_quotas" : { },
"keystoneauth" : { },
"tempauth" : { },
"swift" : {
    "account_autocreate" : false,
    "account_listing_limit" : 10000,
    "allow_account_management" : false,
    "container_listing_limit" : 10000,
    "max_account_name_length" : 63,
    "max_container_name_length" : 63,
    "max_file_size" : 2194719883008,
    "max_header_size" : 10000,
    "max_meta_count" : 10000,
    "max_meta_name_length" : 2048,
    "max_meta_overall_size" : 40960,
    "max_meta_value_length" : 2048,
    "max_object_name_length" : 1024,
    "version" : "8.0.0.14-"
}

The list below describes the elements in this response body. The elements are listed in alphabetical order.

  • container_quotas

    Empty element that signifies that container quotas is supported on this HCP system. The container quota is 10,000.

  • keystoneauth

    Empty element that signifies that Keystone authentication is supported but not necessarily enabled on this HCP system.

  • tempauth

    Empty element that signifies that temporary authentication is supported on this HCP system.

  • swift

    Root element.

  • account_autocreate

    Child of the swift element.

    The account_autocreate element specifies if HCP automatically creates HSwift accounts.

  • account_listing_limit

    Child of the swift element.

    The account_listing_limit element specifies the maximum number of items that are returned for an account listing request.

  • allow_account_management

    Child of the swift element.

    The allow_account_management element specifies whether an HSwift account can be created or deleted using PUT or DELETE requests.

  • container_listing_limit

    Child of the swift element.

    The container_listing_limit element specifies the maximum number of items that are returned for an container listing request.

  • max_account_name_length

    Child of the swift element.

    The max_account_name_length element specifies the maximum number of bytes in the UTF-8 encoding of an account name.

  • max_container_name_length

    Child of the swift element.

    The max_container_name_length element specifies the maximum number of bytes in the utf8 encoding of a container name.

  • max_file_size

    Child of the swift element.

    The max_file_size element specifies the maximum size, in bytes, of an object that can be written to the HCP system.

  • max_header_size

    Child of the swift element.

    The max_header_size element specifies the maximum the maximum number of bytes in the utf8 encoding of each header.

  • max_meta_count

    Child of the swift element.

    The max_meta_count element specifies the maximum number of metadata keys that can be stored on a single account, container, or object.

  • max_meta_name_length

    Child of the swift element.

    The max_meta_name_length element specifies the maximum number of bytes in the UTF-8 encoding of the name portion of a metadata header.

  • max_meta_overall_size

    Child of the swift element.

    The max_meta_overall_size element specifies the maximum number of bytes in the UTF-8 encoding of the metadata key/value pair.

  • max_meta_value_length

    Child of the swift element.

    The max_meta_value_length element specifies the maximum number of bytes in the UTF-8 encoding of a metadata value.

  • max_object_name_length

    Child of the swift element.

    The max_object_name_length element specifies the maximum number of bytes in the UTF-8 encoding of an object name.

  • version

    Child of the swift element.

    The version element specifies the the HCP system software version.

Example: Retrieving node service information

Here is a sample request that retrieves node service information for a node in the system. In this example, the target node IP address is 192.168.210.16.

Request with cURL command line

curl -k https://192.168.210.16/swift/info

Response headers

HTTP/1.1 200 Success

Response body in plain text

{
"container_quotas" : { },
"keystoneauth" : { },
"tempauth" : { },
"swift" : {
    "account_autocreate" : false,
    "account_listing_limit" : 10000,
    "allow_account_management" : false,
    "container_listing_limit" : 10000,
    "max_account_name_length" : 63,
    "max_container_name_length" : 63,
    "max_file_size" : 2194719883008,
    "max_header_size" : 10000,
    "max_meta_count" : 10000,
    "max_meta_name_length" : 2048,
    "max_meta_overall_size" : 40960,
    "max_meta_value_length" : 2048,
    "max_object_name_length" : 1024,
    "version" : "8.0.0.14-"
}

 

  • Was this article helpful?