API overview

更新时间:
复制 MD 格式

API standard and pre-built SDKs in multi-language

The OpenAPI specification of this product (ROS/2019-09-10) follows the RPC standard. Alibaba Cloud provides pre-built SDKs for popular programming languages to abstract low-level complexities such as request signing. This enables developers to call APIs using language-specific syntax without dealing with HTTP details directly.

Custom signature

If your specific needs, such as a customized signature, are not supported by the SDK, manually sign requests using the signature mechanism. Note that manual signing requires significant effort (usually about 5 business days). For support, join our DingTalk group (ID: 147535001692).

Before you begin

An Alibaba Cloud account has full administrative privileges. A compromised AccessKey pair exposes all associated resources to unauthorized access, posing a significant security risk. To call APIs securely, create a Resource Access Management (RAM) user with API access only, configure its AccessKey pairs, and implement the principle of least privilege (PoLP) through RAM policies. Use the Alibaba Cloud account only when its permissions are explicitly required for specific scenarios.

Stack operations

API

Title

Description

CreateStack CreateStack Creates a stack from a ROS template to deploy a group of resources.
UpdateStack UpdateStack Updates the resources in a stack.
PreviewStack PreviewStack Previews the information about a stack that you want to create or update based on a template. You can call this operation to verify whether the template resources are valid.

Scenario operations

API

Title

Description

CreateTemplateScratch CreateTemplateScratch Creates templatescratch: scenario.

Template operations

API

Title

Description

CreateTemplate CreateTemplate Creates a custom template.
ListTemplates List Templates Queries a list of private and shared templates.
GetTemplateParameterConstraints GetTemplateParameterConstraints Queries the valid values of the parameters in a template.
ValidateTemplate ValidateTemplate Validates a template that is used to create a stack by specifying template URL or body.

API operations related to change sets

API

Title

Description

CreateChangeSet CreateChangeSet Creates a change set for a stack so you can preview changes before execution.
GetChangeSet GetChangeSet Returns details for a specified change set, optionally including the details of its associated template.
ListChangeSets ListChangeSets Queries the details of the created change sets.

Stack group operations

API

Title

Description

CreateStackGroup CreateStackGroup Creates a stack group from an ROS template to create stacks across multiple Alibaba Cloud accounts and regions.
UpdateStackGroup Update Stack Group Updates an existing stack group.
ListStackGroups ListStackGroups Queries stack groups in a region.
GetStackGroup GetStackGroup Queries the details of a stack group by its name in an Alibaba Cloud region.
CreateStackInstances CreateStackInstances Creates stack instances for one or more accounts in the specified regions.

Tag operations

API

Title

Description

TagResources TagResources Creates and adds tags to resources.
ListTagKeys ListTagKeys Queries the tag keys for stacks or templates in a specified region.

Resource types operations

API

Title

Description

SetResourceType SetResourceType Modifies the description of a resource type or a version of that type.
DeregisterResourceType DeregisterResourceType Deletes a resource type or a specific version of a resource type.
ListResourceTypes ListResourceTypes Queries the list of supported resource types.
GetResourceTypeTemplate GetResourceTypeTemplate Generates a sample template based on a resource type.
GetResourceType GetResourceType Queries a resource type, including its attributes, properties, and supported features.
ListResourceTypeVersions ListResourceTypeVersions Queries resource type versions, including versions created by you and versions provided by ROS.

Other operations

API

Title

Description

GetServiceProvisions GetServiceProvisions Queries the activation status of an Alibaba Cloud service and information about its service-linked roles.
GetFeatureDetails GetFeatureDetails Queries the details of features that are supported by Resource Orchestration Service (ROS).

Others

API

Title

Description

CancelStackOperation CancelStackOperation Cancels operations on a stack.
CancelUpdateStack CancelUpdateStack Cancels an update operation on a stack. You can call this operation to cancel an update operation on a stack when the stack is being updated or created.
ContinueCreateStack ContinueCreateStack Continues to create a stack after the stack fails to be created.
CreateAITask Create AI Task Create AI Task
CreateDiagnostic CreateDiagnostic Creates a dignosis task.
DeleteChangeSet DeleteChangeSet Deletes change sets.
DeleteDiagnostic DeleteDiagnostic Deletes a diagnostic record.
DeleteStack DeleteStack Deletes a stack, optionally retaining resources.
DeleteStackGroup DeleteStackGroup Deletes a stack group.
DeleteStackInstances DeleteStackInstances Deletes stack instances from specified accounts and regions. You can choose to retain the resources.
DeleteTemplate DeleteTemplate Deletes a template.
DeleteTemplateScratch DeleteTemplateScratch Deletes a scenario.
DescribeRegions DescribeRegions Queries a list of available regions.
DetectStackDrift DetectStackDrift Performs drift detection on resources in a stack to check whether the resources have drifted from the expected template configurations.
DetectStackGroupDrift DetectStackGroupDrift Performs drift detection on stack groups to check whether the stack groups have drifted from the expected template configurations.
DetectStackResourceDrift DetectStackResourceDrift Performs drift detection on resources in a stack to determine whether the resources have drifted from the expected configurations.
EnableServiceAccess EnableServiceAccess Enables trusted service access.
EnableServices EnableServices Enables services in a batch.
ExecuteChangeSet ExecuteChangeSet Executes change sets.
GenerateTemplateByScratch GenerateTemplateByScratch Generates a template for a resource scenario.
GenerateTemplatePolicy GenerateTemplatePolicy Generate policy information using a template.
GetAITask GetAITask Queries the information about an AI task by task ID.
GetDiagnostic GetDiagnostic Obtains the diagnosis details based on a specified diagnostic report ID.
GetServiceAccess GetServiceAccess Queries the access status of a trusted service.
GetStack GetStack Query stack information.
GetStackDriftDetectionStatus GetStackDriftDetectionStatus Queries the drift detection status of a stack.
GetStackGroupOperation GetStackGroupOperation Queries the information about a stack group operation in an Alibaba Cloud region.
GetStackInstance GetStackInstance Queries the information about a stack instance that is associated with a stack group.
GetStackPolicy GetStackPolicy Queries the stack policy of a specified stack.
GetStackResource GetStackResource For more information about common request parameters, see \\[Common parameters]\\(~~131957~~).
GetTemplate GetTemplate Queries the details of a template based on stacks, stack groups, change sets, or any custom template information.
GetTemplateEstimateCost GetTemplateEstimateCost Queries the estimated prices of the resources in a template.
GetTemplateScratch GetTemplateScratch Queries the details of a resource scenario.
GetTemplateSummary GetTemplateSummary Queries the information about a template resource by using the relevant template, stack, stack group, or change set.
ImportStacksToStackGroup ImportStacksToStackGroup Import stacks from multiple different accounts into a stack group.
ListAITaskEvents ListAITaskEvents Queries the events of an AI task.
ListAITasks ListAITasks Queries a list of AI tasks.
ListDiagnostics ListDiagnostics Queries a diagnostic report.
ListResourceTypeRegistrations ListResourceTypeRegistrations Queries the registration records of a resource.
ListStackEvents ListStackEvents Queries a stack and the resource events of the stack.
ListStackGroupOperationResults ListStackGroupOperationResults Queries the results of an operation on a stack group.
ListStackGroupOperations ListStackGroupOperations Queries the information about stack group operations in an Alibaba Cloud region.
ListStackInstances ListStackInstances Queries the list of stack instances that are associated with a stack group in an Alibaba Cloud region.
ListStackOperationRisks ListStackOperationRisks Detects stack-related operation risks and returns missing permissions and the causes of the risks.
ListStackResourceDrifts ListStackResourceDrifts The query token. Set this parameter to the NextToken value returned in the last API call.
ListStackResources ListStackResources Queries the resources in a stack. In this example, the resources in the stack whose ID is \\`4a6c9851-3b0f-4f5f-b4ca-a14bf691\\*\\*\\*\\*\\` in the China (Hangzhou) region are queried.
ListStacks ListStacks Queries a list of stacks.
ListSummaries ListSummaries Queries for an overview.
ListTagResources ListTagResources Queries the tags that are added to resources in a template or stack in an Alibaba Cloud region.
ListTagValues ListTagValues Queries the tag values that are added to resources in a template or stack in an Alibaba Cloud region.
ListTemplateScratches ListTemplateScratches Queries scenarios.
ListTemplateVersions ListTemplateVersions Queries the list of versions of a template.
MoveResourceGroup MoveResourceGroup Moves a resource to a specific resource group.
RegisterResourceType RegisterResourceType Creates a new resource type, or creates a new version for an existing resource type.
SetDeletionProtection SetDeletionProtection Modifies the deletion protection setting for a stack.
SetStackPolicy SetStackPolicy Configures a stack policy for a stack.
SetTemplatePermission SetTemplatePermission Shares or unshares a template.
SignalResource SignalResource Sends a signal to a resource in a stack.
StopStackGroupOperation StopStackGroupOperation Stops an ongoing operation in a stack group.
UntagResources UntagResources Removes tags from resources and then deletes the tags.
UpdateStackInstances UpdateStackInstances Updates stack instances for one or more accounts in specified regions.
UpdateStackTemplateByResources UpdateStackTemplateByResources Eliminates stack drifts by performing drift detection.
UpdateTemplate Update Template Update Template
UpdateTemplateScratch UpdateTemplateScratch Updates a scenario.