调用方式

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

请求结构

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

其请求结构如下:

https://Endpoint/?Action=xx&Parameters

其中:

  • Endpoint

    • 公网接入地址:ros.aliyuncs.com,支持所有地域。

    • VPC内网接入地址:ros.vpc-proxy.aliyuncs.com。目前支持地域如下:

      地域

      地域ID

      华东1(杭州)

      cn-hangzhou

      华东2(上海)

      cn-shanghai

      华东5(南京-本地地域)

      cn-nanjing

      华北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-3

      印度尼西亚(雅加达)

      ap-southeast-5

      菲律宾(马尼拉)

      ap-southeast-6

      泰国(曼谷)

      ap-southeast-7

      日本(东京)

      ap-northeast-1

      韩国(首尔)

      ap-northeast-2

      德国(法兰克福)

      eu-central-1

      英国(伦敦)

      eu-west-1

      阿联酋(迪拜)

      me-east-1

      华东1金融云

      cn-hangzhou-finance

      华东2金融云

      cn-shanghai-finance-1

      华南1金融云

      cn-shenzhen-finance-1

      华东6(福州-本地地域)

      cn-fuzhou

      华北2阿里政务云1

      cn-north-2-gov-1

  • Action

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

  • Parameters

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

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

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

https://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