使用OOS批量修改标签值 - 云服务器 ECS

通过创建OOS自定义模板，您可以一次修改数百个资源的同一标签的标签值。

前提条件

已为资源绑定一个标签，详情请参见创建或绑定标签。

背景信息

本文以ECS实例为例，创建一个OOS自定义模板，该模板支持一次性修改数百台ECS实例的同一标签值。本示例中，ECS实例的源标签键值对为TagKey:OldTagValue，修改后将变为TagKey:NewTagValue。

说明

批量修改资源的数量上限为1000，资源数量大于1000时需要多次执行自定义模板。
OOS自定义模板可以修改同一地域下任何支持绑定标签的资源，您只需要根据您的业务需求修改相应接口，支持绑定标签的资源，详情请参见标签概述。OOS支持的资源，详情请参见OOS支持的云产品列表。

步骤一：创建模板

您可以参照以下步骤，创建批量修改标签值的OOS自定义模板。

登录运维编排服务OOS管理控制台。
在顶部菜单栏左上角处，选择地域。
在左侧导航栏，单击我的模板。
单击创建模板。
在基本信息区域，输入模板名称。
您也可以单击展开更多设置，按需设置模板的标签、资源组和版本描述。

单击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": {
                "zh-cn": "通过标签过滤ECS实例",
                "en": "filter ecs instances by tags"
            },
            "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": {
                "zh-cn": "更新ECS实例标签",
                "en": "tag ecs instances"
            },
            "Properties": {
                "Service": "ECS",
                "API": "TagResources",
                "Parameters": {
                    "Tags": [
                        {
                            "Key": "{{ tagKey }}",
                            "Value": "{{ newTagValue }}"
                        }
                    ],
                    "ResourceType": "Instance",
                    "ResourceIds": [
                        "{{ACS::TaskLoopItem}}"
                    ]
                }
            },
            "Loop": {
                "MaxErrors": "100%",
                "Concurrency": 20,
                "Items": "{{DescribeInstances_ECS.Instances}}"
            }
        }
    ],
    "Outputs": {}
}

单击创建模板，完成模板创建。

步骤二：执行模板

您可以参照以下步骤，执行步骤一：创建模板创建的模板来批量修改标签值。

在左侧导航栏，单击我的模板。
找到步骤一：创建模板新建的模板，单击对应操作列下的创建执行。
填写执行描述，并选择执行模式，单击下一步：设置参数。
参见参数说明，输入各项参数，单击下一步：确定。
参数说明如下：
- operateId：操作ID，用于区分每次操作，可自定义输入。
- tagKey：当前标签键，即想修改标签值的对应标签键，本示例为TagKey。
- tagValue：当前标签值，即修改前的标签值，本示例为OldTagValue。
- newTagValue：新标签值，即修改后的标签值，本示例为NewTagValue。
单击创建开始执行。执行完成后将自动跳转到执行详情页面，可查看执行结果。

说明若执行失败，您可以查看日志获取失败原因，以调整执行内容。