- AI task operations
- Stack operations
- Resource operations
- Scenario operations
- Template operations
- Stack policy operations
- API operations related to change sets
- Stack group operations
- Drift detection operations
- Tag operations
- Diagnostics operations
- Resource types operations
- Other operations
JetBrains PluginOperation Description
A stack group is a collection of ROS stacks that you can manage as a unit. You can use an ROS template of a stack group to create stacks within Alibaba Cloud accounts across regions.
You can create a stack group that is granted self-managed or service-managed permissions:
- If you use an Alibaba Cloud account to create a self-managed stack group, the administrator account and the execution account are Alibaba Cloud accounts.
- If you enable a resource directory and use the management account or a delegated administrator account of the resource directory to create a service-managed stack group, the administrator account is the management account or delegated administrator account, and the execution account is a member account of the resource directory.
For more information about stack groups, see Overview .
In this topic, a stack group named MyStackGroup is created in the China (Hangzhou) region and granted the self-managed permissions. In this example, the template whose ID is 5ecd1e10-b0e9-4389-a565-e4c15efc**** is used.
Request Parameters
| Field Name | Field Details |
|---|---|
RegionIdstring | The region ID of the stack group. You can call the DescribeRegions operation to query the most recent region list. Example:cn-hangzhouReference Value Source: DescribeRegions |
StackGroupNamestring | The name of the stack group. The name must be unique within a region.<a class="workbench-show-detail toggle-down"> Example:MyStackGroupReference Value Source: GetStackGroup ListStackGroups ImportStacksToStackGroup CreateStackInstances |
Descriptionstring | The description of the stack group.<a class="workbench-show-detail toggle-down"> Example:StackGroup Description |
TemplateBodystring | The template body. The template body must be 1 to 524,288 bytes in length. If the length of the template body exceeds the upper limit, we recommend that you add parameters to the HTTP POST request body to prevent request failures caused by excessively long URLs.View Details... Example:{"ROSTemplateFormatVersion":"2015-09-01"}Reference Value Source: GetTemplate UpdateStackTemplateByResources GenerateTemplateByScratch |
TemplateURLstring | The URL of the file that contains the template body. The URL must point to a template that is located on an HTTP or HTTPS web server or in an Alibaba Cloud Object Storage Service (OSS) bucket. The template body must be 1 to 524,288 bytes in length. Examples: oss://ros/template/demo and oss://ros/template/demo?RegionId=cn-hangzhou. If you do not specify the region ID of the OSS bucket, the value of RegionId is used.View Details... Example:oss://ros-template/demo |
ClientTokenstring | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests.<a class="workbench-show-detail toggle-down"> Example:123e4567-e89b-12d3-a456-42665544**** |
AdministrationRoleNamestring | The name of the RAM role that you specify for the administrator account when you create a self-managed stack group. ROS assumes the administrator role to perform operations. If you do not specify this parameter, AliyunROSStackGroupAdministrationRole is used as the default value. ROS uses the administrator role to assume the execution role AliyunROSStackGroupExecutionRole to perform operations on the stacks in the stack group.View Details... Example:AliyunROSStackGroupAdministrationRole |
ExecutionRoleNamestring | The name of the RAM role that you specify for the execution account when you create a self-managed stack group. The administrator role AliyunROSStackGroupAdministrationRole assumes the execution role to perform operations. If you do not specify this parameter, AliyunROSStackGroupExecutionRole is used as the default value. ROS assumes the execution role to perform operations on the stacks in the stack group.View Details... Example:AliyunROSStackGroupExecutionRole |
TemplateIdstring | The ID of the template. This parameter applies to shared and private templates.View Details... Example:5ecd1e10-b0e9-4389-a565-e4c15efc****Reference Value Source: GetTemplate UpdateTemplate ListTemplates CreateTemplate |
TemplateVersionstring | The version of the template. If you do not specify this parameter, the latest version is used.View Details... Example:v1Reference Value Source: ListTemplateVersions GetTemplate UpdateTemplate |
Parametersarray<object> | The parameters of the stack group. Count of Children <= 200 |
ResourceGroupIdstring | The ID of the resource group. If you do not specify this parameter, the stack group is added to the default resource group.<a class="workbench-show-detail toggle-down"> Example:rg-acfmxazb4ph6aiy****Reference Value Source: GetStackGroup ListStackGroups |
PermissionModelstring | The permission model of the stack group.View Details... Example:SELF_MANAGED |
Tagsarray<object> | The tags of the stack group. Count of Children <= 20 |
AutoDeploymentobject | The information about automatic deployment settings.View Details... Example:{"Enabled": true, "RetainStacksOnAccountRemoval": true} |
Capabilitiesarray<string> | The options for the stack group. You can specify up to one option. Count of Children <= 1 |
StackArnstring |
Request Description
For more information about common request parameters, see Common parameters.
Response Parameters
| Field Name | Field Details |
|---|---|
RequestIdstring | The ID of the request. Example:14A07460-EBE7-47CA-9757-12CC4761D47A |
StackGroupIdstring | The ID of the stack group. Example:2c036e78-9e82-428e-afd6-177f5d04**** |