# アカウントの拡張機能の構成データを編集する
<a name="registry-set-configuration"></a>

このトピックでは、特定のリージョン内のアカウントで拡張機能の構成データを編集するためのガイダンスを提供します。拡張機能には、特定のアカウントとリージョンの拡張のすべてのインスタンスに適用される設定プロパティを含めることができます。これらは、拡張機能の作成者が拡張機能の設定定義で定義します。拡張の構成定義に必要なプロパティがある場合、アカウントとリージョンで拡張を使用する前に、それらのプロパティを指定する必要があります。

拡張機能の開発時に設定定義を定義する方法の詳細については、以下のドキュメントを参照してください。
+ [フック設定スキーマ構文リファレンス](https://docs.aws.amazon.com/cloudformation-cli/latest/hooks-userguide/hook-configuration-schema.html)
+ [拡張のアカウントレベルの構成を定義する](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-model.html#resource-type-howto-configuration)

**Topics**
+ [動的リファレンスを使用するために必要なアクセス許可](#registry-set-configuration-considerations)
+ [拡張機能の構成データを編集する (コンソール)](#registry-set-configuration-procedure-console)
+ [拡張機能の構成データを編集する (AWS CLI)](#registry-set-configuration-procedure-cli)

## 動的リファレンスを使用するために必要なアクセス許可
<a name="registry-set-configuration-considerations"></a>

構成データに、AWS Systems Manager または AWS Secrets Manager に格納されている値への動的参照が含まれている場合では、タイプをプロビジョニングするために使用されるロール (スタックの作成や更新など) には、その値を取得するための適切なアクセス許可が必要です。具体的には次のとおりです。
+ 構成データに AWS Systems Manager Parameter Store に格納されたパラメータが含まれている場合、タイプをプロビジョニングするために使用されるユーザーまたはロールには、[https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameter.html) を呼び出すためのアクセス許可が必要です。
+ 構成データに AWS Secrets Manager に格納されたシークレットが含まれている場合、タイプをプロビジョニングするために使用されるユーザーまたはロールには、[https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_GetSecretValue.html) を呼び出すための許可が必要です。

詳細については、「[動的参照を使用して他のサービスに格納されている値を取得する](dynamic-references.md)」を参照してください。

## 拡張機能の構成データを編集する (コンソール)
<a name="registry-set-configuration-procedure-console"></a>

このセクションの手順に従い、コンソールを使用して次の操作を実行します。
+ 拡張機能の現在の構成データを表示する
+ アカウントの拡張機能構成データを更新する

**拡張機能の現在の構成データを表示するには**

1. AWS マネジメントコンソール にサインインし、CloudFormation コンソール ([https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)) を開きます。

1. 画面上部にあるナビゲーションバーで、AWS リージョン を選択します。

1. ナビゲーションペインの **[レジストリ]** の下で、**[アクティブ化済みの拡張機能]** を選択します。

1. 表示する拡張機能を見つけます。詳細については、「[CloudFormation レジストリで使用可能でアクティブ化された拡張を表示する](registry-view.md)」を参照してください。

1. 拡張を選択して、拡張の詳細を表示します。

1. [extension details] (拡張の詳細) ページで、**[Configuration]** (構成) タブを選択します。

1. **[Configuration schema]** (構成スキーマ) タブを展開して、拡張に定義されている構成スキーマを確認します。

1. **[Configuration]** (構成) タブを展開して、この拡張に設定した現在の構成を確認します。

**拡張機能の構成データを更新するには**

1. 拡張の詳細ページで、[**Configuration (構成)**] タブから [**Edit configuration (構成を編集する)**] を選択します。

   または、[**アクション**] から、[**編集**] を選択し、次に [**Edit configuration (構成を編集する)**] を選択します。

   CloudFormation は、**[Configure extension]** (拡張の設定) ページを表示します。拡張の現在の構成定義スキーマを確認するには、**[View configuration schema]** (構成のスキーマの表示) がオンになっていることを確認してください。

1. **[Configuration JSON]** (構成 JSON) テキストボックスに、この拡張に設定する構成スキーマを表す JSON 文字列を入力します。**[Configuration schema]** (構成スキーマ) で定義されたスキーマに対して検証する必要があります

1. [**Configure extension (拡張の設定)**] を選択します。

## 拡張機能の構成データを編集する (AWS CLI)
<a name="registry-set-configuration-procedure-cli"></a>

このセクションの手順に従い、AWS CLI を使用して次の操作を実行します。
+ 拡張機能の現在の構成データを表示する
+ アカウントの拡張機能構成データを更新する

**拡張機能の現在の構成データを表示するには**
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html) コマンドを使用して、拡張機能の詳細情報を返します。出力の `ConfigurationSchema` 要素には、指定されたリージョンの拡張の現在の構成定義が含まれます。

  または、[https://docs.aws.amazon.com/cli/latest/reference/cloudformation/batch-describe-type-configurations.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/batch-describe-type-configurations.html) コマンドを使用して、複数の拡張に関する構成データを返します。

**拡張機能の構成データを更新するには**
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html) コマンドを使用して、構成データを指定します。`--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
  ```