阿里云OOS API支持基于URL发起HTTP/HTTPS GET请求。请求参数需要包含在URL中。本文列举了GET请求中的结构解释,并提供了OOS的服务接入地址(Endpoint)。
结构示例
https://oos.cn-hangzhou.aliyuncs.com/?Action=CreateTemplate
&TemplateName=YourTemplateName
&<公共请求参数>
https
指定了请求通信协议。oos.cn-hangzhou.aliyuncs.com
指定了OOS的服务接入地址(Endpoint)。Action=CreateTemplate
指定了要调用的API,TemplateName=YourTemplateName
是CreateTemplate规定的参数。<公共请求参数>
是系统规定的公共参数。
通信协议
支持HTTP或HTTPS协议请求通信。为了获得更高的安全性,推荐您使用HTTPS协议发送请求。
涉及敏感数据时,如用户密码和SSH密钥对,推荐使用HTTPS协议。例如,在StartExecution中指定敏感参数时。
接入地址
OOS API的服务接入地址,参见以下表格。为较少网络延时,建议您根据业务调用来源配置接入地址。
华东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 |
西南1(成都) | oos.cn-chengdu.aliyuncs.com |
英国(伦敦) | oos.eu-west-1.aliyuncs.com |
印度尼西亚(雅加达) | oos.ap-southeast-5.aliyuncs.com |
马来西亚(吉隆坡) | oos.ap-southeast-3.aliyuncs.com |
澳大利亚(悉尼) | oos.ap-southeast-2.aliyuncs.com |
新加坡 | oos.ap-southeast-1.aliyuncs.com |
日本(东京) | oos.ap-northeast-1.com |
请求参数
您需要通过Action
参数指定目标操作,例如Action=CreateTemplate。还需要指定接口的其他参数以及公共请求参数。
字符编码
请求及返回结果都使用UTF-8
字符集编码。