# AWS Health를 사용한 예시AWS CLI
다음 코드 예시에서는 AWS Health에서 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `describe-affected-entities`
다음 코드 예시는 `describe-affected-entities`의 사용 방법을 보여줍니다.
**AWS CLI**
**지정된 AWS Health 이벤트의 영향을 받는 엔터티를 나열하는 방법**
다음 `describe-affected-entities` 예제에서는 지정된 AWS Health 이벤트의 영향을 받는 엔터티를 나열합니다. 이 이벤트는 AWS 계정에 대한 결제 알림입니다.
```
aws health describe-affected-entities \
--filter "eventArns=arn:aws:health:global::event/BILLING/AWS_BILLING_NOTIFICATION/AWS_BILLING_NOTIFICATION_6ce1d874-e995-40e2-99cd-EXAMPLE11145" \
--region us-east-1
```
출력:
```
{
"entities": [
{
"entityArn": "arn:aws:health:global:123456789012:entity/EXAMPLEimSMoULmWHpb",
"eventArn": "arn:aws:health:global::event/BILLING/AWS_BILLING_NOTIFICATION/AWS_BILLING_NOTIFICATION_6ce1d874-e995-40e2-99cd-EXAMPLE11145",
"entityValue": "AWS_ACCOUNT",
"awsAccountId": "123456789012",
"lastUpdatedTime": 1588356454.08
}
]
}
```
자세한 내용은 *AWS Health 사용 설명서*의 [Event log](https://docs.aws.amazon.com/health/latest/ug/getting-started-phd.html#event-log)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeAffectedEntities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/health/describe-affected-entities.html)를 참조하세요.
### `describe-event-details`
다음 코드 예시는 `describe-event-details`의 사용 방법을 보여줍니다.
**AWS CLI**
**AWS Health 이벤트에 대한 정보를 나열하는 방법**
다음 `describe-event-details` 예제에서는 지정된 AWS Health 이벤트에 대한 정보를 나열합니다.
```
aws health describe-event-details \
--event-arns "arn:aws:health:us-east-1::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_VKTXI_EXAMPLE111" \
--region us-east-1
```
출력:
```
{
"successfulSet": [
{
"event": {
"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"
},
"eventDescription": {
"latestDescription": "[RESOLVED] Increased API Error Rates and Latencies\n\n[02:45 AM PDT] We are investigating increased API error rates and latencies in the US-EAST-1 Region.\n\n[03:16 AM PDT] Between 2:10 AM and 2:59 AM PDT we experienced increased API error rates and latencies in the US-EAST-1 Region. The issue has been resolved and the service is operating normally."
}
}
],
"failedSet": []
}
```
자세한 내용은 *AWS Health 사용 설명서*의 [Event details pane](https://docs.aws.amazon.com/health/latest/ug/getting-started-phd.html#event-details)을 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeEventDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/health/describe-event-details.html)를 참조하세요.
### `describe-events`
다음 코드 예시는 `describe-events`의 사용 방법을 보여줍니다.
**AWS CLI**
**예제 1: AWS Health 이벤트를 나열하는 방법**
다음 `describe-events` 예제에서는 최근 AWS Health 이벤트를 나열합니다.
```
aws health describe-events \
--region us-east-1
```
출력:
```
{
"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"
}
]
}
```
자세한 내용은 *AWS Health 사용 설명서*의 [Getting started with the AWS Personal Health Dashboard](https://docs.aws.amazon.com/health/latest/ug/getting-started-phd.html)를 참조하세요.
**예제 2: 서비스 및 이벤트 상태 코드별 AWS Health 이벤트를 나열하는 방법**
다음 `describe-events` 예제에서는 이벤트 상태가 종료된 Amazon Elastic Compute Cloud(Amazon EC2)에 대한 AWS Health 이벤트를 나열합니다.
```
aws health describe-events \
--filter "services=EC2,eventStatusCodes=closed"
```
출력:
```
{
"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"
}
]
}
```
자세한 내용은 *AWS Health 사용 설명서*의 [Getting started with the AWS Personal Health Dashboard](https://docs.aws.amazon.com/health/latest/ug/getting-started-phd.html)를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [DescribeEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/health/describe-events.html)를 참조하세요.