阿里云弹性容器实例API支持基于URL发起HTTP/HTTPS GET请求。请求参数需要包含在URL中,您需要按照接口说明在请求中加入相应请求参数,调用后系统会返回处理结果。本文为您说明GET请求中的结构要求,并提供了弹性容器实例的服务接入地址(Endpoint)。

请求结构示例

弹性容器实例API是RFC风格,其请求结构如下:
https://Endpoint/?Action=xx&Parameters
  • https:请求通信协议。支持HTTP或HTTPS协议请求通信。

    为了获得更高的安全性,推荐您使用HTTPS协议发送请求。例如,在CreateContainerGroup中指定ImageRegistryCredential.N.Password参数时,涉及用户密码等敏感数据,推荐使用HTTPS协议发送请求。

  • Endpoint:弹性容器实例API的接入地址为eci.[RegionId].aliyuncs.com
  • Action:要执行的操作。例如Action=CreateContainerGroup表示调用CreateContainerGroup创建ECI实例。
  • Parameters:请求参数,每个参数之间用and(&)分隔。

    请求参数由公共请求参数和API自定义参数组成。公共参数由系统规定。更多信息,请参见公共请求参数

以下为CreateContainerGroup的一条未编码的URL请求示例:
https://eci.aliyuncs.com/?Action=CreateContainerGroup
&ContainerGroupName=test
...
&<公共请求参数>
说明 请求需使用UTF-8字符集进行编码。上述示例仅提供示例值,实际调用中请进行URL编码。

接入地址

为减少网络延时,建议您根据业务调用来源配置接入地址。弹性容器实例API的服务接入地址如下表所示。
地域 地域ID 接入地址(Endpoint)
中心 eci.aliyuncs.com
华东 1(杭州) cn-hangzhou eci.cn-hangzhou.aliyuncs.com
华东 2(上海) cn-shanghai eci.cn-shanghai.aliyuncs.com
华北 1(青岛) cn-qingdao eci.cn-qingdao.aliyuncs.com
华北 2(北京) cn-beijing eci.cn-beijing.aliyuncs.com
华北 3(张家口) cn-zhangjiakou eci.cn-zhangjiakou.aliyuncs.com
华北 5(呼和浩特) cn-huhehaote eci.cn-huhehaote.aliyuncs.com
华南 1(深圳) cn-shenzhen eci.cn-shenzhen.aliyuncs.com
华南2(河源) cn-heyuan eci.cn-heyuan.aliyuncs.com
华南3(广州) cn-guangzhou eci.cn-guangzhou.aliyuncs.com
西南 1(成都) cn-chengdu eci.cn-chengdu.aliyuncs.com
中国(香港) cn-hongkong eci.cn-hongkong.aliyuncs.com
新加坡 ap-southeast-1 eci.ap-southeast-1.aliyuncs.com
澳大利亚(悉尼) ap-southeast-2 eci.ap-southeast-2.aliyuncs.com
马来西亚(吉隆坡) ap-southeast-3 eci.ap-southeast-3.aliyuncs.com
印度尼西亚(雅加达) ap-southeast-5 eci.ap-southeast-5.aliyuncs.com
印度(孟买) ap-south-1 eci.ap-south-1.aliyuncs.com
日本(东京) ap-northeast-1 eci.ap-northeast-1.aliyuncs.com
美国(硅谷) us-west-1 eci.us-west-1.aliyuncs.com
美国(弗吉尼亚) us-east-1 eci.us-east-1.aliyuncs.com
德国(法兰克福) eu-central-1 eci.eu-central-1.aliyuncs.com
英国(伦敦) eu-west-1 eci.eu-west-1.aliyuncs.com
说明 由于弹性容器实例提供的接入地址(Endpoint)为公网服务地址,当您的ECI实例没有分配公网带宽或者不存在公网IP地址时,无法使用阿里云CLI或者SDK等工具发起API请求。当您需要使用ECI实例作为请求端调用API时,如果ECI实例不能访问公网,您可以通过内网调用API。具体操作,请参见通过内网调用API