All Products
Search
Document Center

Resource Orchestration Service:Overview

Last Updated:Jan 26, 2024

The resource import feature can help you import existing resources to a stack to manage and orchestrate the resources in a centralized manner.

Term

Resource import allows you to import existing resources and their configurations to stacks in Resource Orchestration Service (ROS). You must use the resource import feature together with change sets.

Sample scenarios

Use resource import to create a stack

If you want to manage a large number of cloud resources at the same time, you can use resource import to add the cloud resources to a new stack. This way, you can use the stack to manage the cloud resources in a centralized manner and reduce manual intervention.

For more information, see Import an existing resource to create a stack.

Use resource import to update a stack

If an empty stack exists in the ROS console or a stack in the ROS console contains cloud resources that you want to manage, you can use resource import to add desired resources to the stack for centralized management.

For more information, see Import an existing resource to update a stack.

Considerations

  • Make sure that the template that you want to use for resource import is valid.

    • The template must contain the original resources in the stack and the resources that you want to import to the stack. The resources that you want to import must be already created. To prevent the resources that you want to import from being unexpectedly deleted, you must set the DeletionPolicy property of the resources to Retain.

    • The resource types must support the properties and values of the resources that you want to import.

    • The required properties for each resource type must be specified in the template.

  • Obtain the identifier property and value of the resource that you want to import.

    For more information, see Obtain a resource identifier property for resource import.

  • Validate the accuracy of the template configurations.

    After you import the resources, we recommend that you detect drift on the resources to ensure that the actual resource configurations are consistent with the template configurations. For more information, see Detect drift on a stack.

Limits

  • The resource import operation must comply with limits on stacks. For more information, see Limits.

  • The same resource of specific resource types cannot be imported to multiple stacks for several times. For more information about the resource types, see Resource types that support drift detection and resource import.

    Alibaba Cloud service

    Resource type

    API Gateway

    • ALIYUN::ApiGateway::Api

    • ALIYUN::ApiGateway::App

    • ALIYUN::ApiGateway::Group

    Alibaba Cloud DNS (DNS)

    ALIYUN::DNS::DomainRecord

    Elastic Compute Service (ECS)

    • ALIYUN::ECS::Snapshot

    • ALIYUN::ECS::VPC

    • ALIYUN::ECS::VSwitch

    Auto Scaling

    • ALIYUN::ESS::ScalingConfiguration

    • ALIYUN::ESS::ScalingRule

    Function Compute

    • ALIYUN::FC::CustomDomain

    • ALIYUN::FC::Function

    • ALIYUN::FC::Service

    • ALIYUN::FC::Trigger

    ApsaraDB for MongoDB

    ALIYUN::MONGODB::Instance

    Apsara File Storage NAS (NAS)

    ALIYUN::NAS::FileSystem

    ApsaraDB RDS

    ALIYUN::RDS::DBInstance

    ApsaraDB for Redis

    ALIYUN::REDIS::Instance

    Server Load Balancer (SLB)

    ALIYUN::SLB::MasterSlaveServerGroup

    Simple Log Service

    ALIYUN::SLS::Project

    Virtual Private Cloud (VPC)

    • ALIYUN::VPC::NatGateway

    • ALIYUN::VPC::SnatEntry

Resource types that support resource import

For more information about the resource types, see Resource types that support drift detection and resource import.

Status related to resource import

Stack status

State

Description

IMPORT_CREATE_IN_PROGRESS

The stack is being created by using imported resources.

IMPORT_CREATE_FAILED

The stack fails to be created by using imported resources.

IMPORT_CREATE_COMPLETE

The stack is created by using imported resources.

IMPORT_CREATE_ROLLBACK_IN_PROGRESS

The resources are being rolled back after the stack fails to be created by using imported resources.

IMPORT_CREATE_ROLLBACK_FAILED

The resources fail to be rolled back after the stack fails to be created by using imported resources.

IMPORT_CREATE_ROLLBACK_COMPLETE

The resources are rolled back after the stack fails to be created by using imported resources.

IMPORT_UPDATE_IN_PROGRESS

The stack is being updated by using imported resources.

IMPORT_UPDATE_FAILED

The stack fails to be updated by using imported resources.

IMPORT_UPDATE_COMPLETE

The stack is updated by using imported resources.

IMPORT_UPDATE_ROLLBACK_IN_PROGRESS

The resources are being rolled back after the stack fails to be updated by using imported resources.

IMPORT_UPDATE_ROLLBACK_FAILED

The resources fail to be rolled back after the stack fails to be updated by using imported resources.

IMPORT_UPDATE_ROLLBACK_COMPLETE

The resources are rolled back after the stack fails to be updated by using imported resources.

Resource status

State

Description

IMPORT_IN_PROGRESS

The resource is being imported.

IMPORT_FAILED

The resource fails to be imported.

IMPORT_COMPLETE

The resource is imported.

References