기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS Resilience Hub APIs 사용하여 애플리케이션 설명 및 관리
AWS Resilience Hub 콘솔을 사용하여 애플리케이션을 설명하고 관리하는 대안으로 AWS Resilience Hub 를 사용하면 AWS Resilience Hub APIs. 이 장에서는 AWS Resilience Hub APIs를 사용하여 애플리케이션을 생성하는 방법을 설명합니다. 또한 API를 실행해야 하는 순서와 적절한 예제와 함께 제공해야 하는 파라미터 값을 정의합니다. 자세한 내용은 다음 항목을 참조하세요.
+ [애플리케이션 준비](prepare-app-using-api.md)
+ [AWS Resilience Hub 복원력 평가 실행 및 관리](running-app-using-api.md)
+ [애플리케이션 수정](modify-application-using-api.md)
# 애플리케이션 준비
애플리케이션을 준비하려면 먼저 애플리케이션을 생성하고 복원력 정책을 할당한 다음 입력 소스에서 애플리케이션 리소스를 가져와야 합니다. 애플리케이션을 준비하는 데 사용되는 AWS Resilience Hub APIs에 대한 자세한 내용은 다음 주제를 참조하세요.
+ [애플리케이션 생성](#create-app-using-api)
+ [복원력 정책 생성](#create-res-policy-using-api)
+ [입력 소스에서 리소스 가져오기 및 가져오기 상태 모니터링](#import-app-resource-using-api)
+ [애플리케이션 초안 버전 게시 및 복원력 정책 할당](#publish-application-using-api)
## 애플리케이션 생성
에서 새 애플리케이션을 생성하려면 `CreateApp` API를 호출하고 고유한 애플리케이션 이름을 제공해야 AWS Resilience Hub합니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateApp.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateApp.html) 단원을 참조하세요.
다음 예제는 `CreateApp` API를 사용하여 AWS Resilience Hub 에서 새 애플리케이션 `newApp`을 만드는 방법을 보여줍니다.
### 요청
```
aws resiliencehub create-app --name newApp
```
### 응답
```
{
"app": {
"appArn": "",
"name": "newApp",
"creationTime": "2022-10-26T19:48:00.434000+03:00",
"status": "Active",
"complianceStatus": "NotAssessed",
"resiliencyScore": 0.0,
"tags": {},
"assessmentSchedule": "Disabled"
}
}
```
## 복원력 정책 생성
애플리케이션을 만든 후에는 `CreateResiliencyPolicy` API를 사용하여 애플리케이션의 복원력 상태를 파악할 수 있는 복원력 정책을 생성해야 합니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateResiliencyPolicy.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateResiliencyPolicy.html) 단원을 참조하세요.
다음 예제에서는 `CreateResiliencyPolicy` API를 AWS Resilience Hub 사용하여에서 애플리케이션에 `newPolicy` 대한를 생성하는 방법을 보여줍니다.
### 요청
```
aws resiliencehub create-resiliency-policy \
--policy-name newPolicy --tier NonCritical \
--policy '{"AZ": {"rtoInSecs": 172800,"rpoInSecs": 86400}, \
"Hardware": {"rtoInSecs": 172800,"rpoInSecs": 86400}, \
"Software": {"rtoInSecs": 172800,"rpoInSecs": 86400}}'
```
### 응답
```
{
"policy": {
"policyArn": "",
"policyName": "newPolicy",
"policyDescription": "",
"dataLocationConstraint": "AnyLocation",
"tier": "NonCritical",
"estimatedCostTier": "L1",
"policy": {
"AZ": {
"rtoInSecs": 172800,
"rpoInSecs": 86400
},
"Hardware": {
"rtoInSecs": 172800,
"rpoInSecs": 86400
},
"Software": {
"rtoInSecs": 172800,
"rpoInSecs": 86400
}
},
"creationTime": "2022-10-26T20:48:05.946000+03:00",
"tags": {}
}
}
```
## 입력 소스에서 리소스 가져오기 및 가져오기 상태 모니터링
AWS Resilience Hub 는 애플리케이션에 리소스를 가져오기 위해 다음 APIs를 제공합니다.
+ `ImportResourcesToDraftAppVersion` – 이 API를 사용하면 다양한 입력 소스에서 애플리케이션의 초안 버전으로 리소스를 가져올 수 있습니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_ImportResourcesToDraftAppVersion.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_ImportResourcesToDraftAppVersion.html) 단원을 참조하세요.
+ `PublishAppVersion` – 이 API는 업데이트된 AppComponent와 함께 새 버전의 애플리케이션을 게시합니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_PublishAppVersion.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_PublishAppVersion.html) 단원을 참조하세요.
+ `DescribeDraftAppVersionResourcesImportStatus` – 이 API를 사용하면 애플리케이션 버전으로의 리소스 가져오기 상태를 모니터링할 수 있습니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeDraftAppVersionResourcesImportStatus.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeDraftAppVersionResourcesImportStatus.html) 단원을 참조하세요.
다음 예제는 AWS Resilience Hub 에서 `ImportResourcesToDraftAppVersion` API를 사용하여 애플리케이션으로 리소스를 가져오는 방법을 보여줍니다.
### 요청
```
aws resiliencehub import-resources-to-draft-app-version \
--app-arn \
--terraform-sources '[{"s3StateFileUrl": }]'
```
### 응답
```
{
"appArn": "",
"appVersion": "draft",
"sourceArns": [],
"status": "Pending",
"terraformSources": [
{
"s3StateFileUrl":
}
]
}
```
다음 예제는 AWS Resilience Hub 에서 `CreateAppVersionResource` API를 사용하여 애플리케이션에 리소스를 수동으로 추가하는 방법을 보여줍니다.
### 요청
```
aws resiliencehub create-app-version-resource \
--app-arn \
--resource-name "backup-efs" \
--logical-resource-id '{"identifier": "backup-efs"}' \
--physical-resource-id '' \
--resource-type AWS::EFS::FileSystem \
--app-components '["new-app-component"]'
```
### 응답
```
{
"appArn": "",
"appVersion": "draft",
"physicalResource": {
"resourceName": "backup-efs",
"logicalResourceId": {
"identifier": "backup-efs"
},
"physicalResourceId": {
"identifier": "",
"type": "Arn"
},
"resourceType": "AWS::EFS::FileSystem",
"appComponents": [
{
"name": "new-app-component",
"type": "AWS::ResilienceHub::StorageAppComponent",
"id": "new-app-component"
}
]
}
}
```
다음 예제는 AWS Resilience Hub 에서 `DescribeDraftAppVersionResourcesImportStatus` API를 사용하여 리소스의 가져오기 상태를 모니터링하는 방법을 보여줍니다.
### 요청
```
aws resiliencehub describe-draft-app-version-resources-import-status \
--app-arn
```
### 응답
```
{
"appArn": "",
"appVersion": "draft",
"status": "Success",
"statusChangeTime": "2022-10-26T19:55:18.471000+03:00"
}
```
## 애플리케이션 초안 버전 게시 및 복원력 정책 할당
평가를 실행하기 전에 먼저 애플리케이션의 초안 버전을 게시하고 애플리케이션의 출시된 버전에 복원력 정책을 할당해야 합니다.
**애플리케이션의 초안 버전을 게시하고 복원력 정책을 할당하려면**
1. 애플리케이션의 초안 버전을 게시하려면 `PublishAppVersion` API를 사용합니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_PublishAppVersion.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_PublishAppVersion.html) 단원을 참조하세요.
다음 예제에서는 `PublishAppVersion` API를 AWS Resilience Hub 사용하여에서 애플리케이션의 초안 버전을 게시하는 방법을 보여줍니다.
**요청**
```
aws resiliencehub publish-app-version \
--app-arn
```
**응답**
```
{
"appArn": "",
"appVersion": "release"
}
```
1. `UpdateApp` API를 사용하여 애플리케이션의 출시된 버전에 복원력 정책을 적용합니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateApp.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateApp.html) 단원을 참조하세요.
다음 예제에서는 `UpdateApp` API를 AWS Resilience Hub 사용하여에서 릴리스된 애플리케이션 버전에 복원력 정책을 적용하는 방법을 보여줍니다.
**요청**
```
aws resiliencehub update-app \
--app-arn \
--policy-arn
```
**응답**
```
{
"app": {
"appArn": "",
"name": "newApp",
"policyArn": "",
"creationTime": "2022-10-26T19:48:00.434000+03:00",
"status": "Active",
"complianceStatus": "NotAssessed",
"resiliencyScore": 0.0,
"tags": {
"resourceArn": ""
},
"assessmentSchedule": "Disabled"
}
}
```
# AWS Resilience Hub 복원력 평가 실행 및 관리
새 버전의 애플리케이션을 게시한 후에는 새 복원력 평가를 실행하고 결과를 분석하여 애플리케이션이 복원력 정책에 정의된 예상 워크로드 RTO와 예상 RPO를 충족하는지 확인해야 합니다. 평가에서는 각 애플리케이션 구성 요소 구성을 정책과 비교하고 경보, SOP 및 테스트 권장 사항을 제시합니다.
자세한 내용은 다음 항목을 참조하세요.
+ [AWS Resilience Hub 복원력 평가 실행 및 모니터링](#run-assess-analyze-using-api)
+ [평가 결과 검사](#run-assessment-using-api)
## AWS Resilience Hub 복원력 평가 실행 및 모니터링
에서 복원력 평가를 실행 AWS Resilience Hub 하고 상태를 모니터링하려면 다음 APIs를 사용해야 합니다.
+ `StartAppAssessment` – 이 API는 애플리케이션에 대한 새 평가를 생성합니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_StartAppAssessment.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_StartAppAssessment.html) 단원을 참조하세요.
+ `DescribeAppAssessment` – 이 API는 애플리케이션에 대한 평가를 설명하고 평가 완료 상태를 제공합니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeAppAssessment.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeAppAssessment.html) 단원을 참조하세요.
다음 예제는 AWS Resilience Hub 에서 `StartAppAssessment` API 사용 시 새 평가 실행을 시작하는 방법을 보여줍니다.
### 요청
```
aws resiliencehub start-app-assessment \
--app-arn \
--app-version release \
--assessment-name first-assessment
```
### 응답
```
{
"assessment": {
"appArn": "",
"appVersion": "release",
"invoker": "User",
"assessmentStatus": "Pending",
"startTime": "2022-10-27T08:15:10.452000+03:00",
"assessmentName": "first-assessment",
"assessmentArn": "",
"policy": {
"policyArn": "",
"policyName": "newPolicy",
"dataLocationConstraint": "AnyLocation",
"policy": {
"AZ": {
"rtoInSecs": 172800,
"rpoInSecs": 86400
},
"Hardware": {
"rtoInSecs": 172800,
"rpoInSecs": 86400
},
"Software": {
"rtoInSecs": 172800,
"rpoInSecs": 86400
}
}
},
"tags": {}
}
}
```
다음 예제는 AWS Resilience Hub 에서 `DescribeAppAssessment` API 사용 시 평가 상태를 모니터링하는 방법을 보여줍니다. `assessmentStatus` 변수에서 평가 상태를 추출할 수 있습니다.
### 요청
```
aws resiliencehub describe-app-assessment \
--assessment-arn
```
### 응답
```
{
"assessment": {
"appArn": "",
"appVersion": "release",
"cost": {
"amount": 0.0,
"currency": "USD",
"frequency": "Monthly"
},
"resiliencyScore": {
"score": 0.27,
"disruptionScore": {
"AZ": 0.42,
"Hardware": 0.0,
"Region": 0.0,
"Software": 0.38
}
},
"compliance": {
"AZ": {
"achievableRtoInSecs": 0,
"currentRtoInSecs": 4500,
"currentRpoInSecs": 86400,
"complianceStatus": "PolicyMet",
"achievableRpoInSecs": 0
},
"Hardware": {
"achievableRtoInSecs": 0,
"currentRtoInSecs": 2595601,
"currentRpoInSecs": 2592001,
"complianceStatus": "PolicyBreached",
"achievableRpoInSecs": 0
},
"Software": {
"achievableRtoInSecs": 0,
"currentRtoInSecs": 4500,
"currentRpoInSecs": 86400,
"complianceStatus": "PolicyMet",
"achievableRpoInSecs": 0
}
},
"complianceStatus": "PolicyBreached",
"assessmentStatus": "Success",
"startTime": "2022-10-27T08:15:10.452000+03:00",
"endTime": "2022-10-27T08:15:31.883000+03:00",
"assessmentName": "first-assessment",
"assessmentArn": "",
"policy": {
"policyArn": "",
"policyName": "newPolicy",
"dataLocationConstraint": "AnyLocation",
"policy": {
"AZ": {
"rtoInSecs": 172800,
"rpoInSecs": 86400
},
"Hardware": {
"rtoInSecs": 172800,
"rpoInSecs": 86400
},
"Software": {
"rtoInSecs": 172800,
"rpoInSecs": 86400
}
}
},
"tags": {}
}
}
```
## 평가 결과 검사
평가가 성공적으로 완료되면 다음 API를 사용하여 평가 결과를 검토할 수 있습니다.
+ `DescribeAppAssessment` – 이 API를 사용하면 복원력 정책을 기준으로 애플리케이션의 현재 상태를 추적할 수 있습니다. 또한 `complianceStatus` 변수에서 규정 준수 상태를 추출하고 `resiliencyScore` 구조에서 각 중단 유형에 대한 복원력 점수를 추출할 수도 있습니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeAppAssessment.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeAppAssessment.html) 단원을 참조하세요.
+ `ListAlarmRecommendations` – 이 API를 사용하면 평가의 Amazon 리소스 이름(ARN)을 사용해 경보 권장 사항을 얻을 수 있습니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_ListAlarmRecommendations.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_ListAlarmRecommendations.html) 단원을 참조하세요.
**참고**
SOP 및 FIS 테스트 권장 사항을 얻으려면 `ListSopRecommendations` 및 `ListTestRecommendations` API를 사용합니다.
다음 예제는 `ListAlarmRecommendations` API를 사용하는 평가의 Amazon 리소스 이름(ARN)을 사용하여 경보 권장 사항을 얻는 방법을 보여줍니다.
**참고**
SOP 및 FIS 테스트 권장 사항을 얻으려면 `ListSopRecommendations` 또는 `ListTestRecommendations` 중 하나로 바꿉니다.
### 요청
```
aws resiliencehub list-alarm-recommendations \
--assessment-arn
```
### 응답
```
{
"alarmRecommendations": [
{
"recommendationId": "78ece7f8-c776-499e-baa8-b35f5e8b8ba2",
"referenceId": "app_common:alarm:synthetic_canary:2021-04-01",
"name": "AWSResilienceHub-SyntheticCanaryInRegionAlarm_2021-04-01",
"description": "A monitor for the entire application, configured to constantly verify that the application API/endpoints are available",
"type": "Metric",
"appComponentName": "appcommon",
"items": [
{
"resourceId": "us-west-2",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
],
"prerequisite": "Make sure Amazon CloudWatch Synthetics is setup to monitor the application (see the docs). \nMake sure that the Synthetics Name passed in the alarm dimension matches the name of the Synthetic Canary. It Defaults to the name of the application.\n"
},
{
"recommendationId": "d9c72c58-8c00-43f0-ad5d-0c6e5332b84b",
"referenceId": "efs:alarm:percent_io_limit:2020-04-01",
"name": "AWSResilienceHub-EFSHighIoAlarm_2020-04-01",
"description": "An alarm by AWS Resilience Hub that reports when Amazon EFS I/O load is more than 90% for too much time",
"type": "Metric",
"appComponentName": "storageappcomponent-rlb",
"items": [
{
"resourceId": "fs-0487f945c02f17b3e",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
]
},
{
"recommendationId": "09f340cd-3427-4f66-8923-7f289d4a3216",
"referenceId": "efs:alarm:mount_failure:2020-04-01",
"name": "AWSResilienceHub-EFSMountFailureAlarm_2020-04-01",
"description": "An alarm by AWS Resilience Hub that reports when volume failed to mount to EC2 instance",
"type": "Metric",
"appComponentName": "storageappcomponent-rlb",
"items": [
{
"resourceId": "fs-0487f945c02f17b3e",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
],
"prerequisite": "* Make sure Amazon EFS utils are installed(see the docs).\n* Make sure cloudwatch logs are enabled in efs-utils (see the docs).\n* Make sure that you've configured `log_group_name` in `/etc/amazon/efs/efs-utils.conf`, for example: `log_group_name = /aws/efs/utils`.\n* Use the created `log_group_name` in the generated alarm. Find `LogGroupName: REPLACE_ME` in the alarm and make sure the `log_group_name` is used instead of REPLACE_ME.\n"
},
{
"recommendationId": "b0f57d2a-1220-4f40-a585-6dab1e79cee2",
"referenceId": "efs:alarm:client_connections:2020-04-01",
"name": "AWSResilienceHub-EFSHighClientConnectionsAlarm_2020-04-01",
"description": "An alarm by AWS Resilience Hub that reports when client connection number deviation is over the specified threshold",
"type": "Metric",
"appComponentName": "storageappcomponent-rlb",
"items": [
{
"resourceId": "fs-0487f945c02f17b3e",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
]
},
{
"recommendationId": "15f49b10-9bac-4494-b376-705f8da252d7",
"referenceId": "rds:alarm:health-storage:2020-04-01",
"name": "AWSResilienceHub-RDSInstanceLowStorageAlarm_2020-04-01",
"description": "Reports when database free storage is low",
"type": "Metric",
"appComponentName": "databaseappcomponent-hji",
"items": [
{
"resourceId": "terraform-20220623141426115800000001",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
]
},
{
"recommendationId": "c1906101-cea8-4f77-be7b-60abb07621f5",
"referenceId": "rds:alarm:health-connections:2020-04-01",
"name": "AWSResilienceHub-RDSInstanceConnectionSpikeAlarm_2020-04-01",
"description": "Reports when database connection count is anomalous",
"type": "Metric",
"appComponentName": "databaseappcomponent-hji",
"items": [
{
"resourceId": "terraform-20220623141426115800000001",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
]
},
{
"recommendationId": "f169b8d4-45c1-4238-95d1-ecdd8d5153fe",
"referenceId": "rds:alarm:health-cpu:2020-04-01",
"name": "AWSResilienceHub-RDSInstanceOverUtilizedCpuAlarm_2020-04-01",
"description": "Reports when database used CPU is high",
"type": "Metric",
"appComponentName": "databaseappcomponent-hji",
"items": [
{
"resourceId": "terraform-20220623141426115800000001",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
]
},
{
"recommendationId": "69da8459-cbe4-4ba1-a476-80c7ebf096f0",
"referenceId": "rds:alarm:health-memory:2020-04-01",
"name": "AWSResilienceHub-RDSInstanceLowMemoryAlarm_2020-04-01",
"description": "Reports when database free memory is low",
"type": "Metric",
"appComponentName": "databaseappcomponent-hji",
"items": [
{
"resourceId": "terraform-20220623141426115800000001",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
]
},
{
"recommendationId": "67e7902a-f658-439e-916b-251a57b97c8a",
"referenceId": "ecs:alarm:health-service_cpu_utilization:2020-04-01",
"name": "AWSResilienceHub-ECSServiceHighCpuUtilizationAlarm_2020-04-01",
"description": "An alarm by AWS Resilience Hub that triggers when CPU utilization of ECS tasks of Service exceeds the threshold",
"type": "Metric",
"appComponentName": "computeappcomponent-nrz",
"items": [
{
"resourceId": "aws_ecs_service_terraform-us-east-1-demo",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
]
},
{
"recommendationId": "fb30cb91-1f09-4abd-bd2e-9e8ee8550eb0",
"referenceId": "ecs:alarm:health-service_memory_utilization:2020-04-01",
"name": "AWSResilienceHub-ECSServiceHighMemoryUtilizationAlarm_2020-04-01",
"description": "An alarm by AWS Resilience Hub for Amazon ECS that indicates if the percentage of memory that is used in the service, is exceeding specified threshold limit",
"type": "Metric",
"appComponentName": "computeappcomponent-nrz",
"items": [
{
"resourceId": "aws_ecs_service_terraform-us-east-1-demo",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
]
},
{
"recommendationId": "1bd45a8e-dd58-4a8e-a628-bdbee234efed",
"referenceId": "ecs:alarm:health-service_sample_count:2020-04-01",
"name": "AWSResilienceHub-ECSServiceSampleCountAlarm_2020-04-01",
"description": "An alarm by AWS Resilience Hub for Amazon ECS that triggers if the count of tasks isn't equal Service Desired Count",
"type": "Metric",
"appComponentName": "computeappcomponent-nrz",
"items": [
{
"resourceId": "aws_ecs_service_terraform-us-east-1-demo",
"targetAccountId": "12345678901",
"targetRegion": "us-west-2",
"alreadyImplemented": false
}
],
"prerequisite": "Make sure the Container Insights on Amazon ECS is enabled: (see the docs)."
}
]
}
```
다음 예제는 `ListAppComponentRecommendations` API를 사용하여 구성 권장 사항 현재 복원력을 개선하는 방법에 대한 권장 사항)을 얻는 방법을 보여줍니다.
### 요청
```
aws resiliencehub list-app-component-recommendations \
--assessment-arn
```
### 응답
```
{
"componentRecommendations": [
{
"appComponentName": "computeappcomponent-nrz",
"recommendationStatus": "MetCanImprove",
"configRecommendations": [
{
"cost": {
"amount": 0.0,
"currency": "USD",
"frequency": "Monthly"
},
"appComponentName": "computeappcomponent-nrz",
"recommendationCompliance": {
"AZ": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": " Estimated time to restore cluster with volumes. (Estimate is based on averages, real time restore may vary).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Based on the frequency of the backups"
},
"Hardware": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": " Estimated time to restore cluster with volumes. (Estimate is based on averages, real time restore may vary).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Based on the frequency of the backups"
},
"Software": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": " Estimated time to restore cluster with volumes. (Estimate is based on averages, real time restore may vary).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Based on the frequency of the backups"
}
},
"optimizationType": "LeastCost",
"description": "Current Configuration",
"suggestedChanges": [],
"haArchitecture": "BackupAndRestore",
"referenceId": "original"
},
{
"cost": {
"amount": 0.0,
"currency": "USD",
"frequency": "Monthly"
},
"appComponentName": "computeappcomponent-nrz",
"recommendationCompliance": {
"AZ": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": " Estimated time to restore cluster with volumes. (Estimate is based on averages, real time restore may vary).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Based on the frequency of the backups"
},
"Hardware": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": " Estimated time to restore cluster with volumes. (Estimate is based on averages, real time restore may vary).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Based on the frequency of the backups"
},
"Software": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": " Estimated time to restore cluster with volumes. (Estimate is based on averages, real time restore may vary).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Based on the frequency of the backups"
}
},
"optimizationType": "LeastChange",
"description": "Current Configuration",
"suggestedChanges": [],
"haArchitecture": "BackupAndRestore",
"referenceId": "original"
},
{
"cost": {
"amount": 14.74,
"currency": "USD",
"frequency": "Monthly"
},
"appComponentName": "computeappcomponent-nrz",
"recommendationCompliance": {
"AZ": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 0,
"expectedRtoDescription": "No expected downtime. You're launching using EC2, with DesiredCount > 1 in multiple AZs and CapacityProviders with MinSize > 1",
"expectedRpoInSecs": 0,
"expectedRpoDescription": "ECS Service state is saved on Amazon EFS file system. No data loss is expected as objects are be stored in multiple AZs."
},
"Hardware": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 0,
"expectedRtoDescription": "No expected downtime. You're launching using EC2, with DesiredCount > 1 and CapacityProviders with MinSize > 1",
"expectedRpoInSecs": 0,
"expectedRpoDescription": "ECS Service state is saved on Amazon EFS file system. No data loss is expected as objects are be stored in multiple AZs."
},
"Software": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": " Estimated time to restore cluster with volumes. (Estimate is based on averages, real time restore may vary).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Based on the frequency of the backups"
}
},
"optimizationType": "BestAZRecovery",
"description": "Stateful Amazon ECS service with launch type Amazon EC2 and Amazon EFS storage, deployed in multiple AZs. AWS Backup is used to backup Amazon EFS and copy snapshots in-Region.",
"suggestedChanges": [
"Add AWS Auto Scaling Groups and Capacity Providers in multiple AZs",
"Change desired count of the setup",
"Remove Amazon EBS volume"
],
"haArchitecture": "BackupAndRestore",
"referenceId": "ecs:config:ec2-multi_az-efs-backups:2022-02-16"
}
]
},
{
"appComponentName": "databaseappcomponent-hji",
"recommendationStatus": "MetCanImprove",
"configRecommendations": [
{
"cost": {
"amount": 0.0,
"currency": "USD",
"frequency": "Monthly"
},
"appComponentName": "databaseappcomponent-hji",
"recommendationCompliance": {
"AZ": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": "Estimated time to restore from an RDS backup. (Estimates are averages based on size, real time may vary greatly from estimate).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Estimate based on the backup schedule. (Estimates are calculated from backup schedule, real time restore may vary)."
},
"Hardware": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": "Estimated time to restore from snapshot. (Estimates are averages based on size, real time may vary greatly from estimate).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Estimate based on the backup schedule. (Estimates are calculated from backup schedule, real time restore may vary)."
},
"Software": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": "Estimated time to restore from snapshot. (Estimates are averages based on size, real time may vary greatly from estimate).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Estimate based on the backup schedule. (Estimates are calculated from backup schedule, real time restore may vary)."
}
},
"optimizationType": "LeastCost",
"description": "Current Configuration",
"suggestedChanges": [],
"haArchitecture": "BackupAndRestore",
"referenceId": "original"
},
{
"cost": {
"amount": 0.0,
"currency": "USD",
"frequency": "Monthly"
},
"appComponentName": "databaseappcomponent-hji",
"recommendationCompliance": {
"AZ": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": "Estimated time to restore from an RDS backup. (Estimates are averages based on size, real time may vary greatly from estimate).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Estimate based on the backup schedule. (Estimates are calculated from backup schedule, real time restore may vary)."
},
"Hardware": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": "Estimated time to restore from snapshot. (Estimates are averages based on size, real time may vary greatly from estimate).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Estimate based on the backup schedule. (Estimates are calculated from backup schedule, real time restore may vary)."
},
"Software": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 1800,
"expectedRtoDescription": "Estimated time to restore from snapshot. (Estimates are averages based on size, real time may vary greatly from estimate).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Estimate based on the backup schedule. (Estimates are calculated from backup schedule, real time restore may vary)."
}
},
"optimizationType": "LeastChange",
"description": "Current Configuration",
"suggestedChanges": [],
"haArchitecture": "BackupAndRestore",
"referenceId": "original"
},
{
"cost": {
"amount": 76.73,
"currency": "USD",
"frequency": "Monthly"
},
"appComponentName": "databaseappcomponent-hji",
"recommendationCompliance": {
"AZ": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 120,
"expectedRtoDescription": "Estimated time to promote a secondary instance.",
"expectedRpoInSecs": 0,
"expectedRpoDescription": "Aurora data is automatically replicated across multiple Availability Zones in a Region."
},
"Hardware": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 120,
"expectedRtoDescription": "Estimated time to promote a secondary instance.",
"expectedRpoInSecs": 0,
"expectedRpoDescription": "Aurora data is automatically replicated across multiple Availability Zones in a Region."
},
"Software": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 900,
"expectedRtoDescription": "Estimate time to backtrack to a stable state.",
"expectedRpoInSecs": 300,
"expectedRpoDescription": "Estimate for latest restorable time for point in time recovery."
}
},
"optimizationType": "BestAZRecovery",
"description": "Aurora database cluster with one read replica, with backtracking window of 24 hours.",
"suggestedChanges": [
"Add read replica in the same Region",
"Change DB instance to a supported class (db.t3.small)",
"Change to Aurora",
"Enable cluster backtracking",
"Enable instance backup with retention period 7"
],
"haArchitecture": "WarmStandby",
"referenceId": "rds:config:aurora-backtracking"
}
]
},
{
"appComponentName": "storageappcomponent-rlb",
"recommendationStatus": "BreachedUnattainable",
"configRecommendations": [
{
"cost": {
"amount": 0.0,
"currency": "USD",
"frequency": "Monthly"
},
"appComponentName": "storageappcomponent-rlb",
"recommendationCompliance": {
"AZ": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 0,
"expectedRtoDescription": "No data loss in your system",
"expectedRpoInSecs": 0,
"expectedRpoDescription": "No data loss in your system"
},
"Hardware": {
"expectedComplianceStatus": "PolicyBreached",
"expectedRtoInSecs": 2592001,
"expectedRtoDescription": "No recovery option configured",
"expectedRpoInSecs": 2592001,
"expectedRpoDescription": "No recovery option configured"
},
"Software": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 900,
"expectedRtoDescription": "Time to recover Amazon EFS from backup. (Estimate is based on averages, real time restore may vary).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Recovery Point Objective for Amazon EFS from backups, derived from backup frequency"
}
},
"optimizationType": "BestAZRecovery",
"description": "Amazon EFS with backups configured",
"suggestedChanges": [
"Add additional availability zone"
],
"haArchitecture": "MultiSite",
"referenceId": "efs:config:with_backups:2020-04-01"
},
{
"cost": {
"amount": 0.0,
"currency": "USD",
"frequency": "Monthly"
},
"appComponentName": "storageappcomponent-rlb",
"recommendationCompliance": {
"AZ": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 0,
"expectedRtoDescription": "No data loss in your system",
"expectedRpoInSecs": 0,
"expectedRpoDescription": "No data loss in your system"
},
"Hardware": {
"expectedComplianceStatus": "PolicyBreached",
"expectedRtoInSecs": 2592001,
"expectedRtoDescription": "No recovery option configured",
"expectedRpoInSecs": 2592001,
"expectedRpoDescription": "No recovery option configured"
},
"Software": {
"expectedComplianceStatus": "PolicyMet",
"expectedRtoInSecs": 900,
"expectedRtoDescription": "Time to recover Amazon EFS from backup. (Estimate is based on averages, real time restore may vary).",
"expectedRpoInSecs": 86400,
"expectedRpoDescription": "Recovery Point Objective for Amazon EFS from backups, derived from backup frequency"
}
},
"optimizationType": "BestAttainable",
"description": "Amazon EFS with backups configured",
"suggestedChanges": [
"Add additional availability zone"
],
"haArchitecture": "MultiSite",
"referenceId": "efs:config:with_backups:2020-04-01"
}
]
}
]
}
```
# 애플리케이션 수정
AWS Resilience Hub 를 사용하면 애플리케이션의 초안 버전을 편집하고 변경 사항을 새(게시된) 버전에 게시하여 애플리케이션 리소스를 수정할 수 있습니다. AWS Resilience Hub 는 복원력 평가를 실행하기 위해 업데이트된 리소스가 포함된 애플리케이션의 게시된 버전을 사용합니다.
자세한 내용은 다음 항목을 참조하세요.
+ [애플리케이션에 리소스 수동 추가](#manually-add-resource-using-api)
+ [리소스를 단일 애플리케이션 구성 요소로 그룹화](#group-resource-using-api)
+ [AppComponent에서 리소스 제외하기](#exclude-resource-using-api)
## 애플리케이션에 리소스 수동 추가
리소스가 입력 소스의 일부로 배포되지 않은 경우 `CreateAppVersionResource` API AWS Resilience Hub 를 사용하여 애플리케이션에 리소스를 수동으로 추가할 수 있습니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateAppVersionResource.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateAppVersionResource.html) 단원을 참조하세요.
다음 파라미터를 이 API에 입력해야 합니다.
+ 애플리케이션의 Amazon 리소스 이름(ARN)입니다.
+ 리소스의 논리적 ID
+ 리소스의 물리적 ID
+ AWS CloudFormation 유형
다음 예제는 AWS Resilience Hub 에서 `CreateAppVersionResource` API를 사용하여 애플리케이션에 리소스를 수동으로 추가하는 방법을 보여줍니다.
### 요청
```
aws resiliencehub create-app-version-resource \
--app-arn \
--resource-name "backup-efs" \
--logical-resource-id '{"identifier": "backup-efs"}' \
--physical-resource-id '' \
--resource-type AWS::EFS::FileSystem \
--app-components '["new-app-component"]'
```
### 응답
```
{
"appArn": "",
"appVersion": "draft",
"physicalResource": {
"resourceName": "backup-efs",
"logicalResourceId": {
"identifier": "backup-efs"
},
"physicalResourceId": {
"identifier": "",
"type": "Arn"
},
"resourceType": "AWS::EFS::FileSystem",
"appComponents": [
{
"name": "new-app-component",
"type": "AWS::ResilienceHub::StorageAppComponent",
"id": "new-app-component"
}
]
}
}
```
## 리소스를 단일 애플리케이션 구성 요소로 그룹화
애플리케이션 구성 요소(AppComponent)는 단일 단위로 작동하고 실패하는 관련 AWS 리소스 그룹입니다. 예를 들어 대기 배포로 사용되는 리전 간 워크로드가 있는 경우, AWS Resilience Hub 에는 어떤 AWS 리소스가 어떤 유형의 AppComponent에 속할 수 있는지에 대한 규칙이 있습니다.는 다음 리소스 관리 APIs를 사용하여 리소스를 단일 AppComponent로 그룹화할 수 있도록 AWS Resilience Hub 허용합니다.
+ `UpdateAppVersionResource` – 이 API는 애플리케이션의 리소스 세부 정보를 업데이트합니다. 이 API에 대한 자세한 내용은 [UpdateAppVersionResource](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateAppVersionResource.html) 단원을 참조하세요.
+ `DeleteAppVersionAppComponent` – 이 API는 애플리케이션에서 AppComponent를 삭제합니다. 이 API에 대한 자세한 내용은 [DeleteAppVersionAppComponent](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DeleteAppVersionAppComponent.html) 단원을 참조하세요.
다음 예제에서는 `DeleteAppVersionAppComponent` API를 AWS Resilience Hub 사용하여에서 애플리케이션의 리소스 세부 정보를 업데이트하는 방법을 보여줍니다.
### 요청
```
aws resiliencehub delete-app-version-app-component \
--app-arn \
--id new-app-component
```
### 응답
```
{
"appArn": "",
"appVersion": "draft",
"appComponent": {
"name": "new-app-component",
"type": "AWS::ResilienceHub::StorageAppComponent",
"id": "new-app-component"
}
}
```
다음 예제에서는 `UpdateAppVersionResource` API를 AWS Resilience Hub 사용하여 이전 예제에서 생성된 빈 AppComponent를 삭제하는 방법을 보여줍니다.
### 요청
```
aws resiliencehub delete-app-version-app-component \
--app-arn \
--id new-app-component
```
### 응답
```
{
"appArn": "",
"appVersion": "draft",
"appComponent": {
"name": "new-app-component",
"type": "AWS::ResilienceHub::StorageAppComponent",
"id": "new-app-component"
}
}
```
## AppComponent에서 리소스 제외하기
AWS Resilience Hub 를 사용하면 `UpdateAppVersionResource` API를 사용하여 평가에서 리소스를 제외할 수 있습니다. 애플리케이션의 복원력을 계산할 때는 이러한 리소스가 고려되지 않습니다. 이 API에 대한 자세한 내용은 [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateAppVersionResource.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateAppVersionResource.html) 단원을 참조하세요.
**참고**
입력 소스에서 가져온 리소스만 제외할 수 있습니다.
다음 예제는 AWS Resilience Hub 에서 `UpdateAppVersionResource` API를 사용할 때 애플리케이션의 리소스를 제외하는 방법을 보여줍니다.
### 요청
```
aws resiliencehub update-app-version-resource \
--app-arn \
--resource-name "ec2instance-nvz" \
--excluded
```
### 응답
```
{
"appArn": "",
"appVersion": "draft",
"physicalResource": {
"resourceName": "ec2instance-nvz",
"logicalResourceId": {
"identifier": "ec2",
"terraformSourceName": "test.state.file"
},
"physicalResourceId": {
"identifier": "i-0b58265a694e5ffc1",
"type": "Native",
"awsRegion": "us-west-2",
"awsAccountId": "123456789101"
},
"resourceType": "AWS::EC2::Instance",
"appComponents": [
{
"name": "computeappcomponent-nrz",
"type": "AWS::ResilienceHub::ComputeAppComponent"
}
]
}
}
```