將現有資源納入 CloudFormation 管理

AWS CloudFormation 提供的功能可讓您透過在範本中描述現有 AWS 資源，將現有資源匯入新的或現有的堆疊。如果您想要開始使用 CloudFormation 來管理在外部建立的資源，而不必刪除並重新建立這些資源 CloudFormation，則此功能非常有用。

CloudFormation 支援匯入各種資源。如需詳細資訊，請參閱 資源類型支援。

注意

若要改為掃描現有資源並自動產生範本，以便將現有資源匯入新帳戶 CloudFormation 或複製資源，請參閱為現有資源產生範本。

主題

• 概觀
• 驗證
• 狀態碼
• 考量事項
• 其他資源
• 從現有資源建立堆疊
• 將現有資源匯入堆疊
• 還原匯入操作

資源匯入概觀

在匯入操作期間，您會建立一個變更集合，將您的現有資源匯入堆疊，或是從您現有的資源建立新堆疊。您可以在匯入期間提供以下資訊。

• 描述整個堆疊的範本，包括原始堆疊資源和您正在匯入的資源。要匯入的每個資源都必須有一個DeletionPolicy 屬性.

• 要匯入資源的識別碼。您可以提供兩個值來識別每個目標資源。

  • 識別碼屬性。這是可用來識別每個資源類型的資源屬性。例如，您可以使用 AWS::S3::Bucket 資源的 BucketName 來識別該資源。

  • 識別碼的值。這是目標資源的實際屬性值。例如，BucketName 屬性的實際值可能是 MyS3Bucket。

注意

AWS CloudFormation 僅支援使用一個巢狀層級resource import。這表示您無法將堆疊匯入子堆疊，或是匯入具有子系的堆疊。

資源匯入驗證

在匯入作業期間， CloudFormation 會執行下列驗證。

• 存在要匯入的資源。

• 每個要匯入資源的屬性和組態值都符合資源類型結構描述，該結構描述定義了其接受的屬性、必要屬性，以及支援的屬性值。

• 必要屬性會在範本中指定。中會列出每個資源類型的必要屬性AWS 資源和屬性類型參考。

• 要匯入的資源不屬於相同區域中的另一個堆疊。

CloudFormation 不檢查模板配置是否與資源屬性的實際配置匹配。

重要

驗證範本中定義的資源及其屬性是否符合資源匯入的預期組態，以避免發生未預期的變更。

資源匯入狀態碼

此表格說明搭配 resource import 使用的各種狀態類型。

匯入作業狀態	描述
IMPORT_IN_PROGRESS	匯入操作正在進行。
IMPORT_COMPLETE	已針對堆疊中的所有資源完成匯入操作。
IMPORT_ROLLBACK_IN_PROGRESS	復原匯入操作正在復原先前的範本組態。
IMPORT_ROLLBACK_FAILED	匯入復原操作失敗。
IMPORT_ROLLBACK_COMPLETE	匯入已復原先前的範本組態。

匯入操作期間的考量

• 在匯入完成且在執行後續的堆疊操作前，我們建議在匯入的資源上執行漂移偵測。漂移偵測可確保範本組態與實際組態相符。如需詳細資訊，請參閱 偵測整個 CloudFormation 堆疊上的漂移。

• 匯入操作不允許建立新資源、刪除資源，或是對屬性組態進行變更。

• 要匯入的每個資源都必須具備 DeletionPolicy 屬性，匯入操作才能成功。DeletionPolicy 可設為任何可能值。只有目標資源需要 DeletionPolicy。已經是堆疊一部分的資源不需要 DeletionPolicy。

• 您無法將相同的資源匯入多個堆疊。

• 您可以使用 cloudformation:ImportResourceTypes IAM 政策條件來控制使用者在匯入操作期間可使用的資源類型。如需詳細資訊，請參閱 AWS CloudFormation 條件。

• 匯入資源時會套用 AWS CloudFormation 堆疊限制。如需限制的詳細資訊，請參閱AWS CloudFormation 配額。

其他資源

如需重構現有堆疊案例的其他匯入指示，請參閱下列主題：

• 若要在堆疊之間移動資源，請參閱在堆疊之間移動資源。

• 若要在另一個現有堆疊中巢狀現有堆疊，請參閱〈〉巢狀現有堆疊。