3.1. Get started¶
This API allows you to create/update/read/delete your EIC/CIC. Here you can see how to use the API to for some basic use cases.
Colocation Interconnectivity(CIC)¶
Create mCIC¶
NTTCom will create mCIC on behalf of you. Please contact our sales of Colocation. We will also create the first CIC.
Create CIC¶
Once mCIC is created, you can create the second CIC by yourself!
Authentication¶
At first, please call the authentication API. You can get authentication token by following instructions on this page . In following steps, you need to put the authentication token in X-Auth-Token header of API request.
Confirm mCIC¶
Please confirm your mCIC is created first. Call the API below.:
$ curl -H "Content-Type: application/json" \
-H "X-Auth-Token: {token}" \
-X GET {api_endpoint}/v1.0/ecc/mCICs/{mcic_id}
This will return a list of your mCICs. Please note "mcic_id" to use in the following steps. If you'd like to get more detailed information, please refer Show mCICs.
Create CIC¶
Let's create CIC resource! You can create a new CIC with this API call.
$ curl -H "Content-Type: application/json" \
-H "X-Auth-Token: {token}" \
-d '{"network_id": "cbbafd82-8f99-4eda-9e46-97ddf24bdxxx","cic_name": "friendly name","colo_vlan": 1000}'
-X POST {api_endpoint}/v1.0/ecc/mCICs/{mcic_id}/CICs
- This will return these 2 items.
- operation_id
- cic_id
You can use the operation_id to track your CIC creation status. See the next step for the detail. If you'd like to get more detailed information, please refer Create CICs.
Track the CIC status¶
You can see the status of CIC creation (or deletion) with this API call.
$ curl -H "Content-Type: application/json" \
-H "X-Auth-Token: {token}" \
-X GET {api_endpoint}/v1.0/ecc/operations/{operation_id}
- This will return these items.
- operation_id
- operation_status
- operation_type
- operation_body
- mcic_id
- cic_id
- user_id
- user_name
- reciept_date
- error_messages
You will see "operation_status" as processing, success or failure. If you'd like to get more detailed information, please refer Show Operation
Delete CIC¶
When you no longer use your CIC, you can delete your server by calling this API.
$ curl -H "Content-Type: application/json" \
-H "X-Auth-Token: {token}" \
-X DELETE {api_endpoint}/v1.0/ecc/mCICs/{mcic_id}/CICs/{cic_id}
- This will return these items.
- operation_id
- cic_id
You can use the operation_id to track your CIC deletion status which is described in 1.4.2 Track the CIC status. If you'd like to get more detailed information, please refer Delete CICs
Delete mCIC¶
NTTCom will delete mCIC on behalf of you. Please contact our sales of Colocation. We will also delete the first CIC.
Enterprise Cloud Interconnectivity(EIC)¶
Note¶
We use the same API endpoint and almost similar API models with CIC. So some API parameter names are the same with them.
Create mEIC¶
NTTCom will create mEIC on behalf of you. Please contact our sales of ECL1.0. We will also create the first EIC.
Create EIC¶
Once mEIC is created, you can create the second EIC by yourself!
Authentication¶
At first, please call the authentication API. You can get authentication token by following instructions on this page . In following steps, you need to put the authentication token in X-Auth-Token header of API request.
Confirm mEIC¶
Please confirm your mEIC is created first. Call the API below.:
$ curl -H "Content-Type: application/json" \
-H "X-Auth-Token: {token}" \
-X GET {api_endpoint}/v1.0/ecc/mCICs/{mcic_id}
This will return a list of your mEICs. Please note "mcic_id" to use in the following steps. If you'd like to get more detailed information, please refer Show mCICs.
Create EIC¶
Let's create EIC resource! You can create a new EIC with this API call. You need to collect some parameters from ECL1.0 Portal.
$ curl -H "Content-Type: application/json" \
-H "X-Auth-Token: {token}" \
-d '{"network_id": "cbbafd82-8f99-4eda-9e46-97ddf24bdxxx","cic_name": "friendly name","server_segment_nbr": 1}'
-X POST {api_endpoint}/v1.0/ecc/mCICs/{mcic_id}/CICs
- This will return these 2 items.
- operation_id
- cic_id
You can use the operation_id to track your EIC creation status. See the next step for the detail. If you'd like to get more detailed information, please refer Create CICs.
Track the EIC status¶
You can see the status of EIC creation (or deletion) with this API call.
$ curl -H "Content-Type: application/json" \
-H "X-Auth-Token: {token}" \
-X GET {api_endpoint}/v1.0/ecc/operations/{operation_id}
- This will return these items.
- operation_id
- operation_status
- operation_type
- operation_body
- mcic_id
- cic_id
- user_id
- user_name
- reciept_date
- error_messages
You will see "operation_status" as processing, success or failure. If you'd like to get more detailed information, please refer Show Operation
Delete EIC¶
When you no longer use your EIC, you can delete your server by calling this API.
$ curl -H "Content-Type: application/json" \
-H "X-Auth-Token: {token}" \
-X DELETE {api_endpoint}/v1.0/ecc/mCICs/{mcic_id}/CICs/{cic_id}
- This will return these items.
- operation_id
- cic_id
You can use the operation_id to track your EIC deletion status which is described in 2.4.2 Track the EIC status. If you'd like to get more detailed information, please refer Delete CICs
Delete mEIC¶
NTTCom will delete mEIC on behalf of you. Please contact our sales of ECL1.0. We will also delete the first EIC.