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

Consulta todas las reglas de la lista de reglas.

Descripción de la operación

Este tema proporciona un ejemplo de cómo consultar la lista de reglas de la cuenta actual. La respuesta muestra que el número total de reglas en la lista de reglas es 1, el número de recursos evaluados es 3 y el resultado de la evaluación de cumplimiento es COMPLIANT.

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

list

*Rule.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ResourceTypes	string	No	El tipo de recurso que evalúa la regla.	ACS::ECS::Instance
PageSize	integer	No	El número de entradas por página. Valores válidos: de 1 a 100. Valor mínimo: 1. Valor predeterminado: 10.	10
CompliancePackId	string	No	El ID del paquete de cumplimiento.	cp-fe416457e0d90022****
ComplianceType	string	No	El resultado de la evaluación de cumplimiento de la regla. Valores válidos: COMPLIANT: Cumple. NON_COMPLIANT: No cumple. NOT_APPLICABLE: No aplicable. INSUFFICIENT_DATA: Sin datos. Valores válidos: NOT_APPLICABLE : No aplicable. COMPLIANT : Cumple. NON_COMPLIANT : No cumple. INSUFFICIENT_DATA : Sin datos. IGNORED : Ignorado.	COMPLIANT
PageNumber	integer	No	El número de página. Valor mínimo: 1. Valor predeterminado: 1.	1
Keyword	string	No	La palabra clave de consulta. Admite coincidencia aproximada en el ID de la regla, el nombre de la regla, la descripción de la regla y el identificador de la plantilla de regla.	ecs
ConfigRuleState	string	No	El estado de ejecución de la regla. Valores válidos: ACTIVE: Activo. DELETING: En eliminación. EVALUATING: En evaluación. INACTIVE: Inactivo. Valores válidos: EVALUATING : En evaluación. ACTIVE : Activo. INACTIVE : Inactivo. DELETING : En eliminación.	ACTIVE
ConfigRuleName	string	No	El nombre de la regla.	El nombre de la regla
RiskLevel	integer	No	El nivel de riesgo de la regla. Valores válidos: 1: Riesgo alto. 2: Riesgo medio. 3: Riesgo bajo.	1
SortBy	string	No	De forma predeterminada, no se especifica ningún valor. Actualmente se admite CreateDate-Desc, que ordena las reglas por fecha de creación en orden descendente.	CreateDate-Desc
Tag	array<object>	No	Las etiquetas del recurso. Se pueden vincular como máximo 20 etiquetas.
	object	No	Las etiquetas del recurso. Se pueden vincular como máximo 20 etiquetas.
Key	string	No	La clave de la etiqueta.	key-1
Value	string	No	El valor de la etiqueta.	value-1

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	AC3A7E12-72E6-5CC9-A5C1-D8D8919829A7
ConfigRules	object	La lista de reglas.
ConfigRuleList	array<object>	Los detalles de la lista de reglas.
	array<object>	Los detalles de la lista de reglas.
RiskLevel	integer	El nivel de riesgo de la regla. Valores válidos: 1: Riesgo alto. 2: Riesgo medio. 3: Riesgo bajo.	1
SourceOwner	string	El propietario del origen de la regla. Valores válidos: CUSTOM_FC: Regla personalizada. ALIYUN: Plantilla de regla.	ALIYUN
AccountId	integer	El ID de la cuenta a la que pertenece la regla.	100931896542****
ConfigRuleState	string	El estado de ejecución de la regla. Valores válidos: ACTIVE: Activo. DELETING: En eliminación. EVALUATING: En evaluación. INACTIVE: Inactivo.	ACTIVE
Compliance	object	El resultado de cumplimiento agregado de la regla.
ComplianceType	string	El resultado resumido de la evaluación de cumplimiento de la regla. Valores válidos: COMPLIANT: Cumple. NON_COMPLIANT: No cumple. NOT_APPLICABLE: No aplicable. INSUFFICIENT_DATA: Sin datos.	COMPLIANT
Count	integer	El número de evaluaciones que corresponden al resultado de cumplimiento resumido de la regla.	2
SourceIdentifier	string	El identificador de la regla. Si la regla se basa en una plantilla de regla, este parámetro especifica el identificador de la plantilla de regla. Si la regla es una regla personalizada, este parámetro especifica el ARN de la función.	eip-bandwidth-limit
ConfigRuleArn	string	El ARN de la regla.	acs:config::100931896542**:rule/cr-fdc8626622af00f9**
Description	string	La descripción de la regla.	La descripción de la regla
CreateBy	object	La información sobre el creador de la regla.
CompliancePackId	string	El ID del paquete de cumplimiento.	cp-fdc8626622af00f9****
CompliancePackName	string	El nombre del paquete de cumplimiento.	El nombre del paquete de cumplimiento
AutomationType	string	El tipo de corrección. Solo se admite OOS (CloudOps Orchestration Service).	OOS
ConfigRuleName	string	El nombre de la regla.	El nombre de la regla
ConfigRuleId	string	El ID de la regla.	cr-fdc8626622af00f9****
Tags	array<object>	Las etiquetas de la regla.
	object	Las etiquetas de la regla.
Key	string	La clave de la etiqueta de la regla.	env
Value	string	El valor de la etiqueta de la regla.	prod
ResourceTypesScope	string	Los tipos de recurso que evalúa la regla. Si hay varios tipos de recurso, se separan mediante comas (,).	ACS::EIP::EipAddress
CreateDate	string	La fecha y hora de creación de la regla (UTC+8).	2025-09-19T15:51:00
PageSize	integer	El número de entradas por página.	10
PageNumber	integer	El número de página.	1
TotalCount	integer	El número total de reglas.	1

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "AC3A7E12-72E6-5CC9-A5C1-D8D8919829A7",
  "ConfigRules": {
    "ConfigRuleList": [
      {
        "RiskLevel": 1,
        "SourceOwner": "ALIYUN",
        "AccountId": 0,
        "ConfigRuleState": "ACTIVE",
        "Compliance": {
          "ComplianceType": "COMPLIANT",
          "Count": 2
        },
        "SourceIdentifier": "eip-bandwidth-limit",
        "ConfigRuleArn": "acs:config::100931896542****:rule/cr-fdc8626622af00f9****",
        "Description": "La descripción de la regla",
        "CreateBy": {
          "CompliancePackId": "cp-fdc8626622af00f9****",
          "CompliancePackName": "El nombre del paquete de cumplimiento"
        },
        "AutomationType": "OOS",
        "ConfigRuleName": "El nombre de la regla",
        "ConfigRuleId": "cr-fdc8626622af00f9****",
        "Tags": [
          {
            "Key": "env",
            "Value": "prod"
          }
        ],
        "ResourceTypesScope": "ACS::EIP::EipAddress",
        "CreateDate": "2025-09-19T15:51:00"
      }
    ],
    "PageSize": 10,
    "PageNumber": 1,
    "TotalCount": 1
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error
400	NoPermission	You are not authorized to perform this operation.
400	Invalid.AggregatorId.Value	The specified AggregatorId is invalid.
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.