このトピックでは、CloudOps Orchestration Service (OOS) カスタムテンプレートを使用して、同じリージョン内の複数のリソースのタグ値を一度に変更する方法について説明します。
前提条件
Elastic Compute Service (ECS) インスタンスにタグが追加されます。 詳細については、「カスタムタグの追加」をご参照ください。
背景情報
このトピックでは、OOS によるカスタムテンプレートの作成と、複数の ECS インスタンスのタグ値をまとめて変更する方法を説明します。 この例では、ECS インスタンスのタグ値が OldTagValue から NewTagValue に変更されています。 関連するタグのキーと値のペアがTagKey:OldTagValue
からTagKey:NewTagValue
に変更されます。
OOS カスタムテンプレートを使用して、最大 1,000 のリソースのタグ値を一度に変更できます。 リソース数が1,000を超える場合は、テンプレートを複数回実行する必要があります。
OOS カスタムテンプレートを使用して、同一リージョンにおけるタグをサポートするリソースのタグ値を変更できます。 テンプレート内の関連 API 操作を変更して、さまざまなリソースに適用できます。 タグをサポートするリソースの詳細については、「タグを使用するサービス」をご参照ください。 OOSでサポートされているリソースの詳細については、サポートされているクラウドサービスのリスト.
ステップ 1:OOS カスタムテンプレートの作成
以下の手順で、複数リソースのタグ値をまとめて変更するための OOS カスタムテンプレートを作成できます。
にログインします。OOSコンソール.
左側のナビゲーションウィンドウで、 .
上部のナビゲーションバーで、リージョンを選択します。
クリックテンプレートの作成.
では、基本情報セクションで、テンプレートの名前を入力します。
[JSON] タブをクリックし、テンプレートのコードを記述します。
以下にコードの例を示します。
{ "Description": "複数のリソースのタグ値を一度に変更する" 、 "FormatVersion": "OOS-2019-06-01" 、 "Parameters": { "operateId": { "説明": "操作IDを定義する" 、 "Type": "String", "MinLength": 1, "MaxLength": 64 }, "tagKey": { "説明": "現在のタグキー" 、 "Type": "String", "MinLength": 1, "MaxLength": 64 }, "tagValue": { "Description": "現在のタグ値" 、 "Type": "String", "MinLength": 1, "MaxLength": 64 }, "newTagValue": { "Description": "新しいタグ値" 、 "Type": "String", "MinLength": 1, "MaxLength": 64 } }, "タスク": [ { "名前": "DescribeInstances_ECS" 、 "Action": "ACS::ExecuteAPI" 、 "Description": { "en": "タグでecsインスタンスをフィルタリングする" }, "Properties": { "サービス": "ECS" 、 "API": "DescribeInstances" 、 "オートページング": true、 "Parameters": { "Tags": [ { "キー": "{{ tagKey }}" 、 "Value": "{{ tagValue }}" } ] } }, "Outputs": { "インスタンス":{ "タイプ": "リスト" 、 "ValueSelector": "Instances.Instance[].InstanceId" } } }, { "名前": "TagResources_ECS_Instances" 、 "Action": "ACS::ExecuteAPI" 、 "Description": { "en": "タグecsインスタンス" }, "Properties": { "サービス": "ECS" 、 "API": "TagResources" 、 "Parameters": { "Tags": [ { "キー": "{{ tagKey }}" 、 "Value": "{{ newTagValue }}" } ], "ResourceType": "インスタンス" 、 "ResourceIds": [ "{{ACS::TaskLoopItem}}" ] } }, "ループ": { "MaxErrors": "100%" 、 "並行性": 20、 "Items": "{{DescribeInstances_ECS.Instances}}" } } ], 「出力」: {} }
クリックテンプレートの作成.
ステップ 2:カスタムテンプレートの実行
次の手順を実行して、手順1: OOSカスタムテンプレートの作成で作成したテンプレートを実行し、複数のリソースのタグ値を変更できます。
On theカスタムテンプレートページで作成したテンプレートを見つけます。手順1: OOSカスタムテンプレートの作成をクリックし、実行の作成で、アクション列を作成します。
[基本情報] ステップで [実行説明] と [実行モード] を設定します。 次に、[次のステップ: パラメーター設定] をクリックします。
[パラメーター設定] ステップで、パラメーターを設定し、次のステップ: OK.
この手順では、以下のパラメーターを設定する必要があります。
operateId: 操作を識別するために使われる操作の ID です。 要件に基づいてこのパラメーターを設定できます。
tagKey:現在のタグキーです。 この例では、現在のタグキーは
TagKey
です。tagValue:現在のタグ値です。 この例では、現在のタグ値は
OldTagValue
です。newTagValue:新しいタグ値です。 この例では、新しいタグ値は
NewTagValue
です。
クリック作成.
テンプレートが実行されると、実行の詳細ページが表示されます。 このページで実行結果を確認できます。
説明実行に失敗した場合は、ログで失敗の原因を確認し、調整できます。