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
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
config:CreateAggregateConfigRule |
create |
*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 |
| MaximumExecutionFrequency |
string |
Não |
A frequência com que a regra é executada. Valores válidos:
Nota
Defina este parâmetro se você definir |
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 |
| 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 |
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 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 |
ECS |
TagValueScope
deprecated
|
string |
Não |
Este parâmetro foi descontinuado. Em vez disso, use o parâmetro 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 |
test |
| TagKeyLogicScope |
string |
Não |
A relação lógica entre várias tags no parâmetro Você também pode usar este parâmetro com o parâmetro descontinuado Valores válidos:
Valores válidos:
|
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 |
| SourceIdentifier |
string |
Sim |
O identificador da regra.
|
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
|
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
|
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.