

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Affichage d'octrois

Pour consulter la subvention, utilisez le [ListGrants](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListGrants.html) opération. Vous devez spécifier la clé KMS à laquelle les octrois s'appliquent. Vous pouvez également filtrer la liste des subventions par ID de subvention, par principal bénéficiaire ou par responsable de service du bénéficiaire. Pour obtenir plus d’exemples, consultez [Utiliser `ListGrants` avec un AWS SDK ou CLI](example_kms_ListGrants_section.md).

Pour consulter toutes les subventions dans Compte AWS et région avec une spécificité [directeur sortant](grants.md#terms-retiring-principal) ou [directeur de service partant à la retraite](grants.md#terms-retiring-service-principal), utiliser [ListRetirableGrants](https://docs.aws.amazon.com/kms/latest/APIReference/API_ListRetirableGrants.html). Les réponses comprennent des détails sur chaque octroi.

**Note**  
Le champ `GranteePrincipal` de la réponse `ListGrants` contient habituellement le bénéficiaire principal. Toutefois, lorsque le principal bénéficiaire de la subvention est AWS service, le `GranteePrincipal` le champ contient le [directeur de service](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#principal-services), qui peut représenter plusieurs directeurs de subventions différents.

**Note**  
Lorsqu'une subvention est créée avec [`GranteeServicePrincipal`](grants.md#terms-grantee-service-principal) paramètre, le `ListGrants` la réponse inclut un `GranteeServicePrincipal` champ au lieu de `GranteePrincipal`. Cela distingue les subventions qui ont été explicitement créées avec `GranteeServicePrincipal` pour un AWS [directeur de service](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#principal-services) à partir de subventions où AWS le service est représenté dans le `GranteePrincipal` champ.

Par exemple, la commande suivante répertorie tous les octrois d'une clé 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"
            ]
        }
    ]
}
```

L'exemple suivant montre un `ListGrants` réponse à une subvention créée avec `GranteeServicePrincipal`. Notez que la réponse inclut un `GranteeServicePrincipal` champ au lieu de `GranteePrincipal`, et le `Constraints` le champ contient un `SourceArn` valeur.

```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"
            ]
        }
    ]
}
```