

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Visualización de la información de cumplimiento y los resultados de la evaluación de su AWS Recursos con AWS Config

**importante**  
Para obtener informes precisos sobre el estado de cumplimiento, debe registrar el tipo de recurso de `AWS::Config::ResourceCompliance`. Para obtener más información, consulte [Grabación AWS Recursos](https://docs.aws.amazon.com/config/latest/developerguide/select-resources.html).

Puedes usar el AWS Config consola o AWS SDK para ver la información de cumplimiento y los resultados de la evaluación de sus recursos.

**Topics**
+ [Visualización de la conformidad (consola)](#evaluate-config_view-compliance-console)
+ [Visualización del cumplimiento (AWS (SDKs)](#evaluate-config_view-compliance-cli)

## Visualización de la conformidad (consola)
<a name="evaluate-config_view-compliance-console"></a>

### Visualización de la conformidad (consola)
<a name="evaluate-config_view-compliance-console-collapsible"></a>

1. Inicie sesión en el Consola de administración de AWS y abre el AWS Config consola en [https://console.aws.amazon.com/config/home](https://console.aws.amazon.com/config/home).

1. En el Consola de administración de AWS en el menú, compruebe que el selector de regiones esté configurado en una región compatible AWS Config reglas. Para ver una lista de las regiones admitidas, consulte [Regiones y puntos de enlace de AWS Config](https://docs.aws.amazon.com/general/latest/gr/rande.html#awsconfig_region) en la *Referencia general de Amazon Web Services*.

1. En el panel de navegación, elija **Recursos**. En la página Inventario de recursos, puede filtrar por categoría de recurso, tipo de recurso y estado de conformidad. Seleccione **Incluir los recursos eliminados**, si procede. En la tabla se muestra el identificador de recurso para el tipo de recurso y el estado de conformidad de ese recurso. El identificador de recursos puede ser un ID o un nombre de recurso. 

1. Elija un recurso de la columna del identificador de recursos.

1. Elija el botón **Escala de tiempo del recurso**. Puede filtrar por eventos de configuración, eventos de cumplimiento o CloudTrail Eventos.
**nota**  
O bien, en la página Inventario de recursos, puede hacer clic directamente en el nombre del recurso. Para acceder a la escala de tiempo del recurso desde la página de detalles del recurso, elija el botón **Escala de tiempo del recurso**.

También puede ver la conformidad de sus recursos a través de búsquedas en la página **Resource inventory**. Para obtener más información, consulte [Búsqueda de recursos descubiertos por AWS Config](looking-up-discovered-resources.md).

## Visualización del cumplimiento (AWS (SDKs)
<a name="evaluate-config_view-compliance-cli"></a>

### Para obtener información de cumplimiento para su AWS recursos
<a name="evaluate-config_view-compliance-sdk-compliance-resources-collapsible"></a>

Los siguientes ejemplos de código muestran cómo utilizar `DescribeComplianceByResource`.

------
#### [ CLI ]

**AWS CLI**  
**Para obtener información de cumplimiento para su AWS recursos**  
Los siguientes `describe-compliance-by-resource` El ejemplo devuelve la información de cumplimiento de cada instancia EC2 registrada por AWS Config y eso infringe una o más reglas.  

```
aws configservice describe-compliance-by-resource \
    --resource-type {{AWS::EC2::Instance}} \
    --compliance-types {{NON_COMPLIANT}}
```
En el resultado, el valor de cada atributo de `CappedCount` indica cuántas reglas infringe el recurso. Por ejemplo, el siguiente resultado indica que la instancia `i-1a2b3c4d` infringe dos reglas.  
Salida:  

```
{
    "ComplianceByResources": [
        {
            "ResourceType": "AWS::EC2::Instance",
            "ResourceId": "i-1a2b3c4d",
            "Compliance": {
                "ComplianceContributorCount": {
                    "CappedCount": 2,
                    "CapExceeded": false
                },
                "ComplianceType": "NON_COMPLIANT"
            }
        },
        {
            "ResourceType": "AWS::EC2::Instance",
            "ResourceId": "i-2a2b3c4d ",
            "Compliance": {
                "ComplianceContributorCount": {
                    "CappedCount": 3,
                    "CapExceeded": false
                },
                "ComplianceType": "NON_COMPLIANT"
            }
        }
    ]
}
```
Para obtener más información, consulte [Visualización de la información de cumplimiento y los resultados de la evaluación de su AWS Recursos con AWS Configuración](https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config_view-compliance.html) en el *AWS Guía para desarrolladores de Config*.  
+  Para obtener más información sobre la API, consulte [DescribeComplianceByResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/describe-compliance-by-resource.html) en *AWS CLI Referencia de comandos*. 

------
#### [ PowerShell ]

**Herramientas para PowerShell V4**  
**Ejemplo 1: En este ejemplo, se revisa el tipo de recurso `AWS::SSM::ManagedInstanceInventory` para el tipo de cumplimiento COMPLIANT.**  

```powershell
Get-CFGComplianceByResource -ComplianceType COMPLIANT -ResourceType AWS::SSM::ManagedInstanceInventory
```
**Salida:**  

```
Compliance                            ResourceId          ResourceType
----------                            ----------          ------------
Amazon.ConfigService.Model.Compliance i-0123bcf4b567890e3 AWS::SSM::ManagedInstanceInventory
Amazon.ConfigService.Model.Compliance i-0a1234f6f5d6b78f7 AWS::SSM::ManagedInstanceInventory
```
+  Para obtener más información sobre la API, consulte [DescribeComplianceByResource](https://docs.aws.amazon.com/powershell/v4/reference) en *Herramientas de AWS para PowerShell Referencia de cmdlets (V4)*. 

**Herramientas para PowerShell V5**  
**Ejemplo 1: En este ejemplo, se revisa el tipo de recurso `AWS::SSM::ManagedInstanceInventory` para el tipo de cumplimiento COMPLIANT.**  

```powershell
Get-CFGComplianceByResource -ComplianceType COMPLIANT -ResourceType AWS::SSM::ManagedInstanceInventory
```
**Salida:**  

```
Compliance                            ResourceId          ResourceType
----------                            ----------          ------------
Amazon.ConfigService.Model.Compliance i-0123bcf4b567890e3 AWS::SSM::ManagedInstanceInventory
Amazon.ConfigService.Model.Compliance i-0a1234f6f5d6b78f7 AWS::SSM::ManagedInstanceInventory
```
+  Para obtener más información sobre la API, consulte [DescribeComplianceByResource](https://docs.aws.amazon.com/powershell/v5/reference) en *Herramientas de AWS para PowerShell Referencia de cmdlets (V5)*. 

------

### Para obtener el resumen de cumplimiento de su AWS recursos
<a name="evaluate-config_view-compliance-sdk-compliance-summary-resources-collapsible"></a>

Los siguientes ejemplos de código muestran cómo utilizar `GetComplianceSummaryByResourceType`.

------
#### [ CLI ]

**AWS CLI**  
**Ejemplo 1: Para obtener el resumen de cumplimiento de todos los tipos de recursos**  
Lo siguiente `get-compliance-summary-by-resource-type` el ejemplo devuelve el número de AWS los recursos que no cumplen con los requisitos y el número de los que sí lo son.  

```
aws configservice get-compliance-summary-by-resource-type
```
En el resultado, el valor de cada atributo `CappedCount` indica el número de recursos conformes y el de no conformes.  
Salida:  

```
{
    "ComplianceSummariesByResourceType": [
        {
            "ComplianceSummary": {
                "NonCompliantResourceCount": {
                    "CappedCount": 16,
                    "CapExceeded": false
                },
                "ComplianceSummaryTimestamp": 1453237464.543,
                "CompliantResourceCount": {
                    "CappedCount": 10,
                    "CapExceeded": false
                }
            }
        }
    ]
}
```
Para obtener más información, consulte [Visualización de la información de cumplimiento y los resultados de la evaluación de su AWS Recursos con AWS Configuración](https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config_view-compliance.html) en el *AWS Guía para desarrolladores de Config*.  
**Ejemplo 2: Para obtener el resumen de cumplimiento de un tipo de recurso específico**  
Lo siguiente `get-compliance-summary-by-resource-type` el ejemplo devuelve el número de instancias EC2 que no cumplen con los requisitos y el número que sí lo son.  

```
aws configservice get-compliance-summary-by-resource-type \
    --resource-types {{AWS::EC2::Instance}}
```
En el resultado, el valor de cada atributo `CappedCount` indica el número de recursos conformes y el de no conformes.  
Salida:  

```
{
    "ComplianceSummariesByResourceType": [
        {
            "ResourceType": "AWS::EC2::Instance",
            "ComplianceSummary": {
                "NonCompliantResourceCount": {
                    "CappedCount": 3,
                    "CapExceeded": false
                },
                "ComplianceSummaryTimestamp": 1452204923.518,
                "CompliantResourceCount": {
                    "CappedCount": 7,
                    "CapExceeded": false
                }
            }
        }
    ]
}
```
Para obtener más información, consulte [Visualización de la información de cumplimiento y los resultados de la evaluación de su AWS Recursos con AWS Configuración](https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config_view-compliance.html) en el *AWS Guía para desarrolladores de Config*.  
+  Para obtener más información sobre la API, consulte [GetComplianceSummaryByResourceType](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-compliance-summary-by-resource-type.html) en *AWS CLI Referencia de comandos*. 

------
#### [ PowerShell ]

**Herramientas para PowerShell V4**  
**Ejemplo 1: En este ejemplo, se devuelve el número de recursos conformes y no conformes, y se convierte el resultado en json.**  

```powershell
Get-CFGComplianceSummaryByResourceType -Select ComplianceSummariesByResourceType.ComplianceSummary | ConvertTo-Json
{
  "ComplianceSummaryTimestamp": "2019-12-14T06:14:49.778Z",
  "CompliantResourceCount": {
    "CapExceeded": false,
    "CappedCount": 2
  },
  "NonCompliantResourceCount": {
    "CapExceeded": true,
    "CappedCount": 100
  }
}
```
+  Para obtener más información sobre la API, consulte [GetComplianceSummaryByResourceType](https://docs.aws.amazon.com/powershell/v4/reference) en *Herramientas de AWS para PowerShell Referencia de cmdlets (V4)*. 

**Herramientas para PowerShell V5**  
**Ejemplo 1: En este ejemplo, se devuelve el número de recursos conformes y no conformes, y se convierte el resultado en json.**  

```powershell
Get-CFGComplianceSummaryByResourceType -Select ComplianceSummariesByResourceType.ComplianceSummary | ConvertTo-Json
{
  "ComplianceSummaryTimestamp": "2019-12-14T06:14:49.778Z",
  "CompliantResourceCount": {
    "CapExceeded": false,
    "CappedCount": 2
  },
  "NonCompliantResourceCount": {
    "CapExceeded": true,
    "CappedCount": 100
  }
}
```
+  Para obtener más información sobre la API, consulte [GetComplianceSummaryByResourceType](https://docs.aws.amazon.com/powershell/v5/reference) en *Herramientas de AWS para PowerShell Referencia de cmdlets (V5)*. 

------

### Para obtener los resultados de la evaluación de un AWS recurso
<a name="evaluate-config_view-compliance-sdk-evaluation-results-resources-collapsible"></a>

Los siguientes ejemplos de código muestran cómo utilizar `GetComplianceDetailsByResource`.

------
#### [ CLI ]

**AWS CLI**  
**Para obtener los resultados de la evaluación de un AWS recurso**  
El siguiente `get-compliance-details-by-resource` el ejemplo devuelve los resultados de la evaluación de cada regla con la que se utiliza la instancia EC2 `i-1a2b3c4d` no cumple.  

```
aws configservice get-compliance-details-by-resource \
    --resource-type {{AWS::EC2::Instance}} \
    --resource-id {{i-1a2b3c4d}} \
    --compliance-types {{NON_COMPLIANT}}
```
Salida:  

```
{
    "EvaluationResults": [
        {
            "EvaluationResultIdentifier": {
                "OrderingTimestamp": 1450314635.065,
                "EvaluationResultQualifier": {
                    "ResourceType": "AWS::EC2::Instance",
                    "ResourceId": "i-1a2b3c4d",
                    "ConfigRuleName": "InstanceTypesAreT2micro"
                }
            },
            "ResultRecordedTime": 1450314643.288,
            "ConfigRuleInvokedTime": 1450314643.034,
            "ComplianceType": "NON_COMPLIANT"
        },
        {
            "EvaluationResultIdentifier": {
                "OrderingTimestamp": 1450314635.065,
                "EvaluationResultQualifier": {
                    "ResourceType": "AWS::EC2::Instance",
                    "ResourceId": "i-1a2b3c4d",
                    "ConfigRuleName": "RequiredTagForEC2Instances"
                }
            },
            "ResultRecordedTime": 1450314645.261,
            "ConfigRuleInvokedTime": 1450314642.948,
            "ComplianceType": "NON_COMPLIANT"
        }
    ]
}
```
Para obtener más información, consulte [Visualización de la información de cumplimiento y los resultados de la evaluación de su AWS Recursos con AWS Configuración](https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config_view-compliance.html) en el *AWS Guía para desarrolladores de Config*.  
+  Para obtener más información sobre la API, consulte [GetComplianceDetailsByResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/configservice/get-compliance-details-by-resource.html) en *AWS CLI Referencia de comandos*. 

------
#### [ PowerShell ]

**Herramientas para PowerShell V4**  
**Ejemplo 1: Este ejemplo devuelve los resultados de la evaluación de un recurso determinado.**  

```powershell
Get-CFGComplianceDetailsByResource -ResourceId ABCD5STJ4EFGHIVEW6JAH -ResourceType 'AWS::IAM::User'
```
**Salida:**  

```
Annotation                 :
ComplianceType             : COMPLIANT
ConfigRuleInvokedTime      : 8/25/2019 11:34:56 PM
EvaluationResultIdentifier : Amazon.ConfigService.Model.EvaluationResultIdentifier
ResultRecordedTime         : 8/25/2019 11:34:56 PM
ResultToken                :
```
+  Para obtener más información sobre la API, consulte [GetComplianceDetailsByResource](https://docs.aws.amazon.com/powershell/v4/reference) en *Herramientas de AWS para PowerShell Referencia de cmdlets (V4)*. 

**Herramientas para PowerShell V5**  
**Ejemplo 1: Este ejemplo devuelve los resultados de la evaluación de un recurso determinado.**  

```powershell
Get-CFGComplianceDetailsByResource -ResourceId ABCD5STJ4EFGHIVEW6JAH -ResourceType 'AWS::IAM::User'
```
**Salida:**  

```
Annotation                 :
ComplianceType             : COMPLIANT
ConfigRuleInvokedTime      : 8/25/2019 11:34:56 PM
EvaluationResultIdentifier : Amazon.ConfigService.Model.EvaluationResultIdentifier
ResultRecordedTime         : 8/25/2019 11:34:56 PM
ResultToken                :
```
+  Para obtener más información sobre la API, consulte [GetComplianceDetailsByResource](https://docs.aws.amazon.com/powershell/v5/reference) en *Herramientas de AWS para PowerShell Referencia de cmdlets (V5)*. 

------