资源编排服务ROS(Resource Orchestration Service)接口调用是向ROS API的服务端地址发送HTTP/HTTPS GET或POST请求。您需要按照接口说明在请求中加入相应请求参数,调用后系统会返回处理结果。请求及返回结果都使用UTF-8字符集进行编码。

请求结构

ROS的API是RPC风格,您可以通过发送HTTPS GET或POST请求调用ROS API。

其请求结构如下:
http(s)://Endpoint/?Action=xx&Parameters
其中:
  • Endpoint
    • 公网接入地址:ros.aliyuncs.com,支持所有地域。
    • VPC内网接入地址:ros.vpc-proxy.aliyuncs.com。目前支持地域如下:
      地域 地域ID
      华东1(杭州) cn-hangzhou
      华东2(上海) cn-shanghai
      华北1(青岛) cn-qingdao
      华北2(北京) cn-beijing
      华北3(张家口) cn-zhangjiakou
      华北5(呼和浩特) cn-huhehaote
      华北6(乌兰察布) cn-wulanchabu
      华南1(深圳) cn-shenzhen
      华南2(河源) cn-heyuan
      华南3(广州) cn-guangzhou
      西南1(成都) cn-chengdu
      中国(香港) cn-hongkong
      美国(硅谷) us-west-1
      美国(弗吉尼亚) us-east-1
      新加坡 ap-southeast-1
      澳大利亚(悉尼) ap-southeast-2
      马来西亚(吉隆坡) ap-southeast-3
      印度尼西亚(雅加达) ap-southeast-5
      印度(孟买) ap-south-1
      日本(东京) ap-northeast-1
      德国(法兰克福) eu-central-1
      英国(伦敦) eu-west-1
      华东1金融云(杭州) cn-hangzhou-finance
      华东2金融云(上海) cn-shanghai-finance
      华南1金融云(深圳) cn-shenzhen-finance
      华北2阿里政务云1 cn-north-2-gov-1
  • Action

    要执行的操作,例如:调用ListStacks查询资源栈列表。

  • Parameters

    请求参数,每个参数之间用and(&)分隔。

    请求参数由公共参数和API自定义参数组成。公共参数中包含API版本号、身份验证等信息。更多信息,请参见公共参数

下面是一个调用ListStacks查询资源栈列表的请求示例:

http(s)://ros.aliyuncs.com/?Action=ListStacks
&RegionId=cn-hangzhou
&Format=xml
&Version=2019-09-10
&Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dg****
&SignatureMethod=HMAC-SHA1
&SignatureNonce=1521552885****
&SignatureVersion=1.0
&AccessKeyId=LTAI4GENiH2u8MVj7Khh****
&Timestamp=2020-06-01T12:00:00Z