阿里云容器服務(wù)-API參考-D

1、容器服務(wù)API參考容器服務(wù)/API參考容器服務(wù)/API參考 PAGE 56 PAGE 56API參考簡介歡迎使用阿里云容器服務(wù)。用戶可以使用本文檔介紹的API對容器服務(wù)進(jìn)行相關(guān)操作。請確保在使用這些接口前，已充分了解了容器服務(wù)說明、使用協(xié)議和收費(fèi)方式。術(shù)語表術(shù)語全稱中文說明ClusterCluster集群用戶的容器集群，一個(gè)集群可以部署多個(gè)應(yīng)用NodeNode節(jié)點(diǎn)用戶的容器集群中的某一個(gè)節(jié)點(diǎn)，目前只支持ECS 實(shí)例ProjectProject應(yīng)用一個(gè)復(fù)雜的應(yīng)用可以由多個(gè)服務(wù)組合而成，最簡單的應(yīng)用可能只包含一個(gè)容器ServiceService服務(wù)一組基于相同鏡像和配置定義的容器，作為一個(gè)可伸縮的

2、微服務(wù)ContainerContainer容器Docker容器運(yùn)行時(shí)實(shí)例API概述容器服務(wù)API組成容器服務(wù)的API主要分為3個(gè)部分集群管理應(yīng)用管理觸發(fā)器集群管理容器服務(wù)提供了一些用于集群的管理的接口，例如創(chuàng)建集群、刪除集群等集群管理接口列表API描述GetClusterList查看所有集群實(shí)例CreateCluster創(chuàng)建集群實(shí)例DeleteCluster刪除集群實(shí)例GetClusterById查看集群實(shí)例GetClusterCerts獲取集群證書UpdateClusterSizeById更新集群節(jié)點(diǎn)數(shù)量應(yīng)用管理應(yīng)用管理的提供了Docker Remote API兼容接口，你可以像訪問單個(gè)Do

3、ckerEngine一樣，操作你的Docker集群。應(yīng)用管理接口列表API描述List Projects查看應(yīng)用實(shí)例列表Create project創(chuàng)建應(yīng)用實(shí)例Retrieve project查看應(yīng)用實(shí)例Start project啟動(dòng)應(yīng)用實(shí)例Stop project停止應(yīng)用實(shí)例Kill project終止應(yīng)用實(shí)例Update project更新應(yīng)用實(shí)例Delete project刪除應(yīng)用實(shí)例List Services查看服務(wù)實(shí)例列表Retrieve service查看服務(wù)實(shí)例Start service啟動(dòng)服務(wù)實(shí)例Stop service停止服務(wù)實(shí)例Kill service終止服務(wù)實(shí)例Scale

4、 service伸縮服務(wù)實(shí)例觸發(fā)器觸發(fā)器是容器服務(wù)中提供的簡單快捷進(jìn)行持續(xù)部署的API,詳見說明更新歷史- 最近更新時(shí)間：2016-02-04更新歷史發(fā)布時(shí)間更新說明2015-12-15第一版確定提供了集群管理的基本接口2015-02-04增加應(yīng)用相關(guān)接口提供了應(yīng)用管理的基本接口集群API調(diào)用方式調(diào)用方式對容器服務(wù)API接口調(diào)用是通過向容器服務(wù)API的服務(wù)端地址發(fā)送HTTP請求，并按照接口說明在請求中加入相 應(yīng)請求參數(shù)來完成的；根據(jù)請求的處理情況，系統(tǒng)會返回處理結(jié)果。請求結(jié)構(gòu)公共參數(shù)返回結(jié)果簽名機(jī)制請求結(jié)構(gòu)服務(wù)地址阿里云容器服務(wù)的Open API接入地址為：通信協(xié)議支持通過HTTP或HTTPS

5、通道進(jìn)行請求通信。為了獲得更高的安全性，推薦您使用HTTPS通道發(fā)送請求。請求方法使用 HTTP 的 PUT、 POST、 GET、 DELETE 等 HTTP Method 發(fā)送不同的請求。請求參數(shù)每個(gè)請求都需要包含的公共請求參數(shù)和指定操作所特有的請求參數(shù)。請求編碼請求及返回結(jié)果都使用UTF-8字符集進(jìn)行編碼。公共參數(shù)公共請求頭部公共請求參數(shù)是指每個(gè)接口都需要使用到的請求參數(shù)。參數(shù)名稱說明選項(xiàng)Authorization用于驗(yàn)證請求合法性的認(rèn)證信息， 采 用 AccessKeyId:Signature的形式RequiredContent-LengthRFC 2616中定義的HTTP請求內(nèi)容長度

6、RequiredContent-TypeRFC 2616中定義的HTTP請求內(nèi)容類型RequiredContent-MD5HTTP協(xié)議消息體的128-bit MD5散列值轉(zhuǎn)換成BASE64編碼的結(jié)果。為了防止所有請求被篡改，這里建議所有請求都附加該信息RequiredDate請求的構(gòu)造時(shí)間，目前只支持GMT格式，如果和MNS的服務(wù)器時(shí)間前后差異超過15分鐘將Required返回本次請求非法Host訪問Host值，例如：RequiredAccept客戶端需要的返回值類型，支持application/json和application/xmlRequiredx-acs-region-id地域（Reg

7、ion）指的是 ECS 實(shí)例所在的物理位置。地域概念，ECS查詢可用地域列表Requiredx-acs-signature-nonce唯一隨機(jī)數(shù)，用于防止網(wǎng)絡(luò)重放攻擊。用戶在不同請求間要使用不同的隨機(jī)數(shù)值Requiredx-acs-signature-method用戶簽名方式，目前只支持HMAC-SHA1RequiredGET /clusters HTTP/1.1 Host: Accept: application/jsonUser-Agent: cs-sdk-python/0.0.1 (Darwin/15.2.0/x86_64;2.7.10)x-acs-signature-nonce: f6

8、3659d4-10ac-483b-99da-ea8fde61eae3 Authorization: acs ACSbW2iBbyX0Pk9N:mp/6Wdr18V3qAc5gbgsqMe/iB0c x-acs-signature-version: 1.0GET /clusters HTTP/1.1 Host: Accept: application/jsonUser-Agent: cs-sdk-python/0.0.1 (Darwin/15.2.0/x86_64;2.7.10)x-acs-signature-nonce: f63659d4-10ac-483b-99da-ea8fde61eae3

9、 Authorization: acs ACSbW2iBbyX0Pk9N:mp/6Wdr18V3qAc5gbgsqMe/iB0c x-acs-signature-version: 1.0Date: Wed, 16 Dec 2015 11:18:47 GMTx-acs-signature-method: HMAC-SHA1 Content-Type: application/json;charset=utf-8 X-Acs-Region-Id: cn-beijingContent-Length: 0公共返回頭部用戶發(fā)送的每次接口調(diào)用請求，無論成功與否，系統(tǒng)都會返回一個(gè)唯一識別碼RequestId

10、給用戶。| | 4C467B38-3910-447D-87BC-AC049166F216| | | 4C467B38-3910-447D-87BC-AC049166F216| RequestId: 4C467B38-3910-447D-87BC-AC049166F216RequestId: 4C467B38-3910-447D-87BC-AC049166F216/* 返回結(jié)果數(shù)據(jù) */返回結(jié)果調(diào)用API服務(wù)后返回?cái)?shù)據(jù)采用統(tǒng)一格式，返回的HTTP狀態(tài)碼為2xx，代表調(diào)用成功；返回4xx或5xx的HTTP狀態(tài) 碼代表調(diào)用失敗。調(diào)用成功返回的數(shù)據(jù)格式主要有XML和JSON兩種，外部系統(tǒng)可以在請求時(shí)傳

11、入?yún)?shù)來制定 返回的數(shù)據(jù)格式，默認(rèn)為XML格式。本文檔中的返回示例為了便于用戶查看，做了格式化處理，實(shí)際返回結(jié)果 是沒有進(jìn)行換行、縮進(jìn)等處理的。簽名機(jī)制簽名機(jī)制說明Access Key ID和Access Key Secret由阿里云官方頒發(fā)給訪問者（可以通過阿里云官方網(wǎng)站申請和管理），其中Access Key ID用于標(biāo)識訪問者的身份；Access Key Secret是用于加密簽名字符串和服務(wù)器端驗(yàn)證簽名字符串的密鑰，必須嚴(yán)格保密，只有阿里云和用戶知道。容器服務(wù)會對每個(gè)訪問的請求進(jìn)行驗(yàn)證，每個(gè)向容器服務(wù)提交的請求，都需要在請求中包含簽名（Signature）信息。容器服務(wù)通過使用Acces

12、s Key ID和Access Key Secret進(jìn)行對稱加密的方法來驗(yàn)證請求的發(fā)送者身份。如果計(jì)算出來的驗(yàn)證碼和提供的一樣即認(rèn)為該請求是有效的；否則，容器服務(wù)將拒絕處理這次請 求，并返回HTTP403錯(cuò)誤。用戶可以在HTTP請求中增加授權(quán)（Authorization）的Head來包含簽名信息，表明這個(gè)消息已被授權(quán)。Signature = base64(hmac-sha1(VERB + n+ ACCEPT + n + Content-MD5 + nSignature = base64(hmac-sha1(VERB + n+ ACCEPT + n + Content-MD5 + n+ Cont

13、ent-Type + n+ Date + n+ CanonicalizedHeaders + n+ CanonicalizedResource)VERBHTTP的Method(如示例中：PUT)Acceptapplication/json和application/xmlContent-MD5MD5值（見下文其他事項(xiàng)3）Content-Type（見下文其他事項(xiàng)3）Date 表示此次操作的時(shí)間，不能為空，目前只支持GMT格式，如果請求時(shí)間和CAS服務(wù)器時(shí)間相差超過15分鐘，CAS會判定此請求不合法，返回400錯(cuò)誤，錯(cuò)誤信息及錯(cuò)誤碼詳見本文檔第5部分。（如 示例中：Thu,17Mar201218:4

14、9:58GMT）CanonicalizedHeadershttp中的x-acs-開始的字段組合。（見下文注意事項(xiàng)）CanonicalizedResourcehttp所請求資源的URI(統(tǒng)一資源標(biāo)識符)。（如示例中：/clusters?name=my-clusters&resource=new）注意： CanonicalizedHeaders（即x-acs-開頭的head）在簽名驗(yàn)證前需要符合以下規(guī)范:將所有以x-acs-為前綴的HTTP請求頭的名字轉(zhuǎn)換成小寫字母。如X-ACS-Meta-Name: TaoBao轉(zhuǎn)換成x-acs-meta-name: TaoBao。阿里云規(guī)范請求頭的名字是大小寫

15、不敏感的，這里建議全小寫。如果一個(gè)公共請求頭的值部分過長，則需要處理其中的t、n、r、f分隔符，將其替換成英 文半角的空格。將上一步得到的所有HTTP阿里云規(guī)范頭按照字典序進(jìn)行升序排列。刪除請求頭和內(nèi)容之間分隔符兩端出現(xiàn)的任何空格。如x-acs-meta-name:TaoBao,Alipay轉(zhuǎn)換成：x-acs-meta-name:TaoBao,Alipay。將所有的頭和內(nèi)容用n分隔符分隔拼成最后的CanonicalizedHeaders HYPERLINK /clusters?name=my-clusters&resource=new /clusters?name=my-clusters&re

16、source=new HYPERLINK /clusters?name=my-clusters&resource=new /clusters?name=my-clusters&resource=newCanonicalizedResource 應(yīng)該為：name=my-clusters + n + resource=newname=my-clusters + n + resource=new簽名示例示例概述用戶可以通過該示例，了解加簽的步驟。示例使用的 accessKeyId 和 accessKeySecret 分別為 access_key_id 和 access_key_secret。并且推薦

17、用戶使用自己的OpenAPI調(diào)用程序，來計(jì)算一下下面這個(gè)示例的加簽串。自己的加簽結(jié)果和示例結(jié)果。請求的示例如下：POST POST HYPERLINK /clusters?param1=value1¶m2=value2 /clusters?param1=value1¶m2=value2 HTTP/1.1 Accept-Encoding: identityContent-Length: 210Content-MD5: 6U4ALMkKSj0PYbeQSHqgmA= x-acs-version: 2015-12-15Accept: application/jsonUser-Agen

18、t: cs-sdk-python/0.0.1 (Darwin/15.2.0/x86_64;2.7.10)x-acs-signature-nonce: fbf6909a-93a5-45d3-8b1c-3e03a7916799 x-acs-signature-version: 1.0Date: Wed, 16 Dec 2015 12:20:18 GMTx-acs-signature-method: HMAC-SHA1 Content-Type: application/json;charset=utf-8 X-Acs-Region-Id: cn-beijingAuthorization: acs

19、access_key_id:/uA9QF5CHrr1FK3siBA4xLMTWE0=password: Just$test,instance_type: ecs.m2.medium,name: my-test-cluster-97082734,size: 1,network_mode: classic,data_disk_category: cloud,data_disk_size: 10,ecs_image_id: m-253llee3l請求構(gòu)造過程計(jì)算Content-Length和Content-MD5body:body:password:Just$test,instance_type:e

20、cs.m2.medium,name:my-test-cluster-97082734,size: 1,network_mode: classic,data_disk_category: cloud,data_disk_size: 10,ecs_image_id:m-253llee3lContent-Length: 210Content-MD5: MD5的計(jì)算過程body:body:password:Just$test,instance_type:ecs.m2.medium,name:my-test-cluster-97082734,size: 1,network_mode: classic,d

21、ata_disk_category: cloud,data_disk_size: 10,ecs_image_id:m-253llee3l# 計(jì)算body的md5值md5(body): e94e002cc90a4a3d0f61b790487aa098# 將md5值轉(zhuǎn)化成字節(jié)數(shù)組。將md5中的每兩個(gè)十六進(jìn)制位合并，轉(zhuǎn)化為一個(gè)字節(jié)。# 例如：e9 - 11111111111111111111111111101001 - -23bytes(md5(body): -23, 78, 0, 44, -55, 10, 74, 61, 15, 97, -73, -112, 72, 122, -96, -104#

22、 將得到的字節(jié)數(shù)組做一個(gè) base64 轉(zhuǎn)換base64(bytes(md5(body): 6U4ALMkKSj0PYbeQSHqgmA=Content-MD5: 6U4ALMkKSj0PYbeQSHqgmA=# 將所有x-acs-開頭的頭部列出來處理 CanonicalizedHeaders# 將所有x-acs-開頭的頭部列出來x-acs-version: 2015-12-15x-acs-signature-nonce: ca480402-7689-43ba-acc4-4d2013d9d8d4 x-acs-signature-version: 1.0 x-acs-version: 2015-

23、12-15x-acs-signature-nonce: ca480402-7689-43ba-acc4-4d2013d9d8d4 x-acs-signature-version: 1.0 x-acs-signature-method: HMAC-SHA1 X-Acs-Region-Id: cn-beijing# 將請求名字變成小寫，去掉每一行首尾的空格，并按照字典序進(jìn)行排序。刪除請求頭和內(nèi)容之間分隔符兩端出現(xiàn)的任何空格。# 注意：最后一行沒有換行符。x-acs-region-id:cn-beijingx-acs-signature-method:HMAC-SHA1x-acs-signature

24、-nonce:fbf6909a-93a5-45d3-8b1c-3e03a7916799 x-acs-signature-version:1.0 x-acs-version:2015-12-15計(jì)算 CanonicalizedResourceparam1=value1 param2=value2示例得到的CanonicalizedResource，長度應(yīng)該為27，注意第一行行尾有一個(gè)n的換行符。param1=value1 param2=value2計(jì)算 SignaturePOSTapplication/json POSTapplication/json 6U4ALMkKSj0PYbeQSHqgm

25、A=application/json;charset=utf-8 Wed, 16 Dec 2015 12:20:18 GMTx-acs-region-id:cn-beijingx-acs-signature-method:HMAC-SHA1x-acs-signature-nonce:fbf6909a-93a5-45d3-8b1c-3e03a7916799 x-acs-signature-version:1.0 x-acs-version:2015-12-15 param1=value1 param2=value2計(jì)算 SignatureaccessKeySecretaccessKeySecre

26、taccess_key_secret。hmac-sha1(SignatureString)fee03d405e421ebaf514adec881038c4b313584d# 類似Content-MD5的計(jì)算方式，將得到的加密串轉(zhuǎn)化成字節(jié)數(shù)組# 將得到的字符數(shù)組做一個(gè) base64 轉(zhuǎn)換。得到最后的簽名串。base64(bytes(hmac-sha1(SignatureString):ZmVlMDNkNDA1ZTQyMWViYWY1MTRhZGVjODgxMDM4YzRiMzEzNTg0ZA=Signature: ZmVlMDNkNDA1ZTQyMWViYWY1MTRhZGVjODgxMDM4Y

27、zRiMzEzNTg0ZA=完成POST HYPERLINK /clusters?param1=value1¶m2=value2 POST HYPERLINK /clusters?param1=value1¶m2=value2 /clusters?param1=value1¶m2=value2 HTTP/1.1 Accept-Encoding: identityContent-Length: 210Content-MD5: 6U4ALMkKSj0PYbeQSHqgmA= x-acs-version: 2015-12-15Accept: application/jsonU

28、ser-Agent: cs-sdk-python/0.0.1 (Darwin/15.2.0/x86_64;2.7.10)x-acs-signature-nonce: fbf6909a-93a5-45d3-8b1c-3e03a7916799 x-acs-signature-version: 1.0Date: Wed, 16 Dec 2015 12:20:18 GMTx-acs-signature-method: HMAC-SHA1 Content-Type: application/json;charset=utf-8 X-Acs-Region-Id: cn-beijingAuthorizati

29、on: acs access_key_id:/uA9QF5CHrr1FK3siBA4xLMTWE0=password: Just$test,instance_type: ecs.m2.medium,name: my-test-cluster-97082734,size: 1,network_mode: classic,data_disk_category: cloud,data_disk_size: 10,ecs_image_id: m-253llee3l集群API列表查看所有集群實(shí)例描述說明：查看用戶在容器服務(wù)中創(chuàng)建的所有集群。如果傳遞了name參數(shù)，則只返回指定集群的詳情。請求信息GET

30、/clusters?name=name HTTP/1.1名稱類型是否必須描述請 求 行 RequestLine 請求行參數(shù) URI ParamGET /clusters?name=name HTTP/1.1名稱類型是否必須描述namestring否集群名稱特有請求頭 RequestHead無，請參考公共請求頭部請求體 RequestBody無返回信息HTTP/1.1 200 OK返回行 ResponseLineHTTP/1.1 200 OK特有返回頭 ResponseHead無，請參考公共返回頭部agent_version: string, cluster_id: string, agent_

31、version: string, cluster_id: string, created: datetime,external_loadbalancer_id: string, master_url: string,name: string, network_mode: string, region_id: string, security_group_id: string, size: numbers,state: string, updated: datetime, vpc_id: string, vswitch_id: string返回體解釋Cluster的格式名稱類型描述agent_v

32、ersionstringAgent版本號cluster_idString集群Id，集群的唯一標(biāo)識createdstring集群的創(chuàng)建時(shí)間external_loadbalancer_idString集群負(fù)載均衡服務(wù)的Id Hyzhou：考慮刪除master_urlstring集群Master地址，你可以通過該地址連接你的集群進(jìn)行相關(guān)操作。集群連接幫助文檔namestring集群名稱，由用戶創(chuàng)建集群時(shí)指定，在每個(gè)用戶下唯一。network_modeString集群網(wǎng)絡(luò)模式（經(jīng)典網(wǎng)絡(luò): classic、VPC網(wǎng)絡(luò): vpc）region_idString集群所在地域Id，地域概念security_g

33、roup_idString安全組IDsizeString節(jié)點(diǎn)數(shù)stateString集群狀態(tài)，集群狀態(tài)列表updatedstring最后更新時(shí)間vpc_idstringvpc idvswitch_idstringvswitch id示例GET /clusters HTTP/1.1請求示例GET /clusters HTTP/1.1返回示例HTTP/1.1 200 OKHTTP/1.1 200 OKagent_version: 0.5-e56dab3,cluster_id: c978ca3eaacd3409a9437db07598f1f69, created: 2015-12-11T03:52:

34、40Z,external_loadbalancer_id: 1518f2b7e4c-cn-beijing-btc-a01, external_loadbalancer_id: 1518f2b7e4c-cn-beijing-btc-a01, master_url: 6:17589,name: my-python-cluster-039de960, network_mode: classic,region_id: cn-beijing, security_group_id: sg-25yqjuxhz, size: 5,state: running,updated: 2015-12-15T15:01

35、:58Z,vpc_id: ,vswitch_id: ,agent_version: 0.5-e56dab3,cluster_id: c1eb19e0093204cbb86c3a80334d2129e, created: 2015-12-15T14:26:58Z,external_loadbalancer_id: 151a6099de1-cn-beijing-btc-a01, master_url: 6:11905,name: my-test-cluster-002b3f3d, network_mode: classic, region_id: cn-beijing, security_grou

36、p_id: sg-25rg2ws9f, size: 1,state: running,updated: 2015-12-15T14:43:55Z,vpc_id: ,vswitch_id: 創(chuàng)建集群實(shí)例描述說明：創(chuàng)建一個(gè)新的集群實(shí)例，并新建指定數(shù)量的節(jié)點(diǎn)請求信息POST /clusters HTTP/1.1請求行 RequestLinePOST /clusters HTTP/1.1請求行參數(shù) URI Param無特有請求頭 RequestHead無，請參考公共請求頭部ClusterCreation name: string,size: number, network_mode: string,

37、subnet_cidr: string, instance_type: string, vpc_id: string, vswitch_id: string, password: string, ClusterCreation name: string,size: number, network_mode: string, subnet_cidr: string, instance_type: string, vpc_id: string, vswitch_id: string, password: string, data_disk_size: number,data_disk_catego

38、ry: number ecs_image_id: string,請求體解釋名稱類型必須描述nameString是集群名稱, 集群名稱可以使用大小寫英文字母、中文、數(shù)字、中劃線sizeint是集群ECS節(jié)點(diǎn)數(shù)量instance_typestring是ECS規(guī)格類型代碼 實(shí)例資源規(guī)格對照表network_modeString是集群網(wǎng)絡(luò)模式（經(jīng)典網(wǎng)絡(luò): classic、VPC網(wǎng)絡(luò): vpc）subnet_cidrString是集群可以使用的網(wǎng)絡(luò)地址塊，例如：/22。只有網(wǎng)絡(luò)模式為vpc的時(shí)候，才需要設(shè)置該字段vpc_idstring是VPC網(wǎng)絡(luò)Id。只有網(wǎng)絡(luò)模式為vpc的時(shí)候，才需要設(shè)置該字段VPC

39、網(wǎng)絡(luò)介紹vswitch_idstring是VPC網(wǎng)絡(luò)的交換機(jī)Id。只有網(wǎng)絡(luò)模式為vpc的時(shí)候，才需要設(shè)置該字段passwordstring是root賬號密碼，登錄data_disk_categorystring是ECS使用的磁盤類型，磁盤種類表data_disk_sizenumber是節(jié)點(diǎn)共享磁盤大小ecs_image_idstring可選ECS使用的系統(tǒng)鏡像Id。ecs_image_id 列表地域系統(tǒng)ecs_image_id北京Ubuntu 14.04 64位m-25i16eaw8北京CentOS 7.0 64位m-25ksqahve杭州Ubuntu 14.04 64位m-2313ixw4g

40、杭州CentOS 7.0 64位m-23i32bks6如果用戶需要自定義集群的ECS鏡像的ID，需要保證ECS鏡像滿足以下條件：操作系統(tǒng)：Ubuntu、CentosLinuxKernelversion3.18，用于支持overlayfs以及overlaynetwork鏡像中刪除/etc/docker/key.json文件，原因返回信息HTTP/1.1 202 Accepted返回行 ResponseLineHTTP/1.1 202 Accepted特有返回頭 ResponseHead無，請參考公共返回頭部返回體 ResponseBody cluster_id:string, request_i

41、d:string示例請求示例POST /clusters HTTP/1.1POST /clusters HTTP/1.1password: Just$test, instance_type: ecs.s2.small, name: my-cluster-001, size: 2,network_mode: classic, data_disk_category: cloud, data_disk_size: 20, charge_type: PayByTraffic, ecs_image_id:m-xx251ll返回示例HTTP/1.1 202 AcceptedHTTP/1.1 202 Acc

42、eptedcluster_id:c01994faf5f364cc79b6ffb604061fa4a, request_id:b44afc3c-46a4-4087-a215-c333a1218316刪除集群實(shí)例描述說明：根據(jù)集群Id，刪除集群實(shí)例，并釋放集群所有節(jié)點(diǎn)資源請求信息DELETE /clusters/cluster_id HTTP/1.1名稱類型是否必須DELETE /clusters/cluster_id HTTP/1.1名稱類型是否必須描述cluster_idstring是集群Id特有請求頭 RequestHead無，請參考公共請求頭部請求體 RequestBody無返回信息HTT

43、P/1.1 202 Accepted返回行 ResponseLineHTTP/1.1 202 Accepted特有返回頭 ResponseHead無，請參考公共返回頭部返回體 ResponseBody無示例DELETE /clusters/Cccfd68c474454665ace07efce924f75f HTTP/1.1DELETE /clusters/Cccfd68c474454665ace07efce924f75f HTTP/1.1返回示例HTTP/1.1 202 AcceptedHTTP/1.1 202 Accepted查看集群實(shí)例描述說明：根據(jù)集群Id，查看集群的詳細(xì)信息請求信息GE

44、T /clusters/cluster_id HTTP/1.1名稱類型是否必須GET /clusters/cluster_id HTTP/1.1名稱類型是否必須描述cluster_idstring是集群Id特有請求頭 RequestHead無，請參考公共請求頭部請求體 RequestBody無返回信息HTTP/1.1 200 OK返回行 ResponseLineHTTP/1.1 200 OK特有返回頭 ResponseHead無，請參考公共返回頭部agent_version: string, agent_version: string, cluster_id: string, created:

45、 datetime,external_loadbalancer_id: string, master_url: string,name: string,network_mode: string, region_id: string, network_mode: string, region_id: string, security_group_id: string, size: numbers,state: string, updated: datetime, vpc_id: string, vswitch_id: string返回體解釋Cluster的格式名稱類型描述agent_versio

46、nstringAgent版本號cluster_idString集群Id，集群的唯一標(biāo)識createdstring集群的創(chuàng)建時(shí)間external_loadbalancer_idString集群負(fù)載均衡服務(wù)的Id Hyzhou：考慮刪除master_urlstring集群Master地址，你可以通過該地址連接你的集群進(jìn)行相關(guān)操作。集群連接幫助文檔namestring集群名稱，由用戶創(chuàng)建集群時(shí)指定，在每個(gè)用戶下唯一。network_modeString集群網(wǎng)絡(luò)模式（經(jīng)典網(wǎng)絡(luò): classic、VPC網(wǎng)絡(luò): vpc）region_idString集群所在地域Id，地域概念security_group_

47、idString安全組IDsizeString節(jié)點(diǎn)數(shù)stateString集群狀態(tài)，集群狀態(tài)列表updatedstring最后更新時(shí)間vpc_idstringvpc idvswitch_idstringvswitch id示例GET /clusters/C5b5e80b0b64a4bf6939d2d8fbbc5ded7 HTTP/1.1請求示例GET /clusters/C5b5e80b0b64a4bf6939d2d8fbbc5ded7 HTTP/1.1HTTP/1.1 200 OkHTTP/1.1 200 Okagent_version: 0.5-e56dab3,cluster_id: c9

48、78ca3eaacd3409a9437db07598f1f69, created: 2015-12-11T03:52:40Z,external_loadbalancer_id: 1518f2b7e4c-cn-beijing-btc-a01, master_url: 6:17589,name: my-python-cluster-039de960, network_mode: classic,region_id: cn-beijing, security_group_id: sg-25yqjuxhz, size: 5,state: running,updated: 2015-12-15T15:0

49、1:58Z,vpc_id: ,vswitch_id: 獲取集群證書信息描述根據(jù)集群ID，獲取集群的證書信息。 使用Docker Client操作集群時(shí)，需要使用該證書進(jìn)行訪問。參考配置證書請求信息GET /clusters/cluster_id/certs HTTP/1.1名稱類型是否必須GET /clusters/cluster_id/certs HTTP/1.1名稱類型是否必須描述cluster_idstring是集群Id特有請求頭 RequestHead無，請參考公共請求頭部請求體 RequestBody無返回信息HTTP/1.1 200 OK返回行 ResponseLineHTTP/1

50、.1 200 OK特有返回頭 ResponseHead無，請參考公共返回頭部ca: string,ca: string,cert: string,key: string返回體解析名稱類型描述castring認(rèn)證機(jī)構(gòu)證書，ca.permcertstring用戶公鑰證書，cert.permkeystring用戶私鑰證書，key.perm示例請求示例GET /clusters/Cccfd68c474454665ace07efce924f75f/certs HTTP/1.1GET /clusters/Cccfd68c474454665ace07efce924f75f/certs HTTP/1.1HTT

51、P/1.1 200 OKHTTP/1.1 200 OKca: BEGINCERTIFICATEca contentENDCERTIFICATEn,cert: BEGINCERTIFICATEcert contentENDCERTIFICATEn,key: BEGINRSAPRIVATEKEYkey contentENDRSAPRIVATEKEYn更新集群節(jié)點(diǎn)數(shù)量描述說明：更新一個(gè)集群的節(jié)點(diǎn)數(shù)量請求信息PUT /clusters/cluster_id HTTP/1.1名稱類型是否必須PUT /clusters/cluster_id HTTP/1.1名稱類型是否必須描述cluster_idstri

52、ng是集群Id特有請求頭 RequestHead無，請參考公共請求頭部password: string, password: string, instance_type: string, size: number,data_disk_category: number data_disk_size: number,ecs_image_id: string,ecs_image_id: string,請求體解析名稱類型是否必須描述passwordstring否集群IDinstance_typeString否ECS規(guī)格類型代碼 實(shí)例資源規(guī)格對照表sizeint否集群的節(jié)點(diǎn)數(shù)量data_disk_cat

53、egoryNumber否ECS使用的磁盤類型，磁盤種類表data_disk_sizeNumber否節(jié)點(diǎn)共享磁盤大?。▎挝唬篏B）ecs_image_idString否ECS使用的系統(tǒng)鏡像Id。ecs_image_id 列表地域系統(tǒng)ecs_image_id北京Ubuntu 14.04 64位m-25i16eaw8北京CentOS 7.0 64位m-25ksqahve杭州Ubuntu 14.04 64位m-2313ixw4g杭州CentOS 7.0 64位m-23i32bks6如果用戶需要自定義集群的ECS鏡像的ID，需要保證ECS鏡像滿足以下條件：操作系統(tǒng)：Ubuntu、CentosLinuxK

54、ernelversion3.18，用于支持overlayfs以及overlaynetwork鏡像中刪除/etc/docker/key.json文件，原因返回信息HTTP/1.1 200 OK返回行 ResponseLineHTTP/1.1 200 OK特有返回頭 ResponseHead無，請參考公共返回頭部返回體 ResponseBody無示例請求示例PUT /clusters/Cccfd68c474454665ace07efce924f75f HTTP/1.1PUT /clusters/Cccfd68c474454665ace07efce924f75f HTTP/1.1password:

55、password, instance_type: ecs.s3.large, size: 2,data_disk_category: cloud_ssd data_disk_size: 500,ecs_image_id: ubuntu1404_64_20G_aliaegis_20150130.vhd,返回示例HTTP/1.1 202 Accepted應(yīng)用API調(diào)用方式調(diào)用方式HTTP/1.1 202 Accepted應(yīng)用管理REST API需要指向集群的接入點(diǎn)地址, 并通過自簽名證書的HTTPS請求和集群進(jìn)行交互。獲取集群Endpoint和證書控制臺方式訪問控制臺, 選擇指定集群的連接信息,

56、下載證書, 具體操作參考示例通過API訪問,需要將截圖里的tcp需要改成https編程方式獲取你需要先通過集群管理的API獲取:ca: string, #認(rèn)證機(jī)構(gòu)證書，ca.pem cert: string, #用戶公鑰證書，cert.pem key: string #用戶私鑰證書，key.pem字段值,詳見查看集群信息2.獲取集群的證書,詳見ca: string, #認(rèn)證機(jī)構(gòu)證書，ca.pem cert: string, #用戶公鑰證書，cert.pem key: string #用戶私鑰證書，key.pem推薦將返回結(jié)果的三個(gè)string的內(nèi)容保存為一個(gè)目錄下的三個(gè)文件ca.pem、cer

57、t.pem、key.pem。大部分的工 具或編程框架是以文件的方式加載https證書.調(diào)用應(yīng)用管理的API假設(shè)你的集群名稱為: ClusterName。并且已經(jīng)將上面三個(gè)證書存儲到 /.docker/aliyun/ClusterName 目錄下。假設(shè)上面獲得的master_url地址為: 23:1234應(yīng)用API列表詳見應(yīng)用API列表下面以查看應(yīng)用列表接口為例(context path 為/projects/)# 提示: 請注意你的curl版本, 你可能需要升級你的curl.curl方式# 提示: 請注意你的curl版本, 你可能需要升級你的curl.curlcurl-insecure-cer

58、t/.docker/aliyun/ClusterName/cert.pem-key/.docker/aliyun/ClusterName/key.pem 23:1234/projects/?php$ch = curl_init();curl_setopt($ch, CURLOPT_URL, 23:1234/projects/); curl_setopt($ch, CURLOPT_SSLKEY, /.docker/aliyun/ClusterName/key.pem); curl_setopt($ch, CURLOPT_CAINFO, /.docker/aliyun/ClusterName/ca

59、.pem); curl_setopt($ch, CURLOPT_SSLCERT, /.docker/aliyun/ClusterName/cert.pem);Python方式import requestsimport requestsres = requests.get(23:1234/projects/, verify=/.docker/aliyun/ClusterName/ca.pem, cert=(/.docker/aliyun/ClusterName/cert.pem, /.docker/aliyun/ClusterName/key.pem)print res.contentJAVA方

60、式org.apache.httpcomponentsorg.apache.httpcomponentshttpclient4.5.1org.bouncycastlebcpkix-jdk15on1.52code sampleimport java.nio.file.Path; import java.nio.file.Path; import java.nio.charset.Charset; import java.nio.file.Files;import java.nio.file.Paths; import java.security.KeyFactory;import java.sec