云效 API 支持基于 URL 发起 HTTP/HTTPS GET 请求。请求参数需要包含在 URL 中。本文列举了 GET 请求中的结构解释,并提供了云效的服务接入地址(Endpoint)。
结构示例
以下为ExecutePipeline一条未编码的URL请求示例:
https://api-devops.cn-beijing.aliyuncs.com/?Action=ExecutePipeline
&OrgId=aaa&PipelineId=bbb¶ms=ccc
&<公共请求参数>
https
指定了请求通信协议。api-devops.cn-beijing.aliyuncs.com
指定了云效服务接入地址(Endpoint)。Action=ExecutePipeline
指定了要调用的API,OrgId=aaa&PipelineId=bbb¶ms=ccc是ExecutePipeline规定的参数。<公共请求参数>
是系统规定的公共参数。
通信协议
支持HTTP或HTTPS协议请求通信。为了获得更高的安全性,推荐您使用HTTPS协议发送请求。
涉及敏感数据时,如用户密码和 SSH 密钥对,推荐使用 HTTPS 协议。
接入地址
ECS API的服务接入地址,参见以下表格。为减少网络延时,建议您根据业务调用来源配置接入地址。
API i类型 | 接入地址 |
流水线相关api | api-devops.cn-beijing.aliyuncs.com |
请求参数
您需要通过Action
参数指定目标操作,例如 Action=ExecutePipeline。还需要指定接口的其他参数以及公共请求参数,详情请参见公共参数。
字符编码
请求及返回结果都使用UTF-8
字符集编码。
文档内容是否对您有帮助?