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.
# CloudWatch Exemples de journaux 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 CloudWatch Logs.
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
### `create-log-group`
L'exemple de code suivant montre comment utiliser`create-log-group`.
**AWS CLI**
La commande suivante permet de créer un groupe de journaux nommé `my-logs` :
```
aws logs create-log-group --log-group-name my-logs
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-group.html)à la section *Référence des AWS CLI commandes*.
### `create-log-stream`
L'exemple de code suivant montre comment utiliser`create-log-stream`.
**AWS CLI**
La commande suivante crée un flux de journaux nommé `20150601` dans le groupe de journaux `my-logs` :
```
aws logs create-log-stream --log-group-name my-logs --log-stream-name 20150601
```
+ Pour plus de détails sur l'API, reportez-vous [CreateLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-stream.html)à la section *Référence des AWS CLI commandes*.
### `delete-log-group`
L'exemple de code suivant montre comment utiliser`delete-log-group`.
**AWS CLI**
La commande suivante supprime un groupe de journaux nommé `my-logs` :
```
aws logs delete-log-group --log-group-name my-logs
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-group.html)à la section *Référence des AWS CLI commandes*.
### `delete-log-stream`
L'exemple de code suivant montre comment utiliser`delete-log-stream`.
**AWS CLI**
La commande suivante supprime un flux de journaux nommé `20150531` à partir d’un groupe de journaux nommé `my-logs` :
```
aws logs delete-log-stream --log-group-name my-logs --log-stream-name 20150531
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-stream.html)à la section *Référence des AWS CLI commandes*.
### `delete-retention-policy`
L'exemple de code suivant montre comment utiliser`delete-retention-policy`.
**AWS CLI**
La commande suivante supprime la politique de rétention précédemment appliquée à un groupe de journaux nommé `my-logs` :
```
aws logs delete-retention-policy --log-group-name my-logs
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-retention-policy.html)à la section *Référence des AWS CLI commandes*.
### `describe-log-groups`
L'exemple de code suivant montre comment utiliser`describe-log-groups`.
**AWS CLI**
La commande suivante décrit un groupe de journaux nommé `my-logs` :
```
aws logs describe-log-groups --log-group-name-prefix my-logs
```
Sortie :
```
{
"logGroups": [
{
"storedBytes": 0,
"metricFilterCount": 0,
"creationTime": 1433189500783,
"logGroupName": "my-logs",
"retentionInDays": 5,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLogGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-groups.html)à la section *Référence des AWS CLI commandes*.
### `describe-log-streams`
L'exemple de code suivant montre comment utiliser`describe-log-streams`.
**AWS CLI**
La commande suivante affiche tous les flux de journaux `2015` commençant par le préfixe `my-logs` dans le groupe de journaux :
```
aws logs describe-log-streams --log-group-name my-logs --log-stream-name-prefix 2015
```
Sortie :
```
{
"logStreams": [
{
"creationTime": 1433189871774,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531",
"logStreamName": "20150531",
"storedBytes": 0
},
{
"creationTime": 1433189873898,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601",
"logStreamName": "20150601",
"storedBytes": 0
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeLogStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-streams.html)à la section *Référence des AWS CLI commandes*.
### `get-log-events`
L'exemple de code suivant montre comment utiliser`get-log-events`.
**AWS CLI**
La commande suivante extrait les événements du journal à partir d’un flux de journaux nommé `20150601` dans le groupe de journaux `my-logs` :
```
aws logs get-log-events --log-group-name my-logs --log-stream-name 20150601
```
Sortie :
```
{
"nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130",
"events": [
{
"ingestionTime": 1433190494190,
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"ingestionTime": 1433190516679,
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"ingestionTime": 1433190494190,
"timestamp": 1433190184358,
"message": "Example Event 2"
}
],
"nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120"
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/get-log-events.html)à la section *Référence des AWS CLI commandes*.
### `put-log-events`
L'exemple de code suivant montre comment utiliser`put-log-events`.
**AWS CLI**
La commande suivante place les événements du journal dans un flux de journaux nommé `20150601` dans le groupe de journaux `my-logs` :
```
aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events
```
Sortie :
```
{
"nextSequenceToken": "49542672486831074009579604567656788214806863282469607346"
}
```
L’exemple ci-dessus lit un tableau JSON d’événements à partir d’un fichier nommé `events` dans le répertoire actuel :
```
[
{
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"timestamp": 1433190184358,
"message": "Example Event 2"
},
{
"timestamp": 1433190184360,
"message": "Example Event 3"
}
]
```
Chaque appel ultérieur nécessite que le jeton de séquence suivant fourni par l’appel précédent soit spécifié avec l’option de jeton de séquence :
```
aws logs put-log-events --log-group-name my-logs --log-stream-name 20150601 --log-events file://events2 --sequence-token "49542672486831074009579604567656788214806863282469607346"
```
Sortie :
```
{
"nextSequenceToken": "49542672486831074009579604567900991230369019956308219826"
}
```
+ Pour plus de détails sur l'API, reportez-vous [PutLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-log-events.html)à la section *Référence des AWS CLI commandes*.
### `put-retention-policy`
L'exemple de code suivant montre comment utiliser`put-retention-policy`.
**AWS CLI**
La commande suivante ajoute une politique de conservation de 5 jours à un groupe de journaux nommé `my-logs` :
```
aws logs put-retention-policy --log-group-name my-logs --retention-in-days 5
```
+ Pour plus de détails sur l'API, reportez-vous [PutRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-retention-policy.html)à la section *Référence des AWS CLI commandes*.