Resource Orchestration Service:UpdateStackGroup

The ID of the region where the stack group is located. You can call the DescribeRegions operation to query the latest list of Alibaba Cloud regions.

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 must start with a digit or a letter. The name can contain digits, letters, hyphens (-), and underscores (_).

The description of the stack group.

The description must be 1 to 256 characters in length.

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 is large, pass the parameter in the request body using the HTTP POST and Body Param method to prevent request failures caused by an excessively long URL.

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. For example, the URL of an OSS bucket can be oss://ros/template/demo or oss://ros/template/demo?RegionId=cn-hangzhou. If you do not specify the region of the OSS bucket, the value of the `RegionId` parameter is used.

A 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.
The token can be up to 64 characters in length and can contain letters, digits, hyphens (-), and underscores (_).
For more information, see How to ensure idempotence.

The description of the operation to update the stack group.

The preferences for the stack group operation.

The following parameters are included:

• FailureToleranceCount

  The number of accounts in each region where stack operation failures are allowed. If the number of failed operations in a region exceeds this value, Resource Orchestration Service (ROS) stops the operations in that region. If the operation is stopped in one region, the operation is not initiated in other regions.

  The value must be an integer from 0 to 20.

  If you do not specify this parameter, 0 is used as the default value.

• FailureTolerancePercentage

  The percentage of accounts in each region where stack operation failures are allowed. If the percentage of failed operations in a region exceeds this value, ROS stops the operations in that region.

  The value must be an integer from 0 to 100. If the percentage is not an integer, ROS rounds down the percentage to the nearest integer.

  If you do not specify this parameter, 0 is used as the default value.

• MaxConcurrentCount

  The maximum number of accounts in each region where stacks are deployed at the same time.

  The value must be an integer from 1 to 20.

  If you do not specify this parameter, 1 is used as the default value.

• MaxConcurrentPercentage

  The maximum percentage of accounts in each region where stacks are deployed at the same time.

  The value must be an integer from 1 to 100. If the percentage is not an integer, ROS rounds down the percentage to the nearest integer.

  If you do not specify this parameter, 1 is used as the default value.

• RegionConcurrencyType The concurrency type of deployment regions. Valid values:

  • SEQUENTIAL (default): Deploys stacks in the specified regions sequentially. At any given time, stacks are deployed in only one region.

  • PARALLEL: Deploys stacks in all the specified regions in parallel.

Separate multiple parameters with commas (,).

The name of the RAM administrator role that is assumed by ROS. This parameter is required when you create a stack group that has self-managed permissions. If you do not specify a value, `AliyunROSStackGroupAdministrationRole` is used as the default value. ROS assumes this role to perform operations on the stacks in the stack group. ROS uses the credentials of this role to assume the execution role (`AliyunROSStackGroupExecutionRole`).

The name must be 1 to 64 characters in length and can contain letters, digits, and hyphens (-).

The name of the RAM execution role that is assumed by the administrator role (`AliyunROSStackGroupAdministrationRole`). This parameter is required when you create a stack group that has self-managed permissions. If you do not specify a value, `AliyunROSStackGroupExecutionRole` is used as the default value. ROS assumes this role to perform operations on the stacks in the stack group.

The name must be 1 to 64 characters in length and can contain letters, digits, and hyphens (-).

The ID of the template. This parameter applies to shared templates and private templates.

The version of the template. If you do not specify this parameter, the latest version is used.

The permission model.

Valid values:

• SELF_MANAGED (default): Self-managed permissions. If you use this permission model, you must create RAM roles in the administrator and member accounts so that the accounts can be associated with each other. Then, you can deploy stacks in the member accounts.

• SERVICE_MANAGED: Service-managed permissions. If you use this permission model, ROS creates service-linked roles for the administrator and member accounts. The administrator account uses the service-linked roles to deploy stacks in the member accounts.