使用API调用创建实例的过程

简介

本文档介绍使用应用编程接口(API)调用在Cisco CloudCenter(CCC)中创建实例的过程。

先决条件

要求

Cisco 建议您了解以下主题：

• Linux界面
• 虚拟机环境
• 命令行界面 (CLI)

使用的组件

本文档中的信息基于以下软件版本：

• CCC版本4.x
• CloudCenter管理(CCM) 
• 管理API访问密钥

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的系统处于活动状态，请确保您了解任何命令的潜在影响。

创建CCC API密钥

步骤1.在CCM GUI中，导航至Admin > Users > Manage API Key（如果用户没有Key，请生成新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

注意： 用CCM地址替换<host>。

步骤5.从CLI(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。
          替换 803D197EFFC9A527作为您的密钥。
          将api_instaces.json替换为文件。
          用CCM地址替换<host>。

如果一切正常，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