文档

API概览

更新时间:
本产品(资源编排/2019-09-10)的OpenAPI采用RPC签名风格,签名细节参见签名机制说明我们已经为开发者封装了常见编程语言的SDK,开发者可通过下载SDK直接调用本产品OpenAPI而无需关心技术细节。如果现有SDK不能满足使用需求,可通过签名机制进行自签名对接。由于自签名细节非常复杂,需花费 5个工作日左右。因此建议加入我们的服务钉钉群(11370001915),在专家指导下进行签名对接。
在使用API前,您需要准备好身份账号及访问密钥(AccessKey),才能有效通过客户端工具(SDK、CLI等)访问API。细节请参见获取AccessKey

AI任务相关接口

API标题API概述
CreateAITask创建AI任务创建AI任务以执行特定的自动化工作流,如生成、修复模板或部署资源栈。
GetAITask查询AI任务详情指定AI任务ID,获取AI任务的详细信息。
ListAITasks查询AI任务列表查询AI任务列表。
ListAITaskEvents查询AI任务的事件查询AI任务的事件。

资源栈相关接口

API标题API概述
CreateStack创建资源栈使用资源编排模板创建资源栈,完成一组资源的创建。
DeleteStack删除资源栈删除指定资源栈,可以选择是否保留资源。
UpdateStack更新资源栈更新已创建资源栈的资源信息。
ContinueCreateStack重新创建资源栈资源栈创建失败后,继续创建资源栈。
GetStack查询资源栈信息查询资源栈信息。
ListStacks查询资源栈列表查询资源栈列表。
CancelUpdateStack取消更新资源栈当您的资源栈正处于更新中或创建中且操作尚未完成,您可以调用该接口取消更新资源栈操作。
CancelStackOperation取消资源栈操作取消资源栈操作。
SetDeletionProtection修改资源栈的删除保护属性修改资源栈的删除保护属性。
ListStackEvents查询资源栈及栈内资源的事件查询资源栈及栈内资源的事件。
ListStackOperationRisks检测资源栈操作可能涉及的风险及原因检测进行资源栈操作可能涉及的风险,并返回风险原因或缺失项。
PreviewStack预览指定模板将要创建的资源栈信息预览指定模板将要创建的资源栈信息,验证模板资源的准确性。

资源相关接口

API标题API概述
ListStackResources查询资源栈的资源列表查询指定资源栈的资源列表。
GetStackResource查询某个资源栈的资源查询某个资源栈的资源。
MoveResourceGroup修改资源所属的资源组调用MoveResourceGroup接口修改资源所属的资源组。

资源场景相关接口

API标题API概述
CreateTemplateScratch创建资源场景创建资源场景。
DeleteTemplateScratch删除资源场景删除资源场景。
UpdateTemplateScratch更新资源场景更新资源场景。
ListTemplateScratches查询资源场景列表查询资源场景列表。
GetTemplateScratch获取资源场景详情获取资源场景详情。
GenerateTemplateByScratch为资源场景生成模板为资源场景生成模板。

模板相关接口

API标题API概述
CreateTemplate创建自定义模板创建自定义模板。
DeleteTemplate删除模板删除指定模板,如果已将模板共享给其他阿里云账号,需要取消共享后才能删除。
UpdateTemplate更新模板通过指定模板地址或模板详情更新模板。
GetTemplate查询模板详情指定资源栈、资源栈组、更改集、自定义模板其中任意信息获取模板详情。
ListTemplates查询模板列表查询私有与共享的模板列表。
ListTemplateVersions查询模板的版本列表通过查询指定模板获取模板的版本列表详情。
GetTemplateParameterConstraints获取模版参数约束调用GetTemplateParameterConstraints接口查询模板参数的取值。
SetTemplatePermission共享模板或取消共享模板为指定模板设置共享或取消共享。
GetTemplateEstimateCost查询模板中创建资源的预估价格通过指定模板和模板参数查询创建资源栈的预估价格。
GetTemplateSummary获取新模板或者现有模板的信息通过指定模板、资源栈、资源栈组、更改集其中任意信息查询模板资源详情。
ValidateTemplate验证将要创建资源栈的模板通过指定模板地址或模板内容验证将要创建资源栈的模板。
GenerateTemplatePolicy生成模板所需的策略信息通过指定模板生成模板所需的策略信息。

资源栈策略相关接口

API标题API概述
SetStackPolicy设置资源栈策略为指定资源栈配置资源策略。
GetStackPolicy获取资源栈策略在一个阿里云地域下查询指定资源栈策略详情。

更改集相关接口

API标题API概述
CreateChangeSet创建更改集为资源栈创建更改集,您可以在执行更改之前查看对应更改内容。
DeleteChangeSet删除更改集为已创建更改集的资源栈删除更改集。
GetChangeSet查询更改集信息查询指定更改集信息,可以选择是否获取对应模板详情。
ListChangeSets查询更改集列表查询已创建的更改集列表详情。
ExecuteChangeSet执行更改集对资源栈执行更改集,资源变更即可生效。

资源栈组相关接口

API标题API概述
CreateStackGroup创建资源栈组使用资源编排模板创建资源栈组,通过资源栈组,可以在多个阿里云账号中跨地域创建资源栈。
DeleteStackGroup删除资源栈组删除已创建的资源栈组。
UpdateStackGroup更新资源栈组更新已创建的资源栈组。
ListStackGroups查询资源栈组列表在一个阿里云地域下查询资源栈组列表详情。
GetStackGroup查询指定资源栈组的信息在一个阿里云地域下根据资源栈组名称查询资源栈组详情。
CreateStackInstances在指定账号和地域下创建资源栈实例为一个或多个账号在指定地域下创建资源栈实例。
DeleteStackInstances删除特定账号和地域下的资源栈实例为一个或多个账号在指定地域下删除资源栈实例,可以选择是否保留资源。
UpdateStackInstances在特定账号和地域下更新资源栈实例为一个或多个账号在指定地域下更新资源栈实例。
GetStackInstance查询资源栈实例信息查询指定资源栈组关联的资源栈实例详情。
StopStackGroupOperation停止资源栈组操作停止资源栈组正在进行的操作。
ListStackInstances查询指定资源栈组关联的资源栈实例列表在一个阿里云地域下查询指定资源栈组关联的资源栈实例列表详情。
GetStackGroupOperation查询资源栈组操作的信息在一个阿里云地域下查询指定资源栈组的操作详情。
ListStackGroupOperations查询资源栈组操作列表在一个阿里云地域下查询资源栈组操作列表详情。
ListStackGroupOperationResults查询资源栈组操作结果列表在一个阿里云地域下查询指定资源栈组操作的结果列表详情。
ImportStacksToStackGroup将资源栈导入至资源栈组将多个不同账号下的资源栈导入至资源栈组。

偏差检测相关接口

API标题API概述
UpdateStackTemplateByResources修正资源栈模板通过执行偏差检测,消除资源栈的偏差。
GetStackDriftDetectionStatus查询偏差检测的状态在一个阿里云地域下根据偏差检测ID查询偏差检查状态。
ListStackResourceDrifts查询资源栈的资源偏差详情在一个阿里云地域下查询资源栈的资源偏差详情。
DetectStackDrift对资源栈进行偏差检测对资源栈进行偏差检测,可以限定具体资源,以便确定资源栈是否已偏离其预期的模板配置。
DetectStackGroupDrift对资源栈组进行偏差检测对资源栈组进行偏差检测,以便确定资源栈组是否已偏离其预期的模板配置。
DetectStackResourceDrift对资源进行偏差检测对资源进行偏差检测,以便确定资源是否已偏离其预期的模板配置。

标签相关接口

API标题API概述
TagResources为指定的资源创建并绑定标签指定一个或多个资源创建并绑定标签。
ListTagResources查询资源已经绑定的标签在一个阿里云地域下查询模板或资源栈中一个或多个资源已经绑定的标签。
ListTagKeys查询标签键在一个阿里云地域下查询资源栈或模板的标签键。
ListTagValues查询指定标签键对应的标签值在一个阿里云地域下查询模板或资源栈中指定标签键对应的标签值。
UntagResources解绑并删除标签为指定的一个或多个资源统一解绑并删除标签。

诊断相关接口

API标题API概述
CreateDiagnostic创建诊断创建诊断任务进行一键诊断。
GetDiagnostic查询诊断详情指定诊断报告ID,获取诊断的详细信息。
ListDiagnostics查询诊断列表查询诊断列表。
DeleteDiagnostic删除诊断删除诊断记录。

资源类型相关接口

API标题API概述
RegisterResourceType注册资源类型创建新的资源类型,或为已有资源类型增加一个新版本。
SetResourceType修改资源类型修改资源类型或资源类型某个版本的相关描述。
DeregisterResourceType注销资源类型删除资源类型,或删除已有资源类型的某个版本。
ListResourceTypes查询支持的资源类型列表查询支持的资源类型列表。
GetResourceTypeTemplate查询资源类型的资源模板根据资源类型生成一个示例模板。
GetResourceType查询资源类型的详细信息通过指定资源类型查询详细信息。
ListResourceTypeVersions查询资源类型版本列表查询资源类型版本列表,包括用户自己创建的和ROS提供的资源类型。
ListResourceTypeRegistrations查询资源注册记录查询资源注册记录列表。

其他相关接口

API标题API概述
DescribeRegions查询地域列表查询可选地域列表。
SignalResource发送信号您可以调用本接口对指定资源栈的资源发送信号,与ALIYUN::ROS::WaitCondition配合使用以控制资源栈的执行流程。
GetServiceProvisions查询服务开通状态查询服务开通状态和服务角色信息。
GetFeatureDetails获取特定功能的详情查询ROS支持的特定功能详情。