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.

Utilisation de la update-trail commande pour mettre à jour un parcours

Vous pouvez utiliser la commande update-trail pour modifier les paramètres de configuration d’un journal de suivi. Vous pouvez également utiliser les commandes add-tags et remove-tags pour ajouter et supprimer les identifications pour un journal de suivi. Vous ne pouvez mettre à jour les sentiers que depuis la AWS région où ils ont été créés (sa région d'origine). Lorsque vous utilisez le AWS CLI, n'oubliez pas que vos commandes s'exécutent dans la AWS région configurée pour votre profil. Si vous souhaitez exécuter les commandes dans une autre région, modifiez la région par défaut pour votre profil, ou utilisez le paramètre --region avec la commande.

Si vous avez activé les événements CloudTrail de gestion dans Amazon Security Lake, vous devez gérer au moins un journal organisationnel multirégional qui enregistre à la fois les read événements de gestion et les événements write de gestion. Vous ne pouvez pas mettre à jour un journal de suivi éligible de telle sorte qu'il ne réponde pas aux exigences de Security Lake. Par exemple, en modifiant le journal de suivi pour qu’il s’applique à une région unique ou en désactivant la journalisation des événements de gestion read et write.

Convertir un journal de suivi qui s'applique à une région de sorte qu'il s'applique à toutes les régions

Pour modifier un journal de suivi existant afin qu'il s'applique à toutes les régions, utilisez l'option --is-multi-region-trail.

aws cloudtrail update-trail --name my-trail --is-multi-region-trail

Afin de confirmer que le journal de suivi s'applique maintenant à toutes les régions, l'élément IsMultiRegionTrail dans le résultat affiche true.

{
    "IncludeGlobalServiceEvents": true, 
    "Name": "my-trail", 
    "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/my-trail", 
    "LogFileValidationEnabled": false, 
    "IsMultiRegionTrail": true, 
    "IsOrganizationTrail": false,
    "S3BucketName": "amzn-s3-demo-bucket"
}

Convertir un journal de suivi multi-régions à un journal de suivi à région unique

Pour modifier un journal de suivi multi-régions existant afin qu'il s'applique uniquement à la région dans laquelle il a été créé, utilisez l'option --no-is-multi-region-trail.

aws cloudtrail update-trail --name my-trail --no-is-multi-region-trail

Afin de confirmer que le journal de suivi s'applique maintenant à une seule région, l'élément IsMultiRegionTrail dans le résultat affiche false.

{
    "IncludeGlobalServiceEvents": true, 
    "Name": "my-trail", 
    "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/my-trail", 
    "LogFileValidationEnabled": false, 
    "IsMultiRegionTrail": false, 
    "IsOrganizationTrail": false,
    "S3BucketName": "amzn-s3-demo-bucket"
}

Activation et désactivation de la journalisation des événements de services mondiaux

Pour modifier un journal de suivi afin qu'il ne journalise pas les événements de services mondiaux, utilisez l'option --no-include-global-service-events.

aws cloudtrail update-trail --name my-trail --no-include-global-service-events

Pour confirmer que le journal de suivi ne journaliser plus d'événements de services mondiaux, l'élément IncludeGlobalServiceEvents dans le résultat indique false.

{
    "IncludeGlobalServiceEvents": false, 
    "Name": "my-trail", 
    "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/my-trail", 
    "LogFileValidationEnabled": false, 
    "IsMultiRegionTrail": false, 
    "IsOrganizationTrail": false,
    "S3BucketName": "amzn-s3-demo-bucket"
}

Pour modifier un journal de suivi afin qu'il journalise les événements de services mondiaux, utilisez l'option --include-global-service-events.

Les journaux de suivi à région unique ne recevront plus d'événements de services mondiaux à partir du 22 novembre 2021, sauf si le journal de suivi apparaît déjà dans la région USA Est (Virginie du Nord), us-east-1. Pour continuer à capturer les événements de services mondiaux, mettez à jour la configuration du journal de suivi en un journal de suivi multi-régions. Par exemple, cette commande met à jour un journal de suivi à région unique dans USA Est (Ohio), us-east-2, en un journal de suivi multi-régions. Remplacez myExistingSingleRegionTrailWithGSE avec le nom de piste approprié à votre configuration.

aws cloudtrail --region us-east-2 update-trail --name myExistingSingleRegionTrailWithGSE --is-multi-region-trail

Étant donné que les activités de services mondiaux ne sont disponibles dans la région USA Est (Virginie du Nord) qu'à partir du 22 novembre 2021, vous pouvez également créer un journal de suivi à région unique pour vous abonner aux activités de services mondiaux dans la région USA Est (Virginie du Nord), us-east-1. La commande suivante crée un suivi d'une seule région dans us-east-1 pour recevoir,, et les événements : CloudFront IAM AWS STS

aws cloudtrail --region us-east-1 create-trail --include-global-service-events --name myTrail --s3-bucket-name amzn-s3-demo-bucket

Activer la validation du fichier journal

Pour activer la validation du fichier journal pour un journal de suivi, utilisez l'option --enable-log-file-validation. Les fichiers de valeur de hachage sont livrés au compartiment Amazon S3 pour ce journal de suivi.

aws cloudtrail update-trail --name my-trail --enable-log-file-validation

Afin de confirmer que la validation de fichiers journaux est activée, l’élément LogFileValidationEnabled dans le résultat affiche true.

{
    "IncludeGlobalServiceEvents": true, 
    "Name": "my-trail", 
    "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/my-trail", 
    "LogFileValidationEnabled": true, 
    "IsMultiRegionTrail": false, 
    "IsOrganizationTrail": false,
    "S3BucketName": "amzn-s3-demo-bucket"
}

Désactiver la validation du fichier journal

Pour désactiver la validation du fichier journal pour un journal de suivi, utilisez l'option --no-enable-log-file-validation.

aws cloudtrail update-trail --name my-trail-name --no-enable-log-file-validation

Afin de confirmer que la validation du fichier journal est désactivée, l’élément LogFileValidationEnabled dans le résultat affiche false.

{
    "IncludeGlobalServiceEvents": true, 
    "Name": "my-trail", 
    "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/my-trail", 
    "LogFileValidationEnabled": false, 
    "IsMultiRegionTrail": false, 
    "IsOrganizationTrail": false,
    "S3BucketName": "amzn-s3-demo-bucket"
}

Pour valider les fichiers journaux à l'aide du AWS CLI, voirValidation de l'intégrité du fichier CloudTrail journal à l'aide du AWS CLI.