Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Wird AWS Resilience Hub APIs zur Beschreibung und Verwaltung der Anwendung verwendet
Als Alternative zur Beschreibung und Verwaltung von Anwendungen mithilfe der AWS Resilience Hub Konsole AWS Resilience Hub ermöglicht es Ihnen, Anwendungen mithilfe von zu beschreiben und zu verwalten AWS Resilience Hub APIs. In diesem Kapitel wird erklärt, wie Sie eine Anwendung mithilfe von erstellen AWS Resilience Hub APIs. Es definiert auch die Reihenfolge, in der Sie die ausführen müssen, APIs und die Parameterwerte, die Sie mit entsprechenden Beispielen angeben müssen. Weitere Informationen finden Sie unter den folgenden Themen:
+ [Vorbereitung des Antrags](prepare-app-using-api.md)
+ [Durchführung und Verwaltung von AWS Resilience Hub Resilienzbewertungen](running-app-using-api.md)
+ [Ihre Anwendung ändern](modify-application-using-api.md)
# Vorbereitung des Antrags
Um eine Anwendung vorzubereiten, müssen Sie zuerst eine Anwendung erstellen, eine Ausfallsicherheitsrichtlinie zuweisen und dann die Anwendungsressourcen aus Ihren Eingabequellen importieren. Weitere Informationen zu den AWS Resilience Hub APIs , die zur Vorbereitung einer Anwendung verwendet werden, finden Sie in den folgenden Themen:
+ [Erstellen einer Anwendung](#create-app-using-api)
+ [Erstellung einer Resilienzrichtlinie](#create-res-policy-using-api)
+ [Ressourcen aus einer Eingabequelle importieren und den Importstatus überwachen](#import-app-resource-using-api)
+ [Veröffentlichung der Entwurfsversion Ihrer Anwendung und Zuweisung einer Ausfallsicherheitsrichtlinie](#publish-application-using-api)
## Erstellen einer Anwendung
Um eine neue Anwendung zu erstellen AWS Resilience Hub, müssen Sie die `CreateApp` API aufrufen und einen eindeutigen Anwendungsnamen angeben. Weitere Informationen über diese API finden Sie unter [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateApp.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateApp.html).
Das folgende Beispiel zeigt, wie Sie AWS Resilience Hub mithilfe der `CreateApp` API eine neue Anwendung `newApp` erstellen.
### Anforderung
```
aws resiliencehub create-app --name newApp
```
### Antwort
```
{
"app": {
"appArn": "",
"name": "newApp",
"creationTime": "2022-10-26T19:48:00.434000+03:00",
"status": "Active",
"complianceStatus": "NotAssessed",
"resiliencyScore": 0.0,
"tags": {},
"assessmentSchedule": "Disabled"
}
}
```
## Erstellung einer Resilienzrichtlinie
Nachdem Sie die Anwendung erstellt haben, müssen Sie eine Ausfallsicherheitsrichtlinie erstellen, die es Ihnen ermöglicht, mithilfe `CreateResiliencyPolicy` der API einen Überblick über die Ausfallsicherheit Ihrer Anwendung zu erhalten. Weitere Informationen über diese API finden Sie unter [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateResiliencyPolicy.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateResiliencyPolicy.html).
Das folgende Beispiel zeigt, wie Sie AWS Resilience Hub mithilfe `CreateResiliencyPolicy` der API `newPolicy` etwas für Ihre Anwendung erstellen.
### Anforderung
```
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}}'
```
### Antwort
```
{
"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": {}
}
}
```
## Ressourcen aus einer Eingabequelle importieren und den Importstatus überwachen
AWS Resilience Hub bietet Folgendes APIs , um Ressourcen in Ihre Anwendung zu importieren:
+ `ImportResourcesToDraftAppVersion`— Diese API ermöglicht es Ihnen, Ressourcen aus verschiedenen Eingabequellen in die Entwurfsversion Ihrer Anwendung zu importieren. Weitere Informationen über diese API finden Sie unter [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`— Diese API veröffentlicht zusammen mit der aktualisierten Version eine neue Version der Anwendung AppComponents. Weitere Informationen über diese API finden Sie unter [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`— Mit dieser API können Sie den Importstatus Ihrer Ressourcen in eine Anwendungsversion überwachen. Weitere Informationen über diese API finden Sie unter [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeDraftAppVersionResourcesImportStatus.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeDraftAppVersionResourcesImportStatus.html).
Das folgende Beispiel zeigt, wie Sie AWS Resilience Hub mithilfe der `ImportResourcesToDraftAppVersion` API Ressourcen in Ihre Anwendung importieren.
### Anforderung
```
aws resiliencehub import-resources-to-draft-app-version \
--app-arn \
--terraform-sources '[{"s3StateFileUrl": }]'
```
### Antwort
```
{
"appArn": "",
"appVersion": "draft",
"sourceArns": [],
"status": "Pending",
"terraformSources": [
{
"s3StateFileUrl":
}
]
}
```
Das folgende Beispiel zeigt, wie Sie Ihrer Anwendung AWS Resilience Hub mithilfe der `CreateAppVersionResource` API manuell Ressourcen hinzufügen können.
### Anforderung
```
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"]'
```
### Antwort
```
{
"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"
}
]
}
}
```
Das folgende Beispiel zeigt, wie Sie den Importstatus Ihrer Ressourcen AWS Resilience Hub mithilfe der `DescribeDraftAppVersionResourcesImportStatus` API überwachen können.
### Anforderung
```
aws resiliencehub describe-draft-app-version-resources-import-status \
--app-arn
```
### Antwort
```
{
"appArn": "",
"appVersion": "draft",
"status": "Success",
"statusChangeTime": "2022-10-26T19:55:18.471000+03:00"
}
```
## Veröffentlichung der Entwurfsversion Ihrer Anwendung und Zuweisung einer Ausfallsicherheitsrichtlinie
Bevor Sie eine Bewertung durchführen, müssen Sie zunächst die Entwurfsversion Ihrer Anwendung veröffentlichen und der veröffentlichten Version Ihrer Anwendung eine Ausfallsicherheitsrichtlinie zuweisen.
**Um die Entwurfsversion Ihrer Anwendung zu veröffentlichen und eine Ausfallsicherheitsrichtlinie zuzuweisen**
1. Verwenden Sie die `PublishAppVersion` API, um die Entwurfsversion Ihrer Anwendung zu veröffentlichen. Weitere Informationen über diese API finden Sie unter [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_PublishAppVersion.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_PublishAppVersion.html).
Das folgende Beispiel zeigt, wie Sie die Entwurfsversion der Anwendung AWS Resilience Hub mithilfe der `PublishAppVersion` API veröffentlichen.
**Anforderung**
```
aws resiliencehub publish-app-version \
--app-arn
```
**Antwort**
```
{
"appArn": "",
"appVersion": "release"
}
```
1. Wenden Sie mithilfe der `UpdateApp` API eine Resilienzrichtlinie auf die veröffentlichte Version Ihrer Anwendung an. Weitere Informationen über diese API finden Sie unter [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateApp.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateApp.html).
Das folgende Beispiel zeigt, wie Sie AWS Resilience Hub mithilfe `UpdateApp` der API eine Resilienzrichtlinie auf die veröffentlichte Version einer Anwendung anwenden.
**Anforderung**
```
aws resiliencehub update-app \
--app-arn \
--policy-arn
```
**Antwort**
```
{
"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"
}
}
```
# Durchführung und Verwaltung von AWS Resilience Hub Resilienzbewertungen
Nachdem Sie eine neue Version Ihrer Anwendung veröffentlicht haben, müssen Sie eine neue Resilienzbewertung durchführen und die Ergebnisse analysieren, um sicherzustellen, dass Ihre Anwendung den geschätzten Workload-RTO und den geschätzten RPO-Wert erfüllt, die in Ihrer Resilienz-Richtlinie definiert sind. Bei der Bewertung wird jede Konfiguration der Anwendungskomponente mit der Richtlinie verglichen und es werden Alarm-, SOP- und Testempfehlungen ausgesprochen.
Weitere Informationen finden Sie unter den folgenden Themen:
+ [Durchführung und Überwachung von AWS Resilience Hub Resilienzbewertungen](#run-assess-analyze-using-api)
+ [Prüfung der Bewertungsergebnisse](#run-assessment-using-api)
## Durchführung und Überwachung von AWS Resilience Hub Resilienzbewertungen
Um Resilienzbewertungen durchzuführen AWS Resilience Hub und deren Status zu überwachen, müssen Sie Folgendes verwenden: APIs
+ `StartAppAssessment`— Diese API erstellt eine neue Bewertung für eine Anwendung. Weitere Informationen über diese API finden Sie unter [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`— Diese API beschreibt eine Bewertung für die Anwendung und gibt den Abschlussstatus der Bewertung an. Weitere Informationen über diese API finden Sie unter [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeAppAssessment.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeAppAssessment.html).
Das folgende Beispiel zeigt, wie Sie AWS Resilience Hub mithilfe der `StartAppAssessment` API mit der Durchführung einer neuen Bewertung beginnen.
### Anforderung
```
aws resiliencehub start-app-assessment \
--app-arn \
--app-version release \
--assessment-name first-assessment
```
### Antwort
```
{
"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": {}
}
}
```
Das folgende Beispiel zeigt, wie Sie den Status Ihrer Bewertung AWS Resilience Hub mithilfe der `DescribeAppAssessment` API überwachen können. Sie können den Status Ihrer Bewertung aus der `assessmentStatus` Variablen extrahieren.
### Anforderung
```
aws resiliencehub describe-app-assessment \
--assessment-arn
```
### Antwort
```
{
"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": {}
}
}
```
## Prüfung der Bewertungsergebnisse
Nachdem Ihre Bewertung erfolgreich abgeschlossen wurde, können Sie die Prüfungsergebnisse anhand der folgenden Methoden überprüfen APIs.
+ `DescribeAppAssessment`— Mit dieser API können Sie den aktuellen Status Ihrer Anwendung anhand der Resilienz-Richtlinie verfolgen. Darüber hinaus können Sie auch den Compliance-Status aus einer `complianceStatus` Variablen und die Resilienzbewertung für jeden Störungstyp aus der `resiliencyScore` Struktur extrahieren. Weitere Informationen über diese API finden Sie unter [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`— Diese API ermöglicht es Ihnen, die Alarmempfehlungen mithilfe des Amazon-Ressourcennamens (ARN) der Bewertung abzurufen. Weitere Informationen über diese API finden Sie unter [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_ListAlarmRecommendations.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_ListAlarmRecommendations.html).
**Anmerkung**
Um die SOP- und FIS-Testempfehlungen zu erhalten, verwenden Sie `ListSopRecommendations` und `ListTestRecommendations` APIs.
Das folgende Beispiel zeigt, wie Sie die Alarmempfehlungen mithilfe des Amazon-Ressourcennamens (ARN) der Bewertung mithilfe der `ListAlarmRecommendations` API abrufen können.
**Anmerkung**
Um die SOP- und FIS-Testempfehlungen zu erhalten, ersetzen Sie sie durch entweder `ListSopRecommendations` oder`ListTestRecommendations`.
### Anforderung
```
aws resiliencehub list-alarm-recommendations \
--assessment-arn
```
### Antwort
```
{
"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)."
}
]
}
```
Das folgende Beispiel zeigt, wie Sie mithilfe der `ListAppComponentRecommendations` API die Konfigurationsempfehlungen (Empfehlungen zur Verbesserung Ihrer aktuellen Resilienz) abrufen können.
### Anforderung
```
aws resiliencehub list-app-component-recommendations \
--assessment-arn
```
### Antwort
```
{
"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"
}
]
}
]
}
```
# Ihre Anwendung ändern
AWS Resilience Hub ermöglicht es Ihnen, Ihre Anwendungsressourcen zu ändern, indem Sie eine Entwurfsversion Ihrer Anwendung bearbeiten und die Änderungen in einer neuen (veröffentlichten) Version veröffentlichen. AWS Resilience Hub verwendet die veröffentlichte Version Ihrer Anwendung, die die aktualisierten Ressourcen enthält, für die Durchführung von Resilienzbewertungen.
Weitere Informationen finden Sie unter den folgenden Themen:
+ [Manuelles Hinzufügen von Ressourcen zu Ihrer Anwendung](#manually-add-resource-using-api)
+ [Gruppieren von Ressourcen in einer einzigen Anwendungskomponente](#group-resource-using-api)
+ [Ausschließen einer Ressource aus einem AppComponent](#exclude-resource-using-api)
## Manuelles Hinzufügen von Ressourcen zu Ihrer Anwendung
Wenn die Ressource nicht als Teil einer Eingabequelle bereitgestellt wird, AWS Resilience Hub können Sie die Ressource mithilfe der `CreateAppVersionResource` API manuell zu Ihrer Anwendung hinzufügen. Weitere Informationen über diese API finden Sie unter [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateAppVersionResource.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateAppVersionResource.html).
Sie müssen die folgenden Parameter für diese API angeben:
+ Amazon-Ressourcenname (ARN) der Anwendung
+ Logische ID der Ressource
+ Physikalische ID der Ressource
+ AWS CloudFormation Typ
Das folgende Beispiel zeigt, wie Sie Ihrer Anwendung AWS Resilience Hub mithilfe der `CreateAppVersionResource` API manuell Ressourcen hinzufügen können.
### Anforderung
```
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"]'
```
### Antwort
```
{
"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"
}
]
}
}
```
## Gruppieren von Ressourcen in einer einzigen Anwendungskomponente
Eine Anwendungskomponente (AppComponent) ist eine Gruppe verwandter AWS Ressourcen, die als eine Einheit funktionieren und ausfallen. Dies ist beispielsweise der Fall, wenn Sie über regionsübergreifende Workloads verfügen, die als Standby-Bereitstellungen verwendet werden. AWS Resilience Hub enthält Regeln, die festlegen, welche AWS Ressourcen zu welchem Typ gehören können. AppComponent AWS Resilience Hub ermöglicht es Ihnen, Ressourcen AppComponent mithilfe der folgenden Ressourcenverwaltung zu einer einzigen zusammenzufassen APIs.
+ `UpdateAppVersionResource`— Diese API aktualisiert die Ressourcendetails einer Anwendung. Weitere Informationen über diese API finden Sie unter [UpdateAppVersionResource](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateAppVersionResource.html).
+ `DeleteAppVersionAppComponent`— Diese API löscht die AppComponent aus der Anwendung. Weitere Informationen über diese API finden Sie unter [DeleteAppVersionAppComponent](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DeleteAppVersionAppComponent.html).
Das folgende Beispiel zeigt, wie Sie die Ressourcendetails Ihrer Anwendung AWS Resilience Hub mithilfe der `DeleteAppVersionAppComponent` API aktualisieren.
### Anforderung
```
aws resiliencehub delete-app-version-app-component \
--app-arn \
--id new-app-component
```
### Antwort
```
{
"appArn": "",
"appVersion": "draft",
"appComponent": {
"name": "new-app-component",
"type": "AWS::ResilienceHub::StorageAppComponent",
"id": "new-app-component"
}
}
```
Das folgende Beispiel zeigt, wie Sie die leere Datei löschen AppComponent , die in den vorherigen Beispielen AWS Resilience Hub mithilfe der `UpdateAppVersionResource` API erstellt wurde.
### Anforderung
```
aws resiliencehub delete-app-version-app-component \
--app-arn \
--id new-app-component
```
### Antwort
```
{
"appArn": "",
"appVersion": "draft",
"appComponent": {
"name": "new-app-component",
"type": "AWS::ResilienceHub::StorageAppComponent",
"id": "new-app-component"
}
}
```
## Ausschließen einer Ressource aus einem AppComponent
AWS Resilience Hub ermöglicht es Ihnen, Ressourcen mithilfe der `UpdateAppVersionResource` API von Bewertungen auszuschließen. Diese Ressourcen werden bei der Berechnung der Ausfallsicherheit Ihrer Anwendung nicht berücksichtigt. Weitere Informationen über diese API finden Sie unter [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateAppVersionResource.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateAppVersionResource.html).
**Anmerkung**
Sie können nur die Ressourcen ausschließen, die aus einer Eingabequelle importiert wurden.
Das folgende Beispiel zeigt, wie Sie eine Ressource Ihrer Anwendung bei der AWS Resilience Hub Verwendung der `UpdateAppVersionResource` API ausschließen können.
### Anforderung
```
aws resiliencehub update-app-version-resource \
--app-arn \
--resource-name "ec2instance-nvz" \
--excluded
```
### Antwort
```
{
"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"
}
]
}
}
```