全部产品
云市场

请求结构

更新时间:2019-10-15 19:35:08

阿里云OOS API支持基于URL发起HTTP/HTTPS GET请求。请求参数需要包含在URL中。本文列举了GET请求中的结构解释,并提供了OOS的服务接入地址(Endpoint)。

结构示例

以下为CreateTemplate一条未编码的URL请求示例:

  1. https://oos.cn-hangzhou.aliyuncs.com/?Action=CreateTemplate
  2. &TemplateName=YourTemplateName
  3. &<公共请求参数>
  • https指定了请求通信协议。
  • oos.cn-hangzhou.aliyuncs.com指定了OOS的服务接入地址(Endpoint)。
  • Action=CreateTemplate指定了要调用的API,TemplateName=YourTemplateNameCreateTemplate规定的参数。
  • <公共请求参数>是系统规定的公共参数。

通信协议

支持HTTP或HTTPS协议请求通信。为了获得更高的安全性,推荐您使用HTTPS协议发送请求。
涉及敏感数据时,如用户密码和SSH密钥对,推荐使用HTTPS协议。例如,在StartExecution中指定敏感参数时。

接入地址

OOS API的服务接入地址,参见以下表格。为较少网络延时,建议您根据业务调用来源配置接入地址。
表 1. 业务调用来源来自中国大陆时的最佳地址列表

地域(部署位置) 接入地址
华东1(杭州) oos.cn-hangzhou.aliyuncs.com
华北2(北京) oos.cn-beijing.aliyuncs.com
华北5(呼和浩特) oos.cn-huhehaote.aliyuncs.com
华北3(张家口) oos.cn-zhangjiakou.aliyuncs.com
中国香港 oos.cn-hongkong.aliyuncs.com
华东2(上海) oos.cn-shanghai.aliyuncs.com
华南1(深圳) oos.cn-shenzhen.aliyuncs.com
印度(孟买) oos.ap-south-1.aliyuncs.com
美国(弗吉尼亚) oos.us-east-1.aliyuncs.com
德国(法兰克福) oos.eu-central-1.aliyuncs.com
英国(伦敦) oos.eu-west-1.aliyuncs.com

请求参数

您需要通过Action参数指定目标操作,例如Action=CreateTemplate。还需要指定接口的其他参数以及公共请求参数

字符编码

请求及返回结果都使用UTF-8字符集编码。