Todos os produtos
Search
Central de documentação

Cloud Config:CreateAggregateConfigRule

Última atualização: Jun 28, 2026

Cria uma regra para um grupo de contas especificado. Você pode criar uma regra a partir de um modelo ou criar uma regra personalizada usando o Function Compute. A regra verifica a conformidade dos seus recursos. Após a criação da regra, ela é executada automaticamente uma vez. O Cloud Config então executa avaliações com base no gatilho da regra. Você também pode executar avaliações manualmente.

Descrição da operação

Limites

Cada conta de gerenciamento e conta de administrador delegado pode ter até 200 regras.

Informações de contexto

O Cloud Config oferece suporte aos seguintes métodos para a criação de regras:

  • Criar regras a partir de modelos

    Os modelos de regras são funções de regra predefinidas que o Cloud Config fornece no Function Compute (FC). Use modelos de regras para criar regras rapidamente. Para obter mais informações sobre regras, consulte o documento referenciado.

  • Criar regras com base em funções no Function Compute

    As regras de função personalizadas são regras cujo código está hospedado em funções do FC. Se os modelos de regras predefinidos no Cloud Config não atenderem aos seus requisitos de conformidade, escreva o código da função para verificar a conformidade em cenários complexos. Para obter mais informações sobre regras de função personalizadas, consulte o documento referenciado.

Notas de uso

Este exemplo mostra como criar uma regra para o grupo de contas ca-a4e5626622af0079**** usando o modelo required-tags. A resposta mostra que a regra é criada com o ID cr-4e3d626622af0080****.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

config:CreateAggregateConfigRule

create

*AggregateConfigRule

acs:config:*:{#accountId}:aggregateconfigrule/*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ConfigRuleName

string

Sim

O nome da regra.

存在所有指定标签

Description

string

Não

A descrição da regra.

最多可以定义6组标签。如果资源同时具有指定的所有标签,则视为“合规”。

InputParameters

object

Não

Os parâmetros de entrada da regra.

{"tag1Key":"ECS","tag1Value":"test"}

ConfigRuleTriggerTypes

string

Sim

O tipo de gatilho da regra. Valores válidos:

  • ConfigurationItemChangeNotification: A regra é acionada quando a configuração de um recurso é alterada.

  • ScheduledNotification: A regra é acionada de acordo com uma programação.

ConfigurationItemChangeNotification

MaximumExecutionFrequency

string

Não

A frequência com que a regra é executada. Valores válidos:

  • One_Hour: 1 hora.

  • Three_Hours: 3 horas.

  • Six_Hours: 6 horas.

  • Twelve_Hours: 12 horas.

  • TwentyFour_Hours (padrão): 24 horas.

Nota

Defina este parâmetro se você definir ConfigRuleTriggerTypes como ScheduledNotification.

One_Hour

ResourceTypesScope

array

Sim

Os tipos de recurso a serem avaliados. Separe vários tipos com vírgulas (,).

ACS::ECS::Instance

string

Não

Os tipos de recurso a serem avaliados. Separe vários tipos com vírgulas (,).

ACS::ECS::Instance

RiskLevel

integer

Sim

O nível de risco da regra. Valores válidos:

  • 1: alto

  • 2: médio

  • 3: baixo

1

ClientToken

string

Não

Um token de cliente que garante que a solicitação seja idempotente. Gere um valor exclusivo a partir do seu cliente para cada solicitação. O parâmetro ClientToken deve conter apenas caracteres ASCII e ter no máximo 64 caracteres.

1594295238-f9361358-5843-4294-8d30-b5183fac****

AggregatorId

string

Sim

O ID do grupo de contas.

Para obter mais informações sobre como obter o ID de um grupo de contas, consulte o documento referenciado.

ca-a4e5626622af0079****

RegionIdsScope

string

Não

A regra se aplica apenas a recursos nas regiões especificadas. Separe vários IDs de região com vírgulas (,).

cn-hangzhou

ExcludeRegionIdsScope

string

Não

A regra não se aplica a recursos nas regiões especificadas. Os recursos nessas regiões não são avaliados. Separe vários IDs de região com vírgulas (,).

cn-shanghai

ResourceIdsScope

string

Não

A regra se aplica apenas aos recursos especificados. Separe vários IDs de recurso com vírgulas (,).

lb-5cmbowstbkss9ta03****

ExcludeResourceIdsScope

string

Não

A regra não se aplica aos recursos especificados. Esses recursos não são avaliados. Separe vários IDs de recurso com vírgulas (,).

lb-t4nbowvtbkss7t326****

ResourceGroupIdsScope

string

Não

A regra se aplica apenas a recursos nos grupos de recursos especificados. Separe vários IDs de grupo de recursos com vírgulas (,).

rg-aekzc7r7rhx****

ExcludeResourceGroupIdsScope

string

Não

A regra não se aplica a recursos nos grupos de recursos especificados. Os recursos nesses grupos não são avaliados. Separe vários IDs de grupo de recursos com vírgulas (,).

rg-bnczc6r7rml****

TagKeyScope deprecated

string

Não

Este parâmetro foi descontinuado. Em vez disso, use o parâmetro TagsScope.

A regra se aplica apenas a recursos que possuem as chaves de tag especificadas. Separe várias chaves de tag com vírgulas (,).

Nota

Este parâmetro se aplica apenas a modelos de regras. Defina TagKeyScope e TagValueScope juntos.

ECS

TagValueScope deprecated

string

Não

Este parâmetro foi descontinuado. Em vez disso, use o parâmetro TagsScope.

A regra se aplica apenas a recursos que possuem os valores de tag especificados.

Nota

Este parâmetro se aplica apenas a modelos de regras. Defina TagKeyScope e TagValueScope juntos.

test

TagKeyLogicScope

string

Não

A relação lógica entre várias tags no parâmetro TagsScope. Por exemplo, se você definir TagsScope como "TagsScope.1.TagKey":"a","TagsScope.1.TagValue":"a","TagsScope.2.TagKey":"b","TagsScope.2.TagValue":"b" e definir este parâmetro como AND, a regra se aplicará apenas a recursos que possuem as tags a:a e b:b. O valor padrão é OR.

Você também pode usar este parâmetro com o parâmetro descontinuado TagKeyScope, mas isso não é recomendado. Por exemplo, se você definir TagKeyScope como ECS,OSS e definir este parâmetro como AND, a regra se aplicará apenas a recursos que possuem as tags ECS e OSS.

Valores válidos:

  • AND

  • OR

Valores válidos:

  • OR :

    OR

  • AND :

    AND.

AND

TagsScope

array<object>

Não

O escopo de tags a serem incluídas.

object

Não

TagKey

string

Não

A chave da tag do recurso.

key-1

TagValue

string

Não

O valor da tag do recurso.

value-1

ExcludeTagsScope

array<object>

Não

O escopo de tags a serem excluídas.

object

Não

TagKey

string

Não

A chave da tag do recurso a ser excluído.

key-2

TagValue

string

Não

O valor da tag do recurso a ser excluído.

value-2

SourceOwner

string

Sim

O tipo de regra. Valores válidos:

  • ALIYUN: modelo de regra

  • CUSTOM_FC: regra personalizada do Function Compute

  • CUSTOM_CONFIGURATION: regra de condição personalizada

ALIYUN

SourceIdentifier

string

Sim

O identificador da regra.

  • Se SourceOwner for ALIYUN, insira o identificador do modelo de regra, como required-tags.

    Nota

    Para obter mais informações sobre como consultar identificadores de modelos de regras, consulte o documento referenciado.

  • Se SourceOwner for CUSTOM_CONFIGURATION, insira acs-config-configuration.

  • Se SourceOwner for CUSTOM_FC, insira o Alibaba Cloud Resource Name (ARN) da função do Function Compute.

    O formato do ARN é acs:fc:{region}:{accountId}:services/{serviceName}.LATEST/functions/{functionName}. Por exemplo, acs:fc:cn-hangzhou:120886317861****:services/service-test.LATEST/functions/config-test.

    Nota

    Para obter mais informações sobre como obter o ARN de uma função, consulte o documento referenciado.

required-tags

FolderIdsScope

string

Não

A regra se aplica apenas a recursos de contas de membro nas pastas especificadas. Separe vários IDs de pasta com vírgulas (,).

Nota
  • Este parâmetro se aplica apenas a regras de grupo de contas globais.

  • Este parâmetro se aplica apenas a modelos de regras.

fd-ZtHsRH****

ExcludeFolderIdsScope

string

Não

A regra não se aplica a recursos de contas de membro nas pastas especificadas. Os recursos nessas pastas não são avaliados. Separe vários IDs de pasta com vírgulas (,).

Nota
  • Este parâmetro se aplica apenas a regras de grupo de contas globais.

  • Este parâmetro se aplica apenas a modelos de regras.

fd-pWmkqZ****

ExcludeAccountIdsScope

string

Não

A regra não se aplica a recursos das contas de membro especificadas. Os recursos nessas contas não são avaliados. Separe vários IDs de conta de membro com vírgulas (,).

Nota

Este parâmetro se aplica apenas a modelos de regras.

120886317861****

AccountIdsScope

string

Não

A regra se aplica apenas a recursos das contas de membro especificadas. Separe vários IDs de conta de membro com vírgulas (,).

Nota

Este parâmetro se aplica apenas a modelos de regras.

115748125982****

Conditions

string

Não

As condições para uma regra de condição personalizada, no formato JSON.

{"ComplianceConditions":"{\"operator\":\"and\",\"children\":[{\"operator\":\"StringEquals\",\"featurePath\":\"$.Status\",\"desired\":\"1\",\"featureSource\":\"CONFIGURATION\"}]}"}

ExtendContent

string

Não

Conteúdo estendido. Atualmente, este parâmetro oferece suporte apenas à definição do horário de acionamento para regras executadas em um ciclo de 24 horas.

{"fixedHour":"12"}

Tag

array<object>

Não

A tag da regra.

object

Não

A tag.

Key

string

Não

A chave da tag.

Você pode adicionar até 20 chaves de tag.

key-1

Value

string

Não

O valor da tag.

Você pode adicionar até 20 valores de tag.

value-1

ResourceNameScope

string

Não

A regra se aplica apenas a recursos com os nomes especificados.

i-xxx

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Nenhum.

ConfigRuleId

string

O ID da regra.

cr-4e3d626622af0080****

RequestId

string

O ID da solicitação.

5895065A-196C-4254-8AD8-14EFC31EEF50

Exemplos

Resposta de sucesso

JSON formato

{
  "ConfigRuleId": "cr-4e3d626622af0080****",
  "RequestId": "5895065A-196C-4254-8AD8-14EFC31EEF50"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 ExceedMaxRuleCount The maximum number of rules is exceeded.
400 ConfigRuleNotExists The ConfigRule does not exist. The rule does not exist.
400 ConfigRuleExists The ConfigRule already exists.
400 Invalid.AggregatorId.Value The specified AggregatorId is invalid. The specified aggregator ID does not exist or you are not authorized to use the aggregator.
403 AggregatorMemberNoPermission The aggregator member is not authorized to perform the operation. The aggregator member is not authorized to perform the operation.
404 AccountNotExisted Your account does not exist.
503 ServiceUnavailable The request has failed due to a temporary failure of the server. The request has failed due to a temporary failure of the server.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.