タグ

重要

AWS OpsWorks Stacks は新規顧客を受け付けなくなりました。既存のお客様は、2024 年 5 月 26 日までは OpsWorks コンソール、 API、 CLI、 および CloudFormation リソースを通常どおり使用できますが、その時点でこれらのリソースは廃止されます。この移行に備えて、できるだけ早くスタックを AWS Systems Manager に移行することをおすすめします。詳細については、AWS OpsWorks Stacks サポート終了に関する FAQ および AWS Systems Manager アプリケーションマネージャへの AWS OpsWorks Stacks アプリケーションの移行 を参照してください。

タグによって、Chef 11.10、Chef 12、Chef 12.2 のスタックでのリソースのグループ化と、AWS Billing and Cost Managementでこれらのリソースを使用するコストの追跡が容易になります。

スタックおよびレイヤーレベルでタグを適用することができます。タグを作成する場合、タグ付けされた構造内すべてのリソースにタグを適用することになります。例えば、あるレイヤーにタグを適用すると、そのレイヤーのすべてのインスタンス、Amazon EBS ボリューム (ルートを除く)、または Elastic Load Balancing ロードバランサーにタグが適用されます。タグは現在、インスタンスのルートまたはデフォルトの EBS ボリュームには適用できません。

タグは、AWS OpsWorks スタックにあるスタックまたはレイヤーに割り当てるキーと値のペアです。タグを作成した後、Management コンソールを開いてユーザー定義のタグを有効化します。タグを有効化して AWS OpsWorks スタックのリソースのコストを追跡及び管理する方法の詳細については、 「Billing and Cost Management User Guide」(Billing and Cost Management ユーザーガイド) の「Using Cost Allocation Tags」(コスト配分タグの使用) および「Activating User-Defined Cost Allocation Tags」(ユーザー定義のコスト配分タグのアクティブ化) を参照してください。

タグは、AWS OpsWorks スタックのカスタム属性と同じように機能します。スタックに適用するタグは、スタックの各レイヤーによって継承されます。レイヤーレベルでは、継承されたタグの値 (キー名は除く) をオーバーライドでき、新しいレイヤー固有のタグを追加できます。AWS OpsWorks は、レイヤー内のすべてのリソースに設定された派生タグに適用されます。リソースを新規作成または既存のリソースをレイヤーに割り当てるとき、そのレイヤーの新しいリソースは、同じタグでタグ付けされます。

スタックレベルでタグを設定

スタックレベルでは、スタックのホームページで Tags を選択してタグを追加および管理できます。

Tags ページで、タグをキーと値のペアとして追加します。次のスクリーンショットでは、タグの例をいくつか示しています。タグを削除するには、キーと値のペアの右側にある赤色の X を選択します。

レイヤーレベルでのタグの設定

レイヤーレベルで、[Tags] (タグ) タブを選択してタグを設定します。このタブは、レイヤーのホームページ、および各レイヤーのホームページにあります。

レイヤーレベルでタグを変更または追加するときに、親スタックレベルで追加されたタグはレイヤーとそのリソースによって継承されることに注意してください。継承されたタグの値を変更することはできますが、キー名の変更や継承されたタグを削除することはできません。スタック設定で、キー名を変更または親スタックから継承されたタグを削除します。次のスクリーンショットでは、スタックレベルから継承されたタグの例を示しています。継承されたタグは灰色で表示されます。

スタックへのタグの追加については、「新しいスタックを作成する」を参照してください。レイヤーへのタグの追加については、「OpsWorks レイヤーの構成を編集する」を参照してください。

ｄAWS CLI を使用したタグの管理

AWS CLI コマンドを使用して、スタックおよびレイヤーレベルでタグを追加および削除することもできます。AWS CLI のダウンロードおよびインストールの方法についての詳細は、AWS「 コマンドラインインターフェイスのインストール」を参照してください。タグ付けしたいスタックがデフォルトのリージョンにない場合は、コマンドに --region パラメータを忘れずに追加してください。レイヤー ARN は、現在 AWS Management Console に表示されます。レイヤーの ARN を取得するには、describe-layers コマンドを実行します。

AWS CLI を使用してタグを追加する方法

• AWS CLI コマンドプロンプトで、次のコマンドを入力して stack_or_layer_ARN を置き換え、キーと値のペアのタグを指定し、Enter キーを押します。二重引用符はバックスラッシュでエスケープされます。

  aws opsworks tag-resource --resource-arn stack_or_layer_ARN --tags "{\"key\":\"value\",\"key\":\"value\"}"

  次に例を示します。

  aws opsworks tag-resource --resource-arn arn:aws:opsworks:us-east-2:800000000003:stack/500b99c0-ec00-4cgg-8a0d-1000000jjd1b --tags "{\"Stage\":\"Production\",\"Organization\":\"Mobile\"}"

AWS CLI を使用してタグを削除する方法

• AWS CLI コマンドプロンプトで以下を入力し、Enter キーを押します。

  aws opsworks untag-resource --resource-arn stack_or_layer_ARN --tag-keys "[\"key\",\"key\"]"

  タグを削除するには、削除したいタグのキーのみを指定します。次に例を示します。

  aws opsworks untag-resource --resource-arn arn:aws:opsworks:us-east-2:800000000003:stack/500b99c0-ec00-4cgg-8a0d-1000000jjd1b --tag-keys "[\"Stage\",\"Organization\"]"

  注記

  レイヤーから継承されたタグ (親スタックレベルで追加されたタグ) を削除することはできません。代わりに、スタックから継承されたタグを削除します。

タグの制限

タグを作成するときは、次の制限事項に留意してください。

• AWS OpsWorks スタックでは、ユーザー定義タグの数がスタックレベルとレイヤーレベルで 40 に制限され、これには親レベルから継承されたユーザー定義タグが含まれます。これにより、opsworks: が付けられるデフォルトタグ、および他の AWS プロセスによって設定されたタグに利用できるスロットが 10 となります。AWS によって作成されたユーザー定義タグとデフォルトタグの両方を含む、最大 50 のタグを 1 つのリソースで使用できます。

• タグキーの先頭を、aws:、opsworks: または rds: にすることはできません。name は Name スタックで予約されているため、Name または AWS OpsWorks をタグキーとして使用しないでください。

• キーは最大 127 文字で、Unicode 文字、区切り文字、数字、または + - = . _ : / の特殊文字のみを含めることができます。

• 値は最大 255 文字で、Unicode 文字、数字、区切り文字、または + - = . _ : / の特殊文字のみを含めることができます。