セグメントへの物件ターゲティング

SDK を使用すると、プロパティーを作成して管理したり、コレクションに追加したり、アプリで使用したりすることができます。 これらは、 Terraform プラグイン または CLI を使用してインフラストラクチャー内で使用できます。 プロパティーを使用すると、App Configuration を使用して、インフラストラクチャーまたはアプリケーションの構成プロパティーを一元管理できます。

デフォルトでは、プロパティウィンドウには、現在の App Configuration サービスインスタンスの環境内のすべてのプロパティがリスト表示されます。 各プロパティの属性として 、名前、 最終更新日時 、最終評価日時 、対象セグメント、 タイプが表示されます。

プロパティー・タイプ:

  • **「ブール値」**タイプには 2 つの値があり、デフォルト値を「true」または「false」に設定できます。

  • **「文字列」**タイプのプロパティーは、テキスト形式のデータ、および JSON ファイルまたは YAML ファイルをサポートします。

  • 「数値」 プロパティーは、整数値をサポートします。

  • 「シークレットの参照」 プロパティーは、 Secrets Manager 統合をサポートします。

    「シークレット参照」 プロパティーを選択するには、シークレット・マネージャー・インスタンスが作成または存在するリソース・グループに対するビューアー権限を持つ Secrets Manager インスタンスが必要です。 また、 Secrets Manager インスタンスに対するリーダー権限を持っている必要があります。

プロパティーのユース・ケースの例としては、特定のリージョンのアプリケーションのインスタンス数を決定する場合があります。 App Configuration でプロパティを作成し、タイプを数値として、地域値に基づいてセグメントを割り当てます。

物件リスト
リスト*物件リスト
物件リスト

プロパティーの作成

プロパティーを作成するには、以下の手順を実行します。

  1. App Configuration コンソールで、**「プロパティー」**をクリックします。

  2. 「現在の環境」 を選択して、その環境のプロパティーのリストを表示します。

  3. 「作成」 をクリックします。 サイドパネルを開くと、新しいプロパティを作成するためのフィールドが表示されます。

    caption-side=bottom"
    プロパティの新規作成

  4. プロパティーの詳細を指定します。

    • 名前 - プロパティーの名前。
    • プロパティー ID - 入力されたプロパティー名に基づいてプロパティー ID 値が自動的に提案されます。 同じものは必要に応じて変更することができます。 この**「プロパティー ID」**値を SDK または API コードで ID として使用します。
    • プロパティー・タイプ - プロパティーのタイプを指定します。 サポートされるタイプには、ブール値、ストリング、数値、およびシークレットの参照が含まれます。 プロパティー・タイプとデフォルト値について詳しくは、 プロパティー・タイプの選択 を参照してください。
    • デフォルト値 - 選択したプロパティー・タイプのデフォルト値を指定します。 詳しくは、 プロパティー・タイプの選択 を参照してください。
    • 必要に応じて、**「コレクションに追加 (Add to collection)」**リストで選択することによって、1 つ以上のコレクションにプロパティーを追加できます。
    • 説明 - プロパティーの説明を追加します。これはオプションです。
    • オプションで、プロパティーの識別に役立つ タグ を定義します。

  5. 「作成」 をクリックします。

プロパティー・タイプの選択

以下のいずれかのプロパティー・タイプをプロパティーに関連付けることができます。

  • ブール値
  • ストリング
  • 数値
  • シークレット参照

各プロパティー・タイプには、デフォルト値があります。

  • **「プロパティー値」**に値は必須ですが、これはセグメントをターゲットにするときにオーバーライドできます。

ブール値

**「プロパティー・タイプ」としてブール値 を選択すると、「デフォルト値」**の詳細が表示されます。

![プロパティタイプ - Booleanプロパティタイプを"){: caption="として](images/ac-property-boolean.png "するプロパティタイプ -" caption-side="bottom"}

  1. リストから 「プロパティー値」 (True または False) を選択します。 この値はデフォルトで返され、セグメントをターゲットにするときにオーバーライドできます。

ストリング

**「プロパティー・タイプ」としてストリング を選択すると、「デフォルト値」**の詳細が表示されます。

プロパティタイプ - 文字
列で選択*プロパティタイプ -
列

  1. 「デフォルト値」 を指定します。 この値はデフォルトで返され、セグメントをターゲットとするときにオーバーライドされます。

    • フォーマット: リストからストリング・タイプのフォーマットを選択します。 オプションは、テキスト、JSON、および YAML です。
    • プロパティー値: 選択した形式に基づいてプロパティー値を指定します。

数値

**「プロパティー・タイプ」として数値 を選択すると、「デフォルト値」**の詳細が表示されます。

プロパティタイプ - 数値*プロパティタイプを数値として
プロパティタイプ -

  1. **「プロパティー値」**を指定します。 この値はデフォルトで返され、セグメントをターゲットにするときにオーバーライドできます。

シークレット参照

「プロパティー・タイプ」 として *「シークレット参照」*を選択すると、 Secrets Manager インスタンス、 および 「デフォルト値」 の詳細が表示されます。

プロパティタイプ - 秘密参照*プロパティタイプを秘密参照として
プロパティタイプ - 秘密参照

  1. 値をプルする必要がある Secrets Manager インスタンス 情報を指定します。

    • リソース・グループ: 使用する Secrets Manager インスタンスが存在するリソース・グループを選択します。
    • Secrets Manager インスタンス: 指定されたプロパティーに使用する Secrets Manager インスタンスを選択します。

  2. 「デフォルト値」 を指定します。 この値はデフォルトで返され、セグメントをターゲットにするときにオーバーライドできます。

    • シークレット・タイプ: リストからシークレット・タイプを選択します。 シークレット・タイプについて詳しくは、 さまざまなタイプのシークレットの処理を参照してください。
    • シークレット名: ドロップダウンからシークレット名を選択します。

コレクションのターゲット・プロパティーの設定

プロパティーの作成時、またはプロパティーの詳細の編集時に、1 つ以上のコレクションにプロパティーを追加できます。

プロパティーにコレクションを追加する場合は、**「複数のコレクションにわたる可用性 (Availability across collections)」**フィールドで、リストからコレクションを選択します。

コレクションにリンクされていないプロパティをターゲットにしようとすると、コレクションにプロパティを追加するウィンドウが表示されます。

プロパティーを指定してターゲット・セグメントを設定

プロパティーを 1 つ以上のターゲット・セグメントにロールアウトできます。 必要に応じて、プロパティー値ごとに異なるセグメントを設定できます。

  1. App Configuration コンソールから、 「プロパティー」 に移動して、 App Configuration サービス・インスタンスの現在の環境で使用可能なプロパティーのリストを表示します。

  2. 必要なプロパティー行で 「ターゲットの追加」 をクリックして、 「ターゲット・プロパティーをセグメントに追加」 サイド・パネルを表示します。

    ![セグメントへのターゲットプロパティへの](images/ac-property-to-segments.png "" caption-side="bottom"}への"){: caption="

  3. リストからセグメントを選択します。 ターゲットに使用できるセグメントがない場合は、 「セグメントの作成」 をクリックします。 セグメントの作成について詳しくは、 セグメントの作成 を参照してください。

  4. プロパティ値 （プロパティから継承または上書き）を選択します。

  5. **「ルールの保存」**をクリックして、ルールに対する変更内容を保存します。

  6. **「ターゲット設定の追加 (Add targeting)」**をクリックします。

コレクションにリンクされていないプロパティをターゲットにしようとすると、コレクションにプロパティを追加するウィンドウが表示されます。

プロパティー - オーバーフロー・メニュー

各プロパティーのオーバーフロー・メニュー (3 つの垂直ドット) は、**「編集」操作、「コピー」操作、「削除」操作と、既にターゲットに設定されているプロパティーの「ターゲット設定の削除 (Remove targeting)」**で構成されています。

![プロパティのオーバーフローメニュー](images/ac-property-overflow-menu.png "プロパティのオーバーフローメニュー" caption-side="bottom"}プロパティの"){: caption="

  • 「編集」 を選択すると 、「名前」 と 「説明」 の変更、 タグの追加または削除、 プロパティの種類とデフォルト値の変更、および 「コレクションにわたる可用性」 フィールド情報のコレクションの追加または削除を行うことができます。
  • コピー が選択された場合、プロパティ情報がコピーされ、 プロパティの名前を変更する必要があります。 必要に応じて他の詳細を変更できます。
  • 削除が選択されると、選択されたプロパティを削除する確認を求める確認ウィンドウが表示されます。 オプションを削除すると、プロパティーが完全に削除され、アクションを元に戻せません。
  • プロパティーのリスト内のプロパティーで**「クリップボードにコピー」アイコンをクリックすると、プロパティーのプロパティー ID** 値がクリップボードにコピーされます。
  • 「ターゲティングの削除」 によって、セグメントに対するプロパティーのターゲット設定は解除されます。