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.
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
The table below describes HTTP status codes that can be returned from a node service information request.
Code | HTTP status | Description |
200 | Success | Node returns its service information. |
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.
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-" }