

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 concesiones

Para ver la subvención, utilice el [ListGrants](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListGrants.html) operación. Debe especificar la clave KMS a la que se aplican las concesiones. También puede filtrar la lista de subvenciones por ID de subvención, director del concesionario o director del servicio del concesionario. Para obtener más ejemplos, consulte [Usa `ListGrants` con un AWS SDK o CLI](example_kms_ListGrants_section.md).

Para ver todas las subvenciones en Cuenta de AWS y una región con una en particular [director jubilado](grants.md#terms-retiring-principal) o [director del servicio jubilado](grants.md#terms-retiring-service-principal), usa [ListRetirableGrants](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListRetirableGrants.html). Las respuestas incluyen detalles sobre cada concesión.

**nota**  
El campo `GranteePrincipal` de la respuesta `ListGrants` generalmente contiene el principal beneficiario de la concesión. Sin embargo, cuando el director del concesionario de la subvención es un AWS servicio, el `GranteePrincipal` el campo contiene el [principal de servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#principal-services), que puede representar a varios directores de concesionarios diferentes.

**nota**  
Cuando se crea una subvención con el [`GranteeServicePrincipal`](grants.md#terms-grantee-service-principal) parámetro, el `ListGrants` la respuesta incluye un `GranteeServicePrincipal` campo en lugar de `GranteePrincipal`. Esto distingue las subvenciones que se crearon explícitamente con `GranteeServicePrincipal` para un AWS [director de servicio](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#principal-services) de subvenciones en las que un AWS el servicio está representado en el `GranteePrincipal` campo.

Por ejemplo, el siguiente comando muestra todas las concesiones de una clave KMS.

```bash
$  aws kms list-grants --key-id 1234abcd-12ab-34cd-56ef-1234567890ab
{
    "Grants": [
        {
            "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
            "CreationDate": 1572216195.0,
            "GrantId": "abcde1237f76e4ba7987489ac329fbfba6ad343d6f7075dbd1ef191f0120514a",
            "Constraints": {
                "EncryptionContextSubset": {
                    "Department": "IT"
                }
            },
            "RetiringPrincipal": "arn:aws:iam::111122223333:role/adminRole",
            "Name": "",
            "IssuingAccount": "arn:aws:iam::111122223333:root",
            "GranteePrincipal": "arn:aws:iam::111122223333:user/exampleUser",
            "Operations": [
                "Decrypt"
            ]
        }
    ]
}
```

El siguiente ejemplo muestra un `ListGrants` respuesta para una subvención creada con `GranteeServicePrincipal`. Tenga en cuenta que la respuesta incluye un `GranteeServicePrincipal` campo en lugar de `GranteePrincipal`, y el `Constraints` el campo contiene un `SourceArn` valor.

```bash
$  aws kms list-grants --key-id 1234abcd-12ab-34cd-56ef-1234567890ab
{
    "Grants": [
        {
            "KeyId": "arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
            "CreationDate": 1718567315.0,
            "GrantId": "abcde1237f76e4ba7987489ac329fbfba6ad343d6f7075dbd1ef191f0120514a",
            "Constraints": {
                "EncryptionContextSubset": {
                    "Department": "IT"
                },
                "SourceArn": "arn:aws:dynamodb:us-east-1:111122223333:table/ExampleTable"
            },
            "RetiringServicePrincipal": "{{service-name}}.amazonaws.com",
            "Name": "",
            "IssuingAccount": "arn:aws:iam::111122223333:root",
            "GranteeServicePrincipal": "{{service-name}}.amazonaws.com",
            "Operations": [
                "Encrypt",
                "Decrypt",
                "GenerateDataKey"
            ]
        }
    ]
}
```