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

Crea un paquete de cumplimiento para un grupo de cuentas especificado.

Descripción de la operación

Un paquete de cumplimiento es un conjunto de reglas. Al crear un paquete de cumplimiento, puede seleccionar reglas predeterminadas de una plantilla de paquete de cumplimiento, o bien seleccionar reglas de plantillas de reglas y listas de reglas existentes.

Una vez creado el paquete de cumplimiento, las reglas del paquete se evalúan una vez de forma predeterminada. Las evaluaciones posteriores se activan automáticamente según el mecanismo de activación de cada regla. También puede activar las evaluaciones manualmente.

Una plantilla de paquete de cumplimiento es un conjunto de reglas que Cloud Config personaliza para escenarios de cumplimiento.

Este tema proporciona un ejemplo de cómo crear un paquete de cumplimiento para el grupo de cuentas ca-f632626622af0079**** mediante la plantilla de paquete de cumplimiento ClassifiedProtectionPreCheck (paquete de cumplimiento de verificación previa de protección clasificada nivel 3).

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:CreateAggregateCompliancePack

create

*Paquete de cumplimiento agregado.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
CompliancePackTemplateId	string	No	El ID de la plantilla del paquete de cumplimiento. Para obtener información sobre cómo obtener el ID de la plantilla del paquete de cumplimiento, consulte ListCompliancePackTemplates.	ct-5f26ff4e06a300c4****
CompliancePackName	string	Sí	El nombre del paquete de cumplimiento.	Paquete de cumplimiento de verificación previa de protección clasificada nivel 3
Description	string	No	La descripción del paquete de cumplimiento.	Verifica el cumplimiento de los recursos en Alibaba Cloud según algunos requisitos de protección clasificada nivel 3
RiskLevel	integer	No	El nivel de riesgo del paquete de cumplimiento. Valores válidos: 1: riesgo alto. 2 (predeterminado): riesgo medio. 3: riesgo bajo. Valores válidos: 1 : Riesgo alto. 2 : Riesgo medio. 3 : Riesgo bajo.	2
AggregatorId	string	Sí	El ID del grupo de cuentas. Para obtener información sobre cómo obtener el ID del grupo de cuentas, consulte ListAggregators.	ca-f632626622af0079****
ConfigRules	array<object>	No	La lista de reglas en el paquete de cumplimiento. Nota Debe especificar este parámetro o `TemplateContent`.
	array<object>	No	La información de la regla.
ManagedRuleIdentifier	string	No	El identificador de la plantilla de regla. Cloud Config crea automáticamente una regla basada en el identificador de la plantilla de regla y agrega la regla al paquete de cumplimiento actual. Debe establecer `ManagedRuleIdentifier` o `ConfigRuleId`. Si se establecen ambos parámetros, `ConfigRuleId` tiene prioridad.	eip-bandwidth-limit
ConfigRuleName	string	No	El nombre de la regla.	El ancho de banda de una EIP cumple con el requisito mínimo
ConfigRuleParameters	array<object>	No	La información de los parámetros de la regla.
	object	No	La información de los parámetros de la regla.
ParameterName	string	No	El nombre del parámetro de la regla. Los parámetros ParameterName y ParameterValue deben especificarse juntos o dejarse vacíos al mismo tiempo. Si la plantilla de regla tiene parámetros sin valores predeterminados, debe especificar este parámetro.	bandwidth
ParameterValue	string	No	El valor del parámetro de la regla. Los parámetros ParameterName y ParameterValue deben especificarse juntos o dejarse vacíos al mismo tiempo. Si la plantilla de regla tiene parámetros sin valores predeterminados, debe especificar este parámetro.	10
ConfigRuleId	string	No	El ID de la regla. Cloud Config agrega la regla existente al paquete de cumplimiento actual. Debe especificar `ManagedRuleIdentifier` o `ConfigRuleId`. Si se especifican ambos parámetros, `ConfigRuleId` tiene prioridad.	cr-e918626622af000f****
Description	string	No	La descripción de la regla.	Una dirección IP elástica (EIP) asociada a una instancia de ECS o a una puerta de enlace NAT que no esté inactiva se considera conforme
RiskLevel	integer	No	El nivel de riesgo de la regla. Valores válidos: 1: riesgo alto. 2: riesgo medio. 3: riesgo bajo.	1
TemplateContent	string	No	La información de la plantilla utilizada para generar el paquete de cumplimiento. Puede ver el contenido de la plantilla desde la API de detalles de un paquete de cumplimiento existente, o consultar Escribir una plantilla de paquete de cumplimiento basada en configuración para crear la plantilla. Nota Debe especificar este parámetro o `TemplateContent`.	{ "configRuleTemplates": [ { "configRuleName": "Ejemplo de regla de condición personalizada", "scope": { "complianceResourceTypes": [ "ACS::ECS::Instance" ] }, "description": "", "source": { "owner": "CUSTOM_CONFIGURATION", "identifier": "acs-config-configuration", "sourceDetails": [ { "messageType": "ScheduledNotification", "maximumExecutionFrequency": "Twelve_Hours" }, { "messageType": "ConfigurationItemChangeNotification" } ], "conditions": "{\"ComplianceConditions\":\"{\\\"operator\\\":\\\"and\\\",\\\"children\\\":[{\\\"operator\\\":\\\"GreaterOrEquals\\\",\\\"featurePath\\\":\\\"$.Cpu\\\",\\\"featureSource\\\":\\\"CONFIGURATION\\\",\\\"desired\\\":\\\"2\\\"}]}\"}" }, "inputParameters": {} }, { "configRuleName": "El Referer de un bucket de OSS está en la lista blanca de protección contra hotlinking especificada", "scope": { "complianceResourceTypes": [ "ACS::OSS::Bucket" ] }, "description": "Un bucket de OSS con protección contra hotlinking habilitada y el Referer en la lista blanca especificada se considera conforme.", "source": { "owner": "ALIYUN", "identifier": "oss-bucket-referer-limit", "sourceDetails": [ { "messageType": "ConfigurationItemChangeNotification" } ] }, "inputParameters": { "allowEmptyReferer": "true", "allowReferers": "http://www.aliyun.com" } } ] }
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que el token sea único entre diferentes solicitudes. El parámetro ClientToken solo admite caracteres ASCII y no puede exceder los 64 caracteres de longitud.	1594295238-f9361358-5843-4294-8d30-b5183fac****
DefaultEnable	boolean	No	Especifica si la regla admite la habilitación rápida. Valores válidos: true: la regla se habilita cuando el paquete de cumplimiento se habilita rápidamente. false (predeterminado): la regla no se habilita.	false
RegionIdsScope	string	No	El paquete de cumplimiento solo surte efecto en los recursos de los ID de región especificados. Separe varios ID de región con comas (,).	cn-hangzhou
ExcludeRegionIdsScope	string	No	El paquete de cumplimiento no surte efecto en los recursos de las regiones especificadas. Los recursos en estas regiones no se evalúan. Separe varios ID de región con comas (,).	cn-shanghai
ExcludeResourceIdsScope	string	No	El paquete de cumplimiento no surte efecto en los ID de recurso especificados. Los recursos con estos ID no se evalúan. Separe varios ID de recurso con comas (,).	eip-8vbf3x310fn56ijfd****
ResourceIdsScope	string	No	La regla solo surte efecto en los ID de recurso especificados. Separe varios ID de recurso con comas (,).	lb-5cmbowstbkss9ta03****
ResourceGroupIdsScope	string	No	El paquete de cumplimiento solo surte efecto en los recursos de los ID de grupo de recursos especificados. Separe varios ID de grupo de recursos con comas (,).	rg-aekzc7r7rhx****
ExcludeResourceGroupIdsScope	string	No	La regla no surte efecto en los recursos de los ID de grupo de recursos especificados. Los recursos en estos grupos de recursos no se evalúan. Separe varios ID de grupo de recursos con comas (,).	rg-bnczc6r7rml****
TagKeyScope	string	No	El paquete de cumplimiento solo surte efecto en los recursos vinculados con la clave de etiqueta especificada.	ECS
TagValueScope	string	No	El paquete de cumplimiento solo surte efecto en los recursos vinculados con el par clave-valor de etiqueta especificado. Nota TagValueScope debe utilizarse junto con TagKeyScope.	test
TagsScope	array<object>	No	Las etiquetas efectivas.
	object	No
TagKey	string	No	La clave de etiqueta del recurso.	tagKey1
TagValue	string	No	El valor de etiqueta del recurso.	tagValue1
ExcludeTagsScope	array<object>	No	Las etiquetas excluidas.
	object	No	El alcance de etiquetas excluidas.
TagKey	string	No	La clave de etiqueta del recurso.	4
TagValue	string	No	El valor de etiqueta del recurso.	user
Tag	array<object>	No	Las etiquetas del recurso. Puede agregar hasta 20 etiquetas.
	object	No	Las etiquetas del recurso. Puede agregar hasta 20 etiquetas.
Key	string	No	La clave de etiqueta del recurso. Puede especificar hasta 20 claves de etiqueta.	key-1
Value	string	No	El valor de etiqueta del recurso. Puede especificar hasta 20 valores de etiqueta.	value-1

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
CompliancePackId	string	El ID del paquete de cumplimiento.	cp-fc56626622af00f9****
RequestId	string	El ID de la solicitud.	CC0CE5EB-E51E-48EB-B4AB-9A9E131ECC0F

Ejemplos

Respuesta exitosa

JSON Formato

{
  "CompliancePackId": "cp-fc56626622af00f9****",
  "RequestId": "CC0CE5EB-E51E-48EB-B4AB-9A9E131ECC0F"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	CompliancePackExists	The compliance pack already exists.
400	Invalid.AggregatorId.Value	The specified AggregatorId is invalid.
400	CompliancePackExceedMaxCount	The maximum number of compliance pack is exceeded.
400	Invalid.CompliancePackName.Value	The specified CompliancePackName is invalid.
400	Invalid.CompliancePackTemplateId.Value	The specified CompliancePackTemplateId does not exist.
400	Invalid.ConfigRules.Empty	You must specify ConfigRules.
400	Invalid.ConfigRules.Value	The specified ConfigRules is invalid.
400	ConfigRuleExceedMaxRuleCount	The maximum number of config rules is exceeded.
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.