Todos os produtos
Search
Central de documentação

Resource Management:Atualização em massa de valores de tag usando o OOS

Última atualização: Jun 27, 2026

Crie um modelo personalizado do CloudOps Orchestration Service (OOS) para atualizar em massa os valores de tag em centenas de recursos dentro de uma região.

Pré-requisitos

As instâncias do ECS devem estar marcadas com tags. Criar uma tag, Adicionar uma tag a um recurso.

Visão geral

Este exemplo altera a tag de centenas de instâncias do ECS de TagKey:OldTagValue para TagKey:NewTagValue.

Nota

Etapa 1: Criar um modelo

Crie um modelo personalizado do OOS para atualizar valores de tag em massa:

  1. Faça login no console do OOS.

  2. No painel de navegação à esquerda, escolha Automated Task > Custom Template.

  3. Na barra de menus superior, selecione uma região.

  4. Clique em Create Template.

  5. Clique na aba JSON e insira o conteúdo do modelo.

    Exemplo:

    {
        "Description": "Bulk update the tag values of resources.",
        "FormatVersion": "OOS-2019-06-01",
        "Parameters": {
            "operateId": {
                "Description": "Enter a custom operation ID.",
                "Type": "String",
                "MinLength": 1,
                "MaxLength": 64
            },
            "tagKey": {
                "Description": "The key of the tag to update.",
                "Type": "String",
                "MinLength": 1,
                "MaxLength": 64
            },
            "tagValue": {
                "Description": "The current value of the tag.",
                "Type": "String",
                "MinLength": 1,
                "MaxLength": 64
            },
            "newTagValue": {
                "Description": "The new value for the tag.",
                "Type": "String",
                "MinLength": 1,
                "MaxLength": 64
            }
        },
        "Tasks": [
            {
                "Name": "DescribeInstances_ECS",
                "Action": "ACS::ExecuteAPI",
                "Description": {
                    "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": {
                    "en": "Update tags for ECS instances"
                },
                "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. Clique em Create Template.

  7. Na caixa de diálogo Template Basic Information, insira o nome do modelo, a tag, o grupo de recursos e a descrição da versão.

  8. Clique em OK.

Etapa 2: Executar o modelo

Execute o modelo criado na Etapa 1 para atualizar os valores de tag em massa.

  1. Na página Custom Template, localize o modelo da Etapa 1 e clique em Create Execution na coluna Actions.

  2. Insira uma Execution Description, selecione um Execution Mode e clique em Next: Set Parameters.

  3. Insira os parâmetros e clique em Next: Confirm.

    Parâmetros:

    • operateId: Identificador personalizado para esta execução.

    • tagKey: Chave da tag a ser atualizada. Exemplo: TagKey.

    • tagValue: Valor atual da tag. Exemplo: OldTagValue.

    • newTagValue: Novo valor da tag. Exemplo: NewTagValue.

  4. Clique em Create.

    Após a execução, você será redirecionado para a página de detalhes para visualizar os resultados.

    Nota

    Se a execução falhar, verifique o log de execução para obter mais detalhes.