阿里云容器服务公测也有一段时间了，这期间接触到不少用户反馈，不知道如何使用openapi进行相关的容器开发。这里我们就准备一篇关于如何使用容器服务Open API进行开发的教程，来讲解容器服务目前已公开的api接口。这里我们不打算自行实现Open API，而采用目前已有的sdk来说明，有兴趣的朋友，也可以尝试在API的接触上自行封装实现SDK。
在本教程过程中，如未特别说明，使用的Python 版本为2.7.10，操作系统为ubuntu 14.04 64位
环境准备
首先我们需要安装sdk的核心库以及容器服务
sudo pip install aliyun-python-sdk-core
sudo pip install aliyun-python-sdk-cs
创建集群
完成准备工作以后，接下来，我们就不如正题了，来讲解第一个api，创建集群。具体关于API的参数细节，可以参考文档
示例代码如下：
from aliyunsdkcore.client import AcsClient
from aliyunsdkcs.request.v20151215 import CreateClusterRequest
import json
client = AcsClient('', '', '')
req = CreateClusterRequest.CreateClusterRequest()
request_body= '''
{
"password": "",
"instance_type": "",
"name": "",
"size": ,
"network_mode": "",
"data_disk_category": "",
"data_disk_size": ,
"ecs_image_id": ""
}'''
req.set_content(request_body)
req.add_header('X-Acs-Region-Id', '')
status, header, res = self.client.get_response(req)
if status == 202:
js = json.loads(res)
print js['cluster_id']代码说明：
由于集群创建是异步进行的，所以当服务端接收到客户端的请求以后，就会返回http code 202，同时返回一个json串，里边包含cluster_id和request_id。
当返回的http code 不为202的时候，则会返回一个json串，里边包含了code,message,requestId等字段
获取集群列表
当集群创建完成以后，我们可以通过控制台或者API查询账号下的集群信息。在获取集群列表的API中也可以指定集群的名称进行精确匹配。详解涉及细节请参考查询集群列表文档
示例代码如下：
from aliyunsdkcs.request.v20151215 import DescribeClustersRequest
from aliyunsdkcore.client import AcsClient
import json
client = AcsClient('', '', '')
req = DescribeClustersRequest.DescribeClustersRequest()
req.set_Name('')
status, header, resp = client.get_response(req)
if status == 200:
js = json.loads(resp)
print js代码说明：
req.set_Name('') 这行代码可以不加，如果忽略的话，则会显示该用户下所有的集群实例列表；若添加，则仅精确匹配该集群名称的集群实例
status == 200 的时候表示服务器返回成功，resp中包含集群相关的字段
当status != 200的时候，则会返回一个失败的json串，里边包含了code,message,requestId等字段
获取集群详情
在很多场景下，我们需要获取某个集群的详细信息，此时则可以通过集群详情的API来实现，通过集群的ID来查询集群的详情，具体可以参考获取集群详情文档
示例代码如下：
from aliyunsdkcs.request.v20151215 import DescribeClusterDetailRequest
from aliyunsdkcore.client import AcsClient
import json
client = AcsClient('', '', '')
req = DescribeClusterDetailRequest.DescribeClusterDetailRequest()
req.set_ClusterId('')
status, header, res = client.get_response(req)
if status == 200:
js = json.loads(res)
print js对现有集群进行扩容
在集群使用的过程中，由于业务的需要，需要增加或减少(公测期间暂不支持)集群的节点数量，来实现资源利用率的最大化。具体可以参考集群扩容文档
示例代码：
from aliyunsdkcs.request.v20151215 import ScaleClusterRequest
from aliyunsdkcore.client import AcsClient
import json
client = AcsClient('', '', '')
req = ScaleClusterRequest.ScaleClusterRequest()
req.set_ClusterId('')
body = '''
{
"password": "",
"instance_type": "ECS实例类型",
"size": ,
"data_disk_category": "",
"data_disk_size": ，
"ecs_image_id": ""
}'''
req.set_content(body)
status, header, res = self.client.get_response(req)代码说明：
集群更新操作是异步进行的，当参数校验均通过的情况下，服务端会返回status == 202
关于size参数，为要更新到的最终节点数量。例如之前集群有1个节点，此时size的取值范围为[2,10]。目前支持一个集群最多一个节点
获取集群证书内容
经过前面几节的介绍，我们有了很好的集群控制能力。但是我们还缺少一个很重要的工具，用它来打通我们和容器间的通信能力，那就是集群证书。在集群创建成功以后，服务端会自动生成和用户集群相关的证书，以供用来下载来使用。 具体可以参考获取集群证书内容文档
from aliyunsdkcs.request.v20151215 import DescribeClusterCertsRequest
from aliyunsdkcore.client import AcsClient
import json
client = AcsClient('', '', '')
req = DescribeClusterCertsRequest.DescribeClusterCertsRequest()
req.set_ClusterId('')
status, header, res = self.client.get_response(req)
if status == 200:
js = json.loads(res)
print js['cert']
print js['key']
print js['ca']代码说明：
当请求返回的status == 200的时候，响应结果里会返回集群证书的内容(json串)
其中的cert是用户公钥证书内容
其中的key是用户私钥证书内容
其中的ca是认证机构证书内容
删除集群
前边介绍了那么多关于集群操作的内容。本节来介绍最后一个关于集群的操作。也是很重要的一个。当集群不在使用的时候，为了避免产生不必要的费用，我们需要及时清理掉不用的集群。具体可以参考删除集群文档
注意：集群的删除是不可逆的，一旦删除所有数据将无法恢复。务必在删除集群前进行数据备份以避免造成不必要的损失。
示例代码：
from aliyunsdkcs.request.v20151215 import DeleteClusterRequest
from aliyunsdkcore.client import AcsClient
import json
client = AcsClient('', '', '')
req = DeleteClusterRequest.DeleteClusterRequest()
req.set_ClusterId('')
status, header, res = self.client.get_response(req)代码说明：
当status == 202的时候表明集群的删除请求被成功接受，服务端将发起删除操作
总结
通过以上的内容，我们把容器服务的Open API 操作进行了一遍详细的介绍。通过以上的内容，相信大家可以快速的使用容器服务的API进行相应的开发。
