Connecting using an IP address

The core hardware for an HCP system consists of servers, called nodes, that are networked together. When you access an HCP system, your point of access is an individual node. Typically, you let HCP choose the node on which to process a metadata query API request. You can, however, use an IP address in the URL to access the system on a specific node. To do this, you replace the fully qualified hostname in the URL with the IP address of the node you want:

https://node-ip-address/query

With this URL format, you can provide an HTTP Host header that specifies a fully qualified hostname for a tenant or the entire repository. The hostname format you use depends on the namespaces you want to query:

To query namespaces owned by an HCP tenant, use this format:

hcp-tenant-name.hcp-domain-name

To query only the default namespace, use this format:

default.hcp-domain-name

To query the entire repository, use this format:

admin.hcp-domain-name

If you omit the Host header, the request queries the entire repository.

Note: The Host header is required when you are performing an operation-based query and the request body specifies a namespace.

With cURL, you use the -H option to provide the Host header. For example:

-H "Host: finance.hcp.example.com"

In Python with PycURL, you do this with the HTTPHEADER option. For example:

curl.setopt(pycurl.HTTPHEADER, [“HOST: default.hcp.example.com”])

When using an IP address in a URL, you need to use HTTP with SSL security.

For information on when to use an IP address for access to the HCP system, see Using a Namespace.

Note: If you don’t know the IP addresses for the HCP system, contact your HCP system administrator.

Trademark and LegalDisclaimer

© 2016 Hitachi Data Systems Corporation. All rights reserved.