編輯您帳戶中擴充功能的組態資料 - AWS CloudFormation
使用動態參考所需的許可編輯擴充功能的組態資料 (主控台)編輯擴充功能的組態資料 (AWS CLI)

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

編輯您帳戶中擴充功能的組態資料

本主題提供在特定區域中編輯您帳戶內擴充功能組態資料的指引。擴充功能可以包含套用至指定帳戶和區域擴充功能之所有執行個體的組態屬性。擴充功能作者會在擴充功能的組態定義中定義這些內容。如果擴充功能組態定義中有任何所需屬性，您必須指定這些屬性，才能在帳戶和區域中使用擴充功能。

如需有關開發擴充功能時如何定義組態定義的更多資訊，請參閱下列文件。

使用動態參考所需的許可

如果組態資料包含對存儲在 AWS Systems Manager 或 AWS Secrets Manager 中值的動態參考，則任何用於佈建類型的角色 (例如，建立或更新堆疊時) 都必須具備擷取該值的適當許可。具體而言：

  • 如果組態資料包含存儲在 AWS Systems Manager Parameter Store 中的參數，則用於佈建類型的使用者或角色必須具備呼叫 GetParameter 的許可。

  • 如果組態資料包含存儲在 AWS Secrets Manager 中的密碼，則用於佈建類型的使用者或角色必須具備呼叫 GetSecretValue 的許可。

如需更多詳細資訊，請參閱 使用動態參考取得存放在其他服務中的值。

編輯擴充功能的組態資料 (主控台)

請依照本節中的步驟，使用主控台執行下列操作：

  • 檢視擴充功能的目前組態資料

  • 更新您帳戶的擴充功能組態資料

檢視擴充功能的目前組態資料

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

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

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

  4. 找到您要檢視的擴充功能。如需更多詳細資訊，請參閱 在 CloudFormation 登錄檔中檢視可用的與已啟用擴充功能。

  5. 選擇擴充功能以檢視擴充功能詳細資訊。

  6. 在擴充功能詳細資訊頁面上，選擇 Configuration (組態) 索引標籤。

  7. 展開 Configuration schema (組態結構描述) 索引標籤，以查看為擴充功能定義的組態結構描述。

  8. 展開 Configuration (組態) 索引標籤，以查看您為此擴充功能設定的目前組態。

更新擴充功能的組態資料

  1. 在擴充功能詳細資訊頁面上，從組態索引標籤中，選擇編輯組態。

    或者，從 Actions (動作) 中，選擇編輯，然後選擇編輯組態。

    CloudFormation 會顯示 Configure extension (設定擴充功能) 頁面。確保已開啟 View configuration schema (檢視組態結構描述) 以查看擴充功能目前的組態定義結構描述。

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

  3. 選擇設定擴充功能。

編輯擴充功能的組態資料 (AWS CLI)

請依照本節中的步驟，使用 AWS CLI 執行下列操作：

  • 檢視擴充功能的目前組態資料

  • 更新您帳戶的擴充功能組態資料

檢視擴充功能的目前組態資料

  • 使用 describe-type 命令傳回有關擴充功能的詳細資訊。該輸出的 ConfigurationSchema 元素包含指定區域中擴充功能的目前組態定義。

    或者，使用 batch-describe-type-configurations 命令傳回有關多個擴充功能的組態資料。

更新擴充功能的組態資料

  • 若要指定組態資料，請使用 set-type-configuration 命令。您為 --configuration 傳遞的 JSON 必須根據擴充功能的組態結構描述進行驗證。

    在下列範例中，set-type-configuration 命令會指定 --configuration 選項組態資料 "{"CredentialKey": "testUserCredential"}"。

    aws cloudformation set-type-configuration --type RESOURCE \
  --type-name My::Resource::Example \
  --configuration-alias default \
  --configuration "{"CredentialKey": "testUserCredential"}" \
  --region us-west-2