API コールを使用してインスタンスを作成するための手順

概要

このドキュメントでは、アプリケーションプログラミングインターフェイス(API)コールを使用してCisco CloudCenter(CCC)でインスタンスを作成する手順について説明します。

前提条件

要件

次の項目に関する知識があることが推奨されます。

• Linux インターフェイス
• 仮想マシン環境
• コマンドライン インターフェイス（CLI）

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアのバージョンに基づいています。

• CCCバージョン4.x
• CloudCenter 管理（CCM） 
• API アクセス キーの管理

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期（デフォルト）設定の状態から起動しています。稼働中のシステムで作業を行う場合、コマンドの影響について十分に理解したうえで作業してください。

CCC API キーの作成

ステップ1:CCM GUIで、[Admin] > [Users] > [Manage API Key] に移動します（ユーザにキーがない場合は、新しいキーを生成します）。

ステップ2：キーをコピーし、テキストファイルに保存して、[キャンセル]をクリックします。

ステップ3：インスタンス情報を含むファイルを作成します(api_instance.json:

{
            "name": "m3.medium",
            "description": "General purpose(m3.medium)",
            "type": "m3.medium",
            "regionId": "1",
            "costPerHour": 0.07,
            "memorySize": 3840,
            "numOfCpus": 1,
            "numOfNics": 1,
            "localStorageCount": 1,
            "localStorageSize": 4,
            "supportsCuda": false,
            "supportsSsd": false,
            "supports32Bit": false,
            "supports64Bit": true,
            "supportsHardwareProvision": false
}

ステップ 4：[Admin] > [Cloud] > [Region] に移動して、クラウド領域を特定します。 https://<hosts>/v1/tenants/1/clouds/1/regions/1/instanceTypes

注： <host>をCCMアドレスに置き換えます。

ステップ5:api_instance.jsonファイルがあるCLIから、次のコマンドを実行します。 

curl -k -X POST -H "Accept: application/json" -H "Content-Type: application/json" \
-u cliqradmin:803D197EFFC9A527 "https://<host>/v1/tenants/1/clouds/1/regions/1/instanceTypes" \
--data @api_instances.json

注：cliqradminをユーザに置き換えます。
          replace キーとして803D197EFFC9A527。
          api_isntaces.jsonをファイルに置き換えます。
          <host>をCCMアドレスに置き換えます。

問題がなければ、CLIからの出力は次のようになります。

user$ curl -k -X POST -H "Accept: application/json" -H "Content-Type: application/json" -u cliqradmin:803D197EFFC9A527 "https://<hosts>0/v1/tenants/1/clouds/1/regions/1/instanceTypes" --data @api_instances.json
output 
{"id":"6","resource":"https://10.31.127.20/v1/tenants/1/clouds/1/regions/1/instanceTypes/6","name":"db.m2.xlarge","description":"High-memory Extra Large DB Instance","type":"db.m2.xlarge","regionId":"1","costPerHour":0.555,"memorySize":17100,"numOfCpus":2,"numOfNics":1,"localStorageCount":0,"localStorageSize":420,"supportsCuda":false,"supportsSsd":false,"supports32Bit":false,"supports64Bit":true,"supportsHardwareProvision":false}

CCM GUIに新しいインスタンスがあります。

関連情報

• http://docs.cloudcenter.cisco.com/display/40API/Create+Cloud+Instance+Type
• テクニカル サポートとドキュメント – Cisco Systems