すべてのプロダクト
Search
ドキュメントセンター

Resource Management:OOS を使用したタグ値の一括更新

最終更新日:Jun 04, 2026

CloudOps Orchestration Service (OOS) でカスタムテンプレートを作成し、単一のリージョン内にある数百のリソースのタグ値を一括更新します。

前提条件

Elastic Compute Service (ECS) インスタンスにタグが付与されている必要があります。詳細については、タグの作成およびリソースへのタグの追加をご参照ください。

概要

この例では、数百の ECS インスタンスのタグを更新し、キーと値のペアを TagKey:OldTagValue から TagKey:NewTagValue に変更します。

説明
  • 1 回の実行で処理できるリソースは最大 1,000 件です。より大きなバッチを処理する場合は、テンプレートを複数回実行してください。

  • このテンプレートは、単一リージョン内の任意のタグ付け可能なリソースで使用できます。リソースタイプに合わせて API オペレーションを調整してください。詳細については、Tag と連携するサービスをご参照ください。OOS がサポートするクラウドサービス

手順1:テンプレートの作成

タグ値を一括更新するためのカスタム OOS テンプレートを作成します。

  1. OOS コンソールにログインします。

  2. ナビゲーションペインで、自動タスク > マイテンプレート を選択します。

  3. 上部ナビゲーションバーの左上でリージョンを選択します。

  4. テンプレートの作成 をクリックします。

  5. [JSON] タブをクリックし、テンプレートの内容を入力します。

    例:

    {
        "Description": "リソースのタグ値を一括で更新します。",
        "FormatVersion": "OOS-2019-06-01",
        "Parameters": {
            "operateId": {
                "Description": "入力するカスタムオペレーション ID。",
                "Type": "String",
                "MinLength": 1,
                "MaxLength": 64
            },
            "tagKey": {
                "Description": "更新対象のタグキー。",
                "Type": "String",
                "MinLength": 1,
                "MaxLength": 64
            },
            "tagValue": {
                "Description": "タグの現在の値。",
                "Type": "String",
                "MinLength": 1,
                "MaxLength": 64
            },
            "newTagValue": {
                "Description": "タグの新しい値。",
                "Type": "String",
                "MinLength": 1,
                "MaxLength": 64
            }
        },
        "Tasks": [
            {
                "Name": "DescribeInstances_ECS",
                "Action": "ACS::ExecuteAPI",
                "Description": "タグに基づいて ECS インスタンスをフィルタリングします。",
                "Properties": {
                    "Service": "ECS",
                    "API": "DescribeInstances",
                    "AutoPaging": true,
                    "Parameters": {
                        "Tags": [
                            {
                                "Key": "{{ tagKey }}",
                                "Value": "{{ tagValue }}"
                            }
                        ]
                    }
                },
                "Outputs": {
                    "Instances": {
                        "Type": "List",
                        "ValueSelector": "Instances.Instance[].InstanceId"
                    }
                }
            },
            {
                "Name": "TagResources_ECS_Instances",
                "Action": "ACS::ExecuteAPI",
                "Description": "ECS インスタンスのタグを更新します。",
                "Properties": {
                    "Service": "ECS",
                    "API": "TagResources",
                    "Parameters": {
                        "Tags": [
                            {
                                "Key": "{{ tagKey }}",
                                "Value": "{{ newTagValue }}"
                            }
                        ],
                        "ResourceType": "Instance",
                        "ResourceId": [
                            "{{ACS::TaskLoopItem}}"
                        ]
                    }
                },
                "Loop": {
                    "MaxErrors": "100%",
                    "Concurrency": 20,
                    "Items": "{{DescribeInstances_ECS.Instances}}"
                }
            }
        ],
        "Outputs": {}
    }
  6. テンプレートの作成 をクリックします。

  7. テンプレートの基本情報を入力してください ダイアログボックスで、テンプレート名、タグ、リソースグループ、バージョンの説明を入力します。

  8. 完全な作成 をクリックします。

手順2:テンプレートの実行

手順1 で作成したテンプレートを実行し、タグ値を一括更新します。

  1. マイテンプレート ページで、手順1 で作成したテンプレートを見つけ、操作 列の 実行を作成 をクリックします。

  2. 実行説明 を入力し、実行モード を選択してから、[次へ:パラメーターの設定] をクリックします。

  3. パラメーターを入力し、[次へ:確認] をクリックします。

    パラメーター:

    • operateId:この実行を識別するためのカスタム ID。

    • tagKey:更新対象のタグキー。例: TagKey

    • tagValue:現在のタグ値。例: OldTagValue

    • newTagValue:新しいタグ値。例: NewTagValue

  4. 作成 をクリックします。

    実行後、詳細ページにリダイレクトされ、結果を確認できます。

    説明

    実行が失敗した場合は、実行ログで詳細を確認してください。