Todos os produtos
Search
Central de documentação

Resource Management:Sintaxe de política de tags

Última atualização: Jun 27, 2026

As políticas de tags usam sintaxe JSON com operadores de herança para aplicar regras de tag em toda a hierarquia de recursos.

Sintaxe

As políticas de tags usam o formato JSON. A sintaxe varia conforme o cenário.

Adicionar tags com valores específicos aos recursos

Esse tipo de política começa com tags.

Elemento

Obrigatório

Descrição

Exemplo

Chave da política

Sim

Identifica exclusivamente uma instrução. Use apenas minúsculas. É possível incluir várias chaves por política. A correspondência com chaves de tag não diferencia maiúsculas de minúsculas.

color

Chave da tag

Sim

Definida por tag_key. Diferencia maiúsculas de minúsculas.

COLER

Valor da tag

Sim

Definido por tag_value. Use um asterisco (*) para corresponder a qualquer valor.

red, green e grey

Escopo do tipo de recurso

Não

Use resource_type_scope para especificar os tipos de recurso aos quais a política se aplica. Por padrão, abrange todos os tipos compatíveis com políticas de tags.

ecs:instance

Escopo da região

Não

Use region_scope para definir as regiões onde a política entra em vigor. Por padrão, aplica-se a todas as regiões.

cn-hangzhou

Escopo do grupo de recursos

Não

Use rg_scope para indicar os grupos de recursos afetados pela política. Se omitido, abrange todos os grupos de recursos.

rg-xxxx

Interceptação pré-evento

Não

Configure enforced_for para determinar os tipos de recurso sujeitos à interceptação pré-evento. Desativado por padrão.

ecs:instance

Correção automática

Não

Ative tag_value_correction para ativar a correção automática de recursos não conformes. Desativado por padrão.

{
	"red": {
		"value_type": "Tag",
		"value_scope": {
			"acs:rm:rgId": "rg-xx1"
		}
	}
}

Operador de herança

Sim

Agrega políticas de tags anexadas e herdadas para calcular a política efetiva do objeto.

Operadores de herança

Código de exemplo:

{
    "tags": {
        "color": {
            "tag_key": {
                "@@operators_allowed_for_child_policies": [
                    "@@none"
                ],
                "@@assign": "COLER"
            },
            "tag_value": {
                "@@operators_allowed_for_child_policies": [
                    "@@append"
                ],
                "@@assign": [
                    "red",
                    "green",
                    "grey"
                ]
            },
          	"resource_type_scope": {
              "@@operators_allowed_for_child_policies": [
                    "@@append"
                ],
                "@@assign": [
                    "ecs:instance"
                ]
            },
          	"region_scope": {
              "@@operators_allowed_for_child_policies": [
                    "@@append"
                ],
                "@@assign": [
                    "cn-hangzhou"
                ]
            },
          	"rg_scope": {
              "@@operators_allowed_for_child_policies": [
                    "@@append"
                ],
                "@@assign": [
                    "rg-xxxx"
                ]
            },
            "enforced_for": {
              "@@operators_allowed_for_child_policies": [
                    "@@remove"
                ],
                "@@assign": [
                    "ecs:instance"
                ]
            },
            "tag_value_correction": {
                "@@operators_allowed_for_child_policies": [
                    "@@none"
                ],
                "@@assign": {
                    "red": {
                        "value_type": "Tag",
                        "value_scope": {
                            "acs:rm:rgId": "rg-xx1"
                        }
                    },
                    "green": {
                        "value_type": "Tag",
                        "value_scope": {
                            "k1": "v2"
                        }
                    },
                    "grey": {
                        "value_type": "Tag",
                        "value_scope": {
                            "k111": "v222"
                        }
                    }
                }
            }
        }
    }
}

Herança automática de tags de grupos de recursos

Esse tipo de política começa com rg_inherit.

Elemento

Obrigatório

Descrição

Exemplo

Chave da política

Sim

Identifica exclusivamente uma instrução. Use apenas minúsculas. É possível incluir várias chaves por política. A correspondência com chaves de tag não diferencia maiúsculas de minúsculas.

color

Chave da tag

Sim

Definida por tag_key. Diferencia maiúsculas de minúsculas.

COLER

Escopo do tipo de recurso

Não

Use resource_type_scope para especificar os tipos de recurso aos quais a política se aplica. Por padrão, abrange todos os tipos compatíveis com políticas de tags.

ecs:instance

Escopo da região

Não

Use region_scope para definir as regiões onde a política entra em vigor. Por padrão, aplica-se a todas as regiões.

cn-hangzhou

Escopo do grupo de recursos

Não

Use rg_scope para indicar os grupos de recursos afetados pela política. Se omitido, abrange todos os grupos de recursos.

rg-xxxx

Operador de herança

Sim

Agrega políticas de tags anexadas e herdadas para calcular a política efetiva do objeto.

Operadores de herança

Código de exemplo:

{
    "rg_inherit": {
        "color": {
            "tag_key": {
                "@@operators_allowed_for_child_policies": [
                    "@@none"
                ],
                "@@assign": "COLER"
            },
          	"resource_type_scope": {
              "@@operators_allowed_for_child_policies": [
                    "@@append"
                ],
                "@@assign": [
                    "ecs:instance"
                ]
            },
          	"region_scope": {
              "@@operators_allowed_for_child_policies": [
                    "@@append"
                ],
                "@@assign": [
                    "cn-hangzhou"
                ]
            },
          	"rg_scope": {
              "@@operators_allowed_for_child_policies": [
                    "@@append"
                ],
                "@@assign": [
                    "rg-xxxx"
                ]
            }
        }
    }
}

Corresponder valores de tag a uma expressão regular

Esse tipo de política começa com matched_tags.

Elemento

Obrigatório

Descrição

Exemplo

Chave da política

Sim

Identifica exclusivamente uma instrução. Use apenas minúsculas. É possível incluir várias chaves por política. A correspondência com chaves de tag não diferencia maiúsculas de minúsculas.

number

Chave da tag

Sim

Definida por tag_key. Diferencia maiúsculas de minúsculas.

NUMBER

Valor da tag

Sim

Definido por tag_value como uma expressão regular.

^[0-9]+$

Escopo do tipo de recurso

Não

Use resource_type_scope para especificar os tipos de recurso aos quais a política se aplica. Por padrão, abrange todos os tipos compatíveis com políticas de tags.

ecs:instance

Escopo da região

Não

Use region_scope para definir as regiões onde a política entra em vigor. Por padrão, aplica-se a todas as regiões.

cn-hangzhou

Escopo do grupo de recursos

Não

Use rg_scope para indicar os grupos de recursos afetados pela política. Se omitido, abrange todos os grupos de recursos.

rg-xxxx

Correção automática

Não

Ative tag_value_correction para ativar a correção automática de recursos não conformes. Desativado por padrão.

{
	"1": {
		"value_type": "Tag",
		"value_scope": {
			"acs:rm:rgId": "rg-xx1"
		}
	}
}

Operador de herança

Sim

Agrega políticas de tags anexadas e herdadas para calcular a política efetiva do objeto.

Operadores de herança

{
    "matched_tags": {
        "number": {
            "tag_key": {
                "@@operators_allowed_for_child_policies": [
                    "@@none"
                ],
                "@@assign": "NUMBER"
            },
            "tag_value": {
                "@@operators_allowed_for_child_policies": [
                    "@@assign"
                ],
                "@@assign": [
                    "^[0-9]+$"
                ]
            },
          	"resource_type_scope": {
              "@@operators_allowed_for_child_policies": [
                    "@@append"
                ],
                "@@assign": [
                    "ecs:instance"
                ]
            },
          	"region_scope": {
              "@@operators_allowed_for_child_policies": [
                    "@@append"
                ],
                "@@assign": [
                    "cn-hangzhou"
                ]
            },
          	"rg_scope": {
              "@@operators_allowed_for_child_policies": [
                    "@@append"
                ],
                "@@assign": [
                    "rg-xxxx"
                ]
            },
            "tag_value_correction": {
                "@@operators_allowed_for_child_policies": [
                    "@@none"
                ],
                "@@assign": {
                    "1": {
                        "value_type": "Tag",
                        "value_scope": {
                            "acs:rm:rgId": "rg-xx1"
                        }
                    },
                    "2": {
                        "value_type": "Tag",
                        "value_scope": {
                            "k1": "v2"
                        }
                    },
                    "3": {
                        "value_type": "Tag",
                        "value_scope": {
                            "k111": "v222"
                        }
                    }
                }
            }
        }
    }
}

Operadores de herança

Os operadores de herança agregam políticas de tags anexadas e herdadas para calcular a política efetiva de um objeto. Eles se dividem em duas categorias: operadores de definição de valor e operadores de controle filho.

Nota

No Quick Mode do console, há suporte apenas ao operador @@assign. Use o modo JSON para acessar os demais operadores.

  • Operadores de definição de valor

    Operador

    Descrição

    @@assign

    Substitui configurações conflitantes.

    • Se uma configuração na política anexada entrar em conflito com a política herdada, a política anexada terá precedência.

    • Quando múltiplas definições @@assign em políticas anexadas entrarem em conflito, a primeira política anexada prevalecerá.

    @@append

    Adiciona a configuração da política anexada à política herdada. Aplicável somente quando vários valores de tag forem especificados para uma chave de tag.

    @@remove

    Remove a configuração especificada da política herdada. Uso restrito a casos com múltiplos valores de tag definidos para uma mesma chave.

  • **Operadores de controle filho**

    Os operadores de controle filho limitam quais operadores de definição de valor as políticas filhas podem usar. Por padrão, todos os operadores de definição de valor são permitidos.

    Operador

    Descrição

    "@@operators_allowed_for_child_policies":["@@all"]

    Permite todos os operadores de definição de valor nas políticas filhas anexadas a subpastas e membros. Este é o comportamento padrão.

    "@@operators_allowed_for_child_policies":["@@assign"

    Restringe as políticas filhas apenas aos operadores de definição de valor especificados. É possível listar um ou mais operadores.

    "@@operators_allowed_for_child_policies":["@@none"]

    Bloqueia todos os operadores de definição de valor nas políticas filhas. Fixa as configurações da política pai para que funcionem como a política efetiva.

Referências