翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon QLDB リソースのタグ付け
タグとは、お客様または AWS が AWS リソースに割り当てるカスタム属性ラベルです。各タグは 2 つの部分で構成されます。
-
タグキー (例:
CostCenter
、Environment
、またはProject
)。タグキーでは、大文字と小文字が区別されます。 -
タグ値として知られるオプションのフィールド (例:
111122223333
またはProduction
)。タグ値を省略すると、空の文字列を使用した場合と同じになります。タグキーと同様に、タグ値は大文字と小文字が区別されます。
タグは、以下のことに役立ちます。
-
AWS リソースを識別および整理します。多くの AWS のサービス ではタグ付けがサポートされているため、各種のサービスからリソースに同じタグを割り当てて、リソースの関連を示すことができます。例えば、Amazon S3 バケットに割り当てる同じタグを Amazon QLDB 台帳に割り当てることができます。
-
AWS のコストの追跡。これらのタグは、AWS Billing and Cost Management ダッシュボードで有効にします。AWS では、タグを使用してコストを分類し、毎月のコスト配分レポートを提供します。詳細については、AWS Billing ユーザーガイド の「コスト配分タグの使用」を参照してください。
-
AWS リソースへのアクセスを AWS Identity and Access Management (IAM) で制御します。詳細については、このデベロッパーガイドの「QLDB での属性ベースのアクセスコントロール (ABAC)」および「IAM ユーザーガイド」の「IAM タグを使用したアクセスの制御」を参照してください。
タグの使用方法のヒントについては、AWS の回答ブログのAWS タグ付け戦略
以下のセクションでは、Amazon QLDB のタグに関する詳細が説明されています。
Amazon QLDB でサポートされるリソース
Amazon QLDB の以下のリソースがタグ付けをサポートしています。
-
台帳
-
テーブル
-
ジャーナルストリーム
タグを追加および管理する方法については、「タグの管理」を参照してください。
タグの命名規則と使用規則
Amazon QLDB リソースでのタグの使用には、以下の基本的な命名規則と使用規則が適用されます。
-
各リソースには、最大 50 個のタグを設定できます。
-
タグキーは、リソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。
-
タグキーの最大長は UTF-8 で 128 Unicode 文字です。
-
タグ値の最大長は UTF-8 で 256 Unicode 文字です。
-
使用できる文字は、UTF-8 対応の文字、数字、スペースと、文字 (. : + = @ _ / -) (ハイフン) です。
-
タグのキーと値は大文字と小文字が区別されます。ベストプラクティスとして、タグを大文字にするための戦略を決定し、その戦略をすべてのリソースタイプにわたって一貫して実装します。たとえば、
Costcenter
、costcenter
、CostCenter
のいずれを使用するかを決定し、すべてのタグに同じ規則を使用します。大文字と小文字の扱いについて、同様のタグに整合性のない規則を使用することは避けてください。 -
aws:
プレフィックスは AWS 用に限定されています。タグにaws:
というプレフィックスが付いたタグキーがある場合、タグのキーまたは値を編集、削除することはできません。このプレフィックスを持つタグは、リソースあたりのタグ数の制限には計算されません。
タグの管理
タグは、リソースの Key
および Value
プロパティで構成されています。このようなプロパティの値を追加、編集、削除するには、Amazon QLDB コンソール、AWS CLI、または QLDB API を使用します。AWS Resource Groups タグエディタを使用してタグを管理することもできます。
タグの使用については、以下の API オペレーションを参照してください。
-
ListTagsForResource (Amazon QLDB API リファレンス)
-
TagResource (Amazon QLDB API リファレンス)
-
UntagResource (Amazon QLDB API リファレンス)
QLDB のタグ付けパネルを使用するには (コンソール)
AWS Management Console にサインインして、Amazon QLDB コンソール (https://console.aws.amazon.com/qldb
) を開きます。 -
ナビゲーションペイン内で [Ledgers (台帳)] を選択します。
-
[Ledgers (台帳)] リストで、タグを管理する台帳の名前を選択します。
-
台帳の詳細ページの [Tags (タグ)] カードで、[Manage tags (タグの管理)] を選択します。
-
[Manage tags (タグの管理)] ページで、台帳に対して、必要に応じてタグを追加、編集、または削除できます。タグのキーと値が希望どおりになったら、[Save (保存)] を選択します。
作成時のリソースのタグ付け
タグ付けをサポートする QLDB リソースの場合、リソースの作成中にタグを定義するには、AWS Management Console、AWS CLI、または QLDB API を使用します。作成時にリソースにタグ付けすることで、リソース作成後にカスタムタグ付けスクリプトを実行する必要がなくなります。
リソースにタグ付けすると、それらのタグに基づいてリソースへのアクセスを制御できます。たとえば、特定のタグを持つテーブルリソースにのみフルアクセス権を付与できます。JSON ポリシーの例については、「テーブルタグに基づくすべてのアクションへのフルアクセス」を参照してください。
注記
テーブルリソースとストリーミングリソースは、ルート台帳リソースのタグを継承しません。
テーブルタグは、CREATE TABLE
PartiQL ステートメントで指定することでも定義できます。詳細については、「テーブルのタグ付け」を参照してください。