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 base pour AWS Health l'utilisation AWS SDKs
Les exemples de code suivants montrent comment utiliser les principes de base de AWS Health with AWS SDKs.
**Contents**
+ [Actions](health_code_examples_actions.md)
+ [`DescribeEvents`](health_example_health_DescribeEvents_section.md)
# Actions d' AWS Health utilisation AWS SDKs
Les exemples de code suivants montrent comment effectuer des AWS Health actions individuelles avec AWS SDKs. Chaque exemple inclut un lien vers GitHub, où vous pouvez trouver des instructions pour configurer et exécuter le code.
Les exemples suivants incluent uniquement les actions les plus couramment utilisées. Pour obtenir la liste complète, consultez la [Référence des API AWS Health](https://docs.aws.amazon.com/health/latest/APIReference/Welcome.html).
**Topics**
+ [`DescribeEvents`](health_example_health_DescribeEvents_section.md)
# Utilisation de `DescribeEvents` avec une CLI
Les exemples de code suivants illustrent comment utiliser `DescribeEvents`.
------
#### [ CLI ]
**AWS CLI**
**Exemple 1 : Pour répertorier les événements liés à AWS la santé**
L'`describe-events`exemple suivant répertorie les récents événements liés à AWS la santé.
```
aws health describe-events \
--region us-east-1
```
Sortie :
```
{
"events": [
{
"arn": "arn:aws:health:us-west-1::event/ECS/AWS_ECS_OPERATIONAL_ISSUE/AWS_ECS_OPERATIONAL_ISSUE_KWQPY_EXAMPLE111",
"service": "ECS",
"eventTypeCode": "AWS_ECS_OPERATIONAL_ISSUE",
"eventTypeCategory": "issue",
"region": "us-west-1",
"startTime": 1589077890.53,
"endTime": 1589086345.597,
"lastUpdatedTime": 1589086345.905,
"statusCode": "closed",
"eventScopeCode": "PUBLIC"
},
{
"arn": "arn:aws:health:global::event/BILLING/AWS_BILLING_NOTIFICATION/AWS_BILLING_NOTIFICATION_6ce1d874-e995-40e2-99cd-EXAMPLE1118b",
"service": "BILLING",
"eventTypeCode": "AWS_BILLING_NOTIFICATION",
"eventTypeCategory": "accountNotification",
"region": "global",
"startTime": 1588356000.0,
"lastUpdatedTime": 1588356524.358,
"statusCode": "open",
"eventScopeCode": "ACCOUNT_SPECIFIC"
},
{
"arn": "arn:aws:health:us-west-2::event/CLOUDFORMATION/AWS_CLOUDFORMATION_OPERATIONAL_ISSUE/AWS_CLOUDFORMATION_OPERATIONAL_ISSUE_OHTWY_EXAMPLE111",
"service": "CLOUDFORMATION",
"eventTypeCode": "AWS_CLOUDFORMATION_OPERATIONAL_ISSUE",
"eventTypeCategory": "issue",
"region": "us-west-2",
"startTime": 1588279630.761,
"endTime": 1588284650.0,
"lastUpdatedTime": 1588284691.941,
"statusCode": "closed",
"eventScopeCode": "PUBLIC"
},
{
"arn": "arn:aws:health:ap-northeast-1::event/LAMBDA/AWS_LAMBDA_OPERATIONAL_ISSUE/AWS_LAMBDA_OPERATIONAL_ISSUE_JZDND_EXAMPLE111",
"service": "LAMBDA",
"eventTypeCode": "AWS_LAMBDA_OPERATIONAL_ISSUE",
"eventTypeCategory": "issue",
"region": "ap-northeast-1",
"startTime": 1587379534.08,
"endTime": 1587391771.0,
"lastUpdatedTime": 1587395689.316,
"statusCode": "closed",
"eventScopeCode": "PUBLIC"
},
{
"arn": "arn:aws:health:us-east-1::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_COBXJ_EXAMPLE111",
"service": "EC2",
"eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE",
"eventTypeCategory": "issue",
"region": "us-east-1",
"startTime": 1586473044.284,
"endTime": 1586479706.091,
"lastUpdatedTime": 1586479706.153,
"statusCode": "closed",
"eventScopeCode": "PUBLIC"
},
{
"arn": "arn:aws:health:global::event/SECURITY/AWS_SECURITY_NOTIFICATION/AWS_SECURITY_NOTIFICATION_42007387-8129-42da-8c88-EXAMPLE11139",
"service": "SECURITY",
"eventTypeCode": "AWS_SECURITY_NOTIFICATION",
"eventTypeCategory": "accountNotification",
"region": "global",
"startTime": 1585674000.0,
"lastUpdatedTime": 1585674004.132,
"statusCode": "open",
"eventScopeCode": "PUBLIC"
},
{
"arn": "arn:aws:health:global::event/CLOUDFRONT/AWS_CLOUDFRONT_OPERATIONAL_ISSUE/AWS_CLOUDFRONT_OPERATIONAL_ISSUE_FRQXG_EXAMPLE111",
"service": "CLOUDFRONT",
"eventTypeCode": "AWS_CLOUDFRONT_OPERATIONAL_ISSUE",
"eventTypeCategory": "issue",
"region": "global",
"startTime": 1585610898.589,
"endTime": 1585617671.0,
"lastUpdatedTime": 1585620638.869,
"statusCode": "closed",
"eventScopeCode": "PUBLIC"
},
{
"arn": "arn:aws:health:us-east-1::event/SES/AWS_SES_OPERATIONAL_ISSUE/AWS_SES_OPERATIONAL_ISSUE_URNDF_EXAMPLE111",
"service": "SES",
"eventTypeCode": "AWS_SES_OPERATIONAL_ISSUE",
"eventTypeCategory": "issue",
"region": "us-east-1",
"startTime": 1585342008.46,
"endTime": 1585344017.0,
"lastUpdatedTime": 1585344355.989,
"statusCode": "closed",
"eventScopeCode": "PUBLIC"
},
{
"arn": "arn:aws:health:global::event/IAM/AWS_IAM_OPERATIONAL_NOTIFICATION/AWS_IAM_OPERATIONAL_NOTIFICATION_b6771c34-6ecd-4aea-9d3e-EXAMPLE1117e",
"service": "IAM",
"eventTypeCode": "AWS_IAM_OPERATIONAL_NOTIFICATION",
"eventTypeCategory": "accountNotification",
"region": "global",
"startTime": 1584978300.0,
"lastUpdatedTime": 1584978553.572,
"statusCode": "open",
"eventScopeCode": "ACCOUNT_SPECIFIC"
},
{
"arn": "arn:aws:health:ap-southeast-2::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_HNGHE_EXAMPLE111",
"service": "EC2",
"eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE",
"eventTypeCategory": "issue",
"region": "ap-southeast-2",
"startTime": 1583881487.483,
"endTime": 1583885056.785,
"lastUpdatedTime": 1583885057.052,
"statusCode": "closed",
"eventScopeCode": "PUBLIC"
}
]
}
```
Pour plus d'informations, consultez [Getting started with the AWS Personal Health Dashboard](https://docs.aws.amazon.com/health/latest/ug/getting-started-phd.html) dans le *AWS Health User Guide*.
**Exemple 2 : Pour répertorier les événements AWS de santé par service et code d'état de l'événement**
L'`describe-events`exemple suivant répertorie les événements AWS Health pour Amazon Elastic Compute Cloud (Amazon EC2) dont le statut est clôturé.
```
aws health describe-events \
--filter "services=EC2,eventStatusCodes=closed"
```
Sortie :
```
{
"events": [
{
"arn": "arn:aws:health:us-east-1::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_VKTXI_EXAMPLE111",
"service": "EC2",
"eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE",
"eventTypeCategory": "issue",
"region": "us-east-1",
"startTime": 1587462325.096,
"endTime": 1587464204.774,
"lastUpdatedTime": 1587464204.865,
"statusCode": "closed",
"eventScopeCode": "PUBLIC"
},
{
"arn": "arn:aws:health:us-east-1::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_COBXJ_EXAMPLE111",
"service": "EC2",
"eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE",
"eventTypeCategory": "issue",
"region": "us-east-1",
"startTime": 1586473044.284,
"endTime": 1586479706.091,
"lastUpdatedTime": 1586479706.153,
"statusCode": "closed",
"eventScopeCode": "PUBLIC"
},
{
"arn": "arn:aws:health:ap-southeast-2::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_HNGHE_EXAMPLE111",
"service": "EC2",
"eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE",
"eventTypeCategory": "issue",
"region": "ap-southeast-2",
"startTime": 1583881487.483,
"endTime": 1583885056.785,
"lastUpdatedTime": 1583885057.052,
"statusCode": "closed",
"eventScopeCode": "PUBLIC"
}
]
}
```
Pour plus d'informations, consultez [Getting started with the AWS Personal Health Dashboard](https://docs.aws.amazon.com/health/latest/ug/getting-started-phd.html) dans le *AWS Health User Guide*.
+ Pour plus de détails sur l'API, reportez-vous [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/health/describe-events.html)à la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : Cette commande renvoie des événements depuis AWS Personal Health Dashboard. L’utilisateur ajoute le paramètre -Region pour voir les événements disponibles pour le service dans la région USA Est (Virginie du Nord), mais le paramètre -Filter\$1Region filtre les événements enregistrés dans les régions UE (Londres) et USA Ouest (Oregon) (eu-west-2 et us-west-2). Le StartTime paramètre -Filter\$1 filtre pour une plage d'heures pendant laquelle les événements peuvent commencer, tandis que le EndTime paramètre -Filter\$1 filtre pour une plage d'heures pendant laquelle les événements peuvent se terminer. Le résultat est un événement de maintenance planifié pour RDS qui commence dans la plage -Filter\$1 spécifiée et se termine dans la StartTime plage planifiée -Filter\$1. EndTime **
```
Get-HLTHEvent -Region us-east-1 -Filter_Region "eu-west-2","us-west-2" -Filter_StartTime @{from="3/14/2019 6:30:00AM";to="3/15/2019 5:00:00PM"} -Filter_EndTime @{from="3/21/2019 7:00:00AM";to="3/21/2019 5:00:00PM"}
```
**Sortie** :
```
Arn : arn:aws:health:us-west-2::event/RDS/AWS_RDS_HARDWARE_MAINTENANCE_SCHEDULED/AWS_RDS_HARDWARE_MAINTENANCE_SCHEDULED_USW2_20190314_20190321
AvailabilityZone :
EndTime : 3/21/2019 2:00:00 PM
EventTypeCategory : scheduledChange
EventTypeCode : AWS_RDS_HARDWARE_MAINTENANCE_SCHEDULED
LastUpdatedTime : 2/28/2019 2:26:07 PM
Region : us-west-2
Service : RDS
StartTime : 3/14/2019 2:00:00 PM
StatusCode : open
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEvents](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : Cette commande renvoie des événements depuis AWS Personal Health Dashboard. L’utilisateur ajoute le paramètre -Region pour voir les événements disponibles pour le service dans la région USA Est (Virginie du Nord), mais le paramètre -Filter\$1Region filtre les événements enregistrés dans les régions UE (Londres) et USA Ouest (Oregon) (eu-west-2 et us-west-2). Le StartTime paramètre -Filter\$1 filtre pour une plage d'heures pendant laquelle les événements peuvent commencer, tandis que le EndTime paramètre -Filter\$1 filtre pour une plage d'heures pendant laquelle les événements peuvent se terminer. Le résultat est un événement de maintenance planifié pour RDS qui commence dans la plage -Filter\$1 spécifiée et se termine dans la StartTime plage planifiée -Filter\$1. EndTime **
```
Get-HLTHEvent -Region us-east-1 -Filter_Region "eu-west-2","us-west-2" -Filter_StartTime @{from="3/14/2019 6:30:00AM";to="3/15/2019 5:00:00PM"} -Filter_EndTime @{from="3/21/2019 7:00:00AM";to="3/21/2019 5:00:00PM"}
```
**Sortie** :
```
Arn : arn:aws:health:us-west-2::event/RDS/AWS_RDS_HARDWARE_MAINTENANCE_SCHEDULED/AWS_RDS_HARDWARE_MAINTENANCE_SCHEDULED_USW2_20190314_20190321
AvailabilityZone :
EndTime : 3/21/2019 2:00:00 PM
EventTypeCategory : scheduledChange
EventTypeCode : AWS_RDS_HARDWARE_MAINTENANCE_SCHEDULED
LastUpdatedTime : 2/28/2019 2:26:07 PM
Region : us-west-2
Service : RDS
StartTime : 3/14/2019 2:00:00 PM
StatusCode : open
```
+ Pour plus de détails sur l'API, reportez-vous [DescribeEvents](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------