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

Resource Management:OOSを使用して一度に複数のリソースのタグ値を変更する

最終更新日:Nov 01, 2024

このトピックでは、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 カスタムテンプレートを作成できます。

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

  2. 左側のナビゲーションウィンドウで、自動タスク > カスタムテンプレート.

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

  4. クリックテンプレートの作成.

  5. では、基本情報セクションで、テンプレートの名前を入力します。

  6. [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}}"
                }
            }
        ],
        「出力」: {}
    } 
  7. クリックテンプレートの作成.

ステップ 2:カスタムテンプレートの実行

次の手順を実行して、手順1: OOSカスタムテンプレートの作成で作成したテンプレートを実行し、複数のリソースのタグ値を変更できます。

  1. On theカスタムテンプレートページで作成したテンプレートを見つけます。手順1: OOSカスタムテンプレートの作成をクリックし、実行の作成で、アクション列を作成します。

  2. [基本情報] ステップで [実行説明][実行モード]設定します。 次に、[次のステップ: パラメーター設定] をクリックします。

  3. [パラメーター設定] ステップで、パラメーターを設定し、次のステップ: OK.

    この手順では、以下のパラメーターを設定する必要があります。

    • operateId: 操作を識別するために使われる操作の ID です。 要件に基づいてこのパラメーターを設定できます。

    • tagKey:現在のタグキーです。 この例では、現在のタグキーはTagKeyです。

    • tagValue:現在のタグ値です。 この例では、現在のタグ値はOldTagValueです。

    • newTagValue:新しいタグ値です。 この例では、新しいタグ値はNewTagValueです。

  4. クリック作成.

    テンプレートが実行されると、実行の詳細ページが表示されます。 このページで実行結果を確認できます。

    説明

    実行に失敗した場合は、ログで失敗の原因を確認し、調整できます。