# Actions
<a name="API_Operations"></a>

The following actions are supported:
+  [AcceptResourceGroupingRecommendations](API_AcceptResourceGroupingRecommendations.md) 
+  [AddDraftAppVersionResourceMappings](API_AddDraftAppVersionResourceMappings.md) 
+  [BatchUpdateRecommendationStatus](API_BatchUpdateRecommendationStatus.md) 
+  [CreateApp](API_CreateApp.md) 
+  [CreateAppVersionAppComponent](API_CreateAppVersionAppComponent.md) 
+  [CreateAppVersionResource](API_CreateAppVersionResource.md) 
+  [CreateRecommendationTemplate](API_CreateRecommendationTemplate.md) 
+  [CreateResiliencyPolicy](API_CreateResiliencyPolicy.md) 
+  [DeleteApp](API_DeleteApp.md) 
+  [DeleteAppAssessment](API_DeleteAppAssessment.md) 
+  [DeleteAppInputSource](API_DeleteAppInputSource.md) 
+  [DeleteAppVersionAppComponent](API_DeleteAppVersionAppComponent.md) 
+  [DeleteAppVersionResource](API_DeleteAppVersionResource.md) 
+  [DeleteRecommendationTemplate](API_DeleteRecommendationTemplate.md) 
+  [DeleteResiliencyPolicy](API_DeleteResiliencyPolicy.md) 
+  [DescribeApp](API_DescribeApp.md) 
+  [DescribeAppAssessment](API_DescribeAppAssessment.md) 
+  [DescribeAppVersion](API_DescribeAppVersion.md) 
+  [DescribeAppVersionAppComponent](API_DescribeAppVersionAppComponent.md) 
+  [DescribeAppVersionResource](API_DescribeAppVersionResource.md) 
+  [DescribeAppVersionResourcesResolutionStatus](API_DescribeAppVersionResourcesResolutionStatus.md) 
+  [DescribeAppVersionTemplate](API_DescribeAppVersionTemplate.md) 
+  [DescribeDraftAppVersionResourcesImportStatus](API_DescribeDraftAppVersionResourcesImportStatus.md) 
+  [DescribeMetricsExport](API_DescribeMetricsExport.md) 
+  [DescribeResiliencyPolicy](API_DescribeResiliencyPolicy.md) 
+  [DescribeResourceGroupingRecommendationTask](API_DescribeResourceGroupingRecommendationTask.md) 
+  [ImportResourcesToDraftAppVersion](API_ImportResourcesToDraftAppVersion.md) 
+  [ListAlarmRecommendations](API_ListAlarmRecommendations.md) 
+  [ListAppAssessmentComplianceDrifts](API_ListAppAssessmentComplianceDrifts.md) 
+  [ListAppAssessmentResourceDrifts](API_ListAppAssessmentResourceDrifts.md) 
+  [ListAppAssessments](API_ListAppAssessments.md) 
+  [ListAppComponentCompliances](API_ListAppComponentCompliances.md) 
+  [ListAppComponentRecommendations](API_ListAppComponentRecommendations.md) 
+  [ListAppInputSources](API_ListAppInputSources.md) 
+  [ListApps](API_ListApps.md) 
+  [ListAppVersionAppComponents](API_ListAppVersionAppComponents.md) 
+  [ListAppVersionResourceMappings](API_ListAppVersionResourceMappings.md) 
+  [ListAppVersionResources](API_ListAppVersionResources.md) 
+  [ListAppVersions](API_ListAppVersions.md) 
+  [ListMetrics](API_ListMetrics.md) 
+  [ListRecommendationTemplates](API_ListRecommendationTemplates.md) 
+  [ListResiliencyPolicies](API_ListResiliencyPolicies.md) 
+  [ListResourceGroupingRecommendations](API_ListResourceGroupingRecommendations.md) 
+  [ListSopRecommendations](API_ListSopRecommendations.md) 
+  [ListSuggestedResiliencyPolicies](API_ListSuggestedResiliencyPolicies.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [ListTestRecommendations](API_ListTestRecommendations.md) 
+  [ListUnsupportedAppVersionResources](API_ListUnsupportedAppVersionResources.md) 
+  [PublishAppVersion](API_PublishAppVersion.md) 
+  [PutDraftAppVersionTemplate](API_PutDraftAppVersionTemplate.md) 
+  [RejectResourceGroupingRecommendations](API_RejectResourceGroupingRecommendations.md) 
+  [RemoveDraftAppVersionResourceMappings](API_RemoveDraftAppVersionResourceMappings.md) 
+  [ResolveAppVersionResources](API_ResolveAppVersionResources.md) 
+  [StartAppAssessment](API_StartAppAssessment.md) 
+  [StartMetricsExport](API_StartMetricsExport.md) 
+  [StartResourceGroupingRecommendationTask](API_StartResourceGroupingRecommendationTask.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateApp](API_UpdateApp.md) 
+  [UpdateAppVersion](API_UpdateAppVersion.md) 
+  [UpdateAppVersionAppComponent](API_UpdateAppVersionAppComponent.md) 
+  [UpdateAppVersionResource](API_UpdateAppVersionResource.md) 
+  [UpdateResiliencyPolicy](API_UpdateResiliencyPolicy.md) 

# AcceptResourceGroupingRecommendations
<a name="API_AcceptResourceGroupingRecommendations"></a>

Accepts the resource grouping recommendations suggested by AWS Resilience Hub for your application.

## Request Syntax
<a name="API_AcceptResourceGroupingRecommendations_RequestSyntax"></a>

```
POST /accept-resource-grouping-recommendations HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "entries": [ 
      { 
         "groupingRecommendationId": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_AcceptResourceGroupingRecommendations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_AcceptResourceGroupingRecommendations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_AcceptResourceGroupingRecommendations_RequestSyntax) **   <a name="resiliencehub-AcceptResourceGroupingRecommendations-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [entries](#API_AcceptResourceGroupingRecommendations_RequestSyntax) **   <a name="resiliencehub-AcceptResourceGroupingRecommendations-request-entries"></a>
List of resource grouping recommendations you want to include in your application.  
Type: Array of [AcceptGroupingRecommendationEntry](API_AcceptGroupingRecommendationEntry.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 30 items.  
Required: Yes

## Response Syntax
<a name="API_AcceptResourceGroupingRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "failedEntries": [ 
      { 
         "errorMessage": "string",
         "groupingRecommendationId": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AcceptResourceGroupingRecommendations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_AcceptResourceGroupingRecommendations_ResponseSyntax) **   <a name="resiliencehub-AcceptResourceGroupingRecommendations-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [failedEntries](#API_AcceptResourceGroupingRecommendations_ResponseSyntax) **   <a name="resiliencehub-AcceptResourceGroupingRecommendations-response-failedEntries"></a>
List of resource grouping recommendations that could not be included in your application.  
Type: Array of [FailedGroupingRecommendationEntry](API_FailedGroupingRecommendationEntry.md) objects

## Errors
<a name="API_AcceptResourceGroupingRecommendations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_AcceptResourceGroupingRecommendations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/AcceptResourceGroupingRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/AcceptResourceGroupingRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/AcceptResourceGroupingRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/AcceptResourceGroupingRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/AcceptResourceGroupingRecommendations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/AcceptResourceGroupingRecommendations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/AcceptResourceGroupingRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/AcceptResourceGroupingRecommendations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/AcceptResourceGroupingRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/AcceptResourceGroupingRecommendations) 

# AddDraftAppVersionResourceMappings
<a name="API_AddDraftAppVersionResourceMappings"></a>

Adds the source of resource-maps to the draft version of an application. During assessment, AWS Resilience Hub will use these resource-maps to resolve the latest physical ID for each resource in the application template. For more information about different types of resources supported by AWS Resilience Hub and how to add them in your application, see [Step 2: How is your application managed?](https://docs.aws.amazon.com/resilience-hub/latest/userguide/how-app-manage.html) in the AWS Resilience Hub User Guide.

## Request Syntax
<a name="API_AddDraftAppVersionResourceMappings_RequestSyntax"></a>

```
POST /add-draft-app-version-resource-mappings HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "resourceMappings": [ 
      { 
         "appRegistryAppName": "string",
         "eksSourceName": "string",
         "logicalStackName": "string",
         "mappingType": "string",
         "physicalResourceId": { 
            "awsAccountId": "string",
            "awsRegion": "string",
            "identifier": "string",
            "type": "string"
         },
         "resourceGroupName": "string",
         "resourceName": "string",
         "terraformSourceName": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_AddDraftAppVersionResourceMappings_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_AddDraftAppVersionResourceMappings_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_AddDraftAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-AddDraftAppVersionResourceMappings-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [resourceMappings](#API_AddDraftAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-AddDraftAppVersionResourceMappings-request-resourceMappings"></a>
Mappings used to map logical resources from the template to physical resources. You can use the mapping type `CFN_STACK` if the application template uses a logical stack name. Or you can map individual resources by using the mapping type `RESOURCE`. We recommend using the mapping type `CFN_STACK` if the application is backed by a CloudFormation stack.  
Type: Array of [ResourceMapping](API_ResourceMapping.md) objects  
Required: Yes

## Response Syntax
<a name="API_AddDraftAppVersionResourceMappings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "resourceMappings": [ 
      { 
         "appRegistryAppName": "string",
         "eksSourceName": "string",
         "logicalStackName": "string",
         "mappingType": "string",
         "physicalResourceId": { 
            "awsAccountId": "string",
            "awsRegion": "string",
            "identifier": "string",
            "type": "string"
         },
         "resourceGroupName": "string",
         "resourceName": "string",
         "terraformSourceName": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AddDraftAppVersionResourceMappings_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_AddDraftAppVersionResourceMappings_ResponseSyntax) **   <a name="resiliencehub-AddDraftAppVersionResourceMappings-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_AddDraftAppVersionResourceMappings_ResponseSyntax) **   <a name="resiliencehub-AddDraftAppVersionResourceMappings-response-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}` 

 ** [resourceMappings](#API_AddDraftAppVersionResourceMappings_ResponseSyntax) **   <a name="resiliencehub-AddDraftAppVersionResourceMappings-response-resourceMappings"></a>
List of sources that are used to map a logical resource from the template to a physical resource. You can use sources such as AWS CloudFormation, Terraform state files, AppRegistry applications, or Amazon EKS.  
Type: Array of [ResourceMapping](API_ResourceMapping.md) objects

## Errors
<a name="API_AddDraftAppVersionResourceMappings_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ServiceQuotaExceededException **   
This exception occurs when you have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.  
HTTP Status Code: 402

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## Examples
<a name="API_AddDraftAppVersionResourceMappings_Examples"></a>

### Example CloudFormation Request
<a name="API_AddDraftAppVersionResourceMappings_Example_1"></a>

The following is an example request payload.

#### Sample Request
<a name="API_AddDraftAppVersionResourceMappings_Example_1_Request"></a>

```
{
  "appArn": "arn:aws:resiliencehub:us-west-2:444455556666:app/dd058443-7e2f-410d-bee6-c634cb3edb39",
  "resourceMappings": [
    {
      "logicalStackName": "my-stack-name",
      "mappingType": "CfnStack",
      "physicalResourceId": {
        "identifier": "arn:aws:cloudformation:us-west-2:444455556666:stack/my-stack-name/fe0e1e00-03eb-11ee-8796-02038f8a9691",
        "type": "Arn"
      }
    }
  ]
}
```

### Sample CloudFormation Response
<a name="API_AddDraftAppVersionResourceMappings_Example_2"></a>

The following is an example response payload.

#### Sample Response
<a name="API_AddDraftAppVersionResourceMappings_Example_2_Response"></a>

```
{
  "appArn": "arn:aws:resiliencehub:us-west-2:444455556666:app/dd058443-7e2f-410d-bee6-c634cb3edb39",
  "appVersion": "draft",
  "resourceMappings": [
    {
      "logicalStackName": "my-stack-name",
      "mappingType": "CfnStack",
      "physicalResourceId": {
        "identifier": "arn:aws:cloudformation:us-west-2:444455556666:stack/my-stack-name/fe0e1e00-03eb-11ee-8796-02038f8a9691",
        "type": "Arn"
      }
    }
  ]
}
```

### Example Terraform Request
<a name="API_AddDraftAppVersionResourceMappings_Example_3"></a>

The following is an example request payload.

#### Sample Request
<a name="API_AddDraftAppVersionResourceMappings_Example_3_Request"></a>

```
{
"appArn": " arn:aws:resiliencehub:us-west-2:444455556666:app/4019253a-0c99-4d30-be32-b14dd46d1c3d",
   "resourceMappings": [ 
      {
"mappingType": "Terraform",
         "physicalResourceId": {
            "awsAccountId": "444455556666",
            "awsRegion": "us-west-2",
            "identifier": "s3://my-terraform-bucket/my/path/application-state-file.tfstate",
            "type": "Native"
         }, 
          
      }
   ]
}
```

### Sample Terraform Response
<a name="API_AddDraftAppVersionResourceMappings_Example_4"></a>

The following is an example response payload.

#### Sample Response
<a name="API_AddDraftAppVersionResourceMappings_Example_4_Response"></a>

```
{
  "appArn": "arn:aws:resiliencehub:us-west-2:444455556666:app/4019253a-0c99-4d30-be32-b14dd46d1c3d",
  "resourceMappings": [
    {
      "terraformSourceName": "application-state-file.tfstate",
      "mappingType": "Terraform",
      "physicalResourceId": {
        "identifier": "s3://terraform-bucket/web-app/latest/application-state-file.tfstate",
        "type": "Native",
        "awsRegion": "us-west-2",
        "awsAccountId": "444455556666"
      }
    }
  ]
}
```

### Sample AppRegistry Request
<a name="API_AddDraftAppVersionResourceMappings_Example_5"></a>

The following is an example request payload.

#### Sample Request
<a name="API_AddDraftAppVersionResourceMappings_Example_5_Request"></a>

```
{
"appArn": "arn:aws:resiliencehub:us-west-2:444455556666:app/4019253a-0c99-4d30-be32-b14dd46d1c3d",
"resourceMappings": [ 
      {
         "appRegistryAppName": "MyWebApp",
         "mappingType": "AppRegistryApp",
         "physicalResourceId": {
            "identifier": "arn:aws:servicecatalog:us-west-2:444455556666:/applications/123456789012abcdefghijklmnop",
            "type": "ARN"
         },
      }
   ]
}
```

### Sample AppRegistry Response
<a name="API_AddDraftAppVersionResourceMappings_Example_6"></a>

The following is an example response payload.

#### Sample Response
<a name="API_AddDraftAppVersionResourceMappings_Example_6_Response"></a>

```
{
  "appArn": "aws:resiliencehub:us-west-2:444455556666:app/4019253a-0c99-4d30-be32-b14dd46d1c3d",
  "resourceMappings": [
    {
      "appRegistryAppName": "MyWebApp",
      "mappingType": "AppRegistryApp",
      "physicalResourceId": {
        "identifier": "arn:aws:servicecatalog:us-west-2:444455556666:/applications/123456789012abcdefghijklmnop",
        "type": "Arn"
      }
    }
  ]
}
```

### Sample Amazon EKS Request
<a name="API_AddDraftAppVersionResourceMappings_Example_7"></a>

The following is an example request payload.

#### Sample Request
<a name="API_AddDraftAppVersionResourceMappings_Example_7_Request"></a>

```
{
"appArn": "arn:aws:resiliencehub:us-west-2:444455556666:app/98f97a67-228f-40b3-8b2b-29da919c68cc",
   "resourceMappings": [ 
      {
         "eksSourceName": "my-cluster/my-namespace",
         "mappingType": "EKS",
         "physicalResourceId": {
            "identifier": "arn:aws:eks:us-west-2:444455556666:cluster/my-cluster/my-namespace",
            "type": "Arn"
         },
      }
   ]
}
```

### Sample Amazon EKS Response
<a name="API_AddDraftAppVersionResourceMappings_Example_8"></a>

The following is an example response payload.

#### Sample Response
<a name="API_AddDraftAppVersionResourceMappings_Example_8_Response"></a>

```
{
"appArn": "arn:aws:resiliencehub:us-west-2:444455556666:app/98f97a67-228f-40b3-8b2b-29da919c68cc",
   "resourceMappings": [ 
      {
"eksSourceName": "my-cluster/my-namespace",
         "mappingType": "EKS",
         "physicalResourceId": {
"identifier": "arn:aws:eks:us-west-2:444455556666:cluster/my-cluster/my-namespace",
            "type": "Arn"
         },
      }
   ]
}
```

## See Also
<a name="API_AddDraftAppVersionResourceMappings_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/AddDraftAppVersionResourceMappings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/AddDraftAppVersionResourceMappings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/AddDraftAppVersionResourceMappings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/AddDraftAppVersionResourceMappings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/AddDraftAppVersionResourceMappings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/AddDraftAppVersionResourceMappings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/AddDraftAppVersionResourceMappings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/AddDraftAppVersionResourceMappings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/AddDraftAppVersionResourceMappings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/AddDraftAppVersionResourceMappings) 

# BatchUpdateRecommendationStatus
<a name="API_BatchUpdateRecommendationStatus"></a>

Enables you to include or exclude one or more operational recommendations.

## Request Syntax
<a name="API_BatchUpdateRecommendationStatus_RequestSyntax"></a>

```
POST /batch-update-recommendation-status HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "requestEntries": [ 
      { 
         "appComponentId": "string",
         "entryId": "string",
         "excluded": boolean,
         "excludeReason": "string",
         "item": { 
            "resourceId": "string",
            "targetAccountId": "string",
            "targetRegion": "string"
         },
         "referenceId": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_BatchUpdateRecommendationStatus_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_BatchUpdateRecommendationStatus_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_BatchUpdateRecommendationStatus_RequestSyntax) **   <a name="resiliencehub-BatchUpdateRecommendationStatus-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [requestEntries](#API_BatchUpdateRecommendationStatus_RequestSyntax) **   <a name="resiliencehub-BatchUpdateRecommendationStatus-request-requestEntries"></a>
Defines the list of operational recommendations that need to be included or excluded.  
Type: Array of [UpdateRecommendationStatusRequestEntry](API_UpdateRecommendationStatusRequestEntry.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 50 items.  
Required: Yes

## Response Syntax
<a name="API_BatchUpdateRecommendationStatus_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "failedEntries": [ 
      { 
         "entryId": "string",
         "errorMessage": "string"
      }
   ],
   "successfulEntries": [ 
      { 
         "appComponentId": "string",
         "entryId": "string",
         "excluded": boolean,
         "excludeReason": "string",
         "item": { 
            "resourceId": "string",
            "targetAccountId": "string",
            "targetRegion": "string"
         },
         "referenceId": "string"
      }
   ]
}
```

## Response Elements
<a name="API_BatchUpdateRecommendationStatus_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_BatchUpdateRecommendationStatus_ResponseSyntax) **   <a name="resiliencehub-BatchUpdateRecommendationStatus-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [failedEntries](#API_BatchUpdateRecommendationStatus_ResponseSyntax) **   <a name="resiliencehub-BatchUpdateRecommendationStatus-response-failedEntries"></a>
A list of items with error details about each item, which could not be included or excluded.  
Type: Array of [BatchUpdateRecommendationStatusFailedEntry](API_BatchUpdateRecommendationStatusFailedEntry.md) objects

 ** [successfulEntries](#API_BatchUpdateRecommendationStatus_ResponseSyntax) **   <a name="resiliencehub-BatchUpdateRecommendationStatus-response-successfulEntries"></a>
A list of items that were included or excluded.  
Type: Array of [BatchUpdateRecommendationStatusSuccessfulEntry](API_BatchUpdateRecommendationStatusSuccessfulEntry.md) objects

## Errors
<a name="API_BatchUpdateRecommendationStatus_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## Examples
<a name="API_BatchUpdateRecommendationStatus_Examples"></a>

### Sample request
<a name="API_BatchUpdateRecommendationStatus_Example_1"></a>

This example illustrates one usage of BatchUpdateRecommendationStatus.

```
{
  "appArn": "APP_ARN",
  "requestEntries": [
    {
      "entryId": "entry_num_1",
      "referenceId": "s3:alarm:health_4xx_errors_count:2020-04-01",
      "item": {
        "resourceId": "a-resource-id",
        "targetAccountId": "123456789012",
        "targetRegion": "us-west-2"
      },
      "excluded": true,
      "excludeReason": "AlreadyImplemented"
    },
    {
      "entryId": "entry_num_2",
      "referenceId": "s3:alarm:health_total_request_latency:2020-04-01",
      "item": {
        "resourceId": "a-resource-id",
        "targetAccountId": "123456789012",
        "targetRegion": "us-west-2"
      },
      "excluded": true
    }
  ]
}
```

### Sample response
<a name="API_BatchUpdateRecommendationStatus_Example_2"></a>

This example illustrates one usage of BatchUpdateRecommendationStatus.

```
{
  "appArn": "APP_ARN",
  "successfulEntries": [
    {
      "entryId": "entry_num_2",
      "referenceId": "s3:alarm:health_total_request_latency:2020-04-01",
      "item": {
        "resourceId": "a-resource-id",
        "targetAccountId": "123456789012",
        "targetRegion": "us-west-2"
      },
      "excluded": true
    },
    {
      "entryId": "entry_num_1",
      "referenceId": "s3:alarm:health_4xx_errors_count:2020-04-01",
      "item": {
        "resourceId": "a-resource-id",
        "targetAccountId": "123456789012",
        "targetRegion": "us-west-2"
      },
      "excluded": true,
      "excludeReason": "AlreadyImplemented"
    }
  ],
  "failedEntries": []
}
```

## See Also
<a name="API_BatchUpdateRecommendationStatus_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/BatchUpdateRecommendationStatus) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/BatchUpdateRecommendationStatus) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/BatchUpdateRecommendationStatus) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/BatchUpdateRecommendationStatus) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/BatchUpdateRecommendationStatus) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/BatchUpdateRecommendationStatus) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/BatchUpdateRecommendationStatus) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/BatchUpdateRecommendationStatus) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/BatchUpdateRecommendationStatus) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/BatchUpdateRecommendationStatus) 

# CreateApp
<a name="API_CreateApp"></a>

Creates an AWS Resilience Hub application. An AWS Resilience Hub application is a collection of AWS resources structured to prevent and recover AWS application disruptions. To describe a AWS Resilience Hub application, you provide an application name, resources from one or more AWS CloudFormation stacks, AWS Resource Groups, Terraform state files, AppRegistry applications, and an appropriate resiliency policy. In addition, you can also add resources that are located on Amazon Elastic Kubernetes Service (Amazon EKS) clusters as optional resources. For more information about the number of resources supported per application, see [Service quotas](https://docs.aws.amazon.com/general/latest/gr/resiliencehub.html#limits_resiliencehub).

After you create an AWS Resilience Hub application, you publish it so that you can run a resiliency assessment on it. You can then use recommendations from the assessment to improve resiliency by running another assessment, comparing results, and then iterating the process until you achieve your goals for recovery time objective (RTO) and recovery point objective (RPO).

## Request Syntax
<a name="API_CreateApp_RequestSyntax"></a>

```
POST /create-app HTTP/1.1
Content-type: application/json

{
   "assessmentSchedule": "string",
   "awsApplicationArn": "string",
   "clientToken": "string",
   "description": "string",
   "eventSubscriptions": [ 
      { 
         "eventType": "string",
         "name": "string",
         "snsTopicArn": "string"
      }
   ],
   "name": "string",
   "permissionModel": { 
      "crossAccountRoleArns": [ "string" ],
      "invokerRoleName": "string",
      "type": "string"
   },
   "policyArn": "string",
   "tags": { 
      "string" : "string" 
   }
}
```

## URI Request Parameters
<a name="API_CreateApp_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateApp_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentSchedule](#API_CreateApp_RequestSyntax) **   <a name="resiliencehub-CreateApp-request-assessmentSchedule"></a>
 Assessment execution schedule with 'Daily' or 'Disabled' values.   
Type: String  
Valid Values: `Disabled | Daily`   
Required: No

 ** [awsApplicationArn](#API_CreateApp_RequestSyntax) **   <a name="resiliencehub-CreateApp-request-awsApplicationArn"></a>
Amazon Resource Name (ARN) of AWS Resource Groups group that is integrated with an AppRegistry application. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: No

 ** [clientToken](#API_CreateApp_RequestSyntax) **   <a name="resiliencehub-CreateApp-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [description](#API_CreateApp_RequestSyntax) **   <a name="resiliencehub-CreateApp-request-description"></a>
The optional description for an app.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 500.  
Required: No

 ** [eventSubscriptions](#API_CreateApp_RequestSyntax) **   <a name="resiliencehub-CreateApp-request-eventSubscriptions"></a>
The list of events you would like to subscribe and get notification for. Currently, AWS Resilience Hub supports only **Drift detected** and **Scheduled assessment failure** events notification.  
Type: Array of [EventSubscription](API_EventSubscription.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.  
Required: No

 ** [name](#API_CreateApp_RequestSyntax) **   <a name="resiliencehub-CreateApp-request-name"></a>
Name of the application.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: Yes

 ** [permissionModel](#API_CreateApp_RequestSyntax) **   <a name="resiliencehub-CreateApp-request-permissionModel"></a>
Defines the roles and credentials that AWS Resilience Hub would use while creating the application, importing its resources, and running an assessment.  
Type: [PermissionModel](API_PermissionModel.md) object  
Required: No

 ** [policyArn](#API_CreateApp_RequestSyntax) **   <a name="resiliencehub-CreateApp-request-policyArn"></a>
Amazon Resource Name (ARN) of the resiliency policy. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:resiliency-policy/`policy-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: No

 ** [tags](#API_CreateApp_RequestSyntax) **   <a name="resiliencehub-CreateApp-request-tags"></a>
Tags assigned to the resource. A tag is a label that you assign to an AWS resource. Each tag consists of a key/value pair.  
Type: String to string map  
Map Entries: Maximum number of 50 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[^\x00-\x1f\x22]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[^\x00-\x1f\x22]*`   
Required: No

## Response Syntax
<a name="API_CreateApp_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "app": { 
      "appArn": "string",
      "assessmentSchedule": "string",
      "awsApplicationArn": "string",
      "complianceStatus": "string",
      "creationTime": number,
      "description": "string",
      "driftStatus": "string",
      "eventSubscriptions": [ 
         { 
            "eventType": "string",
            "name": "string",
            "snsTopicArn": "string"
         }
      ],
      "lastAppComplianceEvaluationTime": number,
      "lastDriftEvaluationTime": number,
      "lastResiliencyScoreEvaluationTime": number,
      "name": "string",
      "permissionModel": { 
         "crossAccountRoleArns": [ "string" ],
         "invokerRoleName": "string",
         "type": "string"
      },
      "policyArn": "string",
      "resiliencyScore": number,
      "rpoInSecs": number,
      "rtoInSecs": number,
      "status": "string",
      "tags": { 
         "string" : "string" 
      }
   }
}
```

## Response Elements
<a name="API_CreateApp_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [app](#API_CreateApp_ResponseSyntax) **   <a name="resiliencehub-CreateApp-response-app"></a>
The created application returned as an object with details including compliance status, creation time, description, resiliency score, and more.  
Type: [App](API_App.md) object

## Errors
<a name="API_CreateApp_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ServiceQuotaExceededException **   
This exception occurs when you have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.  
HTTP Status Code: 402

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_CreateApp_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/CreateApp) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/CreateApp) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/CreateApp) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/CreateApp) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/CreateApp) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/CreateApp) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/CreateApp) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/CreateApp) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/CreateApp) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/CreateApp) 

# CreateAppVersionAppComponent
<a name="API_CreateAppVersionAppComponent"></a>

Creates a new AppComponent in the AWS Resilience Hub application.

**Note**  
This API updates the AWS Resilience Hub application draft version. To use this AppComponent for running assessments, you must publish the AWS Resilience Hub application using the `PublishAppVersion` API.

## Request Syntax
<a name="API_CreateAppVersionAppComponent_RequestSyntax"></a>

```
POST /create-app-version-app-component HTTP/1.1
Content-type: application/json

{
   "additionalInfo": { 
      "string" : [ "string" ]
   },
   "appArn": "string",
   "clientToken": "string",
   "id": "string",
   "name": "string",
   "type": "string"
}
```

## URI Request Parameters
<a name="API_CreateAppVersionAppComponent_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateAppVersionAppComponent_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [additionalInfo](#API_CreateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionAppComponent-request-additionalInfo"></a>
Currently, there is no supported additional information for AppComponents.  
Type: String to array of strings map  
Key Pattern: `\S{1,128}`   
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** [appArn](#API_CreateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionAppComponent-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [clientToken](#API_CreateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionAppComponent-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [id](#API_CreateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionAppComponent-request-id"></a>
Identifier of the AppComponent.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** [name](#API_CreateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionAppComponent-request-name"></a>
Name of the AppComponent.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

 ** [type](#API_CreateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionAppComponent-request-type"></a>
Type of AppComponent. For more information about the types of AppComponent, see [Grouping resources in an AppComponent](https://docs.aws.amazon.com/resilience-hub/latest/userguide/AppComponent.grouping.html).  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_CreateAppVersionAppComponent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appComponent": { 
      "additionalInfo": { 
         "string" : [ "string" ]
      },
      "id": "string",
      "name": "string",
      "type": "string"
   },
   "appVersion": "string"
}
```

## Response Elements
<a name="API_CreateAppVersionAppComponent_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_CreateAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-CreateAppVersionAppComponent-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appComponent](#API_CreateAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-CreateAppVersionAppComponent-response-appComponent"></a>
List of AppComponents that belong to this resource.  
Type: [AppComponent](API_AppComponent.md) object

 ** [appVersion](#API_CreateAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-CreateAppVersionAppComponent-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

## Errors
<a name="API_CreateAppVersionAppComponent_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ServiceQuotaExceededException **   
This exception occurs when you have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.  
HTTP Status Code: 402

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_CreateAppVersionAppComponent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/CreateAppVersionAppComponent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/CreateAppVersionAppComponent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/CreateAppVersionAppComponent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/CreateAppVersionAppComponent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/CreateAppVersionAppComponent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/CreateAppVersionAppComponent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/CreateAppVersionAppComponent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/CreateAppVersionAppComponent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/CreateAppVersionAppComponent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/CreateAppVersionAppComponent) 

# CreateAppVersionResource
<a name="API_CreateAppVersionResource"></a>

Adds a resource to the AWS Resilience Hub application and assigns it to the specified AppComponents. If you specify a new AppComponent, AWS Resilience Hub will automatically create the AppComponent.

**Note**  
This action has no effect outside AWS Resilience Hub.
This API updates the AWS Resilience Hub application draft version. To use this resource for running resiliency assessments, you must publish the AWS Resilience Hub application using the `PublishAppVersion` API.
To update application version with new `physicalResourceID`, you must call `ResolveAppVersionResources` API.
 AWS Resilience Hub blocks manual grouping and automatically groups certain resources based on their dependencies and configurations to prevent configuration errors and ensure accurate resilience assessment results. For more information, see [Managing Application Components](https://docs.aws.amazon.com/resilience-hub/latest/userguide/AppComponent.html).

## Request Syntax
<a name="API_CreateAppVersionResource_RequestSyntax"></a>

```
POST /create-app-version-resource HTTP/1.1
Content-type: application/json

{
   "additionalInfo": { 
      "string" : [ "string" ]
   },
   "appArn": "string",
   "appComponents": [ "string" ],
   "awsAccountId": "string",
   "awsRegion": "string",
   "clientToken": "string",
   "logicalResourceId": { 
      "eksSourceName": "string",
      "identifier": "string",
      "logicalStackName": "string",
      "resourceGroupName": "string",
      "terraformSourceName": "string"
   },
   "physicalResourceId": "string",
   "resourceName": "string",
   "resourceType": "string"
}
```

## URI Request Parameters
<a name="API_CreateAppVersionResource_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateAppVersionResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [additionalInfo](#API_CreateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionResource-request-additionalInfo"></a>
Currently, there is no supported additional information for resources.  
Type: String to array of strings map  
Key Pattern: `\S{1,128}`   
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** [appArn](#API_CreateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionResource-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appComponents](#API_CreateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionResource-request-appComponents"></a>
List of AppComponents that this resource belongs to. If an AppComponent is not part of the AWS Resilience Hub application, it will be added.  
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

 ** [awsAccountId](#API_CreateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionResource-request-awsAccountId"></a>
 AWS account that owns the physical resource.  
Type: String  
Pattern: `[0-9]{12}`   
Required: No

 ** [awsRegion](#API_CreateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionResource-request-awsRegion"></a>
 AWS region that owns the physical resource.  
Type: String  
Pattern: `[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]`   
Required: No

 ** [clientToken](#API_CreateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionResource-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [logicalResourceId](#API_CreateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionResource-request-logicalResourceId"></a>
Logical identifier of the resource.  
Type: [LogicalResourceId](API_LogicalResourceId.md) object  
Required: Yes

 ** [physicalResourceId](#API_CreateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionResource-request-physicalResourceId"></a>
Physical identifier of the resource.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 2048.  
Required: Yes

 ** [resourceName](#API_CreateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionResource-request-resourceName"></a>
Name of the resource.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: No

 ** [resourceType](#API_CreateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-CreateAppVersionResource-request-resourceType"></a>
Type of resource.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_CreateAppVersionResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "physicalResource": { 
      "additionalInfo": { 
         "string" : [ "string" ]
      },
      "appComponents": [ 
         { 
            "additionalInfo": { 
               "string" : [ "string" ]
            },
            "id": "string",
            "name": "string",
            "type": "string"
         }
      ],
      "excluded": boolean,
      "logicalResourceId": { 
         "eksSourceName": "string",
         "identifier": "string",
         "logicalStackName": "string",
         "resourceGroupName": "string",
         "terraformSourceName": "string"
      },
      "parentResourceName": "string",
      "physicalResourceId": { 
         "awsAccountId": "string",
         "awsRegion": "string",
         "identifier": "string",
         "type": "string"
      },
      "resourceName": "string",
      "resourceType": "string",
      "sourceType": "string"
   }
}
```

## Response Elements
<a name="API_CreateAppVersionResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_CreateAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-CreateAppVersionResource-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_CreateAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-CreateAppVersionResource-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

 ** [physicalResource](#API_CreateAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-CreateAppVersionResource-response-physicalResource"></a>
Defines a physical resource. A physical resource is a resource that exists in your account. It can be identified using an Amazon Resource Name (ARN) or a Resilience Hub-native identifier.  
Type: [PhysicalResource](API_PhysicalResource.md) object

## Errors
<a name="API_CreateAppVersionResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ServiceQuotaExceededException **   
This exception occurs when you have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.  
HTTP Status Code: 402

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_CreateAppVersionResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/CreateAppVersionResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/CreateAppVersionResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/CreateAppVersionResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/CreateAppVersionResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/CreateAppVersionResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/CreateAppVersionResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/CreateAppVersionResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/CreateAppVersionResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/CreateAppVersionResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/CreateAppVersionResource) 

# CreateRecommendationTemplate
<a name="API_CreateRecommendationTemplate"></a>

Creates a new recommendation template for the AWS Resilience Hub application.

## Request Syntax
<a name="API_CreateRecommendationTemplate_RequestSyntax"></a>

```
POST /create-recommendation-template HTTP/1.1
Content-type: application/json

{
   "assessmentArn": "string",
   "bucketName": "string",
   "clientToken": "string",
   "format": "string",
   "name": "string",
   "recommendationIds": [ "string" ],
   "recommendationTypes": [ "string" ],
   "tags": { 
      "string" : "string" 
   }
}
```

## URI Request Parameters
<a name="API_CreateRecommendationTemplate_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateRecommendationTemplate_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentArn](#API_CreateRecommendationTemplate_RequestSyntax) **   <a name="resiliencehub-CreateRecommendationTemplate-request-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [bucketName](#API_CreateRecommendationTemplate_RequestSyntax) **   <a name="resiliencehub-CreateRecommendationTemplate-request-bucketName"></a>
The name of the Amazon S3 bucket that will contain the recommendation template.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: No

 ** [clientToken](#API_CreateRecommendationTemplate_RequestSyntax) **   <a name="resiliencehub-CreateRecommendationTemplate-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [format](#API_CreateRecommendationTemplate_RequestSyntax) **   <a name="resiliencehub-CreateRecommendationTemplate-request-format"></a>
The format for the recommendation template.    
CfnJson  
The template is CloudFormation JSON.  
CfnYaml  
The template is CloudFormation YAML.
Type: String  
Valid Values: `CfnYaml | CfnJson`   
Required: No

 ** [name](#API_CreateRecommendationTemplate_RequestSyntax) **   <a name="resiliencehub-CreateRecommendationTemplate-request-name"></a>
The name for the recommendation template.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: Yes

 ** [recommendationIds](#API_CreateRecommendationTemplate_RequestSyntax) **   <a name="resiliencehub-CreateRecommendationTemplate-request-recommendationIds"></a>
Identifiers for the recommendations used to create a recommendation template.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 200 items.  
Pattern: `[0-9a-f]{8}-[0-9a-f]{4}-[0-5][0-9a-f]{3}-[089ab][0-9a-f]{3}-[0-9a-f]{12}`   
Required: No

 ** [recommendationTypes](#API_CreateRecommendationTemplate_RequestSyntax) **   <a name="resiliencehub-CreateRecommendationTemplate-request-recommendationTypes"></a>
An array of strings that specify the recommendation template type or types.    
Alarm  
The template is an [AlarmRecommendation](API_AlarmRecommendation.md) template.  
Sop  
The template is a [SopRecommendation](API_SopRecommendation.md) template.  
Test  
The template is a [TestRecommendation](API_TestRecommendation.md) template.
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 4 items.  
Valid Values: `Alarm | Sop | Test`   
Required: No

 ** [tags](#API_CreateRecommendationTemplate_RequestSyntax) **   <a name="resiliencehub-CreateRecommendationTemplate-request-tags"></a>
Tags assigned to the resource. A tag is a label that you assign to an AWS resource. Each tag consists of a key/value pair.  
Type: String to string map  
Map Entries: Maximum number of 50 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[^\x00-\x1f\x22]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[^\x00-\x1f\x22]*`   
Required: No

## Response Syntax
<a name="API_CreateRecommendationTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "recommendationTemplate": { 
      "appArn": "string",
      "assessmentArn": "string",
      "endTime": number,
      "format": "string",
      "message": "string",
      "name": "string",
      "needsReplacements": boolean,
      "recommendationIds": [ "string" ],
      "recommendationTemplateArn": "string",
      "recommendationTypes": [ "string" ],
      "startTime": number,
      "status": "string",
      "tags": { 
         "string" : "string" 
      },
      "templatesLocation": { 
         "bucket": "string",
         "prefix": "string"
      }
   }
}
```

## Response Elements
<a name="API_CreateRecommendationTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [recommendationTemplate](#API_CreateRecommendationTemplate_ResponseSyntax) **   <a name="resiliencehub-CreateRecommendationTemplate-response-recommendationTemplate"></a>
The newly created recommendation template, returned as an object. This object includes the template's name, format, status, tags, Amazon S3 bucket location, and more.  
Type: [RecommendationTemplate](API_RecommendationTemplate.md) object

## Errors
<a name="API_CreateRecommendationTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ServiceQuotaExceededException **   
This exception occurs when you have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.  
HTTP Status Code: 402

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_CreateRecommendationTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/CreateRecommendationTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/CreateRecommendationTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/CreateRecommendationTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/CreateRecommendationTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/CreateRecommendationTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/CreateRecommendationTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/CreateRecommendationTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/CreateRecommendationTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/CreateRecommendationTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/CreateRecommendationTemplate) 

# CreateResiliencyPolicy
<a name="API_CreateResiliencyPolicy"></a>

Creates a resiliency policy for an application.

**Note**  
 AWS Resilience Hub allows you to provide a value of zero for `rtoInSecs` and `rpoInSecs` of your resiliency policy. But, while assessing your application, the lowest possible assessment result is near zero. Hence, if you provide value zero for `rtoInSecs` and `rpoInSecs`, the estimated workload RTO and estimated workload RPO result will be near zero and the **Compliance status** for your application will be set to **Policy breached**.

## Request Syntax
<a name="API_CreateResiliencyPolicy_RequestSyntax"></a>

```
POST /create-resiliency-policy HTTP/1.1
Content-type: application/json

{
   "clientToken": "string",
   "dataLocationConstraint": "string",
   "policy": { 
      "string" : { 
         "rpoInSecs": number,
         "rtoInSecs": number
      }
   },
   "policyDescription": "string",
   "policyName": "string",
   "tags": { 
      "string" : "string" 
   },
   "tier": "string"
}
```

## URI Request Parameters
<a name="API_CreateResiliencyPolicy_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_CreateResiliencyPolicy_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [clientToken](#API_CreateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-CreateResiliencyPolicy-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [dataLocationConstraint](#API_CreateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-CreateResiliencyPolicy-request-dataLocationConstraint"></a>
Specifies a high-level geographical location constraint for where your resilience policy data can be stored.  
Type: String  
Valid Values: `AnyLocation | SameContinent | SameCountry`   
Required: No

 ** [policy](#API_CreateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-CreateResiliencyPolicy-request-policy"></a>
The type of resiliency policy to be created, including the recovery time objective (RTO) and recovery point objective (RPO) in seconds.  
Type: String to [FailurePolicy](API_FailurePolicy.md) object map  
Valid Keys: `Software | Hardware | AZ | Region`   
Required: Yes

 ** [policyDescription](#API_CreateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-CreateResiliencyPolicy-request-policyDescription"></a>
Description of the resiliency policy.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 500.  
Required: No

 ** [policyName](#API_CreateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-CreateResiliencyPolicy-request-policyName"></a>
Name of the resiliency policy.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: Yes

 ** [tags](#API_CreateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-CreateResiliencyPolicy-request-tags"></a>
Tags assigned to the resource. A tag is a label that you assign to an AWS resource. Each tag consists of a key/value pair.  
Type: String to string map  
Map Entries: Maximum number of 50 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[^\x00-\x1f\x22]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[^\x00-\x1f\x22]*`   
Required: No

 ** [tier](#API_CreateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-CreateResiliencyPolicy-request-tier"></a>
The tier for this resiliency policy, ranging from the highest severity (`MissionCritical`) to lowest (`NonCritical`).  
Type: String  
Valid Values: `MissionCritical | Critical | Important | CoreServices | NonCritical | NotApplicable`   
Required: Yes

## Response Syntax
<a name="API_CreateResiliencyPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "policy": { 
      "creationTime": number,
      "dataLocationConstraint": "string",
      "estimatedCostTier": "string",
      "policy": { 
         "string" : { 
            "rpoInSecs": number,
            "rtoInSecs": number
         }
      },
      "policyArn": "string",
      "policyDescription": "string",
      "policyName": "string",
      "tags": { 
         "string" : "string" 
      },
      "tier": "string"
   }
}
```

## Response Elements
<a name="API_CreateResiliencyPolicy_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [policy](#API_CreateResiliencyPolicy_ResponseSyntax) **   <a name="resiliencehub-CreateResiliencyPolicy-response-policy"></a>
The type of resiliency policy that was created, including the recovery time objective (RTO) and recovery point objective (RPO) in seconds.  
Type: [ResiliencyPolicy](API_ResiliencyPolicy.md) object

## Errors
<a name="API_CreateResiliencyPolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ServiceQuotaExceededException **   
This exception occurs when you have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.  
HTTP Status Code: 402

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## Examples
<a name="API_CreateResiliencyPolicy_Examples"></a>

### Sample ResilienceHub ResiliencyPolicy
<a name="API_CreateResiliencyPolicy_Example_1"></a>

This example illustrates one usage of CreateResiliencyPolicy.

```
AWSTemplateFormatVersion: 2010-09-09
Resources:
  ResiliencyPolicyCFNCanaryStack:
    Type: AWS::ResilienceHub::ResiliencyPolicy
    Properties:
      PolicyName: "ResiliencyPolicyCFNCanaryExample"
      PolicyDescription: 'ResilienceHub TestResiliencyPolicy for CFN'
      Tier: 'MissionCritical'
      Tags:
        TagKey: ""
      Policy:
        Software:
          RtoInSecs: 10
          RpoInSecs: 10
        Hardware:
          RtoInSecs: 10
          RpoInSecs: 10
        AZ:
          RtoInSecs: 10
          RpoInSecs: 10
        Region:
          RtoInSecs: 10
          RpoInSecs: 10
```

## See Also
<a name="API_CreateResiliencyPolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/CreateResiliencyPolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/CreateResiliencyPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/CreateResiliencyPolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/CreateResiliencyPolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/CreateResiliencyPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/CreateResiliencyPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/CreateResiliencyPolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/CreateResiliencyPolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/CreateResiliencyPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/CreateResiliencyPolicy) 

# DeleteApp
<a name="API_DeleteApp"></a>

Deletes an AWS Resilience Hub application. This is a destructive action that can't be undone.

## Request Syntax
<a name="API_DeleteApp_RequestSyntax"></a>

```
POST /delete-app HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "clientToken": "string",
   "forceDelete": boolean
}
```

## URI Request Parameters
<a name="API_DeleteApp_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteApp_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DeleteApp_RequestSyntax) **   <a name="resiliencehub-DeleteApp-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [clientToken](#API_DeleteApp_RequestSyntax) **   <a name="resiliencehub-DeleteApp-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [forceDelete](#API_DeleteApp_RequestSyntax) **   <a name="resiliencehub-DeleteApp-request-forceDelete"></a>
A boolean option to force the deletion of an AWS Resilience Hub application.   
Type: Boolean  
Required: No

## Response Syntax
<a name="API_DeleteApp_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string"
}
```

## Response Elements
<a name="API_DeleteApp_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_DeleteApp_ResponseSyntax) **   <a name="resiliencehub-DeleteApp-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

## Errors
<a name="API_DeleteApp_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DeleteApp_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DeleteApp) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DeleteApp) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DeleteApp) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DeleteApp) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DeleteApp) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DeleteApp) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DeleteApp) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DeleteApp) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DeleteApp) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DeleteApp) 

# DeleteAppAssessment
<a name="API_DeleteAppAssessment"></a>

Deletes an AWS Resilience Hub application assessment. This is a destructive action that can't be undone.

## Request Syntax
<a name="API_DeleteAppAssessment_RequestSyntax"></a>

```
POST /delete-app-assessment HTTP/1.1
Content-type: application/json

{
   "assessmentArn": "string",
   "clientToken": "string"
}
```

## URI Request Parameters
<a name="API_DeleteAppAssessment_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteAppAssessment_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentArn](#API_DeleteAppAssessment_RequestSyntax) **   <a name="resiliencehub-DeleteAppAssessment-request-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [clientToken](#API_DeleteAppAssessment_RequestSyntax) **   <a name="resiliencehub-DeleteAppAssessment-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

## Response Syntax
<a name="API_DeleteAppAssessment_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "assessmentArn": "string",
   "assessmentStatus": "string"
}
```

## Response Elements
<a name="API_DeleteAppAssessment_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentArn](#API_DeleteAppAssessment_ResponseSyntax) **   <a name="resiliencehub-DeleteAppAssessment-response-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [assessmentStatus](#API_DeleteAppAssessment_ResponseSyntax) **   <a name="resiliencehub-DeleteAppAssessment-response-assessmentStatus"></a>
The current status of the assessment for the resiliency policy.  
Type: String  
Valid Values: `Pending | InProgress | Failed | Success` 

## Errors
<a name="API_DeleteAppAssessment_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DeleteAppAssessment_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DeleteAppAssessment) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DeleteAppAssessment) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DeleteAppAssessment) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DeleteAppAssessment) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DeleteAppAssessment) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DeleteAppAssessment) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DeleteAppAssessment) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DeleteAppAssessment) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DeleteAppAssessment) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DeleteAppAssessment) 

# DeleteAppInputSource
<a name="API_DeleteAppInputSource"></a>

Deletes the input source and all of its imported resources from the AWS Resilience Hub application.

## Request Syntax
<a name="API_DeleteAppInputSource_RequestSyntax"></a>

```
POST /delete-app-input-source HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "clientToken": "string",
   "eksSourceClusterNamespace": { 
      "eksClusterArn": "string",
      "namespace": "string"
   },
   "sourceArn": "string",
   "terraformSource": { 
      "s3StateFileUrl": "string"
   }
}
```

## URI Request Parameters
<a name="API_DeleteAppInputSource_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteAppInputSource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DeleteAppInputSource_RequestSyntax) **   <a name="resiliencehub-DeleteAppInputSource-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [clientToken](#API_DeleteAppInputSource_RequestSyntax) **   <a name="resiliencehub-DeleteAppInputSource-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [eksSourceClusterNamespace](#API_DeleteAppInputSource_RequestSyntax) **   <a name="resiliencehub-DeleteAppInputSource-request-eksSourceClusterNamespace"></a>
The namespace on your Amazon Elastic Kubernetes Service cluster that you want to delete from the AWS Resilience Hub application.  
Type: [EksSourceClusterNamespace](API_EksSourceClusterNamespace.md) object  
Required: No

 ** [sourceArn](#API_DeleteAppInputSource_RequestSyntax) **   <a name="resiliencehub-DeleteAppInputSource-request-sourceArn"></a>
The Amazon Resource Name (ARN) of the imported resource you want to remove from the AWS Resilience Hub application. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: No

 ** [terraformSource](#API_DeleteAppInputSource_RequestSyntax) **   <a name="resiliencehub-DeleteAppInputSource-request-terraformSource"></a>
The imported Terraform s3 state file you want to remove from the AWS Resilience Hub application.  
Type: [TerraformSource](API_TerraformSource.md) object  
Required: No

## Response Syntax
<a name="API_DeleteAppInputSource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appInputSource": { 
      "eksSourceClusterNamespace": { 
         "eksClusterArn": "string",
         "namespace": "string"
      },
      "importType": "string",
      "resourceCount": number,
      "sourceArn": "string",
      "sourceName": "string",
      "terraformSource": { 
         "s3StateFileUrl": "string"
      }
   }
}
```

## Response Elements
<a name="API_DeleteAppInputSource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_DeleteAppInputSource_ResponseSyntax) **   <a name="resiliencehub-DeleteAppInputSource-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appInputSource](#API_DeleteAppInputSource_ResponseSyntax) **   <a name="resiliencehub-DeleteAppInputSource-response-appInputSource"></a>
Name of the input source from where the application resource is imported from.  
Type: [AppInputSource](API_AppInputSource.md) object

## Errors
<a name="API_DeleteAppInputSource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DeleteAppInputSource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DeleteAppInputSource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DeleteAppInputSource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DeleteAppInputSource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DeleteAppInputSource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DeleteAppInputSource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DeleteAppInputSource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DeleteAppInputSource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DeleteAppInputSource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DeleteAppInputSource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DeleteAppInputSource) 

# DeleteAppVersionAppComponent
<a name="API_DeleteAppVersionAppComponent"></a>

Deletes an AppComponent from the AWS Resilience Hub application.

**Note**  
This API updates the AWS Resilience Hub application draft version. To use this AppComponent for running assessments, you must publish the AWS Resilience Hub application using the `PublishAppVersion` API.
You will not be able to delete an AppComponent if it has resources associated with it.

## Request Syntax
<a name="API_DeleteAppVersionAppComponent_RequestSyntax"></a>

```
POST /delete-app-version-app-component HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "clientToken": "string",
   "id": "string"
}
```

## URI Request Parameters
<a name="API_DeleteAppVersionAppComponent_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteAppVersionAppComponent_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DeleteAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-DeleteAppVersionAppComponent-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [clientToken](#API_DeleteAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-DeleteAppVersionAppComponent-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [id](#API_DeleteAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-DeleteAppVersionAppComponent-request-id"></a>
Identifier of the AppComponent.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_DeleteAppVersionAppComponent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appComponent": { 
      "additionalInfo": { 
         "string" : [ "string" ]
      },
      "id": "string",
      "name": "string",
      "type": "string"
   },
   "appVersion": "string"
}
```

## Response Elements
<a name="API_DeleteAppVersionAppComponent_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_DeleteAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-DeleteAppVersionAppComponent-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appComponent](#API_DeleteAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-DeleteAppVersionAppComponent-response-appComponent"></a>
List of AppComponents that belong to this resource.  
Type: [AppComponent](API_AppComponent.md) object

 ** [appVersion](#API_DeleteAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-DeleteAppVersionAppComponent-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

## Errors
<a name="API_DeleteAppVersionAppComponent_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DeleteAppVersionAppComponent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DeleteAppVersionAppComponent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DeleteAppVersionAppComponent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DeleteAppVersionAppComponent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DeleteAppVersionAppComponent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DeleteAppVersionAppComponent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DeleteAppVersionAppComponent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DeleteAppVersionAppComponent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DeleteAppVersionAppComponent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DeleteAppVersionAppComponent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DeleteAppVersionAppComponent) 

# DeleteAppVersionResource
<a name="API_DeleteAppVersionResource"></a>

Deletes a resource from the AWS Resilience Hub application.

**Note**  
You can only delete a manually added resource. To exclude non-manually added resources, use the `UpdateAppVersionResource` API.
This action has no effect outside AWS Resilience Hub.
This API updates the AWS Resilience Hub application draft version. To use this resource for running resiliency assessments, you must publish the AWS Resilience Hub application using the `PublishAppVersion` API.

## Request Syntax
<a name="API_DeleteAppVersionResource_RequestSyntax"></a>

```
POST /delete-app-version-resource HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "awsAccountId": "string",
   "awsRegion": "string",
   "clientToken": "string",
   "logicalResourceId": { 
      "eksSourceName": "string",
      "identifier": "string",
      "logicalStackName": "string",
      "resourceGroupName": "string",
      "terraformSourceName": "string"
   },
   "physicalResourceId": "string",
   "resourceName": "string"
}
```

## URI Request Parameters
<a name="API_DeleteAppVersionResource_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteAppVersionResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DeleteAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DeleteAppVersionResource-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [awsAccountId](#API_DeleteAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DeleteAppVersionResource-request-awsAccountId"></a>
 AWS account that owns the physical resource.  
Type: String  
Pattern: `[0-9]{12}`   
Required: No

 ** [awsRegion](#API_DeleteAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DeleteAppVersionResource-request-awsRegion"></a>
 AWS region that owns the physical resource.  
Type: String  
Pattern: `[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]`   
Required: No

 ** [clientToken](#API_DeleteAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DeleteAppVersionResource-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [logicalResourceId](#API_DeleteAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DeleteAppVersionResource-request-logicalResourceId"></a>
Logical identifier of the resource.  
Type: [LogicalResourceId](API_LogicalResourceId.md) object  
Required: No

 ** [physicalResourceId](#API_DeleteAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DeleteAppVersionResource-request-physicalResourceId"></a>
Physical identifier of the resource.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 2048.  
Required: No

 ** [resourceName](#API_DeleteAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DeleteAppVersionResource-request-resourceName"></a>
Name of the resource.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: No

## Response Syntax
<a name="API_DeleteAppVersionResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "physicalResource": { 
      "additionalInfo": { 
         "string" : [ "string" ]
      },
      "appComponents": [ 
         { 
            "additionalInfo": { 
               "string" : [ "string" ]
            },
            "id": "string",
            "name": "string",
            "type": "string"
         }
      ],
      "excluded": boolean,
      "logicalResourceId": { 
         "eksSourceName": "string",
         "identifier": "string",
         "logicalStackName": "string",
         "resourceGroupName": "string",
         "terraformSourceName": "string"
      },
      "parentResourceName": "string",
      "physicalResourceId": { 
         "awsAccountId": "string",
         "awsRegion": "string",
         "identifier": "string",
         "type": "string"
      },
      "resourceName": "string",
      "resourceType": "string",
      "sourceType": "string"
   }
}
```

## Response Elements
<a name="API_DeleteAppVersionResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_DeleteAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-DeleteAppVersionResource-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_DeleteAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-DeleteAppVersionResource-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

 ** [physicalResource](#API_DeleteAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-DeleteAppVersionResource-response-physicalResource"></a>
Defines a physical resource. A physical resource is a resource that exists in your account. It can be identified using an Amazon Resource Name (ARN) or a Resilience Hub-native identifier.  
Type: [PhysicalResource](API_PhysicalResource.md) object

## Errors
<a name="API_DeleteAppVersionResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DeleteAppVersionResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DeleteAppVersionResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DeleteAppVersionResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DeleteAppVersionResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DeleteAppVersionResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DeleteAppVersionResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DeleteAppVersionResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DeleteAppVersionResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DeleteAppVersionResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DeleteAppVersionResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DeleteAppVersionResource) 

# DeleteRecommendationTemplate
<a name="API_DeleteRecommendationTemplate"></a>

Deletes a recommendation template. This is a destructive action that can't be undone.

## Request Syntax
<a name="API_DeleteRecommendationTemplate_RequestSyntax"></a>

```
POST /delete-recommendation-template HTTP/1.1
Content-type: application/json

{
   "clientToken": "string",
   "recommendationTemplateArn": "string"
}
```

## URI Request Parameters
<a name="API_DeleteRecommendationTemplate_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteRecommendationTemplate_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [clientToken](#API_DeleteRecommendationTemplate_RequestSyntax) **   <a name="resiliencehub-DeleteRecommendationTemplate-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [recommendationTemplateArn](#API_DeleteRecommendationTemplate_RequestSyntax) **   <a name="resiliencehub-DeleteRecommendationTemplate-request-recommendationTemplateArn"></a>
The Amazon Resource Name (ARN) for a recommendation template.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_DeleteRecommendationTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "recommendationTemplateArn": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_DeleteRecommendationTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [recommendationTemplateArn](#API_DeleteRecommendationTemplate_ResponseSyntax) **   <a name="resiliencehub-DeleteRecommendationTemplate-response-recommendationTemplateArn"></a>
The Amazon Resource Name (ARN) for a recommendation template.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [status](#API_DeleteRecommendationTemplate_ResponseSyntax) **   <a name="resiliencehub-DeleteRecommendationTemplate-response-status"></a>
Status of the action.  
Type: String  
Valid Values: `Pending | InProgress | Failed | Success` 

## Errors
<a name="API_DeleteRecommendationTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DeleteRecommendationTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DeleteRecommendationTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DeleteRecommendationTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DeleteRecommendationTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DeleteRecommendationTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DeleteRecommendationTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DeleteRecommendationTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DeleteRecommendationTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DeleteRecommendationTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DeleteRecommendationTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DeleteRecommendationTemplate) 

# DeleteResiliencyPolicy
<a name="API_DeleteResiliencyPolicy"></a>

Deletes a resiliency policy. This is a destructive action that can't be undone.

## Request Syntax
<a name="API_DeleteResiliencyPolicy_RequestSyntax"></a>

```
POST /delete-resiliency-policy HTTP/1.1
Content-type: application/json

{
   "clientToken": "string",
   "policyArn": "string"
}
```

## URI Request Parameters
<a name="API_DeleteResiliencyPolicy_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DeleteResiliencyPolicy_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [clientToken](#API_DeleteResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-DeleteResiliencyPolicy-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [policyArn](#API_DeleteResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-DeleteResiliencyPolicy-request-policyArn"></a>
Amazon Resource Name (ARN) of the resiliency policy. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:resiliency-policy/`policy-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_DeleteResiliencyPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "policyArn": "string"
}
```

## Response Elements
<a name="API_DeleteResiliencyPolicy_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [policyArn](#API_DeleteResiliencyPolicy_ResponseSyntax) **   <a name="resiliencehub-DeleteResiliencyPolicy-response-policyArn"></a>
Amazon Resource Name (ARN) of the resiliency policy. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:resiliency-policy/`policy-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

## Errors
<a name="API_DeleteResiliencyPolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DeleteResiliencyPolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DeleteResiliencyPolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DeleteResiliencyPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DeleteResiliencyPolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DeleteResiliencyPolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DeleteResiliencyPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DeleteResiliencyPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DeleteResiliencyPolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DeleteResiliencyPolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DeleteResiliencyPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DeleteResiliencyPolicy) 

# DescribeApp
<a name="API_DescribeApp"></a>

Describes an AWS Resilience Hub application.

## Request Syntax
<a name="API_DescribeApp_RequestSyntax"></a>

```
POST /describe-app HTTP/1.1
Content-type: application/json

{
   "appArn": "string"
}
```

## URI Request Parameters
<a name="API_DescribeApp_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeApp_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DescribeApp_RequestSyntax) **   <a name="resiliencehub-DescribeApp-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_DescribeApp_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "app": { 
      "appArn": "string",
      "assessmentSchedule": "string",
      "awsApplicationArn": "string",
      "complianceStatus": "string",
      "creationTime": number,
      "description": "string",
      "driftStatus": "string",
      "eventSubscriptions": [ 
         { 
            "eventType": "string",
            "name": "string",
            "snsTopicArn": "string"
         }
      ],
      "lastAppComplianceEvaluationTime": number,
      "lastDriftEvaluationTime": number,
      "lastResiliencyScoreEvaluationTime": number,
      "name": "string",
      "permissionModel": { 
         "crossAccountRoleArns": [ "string" ],
         "invokerRoleName": "string",
         "type": "string"
      },
      "policyArn": "string",
      "resiliencyScore": number,
      "rpoInSecs": number,
      "rtoInSecs": number,
      "status": "string",
      "tags": { 
         "string" : "string" 
      }
   }
}
```

## Response Elements
<a name="API_DescribeApp_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [app](#API_DescribeApp_ResponseSyntax) **   <a name="resiliencehub-DescribeApp-response-app"></a>
The specified application, returned as an object with details including compliance status, creation time, description, resiliency score, and more.  
Type: [App](API_App.md) object

## Errors
<a name="API_DescribeApp_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeApp_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeApp) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeApp) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeApp) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeApp) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeApp) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeApp) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeApp) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeApp) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeApp) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeApp) 

# DescribeAppAssessment
<a name="API_DescribeAppAssessment"></a>

Describes an assessment for an AWS Resilience Hub application.

## Request Syntax
<a name="API_DescribeAppAssessment_RequestSyntax"></a>

```
POST /describe-app-assessment HTTP/1.1
Content-type: application/json

{
   "assessmentArn": "string"
}
```

## URI Request Parameters
<a name="API_DescribeAppAssessment_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeAppAssessment_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentArn](#API_DescribeAppAssessment_RequestSyntax) **   <a name="resiliencehub-DescribeAppAssessment-request-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_DescribeAppAssessment_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "assessment": { 
      "appArn": "string",
      "appVersion": "string",
      "assessmentArn": "string",
      "assessmentName": "string",
      "assessmentStatus": "string",
      "compliance": { 
         "string" : { 
            "achievableRpoInSecs": number,
            "achievableRtoInSecs": number,
            "complianceStatus": "string",
            "currentRpoInSecs": number,
            "currentRtoInSecs": number,
            "message": "string",
            "rpoDescription": "string",
            "rpoReferenceId": "string",
            "rtoDescription": "string",
            "rtoReferenceId": "string"
         }
      },
      "complianceStatus": "string",
      "cost": { 
         "amount": number,
         "currency": "string",
         "frequency": "string"
      },
      "driftStatus": "string",
      "endTime": number,
      "invoker": "string",
      "message": "string",
      "policy": { 
         "creationTime": number,
         "dataLocationConstraint": "string",
         "estimatedCostTier": "string",
         "policy": { 
            "string" : { 
               "rpoInSecs": number,
               "rtoInSecs": number
            }
         },
         "policyArn": "string",
         "policyDescription": "string",
         "policyName": "string",
         "tags": { 
            "string" : "string" 
         },
         "tier": "string"
      },
      "resiliencyScore": { 
         "componentScore": { 
            "string" : { 
               "excludedCount": number,
               "outstandingCount": number,
               "possibleScore": number,
               "score": number
            }
         },
         "disruptionScore": { 
            "string" : number 
         },
         "score": number
      },
      "resourceErrorsDetails": { 
         "hasMoreErrors": boolean,
         "resourceErrors": [ 
            { 
               "logicalResourceId": "string",
               "physicalResourceId": "string",
               "reason": "string"
            }
         ]
      },
      "startTime": number,
      "summary": { 
         "riskRecommendations": [ 
            { 
               "appComponents": [ "string" ],
               "recommendation": "string",
               "risk": "string"
            }
         ],
         "summary": "string"
      },
      "tags": { 
         "string" : "string" 
      },
      "versionName": "string"
   }
}
```

## Response Elements
<a name="API_DescribeAppAssessment_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessment](#API_DescribeAppAssessment_ResponseSyntax) **   <a name="resiliencehub-DescribeAppAssessment-response-assessment"></a>
The assessment for an AWS Resilience Hub application, returned as an object. This object includes Amazon Resource Names (ARNs), compliance information, compliance status, cost, messages, resiliency scores, and more.  
Type: [AppAssessment](API_AppAssessment.md) object

## Errors
<a name="API_DescribeAppAssessment_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeAppAssessment_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeAppAssessment) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeAppAssessment) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeAppAssessment) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeAppAssessment) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeAppAssessment) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeAppAssessment) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeAppAssessment) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeAppAssessment) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeAppAssessment) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeAppAssessment) 

# DescribeAppVersion
<a name="API_DescribeAppVersion"></a>

Describes the AWS Resilience Hub application version.

## Request Syntax
<a name="API_DescribeAppVersion_RequestSyntax"></a>

```
POST /describe-app-version HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string"
}
```

## URI Request Parameters
<a name="API_DescribeAppVersion_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeAppVersion_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DescribeAppVersion_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersion-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_DescribeAppVersion_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersion-request-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

## Response Syntax
<a name="API_DescribeAppVersion_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "additionalInfo": { 
      "string" : [ "string" ]
   },
   "appArn": "string",
   "appVersion": "string"
}
```

## Response Elements
<a name="API_DescribeAppVersion_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [additionalInfo](#API_DescribeAppVersion_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersion-response-additionalInfo"></a>
Additional configuration parameters for an AWS Resilience Hub application. If you want to implement `additionalInfo` through the AWS Resilience Hub console rather than using an API call, see [Configure the application configuration parameters](https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html).  
Currently, this parameter supports only failover region and account.
Type: String to array of strings map  
Key Pattern: `\S{1,128}`   
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 1024.

 ** [appArn](#API_DescribeAppVersion_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersion-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_DescribeAppVersion_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersion-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

## Errors
<a name="API_DescribeAppVersion_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeAppVersion_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeAppVersion) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeAppVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeAppVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeAppVersion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeAppVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeAppVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeAppVersion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeAppVersion) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeAppVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeAppVersion) 

# DescribeAppVersionAppComponent
<a name="API_DescribeAppVersionAppComponent"></a>

Describes an AppComponent in the AWS Resilience Hub application.

## Request Syntax
<a name="API_DescribeAppVersionAppComponent_RequestSyntax"></a>

```
POST /describe-app-version-app-component HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "id": "string"
}
```

## URI Request Parameters
<a name="API_DescribeAppVersionAppComponent_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeAppVersionAppComponent_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DescribeAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionAppComponent-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_DescribeAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionAppComponent-request-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

 ** [id](#API_DescribeAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionAppComponent-request-id"></a>
Identifier of the AppComponent.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_DescribeAppVersionAppComponent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appComponent": { 
      "additionalInfo": { 
         "string" : [ "string" ]
      },
      "id": "string",
      "name": "string",
      "type": "string"
   },
   "appVersion": "string"
}
```

## Response Elements
<a name="API_DescribeAppVersionAppComponent_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_DescribeAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionAppComponent-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appComponent](#API_DescribeAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionAppComponent-response-appComponent"></a>
List of AppComponents that belong to this resource.  
Type: [AppComponent](API_AppComponent.md) object

 ** [appVersion](#API_DescribeAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionAppComponent-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

## Errors
<a name="API_DescribeAppVersionAppComponent_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeAppVersionAppComponent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeAppVersionAppComponent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeAppVersionAppComponent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeAppVersionAppComponent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeAppVersionAppComponent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeAppVersionAppComponent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeAppVersionAppComponent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeAppVersionAppComponent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeAppVersionAppComponent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeAppVersionAppComponent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeAppVersionAppComponent) 

# DescribeAppVersionResource
<a name="API_DescribeAppVersionResource"></a>

Describes a resource of the AWS Resilience Hub application.

**Note**  
This API accepts only one of the following parameters to describe the resource:  
 `resourceName` 
 `logicalResourceId` 
 `physicalResourceId` (Along with `physicalResourceId`, you can also provide `awsAccountId`, and `awsRegion`)

## Request Syntax
<a name="API_DescribeAppVersionResource_RequestSyntax"></a>

```
POST /describe-app-version-resource HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "awsAccountId": "string",
   "awsRegion": "string",
   "logicalResourceId": { 
      "eksSourceName": "string",
      "identifier": "string",
      "logicalStackName": "string",
      "resourceGroupName": "string",
      "terraformSourceName": "string"
   },
   "physicalResourceId": "string",
   "resourceName": "string"
}
```

## URI Request Parameters
<a name="API_DescribeAppVersionResource_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeAppVersionResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DescribeAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionResource-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_DescribeAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionResource-request-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

 ** [awsAccountId](#API_DescribeAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionResource-request-awsAccountId"></a>
 AWS account that owns the physical resource.  
Type: String  
Pattern: `[0-9]{12}`   
Required: No

 ** [awsRegion](#API_DescribeAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionResource-request-awsRegion"></a>
 AWS region that owns the physical resource.  
Type: String  
Pattern: `[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]`   
Required: No

 ** [logicalResourceId](#API_DescribeAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionResource-request-logicalResourceId"></a>
Logical identifier of the resource.  
Type: [LogicalResourceId](API_LogicalResourceId.md) object  
Required: No

 ** [physicalResourceId](#API_DescribeAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionResource-request-physicalResourceId"></a>
Physical identifier of the resource.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 2048.  
Required: No

 ** [resourceName](#API_DescribeAppVersionResource_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionResource-request-resourceName"></a>
Name of the resource.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: No

## Response Syntax
<a name="API_DescribeAppVersionResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "physicalResource": { 
      "additionalInfo": { 
         "string" : [ "string" ]
      },
      "appComponents": [ 
         { 
            "additionalInfo": { 
               "string" : [ "string" ]
            },
            "id": "string",
            "name": "string",
            "type": "string"
         }
      ],
      "excluded": boolean,
      "logicalResourceId": { 
         "eksSourceName": "string",
         "identifier": "string",
         "logicalStackName": "string",
         "resourceGroupName": "string",
         "terraformSourceName": "string"
      },
      "parentResourceName": "string",
      "physicalResourceId": { 
         "awsAccountId": "string",
         "awsRegion": "string",
         "identifier": "string",
         "type": "string"
      },
      "resourceName": "string",
      "resourceType": "string",
      "sourceType": "string"
   }
}
```

## Response Elements
<a name="API_DescribeAppVersionResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_DescribeAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionResource-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_DescribeAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionResource-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

 ** [physicalResource](#API_DescribeAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionResource-response-physicalResource"></a>
Defines a physical resource. A physical resource is a resource that exists in your account. It can be identified using an Amazon Resource Name (ARN) or a Resilience Hub-native identifier.  
Type: [PhysicalResource](API_PhysicalResource.md) object

## Errors
<a name="API_DescribeAppVersionResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeAppVersionResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeAppVersionResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeAppVersionResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeAppVersionResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeAppVersionResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeAppVersionResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeAppVersionResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeAppVersionResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeAppVersionResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeAppVersionResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeAppVersionResource) 

# DescribeAppVersionResourcesResolutionStatus
<a name="API_DescribeAppVersionResourcesResolutionStatus"></a>

Returns the resolution status for the specified resolution identifier for an application version. If `resolutionId` is not specified, the current resolution status is returned.

## Request Syntax
<a name="API_DescribeAppVersionResourcesResolutionStatus_RequestSyntax"></a>

```
POST /describe-app-version-resources-resolution-status HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "resolutionId": "string"
}
```

## URI Request Parameters
<a name="API_DescribeAppVersionResourcesResolutionStatus_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeAppVersionResourcesResolutionStatus_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DescribeAppVersionResourcesResolutionStatus_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionResourcesResolutionStatus-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_DescribeAppVersionResourcesResolutionStatus_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionResourcesResolutionStatus-request-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

 ** [resolutionId](#API_DescribeAppVersionResourcesResolutionStatus_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionResourcesResolutionStatus-request-resolutionId"></a>
The identifier for a specific resolution.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

## Response Syntax
<a name="API_DescribeAppVersionResourcesResolutionStatus_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "errorMessage": "string",
   "resolutionId": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_DescribeAppVersionResourcesResolutionStatus_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_DescribeAppVersionResourcesResolutionStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionResourcesResolutionStatus-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_DescribeAppVersionResourcesResolutionStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionResourcesResolutionStatus-response-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}` 

 ** [errorMessage](#API_DescribeAppVersionResourcesResolutionStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionResourcesResolutionStatus-response-errorMessage"></a>
The returned error message for the request.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 500.

 ** [resolutionId](#API_DescribeAppVersionResourcesResolutionStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionResourcesResolutionStatus-response-resolutionId"></a>
The identifier for a specific resolution.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.

 ** [status](#API_DescribeAppVersionResourcesResolutionStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionResourcesResolutionStatus-response-status"></a>
Status of the action.  
Type: String  
Valid Values: `Pending | InProgress | Failed | Success` 

## Errors
<a name="API_DescribeAppVersionResourcesResolutionStatus_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeAppVersionResourcesResolutionStatus_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeAppVersionResourcesResolutionStatus) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeAppVersionResourcesResolutionStatus) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeAppVersionResourcesResolutionStatus) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeAppVersionResourcesResolutionStatus) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeAppVersionResourcesResolutionStatus) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeAppVersionResourcesResolutionStatus) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeAppVersionResourcesResolutionStatus) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeAppVersionResourcesResolutionStatus) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeAppVersionResourcesResolutionStatus) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeAppVersionResourcesResolutionStatus) 

# DescribeAppVersionTemplate
<a name="API_DescribeAppVersionTemplate"></a>

Describes details about an AWS Resilience Hub application.

## Request Syntax
<a name="API_DescribeAppVersionTemplate_RequestSyntax"></a>

```
POST /describe-app-version-template HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string"
}
```

## URI Request Parameters
<a name="API_DescribeAppVersionTemplate_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeAppVersionTemplate_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DescribeAppVersionTemplate_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionTemplate-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_DescribeAppVersionTemplate_RequestSyntax) **   <a name="resiliencehub-DescribeAppVersionTemplate-request-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

## Response Syntax
<a name="API_DescribeAppVersionTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appTemplateBody": "string",
   "appVersion": "string"
}
```

## Response Elements
<a name="API_DescribeAppVersionTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_DescribeAppVersionTemplate_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionTemplate-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appTemplateBody](#API_DescribeAppVersionTemplate_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionTemplate-response-appTemplateBody"></a>
A JSON string that provides information about your application structure. To learn more about the `appTemplateBody` template, see the sample template provided in the *Examples* section.  
The `appTemplateBody` JSON string has the following structure:  
+  ** `resources` ** 

  The list of logical resources that must be included in the AWS Resilience Hub application.

  Type: Array
**Note**  
Don't add the resources that you want to exclude.

  Each `resources` array item includes the following fields:
  +  * `logicalResourceId` * 

    Logical identifier of the resource.

    Type: Object

    Each `logicalResourceId` object includes the following fields:
    +  `identifier` 

      Identifier of the resource.

      Type: String
    +  `logicalStackName` 

      The name of the AWS CloudFormation stack this resource belongs to.

      Type: String
    +  `resourceGroupName` 

      The name of the resource group this resource belongs to.

      Type: String
    +  `terraformSourceName` 

      The name of the Terraform S3 state file this resource belongs to.

      Type: String
    +  `eksSourceName` 

      Name of the Amazon Elastic Kubernetes Service cluster and namespace this resource belongs to.
**Note**  
This parameter accepts values in "eks-cluster/namespace" format.

      Type: String
  +  * `type` * 

    The type of resource.

    Type: string
  +  * `name` * 

    The name of the resource.

    Type: String
  +  `additionalInfo` 

    Additional configuration parameters for an AWS Resilience Hub application. If you want to implement `additionalInfo` through the AWS Resilience Hub console rather than using an API call, see [Configure the application configuration parameters](https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html).
**Note**  
Currently, this parameter accepts a key-value mapping (in a string format) of only one failover region and one associated account.  
Key: `"failover-regions"`   
Value: `"[{"region":"<REGION>", "accounts":[{"id":"<ACCOUNT_ID>"}]}]"` 
+  ** `appComponents` ** 

  List of AppComponents that this resource belongs to. If an AppComponent is not part of the AWS Resilience Hub application, it will be added.

  Type: Array

  Each `appComponents` array item includes the following fields:
  +  `name` 

    Name of the AppComponent.

    Type: String
  +  `type` 

    Type of AppComponent. For more information about the types of AppComponent, see [Grouping resources in an AppComponent](https://docs.aws.amazon.com/resilience-hub/latest/userguide/AppComponent.grouping.html).

    Type: String
  +  `resourceNames` 

    The list of included resources that are assigned to the AppComponent.

    Type: Array of strings
  +  `additionalInfo` 

    Additional configuration parameters for an AWS Resilience Hub application. If you want to implement `additionalInfo` through the AWS Resilience Hub console rather than using an API call, see [Configure the application configuration parameters](https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html).
**Note**  
Currently, this parameter accepts a key-value mapping (in a string format) of only one failover region and one associated account.  
Key: `"failover-regions"`   
Value: `"[{"region":"<REGION>", "accounts":[{"id":"<ACCOUNT_ID>"}]}]"` 
+  ** `excludedResources` ** 

  The list of logical resource identifiers to be excluded from the application.

  Type: Array
**Note**  
Don't add the resources that you want to include.

  Each `excludedResources` array item includes the following fields:
  +  * `logicalResourceIds` * 

    Logical identifier of the resource.

    Type: Object
**Note**  
You can configure only one of the following fields:  
 `logicalStackName` 
 `resourceGroupName` 
 `terraformSourceName` 
 `eksSourceName` 

    Each `logicalResourceIds` object includes the following fields:
    +  `identifier` 

      Identifier of the resource.

      Type: String
    +  `logicalStackName` 

      The name of the AWS CloudFormation stack this resource belongs to.

      Type: String
    +  `resourceGroupName` 

      The name of the resource group this resource belongs to.

      Type: String
    +  `terraformSourceName` 

      The name of the Terraform S3 state file this resource belongs to.

      Type: String
    +  `eksSourceName` 

      Name of the Amazon Elastic Kubernetes Service cluster and namespace this resource belongs to.
**Note**  
This parameter accepts values in "eks-cluster/namespace" format.

      Type: String
+  ** `version` ** 

   AWS Resilience Hub application version.
+  `additionalInfo` 

  Additional configuration parameters for an AWS Resilience Hub application. If you want to implement `additionalInfo` through the AWS Resilience Hub console rather than using an API call, see [Configure the application configuration parameters](https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html).
**Note**  
Currently, this parameter accepts a key-value mapping (in a string format) of only one failover region and one associated account.  
Key: `"failover-regions"`   
Value: `"[{"region":"<REGION>", "accounts":[{"id":"<ACCOUNT_ID>"}]}]"` 
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 409600.  
Pattern: `[\w\s:,-\.'\/{}\[\]:"\\]+` 

 ** [appVersion](#API_DescribeAppVersionTemplate_ResponseSyntax) **   <a name="resiliencehub-DescribeAppVersionTemplate-response-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}` 

## Errors
<a name="API_DescribeAppVersionTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeAppVersionTemplate_Examples"></a>

### Sample appTemplateBody template
<a name="API_DescribeAppVersionTemplate_Example_1"></a>

This example illustrates one usage of DescribeAppVersionTemplate.

```
{
	"resources": [{
		"logicalResourceId": {
			"identifier": "testResourceID1",
			"logicalStackName": "testResourceStack1",
			"resourceGroupName": null
		},
		"type": "AWS::RDS::DBInstance",
		"name": "testResourceName"
	}],
	"appComponents": [{
			"name": "testappcomponent-test",
			"type": "AWS::ResilienceHub::AppComponent",
			"resourceNames": [
				"testResourceName"
			]
		},
		{
			"name": "testappcommon",
			"type": "AWS::ResilienceHub::AppComponent",
			"resourceNames": "[testResourceName]"
		}
	],
	"excludedResources": {
		"logicalResourceIds": [{
			"identifier": "testResourceID2",
			"logicalStackName": "testResourceStack2",
			"resourceGroupName": ""
		}]
	},
	"version": 2.0
}
```

## See Also
<a name="API_DescribeAppVersionTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeAppVersionTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeAppVersionTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeAppVersionTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeAppVersionTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeAppVersionTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeAppVersionTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeAppVersionTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeAppVersionTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeAppVersionTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeAppVersionTemplate) 

# DescribeDraftAppVersionResourcesImportStatus
<a name="API_DescribeDraftAppVersionResourcesImportStatus"></a>

Describes the status of importing resources to an application version.

**Note**  
If you get a 404 error with `ResourceImportStatusNotFoundAppMetadataException`, you must call `importResourcesToDraftAppVersion` after creating the application and before calling `describeDraftAppVersionResourcesImportStatus` to obtain the status.

## Request Syntax
<a name="API_DescribeDraftAppVersionResourcesImportStatus_RequestSyntax"></a>

```
POST /describe-draft-app-version-resources-import-status HTTP/1.1
Content-type: application/json

{
   "appArn": "string"
}
```

## URI Request Parameters
<a name="API_DescribeDraftAppVersionResourcesImportStatus_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeDraftAppVersionResourcesImportStatus_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DescribeDraftAppVersionResourcesImportStatus_RequestSyntax) **   <a name="resiliencehub-DescribeDraftAppVersionResourcesImportStatus-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_DescribeDraftAppVersionResourcesImportStatus_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "errorDetails": [ 
      { 
         "errorMessage": "string"
      }
   ],
   "errorMessage": "string",
   "status": "string",
   "statusChangeTime": number
}
```

## Response Elements
<a name="API_DescribeDraftAppVersionResourcesImportStatus_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_DescribeDraftAppVersionResourcesImportStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeDraftAppVersionResourcesImportStatus-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_DescribeDraftAppVersionResourcesImportStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeDraftAppVersionResourcesImportStatus-response-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}` 

 ** [errorDetails](#API_DescribeDraftAppVersionResourcesImportStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeDraftAppVersionResourcesImportStatus-response-errorDetails"></a>
List of errors that were encountered while importing resources.  
Type: Array of [ErrorDetail](API_ErrorDetail.md) objects

 ** [errorMessage](#API_DescribeDraftAppVersionResourcesImportStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeDraftAppVersionResourcesImportStatus-response-errorMessage"></a>
The error message returned for the resource request.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 500.

 ** [status](#API_DescribeDraftAppVersionResourcesImportStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeDraftAppVersionResourcesImportStatus-response-status"></a>
Status of the action.  
Type: String  
Valid Values: `Pending | InProgress | Failed | Success` 

 ** [statusChangeTime](#API_DescribeDraftAppVersionResourcesImportStatus_ResponseSyntax) **   <a name="resiliencehub-DescribeDraftAppVersionResourcesImportStatus-response-statusChangeTime"></a>
The time when the status last changed.  
Type: Timestamp

## Errors
<a name="API_DescribeDraftAppVersionResourcesImportStatus_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeDraftAppVersionResourcesImportStatus_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeDraftAppVersionResourcesImportStatus) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeDraftAppVersionResourcesImportStatus) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeDraftAppVersionResourcesImportStatus) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeDraftAppVersionResourcesImportStatus) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeDraftAppVersionResourcesImportStatus) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeDraftAppVersionResourcesImportStatus) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeDraftAppVersionResourcesImportStatus) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeDraftAppVersionResourcesImportStatus) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeDraftAppVersionResourcesImportStatus) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeDraftAppVersionResourcesImportStatus) 

# DescribeMetricsExport
<a name="API_DescribeMetricsExport"></a>

Describes the metrics of the application configuration being exported.

## Request Syntax
<a name="API_DescribeMetricsExport_RequestSyntax"></a>

```
POST /describe-metrics-export HTTP/1.1
Content-type: application/json

{
   "metricsExportId": "string"
}
```

## URI Request Parameters
<a name="API_DescribeMetricsExport_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeMetricsExport_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [metricsExportId](#API_DescribeMetricsExport_RequestSyntax) **   <a name="resiliencehub-DescribeMetricsExport-request-metricsExportId"></a>
Identifier of the metrics export task.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

## Response Syntax
<a name="API_DescribeMetricsExport_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "errorMessage": "string",
   "exportLocation": { 
      "bucket": "string",
      "prefix": "string"
   },
   "metricsExportId": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_DescribeMetricsExport_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errorMessage](#API_DescribeMetricsExport_ResponseSyntax) **   <a name="resiliencehub-DescribeMetricsExport-response-errorMessage"></a>
Explains the error that occurred while exporting the metrics.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 500.

 ** [exportLocation](#API_DescribeMetricsExport_ResponseSyntax) **   <a name="resiliencehub-DescribeMetricsExport-response-exportLocation"></a>
Specifies the name of the Amazon S3 bucket where the exported metrics is stored.  
Type: [S3Location](API_S3Location.md) object

 ** [metricsExportId](#API_DescribeMetricsExport_ResponseSyntax) **   <a name="resiliencehub-DescribeMetricsExport-response-metricsExportId"></a>
Identifier for the metrics export task.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.

 ** [status](#API_DescribeMetricsExport_ResponseSyntax) **   <a name="resiliencehub-DescribeMetricsExport-response-status"></a>
Indicates the status of the metrics export task.  
Type: String  
Valid Values: `Pending | InProgress | Failed | Success` 

## Errors
<a name="API_DescribeMetricsExport_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## Examples
<a name="API_DescribeMetricsExport_Examples"></a>

### Sample Request
<a name="API_DescribeMetricsExport_Example_1"></a>

The following is an example request payload.

#### Sample Request
<a name="API_DescribeMetricsExport_Example_1_Request"></a>

```
{
  "metricsExportId": "fe0e1e00-03eb-11ee-8796-02038f8a9691"
}
```

### Sample Response
<a name="API_DescribeMetricsExport_Example_2"></a>

The following is an example response payload.

#### Sample Response
<a name="API_DescribeMetricsExport_Example_2_Response"></a>

```
{
  "metricsExportId": "fe0e1e00-03eb-11ee-8796-02038f8a9691",
  "status": "Success",
  "exportLocation": {
    "bucket": "my-bucket-name",
    "prefix": "resiliencehub-metrics/2024-11-14/fe0e1e00-03eb-11ee-8796-02038f8a9691"
  }
}
```

## See Also
<a name="API_DescribeMetricsExport_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeMetricsExport) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeMetricsExport) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeMetricsExport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeMetricsExport) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeMetricsExport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeMetricsExport) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeMetricsExport) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeMetricsExport) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeMetricsExport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeMetricsExport) 

# DescribeResiliencyPolicy
<a name="API_DescribeResiliencyPolicy"></a>

Describes a specified resiliency policy for an AWS Resilience Hub application. The returned policy object includes creation time, data location constraints, the Amazon Resource Name (ARN) for the policy, tags, tier, and more.

## Request Syntax
<a name="API_DescribeResiliencyPolicy_RequestSyntax"></a>

```
POST /describe-resiliency-policy HTTP/1.1
Content-type: application/json

{
   "policyArn": "string"
}
```

## URI Request Parameters
<a name="API_DescribeResiliencyPolicy_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeResiliencyPolicy_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [policyArn](#API_DescribeResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-DescribeResiliencyPolicy-request-policyArn"></a>
Amazon Resource Name (ARN) of the resiliency policy. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:resiliency-policy/`policy-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_DescribeResiliencyPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "policy": { 
      "creationTime": number,
      "dataLocationConstraint": "string",
      "estimatedCostTier": "string",
      "policy": { 
         "string" : { 
            "rpoInSecs": number,
            "rtoInSecs": number
         }
      },
      "policyArn": "string",
      "policyDescription": "string",
      "policyName": "string",
      "tags": { 
         "string" : "string" 
      },
      "tier": "string"
   }
}
```

## Response Elements
<a name="API_DescribeResiliencyPolicy_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [policy](#API_DescribeResiliencyPolicy_ResponseSyntax) **   <a name="resiliencehub-DescribeResiliencyPolicy-response-policy"></a>
Information about the specific resiliency policy, returned as an object. This object includes creation time, data location constraints, its name, description, tags, the recovery time objective (RTO) and recovery point objective (RPO) in seconds, and more.  
Type: [ResiliencyPolicy](API_ResiliencyPolicy.md) object

## Errors
<a name="API_DescribeResiliencyPolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeResiliencyPolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeResiliencyPolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeResiliencyPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeResiliencyPolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeResiliencyPolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeResiliencyPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeResiliencyPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeResiliencyPolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeResiliencyPolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeResiliencyPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeResiliencyPolicy) 

# DescribeResourceGroupingRecommendationTask
<a name="API_DescribeResourceGroupingRecommendationTask"></a>

Describes the resource grouping recommendation tasks run by AWS Resilience Hub for your application.

## Request Syntax
<a name="API_DescribeResourceGroupingRecommendationTask_RequestSyntax"></a>

```
POST /describe-resource-grouping-recommendation-task HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "groupingId": "string"
}
```

## URI Request Parameters
<a name="API_DescribeResourceGroupingRecommendationTask_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_DescribeResourceGroupingRecommendationTask_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_DescribeResourceGroupingRecommendationTask_RequestSyntax) **   <a name="resiliencehub-DescribeResourceGroupingRecommendationTask-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [groupingId](#API_DescribeResourceGroupingRecommendationTask_RequestSyntax) **   <a name="resiliencehub-DescribeResourceGroupingRecommendationTask-request-groupingId"></a>
Identifier of the grouping recommendation task.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

## Response Syntax
<a name="API_DescribeResourceGroupingRecommendationTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "errorMessage": "string",
   "groupingId": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_DescribeResourceGroupingRecommendationTask_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errorMessage](#API_DescribeResourceGroupingRecommendationTask_ResponseSyntax) **   <a name="resiliencehub-DescribeResourceGroupingRecommendationTask-response-errorMessage"></a>
Error that occurred while generating a grouping recommendation.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 500.

 ** [groupingId](#API_DescribeResourceGroupingRecommendationTask_ResponseSyntax) **   <a name="resiliencehub-DescribeResourceGroupingRecommendationTask-response-groupingId"></a>
Identifier of the grouping recommendation task.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.

 ** [status](#API_DescribeResourceGroupingRecommendationTask_ResponseSyntax) **   <a name="resiliencehub-DescribeResourceGroupingRecommendationTask-response-status"></a>
Status of the action.  
Type: String  
Valid Values: `Pending | InProgress | Failed | Success` 

## Errors
<a name="API_DescribeResourceGroupingRecommendationTask_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_DescribeResourceGroupingRecommendationTask_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/DescribeResourceGroupingRecommendationTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/DescribeResourceGroupingRecommendationTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/DescribeResourceGroupingRecommendationTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/DescribeResourceGroupingRecommendationTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/DescribeResourceGroupingRecommendationTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/DescribeResourceGroupingRecommendationTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/DescribeResourceGroupingRecommendationTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/DescribeResourceGroupingRecommendationTask) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/DescribeResourceGroupingRecommendationTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/DescribeResourceGroupingRecommendationTask) 

# ImportResourcesToDraftAppVersion
<a name="API_ImportResourcesToDraftAppVersion"></a>

Imports resources to AWS Resilience Hub application draft version from different input sources. For more information about the input sources supported by AWS Resilience Hub, see [Discover the structure and describe your Resilience Hub application](https://docs.aws.amazon.com/resilience-hub/latest/userguide/discover-structure.html).

## Request Syntax
<a name="API_ImportResourcesToDraftAppVersion_RequestSyntax"></a>

```
POST /import-resources-to-draft-app-version HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "eksSources": [ 
      { 
         "eksClusterArn": "string",
         "namespaces": [ "string" ]
      }
   ],
   "importStrategy": "string",
   "sourceArns": [ "string" ],
   "terraformSources": [ 
      { 
         "s3StateFileUrl": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_ImportResourcesToDraftAppVersion_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ImportResourcesToDraftAppVersion_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_ImportResourcesToDraftAppVersion_RequestSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [eksSources](#API_ImportResourcesToDraftAppVersion_RequestSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-request-eksSources"></a>
The input sources of the Amazon Elastic Kubernetes Service resources you need to import.  
Type: Array of [EksSource](API_EksSource.md) objects  
Required: No

 ** [importStrategy](#API_ImportResourcesToDraftAppVersion_RequestSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-request-importStrategy"></a>
The import strategy you would like to set to import resources into AWS Resilience Hub application.  
Type: String  
Valid Values: `AddOnly | ReplaceAll`   
Required: No

 ** [sourceArns](#API_ImportResourcesToDraftAppVersion_RequestSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-request-sourceArns"></a>
The Amazon Resource Names (ARNs) for the resources.  
Type: Array of strings  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: No

 ** [terraformSources](#API_ImportResourcesToDraftAppVersion_RequestSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-request-terraformSources"></a>
 A list of terraform file s3 URLs you need to import.   
Type: Array of [TerraformSource](API_TerraformSource.md) objects  
Required: No

## Response Syntax
<a name="API_ImportResourcesToDraftAppVersion_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "eksSources": [ 
      { 
         "eksClusterArn": "string",
         "namespaces": [ "string" ]
      }
   ],
   "sourceArns": [ "string" ],
   "status": "string",
   "terraformSources": [ 
      { 
         "s3StateFileUrl": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ImportResourcesToDraftAppVersion_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_ImportResourcesToDraftAppVersion_ResponseSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_ImportResourcesToDraftAppVersion_ResponseSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-response-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}` 

 ** [eksSources](#API_ImportResourcesToDraftAppVersion_ResponseSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-response-eksSources"></a>
The input sources of the Amazon Elastic Kubernetes Service resources you have imported.  
Type: Array of [EksSource](API_EksSource.md) objects

 ** [sourceArns](#API_ImportResourcesToDraftAppVersion_ResponseSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-response-sourceArns"></a>
The Amazon Resource Names (ARNs) for the resources you have imported.  
Type: Array of strings  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [status](#API_ImportResourcesToDraftAppVersion_ResponseSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-response-status"></a>
Status of the action.  
Type: String  
Valid Values: `Pending | InProgress | Failed | Success` 

 ** [terraformSources](#API_ImportResourcesToDraftAppVersion_ResponseSyntax) **   <a name="resiliencehub-ImportResourcesToDraftAppVersion-response-terraformSources"></a>
 A list of terraform file s3 URLs you have imported.   
Type: Array of [TerraformSource](API_TerraformSource.md) objects

## Errors
<a name="API_ImportResourcesToDraftAppVersion_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ServiceQuotaExceededException **   
This exception occurs when you have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.  
HTTP Status Code: 402

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ImportResourcesToDraftAppVersion_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ImportResourcesToDraftAppVersion) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ImportResourcesToDraftAppVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ImportResourcesToDraftAppVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ImportResourcesToDraftAppVersion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ImportResourcesToDraftAppVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ImportResourcesToDraftAppVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ImportResourcesToDraftAppVersion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ImportResourcesToDraftAppVersion) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ImportResourcesToDraftAppVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ImportResourcesToDraftAppVersion) 

# ListAlarmRecommendations
<a name="API_ListAlarmRecommendations"></a>

Lists the alarm recommendations for an AWS Resilience Hub application.

## Request Syntax
<a name="API_ListAlarmRecommendations_RequestSyntax"></a>

```
POST /list-alarm-recommendations HTTP/1.1
Content-type: application/json

{
   "assessmentArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListAlarmRecommendations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAlarmRecommendations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentArn](#API_ListAlarmRecommendations_RequestSyntax) **   <a name="resiliencehub-ListAlarmRecommendations-request-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [maxResults](#API_ListAlarmRecommendations_RequestSyntax) **   <a name="resiliencehub-ListAlarmRecommendations-request-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListAlarmRecommendations_RequestSyntax) **   <a name="resiliencehub-ListAlarmRecommendations-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

## Response Syntax
<a name="API_ListAlarmRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "alarmRecommendations": [ 
      { 
         "appComponentName": "string",
         "appComponentNames": [ "string" ],
         "description": "string",
         "items": [ 
            { 
               "alreadyImplemented": boolean,
               "discoveredAlarm": { 
                  "alarmArn": "string",
                  "source": "string"
               },
               "excluded": boolean,
               "excludeReason": "string",
               "latestDiscoveredExperiment": { 
                  "experimentArn": "string",
                  "experimentTemplateId": "string"
               },
               "resourceId": "string",
               "targetAccountId": "string",
               "targetRegion": "string"
            }
         ],
         "name": "string",
         "prerequisite": "string",
         "recommendationId": "string",
         "recommendationStatus": "string",
         "referenceId": "string",
         "type": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAlarmRecommendations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [alarmRecommendations](#API_ListAlarmRecommendations_ResponseSyntax) **   <a name="resiliencehub-ListAlarmRecommendations-response-alarmRecommendations"></a>
The alarm recommendations for an AWS Resilience Hub application, returned as an object. This object includes AppComponent names, descriptions, information about whether a recommendation has already been implemented or not, prerequisites, and more.  
Type: Array of [AlarmRecommendation](API_AlarmRecommendation.md) objects

 ** [nextToken](#API_ListAlarmRecommendations_ResponseSyntax) **   <a name="resiliencehub-ListAlarmRecommendations-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

## Errors
<a name="API_ListAlarmRecommendations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAlarmRecommendations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAlarmRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAlarmRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAlarmRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAlarmRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAlarmRecommendations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAlarmRecommendations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAlarmRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAlarmRecommendations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAlarmRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAlarmRecommendations) 

# ListAppAssessmentComplianceDrifts
<a name="API_ListAppAssessmentComplianceDrifts"></a>

List of compliance drifts that were detected while running an assessment.

## Request Syntax
<a name="API_ListAppAssessmentComplianceDrifts_RequestSyntax"></a>

```
POST /list-app-assessment-compliance-drifts HTTP/1.1
Content-type: application/json

{
   "assessmentArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListAppAssessmentComplianceDrifts_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAppAssessmentComplianceDrifts_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentArn](#API_ListAppAssessmentComplianceDrifts_RequestSyntax) **   <a name="resiliencehub-ListAppAssessmentComplianceDrifts-request-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [maxResults](#API_ListAppAssessmentComplianceDrifts_RequestSyntax) **   <a name="resiliencehub-ListAppAssessmentComplianceDrifts-request-maxResults"></a>
Maximum number of compliance drifts requested.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListAppAssessmentComplianceDrifts_RequestSyntax) **   <a name="resiliencehub-ListAppAssessmentComplianceDrifts-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

## Response Syntax
<a name="API_ListAppAssessmentComplianceDrifts_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "complianceDrifts": [ 
      { 
         "actualReferenceId": "string",
         "actualValue": { 
            "string" : { 
               "achievableRpoInSecs": number,
               "achievableRtoInSecs": number,
               "complianceStatus": "string",
               "currentRpoInSecs": number,
               "currentRtoInSecs": number,
               "message": "string",
               "rpoDescription": "string",
               "rpoReferenceId": "string",
               "rtoDescription": "string",
               "rtoReferenceId": "string"
            }
         },
         "appId": "string",
         "appVersion": "string",
         "diffType": "string",
         "driftType": "string",
         "entityId": "string",
         "entityType": "string",
         "expectedReferenceId": "string",
         "expectedValue": { 
            "string" : { 
               "achievableRpoInSecs": number,
               "achievableRtoInSecs": number,
               "complianceStatus": "string",
               "currentRpoInSecs": number,
               "currentRtoInSecs": number,
               "message": "string",
               "rpoDescription": "string",
               "rpoReferenceId": "string",
               "rtoDescription": "string",
               "rtoReferenceId": "string"
            }
         }
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAppAssessmentComplianceDrifts_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [complianceDrifts](#API_ListAppAssessmentComplianceDrifts_ResponseSyntax) **   <a name="resiliencehub-ListAppAssessmentComplianceDrifts-response-complianceDrifts"></a>
Indicates compliance drifts (recovery time objective (RTO) and recovery point objective (RPO)) detected for an assessed entity.  
Type: Array of [ComplianceDrift](API_ComplianceDrift.md) objects

 ** [nextToken](#API_ListAppAssessmentComplianceDrifts_ResponseSyntax) **   <a name="resiliencehub-ListAppAssessmentComplianceDrifts-response-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}` 

## Errors
<a name="API_ListAppAssessmentComplianceDrifts_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAppAssessmentComplianceDrifts_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAppAssessmentComplianceDrifts) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAppAssessmentComplianceDrifts) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAppAssessmentComplianceDrifts) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAppAssessmentComplianceDrifts) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAppAssessmentComplianceDrifts) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAppAssessmentComplianceDrifts) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAppAssessmentComplianceDrifts) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAppAssessmentComplianceDrifts) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAppAssessmentComplianceDrifts) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAppAssessmentComplianceDrifts) 

# ListAppAssessmentResourceDrifts
<a name="API_ListAppAssessmentResourceDrifts"></a>

List of resource drifts that were detected while running an assessment.

## Request Syntax
<a name="API_ListAppAssessmentResourceDrifts_RequestSyntax"></a>

```
POST /list-app-assessment-resource-drifts HTTP/1.1
Content-type: application/json

{
   "assessmentArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListAppAssessmentResourceDrifts_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAppAssessmentResourceDrifts_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentArn](#API_ListAppAssessmentResourceDrifts_RequestSyntax) **   <a name="resiliencehub-ListAppAssessmentResourceDrifts-request-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [maxResults](#API_ListAppAssessmentResourceDrifts_RequestSyntax) **   <a name="resiliencehub-ListAppAssessmentResourceDrifts-request-maxResults"></a>
Maximum number of drift results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListAppAssessmentResourceDrifts_RequestSyntax) **   <a name="resiliencehub-ListAppAssessmentResourceDrifts-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

## Response Syntax
<a name="API_ListAppAssessmentResourceDrifts_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "resourceDrifts": [ 
      { 
         "appArn": "string",
         "appVersion": "string",
         "diffType": "string",
         "referenceId": "string",
         "resourceIdentifier": { 
            "logicalResourceId": { 
               "eksSourceName": "string",
               "identifier": "string",
               "logicalStackName": "string",
               "resourceGroupName": "string",
               "terraformSourceName": "string"
            },
            "resourceType": "string"
         }
      }
   ]
}
```

## Response Elements
<a name="API_ListAppAssessmentResourceDrifts_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListAppAssessmentResourceDrifts_ResponseSyntax) **   <a name="resiliencehub-ListAppAssessmentResourceDrifts-response-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}` 

 ** [resourceDrifts](#API_ListAppAssessmentResourceDrifts_ResponseSyntax) **   <a name="resiliencehub-ListAppAssessmentResourceDrifts-response-resourceDrifts"></a>
Indicates all the resource drifts detected for an assessed entity.  
Type: Array of [ResourceDrift](API_ResourceDrift.md) objects

## Errors
<a name="API_ListAppAssessmentResourceDrifts_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAppAssessmentResourceDrifts_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAppAssessmentResourceDrifts) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAppAssessmentResourceDrifts) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAppAssessmentResourceDrifts) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAppAssessmentResourceDrifts) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAppAssessmentResourceDrifts) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAppAssessmentResourceDrifts) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAppAssessmentResourceDrifts) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAppAssessmentResourceDrifts) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAppAssessmentResourceDrifts) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAppAssessmentResourceDrifts) 

# ListAppAssessments
<a name="API_ListAppAssessments"></a>

Lists the assessments for an AWS Resilience Hub application. You can use request parameters to refine the results for the response object.

## Request Syntax
<a name="API_ListAppAssessments_RequestSyntax"></a>

```
GET /list-app-assessments?appArn=appArn&assessmentName=assessmentName&assessmentStatus=assessmentStatus&complianceStatus=complianceStatus&invoker=invoker&maxResults=maxResults&nextToken=nextToken&reverseOrder=reverseOrder HTTP/1.1
```

## URI Request Parameters
<a name="API_ListAppAssessments_RequestParameters"></a>

The request uses the following URI parameters.

 ** [appArn](#API_ListAppAssessments_RequestSyntax) **   <a name="resiliencehub-ListAppAssessments-request-uri-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [assessmentName](#API_ListAppAssessments_RequestSyntax) **   <a name="resiliencehub-ListAppAssessments-request-uri-assessmentName"></a>
The name for the assessment.  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}` 

 ** [assessmentStatus](#API_ListAppAssessments_RequestSyntax) **   <a name="resiliencehub-ListAppAssessments-request-uri-assessmentStatus"></a>
The current status of the assessment for the resiliency policy.  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Valid Values: `Pending | InProgress | Failed | Success` 

 ** [complianceStatus](#API_ListAppAssessments_RequestSyntax) **   <a name="resiliencehub-ListAppAssessments-request-uri-complianceStatus"></a>
The current status of compliance for the resiliency policy.  
Valid Values: `PolicyBreached | PolicyMet | NotApplicable | MissingPolicy` 

 ** [invoker](#API_ListAppAssessments_RequestSyntax) **   <a name="resiliencehub-ListAppAssessments-request-uri-invoker"></a>
Specifies the entity that invoked a specific assessment, either a `User` or the `System`.  
Valid Values: `User | System` 

 ** [maxResults](#API_ListAppAssessments_RequestSyntax) **   <a name="resiliencehub-ListAppAssessments-request-uri-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Valid Range: Minimum value of 1. Maximum value of 100.

 ** [nextToken](#API_ListAppAssessments_RequestSyntax) **   <a name="resiliencehub-ListAppAssessments-request-uri-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Pattern: `\S{1,2000}` 

 ** [reverseOrder](#API_ListAppAssessments_RequestSyntax) **   <a name="resiliencehub-ListAppAssessments-request-uri-reverseOrder"></a>
The default is to sort by ascending **startTime**. To sort by descending **startTime**, set reverseOrder to `true`.

## Request Body
<a name="API_ListAppAssessments_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListAppAssessments_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "assessmentSummaries": [ 
      { 
         "appArn": "string",
         "appVersion": "string",
         "assessmentArn": "string",
         "assessmentName": "string",
         "assessmentStatus": "string",
         "complianceStatus": "string",
         "cost": { 
            "amount": number,
            "currency": "string",
            "frequency": "string"
         },
         "driftStatus": "string",
         "endTime": number,
         "invoker": "string",
         "message": "string",
         "resiliencyScore": number,
         "startTime": number,
         "versionName": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAppAssessments_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessmentSummaries](#API_ListAppAssessments_ResponseSyntax) **   <a name="resiliencehub-ListAppAssessments-response-assessmentSummaries"></a>
The summaries for the specified assessments, returned as an object. This object includes application versions, associated Amazon Resource Numbers (ARNs), cost, messages, resiliency scores, and more.  
Type: Array of [AppAssessmentSummary](API_AppAssessmentSummary.md) objects

 ** [nextToken](#API_ListAppAssessments_ResponseSyntax) **   <a name="resiliencehub-ListAppAssessments-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

## Errors
<a name="API_ListAppAssessments_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAppAssessments_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAppAssessments) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAppAssessments) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAppAssessments) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAppAssessments) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAppAssessments) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAppAssessments) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAppAssessments) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAppAssessments) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAppAssessments) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAppAssessments) 

# ListAppComponentCompliances
<a name="API_ListAppComponentCompliances"></a>

Lists the compliances for an AWS Resilience Hub AppComponent.

## Request Syntax
<a name="API_ListAppComponentCompliances_RequestSyntax"></a>

```
POST /list-app-component-compliances HTTP/1.1
Content-type: application/json

{
   "assessmentArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListAppComponentCompliances_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAppComponentCompliances_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentArn](#API_ListAppComponentCompliances_RequestSyntax) **   <a name="resiliencehub-ListAppComponentCompliances-request-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [maxResults](#API_ListAppComponentCompliances_RequestSyntax) **   <a name="resiliencehub-ListAppComponentCompliances-request-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListAppComponentCompliances_RequestSyntax) **   <a name="resiliencehub-ListAppComponentCompliances-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

## Response Syntax
<a name="API_ListAppComponentCompliances_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "componentCompliances": [ 
      { 
         "appComponentName": "string",
         "compliance": { 
            "string" : { 
               "achievableRpoInSecs": number,
               "achievableRtoInSecs": number,
               "complianceStatus": "string",
               "currentRpoInSecs": number,
               "currentRtoInSecs": number,
               "message": "string",
               "rpoDescription": "string",
               "rpoReferenceId": "string",
               "rtoDescription": "string",
               "rtoReferenceId": "string"
            }
         },
         "cost": { 
            "amount": number,
            "currency": "string",
            "frequency": "string"
         },
         "message": "string",
         "resiliencyScore": { 
            "componentScore": { 
               "string" : { 
                  "excludedCount": number,
                  "outstandingCount": number,
                  "possibleScore": number,
                  "score": number
               }
            },
            "disruptionScore": { 
               "string" : number 
            },
            "score": number
         },
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAppComponentCompliances_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [componentCompliances](#API_ListAppComponentCompliances_ResponseSyntax) **   <a name="resiliencehub-ListAppComponentCompliances-response-componentCompliances"></a>
The compliances for an AWS Resilience Hub AppComponent, returned as an object. This object contains the names of the AppComponents, compliances, costs, resiliency scores, outage scores, and more.  
Type: Array of [AppComponentCompliance](API_AppComponentCompliance.md) objects

 ** [nextToken](#API_ListAppComponentCompliances_ResponseSyntax) **   <a name="resiliencehub-ListAppComponentCompliances-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

## Errors
<a name="API_ListAppComponentCompliances_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAppComponentCompliances_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAppComponentCompliances) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAppComponentCompliances) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAppComponentCompliances) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAppComponentCompliances) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAppComponentCompliances) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAppComponentCompliances) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAppComponentCompliances) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAppComponentCompliances) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAppComponentCompliances) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAppComponentCompliances) 

# ListAppComponentRecommendations
<a name="API_ListAppComponentRecommendations"></a>

Lists the recommendations for an AWS Resilience Hub AppComponent.

## Request Syntax
<a name="API_ListAppComponentRecommendations_RequestSyntax"></a>

```
POST /list-app-component-recommendations HTTP/1.1
Content-type: application/json

{
   "assessmentArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListAppComponentRecommendations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAppComponentRecommendations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentArn](#API_ListAppComponentRecommendations_RequestSyntax) **   <a name="resiliencehub-ListAppComponentRecommendations-request-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [maxResults](#API_ListAppComponentRecommendations_RequestSyntax) **   <a name="resiliencehub-ListAppComponentRecommendations-request-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListAppComponentRecommendations_RequestSyntax) **   <a name="resiliencehub-ListAppComponentRecommendations-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

## Response Syntax
<a name="API_ListAppComponentRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "componentRecommendations": [ 
      { 
         "appComponentName": "string",
         "configRecommendations": [ 
            { 
               "appComponentName": "string",
               "compliance": { 
                  "string" : { 
                     "achievableRpoInSecs": number,
                     "achievableRtoInSecs": number,
                     "complianceStatus": "string",
                     "currentRpoInSecs": number,
                     "currentRtoInSecs": number,
                     "message": "string",
                     "rpoDescription": "string",
                     "rpoReferenceId": "string",
                     "rtoDescription": "string",
                     "rtoReferenceId": "string"
                  }
               },
               "cost": { 
                  "amount": number,
                  "currency": "string",
                  "frequency": "string"
               },
               "description": "string",
               "haArchitecture": "string",
               "name": "string",
               "optimizationType": "string",
               "recommendationCompliance": { 
                  "string" : { 
                     "expectedComplianceStatus": "string",
                     "expectedRpoDescription": "string",
                     "expectedRpoInSecs": number,
                     "expectedRtoDescription": "string",
                     "expectedRtoInSecs": number
                  }
               },
               "referenceId": "string",
               "suggestedChanges": [ "string" ]
            }
         ],
         "recommendationStatus": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAppComponentRecommendations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [componentRecommendations](#API_ListAppComponentRecommendations_ResponseSyntax) **   <a name="resiliencehub-ListAppComponentRecommendations-response-componentRecommendations"></a>
The recommendations for an AWS Resilience Hub AppComponent, returned as an object. This object contains the names of the AppComponents, configuration recommendations, and recommendation statuses.  
Type: Array of [ComponentRecommendation](API_ComponentRecommendation.md) objects

 ** [nextToken](#API_ListAppComponentRecommendations_ResponseSyntax) **   <a name="resiliencehub-ListAppComponentRecommendations-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

## Errors
<a name="API_ListAppComponentRecommendations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAppComponentRecommendations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAppComponentRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAppComponentRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAppComponentRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAppComponentRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAppComponentRecommendations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAppComponentRecommendations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAppComponentRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAppComponentRecommendations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAppComponentRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAppComponentRecommendations) 

# ListAppInputSources
<a name="API_ListAppInputSources"></a>

Lists all the input sources of the AWS Resilience Hub application. For more information about the input sources supported by AWS Resilience Hub, see [Discover the structure and describe your Resilience Hub application](https://docs.aws.amazon.com/resilience-hub/latest/userguide/discover-structure.html).

## Request Syntax
<a name="API_ListAppInputSources_RequestSyntax"></a>

```
POST /list-app-input-sources HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListAppInputSources_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAppInputSources_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_ListAppInputSources_RequestSyntax) **   <a name="resiliencehub-ListAppInputSources-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_ListAppInputSources_RequestSyntax) **   <a name="resiliencehub-ListAppInputSources-request-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

 ** [maxResults](#API_ListAppInputSources_RequestSyntax) **   <a name="resiliencehub-ListAppInputSources-request-maxResults"></a>
Maximum number of input sources to be displayed per AWS Resilience Hub application.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListAppInputSources_RequestSyntax) **   <a name="resiliencehub-ListAppInputSources-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

## Response Syntax
<a name="API_ListAppInputSources_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appInputSources": [ 
      { 
         "eksSourceClusterNamespace": { 
            "eksClusterArn": "string",
            "namespace": "string"
         },
         "importType": "string",
         "resourceCount": number,
         "sourceArn": "string",
         "sourceName": "string",
         "terraformSource": { 
            "s3StateFileUrl": "string"
         }
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAppInputSources_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appInputSources](#API_ListAppInputSources_ResponseSyntax) **   <a name="resiliencehub-ListAppInputSources-response-appInputSources"></a>
The list of AWS Resilience Hub application input sources.  
Type: Array of [AppInputSource](API_AppInputSource.md) objects

 ** [nextToken](#API_ListAppInputSources_ResponseSyntax) **   <a name="resiliencehub-ListAppInputSources-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

## Errors
<a name="API_ListAppInputSources_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAppInputSources_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAppInputSources) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAppInputSources) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAppInputSources) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAppInputSources) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAppInputSources) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAppInputSources) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAppInputSources) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAppInputSources) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAppInputSources) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAppInputSources) 

# ListApps
<a name="API_ListApps"></a>

Lists your AWS Resilience Hub applications.

**Note**  
You can filter applications using only one filter at a time or without using any filter. If you try to filter applications using multiple filters, you will get the following error:  
 `An error occurred (ValidationException) when calling the ListApps operation: Only one filter is supported for this operation.` 

## Request Syntax
<a name="API_ListApps_RequestSyntax"></a>

```
GET /list-apps?appArn=appArn&awsApplicationArn=awsApplicationArn&fromLastAssessmentTime=fromLastAssessmentTime&maxResults=maxResults&name=name&nextToken=nextToken&reverseOrder=reverseOrder&toLastAssessmentTime=toLastAssessmentTime HTTP/1.1
```

## URI Request Parameters
<a name="API_ListApps_RequestParameters"></a>

The request uses the following URI parameters.

 ** [appArn](#API_ListApps_RequestSyntax) **   <a name="resiliencehub-ListApps-request-uri-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [awsApplicationArn](#API_ListApps_RequestSyntax) **   <a name="resiliencehub-ListApps-request-uri-awsApplicationArn"></a>
Amazon Resource Name (ARN) of AWS Resource Groups group that is integrated with an AppRegistry application. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [fromLastAssessmentTime](#API_ListApps_RequestSyntax) **   <a name="resiliencehub-ListApps-request-uri-fromLastAssessmentTime"></a>
Lower limit of the range that is used to filter applications based on their last assessment times.

 ** [maxResults](#API_ListApps_RequestSyntax) **   <a name="resiliencehub-ListApps-request-uri-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Valid Range: Minimum value of 1. Maximum value of 100.

 ** [name](#API_ListApps_RequestSyntax) **   <a name="resiliencehub-ListApps-request-uri-name"></a>
The name for the one of the listed applications.  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}` 

 ** [nextToken](#API_ListApps_RequestSyntax) **   <a name="resiliencehub-ListApps-request-uri-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Pattern: `\S{1,2000}` 

 ** [reverseOrder](#API_ListApps_RequestSyntax) **   <a name="resiliencehub-ListApps-request-uri-reverseOrder"></a>
The application list is sorted based on the values of `lastAppComplianceEvaluationTime` field. By default, application list is sorted in ascending order. To sort the application list in descending order, set this field to `True`.

 ** [toLastAssessmentTime](#API_ListApps_RequestSyntax) **   <a name="resiliencehub-ListApps-request-uri-toLastAssessmentTime"></a>
Upper limit of the range that is used to filter the applications based on their last assessment times.

## Request Body
<a name="API_ListApps_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListApps_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appSummaries": [ 
      { 
         "appArn": "string",
         "assessmentSchedule": "string",
         "awsApplicationArn": "string",
         "complianceStatus": "string",
         "creationTime": number,
         "description": "string",
         "driftStatus": "string",
         "lastAppComplianceEvaluationTime": number,
         "name": "string",
         "resiliencyScore": number,
         "rpoInSecs": number,
         "rtoInSecs": number,
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListApps_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appSummaries](#API_ListApps_ResponseSyntax) **   <a name="resiliencehub-ListApps-response-appSummaries"></a>
Summaries for the AWS Resilience Hub application.  
Type: Array of [AppSummary](API_AppSummary.md) objects

 ** [nextToken](#API_ListApps_ResponseSyntax) **   <a name="resiliencehub-ListApps-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

## Errors
<a name="API_ListApps_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListApps_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListApps) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListApps) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListApps) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListApps) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListApps) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListApps) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListApps) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListApps) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListApps) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListApps) 

# ListAppVersionAppComponents
<a name="API_ListAppVersionAppComponents"></a>

Lists all the AppComponents in the AWS Resilience Hub application.

## Request Syntax
<a name="API_ListAppVersionAppComponents_RequestSyntax"></a>

```
POST /list-app-version-app-components HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListAppVersionAppComponents_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAppVersionAppComponents_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_ListAppVersionAppComponents_RequestSyntax) **   <a name="resiliencehub-ListAppVersionAppComponents-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_ListAppVersionAppComponents_RequestSyntax) **   <a name="resiliencehub-ListAppVersionAppComponents-request-appVersion"></a>
Version of the AppComponent.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

 ** [maxResults](#API_ListAppVersionAppComponents_RequestSyntax) **   <a name="resiliencehub-ListAppVersionAppComponents-request-maxResults"></a>
Maximum number of AppComponents to be displayed per AWS Resilience Hub application version.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListAppVersionAppComponents_RequestSyntax) **   <a name="resiliencehub-ListAppVersionAppComponents-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

## Response Syntax
<a name="API_ListAppVersionAppComponents_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appComponents": [ 
      { 
         "additionalInfo": { 
            "string" : [ "string" ]
         },
         "id": "string",
         "name": "string",
         "type": "string"
      }
   ],
   "appVersion": "string",
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAppVersionAppComponents_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_ListAppVersionAppComponents_ResponseSyntax) **   <a name="resiliencehub-ListAppVersionAppComponents-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appComponents](#API_ListAppVersionAppComponents_ResponseSyntax) **   <a name="resiliencehub-ListAppVersionAppComponents-response-appComponents"></a>
Defines an AppComponent.  
Type: Array of [AppComponent](API_AppComponent.md) objects

 ** [appVersion](#API_ListAppVersionAppComponents_ResponseSyntax) **   <a name="resiliencehub-ListAppVersionAppComponents-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

 ** [nextToken](#API_ListAppVersionAppComponents_ResponseSyntax) **   <a name="resiliencehub-ListAppVersionAppComponents-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

## Errors
<a name="API_ListAppVersionAppComponents_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAppVersionAppComponents_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAppVersionAppComponents) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAppVersionAppComponents) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAppVersionAppComponents) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAppVersionAppComponents) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAppVersionAppComponents) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAppVersionAppComponents) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAppVersionAppComponents) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAppVersionAppComponents) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAppVersionAppComponents) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAppVersionAppComponents) 

# ListAppVersionResourceMappings
<a name="API_ListAppVersionResourceMappings"></a>

Lists how the resources in an application version are mapped/sourced from. Mappings can be physical resource identifiers, CloudFormation stacks, resource-groups, or an application registry app.

## Request Syntax
<a name="API_ListAppVersionResourceMappings_RequestSyntax"></a>

```
POST /list-app-version-resource-mappings HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListAppVersionResourceMappings_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAppVersionResourceMappings_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_ListAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-ListAppVersionResourceMappings-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_ListAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-ListAppVersionResourceMappings-request-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

 ** [maxResults](#API_ListAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-ListAppVersionResourceMappings-request-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-ListAppVersionResourceMappings-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

## Response Syntax
<a name="API_ListAppVersionResourceMappings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "resourceMappings": [ 
      { 
         "appRegistryAppName": "string",
         "eksSourceName": "string",
         "logicalStackName": "string",
         "mappingType": "string",
         "physicalResourceId": { 
            "awsAccountId": "string",
            "awsRegion": "string",
            "identifier": "string",
            "type": "string"
         },
         "resourceGroupName": "string",
         "resourceName": "string",
         "terraformSourceName": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListAppVersionResourceMappings_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListAppVersionResourceMappings_ResponseSyntax) **   <a name="resiliencehub-ListAppVersionResourceMappings-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

 ** [resourceMappings](#API_ListAppVersionResourceMappings_ResponseSyntax) **   <a name="resiliencehub-ListAppVersionResourceMappings-response-resourceMappings"></a>
Mappings used to map logical resources from the template to physical resources. You can use the mapping type `CFN_STACK` if the application template uses a logical stack name. Or you can map individual resources by using the mapping type `RESOURCE`. We recommend using the mapping type `CFN_STACK` if the application is backed by a CloudFormation stack.  
Type: Array of [ResourceMapping](API_ResourceMapping.md) objects

## Errors
<a name="API_ListAppVersionResourceMappings_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAppVersionResourceMappings_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAppVersionResourceMappings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAppVersionResourceMappings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAppVersionResourceMappings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAppVersionResourceMappings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAppVersionResourceMappings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAppVersionResourceMappings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAppVersionResourceMappings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAppVersionResourceMappings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAppVersionResourceMappings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAppVersionResourceMappings) 

# ListAppVersionResources
<a name="API_ListAppVersionResources"></a>

Lists all the resources in an AWS Resilience Hub application.

## Request Syntax
<a name="API_ListAppVersionResources_RequestSyntax"></a>

```
POST /list-app-version-resources HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "maxResults": number,
   "nextToken": "string",
   "resolutionId": "string"
}
```

## URI Request Parameters
<a name="API_ListAppVersionResources_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAppVersionResources_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_ListAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ListAppVersionResources-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_ListAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ListAppVersionResources-request-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

 ** [maxResults](#API_ListAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ListAppVersionResources-request-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ListAppVersionResources-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

 ** [resolutionId](#API_ListAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ListAppVersionResources-request-resolutionId"></a>
The identifier for a specific resolution.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

## Response Syntax
<a name="API_ListAppVersionResources_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "physicalResources": [ 
      { 
         "additionalInfo": { 
            "string" : [ "string" ]
         },
         "appComponents": [ 
            { 
               "additionalInfo": { 
                  "string" : [ "string" ]
               },
               "id": "string",
               "name": "string",
               "type": "string"
            }
         ],
         "excluded": boolean,
         "logicalResourceId": { 
            "eksSourceName": "string",
            "identifier": "string",
            "logicalStackName": "string",
            "resourceGroupName": "string",
            "terraformSourceName": "string"
         },
         "parentResourceName": "string",
         "physicalResourceId": { 
            "awsAccountId": "string",
            "awsRegion": "string",
            "identifier": "string",
            "type": "string"
         },
         "resourceName": "string",
         "resourceType": "string",
         "sourceType": "string"
      }
   ],
   "resolutionId": "string"
}
```

## Response Elements
<a name="API_ListAppVersionResources_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListAppVersionResources_ResponseSyntax) **   <a name="resiliencehub-ListAppVersionResources-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

 ** [physicalResources](#API_ListAppVersionResources_ResponseSyntax) **   <a name="resiliencehub-ListAppVersionResources-response-physicalResources"></a>
The physical resources in the application version.  
Type: Array of [PhysicalResource](API_PhysicalResource.md) objects

 ** [resolutionId](#API_ListAppVersionResources_ResponseSyntax) **   <a name="resiliencehub-ListAppVersionResources-response-resolutionId"></a>
The ID for a specific resolution.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.

## Errors
<a name="API_ListAppVersionResources_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAppVersionResources_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAppVersionResources) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAppVersionResources) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAppVersionResources) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAppVersionResources) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAppVersionResources) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAppVersionResources) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAppVersionResources) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAppVersionResources) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAppVersionResources) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAppVersionResources) 

# ListAppVersions
<a name="API_ListAppVersions"></a>

Lists the different versions for the AWS Resilience Hub applications.

## Request Syntax
<a name="API_ListAppVersions_RequestSyntax"></a>

```
POST /list-app-versions HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "endTime": number,
   "maxResults": number,
   "nextToken": "string",
   "startTime": number
}
```

## URI Request Parameters
<a name="API_ListAppVersions_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListAppVersions_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_ListAppVersions_RequestSyntax) **   <a name="resiliencehub-ListAppVersions-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [endTime](#API_ListAppVersions_RequestSyntax) **   <a name="resiliencehub-ListAppVersions-request-endTime"></a>
Upper limit of the time range to filter the application versions.  
Type: Timestamp  
Required: No

 ** [maxResults](#API_ListAppVersions_RequestSyntax) **   <a name="resiliencehub-ListAppVersions-request-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListAppVersions_RequestSyntax) **   <a name="resiliencehub-ListAppVersions-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

 ** [startTime](#API_ListAppVersions_RequestSyntax) **   <a name="resiliencehub-ListAppVersions-request-startTime"></a>
Lower limit of the time range to filter the application versions.  
Type: Timestamp  
Required: No

## Response Syntax
<a name="API_ListAppVersions_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appVersions": [ 
      { 
         "appVersion": "string",
         "creationTime": number,
         "identifier": number,
         "versionName": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListAppVersions_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appVersions](#API_ListAppVersions_ResponseSyntax) **   <a name="resiliencehub-ListAppVersions-response-appVersions"></a>
The version of the application.  
Type: Array of [AppVersionSummary](API_AppVersionSummary.md) objects

 ** [nextToken](#API_ListAppVersions_ResponseSyntax) **   <a name="resiliencehub-ListAppVersions-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

## Errors
<a name="API_ListAppVersions_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListAppVersions_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListAppVersions) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListAppVersions) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListAppVersions) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListAppVersions) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListAppVersions) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListAppVersions) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListAppVersions) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListAppVersions) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListAppVersions) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListAppVersions) 

# ListMetrics
<a name="API_ListMetrics"></a>

Lists the metrics that can be exported.

## Request Syntax
<a name="API_ListMetrics_RequestSyntax"></a>

```
POST /list-metrics HTTP/1.1
Content-type: application/json

{
   "conditions": [ 
      { 
         "field": "string",
         "operator": "string",
         "value": "string"
      }
   ],
   "dataSource": "string",
   "fields": [ 
      { 
         "aggregation": "string",
         "name": "string"
      }
   ],
   "maxResults": number,
   "nextToken": "string",
   "sorts": [ 
      { 
         "ascending": boolean,
         "field": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_ListMetrics_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListMetrics_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [conditions](#API_ListMetrics_RequestSyntax) **   <a name="resiliencehub-ListMetrics-request-conditions"></a>
Indicates the list of all the conditions that were applied on the metrics.  
Type: Array of [Condition](API_Condition.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 50 items.  
Required: No

 ** [dataSource](#API_ListMetrics_RequestSyntax) **   <a name="resiliencehub-ListMetrics-request-dataSource"></a>
Indicates the data source of the metrics.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** [fields](#API_ListMetrics_RequestSyntax) **   <a name="resiliencehub-ListMetrics-request-fields"></a>
Indicates the list of fields in the data source.  
Type: Array of [Field](API_Field.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 50 items.  
Required: No

 ** [maxResults](#API_ListMetrics_RequestSyntax) **   <a name="resiliencehub-ListMetrics-request-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListMetrics_RequestSyntax) **   <a name="resiliencehub-ListMetrics-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

 ** [sorts](#API_ListMetrics_RequestSyntax) **   <a name="resiliencehub-ListMetrics-request-sorts"></a>
(Optional) Indicates the order in which you want to sort the fields in the metrics. By default, the fields are sorted in the ascending order.  
Type: Array of [Sort](API_Sort.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 50 items.  
Required: No

## Response Syntax
<a name="API_ListMetrics_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "rows": [ 
      [ "string" ]
   ]
}
```

## Response Elements
<a name="API_ListMetrics_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListMetrics_ResponseSyntax) **   <a name="resiliencehub-ListMetrics-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

 ** [rows](#API_ListMetrics_ResponseSyntax) **   <a name="resiliencehub-ListMetrics-response-rows"></a>
Specifies all the list of metric values for each row of metrics.  
Type: Array of arrays of strings  
Length Constraints: Minimum length of 1. Maximum length of 255.

## Errors
<a name="API_ListMetrics_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## Examples
<a name="API_ListMetrics_Examples"></a>

### Sample Request
<a name="API_ListMetrics_Example_1"></a>

The following is an example request payload.

#### Sample Request
<a name="API_ListMetrics_Example_1_Request"></a>

```
{
  "dataSource": "Applications",
  "fields": [
    {
      "name": "Application Arn"
    }
  ]
}
```

### Sample Response
<a name="API_ListMetrics_Example_2"></a>

The following is an example response payload.

#### Sample Response
<a name="API_ListMetrics_Example_2_Response"></a>

```
{
  "headers": [
    "Application Arn"
  ],
  "rows": [
    [
      "arn:aws:resiliencehub:us-west-2:444455556666:app/dd058443-7e2f-410d-bee6-c634cb3edb39"
    ]
  ]
}
```

## See Also
<a name="API_ListMetrics_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListMetrics) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListMetrics) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListMetrics) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListMetrics) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListMetrics) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListMetrics) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListMetrics) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListMetrics) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListMetrics) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListMetrics) 

# ListRecommendationTemplates
<a name="API_ListRecommendationTemplates"></a>

Lists the recommendation templates for the AWS Resilience Hub applications.

## Request Syntax
<a name="API_ListRecommendationTemplates_RequestSyntax"></a>

```
GET /list-recommendation-templates?assessmentArn=assessmentArn&maxResults=maxResults&name=name&nextToken=nextToken&recommendationTemplateArn=recommendationTemplateArn&reverseOrder=reverseOrder&status=status HTTP/1.1
```

## URI Request Parameters
<a name="API_ListRecommendationTemplates_RequestParameters"></a>

The request uses the following URI parameters.

 ** [assessmentArn](#API_ListRecommendationTemplates_RequestSyntax) **   <a name="resiliencehub-ListRecommendationTemplates-request-uri-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [maxResults](#API_ListRecommendationTemplates_RequestSyntax) **   <a name="resiliencehub-ListRecommendationTemplates-request-uri-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Valid Range: Minimum value of 1. Maximum value of 100.

 ** [name](#API_ListRecommendationTemplates_RequestSyntax) **   <a name="resiliencehub-ListRecommendationTemplates-request-uri-name"></a>
The name for one of the listed recommendation templates.  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}` 

 ** [nextToken](#API_ListRecommendationTemplates_RequestSyntax) **   <a name="resiliencehub-ListRecommendationTemplates-request-uri-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Pattern: `\S{1,2000}` 

 ** [recommendationTemplateArn](#API_ListRecommendationTemplates_RequestSyntax) **   <a name="resiliencehub-ListRecommendationTemplates-request-uri-recommendationTemplateArn"></a>
The Amazon Resource Name (ARN) for a recommendation template.  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [reverseOrder](#API_ListRecommendationTemplates_RequestSyntax) **   <a name="resiliencehub-ListRecommendationTemplates-request-uri-reverseOrder"></a>
The default is to sort by ascending **startTime**. To sort by descending **startTime**, set reverseOrder to `true`.

 ** [status](#API_ListRecommendationTemplates_RequestSyntax) **   <a name="resiliencehub-ListRecommendationTemplates-request-uri-status"></a>
Status of the action.  
Array Members: Minimum number of 1 item. Maximum number of 4 items.  
Valid Values: `Pending | InProgress | Failed | Success` 

## Request Body
<a name="API_ListRecommendationTemplates_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListRecommendationTemplates_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "recommendationTemplates": [ 
      { 
         "appArn": "string",
         "assessmentArn": "string",
         "endTime": number,
         "format": "string",
         "message": "string",
         "name": "string",
         "needsReplacements": boolean,
         "recommendationIds": [ "string" ],
         "recommendationTemplateArn": "string",
         "recommendationTypes": [ "string" ],
         "startTime": number,
         "status": "string",
         "tags": { 
            "string" : "string" 
         },
         "templatesLocation": { 
            "bucket": "string",
            "prefix": "string"
         }
      }
   ]
}
```

## Response Elements
<a name="API_ListRecommendationTemplates_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListRecommendationTemplates_ResponseSyntax) **   <a name="resiliencehub-ListRecommendationTemplates-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

 ** [recommendationTemplates](#API_ListRecommendationTemplates_ResponseSyntax) **   <a name="resiliencehub-ListRecommendationTemplates-response-recommendationTemplates"></a>
The recommendation templates for the AWS Resilience Hub applications.  
Type: Array of [RecommendationTemplate](API_RecommendationTemplate.md) objects

## Errors
<a name="API_ListRecommendationTemplates_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListRecommendationTemplates_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListRecommendationTemplates) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListRecommendationTemplates) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListRecommendationTemplates) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListRecommendationTemplates) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListRecommendationTemplates) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListRecommendationTemplates) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListRecommendationTemplates) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListRecommendationTemplates) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListRecommendationTemplates) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListRecommendationTemplates) 

# ListResiliencyPolicies
<a name="API_ListResiliencyPolicies"></a>

Lists the resiliency policies for the AWS Resilience Hub applications.

## Request Syntax
<a name="API_ListResiliencyPolicies_RequestSyntax"></a>

```
GET /list-resiliency-policies?maxResults=maxResults&nextToken=nextToken&policyName=policyName HTTP/1.1
```

## URI Request Parameters
<a name="API_ListResiliencyPolicies_RequestParameters"></a>

The request uses the following URI parameters.

 ** [maxResults](#API_ListResiliencyPolicies_RequestSyntax) **   <a name="resiliencehub-ListResiliencyPolicies-request-uri-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Valid Range: Minimum value of 1. Maximum value of 100.

 ** [nextToken](#API_ListResiliencyPolicies_RequestSyntax) **   <a name="resiliencehub-ListResiliencyPolicies-request-uri-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Pattern: `\S{1,2000}` 

 ** [policyName](#API_ListResiliencyPolicies_RequestSyntax) **   <a name="resiliencehub-ListResiliencyPolicies-request-uri-policyName"></a>
Name of the resiliency policy.  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}` 

## Request Body
<a name="API_ListResiliencyPolicies_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListResiliencyPolicies_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "resiliencyPolicies": [ 
      { 
         "creationTime": number,
         "dataLocationConstraint": "string",
         "estimatedCostTier": "string",
         "policy": { 
            "string" : { 
               "rpoInSecs": number,
               "rtoInSecs": number
            }
         },
         "policyArn": "string",
         "policyDescription": "string",
         "policyName": "string",
         "tags": { 
            "string" : "string" 
         },
         "tier": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListResiliencyPolicies_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListResiliencyPolicies_ResponseSyntax) **   <a name="resiliencehub-ListResiliencyPolicies-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

 ** [resiliencyPolicies](#API_ListResiliencyPolicies_ResponseSyntax) **   <a name="resiliencehub-ListResiliencyPolicies-response-resiliencyPolicies"></a>
The resiliency policies for the AWS Resilience Hub applications.  
Type: Array of [ResiliencyPolicy](API_ResiliencyPolicy.md) objects

## Errors
<a name="API_ListResiliencyPolicies_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListResiliencyPolicies_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListResiliencyPolicies) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListResiliencyPolicies) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListResiliencyPolicies) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListResiliencyPolicies) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListResiliencyPolicies) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListResiliencyPolicies) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListResiliencyPolicies) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListResiliencyPolicies) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListResiliencyPolicies) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListResiliencyPolicies) 

# ListResourceGroupingRecommendations
<a name="API_ListResourceGroupingRecommendations"></a>

Lists the resource grouping recommendations suggested by AWS Resilience Hub for your application.

## Request Syntax
<a name="API_ListResourceGroupingRecommendations_RequestSyntax"></a>

```
GET /list-resource-grouping-recommendations?appArn=appArn&maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## URI Request Parameters
<a name="API_ListResourceGroupingRecommendations_RequestParameters"></a>

The request uses the following URI parameters.

 ** [appArn](#API_ListResourceGroupingRecommendations_RequestSyntax) **   <a name="resiliencehub-ListResourceGroupingRecommendations-request-uri-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [maxResults](#API_ListResourceGroupingRecommendations_RequestSyntax) **   <a name="resiliencehub-ListResourceGroupingRecommendations-request-uri-maxResults"></a>
Maximum number of grouping recommendations to be displayed per AWS Resilience Hub application.  
Valid Range: Minimum value of 1. Maximum value of 100.

 ** [nextToken](#API_ListResourceGroupingRecommendations_RequestSyntax) **   <a name="resiliencehub-ListResourceGroupingRecommendations-request-uri-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Pattern: `\S{1,2000}` 

## Request Body
<a name="API_ListResourceGroupingRecommendations_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListResourceGroupingRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "groupingRecommendations": [ 
      { 
         "confidenceLevel": "string",
         "creationTime": number,
         "groupingAppComponent": { 
            "appComponentId": "string",
            "appComponentName": "string",
            "appComponentType": "string"
         },
         "groupingRecommendationId": "string",
         "recommendationReasons": [ "string" ],
         "rejectionReason": "string",
         "resources": [ 
            { 
               "logicalResourceId": { 
                  "eksSourceName": "string",
                  "identifier": "string",
                  "logicalStackName": "string",
                  "resourceGroupName": "string",
                  "terraformSourceName": "string"
               },
               "physicalResourceId": { 
                  "awsAccountId": "string",
                  "awsRegion": "string",
                  "identifier": "string",
                  "type": "string"
               },
               "resourceName": "string",
               "resourceType": "string",
               "sourceAppComponentIds": [ "string" ]
            }
         ],
         "score": number,
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_ListResourceGroupingRecommendations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [groupingRecommendations](#API_ListResourceGroupingRecommendations_ResponseSyntax) **   <a name="resiliencehub-ListResourceGroupingRecommendations-response-groupingRecommendations"></a>
List of resource grouping recommendations generated by AWS Resilience Hub.  
Type: Array of [GroupingRecommendation](API_GroupingRecommendation.md) objects

 ** [nextToken](#API_ListResourceGroupingRecommendations_ResponseSyntax) **   <a name="resiliencehub-ListResourceGroupingRecommendations-response-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}` 

## Errors
<a name="API_ListResourceGroupingRecommendations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListResourceGroupingRecommendations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListResourceGroupingRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListResourceGroupingRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListResourceGroupingRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListResourceGroupingRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListResourceGroupingRecommendations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListResourceGroupingRecommendations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListResourceGroupingRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListResourceGroupingRecommendations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListResourceGroupingRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListResourceGroupingRecommendations) 

# ListSopRecommendations
<a name="API_ListSopRecommendations"></a>

Lists the standard operating procedure (SOP) recommendations for the AWS Resilience Hub applications.

## Request Syntax
<a name="API_ListSopRecommendations_RequestSyntax"></a>

```
POST /list-sop-recommendations HTTP/1.1
Content-type: application/json

{
   "assessmentArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListSopRecommendations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListSopRecommendations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentArn](#API_ListSopRecommendations_RequestSyntax) **   <a name="resiliencehub-ListSopRecommendations-request-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [maxResults](#API_ListSopRecommendations_RequestSyntax) **   <a name="resiliencehub-ListSopRecommendations-request-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListSopRecommendations_RequestSyntax) **   <a name="resiliencehub-ListSopRecommendations-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

## Response Syntax
<a name="API_ListSopRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "sopRecommendations": [ 
      { 
         "appComponentName": "string",
         "description": "string",
         "items": [ 
            { 
               "alreadyImplemented": boolean,
               "discoveredAlarm": { 
                  "alarmArn": "string",
                  "source": "string"
               },
               "excluded": boolean,
               "excludeReason": "string",
               "latestDiscoveredExperiment": { 
                  "experimentArn": "string",
                  "experimentTemplateId": "string"
               },
               "resourceId": "string",
               "targetAccountId": "string",
               "targetRegion": "string"
            }
         ],
         "name": "string",
         "prerequisite": "string",
         "recommendationId": "string",
         "recommendationStatus": "string",
         "referenceId": "string",
         "serviceType": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListSopRecommendations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListSopRecommendations_ResponseSyntax) **   <a name="resiliencehub-ListSopRecommendations-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

 ** [sopRecommendations](#API_ListSopRecommendations_ResponseSyntax) **   <a name="resiliencehub-ListSopRecommendations-response-sopRecommendations"></a>
The standard operating procedure (SOP) recommendations for the AWS Resilience Hub applications.  
Type: Array of [SopRecommendation](API_SopRecommendation.md) objects

## Errors
<a name="API_ListSopRecommendations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListSopRecommendations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListSopRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListSopRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListSopRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListSopRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListSopRecommendations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListSopRecommendations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListSopRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListSopRecommendations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListSopRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListSopRecommendations) 

# ListSuggestedResiliencyPolicies
<a name="API_ListSuggestedResiliencyPolicies"></a>

Lists the suggested resiliency policies for the AWS Resilience Hub applications.

## Request Syntax
<a name="API_ListSuggestedResiliencyPolicies_RequestSyntax"></a>

```
GET /list-suggested-resiliency-policies?maxResults=maxResults&nextToken=nextToken HTTP/1.1
```

## URI Request Parameters
<a name="API_ListSuggestedResiliencyPolicies_RequestParameters"></a>

The request uses the following URI parameters.

 ** [maxResults](#API_ListSuggestedResiliencyPolicies_RequestSyntax) **   <a name="resiliencehub-ListSuggestedResiliencyPolicies-request-uri-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Valid Range: Minimum value of 1. Maximum value of 100.

 ** [nextToken](#API_ListSuggestedResiliencyPolicies_RequestSyntax) **   <a name="resiliencehub-ListSuggestedResiliencyPolicies-request-uri-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Pattern: `\S{1,2000}` 

## Request Body
<a name="API_ListSuggestedResiliencyPolicies_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListSuggestedResiliencyPolicies_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "resiliencyPolicies": [ 
      { 
         "creationTime": number,
         "dataLocationConstraint": "string",
         "estimatedCostTier": "string",
         "policy": { 
            "string" : { 
               "rpoInSecs": number,
               "rtoInSecs": number
            }
         },
         "policyArn": "string",
         "policyDescription": "string",
         "policyName": "string",
         "tags": { 
            "string" : "string" 
         },
         "tier": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListSuggestedResiliencyPolicies_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListSuggestedResiliencyPolicies_ResponseSyntax) **   <a name="resiliencehub-ListSuggestedResiliencyPolicies-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

 ** [resiliencyPolicies](#API_ListSuggestedResiliencyPolicies_ResponseSyntax) **   <a name="resiliencehub-ListSuggestedResiliencyPolicies-response-resiliencyPolicies"></a>
The suggested resiliency policies for the AWS Resilience Hub applications.  
Type: Array of [ResiliencyPolicy](API_ResiliencyPolicy.md) objects

## Errors
<a name="API_ListSuggestedResiliencyPolicies_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListSuggestedResiliencyPolicies_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListSuggestedResiliencyPolicies) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListSuggestedResiliencyPolicies) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListSuggestedResiliencyPolicies) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListSuggestedResiliencyPolicies) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListSuggestedResiliencyPolicies) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListSuggestedResiliencyPolicies) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListSuggestedResiliencyPolicies) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListSuggestedResiliencyPolicies) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListSuggestedResiliencyPolicies) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListSuggestedResiliencyPolicies) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Lists the tags for your resources in your AWS Resilience Hub applications.

## Request Syntax
<a name="API_ListTagsForResource_RequestSyntax"></a>

```
GET /tags/resourceArn HTTP/1.1
```

## URI Request Parameters
<a name="API_ListTagsForResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="resiliencehub-ListTagsForResource-request-uri-resourceArn"></a>
The Amazon Resource Name (ARN) for a specific resource in your AWS Resilience Hub application.  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

## Request Body
<a name="API_ListTagsForResource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_ListTagsForResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "tags": { 
      "string" : "string" 
   }
}
```

## Response Elements
<a name="API_ListTagsForResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="resiliencehub-ListTagsForResource-response-tags"></a>
Tags assigned to the resource. A tag is a label that you assign to an AWS resource. Each tag consists of a key/value pair.  
Type: String to string map  
Map Entries: Maximum number of 50 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[^\x00-\x1f\x22]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[^\x00-\x1f\x22]*` 

## Errors
<a name="API_ListTagsForResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListTagsForResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListTagsForResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListTagsForResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListTagsForResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListTagsForResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListTagsForResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListTagsForResource) 

# ListTestRecommendations
<a name="API_ListTestRecommendations"></a>

Lists the test recommendations for the AWS Resilience Hub application.

## Request Syntax
<a name="API_ListTestRecommendations_RequestSyntax"></a>

```
POST /list-test-recommendations HTTP/1.1
Content-type: application/json

{
   "assessmentArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## URI Request Parameters
<a name="API_ListTestRecommendations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListTestRecommendations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [assessmentArn](#API_ListTestRecommendations_RequestSyntax) **   <a name="resiliencehub-ListTestRecommendations-request-assessmentArn"></a>
Amazon Resource Name (ARN) of the assessment. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app-assessment/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [maxResults](#API_ListTestRecommendations_RequestSyntax) **   <a name="resiliencehub-ListTestRecommendations-request-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListTestRecommendations_RequestSyntax) **   <a name="resiliencehub-ListTestRecommendations-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

## Response Syntax
<a name="API_ListTestRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "testRecommendations": [ 
      { 
         "appComponentId": "string",
         "appComponentName": "string",
         "dependsOnAlarms": [ "string" ],
         "description": "string",
         "intent": "string",
         "items": [ 
            { 
               "alreadyImplemented": boolean,
               "discoveredAlarm": { 
                  "alarmArn": "string",
                  "source": "string"
               },
               "excluded": boolean,
               "excludeReason": "string",
               "latestDiscoveredExperiment": { 
                  "experimentArn": "string",
                  "experimentTemplateId": "string"
               },
               "resourceId": "string",
               "targetAccountId": "string",
               "targetRegion": "string"
            }
         ],
         "name": "string",
         "prerequisite": "string",
         "recommendationId": "string",
         "recommendationStatus": "string",
         "referenceId": "string",
         "risk": "string",
         "type": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListTestRecommendations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListTestRecommendations_ResponseSyntax) **   <a name="resiliencehub-ListTestRecommendations-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

 ** [testRecommendations](#API_ListTestRecommendations_ResponseSyntax) **   <a name="resiliencehub-ListTestRecommendations-response-testRecommendations"></a>
The test recommendations for the AWS Resilience Hub application.  
Type: Array of [TestRecommendation](API_TestRecommendation.md) objects

## Errors
<a name="API_ListTestRecommendations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListTestRecommendations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListTestRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListTestRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListTestRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListTestRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListTestRecommendations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListTestRecommendations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListTestRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListTestRecommendations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListTestRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListTestRecommendations) 

# ListUnsupportedAppVersionResources
<a name="API_ListUnsupportedAppVersionResources"></a>

Lists the resources that are not currently supported in AWS Resilience Hub. An unsupported resource is a resource that exists in the object that was used to create an app, but is not supported by AWS Resilience Hub.

## Request Syntax
<a name="API_ListUnsupportedAppVersionResources_RequestSyntax"></a>

```
POST /list-unsupported-app-version-resources HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "maxResults": number,
   "nextToken": "string",
   "resolutionId": "string"
}
```

## URI Request Parameters
<a name="API_ListUnsupportedAppVersionResources_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ListUnsupportedAppVersionResources_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_ListUnsupportedAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ListUnsupportedAppVersionResources-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_ListUnsupportedAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ListUnsupportedAppVersionResources-request-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

 ** [maxResults](#API_ListUnsupportedAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ListUnsupportedAppVersionResources-request-maxResults"></a>
Maximum number of results to include in the response. If more results exist than the specified `MaxResults` value, a token is included in the response so that the remaining results can be retrieved.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [nextToken](#API_ListUnsupportedAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ListUnsupportedAppVersionResources-request-nextToken"></a>
Null, or the token from a previous call to get the next set of results.  
Type: String  
Pattern: `\S{1,2000}`   
Required: No

 ** [resolutionId](#API_ListUnsupportedAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ListUnsupportedAppVersionResources-request-resolutionId"></a>
The identifier for a specific resolution.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

## Response Syntax
<a name="API_ListUnsupportedAppVersionResources_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "resolutionId": "string",
   "unsupportedResources": [ 
      { 
         "logicalResourceId": { 
            "eksSourceName": "string",
            "identifier": "string",
            "logicalStackName": "string",
            "resourceGroupName": "string",
            "terraformSourceName": "string"
         },
         "physicalResourceId": { 
            "awsAccountId": "string",
            "awsRegion": "string",
            "identifier": "string",
            "type": "string"
         },
         "resourceType": "string",
         "unsupportedResourceStatus": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListUnsupportedAppVersionResources_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [nextToken](#API_ListUnsupportedAppVersionResources_ResponseSyntax) **   <a name="resiliencehub-ListUnsupportedAppVersionResources-response-nextToken"></a>
Token for the next set of results, or null if there are no more results.  
Type: String  
Pattern: `\S{1,2000}` 

 ** [resolutionId](#API_ListUnsupportedAppVersionResources_ResponseSyntax) **   <a name="resiliencehub-ListUnsupportedAppVersionResources-response-resolutionId"></a>
The identifier for a specific resolution.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.

 ** [unsupportedResources](#API_ListUnsupportedAppVersionResources_ResponseSyntax) **   <a name="resiliencehub-ListUnsupportedAppVersionResources-response-unsupportedResources"></a>
The unsupported resources for the application.  
Type: Array of [UnsupportedResource](API_UnsupportedResource.md) objects

## Errors
<a name="API_ListUnsupportedAppVersionResources_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ListUnsupportedAppVersionResources_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ListUnsupportedAppVersionResources) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ListUnsupportedAppVersionResources) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ListUnsupportedAppVersionResources) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ListUnsupportedAppVersionResources) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ListUnsupportedAppVersionResources) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ListUnsupportedAppVersionResources) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ListUnsupportedAppVersionResources) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ListUnsupportedAppVersionResources) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ListUnsupportedAppVersionResources) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ListUnsupportedAppVersionResources) 

# PublishAppVersion
<a name="API_PublishAppVersion"></a>

Publishes a new version of a specific AWS Resilience Hub application.

## Request Syntax
<a name="API_PublishAppVersion_RequestSyntax"></a>

```
POST /publish-app-version HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "versionName": "string"
}
```

## URI Request Parameters
<a name="API_PublishAppVersion_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_PublishAppVersion_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_PublishAppVersion_RequestSyntax) **   <a name="resiliencehub-PublishAppVersion-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [versionName](#API_PublishAppVersion_RequestSyntax) **   <a name="resiliencehub-PublishAppVersion-request-versionName"></a>
Name of the application version.  
Type: String  
Pattern: `\S{1,50}`   
Required: No

## Response Syntax
<a name="API_PublishAppVersion_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "identifier": number,
   "versionName": "string"
}
```

## Response Elements
<a name="API_PublishAppVersion_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_PublishAppVersion_ResponseSyntax) **   <a name="resiliencehub-PublishAppVersion-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_PublishAppVersion_ResponseSyntax) **   <a name="resiliencehub-PublishAppVersion-response-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}` 

 ** [identifier](#API_PublishAppVersion_ResponseSyntax) **   <a name="resiliencehub-PublishAppVersion-response-identifier"></a>
Identifier of the application version.  
Type: Long

 ** [versionName](#API_PublishAppVersion_ResponseSyntax) **   <a name="resiliencehub-PublishAppVersion-response-versionName"></a>
Name of the application version.  
Type: String  
Pattern: `\S{1,50}` 

## Errors
<a name="API_PublishAppVersion_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_PublishAppVersion_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/PublishAppVersion) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/PublishAppVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/PublishAppVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/PublishAppVersion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/PublishAppVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/PublishAppVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/PublishAppVersion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/PublishAppVersion) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/PublishAppVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/PublishAppVersion) 

# PutDraftAppVersionTemplate
<a name="API_PutDraftAppVersionTemplate"></a>

Adds or updates the app template for an AWS Resilience Hub application draft version.

**Note**  
 AWS Resilience Hub blocks manual grouping and automatically groups certain resources based on their dependencies and configurations to prevent configuration errors and ensure accurate resilience assessment results. For more information, see [Managing Application Components](https://docs.aws.amazon.com/resilience-hub/latest/userguide/AppComponent.html).

## Request Syntax
<a name="API_PutDraftAppVersionTemplate_RequestSyntax"></a>

```
POST /put-draft-app-version-template HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appTemplateBody": "string"
}
```

## URI Request Parameters
<a name="API_PutDraftAppVersionTemplate_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_PutDraftAppVersionTemplate_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_PutDraftAppVersionTemplate_RequestSyntax) **   <a name="resiliencehub-PutDraftAppVersionTemplate-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appTemplateBody](#API_PutDraftAppVersionTemplate_RequestSyntax) **   <a name="resiliencehub-PutDraftAppVersionTemplate-request-appTemplateBody"></a>
A JSON string that provides information about your application structure. To learn more about the `appTemplateBody` template, see the sample template provided in the *Examples* section.  
The `appTemplateBody` JSON string has the following structure:  
+  ** `resources` ** 

  The list of logical resources that must be included in the AWS Resilience Hub application.

  Type: Array
**Note**  
Don't add the resources that you want to exclude.

  Each `resources` array item includes the following fields:
  +  * `logicalResourceId` * 

    Logical identifier of the resource.

    Type: Object

    Each `logicalResourceId` object includes the following fields:
    +  `identifier` 

      Identifier of the resource.

      Type: String
    +  `logicalStackName` 

      The name of the AWS CloudFormation stack this resource belongs to.

      Type: String
    +  `resourceGroupName` 

      The name of the resource group this resource belongs to.

      Type: String
    +  `terraformSourceName` 

      The name of the Terraform S3 state file this resource belongs to.

      Type: String
    +  `eksSourceName` 

      Name of the Amazon Elastic Kubernetes Service cluster and namespace this resource belongs to.
**Note**  
This parameter accepts values in "eks-cluster/namespace" format.

      Type: String
  +  * `type` * 

    The type of resource.

    Type: string
  +  * `name` * 

    The name of the resource.

    Type: String
  +  `additionalInfo` 

    Additional configuration parameters for an AWS Resilience Hub application. If you want to implement `additionalInfo` through the AWS Resilience Hub console rather than using an API call, see [Configure the application configuration parameters](https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html).
**Note**  
Currently, this parameter accepts a key-value mapping (in a string format) of only one failover region and one associated account.  
Key: `"failover-regions"`   
Value: `"[{"region":"<REGION>", "accounts":[{"id":"<ACCOUNT_ID>"}]}]"` 
+  ** `appComponents` ** 

  List of AppComponents that this resource belongs to. If an AppComponent is not part of the AWS Resilience Hub application, it will be added.

  Type: Array

  Each `appComponents` array item includes the following fields:
  +  `name` 

    Name of the AppComponent.

    Type: String
  +  `type` 

    Type of AppComponent. For more information about the types of AppComponent, see [Grouping resources in an AppComponent](https://docs.aws.amazon.com/resilience-hub/latest/userguide/AppComponent.grouping.html).

    Type: String
  +  `resourceNames` 

    The list of included resources that are assigned to the AppComponent.

    Type: Array of strings
  +  `additionalInfo` 

    Additional configuration parameters for an AWS Resilience Hub application. If you want to implement `additionalInfo` through the AWS Resilience Hub console rather than using an API call, see [Configure the application configuration parameters](https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html).
**Note**  
Currently, this parameter accepts a key-value mapping (in a string format) of only one failover region and one associated account.  
Key: `"failover-regions"`   
Value: `"[{"region":"<REGION>", "accounts":[{"id":"<ACCOUNT_ID>"}]}]"` 
+  ** `excludedResources` ** 

  The list of logical resource identifiers to be excluded from the application.

  Type: Array
**Note**  
Don't add the resources that you want to include.

  Each `excludedResources` array item includes the following fields:
  +  * `logicalResourceIds` * 

    Logical identifier of the resource.

    Type: Object
**Note**  
You can configure only one of the following fields:  
 `logicalStackName` 
 `resourceGroupName` 
 `terraformSourceName` 
 `eksSourceName` 

    Each `logicalResourceIds` object includes the following fields:
    +  `identifier` 

      Identifier of the resource.

      Type: String
    +  `logicalStackName` 

      The name of the AWS CloudFormation stack this resource belongs to.

      Type: String
    +  `resourceGroupName` 

      The name of the resource group this resource belongs to.

      Type: String
    +  `terraformSourceName` 

      The name of the Terraform S3 state file this resource belongs to.

      Type: String
    +  `eksSourceName` 

      Name of the Amazon Elastic Kubernetes Service cluster and namespace this resource belongs to.
**Note**  
This parameter accepts values in "eks-cluster/namespace" format.

      Type: String
+  ** `version` ** 

   AWS Resilience Hub application version.
+  `additionalInfo` 

  Additional configuration parameters for an AWS Resilience Hub application. If you want to implement `additionalInfo` through the AWS Resilience Hub console rather than using an API call, see [Configure the application configuration parameters](https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html).
**Note**  
Currently, this parameter accepts a key-value mapping (in a string format) of only one failover region and one associated account.  
Key: `"failover-regions"`   
Value: `"[{"region":"<REGION>", "accounts":[{"id":"<ACCOUNT_ID>"}]}]"` 
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 409600.  
Pattern: `[\w\s:,-\.'\/{}\[\]:"\\]+`   
Required: Yes

## Response Syntax
<a name="API_PutDraftAppVersionTemplate_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string"
}
```

## Response Elements
<a name="API_PutDraftAppVersionTemplate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_PutDraftAppVersionTemplate_ResponseSyntax) **   <a name="resiliencehub-PutDraftAppVersionTemplate-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_PutDraftAppVersionTemplate_ResponseSyntax) **   <a name="resiliencehub-PutDraftAppVersionTemplate-response-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}` 

## Errors
<a name="API_PutDraftAppVersionTemplate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## Examples
<a name="API_PutDraftAppVersionTemplate_Examples"></a>

### Sample appTemplateBody template
<a name="API_PutDraftAppVersionTemplate_Example_1"></a>

This example illustrates one usage of PutDraftAppVersionTemplate.

```
{
	"resources": [{
		"logicalResourceId": {
			"identifier": "testResourceID1",
			"logicalStackName": "testResourceStack1",
			"resourceGroupName": null
		},
		"type": "AWS::RDS::DBInstance",
		"name": "testResourceName"
	}],
	"appComponents": [{
			"name": "testappcomponent-test",
			"type": "AWS::ResilienceHub::AppComponent",
			"resourceNames": [
				"testResourceName"
			]
		},
		{
			"name": "testappcommon",
			"type": "AWS::ResilienceHub::AppComponent",
			"resourceNames": "[testResourceName]"
		}
	],
	"excludedResources": {
		"logicalResourceIds": [{
			"identifier": "testResourceID2",
			"logicalStackName": "testResourceStack2",
			"resourceGroupName": ""
		}]
	},
	"version": 2.0
}
```

## See Also
<a name="API_PutDraftAppVersionTemplate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/PutDraftAppVersionTemplate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/PutDraftAppVersionTemplate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/PutDraftAppVersionTemplate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/PutDraftAppVersionTemplate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/PutDraftAppVersionTemplate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/PutDraftAppVersionTemplate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/PutDraftAppVersionTemplate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/PutDraftAppVersionTemplate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/PutDraftAppVersionTemplate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/PutDraftAppVersionTemplate) 

# RejectResourceGroupingRecommendations
<a name="API_RejectResourceGroupingRecommendations"></a>

Rejects resource grouping recommendations.

## Request Syntax
<a name="API_RejectResourceGroupingRecommendations_RequestSyntax"></a>

```
POST /reject-resource-grouping-recommendations HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "entries": [ 
      { 
         "groupingRecommendationId": "string",
         "rejectionReason": "string"
      }
   ]
}
```

## URI Request Parameters
<a name="API_RejectResourceGroupingRecommendations_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_RejectResourceGroupingRecommendations_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_RejectResourceGroupingRecommendations_RequestSyntax) **   <a name="resiliencehub-RejectResourceGroupingRecommendations-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [entries](#API_RejectResourceGroupingRecommendations_RequestSyntax) **   <a name="resiliencehub-RejectResourceGroupingRecommendations-request-entries"></a>
List of resource grouping recommendations you have selected to exclude from your application.  
Type: Array of [RejectGroupingRecommendationEntry](API_RejectGroupingRecommendationEntry.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 30 items.  
Required: Yes

## Response Syntax
<a name="API_RejectResourceGroupingRecommendations_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "failedEntries": [ 
      { 
         "errorMessage": "string",
         "groupingRecommendationId": "string"
      }
   ]
}
```

## Response Elements
<a name="API_RejectResourceGroupingRecommendations_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_RejectResourceGroupingRecommendations_ResponseSyntax) **   <a name="resiliencehub-RejectResourceGroupingRecommendations-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [failedEntries](#API_RejectResourceGroupingRecommendations_ResponseSyntax) **   <a name="resiliencehub-RejectResourceGroupingRecommendations-response-failedEntries"></a>
List of resource grouping recommendations that failed to get excluded in your application.  
Type: Array of [FailedGroupingRecommendationEntry](API_FailedGroupingRecommendationEntry.md) objects

## Errors
<a name="API_RejectResourceGroupingRecommendations_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_RejectResourceGroupingRecommendations_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/RejectResourceGroupingRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/RejectResourceGroupingRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/RejectResourceGroupingRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/RejectResourceGroupingRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/RejectResourceGroupingRecommendations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/RejectResourceGroupingRecommendations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/RejectResourceGroupingRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/RejectResourceGroupingRecommendations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/RejectResourceGroupingRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/RejectResourceGroupingRecommendations) 

# RemoveDraftAppVersionResourceMappings
<a name="API_RemoveDraftAppVersionResourceMappings"></a>

Removes resource mappings from a draft application version.

## Request Syntax
<a name="API_RemoveDraftAppVersionResourceMappings_RequestSyntax"></a>

```
POST /remove-draft-app-version-resource-mappings HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appRegistryAppNames": [ "string" ],
   "eksSourceNames": [ "string" ],
   "logicalStackNames": [ "string" ],
   "resourceGroupNames": [ "string" ],
   "resourceNames": [ "string" ],
   "terraformSourceNames": [ "string" ]
}
```

## URI Request Parameters
<a name="API_RemoveDraftAppVersionResourceMappings_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_RemoveDraftAppVersionResourceMappings_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_RemoveDraftAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-RemoveDraftAppVersionResourceMappings-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appRegistryAppNames](#API_RemoveDraftAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-RemoveDraftAppVersionResourceMappings-request-appRegistryAppNames"></a>
The names of the registered applications you want to remove from the resource mappings.  
Type: Array of strings  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: No

 ** [eksSourceNames](#API_RemoveDraftAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-RemoveDraftAppVersionResourceMappings-request-eksSourceNames"></a>
The names of the Amazon Elastic Kubernetes Service clusters and namespaces you want to remove from the resource mappings.  
This parameter accepts values in "eks-cluster/namespace" format.
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** [logicalStackNames](#API_RemoveDraftAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-RemoveDraftAppVersionResourceMappings-request-logicalStackNames"></a>
The names of the CloudFormation stacks you want to remove from the resource mappings.  
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** [resourceGroupNames](#API_RemoveDraftAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-RemoveDraftAppVersionResourceMappings-request-resourceGroupNames"></a>
The names of the resource groups you want to remove from the resource mappings.  
Type: Array of strings  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: No

 ** [resourceNames](#API_RemoveDraftAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-RemoveDraftAppVersionResourceMappings-request-resourceNames"></a>
The names of the resources you want to remove from the resource mappings.  
Type: Array of strings  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: No

 ** [terraformSourceNames](#API_RemoveDraftAppVersionResourceMappings_RequestSyntax) **   <a name="resiliencehub-RemoveDraftAppVersionResourceMappings-request-terraformSourceNames"></a>
The names of the Terraform sources you want to remove from the resource mappings.  
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

## Response Syntax
<a name="API_RemoveDraftAppVersionResourceMappings_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string"
}
```

## Response Elements
<a name="API_RemoveDraftAppVersionResourceMappings_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_RemoveDraftAppVersionResourceMappings_ResponseSyntax) **   <a name="resiliencehub-RemoveDraftAppVersionResourceMappings-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_RemoveDraftAppVersionResourceMappings_ResponseSyntax) **   <a name="resiliencehub-RemoveDraftAppVersionResourceMappings-response-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}` 

## Errors
<a name="API_RemoveDraftAppVersionResourceMappings_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_RemoveDraftAppVersionResourceMappings_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/RemoveDraftAppVersionResourceMappings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/RemoveDraftAppVersionResourceMappings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/RemoveDraftAppVersionResourceMappings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/RemoveDraftAppVersionResourceMappings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/RemoveDraftAppVersionResourceMappings) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/RemoveDraftAppVersionResourceMappings) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/RemoveDraftAppVersionResourceMappings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/RemoveDraftAppVersionResourceMappings) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/RemoveDraftAppVersionResourceMappings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/RemoveDraftAppVersionResourceMappings) 

# ResolveAppVersionResources
<a name="API_ResolveAppVersionResources"></a>

Resolves the resources for an application version.

## Request Syntax
<a name="API_ResolveAppVersionResources_RequestSyntax"></a>

```
POST /resolve-app-version-resources HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string"
}
```

## URI Request Parameters
<a name="API_ResolveAppVersionResources_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_ResolveAppVersionResources_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_ResolveAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ResolveAppVersionResources-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_ResolveAppVersionResources_RequestSyntax) **   <a name="resiliencehub-ResolveAppVersionResources-request-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

## Response Syntax
<a name="API_ResolveAppVersionResources_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "resolutionId": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_ResolveAppVersionResources_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_ResolveAppVersionResources_ResponseSyntax) **   <a name="resiliencehub-ResolveAppVersionResources-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_ResolveAppVersionResources_ResponseSyntax) **   <a name="resiliencehub-ResolveAppVersionResources-response-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}` 

 ** [resolutionId](#API_ResolveAppVersionResources_ResponseSyntax) **   <a name="resiliencehub-ResolveAppVersionResources-response-resolutionId"></a>
The identifier for a specific resolution.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.

 ** [status](#API_ResolveAppVersionResources_ResponseSyntax) **   <a name="resiliencehub-ResolveAppVersionResources-response-status"></a>
Status of the action.  
Type: String  
Valid Values: `Pending | InProgress | Failed | Success` 

## Errors
<a name="API_ResolveAppVersionResources_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_ResolveAppVersionResources_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/ResolveAppVersionResources) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/ResolveAppVersionResources) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/ResolveAppVersionResources) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/ResolveAppVersionResources) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/ResolveAppVersionResources) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/ResolveAppVersionResources) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/ResolveAppVersionResources) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/ResolveAppVersionResources) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/ResolveAppVersionResources) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/ResolveAppVersionResources) 

# StartAppAssessment
<a name="API_StartAppAssessment"></a>

Creates a new application assessment for an application.

## Request Syntax
<a name="API_StartAppAssessment_RequestSyntax"></a>

```
POST /start-app-assessment HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "assessmentName": "string",
   "clientToken": "string",
   "tags": { 
      "string" : "string" 
   }
}
```

## URI Request Parameters
<a name="API_StartAppAssessment_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_StartAppAssessment_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_StartAppAssessment_RequestSyntax) **   <a name="resiliencehub-StartAppAssessment-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appVersion](#API_StartAppAssessment_RequestSyntax) **   <a name="resiliencehub-StartAppAssessment-request-appVersion"></a>
The version of the application.  
Type: String  
Pattern: `\S{1,50}`   
Required: Yes

 ** [assessmentName](#API_StartAppAssessment_RequestSyntax) **   <a name="resiliencehub-StartAppAssessment-request-assessmentName"></a>
The name for the assessment.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: Yes

 ** [clientToken](#API_StartAppAssessment_RequestSyntax) **   <a name="resiliencehub-StartAppAssessment-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

 ** [tags](#API_StartAppAssessment_RequestSyntax) **   <a name="resiliencehub-StartAppAssessment-request-tags"></a>
Tags assigned to the resource. A tag is a label that you assign to an AWS resource. Each tag consists of a key/value pair.  
Type: String to string map  
Map Entries: Maximum number of 50 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[^\x00-\x1f\x22]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[^\x00-\x1f\x22]*`   
Required: No

## Response Syntax
<a name="API_StartAppAssessment_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "assessment": { 
      "appArn": "string",
      "appVersion": "string",
      "assessmentArn": "string",
      "assessmentName": "string",
      "assessmentStatus": "string",
      "compliance": { 
         "string" : { 
            "achievableRpoInSecs": number,
            "achievableRtoInSecs": number,
            "complianceStatus": "string",
            "currentRpoInSecs": number,
            "currentRtoInSecs": number,
            "message": "string",
            "rpoDescription": "string",
            "rpoReferenceId": "string",
            "rtoDescription": "string",
            "rtoReferenceId": "string"
         }
      },
      "complianceStatus": "string",
      "cost": { 
         "amount": number,
         "currency": "string",
         "frequency": "string"
      },
      "driftStatus": "string",
      "endTime": number,
      "invoker": "string",
      "message": "string",
      "policy": { 
         "creationTime": number,
         "dataLocationConstraint": "string",
         "estimatedCostTier": "string",
         "policy": { 
            "string" : { 
               "rpoInSecs": number,
               "rtoInSecs": number
            }
         },
         "policyArn": "string",
         "policyDescription": "string",
         "policyName": "string",
         "tags": { 
            "string" : "string" 
         },
         "tier": "string"
      },
      "resiliencyScore": { 
         "componentScore": { 
            "string" : { 
               "excludedCount": number,
               "outstandingCount": number,
               "possibleScore": number,
               "score": number
            }
         },
         "disruptionScore": { 
            "string" : number 
         },
         "score": number
      },
      "resourceErrorsDetails": { 
         "hasMoreErrors": boolean,
         "resourceErrors": [ 
            { 
               "logicalResourceId": "string",
               "physicalResourceId": "string",
               "reason": "string"
            }
         ]
      },
      "startTime": number,
      "summary": { 
         "riskRecommendations": [ 
            { 
               "appComponents": [ "string" ],
               "recommendation": "string",
               "risk": "string"
            }
         ],
         "summary": "string"
      },
      "tags": { 
         "string" : "string" 
      },
      "versionName": "string"
   }
}
```

## Response Elements
<a name="API_StartAppAssessment_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [assessment](#API_StartAppAssessment_ResponseSyntax) **   <a name="resiliencehub-StartAppAssessment-response-assessment"></a>
The assessment created.  
Type: [AppAssessment](API_AppAssessment.md) object

## Errors
<a name="API_StartAppAssessment_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ServiceQuotaExceededException **   
This exception occurs when you have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.  
HTTP Status Code: 402

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_StartAppAssessment_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/StartAppAssessment) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/StartAppAssessment) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/StartAppAssessment) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/StartAppAssessment) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/StartAppAssessment) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/StartAppAssessment) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/StartAppAssessment) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/StartAppAssessment) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/StartAppAssessment) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/StartAppAssessment) 

# StartMetricsExport
<a name="API_StartMetricsExport"></a>

Initiates the export task of metrics.

## Request Syntax
<a name="API_StartMetricsExport_RequestSyntax"></a>

```
POST /start-metrics-export HTTP/1.1
Content-type: application/json

{
   "bucketName": "string",
   "clientToken": "string"
}
```

## URI Request Parameters
<a name="API_StartMetricsExport_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_StartMetricsExport_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [bucketName](#API_StartMetricsExport_RequestSyntax) **   <a name="resiliencehub-StartMetricsExport-request-bucketName"></a>
(Optional) Specifies the name of the Amazon Simple Storage Service bucket where the exported metrics will be stored.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: No

 ** [clientToken](#API_StartMetricsExport_RequestSyntax) **   <a name="resiliencehub-StartMetricsExport-request-clientToken"></a>
Used for an idempotency token. A client token is a unique, case-sensitive string of up to 64 ASCII characters. You should not reuse the same client token for other API requests.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 63.  
Pattern: `[A-Za-z0-9_.-]{0,63}`   
Required: No

## Response Syntax
<a name="API_StartMetricsExport_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "metricsExportId": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_StartMetricsExport_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [metricsExportId](#API_StartMetricsExport_ResponseSyntax) **   <a name="resiliencehub-StartMetricsExport-response-metricsExportId"></a>
Identifier of the metrics export task.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.

 ** [status](#API_StartMetricsExport_ResponseSyntax) **   <a name="resiliencehub-StartMetricsExport-response-status"></a>
Indicates the status of the metrics export task.  
Type: String  
Valid Values: `Pending | InProgress | Failed | Success` 

## Errors
<a name="API_StartMetricsExport_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ServiceQuotaExceededException **   
This exception occurs when you have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.  
HTTP Status Code: 402

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## Examples
<a name="API_StartMetricsExport_Examples"></a>

### Example
<a name="API_StartMetricsExport_Example_1"></a>

The following is an example request payload.

#### Sample Request
<a name="API_StartMetricsExport_Example_1_Request"></a>

```
{
  "bucketName": "my-bucket-name"
}
```

### Example
<a name="API_StartMetricsExport_Example_2"></a>

The following is an example response payload.

#### Sample Response
<a name="API_StartMetricsExport_Example_2_Response"></a>

```
{
  "metricsExportId": "fe0e1e00-03eb-11ee-8796-02038f8a9691",
  "status": "Pending"
}
```

## See Also
<a name="API_StartMetricsExport_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/StartMetricsExport) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/StartMetricsExport) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/StartMetricsExport) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/StartMetricsExport) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/StartMetricsExport) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/StartMetricsExport) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/StartMetricsExport) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/StartMetricsExport) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/StartMetricsExport) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/StartMetricsExport) 

# StartResourceGroupingRecommendationTask
<a name="API_StartResourceGroupingRecommendationTask"></a>

Starts grouping recommendation task.

## Request Syntax
<a name="API_StartResourceGroupingRecommendationTask_RequestSyntax"></a>

```
POST /start-resource-grouping-recommendation-task HTTP/1.1
Content-type: application/json

{
   "appArn": "string"
}
```

## URI Request Parameters
<a name="API_StartResourceGroupingRecommendationTask_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_StartResourceGroupingRecommendationTask_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_StartResourceGroupingRecommendationTask_RequestSyntax) **   <a name="resiliencehub-StartResourceGroupingRecommendationTask-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_StartResourceGroupingRecommendationTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "errorMessage": "string",
   "groupingId": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_StartResourceGroupingRecommendationTask_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_StartResourceGroupingRecommendationTask_ResponseSyntax) **   <a name="resiliencehub-StartResourceGroupingRecommendationTask-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [errorMessage](#API_StartResourceGroupingRecommendationTask_ResponseSyntax) **   <a name="resiliencehub-StartResourceGroupingRecommendationTask-response-errorMessage"></a>
Error that occurred while executing a grouping recommendation task.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 500.

 ** [groupingId](#API_StartResourceGroupingRecommendationTask_ResponseSyntax) **   <a name="resiliencehub-StartResourceGroupingRecommendationTask-response-groupingId"></a>
Identifier of the grouping recommendation task.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.

 ** [status](#API_StartResourceGroupingRecommendationTask_ResponseSyntax) **   <a name="resiliencehub-StartResourceGroupingRecommendationTask-response-status"></a>
Status of the action.  
Type: String  
Valid Values: `Pending | InProgress | Failed | Success` 

## Errors
<a name="API_StartResourceGroupingRecommendationTask_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_StartResourceGroupingRecommendationTask_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/StartResourceGroupingRecommendationTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/StartResourceGroupingRecommendationTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/StartResourceGroupingRecommendationTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/StartResourceGroupingRecommendationTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/StartResourceGroupingRecommendationTask) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/StartResourceGroupingRecommendationTask) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/StartResourceGroupingRecommendationTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/StartResourceGroupingRecommendationTask) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/StartResourceGroupingRecommendationTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/StartResourceGroupingRecommendationTask) 

# TagResource
<a name="API_TagResource"></a>

Applies one or more tags to a resource.

## Request Syntax
<a name="API_TagResource_RequestSyntax"></a>

```
POST /tags/resourceArn HTTP/1.1
Content-type: application/json

{
   "tags": { 
      "string" : "string" 
   }
}
```

## URI Request Parameters
<a name="API_TagResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="resiliencehub-TagResource-request-uri-resourceArn"></a>
Amazon Resource Name (ARN) of the resource.   
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

## Request Body
<a name="API_TagResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [tags](#API_TagResource_RequestSyntax) **   <a name="resiliencehub-TagResource-request-tags"></a>
The tags to assign to the resource. Each tag consists of a key/value pair.  
Type: String to string map  
Map Entries: Maximum number of 50 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[^\x00-\x1f\x22]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[^\x00-\x1f\x22]*`   
Required: Yes

## Response Syntax
<a name="API_TagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_TagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_TagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_TagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/TagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/TagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/TagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/TagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/TagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Removes one or more tags from a resource.

## Request Syntax
<a name="API_UntagResource_RequestSyntax"></a>

```
DELETE /tags/resourceArn?tagKeys=tagKeys HTTP/1.1
```

## URI Request Parameters
<a name="API_UntagResource_RequestParameters"></a>

The request uses the following URI parameters.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="resiliencehub-UntagResource-request-uri-resourceArn"></a>
Amazon Resource Name (ARN) of the resource.   
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [tagKeys](#API_UntagResource_RequestSyntax) **   <a name="resiliencehub-UntagResource-request-uri-tagKeys"></a>
The keys of the tags you want to remove.  
Array Members: Minimum number of 1 item. Maximum number of 50 items.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `[^\x00-\x1f\x22]+`   
Required: Yes

## Request Body
<a name="API_UntagResource_RequestBody"></a>

The request does not have a request body.

## Response Syntax
<a name="API_UntagResource_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Response Elements
<a name="API_UntagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_UntagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_UntagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/UntagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/UntagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/UntagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/UntagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/UntagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/UntagResource) 

# UpdateApp
<a name="API_UpdateApp"></a>

Updates an application.

## Request Syntax
<a name="API_UpdateApp_RequestSyntax"></a>

```
POST /update-app HTTP/1.1
Content-type: application/json

{
   "appArn": "string",
   "assessmentSchedule": "string",
   "clearResiliencyPolicyArn": boolean,
   "description": "string",
   "eventSubscriptions": [ 
      { 
         "eventType": "string",
         "name": "string",
         "snsTopicArn": "string"
      }
   ],
   "permissionModel": { 
      "crossAccountRoleArns": [ "string" ],
      "invokerRoleName": "string",
      "type": "string"
   },
   "policyArn": "string"
}
```

## URI Request Parameters
<a name="API_UpdateApp_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UpdateApp_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [appArn](#API_UpdateApp_RequestSyntax) **   <a name="resiliencehub-UpdateApp-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [assessmentSchedule](#API_UpdateApp_RequestSyntax) **   <a name="resiliencehub-UpdateApp-request-assessmentSchedule"></a>
 Assessment execution schedule with 'Daily' or 'Disabled' values.   
Type: String  
Valid Values: `Disabled | Daily`   
Required: No

 ** [clearResiliencyPolicyArn](#API_UpdateApp_RequestSyntax) **   <a name="resiliencehub-UpdateApp-request-clearResiliencyPolicyArn"></a>
Specifies if the resiliency policy ARN should be cleared.  
Type: Boolean  
Required: No

 ** [description](#API_UpdateApp_RequestSyntax) **   <a name="resiliencehub-UpdateApp-request-description"></a>
The optional description for an app.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 500.  
Required: No

 ** [eventSubscriptions](#API_UpdateApp_RequestSyntax) **   <a name="resiliencehub-UpdateApp-request-eventSubscriptions"></a>
The list of events you would like to subscribe and get notification for. Currently, AWS Resilience Hub supports notifications only for **Drift detected** and **Scheduled assessment failure** events.  
Type: Array of [EventSubscription](API_EventSubscription.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.  
Required: No

 ** [permissionModel](#API_UpdateApp_RequestSyntax) **   <a name="resiliencehub-UpdateApp-request-permissionModel"></a>
Defines the roles and credentials that AWS Resilience Hub would use while creating an application, importing its resources, and running an assessment.  
Type: [PermissionModel](API_PermissionModel.md) object  
Required: No

 ** [policyArn](#API_UpdateApp_RequestSyntax) **   <a name="resiliencehub-UpdateApp-request-policyArn"></a>
Amazon Resource Name (ARN) of the resiliency policy. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:resiliency-policy/`policy-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: No

## Response Syntax
<a name="API_UpdateApp_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "app": { 
      "appArn": "string",
      "assessmentSchedule": "string",
      "awsApplicationArn": "string",
      "complianceStatus": "string",
      "creationTime": number,
      "description": "string",
      "driftStatus": "string",
      "eventSubscriptions": [ 
         { 
            "eventType": "string",
            "name": "string",
            "snsTopicArn": "string"
         }
      ],
      "lastAppComplianceEvaluationTime": number,
      "lastDriftEvaluationTime": number,
      "lastResiliencyScoreEvaluationTime": number,
      "name": "string",
      "permissionModel": { 
         "crossAccountRoleArns": [ "string" ],
         "invokerRoleName": "string",
         "type": "string"
      },
      "policyArn": "string",
      "resiliencyScore": number,
      "rpoInSecs": number,
      "rtoInSecs": number,
      "status": "string",
      "tags": { 
         "string" : "string" 
      }
   }
}
```

## Response Elements
<a name="API_UpdateApp_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [app](#API_UpdateApp_ResponseSyntax) **   <a name="resiliencehub-UpdateApp-response-app"></a>
The specified application, returned as an object with details including compliance status, creation time, description, resiliency score, and more.  
Type: [App](API_App.md) object

## Errors
<a name="API_UpdateApp_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_UpdateApp_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/UpdateApp) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/UpdateApp) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/UpdateApp) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/UpdateApp) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/UpdateApp) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/UpdateApp) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/UpdateApp) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/UpdateApp) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/UpdateApp) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/UpdateApp) 

# UpdateAppVersion
<a name="API_UpdateAppVersion"></a>

Updates the AWS Resilience Hub application version.

**Note**  
This API updates the AWS Resilience Hub application draft version. To use this information for running resiliency assessments, you must publish the AWS Resilience Hub application using the `PublishAppVersion` API.

## Request Syntax
<a name="API_UpdateAppVersion_RequestSyntax"></a>

```
POST /update-app-version HTTP/1.1
Content-type: application/json

{
   "additionalInfo": { 
      "string" : [ "string" ]
   },
   "appArn": "string"
}
```

## URI Request Parameters
<a name="API_UpdateAppVersion_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UpdateAppVersion_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [additionalInfo](#API_UpdateAppVersion_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersion-request-additionalInfo"></a>
Additional configuration parameters for an AWS Resilience Hub application. If you want to implement `additionalInfo` through the AWS Resilience Hub console rather than using an API call, see [Configure the application configuration parameters](https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html).  
Currently, this parameter accepts a key-value mapping (in a string format) of only one failover region and one associated account.  
Key: `"failover-regions"`   
Value: `"[{"region":"<REGION>", "accounts":[{"id":"<ACCOUNT_ID>"}]}]"` 
Type: String to array of strings map  
Key Pattern: `\S{1,128}`   
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** [appArn](#API_UpdateAppVersion_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersion-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

## Response Syntax
<a name="API_UpdateAppVersion_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "additionalInfo": { 
      "string" : [ "string" ]
   },
   "appArn": "string",
   "appVersion": "string"
}
```

## Response Elements
<a name="API_UpdateAppVersion_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [additionalInfo](#API_UpdateAppVersion_ResponseSyntax) **   <a name="resiliencehub-UpdateAppVersion-response-additionalInfo"></a>
Additional configuration parameters for an AWS Resilience Hub application. If you want to implement `additionalInfo` through the AWS Resilience Hub console rather than using an API call, see [Configure the application configuration parameters](https://docs.aws.amazon.com/resilience-hub/latest/userguide/app-config-param.html).  
Currently, this parameter supports only failover region and account.
Type: String to array of strings map  
Key Pattern: `\S{1,128}`   
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 1024.

 ** [appArn](#API_UpdateAppVersion_ResponseSyntax) **   <a name="resiliencehub-UpdateAppVersion-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_UpdateAppVersion_ResponseSyntax) **   <a name="resiliencehub-UpdateAppVersion-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

## Errors
<a name="API_UpdateAppVersion_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_UpdateAppVersion_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/UpdateAppVersion) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/UpdateAppVersion) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/UpdateAppVersion) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/UpdateAppVersion) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/UpdateAppVersion) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/UpdateAppVersion) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/UpdateAppVersion) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/UpdateAppVersion) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/UpdateAppVersion) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/UpdateAppVersion) 

# UpdateAppVersionAppComponent
<a name="API_UpdateAppVersionAppComponent"></a>

Updates an existing AppComponent in the AWS Resilience Hub application.

**Note**  
This API updates the AWS Resilience Hub application draft version. To use this AppComponent for running assessments, you must publish the AWS Resilience Hub application using the `PublishAppVersion` API.

## Request Syntax
<a name="API_UpdateAppVersionAppComponent_RequestSyntax"></a>

```
POST /update-app-version-app-component HTTP/1.1
Content-type: application/json

{
   "additionalInfo": { 
      "string" : [ "string" ]
   },
   "appArn": "string",
   "id": "string",
   "name": "string",
   "type": "string"
}
```

## URI Request Parameters
<a name="API_UpdateAppVersionAppComponent_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UpdateAppVersionAppComponent_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [additionalInfo](#API_UpdateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionAppComponent-request-additionalInfo"></a>
Currently, there is no supported additional information for AppComponents.  
Type: String to array of strings map  
Key Pattern: `\S{1,128}`   
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** [appArn](#API_UpdateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionAppComponent-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [id](#API_UpdateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionAppComponent-request-id"></a>
Identifier of the AppComponent.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: Yes

 ** [name](#API_UpdateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionAppComponent-request-name"></a>
Name of the AppComponent.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** [type](#API_UpdateAppVersionAppComponent_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionAppComponent-request-type"></a>
Type of AppComponent. For more information about the types of AppComponent, see [Grouping resources in an AppComponent](https://docs.aws.amazon.com/resilience-hub/latest/userguide/AppComponent.grouping.html).  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

## Response Syntax
<a name="API_UpdateAppVersionAppComponent_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appComponent": { 
      "additionalInfo": { 
         "string" : [ "string" ]
      },
      "id": "string",
      "name": "string",
      "type": "string"
   },
   "appVersion": "string"
}
```

## Response Elements
<a name="API_UpdateAppVersionAppComponent_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_UpdateAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-UpdateAppVersionAppComponent-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appComponent](#API_UpdateAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-UpdateAppVersionAppComponent-response-appComponent"></a>
List of AppComponents that belong to this resource.  
Type: [AppComponent](API_AppComponent.md) object

 ** [appVersion](#API_UpdateAppVersionAppComponent_ResponseSyntax) **   <a name="resiliencehub-UpdateAppVersionAppComponent-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

## Errors
<a name="API_UpdateAppVersionAppComponent_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_UpdateAppVersionAppComponent_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/UpdateAppVersionAppComponent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/UpdateAppVersionAppComponent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/UpdateAppVersionAppComponent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/UpdateAppVersionAppComponent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/UpdateAppVersionAppComponent) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/UpdateAppVersionAppComponent) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/UpdateAppVersionAppComponent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/UpdateAppVersionAppComponent) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/UpdateAppVersionAppComponent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/UpdateAppVersionAppComponent) 

# UpdateAppVersionResource
<a name="API_UpdateAppVersionResource"></a>

Updates the resource details in the AWS Resilience Hub application.

**Note**  
This action has no effect outside AWS Resilience Hub.
This API updates the AWS Resilience Hub application draft version. To use this resource for running resiliency assessments, you must publish the AWS Resilience Hub application using the `PublishAppVersion` API.
To update application version with new `physicalResourceID`, you must call `ResolveAppVersionResources` API.
 AWS Resilience Hub blocks manual grouping and automatically groups certain resources based on their dependencies and configurations to prevent configuration errors and ensure accurate resilience assessment results. For more information, see [Managing Application Components](https://docs.aws.amazon.com/resilience-hub/latest/userguide/AppComponent.html).

## Request Syntax
<a name="API_UpdateAppVersionResource_RequestSyntax"></a>

```
POST /update-app-version-resource HTTP/1.1
Content-type: application/json

{
   "additionalInfo": { 
      "string" : [ "string" ]
   },
   "appArn": "string",
   "appComponents": [ "string" ],
   "awsAccountId": "string",
   "awsRegion": "string",
   "excluded": boolean,
   "logicalResourceId": { 
      "eksSourceName": "string",
      "identifier": "string",
      "logicalStackName": "string",
      "resourceGroupName": "string",
      "terraformSourceName": "string"
   },
   "physicalResourceId": "string",
   "resourceName": "string",
   "resourceType": "string"
}
```

## URI Request Parameters
<a name="API_UpdateAppVersionResource_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UpdateAppVersionResource_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [additionalInfo](#API_UpdateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-request-additionalInfo"></a>
Currently, there is no supported additional information for resources.  
Type: String to array of strings map  
Key Pattern: `\S{1,128}`   
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Length Constraints: Minimum length of 1. Maximum length of 1024.  
Required: No

 ** [appArn](#API_UpdateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-request-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [appComponents](#API_UpdateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-request-appComponents"></a>
List of AppComponents that this resource belongs to. If an AppComponent is not part of the AWS Resilience Hub application, it will be added.  
Type: Array of strings  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

 ** [awsAccountId](#API_UpdateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-request-awsAccountId"></a>
 AWS account that owns the physical resource.  
Type: String  
Pattern: `[0-9]{12}`   
Required: No

 ** [awsRegion](#API_UpdateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-request-awsRegion"></a>
 AWS region that owns the physical resource.  
Type: String  
Pattern: `[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]`   
Required: No

 ** [excluded](#API_UpdateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-request-excluded"></a>
Indicates if a resource is excluded from an AWS Resilience Hub application.  
You can exclude only imported resources from an AWS Resilience Hub application.
Type: Boolean  
Required: No

 ** [logicalResourceId](#API_UpdateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-request-logicalResourceId"></a>
Logical identifier of the resource.  
Type: [LogicalResourceId](API_LogicalResourceId.md) object  
Required: No

 ** [physicalResourceId](#API_UpdateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-request-physicalResourceId"></a>
Physical identifier of the resource.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 2048.  
Required: No

 ** [resourceName](#API_UpdateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-request-resourceName"></a>
Name of the resource.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: No

 ** [resourceType](#API_UpdateAppVersionResource_RequestSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-request-resourceType"></a>
Type of resource.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 255.  
Required: No

## Response Syntax
<a name="API_UpdateAppVersionResource_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "appArn": "string",
   "appVersion": "string",
   "physicalResource": { 
      "additionalInfo": { 
         "string" : [ "string" ]
      },
      "appComponents": [ 
         { 
            "additionalInfo": { 
               "string" : [ "string" ]
            },
            "id": "string",
            "name": "string",
            "type": "string"
         }
      ],
      "excluded": boolean,
      "logicalResourceId": { 
         "eksSourceName": "string",
         "identifier": "string",
         "logicalStackName": "string",
         "resourceGroupName": "string",
         "terraformSourceName": "string"
      },
      "parentResourceName": "string",
      "physicalResourceId": { 
         "awsAccountId": "string",
         "awsRegion": "string",
         "identifier": "string",
         "type": "string"
      },
      "resourceName": "string",
      "resourceType": "string",
      "sourceType": "string"
   }
}
```

## Response Elements
<a name="API_UpdateAppVersionResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [appArn](#API_UpdateAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-response-appArn"></a>
Amazon Resource Name (ARN) of the AWS Resilience Hub application. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:app/`app-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}` 

 ** [appVersion](#API_UpdateAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-response-appVersion"></a>
 AWS Resilience Hub application version.  
Type: String  
Pattern: `\S{1,50}` 

 ** [physicalResource](#API_UpdateAppVersionResource_ResponseSyntax) **   <a name="resiliencehub-UpdateAppVersionResource-response-physicalResource"></a>
Defines a physical resource. A physical resource is a resource that exists in your account. It can be identified using an Amazon Resource Name (ARN) or a Resilience Hub-native identifier.  
Type: [PhysicalResource](API_PhysicalResource.md) object

## Errors
<a name="API_UpdateAppVersionResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ServiceQuotaExceededException **   
This exception occurs when you have exceeded your service quota. To perform the requested action, remove some of the relevant resources, or use Service Quotas to request a service quota increase.  
HTTP Status Code: 402

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_UpdateAppVersionResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/UpdateAppVersionResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/UpdateAppVersionResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/UpdateAppVersionResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/UpdateAppVersionResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/UpdateAppVersionResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/UpdateAppVersionResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/UpdateAppVersionResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/UpdateAppVersionResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/UpdateAppVersionResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/UpdateAppVersionResource) 

# UpdateResiliencyPolicy
<a name="API_UpdateResiliencyPolicy"></a>

Updates a resiliency policy.

**Note**  
 AWS Resilience Hub allows you to provide a value of zero for `rtoInSecs` and `rpoInSecs` of your resiliency policy. But, while assessing your application, the lowest possible assessment result is near zero. Hence, if you provide value zero for `rtoInSecs` and `rpoInSecs`, the estimated workload RTO and estimated workload RPO result will be near zero and the **Compliance status** for your application will be set to **Policy breached**.

## Request Syntax
<a name="API_UpdateResiliencyPolicy_RequestSyntax"></a>

```
POST /update-resiliency-policy HTTP/1.1
Content-type: application/json

{
   "dataLocationConstraint": "string",
   "policy": { 
      "string" : { 
         "rpoInSecs": number,
         "rtoInSecs": number
      }
   },
   "policyArn": "string",
   "policyDescription": "string",
   "policyName": "string",
   "tier": "string"
}
```

## URI Request Parameters
<a name="API_UpdateResiliencyPolicy_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_UpdateResiliencyPolicy_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [dataLocationConstraint](#API_UpdateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-UpdateResiliencyPolicy-request-dataLocationConstraint"></a>
Specifies a high-level geographical location constraint for where your resilience policy data can be stored.  
Type: String  
Valid Values: `AnyLocation | SameContinent | SameCountry`   
Required: No

 ** [policy](#API_UpdateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-UpdateResiliencyPolicy-request-policy"></a>
Resiliency policy to be created, including the recovery time objective (RTO) and recovery point objective (RPO) in seconds.  
Type: String to [FailurePolicy](API_FailurePolicy.md) object map  
Valid Keys: `Software | Hardware | AZ | Region`   
Required: No

 ** [policyArn](#API_UpdateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-UpdateResiliencyPolicy-request-policyArn"></a>
Amazon Resource Name (ARN) of the resiliency policy. The format for this ARN is: arn:`partition`:resiliencehub:`region`:`account`:resiliency-policy/`policy-id`. For more information about ARNs, see [ Amazon Resource Names (ARNs)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) in the * AWS General Reference* guide.  
Type: String  
Pattern: `arn:(aws|aws-cn|aws-iso|aws-iso-[a-z]{1}|aws-us-gov):[A-Za-z0-9][A-Za-z0-9_/.-]{0,62}:([a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-[0-9]):[0-9]{12}:[A-Za-z0-9/][A-Za-z0-9:_/+.-]{0,1023}`   
Required: Yes

 ** [policyDescription](#API_UpdateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-UpdateResiliencyPolicy-request-policyDescription"></a>
Description of the resiliency policy.  
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 500.  
Required: No

 ** [policyName](#API_UpdateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-UpdateResiliencyPolicy-request-policyName"></a>
Name of the resiliency policy.  
Type: String  
Pattern: `[A-Za-z0-9][A-Za-z0-9_\-]{1,59}`   
Required: No

 ** [tier](#API_UpdateResiliencyPolicy_RequestSyntax) **   <a name="resiliencehub-UpdateResiliencyPolicy-request-tier"></a>
The tier for this resiliency policy, ranging from the highest severity (`MissionCritical`) to lowest (`NonCritical`).  
Type: String  
Valid Values: `MissionCritical | Critical | Important | CoreServices | NonCritical | NotApplicable`   
Required: No

## Response Syntax
<a name="API_UpdateResiliencyPolicy_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "policy": { 
      "creationTime": number,
      "dataLocationConstraint": "string",
      "estimatedCostTier": "string",
      "policy": { 
         "string" : { 
            "rpoInSecs": number,
            "rtoInSecs": number
         }
      },
      "policyArn": "string",
      "policyDescription": "string",
      "policyName": "string",
      "tags": { 
         "string" : "string" 
      },
      "tier": "string"
   }
}
```

## Response Elements
<a name="API_UpdateResiliencyPolicy_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [policy](#API_UpdateResiliencyPolicy_ResponseSyntax) **   <a name="resiliencehub-UpdateResiliencyPolicy-response-policy"></a>
The resiliency policy that was updated, including the recovery time objective (RTO) and recovery point objective (RPO) in seconds.  
Type: [ResiliencyPolicy](API_ResiliencyPolicy.md) object

## Errors
<a name="API_UpdateResiliencyPolicy_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
You don't have permissions to perform the requested operation. The user or role that is making the request must have at least one IAM permissions policy attached that grants the required permissions.  
HTTP Status Code: 403

 ** ConflictException **   
This exception occurs when a conflict with a previous successful write is detected. This generally occurs when the previous write did not have time to propagate to the host serving the current request. A retry (with appropriate backoff logic) is the recommended response to this exception.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 409

 ** InternalServerException **   
This exception occurs when there is an internal failure in the AWS Resilience Hub service.  
HTTP Status Code: 500

 ** ResourceNotFoundException **   
This exception occurs when the specified resource could not be found.    
 ** resourceId **   
The identifier of the resource that the exception applies to.  
 ** resourceType **   
The type of the resource that the exception applies to.
HTTP Status Code: 404

 ** ThrottlingException **   
This exception occurs when you have exceeded the limit on the number of requests per second.    
 ** retryAfterSeconds **   
The number of seconds to wait before retrying the operation.
HTTP Status Code: 429

 ** ValidationException **   
This exception occurs when a request is not valid.  
HTTP Status Code: 400

## See Also
<a name="API_UpdateResiliencyPolicy_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/resiliencehub-2020-04-30/UpdateResiliencyPolicy) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/resiliencehub-2020-04-30/UpdateResiliencyPolicy) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/resiliencehub-2020-04-30/UpdateResiliencyPolicy) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/resiliencehub-2020-04-30/UpdateResiliencyPolicy) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/resiliencehub-2020-04-30/UpdateResiliencyPolicy) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/resiliencehub-2020-04-30/UpdateResiliencyPolicy) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/resiliencehub-2020-04-30/UpdateResiliencyPolicy) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/resiliencehub-2020-04-30/UpdateResiliencyPolicy) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/resiliencehub-2020-04-30/UpdateResiliencyPolicy) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/resiliencehub-2020-04-30/UpdateResiliencyPolicy)