- 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

Operation Description
The name of the stack group. The name must be unique within a region.
The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). The name must start with a digit or a letter.
Request Parameters
Field Name | Field Details |
---|---|
RegionIdstring | The region IDs of stack instances. You can specify a maximum of 20 region IDs. Example:cn-hangzhouReference Value Source: DescribeRegions |
StackGroupNamestring | The region IDs of stack instances. You can specify a maximum of 20 region IDs. Example:MyStackGroupReference Value Source: GetStackGroup CreateStackGroup ListStackGroups ImportStacksToStackGroup |
Descriptionstring | The structure that contains 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:My Stack Group |
AccountIdsarray<string> | 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 the RegionId parameter is used.View Details... Example:["12****"] |
RegionIdsarray<string> | The description of the operation to update the stack group. Example:["cn-hangzhou", "cn-beijing"] |
TemplateBodystring | The name of the RAM role to be assumed by the administrator account in ROS. This parameter is required if you want to grant self-managed permissions to the stack group. If you do not specify a value for this parameter, the default value AliyunROSStackGroupAdministrationRole is used. You can use the administrator role in ROS to assume the execution role AliyunROSStackGroupExecutionRole to perform operations on the stacks that correspond to stack instances in the stack group.View Details... Example:{"ROSTemplateFormatVersion": "2015-09-01"}Reference Value Source: GetTemplate UpdateStackTemplateByResources GenerateTemplateByScratch |
TemplateURLstring | The name of the RAM role to be assumed by the administrator role AliyunROSStackGroupAdministrationRole. This parameter is required if you want to grant self-managed permissions to the stack group. If you do not specify a value for this parameter, the default value AliyunROSStackGroupExecutionRole is used. You can use this role in ROS to perform operations on the stacks that correspond to stack instances in the stack group.View Details... Example:oss://ros-template/demo |
ClientTokenstring | The ID of the template. This parameter applies to shared and private templates.View Details... Example:123e4567-e89b-12d3-a456-42665544**** |
OperationDescriptionstring | The version of the template. If you do not specify a version, the latest version is used.View Details... Example:Update stack instances in hangzhou |
OperationPreferencesobject | The list of parameters. Example:{"FailureToleranceCount": 1,"MaxConcurrentCount": 2}Reference Value Source: GetStackGroupOperation |
AdministrationRoleNamestring | The key of parameter N. If you do not specify the key and value of the parameter, ROS uses the default key and value in the template.View Details... Example:AliyunROSStackGroupAdministrationRole |
ExecutionRoleNamestring | The value of parameter N.View Details... Example:AliyunROSStackGroupExecutionRole |
TemplateIdstring | The permission model.View Details... Example:5ecd1e10-b0e9-4389-a565-e4c15efc****Reference Value Source: GetTemplate UpdateTemplate ListTemplates CreateTemplate |
TemplateVersionstring | The information about automatic deployment settings.View Details... Example:v1Reference Value Source: ListTemplateVersions GetTemplate UpdateTemplate |
Parametersarray<object> | Specifies whether to enable automatic deployment.View Details... Count of Children <= 200 |
PermissionModelstring | The folder IDs in the resource directory. You can specify a maximum of five folder IDs.View Details... Example:SELF_MANAGED |
AutoDeploymentobject | The IDs of the folders in the resource directory. You can specify up to five folder IDs.View Details... Example:{"Enabled": true, "RetainStacksOnAccountRemoval": true} |
DeploymentTargetsobject | The ID of the request. Example:{"RdFolderIds": ["fd-4PvlVLOL8v"]} |
Capabilitiesarray<string> | The option for the stack group. You can specify up to one option. Count of Children <= 1 |
DeploymentOptionsarray<string> | Count of Children <= 1 |
Request Description
The description of the stack group.
The description must be 1 to 256 characters in length.
Response Parameters
Field Name | Field Details |
---|---|
RequestIdstring | The ID of the request. Example:14A07460-EBE7-47CA-9757-12CC4761D47A |
OperationIdstring | The ID of the operation. Example:6da106ca-1784-4a6f-a7e1-e723863d**** |
Response Description
The IDs of the accounts within which you want to use self-managed permissions to deploy stacks. You can specify a maximum of 20 account IDs.
Change time | Change content summary | operation | |
---|---|---|---|
2024-11-21 | addRequest parameter DeploymentOptions | ||
2024-01-11 | changeRequest parameter TemplateBody | ||
2023-05-10 | addRequest parameter Capabilities |