翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS OpsWorks for Chef Automate リソースでのタグの使用
重要
AWS OpsWorks for Chef Automate は 2024 年 5 月 5 日にサポートが終了し、新規および既存のお客様の両方で無効になっています。既存のお客様は、 Chef SaaS または代替ソリューションに移行することをお勧めします。ご質問がある場合は、 AWS re:Post
タグとは、AWS リソースを識別および整理するためのメタデータとして使用される単語やフレーズのことです。では AWS OpsWorks for Chef Automate、リソースには最大 50 個のユーザー適用タグを含めることができます。各タグはキーと 1 つのオプションの値で構成されます。 AWS OpsWorks for Chef Automateで以下のリソースにタグを適用できます。
-
AWS OpsWorks for Chef Automate サーバー
-
AWS OpsWorks for Chef Automate サーバーのバックアップ
AWS リソースのタグは、コストの追跡、リソースへのアクセスの制御、タスクを自動化するためのリソースのグループ化、目的またはライフサイクルステージによるリソースの整理に役立ちます。タグのメリットの詳細については、AWS Billing and Cost Management ユーザーガイドのAWS タグ付け戦略
タグを使用して AWS OpsWorks for Chef Automate サーバーまたはバックアップへのアクセスを制御するには、 AWS Identity and Access Management (IAM) でポリシーステートメントを作成または編集します。詳細については、AWS Identity and Access Management ユーザーガイド の「Controlling Access to AWS Resources Using Resource Tags」(リソースタグを使用した リソースへのアクセスの制御) を参照してください。
AWS OpsWorks for Chef Automate サーバーにタグを適用すると、タグはサーバーのバックアップ、バックアップを保存する Amazon S3 バケット、サーバーの Amazon EC2 インスタンス、 に保存されているサーバーのシークレット AWS Secrets Manager、およびサーバーで使用される Elastic IP アドレスにも適用されます。タグは、 がサーバーの作成 AWS OpsWorks に使用する AWS CloudFormation スタックには伝達されません。
トピック
でのタグの仕組み AWS OpsWorks for Chef Automate
このリリースでは、AWS OpsWorks CM API または AWS Management Consoleを使用してタグを追加および管理できます。 AWS OpsWorks また、CM は、EC2 インスタンス、Secrets Manager のシークレット、Elastic IP アドレス、セキュリティグループ、S3 バケット、バックアップなど、サーバーに関連付けられている AWS リソースにサーバーに追加するタグを追加しようとします。以下の表では、 AWS OpsWorks for Chef Automateでタグを追加および管理する方法の概要を示しています。
アクション | 使用するもの |
---|---|
手動で作成する新しい AWS OpsWorks for Chef Automate サーバーまたはバックアップにタグを追加します。 |
|
リソースのタグを表示します。 |
|
バックアップが手動または自動で作成されたかどうかにかかわらず、既存の AWS OpsWorks for Chef Automate サーバーまたはバックアップにタグを追加します。 |
|
リソースからタグを削除する |
|
DescribeServers
および DescribeBackups
のレスポンスにタグ情報は含まれません。タグを表示するには、ListTagsForResource
API を使用します。
でのタグの追加と管理 AWS OpsWorks for Chef Automate (コンソール)
このセクションの手順は AWS Management Consoleで実行されます。
タグを追加する場合、タグのキーを空にすることはできません。キーは最大 127 文字で、Unicode 文字、数字、区切り文字、または特殊文字 (+ - = . _ : / @
) のみを含めることができます。タグの値はオプションです。キーはあるが値はないタグであれば、追加できます。値は最大 255 文字とし、Unicode 文字、数字、区切り文字、または特殊文字 (+ - = .
_ : / @
) のみを含めることができます。
トピック
新しい AWS OpsWorks for Chef Automate サーバーにタグを追加する (コンソール)
-
AWS OpsWorks for Chef Automate サーバーを作成するための前提条件をすべて満たしてください。
-
Chef Automate サーバーの作成 の手順 1~10 に従います。
-
自動バックアップ設定を指定した後、[Configure advanced settings] (詳細設定の設定) ページの [Tags] (タグ) の領域でタグを追加します。最大 50 個のタグを追加できます。タグを追加したら、[次へ] を選択します。
-
Chef Automate サーバーの作成 のステップ 13 に進み、新しいサーバーに対して選択した設定を確認します。
新しいバックアップにタグを追加する (コンソール)
-
AWS OpsWorks for Chef Automate ホームページで、既存の Chef Automate サーバーを選択します。
-
サーバーの詳細ページで、ナビゲーションペインで [Backups (バックアップ)] を選択します。
-
[Backups (バックアップ)] ページで、[Create backup (バックアップの作成)] を選択します。
-
タグを追加する。タグの追加が完了したら、[Create (作成)] を選択します。
既存のサーバーにタグを追加または表示する (コンソール)
-
AWS OpsWorks for Chef Automate ホームページで、既存の Chef Automate サーバーを選択して詳細ページを開きます。
-
ナビゲーションペインで [Tags (タグ)] を選択するか、詳細ページの下部にある [View all tags (すべてのタグを表示)] を選択します。
-
[Tags (タグ)] ページで、[Edit (編集)] を選択します。
-
サーバー上のタグを追加または編集します。完了したら、[保存] を選択します。
注記
Chef Automate サーバーでタグを変更すると、EC2 インスタンス、Elastic IP アドレス、セキュリティグループ、S3 バケット、バックアップなど、サーバーに関連付けられているリソースのタグも変更されることに注意してください。
既存のバックアップにタグを追加または表示する (コンソール)
-
AWS OpsWorks for Chef Automate ホームページで、既存の Chef Automate サーバーを選択して詳細ページを開きます。
-
ナビゲーションペインで [Backups (バックアップ)] を選択するか、詳細ページの [Recent backups (最近のバックアップ)] 領域で [View all backups (すべてのバックアップを表示)] を選択します。
-
[Backups (バックアップ)] ページで、管理するバックアップを選択し、[Edit backup (バックアップの編集)] を選択します。
-
バックアップにタグを追加または編集します。完了したら、[Update (更新)] を選択します。
サーバからタグを削除する (コンソール)
-
AWS OpsWorks for Chef Automate ホームページで、既存の Chef Automate サーバーを選択して詳細ページを開きます。
-
ナビゲーションペインで [Tags (タグ)] を選択するか、詳細ページの下部にある [View all tags (すべてのタグを表示)] を選択します。
-
[Tags (タグ)] ページで、[Edit (編集)] を選択します。
-
タグを削除するには、タグの横にある [X] を選択します。完了したら、[保存] を選択します。
注記
Chef Automate サーバーでタグを変更すると、EC2 インスタンス、Elastic IP アドレス、セキュリティグループ、S3 バケット、バックアップなど、サーバーに関連付けられているリソースのタグも変更されることに注意してください。
バックアップからタグを削除する (コンソール)
-
AWS OpsWorks for Chef Automate ホームページで、既存の Chef Automate サーバーを選択して詳細ページを開きます。
-
ナビゲーションペインで [Backups (バックアップ)] を選択するか、詳細ページの [Recent backups (最近のバックアップ)] 領域で [View all backups (すべてのバックアップを表示)] を選択します。
-
[Backups (バックアップ)] ページで、管理するバックアップを選択し、[Edit backup (バックアップの編集)] を選択します。
-
タグを削除するには、タグの横にある [X] を選択します。完了したら、[Update (更新)] を選択します。
AWS OpsWorks for Chef Automate (CLI) でのタグの追加と管理
このセクションの手順は AWS CLIで実行されます。タグの使用 AWS CLI を開始する前に、 の最新リリースを実行していることを確認してください。のインストールまたは更新の詳細については AWS CLI、「 AWS Command Line Interface ユーザーガイド」の「 AWS CLIのインストール」を参照してください。
タグを追加する場合、タグのキーを空にすることはできません。キーは最大 127 文字で、Unicode 文字、数字、区切り文字、または特殊文字 (+ - = . _ : / @
) のみを含めることができます。タグの値はオプションです。キーはあるが値はないタグであれば、追加できます。値は最大 255 文字とし、Unicode 文字、数字、区切り文字、または特殊文字 (+ - = .
_ : / @
) のみを含めることができます。
トピック
新しい AWS OpsWorks for Chef Automate サーバーにタグを追加する (CLI)
AWS OpsWorks for Chef Automate サーバーを作成するときに、 を使用してタグ AWS CLI を追加できます。この手順では、サーバーの作成方法について詳しく説明していません。このガイドの「」を参照して AWS OpsWorks for Chef Automate サーバーを作成する方法の詳細についてはを使用して Chef Automate サーバーを作成する AWS CLI、 AWS CLI 「」を参照してください。サーバーには最大 50 個のタグを追加できます。
-
AWS OpsWorks for Chef Automate サーバーを作成するための前提条件をすべて満たしてください。
-
「を使用して Chef Automate サーバーを作成する AWS CLI」のステップ 1 〜 5 を完了します。
-
ステップ 6 では、
create-server
コマンドを実行するときに、以下の例に示すように、コマンドに--tags
パラメータを追加します。aws opsworks-cm create-server ... --tags Key=
Key1
,Value=Value1
Key=Key2
,Value=Value2
以下の例では、
create-server
コマンドのタグ部分のみを示しています。aws opsworks-cm create-server ... --tags Key=Stage,Value=Production Key=Department,Value=Marketing
-
「を使用して Chef Automate サーバーを作成する AWS CLI」の残りのステップを行います。タグが新しいサーバーに追加されたことを確認するには、このトピックの「リソースタグのリストを取得する 」の手順に従います。
新しいバックアップにタグを追加する (CLI)
サーバーの新しい手動バックアップを作成するときに、 AWS OpsWorks for Chef Automate を使用してタグ AWS CLI を追加できます。この手順では、手動バックアップの作成方法について詳しく説明していません。手動バックアップの作成方法の詳細については、「」の「手動バックアップを実行するには AWS CLI」を参照してくださいAWS OpsWorks for Chef Automate サーバーのバックアップ。バックアップには最大 50 個のタグを追加できます。サーバにタグがある場合、新しいバックアップにはサーバのタグが自動的にタグ付けされます。
デフォルトでは、新しい AWS OpsWorks for Chef Automate サーバーを作成すると、自動バックアップが有効になります。このトピックの「既存のサーバーまたはバックアップにタグを追加する (CLI) 」で説明されている tag-resource
コマンドを実行して、自動バックアップにタグを追加できます。
-
手動バックアップの作成中にタグをバックアップに追加するには、以下のコマンドを実行します。コマンドのタグ部分のみを示しています。フル
create-backup
コマンドの例に関しては、AWS OpsWorks for Chef Automate サーバーのバックアップ の「 AWS CLIで手動バックアップを実行するには」を参照してください。aws opsworks-cm create-backup ... --tags Key=
Key1
,Value=Value1
Key=Key2
,Value=Value2
以下の例では、
create-backup
コマンドのタグ部分のみを示しています。aws opsworks-cm create-backup ... --tags Key=Stage,Value=Production Key=Department,Value=Marketing
既存のサーバーまたはバックアップにタグを追加する (CLI)
tag-resource
コマンドを実行して、タグを既存の AWS OpsWorks for Chef Automate
サーバーまたはバックアップに追加できます (バックアップが手動で作成されたか自動的に作成されたかに関係なく)。ターゲットリソースの Amazon リソースナンバー (ARN) を指定して、タグを追加します。
-
タグを適用するリソースの ARN を取得するには:
-
サーバーの場合は、
describe-servers --server-name
を実行します。コマンドの結果には、サーバーの ARN が表示されます。server_name
-
バックアップの場合は、
describe-backups --backup-id
を実行します。コマンドの結果には、バックアップの ARN が表示されます。を実行してbackup_ID
describe-backups --server-name
、特定の AWS OpsWorks for Chef Automate サーバーのすべてのバックアップに関する情報を表示することもできます。server_name
以下の例では、
ServerArn
コマンドの結果のdescribe-servers --server-name opsworks-cm-test
のみを示しています。tag-resource
コマンドにServerArn
値を指定して、サーバーにタグを追加します。{ "Servers": [ { ... "ServerArn": "arn:aws:opsworks-cm:us-west-2:123456789012:server/opsworks-cm-test/EXAMPLEd-66b0-4196-8274-d1a2bEXAMPLE" } ] }
-
-
ステップ 1 で返された ARN を使用して、
tag-resource
コマンドを実行します。aws opsworks-cm tag-resource --resource-arn "
server_or_backup_ARN
" --tags Key=Key1
,Value=Value1
Key=Key2
,Value=Value2
次に例を示します。
aws opsworks-cm tag-resource --resource-arn "arn:aws:opsworks-cm:us-west-2:123456789012:server/opsworks-cm-test/EXAMPLEd-66b0-4196-8274-d1a2bEXAMPLE" --tags Key=Stage,Value=Production Key=Department,Value=Marketing
-
タグが正常に追加されたことを確認するには、次の手順「リソースタグのリストを取得する 」に進みます。
リソースタグのリストを取得する
list-tags-for-resource
コマンドを実行して、 AWS OpsWorks for Chef Automate サーバーまたはバックアップにアタッチされているタグを表示できます。ターゲットリソースの ARN を指定して、そのタグを表示します。
-
タグを一覧表示するリソースの ARN を取得するには:
-
サーバーの場合は、
describe-servers --server-name
を実行します。コマンドの結果には、サーバーの ARN が表示されます。server_name
-
バックアップの場合は、
describe-backups --backup-id
を実行します。コマンドの結果には、バックアップの ARN が表示されます。を実行してbackup_ID
describe-backups --server-name
、特定の AWS OpsWorks for Chef Automate サーバーのすべてのバックアップに関する情報を表示することもできます。server_name
-
-
ステップ 1 で返された ARN を使用して、
list-tags-for-resource
コマンドを実行します。aws opsworks-cm list-tags-for-resource --resource-arn "
server_or_backup_ARN
"次に例を示します。
aws opsworks-cm tag-resource --resource-arn "arn:aws:opsworks-cm:us-west-2:123456789012:server/opsworks-cm-test/EXAMPLEd-66b0-4196-8274-d1a2bEXAMPLE"
リソースにタグがある場合、コマンドは以下のような結果を返します。
{ "Tags": [ { "Key": "Stage", "Value": "Production" }, { "Key": "Department", "Value": "Marketing" } ] }
リソースからタグを削除する
untag-resource
コマンドを実行して、 AWS OpsWorks for Chef Automate
サーバーまたはバックアップからタグを削除できます。リソースが削除されると、リソースのタグも削除されます。ターゲットリソースの Amazon リソースナンバー (ARN) を指定して、タグを削除します。
-
タグを削除するリソースの ARN を取得するには:
-
サーバーの場合は、
describe-servers --server-name
を実行します。コマンドの結果には、サーバーの ARN が表示されます。server_name
-
バックアップの場合は、
describe-backups --backup-id
を実行します。コマンドの結果には、バックアップの ARN が表示されます。を実行してbackup_ID
describe-backups --server-name
、特定の AWS OpsWorks for Chef Automate サーバーのすべてのバックアップに関する情報を表示することもできます。server_name
-
-
ステップ 1 で返された ARN を使用して、
untag-resource
コマンドを実行します。削除するタグのみを指定します。aws opsworks-cm untag-resource --resource-arn "
server_or_backup_ARN
" --tags Key=Key1
,Value=Value1
Key=Key2
,Value=Value2
この例では、
untag-resource
コマンドは、キーがStage
で値がProduction
のタグのみを削除します。aws opsworks-cm untag-resource --resource-arn "arn:aws:opsworks-cm:us-west-2:123456789012:server/opsworks-cm-test/EXAMPLEd-66b0-4196-8274-d1a2bEXAMPLE" --tags Key=Stage,Value=Production
-
タグが正常に削除されたことを確認するには、このトピックの「リソースタグのリストを取得する 」の手順に従います。
以下の資料も参照してください。
-
AWS Identity and Access Management ユーザーガイドのAWS リソースタグを使用したリソースへのアクセスの制御
-
「AWS Billing and Cost Management ユーザーガイド」の「コスト配分タグの使用」
-
「CreateBackup」 (AWS OpsWorks CM API リファレンス)
-
「CreateServer」 (AWS OpsWorks CM API リファレンス)
-
「TagResource」 (AWS OpsWorks CM API リファレンス)
-
「ListTagsForResource」 (AWS OpsWorks CM API リファレンス)
-
「UntagResource」 (AWS OpsWorks CM API リファレンス)