Get Started with Enterprise Cloud 2.0 API
When you are new to API of Enterprise Cloud 2.0 , please use the following procedure to reference. Please refer to Tutorial : Basic Information on API Call for more detail.
1. Get information of API key and API secret key
To utilize APIs provided in this service, you need to get a Token beforehand.
API key, API secret key and Tenant ID are required to get the Token. The following is an example.
API key and API secret key can be found on the Profile section of the Enterprise Cloud 2.0 portal.
2. Get Token
Customers can get a token by executing the command below with the API key, API secret key and Tenant ID.
curl -i \ -H "Content-Type: application/json" \ -d ' { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "domain": { "id": "default" }, "name": "ApiKey", "password": "ApiSecret" } } }, "scope": { "project": { "id": "TenantID" } } } }' https://keystone-jp1-ecl.api.ntt.com/v3/auth/tokens
Customers will receive following response after executing the command. The value of “X-Subject-Token” need to be used as Token in each API execution.
HTTP/1.1 201 Created Date: Fri, 30 Oct 2015 07:52:26 GMT Server: Apache/2.4.7 (Ubuntu) X-Subject-Token: fe7136237a6e40729e52fc452b8cdf82 Vary: X-Auth-Token X-Distribution: Ubuntu (snip)
3. Execute API for each service
After obtaining a Token, customer can call APIs to the endpoint defined for each service.
Every endpoints is defined by the following policy.[Function Name]-[Region Name]-ecl.api.ntt.com
For now JP1, JP2, US1, UK1, SG1, AU1, HK1 and DE1 region are available. Please refer to next chapter for the URLs of each API endpoint.