Cloudn Compute API

Overview

本APIは、NTT Com Cloudn Compute API(CloudStack Base)をAPIゲートウェイ経由で
利用できるようにするAPIです。
FLATタイプ、VPCタイプ OpenNWに対応しています。
また、本2タイプのリージョン指定をHTTPヘッダに付与することで、エンドポイント指定を切り替えることなくAPIを利用が可能です。

Resource URL

グローバル共通ドメインの利用、または個別リージョンドメインをご利用ください。

グローバル共通ドメインを利用する場合、お客様のご利用箇所の状況に応じて、
一番近いAPIゲートウェイに接続します。1

1.Base Path(Global Load Balance)

https://api.ntt.com/v1/cloudn/compute

2.Base Path(Region)

https://{region}.api.ntt.com/v1/cloudn/compute
  • region is jp|us|uk
  • e.g. https://us.api.ntt.com/v1/cloudn/compute
  • 指定できるregionは、将来拡充予定

Resource Information

Key Value
レスポンス フォーマット JSON/XML
認証(OAuth)APIゲートウェイ用 Yes
認証(HMAC)Cloudn Compute用 Yes
帯域制御#1 Yes
  • #1 お客さま接続単位で適切な流量制限を実施

Cloudn Compute操作

FLATタイプ、VPCタイプ OpenNW共にCloudStack Baseとなります。
これらの制御のためのAPI入出力はCloudStack APIまたは、Cloudn APIご利用ガイドを参照ください。

APIゲートウエイ経由でCloudn Compute APIを利用するための追加仕様は以下の通りです。

Request Parameters

Name Description type mandatory
X-Api-Location FLAT/OpenNWのリージョン Header Yes

FLAT/OpenNW Type Region

Pattern Cloudn Compute Type Cloudn Compute Region
jp-east-vpc OpenNW 東日本
jp-east-flat Flat 東日本
jp-west-flat Flat 西日本
us-flat Flat 米国

Example Request

GET /v1/cloudn/compute?command=listZones&response=json&apiKey={CloudnConsumerKey}&signature={CloudnHMAC}

Response Parameters

CloudStack APIまたは、Cloudn APIご利用ガイドを参照ください。

Example Result

{
  "listzonesresponse": {
  "count": 2,
  "zone": [
    {
        "id": "**********",
        "name": "jp-e1a",
        "networktype": "Advanced",
        "securitygroupsenabled": false,
        "allocationstate": "Enabled",
        "zonetoken": "**********",
        "dhcpprovider": "VirtualRouter",
        "localstorageenabled": false
    },
    {
        "id": "**********",
        "name": "jp-e1b",
        "networktype": "Advanced",
        "securitygroupsenabled": false,
        "allocationstate": "Enabled",
        "zonetoken": "**********",
        "dhcpprovider": "VirtualRouter",
        "localstorageenabled": false
    }
  ]
 }
}

  1. 2014/12現在、DNSラウンドロビン運用。2015/04以降、お客さまの地理的に近いAPIゲートウェイに自動接続します