

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Neptune リソースのタグ付け
<a name="tagging"></a>

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

すべての Neptune リソースには、次のようなタグを付けることができます。
+ DB インスタンス
+ DB クラスター
+ リードレプリカ
+ DB スナップショット
+ DB クラスタースナップショット
+ イベントサブスクリプション
+ DB パラメータグループ
+ DB クラスターのパラメータグループ
+ DB サブネットグループ



## Neptune リソースタグの概要
<a name="tagging-overview"></a>

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

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

各 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 マネジメントコンソール、 AWS CLI、または Neptune API を使用して、Neptune リソースのタグを追加、一覧表示、削除できます。 AWS CLI または Neptune API を使用する場合は、操作する Neptune リソースの Amazon リソースネーム (ARN) を指定する必要があります。ARN の作成の詳細については、「[Neptune 用 ARN の構築](tagging-arns-constructing.md)」を参照してください。

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

### Neptune でタグをコピーする
<a name="tagging-copying"></a>

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

次のアクションでタグが DB スナップショットにコピーされるように指定できます。
+ DB インスタンスの作成
+ DB インスタンスの復元
+ リードレプリカの作成。
+ DB スナップショットのコピー

**注記**  
[create-db-cluster-snapshot](https://docs.aws.amazon.com/cli/latest/reference/neptune/create-db-cluster-snapshot.html) AWS CLI コマンドの `--tag-key`パラメータの値を含める場合 (または [CreateDBClusterSnapshot](api-snapshots.md#CreateDBClusterSnapshot) API アクションに少なくとも 1 つのタグを指定した場合）、Neptune はソース DB インスタンスから新しい DB スナップショットにタグをコピーしません。これは、ソース DB インスタンスの `--copy-tags-to-snapshot` (`CopyTagsToSnapshot`) オプションが有効になっている場合でも当てはまります。  
つまり、DB スナップショットから DB インスタンスのコピーを作成でき、新しい DB インスタンスに適用されないタグを追加することがありません。コマンド (または `CreateDBClusterSnapshot` Neptune API アクション) を使用して AWS CLI `create-db-cluster-snapshot` DB スナップショットを作成したら、このトピックで後述するようにタグを追加できます。