D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
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.
# Exemples de Detective utilisant AWS CLI
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS Command Line Interface with Detective.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.
**Topics**
+ [Actions](#actions)
## Actions
### `accept-invitation`
L'exemple de code suivant montre comment utiliser`accept-invitation`.
**AWS CLI**
**Pour accepter une invitation à devenir un compte membre dans un graphe de comportement**
L’exemple `accept-invitation` suivant accepte une invitation à devenir un compte membre dans le graphe de comportement arn:aws:detective:us-east-1:111122223333:graph:123412341234.
```
aws detective accept-invitation \
--graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Réponse à une invitation de graphe de comportement](https://docs.aws.amazon.com/detective/latest/adminguide/member-invitation-response.html) dans le *Guide de l’administrateur Amazon Detective*.
+ Pour plus de détails sur l'API, reportez-vous [AcceptInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/accept-invitation.html)à la section *Référence des AWS CLI commandes*.
### `create-graph`
L'exemple de code suivant montre comment utiliser`create-graph`.
**AWS CLI**
**Pour activer Amazon Detective et créer un graphe de comportement**
L'`create-graph`exemple suivant active Detective pour le AWS compte qui exécute la commande dans la région où la commande est exécutée. Un graphe de comportement est créé avec ce compte comme compte administrateur. La commande affecte également la valeur Finance à la balise Department.
```
aws detective create-graph \
--tags '{"Department": "Finance"}'
```
Sortie :
```
{
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:027c7c4610ea4aacaf0b883093cab899"
}
```
Pour plus d’informations, consultez [Activation d’Amazon Detective](https://docs.aws.amazon.com/detective/latest/adminguide/detective-enabling.html) dans le *Guide de l’administrateur Amazon Detective*.
+ Pour plus de détails sur l'API, reportez-vous [CreateGraph](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/create-graph.html)à la section *Référence des AWS CLI commandes*.
### `create-members`
L'exemple de code suivant montre comment utiliser`create-members`.
**AWS CLI**
**Pour inviter des comptes membres à accéder à un graphe de comportement**
L'`create-members`exemple suivant invite deux AWS comptes à devenir des comptes membres dans le graphe de comportement arn:aws:detective:us-east- 1:111122223333:graph:123412341234. Pour chaque compte, la demande fournit l'ID du AWS compte et l'adresse e-mail de l'utilisateur root du compte. La demande inclut un message personnalisé à insérer dans l’e-mail d’invitation.
```
aws detective create-members \
--accounts AccountId=444455556666,EmailAddress=mmajor@example.com AccountId=123456789012,EmailAddress=jstiles@example.com \
--graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
--message "This is Paul Santos. I need to add your account to the data we use for security investigation in Amazon Detective. If you have any questions, contact me at psantos@example.com."
```
Sortie :
```
{
"Members": [
{
"AccountId": "444455556666",
"AdministratorId": "111122223333",
"EmailAddress": "mmajor@example.com",
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
"InvitedTime": 1579826107000,
"MasterId": "111122223333",
"Status": "INVITED",
"UpdatedTime": 1579826107000
},
{
"AccountId": "123456789012",
"AdministratorId": "111122223333",
"EmailAddress": "jstiles@example.com",
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
"InvitedTime": 1579826107000,
"MasterId": "111122223333",
"Status": "VERIFICATION_IN_PROGRESS",
"UpdatedTime": 1579826107000
}
],
"UnprocessedAccounts": [ ]
}
```
Pour plus d'informations, consultez la section Invitation des comptes membres à un graphe de comportement < https://docs.aws.amazon.com/detective/ latest/adminguide/graph - admin-add-member-accounts .html> dans le guide d'administration d'Amazon *Detective*.
**Pour inviter des comptes membres sans envoyer d’e-mails d’invitation**
L'`create-members`exemple suivant invite deux AWS comptes à devenir des comptes membres dans le graphe de comportement arn:aws:detective:us-east- 1:111122223333:graph:123412341234. Pour chaque compte, la demande fournit l'ID du AWS compte et l'adresse e-mail de l'utilisateur root du compte. Les comptes membres ne reçoivent pas d’e-mails d’invitation.
```
aws detective create-members \
--accounts AccountId=444455556666,EmailAddress=mmajor@example.com AccountId=123456789012,EmailAddress=jstiles@example.com \
--graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
--disable-email-notification
```
Sortie :
```
{
"Members": [
{
"AccountId": "444455556666",
"AdministratorId": "111122223333",
"EmailAddress": "mmajor@example.com",
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
"InvitedTime": 1579826107000,
"MasterId": "111122223333",
"Status": "INVITED",
"UpdatedTime": 1579826107000
},
{
"AccountId": "123456789012",
"AdministratorId": "111122223333",
"EmailAddress": "jstiles@example.com",
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
"InvitedTime": 1579826107000,
"MasterId": "111122223333",
"Status": "VERIFICATION_IN_PROGRESS",
"UpdatedTime": 1579826107000
}
],
"UnprocessedAccounts": [ ]
}
```
Pour plus d'informations, consultez la section Invitation des comptes membres à un graphe de comportement < https://docs.aws.amazon.com/detective/ latest/adminguide/graph - admin-add-member-accounts .html> dans le guide d'administration d'Amazon *Detective*.
+ Pour plus de détails sur l'API, reportez-vous [CreateMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/create-members.html)à la section *Référence des AWS CLI commandes*.
### `delete-graph`
L'exemple de code suivant montre comment utiliser`delete-graph`.
**AWS CLI**
**Pour désactiver Detective et supprimer le graphe de comportement**
L’exemple `delete-graph` suivant désactive Detective et supprime le graphe de comportement spécifié.
```
aws detective delete-graph \
--graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Désactivation Amazon Detective](https://docs.aws.amazon.com/detective/latest/adminguide/detective-disabling.html) dans le *Guide de l’administrateur Amazon Detective*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteGraph](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/delete-graph.html)à la section *Référence des AWS CLI commandes*.
### `delete-members`
L'exemple de code suivant montre comment utiliser`delete-members`.
**AWS CLI**
**Pour supprimer des comptes membres d’un graphe de comportement**
L’exemple `delete-members` suivant supprime deux comptes membres du graphe de comportement arn:aws:detective:us-east-1:111122223333:graph:123412341234. Pour identifier les comptes, la demande fournit le AWS compte IDs.
```
aws detective delete-members \
--account-ids 444455556666 123456789012 \
--graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234
```
Sortie :
```
{
"AccountIds": [ "444455556666", "123456789012" ],
"UnprocessedAccounts": [ ]
}
```
Pour plus d'informations, consultez Supprimer des comptes membres d'un graphe de comportement < https://docs.aws.amazon.com/detective/ latest/adminguide/graph - admin-remove-member-accounts .html> dans le guide d'administration d'Amazon *Detective*.
+ Pour plus de détails sur l'API, reportez-vous [DeleteMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/delete-members.html)à la section *Référence des AWS CLI commandes*.
### `disassociate-membership`
L'exemple de code suivant montre comment utiliser`disassociate-membership`.
**AWS CLI**
**Pour résilier une adhésion d’un graphe de comportement**
L'exemple de désassociation suivant supprime le AWS compte qui exécute la commande du graphe de comportement arn:aws:detective:us-east- 1:111122223333:graph:123412341234.
```
aws detective disassociate-membership \
--graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234
```
Pour plus d'informations, consultez Supprimer votre compte d'un graphe de comportement < https://docs.aws.amazon.com/detective/ latest/adminguide/member - remove-self-from-graph .html> dans le guide d'administration d'Amazon *Detective*.
+ Pour plus de détails sur l'API, reportez-vous [DisassociateMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/disassociate-membership.html)à la section *Référence des AWS CLI commandes*.
### `get-members`
L'exemple de code suivant montre comment utiliser`get-members`.
**AWS CLI**
**Pour extraire des informations sur les comptes membres du graphe de comportement sélectionnés**
L’exemple `get-members` suivant extrait des informations sur deux comptes membres dans le graphe de comportement arn:aws:detective:us-east-1:111122223333:graph:123412341234. Pour les deux comptes, la demande fournit le AWS compte IDs.
```
aws detective get-members \
--account-ids 444455556666 123456789012 \
--graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234
```
Sortie :
```
{
"MemberDetails": [
{
"AccountId": "444455556666",
"AdministratorId": "111122223333",
"EmailAddress": "mmajor@example.com",
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
"InvitedTime": 1579826107000,
"MasterId": "111122223333",
"Status": "INVITED",
"UpdatedTime": 1579826107000
}
{
"AccountId": "123456789012",
"AdministratorId": "111122223333",
"EmailAddress": "jstiles@example.com",
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
"InvitedTime": 1579826107000,
"MasterId": "111122223333",
"Status": "INVITED",
"UpdatedTime": 1579826107000
}
],
"UnprocessedAccounts": [ ]
}
```
Pour plus d'informations, consultez la section Affichage de la liste des comptes dans un graphe de comportement < https://docs.aws.amazon.com/detective/ latest/adminguide/graph - admin-view-accounts .html> dans le guide d'administration d'Amazon *Detective*.
+ Pour plus de détails sur l'API, reportez-vous [GetMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/get-members.html)à la section *Référence des AWS CLI commandes*.
### `list-graphs`
L'exemple de code suivant montre comment utiliser`list-graphs`.
**AWS CLI**
**Pour afficher une liste des graphes de comportement dont votre compte est l’administrateur**
L’exemple `list-graphs` suivant extrait les graphes de comportement dont le compte d’appel est l’administrateur dans la région actuelle.
```
aws detective list-graphs
```
Sortie :
```
{
"GraphList": [
{
"Arn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
"CreatedTime": 1579736111000
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListGraphs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/list-graphs.html)à la section *Référence des AWS CLI commandes*.
### `list-invitations`
L'exemple de code suivant montre comment utiliser`list-invitations`.
**AWS CLI**
**Pour afficher une liste des graphes de comportement auxquels un compte est membre ou auquel il est invité**
L’exemple `list-invitations` suivant extrait les graphes de comportement auxquels le compte appelant a été invité. Les résultats incluent uniquement les invitations ouvertes et les invitations acceptées. Ils n’incluent pas les invitations rejetées ou les adhésions supprimées.
```
aws detective list-invitations
```
Sortie :
```
{
"Invitations": [
{
"AccountId": "444455556666",
"AdministratorId": "111122223333",
"EmailAddress": "mmajor@example.com",
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
"InvitedTime": 1579826107000,
"MasterId": "111122223333",
"Status": "INVITED",
"UpdatedTime": 1579826107000
}
]
}
```
Pour plus d'informations, consultez la section Affichage de votre liste d'invitations à des graphes de comportement < https://docs.aws.amazon.com/detective/ latest/adminguide/member - view-graph-invitations .html> dans le guide d'administration d'*Amazon* Detective.
+ Pour plus de détails sur l'API, reportez-vous [ListInvitations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/list-invitations.html)à la section *Référence des AWS CLI commandes*.
### `list-members`
L'exemple de code suivant montre comment utiliser`list-members`.
**AWS CLI**
**Pour répertorier les comptes membres dans un graphe de comportement**
L’exemple `list-members` suivant extrait les comptes des membres invités et activés pour le graphe de comportement `arn:aws:detective:us-east-1:111122223333:graph:123412341234`. Les résultats n’incluent pas les comptes membres qui ont été supprimés.
```
aws detective list-members \
--graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234
```
Sortie :
```
{
"MemberDetails": [
{
"AccountId": "444455556666",
"AdministratorId": "111122223333",
"EmailAddress": "mmajor@example.com",
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
"InvitedTime": 1579826107000,
"MasterId": "111122223333",
"Status": "INVITED",
"UpdatedTime": 1579826107000
},
{
"AccountId": "123456789012",
"AdministratorId": "111122223333",
"EmailAddress": "jstiles@example.com",
"GraphArn": "arn:aws:detective:us-east-1:111122223333:graph:123412341234",
"InvitedTime": 1579826107000,
"MasterId": "111122223333",
"PercentOfGraphUtilization": 2,
"PercentOfGraphUtilizationUpdatedTime": 1586287843,
"Status": "ENABLED",
"UpdatedTime": 1579973711000,
"VolumeUsageInBytes": 200,
"VolumeUsageUpdatedTime": 1586287843
}
]
}
```
Pour plus d’informations, consultez [Affichage de la liste des comptes d’un graphe de comportement](https://docs.aws.amazon.com/detective/latest/adminguide/graph-admin-view-accounts.html) dans le *Guide de l’administrateur Amazon Detective*.
+ Pour plus de détails sur l'API, reportez-vous [ListMembers](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/list-members.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
L'exemple de code suivant montre comment utiliser`list-tags-for-resource`.
**AWS CLI**
**Pour extraire les balises attribuées à un graphe de comportement**
L’exemple `list-tags-for-resource` suivant renvoie les balises attribuées au graphe de comportement spécifié.
```
aws detective list-tags-for-resource \
--resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234
```
Sortie :
```
{
"Tags": {
"Department" : "Finance"
}
}
```
Pour plus d’informations, consultez [Gestion des balises pour un graphe de comportement](https://docs.aws.amazon.com/detective/latest/adminguide/graph-tags.html) dans le *Guide de l’administrateur Amazon Detective*.
+ Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `reject-invitation`
L'exemple de code suivant montre comment utiliser`reject-invitation`.
**AWS CLI**
**Pour rejeter une invitation à devenir un compte membre dans un graphe de comportement**
L’exemple `reject-invitation` suivant rejette une invitation à devenir un compte membre dans le graphe de comportement arn:aws:detective:us-east-1:111122223333:graph:123412341234.
```
aws detective reject-invitation \
--graph-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234
```
Cette commande ne produit aucune sortie.
*Pour plus d'informations, consultez Responding to a behavior graph invitation< https://docs.aws.amazon.com/detective/ latest/adminguide/member -invitation-response.html> dans le manuel Amazon Detective Administration Guide.*
+ Pour plus de détails sur l'API, reportez-vous [RejectInvitation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/reject-invitation.html)à la section *Référence des AWS CLI commandes*.
### `tag-resource`
L'exemple de code suivant montre comment utiliser`tag-resource`.
**AWS CLI**
**Pour attribuer une balise à une ressource**
L’exemple `tag-resource` suivant attribue une valeur pour la balise Department au graphe de comportement spécifié.
```
aws detective tag-resource \
--resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
--tags '{"Department":"Finance"}'
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Gestion des balises pour un graphe de comportement](https://docs.aws.amazon.com/detective/latest/adminguide/graph-tags.html) dans le *Guide de l’administrateur Amazon Detective*.
+ Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/tag-resource.html)à la section *Référence des AWS CLI commandes*.
### `untag-resource`
L'exemple de code suivant montre comment utiliser`untag-resource`.
**AWS CLI**
**Pour supprimer une valeur de balise d’une ressource**
L’exemple `untag-resource` suivant supprime la balise Department du graphe de comportement spécifié.
```
aws detective untag-resource \
--resource-arn arn:aws:detective:us-east-1:111122223333:graph:123412341234 \
--tag-keys "Department"
```
Cette commande ne produit aucune sortie.
Pour plus d’informations, consultez [Gestion des balises pour un graphe de comportement](https://docs.aws.amazon.com/detective/latest/adminguide/graph-tags.html) dans le *Guide de l’administrateur Amazon Detective*.
+ Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/detective/untag-resource.html)à la section *Référence des AWS CLI commandes*.