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 toRetain
.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
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. |