

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Preparar o aplicativo
<a name="prepare-app-using-api"></a>

Para preparar um aplicativo, você deve primeiro criar um aplicativo, atribuir uma política de resiliência e, em seguida, importar os recursos do aplicativo de suas fontes de entrada. Para obter mais informações sobre os AWS Resilience Hub APIs que são usados para preparar um aplicativo, consulte os tópicos a seguir:
+ [Como criar uma aplicação do](#create-app-using-api)
+ [Criar política de resiliência](#create-res-policy-using-api)
+ [Importar recursos de uma fonte de entrada e monitorar o status da importação](#import-app-resource-using-api)
+ [Publicar a versão preliminar do seu aplicativo e atribuir uma política de resiliência](#publish-application-using-api)

## Como criar uma aplicação do
<a name="create-app-using-api"></a>

Para criar um novo aplicativo em AWS Resilience Hub, você deve chamar a `CreateApp` API e fornecer um nome de aplicativo exclusivo. Para obter mais informações sobre essa 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).

O exemplo a seguir mostra como criar um novo aplicativo do `newApp` no AWS Resilience Hub usando a API do `CreateApp`. 

### Solicitação
<a name="create-app-using-api-req"></a>

```
aws resiliencehub create-app --name newApp
```

### Resposta
<a name="create-app-using-api-res"></a>

```
{
    "app": {
        "appArn": "<App_ARN>",
        "name": "newApp",
        "creationTime": "2022-10-26T19:48:00.434000+03:00",
        "status": "Active",
        "complianceStatus": "NotAssessed",
        "resiliencyScore": 0.0,
        "tags": {},
        "assessmentSchedule": "Disabled"
    }
}
```

## Criar política de resiliência
<a name="create-res-policy-using-api"></a>

Depois de criar o aplicativo, você deve criar uma política de resiliência que permita entender a postura de resiliência do seu aplicativo usando a API do `CreateResiliencyPolicy`. Para obter mais informações sobre essa 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).

O exemplo a seguir mostra como criar `newPolicy` para seu aplicativo AWS Resilience Hub usando a `CreateResiliencyPolicy` API.

### Solicitação
<a name="create-res-policy-using-api-req"></a>

```
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}}'
```

### Resposta
<a name="create-res-policy-using-api-res"></a>

```
{
    "policy": {
        "policyArn": "<Policy_ARN>",
        "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": {}
    }
}
```

## Importar recursos de uma fonte de entrada e monitorar o status da importação
<a name="import-app-resource-using-api"></a>

AWS Resilience Hub fornece o seguinte APIs para importar recursos para seu aplicativo:
+ `ImportResourcesToDraftAppVersion`: essa API permite importar recursos para a versão preliminar do seu aplicativo a partir de diferentes fontes de entrada. Para obter mais informações sobre essa 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`— Essa API publica uma nova versão do aplicativo junto com a atualização AppComponents. Para obter mais informações sobre essa 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`: essa API permite monitorar o status de importação de seus recursos para uma versão do aplicativo. Para obter mais informações sobre essa 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).

O exemplo a seguir mostra como importar recursos para seu aplicativo no AWS Resilience Hub usando a API do `ImportResourcesToDraftAppVersion`.

### Solicitação
<a name="w2aac12b9c11b9"></a>

```
aws resiliencehub import-resources-to-draft-app-version \
--app-arn <App_ARN> \
--terraform-sources '[{"s3StateFileUrl": <S3_URI>}]'
```

### Resposta
<a name="w2aac12b9c11c13"></a>

```
{
    "appArn": "<App_ARN>",
    "appVersion": "draft",
    "sourceArns": [],
    "status": "Pending",
    "terraformSources": [
        {
            "s3StateFileUrl": <S3_URI>
        }
    ]
}
```

O exemplo a seguir mostra como adicionar recursos manualmente ao seu aplicativo do AWS Resilience Hub usando a API `CreateAppVersionResource`.

### Solicitação
<a name="create-res-policy-using-api-req"></a>

```
aws resiliencehub create-app-version-resource \
--app-arn <App_ARN> \
--resource-name "backup-efs" \
--logical-resource-id '{"identifier": "backup-efs"}' \
--physical-resource-id '<Physical_resource_id_ARN>' \
--resource-type AWS::EFS::FileSystem \
--app-components '["new-app-component"]'
```

### Resposta
<a name="create-res-policy-using-api-res"></a>

```
{
    "appArn": "<App_ARN>",
    "appVersion": "draft",
    "physicalResource": {
        "resourceName": "backup-efs",
        "logicalResourceId": {
            "identifier": "backup-efs"
        },
        "physicalResourceId": {
            "identifier": "<Physical_resource_id_ARN>",
            "type": "Arn"
        },
        "resourceType": "AWS::EFS::FileSystem",
        "appComponents": [
            {
                "name": "new-app-component",
                "type": "AWS::ResilienceHub::StorageAppComponent",
                "id": "new-app-component"
            }
        ]
    }
}
```

O exemplo a seguir mostra como monitorar o status de importação de seus recursos do AWS Resilience Hub usando a API `DescribeDraftAppVersionResourcesImportStatus`.

### Solicitação
<a name="describe-draft-app-policy-req"></a>

```
aws resiliencehub describe-draft-app-version-resources-import-status \
--app-arn <App_ARN>
```

### Resposta
<a name="describe-draft-app-policy-res"></a>

```
{
    "appArn": "<App_ARN>",
    "appVersion": "draft",
    "status": "Success",
    "statusChangeTime": "2022-10-26T19:55:18.471000+03:00"
}
```

## Publicar a versão preliminar do seu aplicativo e atribuir uma política de resiliência
<a name="publish-application-using-api"></a>

Antes de executar uma avaliação, você deve primeiro publicar a versão preliminar do seu aplicativo e atribuir uma política de resiliência à versão lançada do seu aplicativo. 

**Publicar a versão preliminar do seu aplicativo e atribuir uma política de resiliência**

1. Publicar a versão preliminar do seu aplicativo, usar a API `PublishAppVersion`. Para obter mais informações sobre essa 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).

   O exemplo a seguir mostra como publicar a versão de rascunho do aplicativo AWS Resilience Hub usando a `PublishAppVersion` API.

   

**Solicitação**  


   ```
   aws resiliencehub publish-app-version \
    --app-arn <App_ARN>
   ```

**Resposta**  


   ```
   {
       "appArn": "<App_ARN>",
       "appVersion": "release"
   }
   ```

1. Aplique uma política de resiliência à versão lançada do seu aplicativo usando a API `UpdateApp`. Para obter mais informações sobre essa 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).

   O exemplo a seguir mostra como aplicar uma política de resiliência à versão lançada de um aplicativo AWS Resilience Hub usando a `UpdateApp` API.

**Solicitação**  


   ```
   aws resiliencehub update-app \
   --app-arn <App_ARN> \
   --policy-arn <Policy_ARN>
   ```

**Resposta**  


   ```
   {
       "app": {
           "appArn": "<App_ARN>",
           "name": "newApp",
           "policyArn": "<Policy_ARN>",
           "creationTime": "2022-10-26T19:48:00.434000+03:00",
           "status": "Active",
           "complianceStatus": "NotAssessed",
           "resiliencyScore": 0.0,
           "tags": {
               "resourceArn": "<App_ARN>"
           },
           "assessmentSchedule": "Disabled"
       }
   }
   ```