All Products
Search

This Product

    Resource Orchestration Service:ContinueCreateStack

    Document Center

    Resource Orchestration Service:ContinueCreateStack

    Last Updated:Oct 26, 2026

    Continues the creation of a stack after the stack creation fails.

    Operation description

    This topic provides an example on how to resume the creation of a failed stack with the ID 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** in the China (Hangzhou) region.

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

    • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

    • API: The API that you can call to perform the action.

    • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

    • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

      • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

      • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

    • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

    • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    ros:ContinueCreateStack

    update

    *stack

    acs:ros:{#regionId}:{#accountId}:stack/{#stackId}

    Template

    acs:ros:{#regionId}:{#accountId}:template/{#TemplateId}

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    StackId

    string

    Yes

    The stack ID.

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    RegionId

    string

    Yes

    The region ID of the stack. You can call the DescribeRegions operation to query the most recent region list.

    cn-hangzhou
    RamRoleName

    string

    No

    The name of the Resource Access Management (RAM) role. Resource Orchestration Service (ROS) assumes this role to create the stack and uses the credentials of the role to call API operations on behalf of the user. ROS always uses this role for subsequent operations on the stack. As long as you have permissions to perform operations on the stack, ROS uses this role even if you do not have permissions to assume the role. This ensures that the minimum permissions are granted to the role. If you do not specify this parameter, ROS uses the role that was previously associated with the stack. If no role is available, ROS uses temporary credentials generated from your user credentials. The RAM role name can be up to 64 bytes in length.

    test-role
    Mode

    string

    No

    The mode for continuing stack creation. Valid values:

    • Recreate (default): You only need to continue creating the following four types of resources. Other resources do not need to be created:

      • Resources that failed to be created.

      • Resources specified for recreation (RecreatingResources.N).

      • Resources that depend on the resources specified for recreation (RecreatingResources.N).

      • Resources that are not created.

    Note

    The RecreatingResources.N, TemplateBody, TemplateURL, and Parameters parameters take effect only in this mode.

    • Ignore:

      • Ignores and discards all resources that failed to be created and resources that are not created, and directly marks the stack as successful.

      • The template content changes.

    Note

    This mode is available only for ROS stacks.

    Recreate
    TemplateBody

    string

    No

    The structure of the template. 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 use the HTTP POST method and pass the parameter in the request body to prevent request failures caused by excessively long URLs. The following limits apply to ROS templates:

    • You can modify only the Description, Metadata, Resources, Outputs, and Rules sections of the template.

    • You cannot add or delete sections, which are the first-level elements of the template content.

    • The Resources section of the template has the following limits:

      • For resources that are not to be recreated, you can neither delete them nor modify their template content.

      • For resources that are to be recreated, you can delete them or modify their template content.

      • You can add new resources.

    Note

    • This parameter takes effect only when Mode is set to Recreate.

    • You can specify only one of the TemplateBody, TemplateURL, and TemplateId parameters. If none of these parameters are specified, the original template is used.

    {"ROSTemplateFormatVersion": "2015-09-01"}
    TemplateURL

    string

    No

    The URL of the file that contains the template body. The URL must point to a template located on an HTTP or HTTPS web server or in an Alibaba Cloud Object Storage Service (OSS) bucket, such as oss://ros/template/demo and oss://ros/template/demo?RegionId=cn-hangzhou. The template can be up to 524,288 bytes in length. If the region of the OSS bucket is not specified, the region of the OSS bucket is the same as the value of the RegionId parameter.

    Note

    • This parameter takes effect only when Mode is set to Recreate. The limits on the template are the same as those for TemplateBody.

    • You can specify only one of the TemplateBody, TemplateURL, and TemplateId parameters. If none of these parameters are specified, the original template is used.

    oss://ros-template/demo
    DryRun

    boolean

    No

    Specifies whether to only precheck the request. Valid values:

    • true: performs a precheck without performing the actual operation.

    • false (default): performs the actual operation and continues to create the stack.

    false
    TemplateId

    string

    No

    The template ID. Shared templates and private templates are supported.

    Note

    • This parameter takes effect only when Mode is set to Recreate. The limits on the template are the same as those for TemplateBody.

    • You can specify only one of the TemplateBody, TemplateURL, and TemplateId parameters. If none of these parameters are specified, the original template is used.

    5ecd1e10-b0e9-4389-a565-e4c15efc****
    TemplateVersion

    string

    No

    The template version. This parameter takes effect only when TemplateId is specified.

    v1
    RecreatingResources

    array

    No

    Resources that failed to be created will be recreated. You can specify a list of additional resources to be recreated. ROS will recreate all resources that depend on these resources.

    Note

    This parameter is available only for ROS stacks.

    WebServer

    string

    No

    Resources that failed to be created will be recreated. You can specify a list of additional resources to be recreated. ROS will recreate all resources that depend on these resources.

    Note

    This parameter is available only for ROS stacks.

    WebServer
    Parameters

    array<object>

    No

    The template parameters to override.

    object

    No

    ParameterKey

    string

    Yes

    The name of the template parameter to override. If you do not specify the name and value of a specific parameter, ROS uses the value from the previous creation. Maximum value of N: 200.

    Note

    This parameter takes effect only when Mode is set to Recreate.

    Amount
    ParameterValue

    string

    Yes

    The value of the template parameter to override. Maximum value of N: 200.

    For ROS stacks, the overridden template parameters have the following limits:

    • The override cannot cause the value of any condition in the Conditions section of the template to change from true to false or from false to true.

    • The overridden parameters cannot be referenced by resources that are not to be recreated.

    Note

    This parameter takes effect only when Mode is set to Recreate.

    12
    Parallelism

    integer

    No

    The maximum number of concurrent resources.

    Default value: empty. You can enter an integer greater than or equal to 0.

    Note

    • If you set this parameter to an integer greater than 0, the specified integer is used.

    • If you set this parameter to 0, no limit is applied to ROS stacks, and the default Terraform value (typically 10) is used for Terraform stacks.

    • If you do not specify this parameter, the value from the previous operation is used. If no value was specified in the previous operation, no limit is applied to ROS stacks, and the default Terraform value (typically 10) is used for Terraform stacks.

    • If you specify this parameter, it is associated with the stack and affects subsequent operations on the stack.

    1
    RecreatingOptions

    array

    No

    The recreation options.

    string

    No

    The recreation options. This parameter takes effect when Mode is set to Recreate. Valid values:

    • TryToFixSignalFailureByRerunEcsCommand: attempts to fix existing signal failures. When an ALIYUN::ROS::WaitCondition resource fails to be created, ROS finds the associated and successfully created ALIYUN::ECS::RunCommand and ALIYUN::ECS::Invocation resources, and recreates these resources and the resources that depend on them.

    Note

    This option takes effect only for ROS stacks.

    • IgnoreExistingSignalFailure: ignores existing signal failures. If an ALIYUN::ROS::WaitCondition resource failed to be created previously, it is directly marked as successfully created during the new creation process.

    Note

    This option takes effect only for ROS stacks.

    • AutoRecreatingResources: automatically recreates resources whose template content or referenced parameters have changed, including the resources that depend on them. This option simplifies the configuration of the RecreatingResources.N parameter, but may cause unexpected resource recreation.

    Note

    This option takes effect only for ROS stacks.

    • CreateNewPrepaidInstance: when you continue to create instances, if a resource that failed to be created or was successfully created but is specified to be recreated is of the subscription type, ROS creates a new instance.

    Note

    • This option takes effect only for ROS stacks.

    • If an old instance has been created, it is not deleted because subscription instances cannot be deleted.

    • By default (when CreateNewPrepaidInstance is not set), in this scenario, if an old instance has been created, ROS attempts to reuse the created instance. Reuse has certain limits, and resource properties are generally not allowed to be modified or only a few properties are allowed to be modified.

    CreateNewPrepaidInstance

    For more information about common request parameters, see Common parameters.

    Response elements

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    B288A0BE-D927-4888-B0F7-B35EF84B6E6
    StackId

    string

    The stack ID.

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    DryRunResult

    object

    The precheck result.

    ParametersAllowedToBeModified

    array

    The parameters that are allowed to be modified.

    string

    The parameters that are allowed to be modified. Modifying these parameters does not cause precheck errors.

    Note

    This parameter is returned only when DryRun is set to true. The result is related to Mode, Template*, RecreatingResources.N, and RecreatingOptions.N.

    description
    ParametersConditionallyAllowedToBeModified

    array

    The parameters that may be allowed to be modified.

    string

    The parameters that may be allowed to be modified.

    Whether modifying a parameter causes a precheck error depends on the value of the parameter.

    Note

    This parameter is returned only when DryRun is set to true. The result is related to Mode, Template*, RecreatingResources.N, and RecreatingOptions.N.

    name
    ParametersNotAllowedToBeModified

    array

    The parameters that are not allowed to be modified.

    string

    The parameters that are not allowed to be modified. Modifying these parameters definitely causes precheck errors.

    Note

    This parameter is returned only when DryRun is set to true. The result is related to Mode, Template*, RecreatingResources.N, and RecreatingOptions.N.

    cidr

    Examples

    Success response

    JSON format

    {
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6",
  "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****",
  "DryRunResult": {
    "ParametersAllowedToBeModified": [
      "description"
    ],
    "ParametersConditionallyAllowedToBeModified": [
      "name"
    ],
    "ParametersNotAllowedToBeModified": [
      "cidr"
    ]
  }
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.