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.