阿里云-资源编排服务API文档-D.docxVIP

资源编排

API文档

资源编排/API

资源编排/API文档

PAGE10

PAGE10

API文档

简介

资源编排可以帮助用户对阿里云资源进行建模和配置。用户只需要创建一个描述自己所需的所有阿里云资源

（如ECS实例或RDS数据库实例）的模板，然后资源编排将根据模板创建和配置这些资源，以便用户将更多的时间花在使用阿里云资源上。资源编排具有以下特点：

简化资源的管理

如果用户想创建一个包含后端数据库的可扩展Web应用，或者一个包含几十个ECS实例的集群，需要用到

ECS，RDS，SLB，VPC，ESS等阿里云资源。通常情况下，用户需要使用单独的服务来创建这些资源，然后必须将这些资源配置为结合使用才能确保应用顺利启动，这些任务增加了使用阿里云资源的复杂性和时间成本。

使用资源编排，用户可以通过创建或者修改已有资源编排模板达到同样的目的，而且无需关心整个复杂的配置流程。例如，这个模板列出了用户所需的ECS，RDS，SLB等资源的类型、配置和数量等属性，以及各个资源之间的依赖关系。然后资源编排会解析这个模板，根据资源之间的依赖关系和详细参数依次创建每一个资源

，并将其配置为结合使用，最后确保所有的资源按照模板描述正常运行。之后用户还可以一键删除所有的资源

。

快速复制整套资源

当用户已经从资源编排创建了一个Web应用或者集群，可以重复使用已经创建的资源编排模板快速的复制整套资源。由于模板中已经记录了每个资源的属性和依赖关系，在复制整套资源时不需要再次进行配置。

API概览

堆栈相关接口

URI

Method

描述

/stacks

POST

创建堆栈

/stacks

GET

查询堆栈列表

/stacks/{StackName}/{StackId}

GET

查询堆栈信息

高速通道/API

高速通道/API使用手册

/stacks/{StackName}/{StackId}

DELETE

删除堆栈

/stacks/{StackName}/{StackId}/abandon

DELETE

废弃堆栈

资源相关接口

URI

Method

描述

/stacks/{StackName}/{StackId}/resources

GET

查询资源列表

/stacks/{StackName}/{StackId}/resources/{ResourceName}

GET

查询资源信息

/resource_types

GET

查询资源类型列表

/resource_types/

{TypeName}

GET

查询资源类型信息

/resource_types/

{TypeName}/template

GET

查询资源类型模板信息

模板相关接口

URI

Method

描述

/stacks/{StackName}/{StackId}/template

GET

查询模板信息

/validate

POST

验证模板信息

其他接口

URI

Method

描述

/stacks/{StackName}/{StackId}/events

GET

查询事件列表

更新历史

API版本：2015-09-01

最近更新时间：2015-09-01

发布事件

更新

说明

2015-09-01

版本2015-09-01第一版确定

提供了堆栈、资源、模板等操作接口

调用方式调用方式

调用方式

对ROSAPI接口调用是通过向ROSAPI的服务端地址发送HTTP/HTTPS请求，并按照接口说明在请求中加入相应请求参数来完成的；根据请求的处理情况，系统会返回处理结果。

请求结构

请求结构

服务地址

ROSAPI的服务接入地址为：

通信协议

支持通过HTTP或HTTPS通道进行请求通信。为了获得更高的安全性，推荐您使用HTTPS通道发送请求

请求方法

ROA风格的接入方式，支持HTTP或HTTPS协议。

字符编码

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

公共参数

公共参数

公共请求参数

公共请求参数是指每个接口都需要使用到的请求参数。

POST

POST/stacksHTTP/1.1x-acs-signature-method:HMAC-SHA1Authorization:acsAccessKeyId:signatureDate:Fri,11Sep201505:28:47GMT

Content-MD5:4eCVDLNDI0GRJMiZ6mLmgw==x-acs-signature-version:1.0

Accept:application/octet-stream

Content-Type:application/json;