Skip to main content
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?