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.
# Rédaction d'entités PII avec des tâches asynchrones (API)
Pour supprimer les entités PII de votre texte, vous devez démarrer un traitement par lots asynchrone. Pour exécuter la tâche, téléchargez vos documents sur Amazon S3 et soumettez une [StartPiiEntitiesDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartPiiEntitiesDetectionJob.html)demande.
**Topics**
+ [Avant de commencer](#redact-pii-before)
+ [Paramètres d’entrée](#redact-pii-api-inputs)
+ [Format du fichier de sortie](#redact-pii-api-outputs)
+ [Rédaction des informations personnelles à l'aide du AWS Command Line Interface](#redact-pii-api-cli)
## Avant de commencer
Avant de commencer, assurez-vous d'avoir :
+ **Compartiments d'entrée et de sortie** : identifiez les compartiments Amazon S3 que vous souhaitez utiliser pour les fichiers d'entrée et de sortie. Les buckets doivent se trouver dans la même région que l'API que vous appelez.
+ **Rôle de service IAM** : vous devez disposer d'un rôle de service IAM autorisé à accéder à vos compartiments d'entrée et de sortie. Pour de plus amples informations, veuillez consulter [Autorisations basées sur les rôles requises pour les opérations asynchrones](security_iam_id-based-policy-examples.md#auth-role-permissions).
## Paramètres d’entrée
Dans votre demande, incluez les paramètres obligatoires suivants :
+ `InputDataConfig`— Fournissez une [InputDataConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_InputDataConfig.html)définition pour votre demande, qui inclut les propriétés d'entrée de la tâche. Pour le `S3Uri` paramètre, spécifiez l'emplacement Amazon S3 de vos documents d'entrée.
+ `OutputDataConfig`— Fournissez une [OutputDataConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_OutputDataConfig.html)définition pour votre demande, qui inclut les propriétés de sortie de la tâche. Pour le `S3Uri` paramètre, spécifiez l'emplacement Amazon S3 où Amazon Comprehend écrit les résultats de son analyse.
+ `DataAccessRoleArn`— Fournissez le nom de ressource Amazon (ARN) d'un Gestion des identités et des accès AWS rôle. Ce rôle doit accorder à Amazon Comprehend un accès en lecture à vos données d'entrée et un accès en écriture à votre emplacement de sortie dans Amazon S3. Pour de plus amples informations, veuillez consulter [Autorisations basées sur les rôles requises pour les opérations asynchrones](security_iam_id-based-policy-examples.md#auth-role-permissions).
+ `Mode`— Définissez ce paramètre sur`ONLY_REDACTION`. Avec ce paramètre, Amazon Comprehend écrit une copie de vos documents d'entrée sur l'emplacement de sortie dans Amazon S3. Dans cette copie, chaque entité PII est expurgée.
+ `RedactionConfig`— Fournissez une [RedactionConfig](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_RedactionConfig.html)définition pour votre demande, qui inclut les paramètres de configuration pour la rédaction. Spécifiez les types de PII à supprimer, et précisez si chaque entité PII est remplacée par le nom de son type ou par un caractère de votre choix :
+ Spécifiez les types d'entités PII à supprimer dans le `PiiEntityTypes` tableau. Pour supprimer tous les types d'entités, définissez la valeur du tableau sur`["ALL"]`.
+ Pour remplacer chaque entité PII par son type, définissez le `MaskMode` paramètre sur. `REPLACE_WITH_PII_ENTITY_TYPE` Par exemple, avec ce paramètre, l'entité PII « Jane Doe » est remplacée par « [NAME] ».
+ Pour remplacer les caractères de chaque entité PII par un caractère de votre choix, définissez le `MaskMode` paramètre sur et définissez le `MaskCharacter` paramètre sur le caractère de remplacement. `MASK` Ne fournissez qu'un seul caractère. Les caractères valides sont \$1 , \$1, \$1, %, &, \$1 et @. Par exemple, avec ce paramètre, l'entité PII « Jane Doe » peut être remplacée par « \$1\$1\$1\$1 \$1\$1\$1 »
+ `LanguageCode`— Définissez ce paramètre sur `en` ou`es`. Amazon Comprehend prend en charge la détection des informations personnelles dans des textes en anglais ou en espagnol.
## Format du fichier de sortie
L'exemple suivant montre les fichiers d'entrée et de sortie d'une tâche d'analyse qui expédie des informations personnelles. Le format de l'entrée est d'un document par ligne.
```
{
Managing Your Accounts Primary Branch Canton John Doe Phone Number 443-573-4800 123 Main StreetBaltimore, MD 21224
Online Banking HowardBank.com Telephone 1-877-527-2703 Bank 3301 Boston Street, Baltimore, MD 21224
```
La tâche d'analyse visant à supprimer ce fichier d'entrée produit le fichier de sortie suivant.
```
{
Managing Your Accounts Primary Branch ****** ******** Phone Number ************ **********************************
Online Banking ************** Telephone ************** Bank ***************************************
}
```
## Rédaction des informations personnelles à l'aide du AWS Command Line Interface
L'exemple suivant utilise l'`StartPiiEntitiesDetectionJob`opération avec le AWS CLI.
L'exemple est mis en forme pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation Unix, à savoir la barre oblique inversée (\$1), à la fin de chaque ligne par un accent circonflexe (^).
```
aws comprehend start-pii-entities-detection-job \
--region region \
--job-name job name \
--cli-input-json file://path to JSON input file
```
Pour le `cli-input-json` paramètre, vous fournissez le chemin d'accès à un fichier JSON contenant les données de demande, comme illustré dans l'exemple suivant.
```
{
"InputDataConfig": {
"S3Uri": "s3://input bucket/input path",
"InputFormat": "ONE_DOC_PER_LINE"
},
"OutputDataConfig": {
"S3Uri": "s3://output bucket/output path"
},
"DataAccessRoleArn": "arn:aws:iam::account ID:role/data access role"
"LanguageCode": "en",
"Mode": "ONLY_REDACTION"
"RedactionConfig": {
"MaskCharacter": "*",
"MaskMode": "MASK",
"PiiEntityTypes": ["ALL"]
}
}
```
Si la demande de démarrage de la tâche de détection des événements est réussie, vous recevrez une réponse similaire à la suivante :
```
{
"JobId": "7c4fbe6e...e5b"
"JobArn": "arn:aws:comprehend:us-west-2:123456789012:pii-entities-detection-job/7c4fbe6e...e5b"
"JobStatus": "SUBMITTED",
}
```
Vous pouvez utiliser cette [DescribeEventsDetectionJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeEventsDetectionJob.html)opération pour obtenir le statut d'une tâche existante.
```
aws comprehend describe-pii-entities-detection-job \
--region region \
--job-id job ID
```
Lorsque le travail est terminé avec succès, vous recevez une réponse similaire à la suivante :
```
{
"PiiEntitiesDetectionJobProperties": {
"JobId": "7c4fbe6e...e5b"
"JobArn": "arn:aws:comprehend:us-west-2:123456789012:pii-entities-detection-job/7c4fbe6e...e5b"
"JobName": "piiCLIredtest1",
"JobStatus": "COMPLETED",
"SubmitTime": "2022-05-05T14:54:06.169000-07:00",
"EndTime": "2022-05-05T15:00:17.007000-07:00",
"InputDataConfig": {
(identical to the input data that you provided with the request)
}
}
```