Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Uso AWS Resilience Hub APIs para describir y administrar la aplicación
Como alternativa para describir y administrar la aplicación mediante AWS Resilience Hub la consola, AWS Resilience Hub permite describir y administrar las aplicaciones mediante AWS Resilience Hub APIs. En este capítulo se explica cómo crear una aplicación utilizando AWS Resilience Hub APIs. También define la secuencia en la que debe ejecutarse APIs y los valores de los parámetros que debe proporcionar con los ejemplos correspondientes. Para obtener más información, consulte los temas siguientes:
+ [Preparación de la aplicación](prepare-app-using-api.md)
+ [Ejecutar y gestionar las evaluaciones de AWS Resilience Hub resiliencia](running-app-using-api.md)
+ [Modificación de la aplicación](modify-application-using-api.md)
# Preparación de la aplicación
Para preparar una aplicación, primero debe crearla, asignar una política de resiliencia y, a continuación, importar los recursos de la aplicación desde sus orígenes de entrada. Para obtener más información acerca de los AWS Resilience Hub APIs que se utilizan para preparar una solicitud, consulte los temas siguientes:
+ [Creación de una aplicación de](#create-app-using-api)
+ [Creación de una política de resiliencia](#create-res-policy-using-api)
+ [Importación de recursos desde un origen de entrada y supervisión del estado de la importación](#import-app-resource-using-api)
+ [Publicar la versión preliminar de su aplicación y asignar una política de resiliencia](#publish-application-using-api)
## Creación de una aplicación de
Para crear una nueva aplicación AWS Resilience Hub, debe llamar a la `CreateApp` API y proporcionar un nombre de aplicación único. Para obtener más información acerca esta API, consulte [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateApp.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateApp.html).
El siguiente ejemplo muestra cómo crear una nueva aplicación `newApp` en AWS Resilience Hub mediante una API `CreateApp`.
### Solicitud
```
aws resiliencehub create-app --name newApp
```
### Respuesta
```
{
"app": {
"appArn": "",
"name": "newApp",
"creationTime": "2022-10-26T19:48:00.434000+03:00",
"status": "Active",
"complianceStatus": "NotAssessed",
"resiliencyScore": 0.0,
"tags": {},
"assessmentSchedule": "Disabled"
}
}
```
## Creación de una política de resiliencia
Tras crear la aplicación, debe crear una política de resiliencia que le permita comprender la postura de resiliencia de la aplicación mediante una API `CreateResiliencyPolicy`. Para obtener más información acerca esta API, consulte [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateResiliencyPolicy.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateResiliencyPolicy.html).
El siguiente ejemplo muestra cómo crear `newPolicy` para su aplicación AWS Resilience Hub mediante la `CreateResiliencyPolicy` API.
### Solicitud
```
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}}'
```
### Respuesta
```
{
"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": {}
}
}
```
## Importación de recursos desde un origen de entrada y supervisión del estado de la importación
AWS Resilience Hub proporciona lo siguiente APIs para importar recursos a la aplicación:
+ `ImportResourcesToDraftAppVersion`: esta API le permite importar recursos a la versión preliminar de su aplicación desde diferentes orígenes de entrada. Para obtener más información acerca esta API, consulte [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`— Esta API publica una nueva versión de la aplicación junto con la versión actualizada AppComponents. Para obtener más información acerca esta API, consulte [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`: esta API le permite supervisar el estado de importación de sus recursos a una versión de la aplicación. Para obtener más información acerca esta API, consulte [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeDraftAppVersionResourcesImportStatus.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeDraftAppVersionResourcesImportStatus.html).
En el siguiente ejemplo, se muestra cómo importar recursos a su aplicación en AWS Resilience Hub mediante una API `ImportResourcesToDraftAppVersion`.
### Solicitud
```
aws resiliencehub import-resources-to-draft-app-version \
--app-arn \
--terraform-sources '[{"s3StateFileUrl": }]'
```
### Respuesta
```
{
"appArn": "",
"appVersion": "draft",
"sourceArns": [],
"status": "Pending",
"terraformSources": [
{
"s3StateFileUrl":
}
]
}
```
En el siguiente ejemplo, se muestra cómo añadir recursos manualmente a su aplicación en AWS Resilience Hub mediante una API `CreateAppVersionResource`.
### Solicitud
```
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"]'
```
### Respuesta
```
{
"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"
}
]
}
}
```
En el siguiente ejemplo, se muestra cómo supervisar el estado de la importación de sus recursos en AWS Resilience Hub mediante una API `DescribeDraftAppVersionResourcesImportStatus`.
### Solicitud
```
aws resiliencehub describe-draft-app-version-resources-import-status \
--app-arn
```
### Respuesta
```
{
"appArn": "",
"appVersion": "draft",
"status": "Success",
"statusChangeTime": "2022-10-26T19:55:18.471000+03:00"
}
```
## Publicar la versión preliminar de su aplicación y asignar una política de resiliencia
Antes de realizar una evaluación, primero debe publicar la versión preliminar de la aplicación y asignar una política de resiliencia a la versión publicada de la aplicación.
**Para publicar la versión preliminar de su aplicación y asignar una política de resiliencia**
1. Para publicar la versión preliminar de su aplicación, utilice la API `PublishAppVersion`. Para obtener más información acerca esta API, consulte [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_PublishAppVersion.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_PublishAppVersion.html).
El siguiente ejemplo muestra cómo publicar la versión preliminar de la aplicación AWS Resilience Hub mediante la `PublishAppVersion` API.
**Solicitud**
```
aws resiliencehub publish-app-version \
--app-arn
```
**Respuesta**
```
{
"appArn": "",
"appVersion": "release"
}
```
1. Aplique una política de resiliencia a la versión publicada de su aplicación mediante una API `UpdateApp`. Para obtener más información acerca esta API, consulte [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateApp.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateApp.html).
El siguiente ejemplo muestra cómo aplicar una política de resiliencia a la versión publicada de una aplicación AWS Resilience Hub mediante la `UpdateApp` API.
**Solicitud**
```
aws resiliencehub update-app \
--app-arn \
--policy-arn
```
**Respuesta**
```
{
"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"
}
}
```
# Ejecutar y gestionar las evaluaciones de AWS Resilience Hub resiliencia
Después de publicar una nueva versión de la aplicación, debe realizar una nueva evaluación de la resiliencia y analizar los resultados para asegurarse de que la aplicación cumple con el RTO de carga de trabajo y el RPO estimados que se definen en su política de resiliencia. La evaluación compara la configuración de cada componente de la aplicación con la política y formula recomendaciones de alarma, SOP y pruebas.
Para obtener más información, consulte los temas siguientes:
+ [Ejecutar y monitorear las AWS Resilience Hub evaluaciones de resiliencia](#run-assess-analyze-using-api)
+ [Examen de los resultados de la evaluación](#run-assessment-using-api)
## Ejecutar y monitorear las AWS Resilience Hub evaluaciones de resiliencia
Para realizar evaluaciones de resiliencia AWS Resilience Hub y monitorear su estado, debe usar lo siguiente: APIs
+ `StartAppAssessment`: esta API crea una nueva evaluación para una aplicación. Para obtener más información acerca esta API, consulte [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`: esta API describe una evaluación de la aplicación y proporciona el estado de finalización de la evaluación. Para obtener más información acerca esta API, consulte [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeAppAssessment.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DescribeAppAssessment.html).
En el siguiente ejemplo, se muestra cómo comenzar a ejecutar una nueva evaluación en AWS Resilience Hub mediante API `StartAppAssessment`.
### Solicitud
```
aws resiliencehub start-app-assessment \
--app-arn \
--app-version release \
--assessment-name first-assessment
```
### Respuesta
```
{
"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": {}
}
}
```
En el siguiente ejemplo, se muestra cómo supervisar el estado de la evaluación en AWS Resilience Hub mediante API `DescribeAppAssessment`. Puede extraer el estado de la evaluación a partir de la variable `assessmentStatus`.
### Solicitud
```
aws resiliencehub describe-app-assessment \
--assessment-arn
```
### Respuesta
```
{
"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": {}
}
}
```
## Examen de los resultados de la evaluación
Una vez que la evaluación se haya completado correctamente, puede examinar los resultados de la evaluación utilizando lo siguiente APIs.
+ `DescribeAppAssessment`: esta API le permite hacer un seguimiento del estado actual de su aplicación en relación con la política de resiliencia. Además, también puede extraer el estado de conformidad de la variable `complianceStatus` y la puntuación de resiliencia de cada tipo de interrupción a partir de la estructura `resiliencyScore`. Para obtener más información acerca esta API, consulte [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`: esta API le permite obtener las recomendaciones de alarma utilizando el nombre de recurso de Amazon (ARN) de la evaluación. Para obtener más información acerca esta API, consulte [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_ListAlarmRecommendations.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_ListAlarmRecommendations.html).
**nota**
Para obtener las recomendaciones de las pruebas SOP y FIS, utilice `ListSopRecommendations` y. `ListTestRecommendations` APIs
En el siguiente ejemplo, se muestra cómo obtener las recomendaciones de alarma utilizando el nombre de recurso de Amazon (ARN) de la evaluación mediante API `ListAlarmRecommendations`.
**nota**
Para obtener las recomendaciones de las pruebas SOP y FIS, sustitúyalas por `ListSopRecommendations` o `ListTestRecommendations`.
### Solicitud
```
aws resiliencehub list-alarm-recommendations \
--assessment-arn
```
### Respuesta
```
{
"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)."
}
]
}
```
El siguiente ejemplo muestra cómo obtener las recomendaciones de configuración (recomendaciones sobre cómo mejorar su resiliencia actual) mediante la API `ListAppComponentRecommendations`.
### Solicitud
```
aws resiliencehub list-app-component-recommendations \
--assessment-arn
```
### Respuesta
```
{
"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"
}
]
}
]
}
```
# Modificación de la aplicación
AWS Resilience Hub le permite modificar los recursos de la aplicación editando una versión preliminar de la aplicación y publicando los cambios en una versión nueva (publicada). AWS Resilience Hub utiliza la versión publicada de la aplicación, que incluye los recursos actualizados, para realizar las evaluaciones de resiliencia.
Para obtener más información, consulte los temas siguientes:
+ [Agregar recursos manualmente a la aplicación](#manually-add-resource-using-api)
+ [Agrupar los recursos en un único componente de aplicación](#group-resource-using-api)
+ [Excluir un recurso de un AppComponent](#exclude-resource-using-api)
## Agregar recursos manualmente a la aplicación
Si el recurso no se implementa como parte de una fuente de entrada, te AWS Resilience Hub permite añadir el recurso manualmente a tu aplicación mediante la `CreateAppVersionResource` API. Para obtener más información acerca esta API, consulte [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateAppVersionResource.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_CreateAppVersionResource.html).
Debe proporcionar los siguientes parámetros a esta API:
+ Nombre de recurso de Amazon (ARN) de la aplicación
+ ID lógico del recurso
+ ID física del recurso
+ AWS CloudFormation escriba
En el siguiente ejemplo, se muestra cómo añadir recursos manualmente a su aplicación en AWS Resilience Hub mediante una API `CreateAppVersionResource`.
### Solicitud
```
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"]'
```
### Respuesta
```
{
"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"
}
]
}
}
```
## Agrupar los recursos en un único componente de aplicación
Un componente de aplicación (AppComponent) es un grupo de AWS recursos relacionados que funcionan y fallan como una sola unidad. Por ejemplo, cuando tiene cargas de trabajo entre regiones que se utilizan como implementaciones en espera. AWS Resilience Hub tiene reglas que rigen qué AWS recursos pueden pertenecer a qué tipo de. AppComponent AWS Resilience Hub permite agrupar los recursos en uno solo AppComponent mediante la siguiente administración de recursos APIs.
+ `UpdateAppVersionResource`: esta API actualiza los detalles de los recursos de una aplicación. Para obtener más información acerca esta API, consulte [UpdateAppVersionResource](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateAppVersionResource.html).
+ `DeleteAppVersionAppComponent`— Esta API los elimina AppComponent de la aplicación. Para obtener más información acerca esta API, consulte [DeleteAppVersionAppComponent](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_DeleteAppVersionAppComponent.html).
El siguiente ejemplo muestra cómo actualizar los detalles de los recursos de su aplicación AWS Resilience Hub mediante la `DeleteAppVersionAppComponent` API.
### Solicitud
```
aws resiliencehub delete-app-version-app-component \
--app-arn \
--id new-app-component
```
### Respuesta
```
{
"appArn": "",
"appVersion": "draft",
"appComponent": {
"name": "new-app-component",
"type": "AWS::ResilienceHub::StorageAppComponent",
"id": "new-app-component"
}
}
```
El siguiente ejemplo muestra cómo eliminar el espacio vacío AppComponent que se creó en los ejemplos anteriores al AWS Resilience Hub usar la `UpdateAppVersionResource` API.
### Solicitud
```
aws resiliencehub delete-app-version-app-component \
--app-arn \
--id new-app-component
```
### Respuesta
```
{
"appArn": "",
"appVersion": "draft",
"appComponent": {
"name": "new-app-component",
"type": "AWS::ResilienceHub::StorageAppComponent",
"id": "new-app-component"
}
}
```
## Excluir un recurso de un AppComponent
AWS Resilience Hub permite excluir los recursos de las evaluaciones mediante la `UpdateAppVersionResource` API. Estos recursos no se tendrán en cuenta al calcular la resiliencia de la aplicación. Para obtener más información acerca esta API, consulte [https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateAppVersionResource.html](https://docs.aws.amazon.com/resilience-hub/latest/APIReference/API_UpdateAppVersionResource.html).
**nota**
Solo puede excluir los recursos que se importaron de un origen de entrada.
El siguiente ejemplo muestra cómo excluir un recurso de su aplicación en AWS Resilience Hub mediante la API `UpdateAppVersionResource`.
### Solicitud
```
aws resiliencehub update-app-version-resource \
--app-arn \
--resource-name "ec2instance-nvz" \
--excluded
```
### Respuesta
```
{
"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"
}
]
}
}
```