在您的帳戶中啟用第三方公有擴充功能

啟用公有擴充功能，以便在帳戶中使用

1. 請登入 AWS 管理主控台，開啟位於 https://console.aws.amazon.com/cloudformation 的 CloudFormation 主控台。

2. 在畫面上方的導覽列上，選擇 AWS 區域。

3. 在導覽窗格的登錄檔下方，選擇公有擴充功能。

4. 使用篩選條件選擇擴充功能類型，然後選擇第三方。(AWS 發佈的擴充功能預設為已啟用。)

5. 選擇擴充功能，然後選擇啟用。

   如果擴充功能有多個版本，您可以使用版本選單選擇要啟用的擴充功能版本。預設為最新版本。

6. 對於擴充功能名稱，您可保持選取使用預設值，或選擇覆寫預設值，然後輸入要與此擴充功能搭配使用的擴充功能類型別名。別名必須遵循擴充功能類型的推薦格式。如需更多詳細資訊，請參閱 使用別名來稱呼擴充功能。

7. 若您要啟用的擴充功能是勾點或資源類型，請針對執行角色 ARN，指定 CloudFormation 在調用擴充功能時要扮演的 IAM 角色。如需更多詳細資訊，請參閱 為公有擴充功能存取設定具有 IAM 許可和信任政策的執行角色。

8. 對於記錄設定，指定擴充功能的記錄組態資訊 (若需要)。例如：

   {
       "logRoleArn": "arn:aws:iam::account:role/rolename",
       "logGroupName": "log-group-name"
   }

   記錄組態資訊不是必需的，但建議作為除錯用途使用。若要使用帶勾點的記錄組態，請新增與指定執行角色相同的信任政策，以便日誌角色可以將日誌寫入您的日誌群組。

   logRoleArn 和 logGroupName 金鑰名稱不區分大小寫。

9. 針對版本控制、自動更新，選擇接收更新的方式。

   • On (打開) – 自動更新為最新次要版本。主要版本需手動更新。

   • Off (關閉) – 永不自動更新為最新版本。所有版本需手動更新。

   如需更多詳細資訊，請參閱 自動使用擴充功能的新版本。

指定組態資料

1. 針對組態，選擇立即設定，然後選擇啟用擴充功能。

   CloudFormation 會顯示 Configure extension (設定擴充功能) 頁面。若要檢視擴充功能的目前組態結構描述，請確保已啟用 View configuration schema (檢視組態結構描述)。

2. 在組態 JSON 文字方塊中，輸入 JSON 字串，代表您要為此擴充功能指定的組態資料。您指定的 JSON 必須根據擴充功能的組態結構描述進行驗證。

3. 選擇設定擴充功能。

1. 針對組態，選擇稍後設定，然後選擇啟用擴充功能。

2. 擴充功能啟用後，您可從已啟用擴充功能頁面進入該擴充功能，並提供組態資料進行組態。

啟用公有勾點，以便在帳戶中使用 (AWS CLI)

1. 取得勾點的 ARN 並儲存。您可以使用 AWS 管理主控台 或 AWS CLI 取得勾點的 ARN。如需更多資訊，請參閱在 CloudFormation 登錄檔中檢視可用的與已啟用擴充功能。

   export HOOK_TYPE_ARN="arn:aws:cloudformation:us-west-2:123456789012:type/hook/Organization-Service-Hook/"

2. 若要指定組態資料，請使用 set-type-configuration 命令。您為 --configuration 傳遞的 JSON 必須根據勾點的組態結構描述進行驗證。若要為所有堆疊操作啟用勾點，您必須在 HookConfiguration 區段將 HookInvocationStatus 屬性設定為 ENABLED。

   aws cloudformation set-type-configuration \
     --configuration "{"CloudFormationConfiguration":{"HookConfiguration":{"HookInvocationStatus": "ENABLED", "FailureMode": "FAIL", "Properties":{}}}}" \
     --type-arn $HOOK_TYPE_ARN --region us-west-2

   如需 HookConfiguration 組態選項的詳細資訊，請參閱《CloudFormation Hooks 使用者指南》中的勾點組態結構描述語法參考。

啟用公有擴充功能，以便在帳戶中使用 (AWS CLI)

• 使用 activate-type 命令啟用擴充功能，並指定是否在發佈擴充功能的新次要版本時自動更新擴充功能。

  下列範例指定要為此帳戶啟用之公有擴充功能的公有 Amazon Resource Name (ARN)。此外，其還指定發佈新次要版本時，CloudFormation 將更新擴充功能。

  aws cloudformation activate-type \
    --public-type-arn public_extension_ARN \
    --execution-role-arn arn:aws:iam::123456789012:role/my-execution-role \
    --auto-update true --region us-west-2

  此命令會傳回已啟用擴充功能的 ARN。

  {
      "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Resource-Example"
  }