CreateAggregateConfigRule - Cloud Config - Centro de documentación de Alibaba Cloud

Crea una regla para un grupo de cuentas especificado basada en una plantilla, o crea una regla personalizada basada en Function Compute para verificar el cumplimiento de los recursos. Después de crear una regla, esta activa automáticamente una evaluación. Cloud Config activa posteriormente las evaluaciones de forma automática según el mecanismo de activación de la regla. También puede activar las evaluaciones manualmente.

Descripción de la operación

Límites

Cada cuenta de administración y cuenta de administrador delegado pueden crear un máximo de 200 reglas.

Información general

Cloud Config admite los siguientes métodos para crear reglas:

Crear una regla basada en una plantilla

Una plantilla de regla es una función de regla que Cloud Config tiene integrada en Function Compute. Puede utilizar una plantilla de regla para crear rápidamente una regla. Para obtener más información sobre las reglas, consulte Definición y principio de funcionamiento de las reglas.
Crear una regla basada en Function Compute

Una regla de función personalizada es una regla personalizada cuyo código se aloja en una función de Function Compute. Si las plantillas de reglas predefinidas de Cloud Config no satisfacen sus requisitos para verificar el cumplimiento de los recursos, puede escribir código de función para realizar verificaciones de cumplimiento en escenarios complejos. Para obtener más información sobre las reglas de función personalizadas, consulte Definición y principio de funcionamiento de las reglas de función personalizadas.

Descripción

Este tema proporciona un ejemplo de cómo utilizar la plantilla de regla "required-tags" para crear una regla para el grupo de cuentas ca-a4e5626622af0079****. El resultado de la respuesta muestra que la regla se ha creado y que el ID de la regla es cr-4e3d626622af0080****.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

config:CreateAggregateConfigRule

create

*AggregateConfigRule.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ConfigRuleName	string	Sí	El nombre de la regla.	required-tags
Description	string	No	La descripción de la regla.	Se pueden definir hasta seis pares clave-valor de etiqueta. Si el recurso tiene todas las etiquetas especificadas, se considera "cumplidor"
InputParameters	object	No	Los parámetros de la regla.	{"tag1Key":"ECS","tag1Value":"test"}
ConfigRuleTriggerTypes	string	Sí	El mecanismo de activación de la regla. Valores válidos: ConfigurationItemChangeNotification: al cambiar la configuración. ScheduledNotification: ejecución periódica.	ConfigurationItemChangeNotification
MaximumExecutionFrequency	string	No	La frecuencia de ejecución de la regla. Valores válidos: One_Hour: 1 hora. Three_Hours: 3 horas. Six_Hours: 6 horas. Twelve_Hours: 12 horas. TwentyFour_Hours (predeterminado): 24 horas. Nota Este parámetro es obligatorio cuando `ConfigRuleTriggerTypes` se establece en `ScheduledNotification`. Valores válidos: Twelve_Hours : 12 horas. Three_Hours : 3 horas. Six_Hours : 6 horas. One_Hour : 1 hora. TwentyFour_Hours : 24 horas.	One_Hour
ResourceTypesScope	array	Sí	Los tipos de recursos que evaluará la regla. Separe varios tipos de recursos con comas (,).	ACS::ECS::Instance
	string	No	Los tipos de recursos que evaluará la regla. Separe varios tipos de recursos con comas (,).	ACS::ECS::Instance
RiskLevel	integer	Sí	El nivel de riesgo de la regla. Valores válidos: 1: riesgo alto. 2: riesgo medio. 3: riesgo bajo. Valores válidos: 1 : riesgo alto. 2 : riesgo medio. 3 : riesgo bajo.	1
ClientToken	string	No	Garantiza la idempotencia de la solicitud. Genere un valor único desde su cliente para asegurar que el valor sea único entre diferentes solicitudes. ClientToken solo admite caracteres ASCII y no puede exceder los 64 caracteres de longitud.	1594295238-f9361358-5843-4294-8d30-b5183fac****
AggregatorId	string	Sí	El ID del grupo de cuentas. Para obtener información sobre cómo conseguir el ID del grupo de cuentas, consulte ListAggregators.	ca-a4e5626622af0079****
RegionIdsScope	string	No	La regla se aplica solo a los recursos en los ID de región especificados. Separe varios ID de región con comas (,).	cn-hangzhou
ExcludeRegionIdsScope	string	No	La regla no se aplica a los recursos en los ID de región especificados, lo que significa que los recursos en esas regiones no se evalúan. Separe varios ID de región con comas (,).	cn-shanghai
ResourceIdsScope	string	No	La regla se aplica solo a los ID de recursos especificados. Separe varios ID de recursos con comas (,).	lb-5cmbowstbkss9ta03****
ExcludeResourceIdsScope	string	No	La regla no se aplica a los ID de recursos especificados, lo que significa que esos recursos no se evalúan. Separe varios ID de recursos con comas (,).	lb-t4nbowvtbkss7t326****
ResourceGroupIdsScope	string	No	La regla se aplica solo a los recursos en los ID de grupo de recursos especificados. Separe varios ID de grupos de recursos con comas (,).	rg-aekzc7r7rhx****
ExcludeResourceGroupIdsScope	string	No	La regla no se aplica a los recursos en los ID de grupo de recursos especificados, lo que significa que los recursos en esos grupos de recursos no se evalúan. Separe varios ID de grupos de recursos con comas (,).	rg-bnczc6r7rml****
TagKeyScope `deprecated`	string	No	[Obsoleto] Utilice el parámetro `TagsScope` en su lugar. La regla se aplica solo a los recursos vinculados con las etiquetas especificadas. Separe varias etiquetas con comas (,). Nota Este parámetro se aplica solo a plantillas de reglas. `TagKeyScope` y `TagValueScope` deben configurarse al mismo tiempo.	ECS
TagValueScope `deprecated`	string	No	[Obsoleto] Utilice el parámetro `TagsScope` en su lugar. La regla se aplica solo a los recursos vinculados con las etiquetas especificadas. Nota Este parámetro se aplica solo a plantillas de reglas. `TagKeyScope` y `TagValueScope` deben configurarse al mismo tiempo.	test
TagKeyLogicScope	string	No	La relación lógica cuando el parámetro `TagsScope` tiene múltiples valores. Por ejemplo, si `TagsScope` se establece en `"TagsScope.1.TagKey":"a","TagsScope.1.TagValue":"a","TagsScope.2.TagKey":"b","TagsScope.2.TagValue":"b"` y este parámetro se establece en `AND`, la regla se aplica solo a los recursos vinculados tanto con la etiqueta `a:a` como con la `b:b`. Si no se especifica este parámetro, se utiliza la lógica predeterminada `OR`. Este parámetro también se puede utilizar con el parámetro obsoleto `TagKeyScope` (no recomendado). Por ejemplo, si `TagKeyScope` se establece en `ECS,OSS` y este parámetro se establece en `AND`, la regla se aplica solo a los recursos vinculados tanto con la etiqueta `ECS` como con la `OSS`. Valores válidos: AND: y. OR: o. Valores válidos: OR : OR AND : AND.	AND
TagsScope	array<object>	No	El alcance de las etiquetas.
	object	No
TagKey	string	No	La clave de etiqueta del recurso.	key-1
TagValue	string	No	El valor de etiqueta del recurso.	value-1
ExcludeTagsScope	array<object>	No	El alcance de las etiquetas excluidas.
	object	No
TagKey	string	No	La clave de etiqueta del recurso que se va a excluir.	key-2
TagValue	string	No	El valor de etiqueta del recurso que se va a excluir.	value-2
SourceOwner	string	Sí	El tipo de regla. Valores válidos: ALIYUN: plantilla de regla. CUSTOM_FC: regla personalizada de Function Compute. CUSTOM_CONFIGURATION: regla de condición personalizada. Valores válidos: CUSTOM_CONFIGURATION : regla de condición personalizada. ALIYUN : plantilla de regla. CUSTOM_FC : regla personalizada de Function Compute.	ALIYUN
SourceIdentifier	string	Sí	El identificador de la regla. Si `SourceOwner` se establece en `ALIYUN`, introduzca el identificador de la plantilla de regla, como `required-tags`. Nota Para obtener información sobre cómo consultar el identificador de una plantilla de regla, consulte Lista de plantillas de reglas. Si `SourceOwner` se establece en `CUSTOM_CONFIGURATION`, introduzca `acs-config-configuration`. Si `SourceOwner` se establece en `CUSTOM_FC`, introduzca el Nombre de Recurso de Alibaba Cloud (ARN) de la función en Function Compute. El ARN tiene el formato `acs:fc:region:accountId:services/service name.LATEST/functions/functionName`, como `acs:fc:cn-hangzhou:120886317861**:services/service-test.LATEST/functions/config-test`. Nota** Para obtener información sobre cómo conseguir el ARN de la función, consulte ListFunctions.	required-tags
FolderIdsScope	string	No	La regla se aplica solo a los recursos dentro de las cuentas miembro bajo los ID de carpeta del directorio de recursos especificados. Separe varios ID de carpetas con comas (,). Nota Este parámetro se aplica solo a reglas de un grupo de cuentas global. Este parámetro se aplica solo a plantillas de reglas.	fd-ZtHsRH****
ExcludeFolderIdsScope	string	No	La regla no se aplica a los recursos dentro de las cuentas miembro bajo los ID de carpeta del directorio de recursos especificados, lo que significa que esos recursos no se evalúan. Separe varios ID de carpetas con comas (,). Nota Este parámetro se aplica solo a reglas de un grupo de cuentas global. Este parámetro se aplica solo a plantillas de reglas.	fd-pWmkqZ****
ExcludeAccountIdsScope	string	No	La regla no se aplica a los recursos dentro de las cuentas miembro especificadas, lo que significa que la evaluación no se ejecuta para esos recursos. Separe varios ID de cuentas miembro con comas (,). Nota Este parámetro se aplica solo a plantillas de reglas.	120886317861****
AccountIdsScope	string	No	La regla se aplica solo a los recursos dentro de las cuentas miembro especificadas. Separe varios ID de cuentas miembro con comas (,). Nota Este parámetro se aplica solo a plantillas de reglas.	115748125982****
Conditions	string	No	Las condiciones de la regla de condición personalizada en formato JSON.	{"ComplianceConditions":"{\"operator\":\"and\",\"children\":[{\"operator\":\"StringEquals\",\"featurePath\":\"$.Status\",\"desired\":\"1\",\"featureSource\":\"CONFIGURATION\"}]}"}
ExtendContent	string	No	El contenido extendido. Actualmente, este parámetro se utiliza solo para configurar la hora de activación junto con la activación periódica de 24 horas.	{"fixedHour":"12"}
Tag	array<object>	No	Las etiquetas de la regla creada.
	object	No	La etiqueta.
Key	string	No	La clave de etiqueta del recurso. Se pueden vincular un máximo de 20 claves de etiqueta.	key-1
Value	string	No	El valor de etiqueta del recurso. Se pueden vincular un máximo de 20 valores de etiqueta.	value-1
ResourceNameScope	string	No	La regla se aplica solo a los recursos con el nombre de recurso especificado.	i-xxx

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
ConfigRuleId	string	El ID de la regla.	cr-4e3d626622af0080****
RequestId	string	El ID de la solicitud.	5895065A-196C-4254-8AD8-14EFC31EEF50

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	ExceedMaxRuleCount	The maximum number of rules is exceeded.
400	ConfigRuleNotExists	The ConfigRule does not exist.
400	ConfigRuleExists	The ConfigRule already exists.
400	Invalid.AggregatorId.Value	The specified AggregatorId is invalid.
403	AggregatorMemberNoPermission	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.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.