Amazon Neptune リソースのタグ付け

&neptune; タグを使用して &neptune; リソースにメタデータを追加できます。さらに、 AWS Identity and Access Management (IAM) ポリシーでタグを使用して Neptune リソースへのアクセスを管理し、それらのリソースに適用できるアクションを制御できます。最後に、タグを使用して、類似のリソースの費用をグループ化することで、コストを追跡できます。

すべての Neptune リソースには、次のようなタグを付けることができます。

• DB インスタンス

• DB クラスター

• リードレプリカ

• DB スナップショット

• DB クラスタースナップショット

• イベントサブスクリプション

• DB パラメータグループ

• DB クラスターのパラメータグループ

• DB サブネットグループ

Neptune リソースタグの概要

Amazon Neptune タグは、Neptune リソースを定義して Neptune リソースに関連付ける名前と値のペアです。その名前はキーと呼ばれます。キーの値の指定は省略可能です。タグを使用して、Neptune リソースに任意の情報を割り当てることができます。例えば、タグキーを使用してカテゴリを定義し、タグ値をそのカテゴリのアイテムにすることができます。具体的には、「project」というタグキーと「Salix」というタグ値を定義して、Neptune リソースが Salix プロジェクトに割り当てられていることを示すことができます。また、タグキーとして environment=test や environment=production などを使用して、Neptune リソースがテスト用なのか本稼働用なのかを示すこともできます。Neptune リソースに関連付けられているメタデータの追跡が簡単になるように、一貫した一連のタグキーを使用することをお勧めします。

タグを使用して請求書を整理し AWS 、独自のコスト構造を反映します。これを行うには、サインアップして、タグキー値を含む AWS アカウント 請求書を取得します。次に、結合したリソースのコストを見るには、同じタグキー値のリソースに従って請求書情報を整理します。例えば、複数のリソースに特定のアプリケーション名のタグを付け、請求情報を整理することで、複数のサービスを利用しているアプリケーションの合計コストを確認することができます。詳細については、AWS Billing ユーザーガイド の「コスト配分タグの使用」をご参照ください。

各 Neptune リソースにはタグセットがあり、それぞれの Neptune リソースに割り当てられているすべてのタグが含まれています。タグセットには最大 10 個のタグを含めることができ、空にすることもできます。Neptune リソースに追加したタグのキーがそのリソースの既存のタグのキーと同じ場合、既存の値は新しい値によって上書きされます。

AWS はタグに意味論的意味を適用しません。タグは厳密には文字列として解釈されます。リソース作成時に使用する設定によっては、Neptune によって DB インスタンスまたは他のNeptune リソースにタグが設定されることがあります。たとえば、Neptune によって DB インスタンスが本稼働用またはテスト用であることを示すタグが追加されることがあります。

• タグキーは、必須のタグ名です。文字列値は、1〜128 文字の Unicode 文字です。「aws:」または「rds:」をプレフィックスとして使用することはできません。文字列には、一連の Unicode 文字、数字、空白、「_」、「.」、「/」、「=」、「+」、「-」 (Java 正規表現: ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$) を含めることができます。

• タグ値は、タグの省略可能な文字列値です。文字列値は、1 〜 256 文字の Unicode 文字です。「aws:」をプレフィックスとして使用することはできません。文字列には、一連の Unicode 文字、数字、空白、「_」、「.」、「/」、「=」、「+」、「-」 (Java 正規表現: ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$) を含めることができます。

  値はタグセット内で一意である必要はなく、null を指定できます。例えば、project/Trinity と cost-center/Trinity のタグセット内に 1 つのキーと値のペアを使用できます。

注記

スナップショットにタグを追加することができます。ただし、このグループは請求書に反映されません。

AWS Management Console、 AWS CLI、または Neptune API を使用して、Neptune リソースのタグを追加、一覧表示、削除できます。 AWS CLI または Neptune API を使用する場合は、使用する Neptune リソースの Amazon リソースネーム (ARN) を指定する必要があります。ARN の作成の詳細については、「Neptune 用 ARN の構築」を参照してください。

タグは承認用にキャッシュに格納されます。そのため、Neptune リソースに対するタグの追加や更新には数分かかることがあります。

Neptune でタグをコピーする

DB インスタンスを作成または復元するとき、DB インスタンスから DB インスタンスのスナップショットにタグがコピーされるように指定できます。タグをコピーすると、DB スナップショットとソース DB インスタンスのメタデータが確実に一致し、また、DB スナップショットとソース DB インスタンスのアクセスポリシーが確実に一致するようになります。タグは、デフォルトではコピーされません。

次のアクションでタグが DB スナップショットにコピーされるように指定できます。

• DB インスタンスの作成

• DB インスタンスの復元

• リードレプリカの作成。

• DB スナップショットのコピー

注記

create-db-cluster-snapshot AWS CLI コマンドの --tag-keyパラメータの値を含める (または CreateDBClusterSnapshot API アクションに少なくとも 1 つのタグを指定する) 場合、Neptune はソース DB インスタンスから新しい DB スナップショットにタグをコピーしません。これは、ソース DB インスタンスの --copy-tags-to-snapshot (CopyTagsToSnapshot) オプションが有効になっている場合でも当てはまります。

つまり、DB スナップショットから DB インスタンスのコピーを作成でき、新しい DB インスタンスに適用されないタグを追加することがありません。コマンド (または Neptune API アクション) を使用して AWS CLI create-db-cluster-snapshot DB CreateDBClusterSnapshot スナップショットを作成した後、このトピックで後述するようにタグを追加できます。

を使用した Neptune でのタグ付け AWS Management Console

Amazon Neptune リソースにタグを追加するプロセスはすべてのリソースで同様です。以下の手順では、Neptune DB インスタンスにタグを付加する方法を示します。

DB インスタンスにタグを追加するには

1. AWS マネジメントコンソールにサインインし、https://console.aws.amazon.com/neptune/home で Amazon Neptune コンソールを開きます。

2. ナビゲーションペインで、[インスタンス] を選択します。

   注記

   [インスタンス] ペインで DB インスタンスのリストをフィルタするには、[インスタンスのフィルター] ボックスの横にあるボックスにテキスト文字列を入力します。その文字列を含む DB インスタンスのみが表示されます。

3. タグを付加する DB インスタンスを選択します。

4. [Instance actions] を選択し、[See details] を選択します。

5. 詳細セクションで、下にスクロールし、[タグ] を選択します。

6. 追加を選択します。[タグの追加] ウィンドウが表示されます。

7. [タグキー] と [値] の値を入力します。

8. 別のタグを追加するには、[別のタグを追加] を選択し、[タブキー] と [値] の値を入力します。

   このステップを必要な回数繰り返します。

9. 追加を選択します。

DB インスタンスからタグを削除するには

1. AWS マネジメントコンソールにサインインし、https://console.aws.amazon.com/neptune/home で Amazon Neptune コンソールを開きます。

2. ナビゲーションペインで、[インスタンス] を選択します。

   注記

   [インスタンス] ペインで DB インスタンスのリストをフィルタするには、[インスタンスのフィルター] ボックスの横にあるボックスにテキスト文字列を入力します。その文字列を含む DB インスタンスのみが表示されます。

3. タグを付加する DB インスタンスを選択します。

4. [Instance actions] を選択し、[See details] を選択します。

5. 詳細セクションで、下にスクロールし、[タグ] を選択します。

6. 削除するタグを選択します。

7. [削除] を選択し、[タグの削除] ウィンドウで [削除] を選択します。

を使用した Neptune でのタグ付け AWS CLI

AWS CLIを使用して、Neptune で DB インスタンスのタグを追加、一覧表示、または削除できます。

• Neptune リソースに 1 つ以上のタグを追加するには、 AWS CLI コマンド を使用しますadd-tags-to-resource。

• Neptune リソースのタグを一覧表示するには、 AWS CLI コマンドを使用しますlist-tags-for-resource。

• Neptune リソースから 1 つ以上のタグを削除するには、 AWS CLI コマンドを使用しますremove-tags-from-resource。

必要な Amazon リソースネーム (ARN) を作成する方法の詳細については、「Neptune 用 ARN の構築」を参照してください。

Neptune で API を使用してタグを付ける

Neptune API を使用して DB インスタンスのタグを追加、一覧表示、または削除できます。

• Neptune リソースにタグを追加するには、AddTagsToResource オペレーションを使用します。

• Neptune リソースに割り当てられているタグを一覧表示するには、ListTagsForResource オペレーションを使用します。

• Neptune リソースからタグを削除するには、RemoveTagsFromResource オペレーションを使用します。

必要な ARN を作成する方法の詳細については、「Neptune 用 ARN の構築」をご参照ください。

Neptune API を使用して XML を操作する場合、タグでは以下のスキーマを使用します。

<Tagging>
    <TagSet>
        <Tag>
            <Key>Project</Key>
            <Value>Trinity</Value>
        </Tag>
        <Tag>
            <Key>User</Key>
            <Value>Jones</Value>
        </Tag>
    </TagSet>
</Tagging> 

以下の表に示しているのは、使用可能な XML タグとその特性のリストです。Key と Value では大文字と小文字が区別されます。たとえば、project=Trinity と PROJECT=Trinity は 2 つの別個のタグです。

タグ付け要素	説明
TagSet	タグセットは、Neptune リソースに割り当てられるすべてのタグのコンテナです。リソースごとに割り当て可能なのは 1 つのタグセットのみです。Neptune API によってのみ TagSet を操作できます。
Tag	タグはユーザー定義のキーと値のペアです。1～50 個のタグをタグセットに含めることができます。
Key	キーはタグの必須の名前です。文字列値は、1〜128 文字の Unicode 文字です。「rds:」または「aws:」をプレフィックスとして使用することはできません。文字列には、一連の Unicode 文字、数字、空白、「_」、「.」、「/」、「=」、「+」、「-」 (Java 正規表現: ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$) を含めることができます。 キーはタグセットに対して一意である必要があります。たとえば、タグセットでキーが同じで値が異なるキーと値のペアは使用できません。たとえば、project/Trinity や project/Xanadu は使用できません。
値	値はタグの省略可能な値です。文字列値は、1 〜 256 文字の Unicode 文字です。「rds:」または「aws:」をプレフィックスとして使用することはできません。文字列には、一連の Unicode 文字、数字、空白、「_」、「.」、「/」、「=」、「+」、「-」 (Java 正規表現: ^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-]*)$) を含めることができます。 値はタグセット内で一意である必要はなく、null を指定できます。例えば、project/Trinity と cost-center/Trinity のタグセット内に 1 つのキーと値のペアを使用できます。