mirror of https://github.com/pulumi/pulumi.git
e1a52693dc
A resource can be imported by setting the `import` property in the resource options bag when instantiating a resource. In order to successfully import a resource, its desired configuration (i.e. its inputs) must not differ from its actual configuration (i.e. its state) as calculated by the resource's provider. There are a few interesting state transitions hiding here when importing a resource: 1. No prior resource exists in the checkpoint file. In this case, the resource is simply imported. 2. An external resource exists in the checkpoint file. In this case, the resource is imported and the old external state is discarded. 3. A non-external resource exists in the checkpoint file and its ID is different from the ID to import. In this case, the new resource is imported and the old resource is deleted. 4. A non-external resource exists in the checkpoint file, but the ID is the same as the ID to import. In this case, the import ID is ignored and the resource is treated as it would be in all cases except for changes that would replace the resource. In that case, the step generator issues an error that indicates that the import ID should be removed: were we to move forward with the replace, the new state of the stack would fall under case (3), which is almost certainly not what the user intends. Fixes #1662. |
||
|---|---|---|
| .. | ||
| 000.empty | ||
| 001.one_resource | ||
| 002.ten_resources | ||
| 003.one_complex_resource | ||
| 004.ten_complex_resources | ||
| 005.resource_thens | ||
| 006.asset | ||
| 007.promises_io | ||
| 008.ten_depends_on_resources | ||
| 009.invoke | ||
| 010.runtime_settings | ||
| 011.unhandled_error | ||
| 012.assets_archive | ||
| 013.unhandled_promise_rejection | ||
| 014.read_resource | ||
| 015.runtime_sxs | ||
| 016.promise_leak | ||
| 017.parent_defaults | ||
| 018.logging | ||
| 019.stack_exports | ||
| 020.property_dependencies | ||
| 021.parent_child_dependencies | ||
| 022.parent_child_dependencies_2 | ||
| 023.parent_child_dependencies_3 | ||
| 024.parent_child_dependencies_4 | ||
| 025.parent_child_dependencies_5 | ||
| 026.parent_child_dependencies_6 | ||
| 027.parent_child_dependencies_7 | ||
| 028.parent_child_dependencies_8 | ||
| 029.parent_child_dependencies_9 | ||
| 030.import_resource | ||
| 040.run_error | ||
| 041.component_opt_single_provider | ||
| 042.component_opt_providers_array | ||
| 043.depends_on_non_resource | ||
| 044.versions | ||
| 045.ignore_changes | ||