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

The following actions are supported:
+  [AddNotificationChannel](API_AddNotificationChannel.md) 
+  [DeleteInsight](API_DeleteInsight.md) 
+  [DescribeAccountHealth](API_DescribeAccountHealth.md) 
+  [DescribeAccountOverview](API_DescribeAccountOverview.md) 
+  [DescribeAnomaly](API_DescribeAnomaly.md) 
+  [DescribeEventSourcesConfig](API_DescribeEventSourcesConfig.md) 
+  [DescribeFeedback](API_DescribeFeedback.md) 
+  [DescribeInsight](API_DescribeInsight.md) 
+  [DescribeOrganizationHealth](API_DescribeOrganizationHealth.md) 
+  [DescribeOrganizationOverview](API_DescribeOrganizationOverview.md) 
+  [DescribeOrganizationResourceCollectionHealth](API_DescribeOrganizationResourceCollectionHealth.md) 
+  [DescribeResourceCollectionHealth](API_DescribeResourceCollectionHealth.md) 
+  [DescribeServiceIntegration](API_DescribeServiceIntegration.md) 
+  [GetCostEstimation](API_GetCostEstimation.md) 
+  [GetResourceCollection](API_GetResourceCollection.md) 
+  [ListAnomaliesForInsight](API_ListAnomaliesForInsight.md) 
+  [ListAnomalousLogGroups](API_ListAnomalousLogGroups.md) 
+  [ListEvents](API_ListEvents.md) 
+  [ListInsights](API_ListInsights.md) 
+  [ListMonitoredResources](API_ListMonitoredResources.md) 
+  [ListNotificationChannels](API_ListNotificationChannels.md) 
+  [ListOrganizationInsights](API_ListOrganizationInsights.md) 
+  [ListRecommendations](API_ListRecommendations.md) 
+  [PutFeedback](API_PutFeedback.md) 
+  [RemoveNotificationChannel](API_RemoveNotificationChannel.md) 
+  [SearchInsights](API_SearchInsights.md) 
+  [SearchOrganizationInsights](API_SearchOrganizationInsights.md) 
+  [StartCostEstimation](API_StartCostEstimation.md) 
+  [UpdateEventSourcesConfig](API_UpdateEventSourcesConfig.md) 
+  [UpdateResourceCollection](API_UpdateResourceCollection.md) 
+  [UpdateServiceIntegration](API_UpdateServiceIntegration.md) 

# AddNotificationChannel
<a name="API_AddNotificationChannel"></a>

 Adds a notification channel to DevOps Guru. A notification channel is used to notify you about important DevOps Guru events, such as when an insight is generated. 

If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to send it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see [Permissions for Amazon SNS topics](https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-required-permissions.html).

If you use an Amazon SNS topic that is encrypted by an AWS Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see [Permissions for AWS KMS–encrypted Amazon SNS topics](https://docs.aws.amazon.com/devops-guru/latest/userguide/sns-kms-permissions.html).

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

```
PUT /channels HTTP/1.1
Content-type: application/json

{
   "Config": { 
      "Filters": { 
         "MessageTypes": [ "string" ],
         "Severities": [ "string" ]
      },
      "Sns": { 
         "TopicArn": "string"
      }
   }
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [Config](#API_AddNotificationChannel_RequestSyntax) **   <a name="DevOpsGuru-AddNotificationChannel-request-Config"></a>
 A `NotificationChannelConfig` object that specifies what type of notification channel to add. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS).   
Type: [NotificationChannelConfig](API_NotificationChannelConfig.md) object  
Required: Yes

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

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

{
   "Id": "string"
}
```

## Response Elements
<a name="API_AddNotificationChannel_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.

 ** [Id](#API_AddNotificationChannel_ResponseSyntax) **   <a name="DevOpsGuru-AddNotificationChannel-response-Id"></a>
 The ID of the added notification channel.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

## Errors
<a name="API_AddNotificationChannel_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** ConflictException **   
 An exception that is thrown when a conflict occurs.     
 ** ResourceId **   
 The ID of the AWS resource in which a conflict occurred.   
 ** ResourceType **   
 The type of the AWS resource in which a conflict occurred. 
HTTP Status Code: 409

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ServiceQuotaExceededException **   
The request contains a value that exceeds a maximum quota.  
HTTP Status Code: 402

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_AddNotificationChannel_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/devops-guru-2020-12-01/AddNotificationChannel) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/AddNotificationChannel) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/AddNotificationChannel) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/AddNotificationChannel) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/AddNotificationChannel) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/AddNotificationChannel) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/AddNotificationChannel) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/AddNotificationChannel) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/AddNotificationChannel) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/AddNotificationChannel) 

# DeleteInsight
<a name="API_DeleteInsight"></a>

Deletes the insight along with the associated anomalies, events and recommendations.

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

```
DELETE /insights/Id HTTP/1.1
```

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

The request uses the following URI parameters.

 ** [Id](#API_DeleteInsight_RequestSyntax) **   <a name="DevOpsGuru-DeleteInsight-request-uri-Id"></a>
The ID of the insight.  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[\w-]*$`   
Required: Yes

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

The request does not have a request body.

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

```
HTTP/1.1 200
```

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

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

## Errors
<a name="API_DeleteInsight_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** ConflictException **   
 An exception that is thrown when a conflict occurs.     
 ** ResourceId **   
 The ID of the AWS resource in which a conflict occurred.   
 ** ResourceType **   
 The type of the AWS resource in which a conflict occurred. 
HTTP Status Code: 409

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DeleteInsight_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/devops-guru-2020-12-01/DeleteInsight) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DeleteInsight) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DeleteInsight) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DeleteInsight) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DeleteInsight) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DeleteInsight) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DeleteInsight) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DeleteInsight) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DeleteInsight) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DeleteInsight) 

# DescribeAccountHealth
<a name="API_DescribeAccountHealth"></a>

 Returns the number of open reactive insights, the number of open proactive insights, and the number of metrics analyzed in your AWS account. Use these numbers to gauge the health of operations in your AWS account. 

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

```
GET /accounts/health HTTP/1.1
```

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

The request does not use any URI parameters.

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

The request does not have a request body.

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

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

{
   "AnalyzedResourceCount": number,
   "MetricsAnalyzed": number,
   "OpenProactiveInsights": number,
   "OpenReactiveInsights": number,
   "ResourceHours": number
}
```

## Response Elements
<a name="API_DescribeAccountHealth_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.

 ** [AnalyzedResourceCount](#API_DescribeAccountHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeAccountHealth-response-AnalyzedResourceCount"></a>
 Number of resources that DevOps Guru is monitoring in your AWS account.   
Type: Long

 ** [MetricsAnalyzed](#API_DescribeAccountHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeAccountHealth-response-MetricsAnalyzed"></a>
 An integer that specifies the number of metrics that have been analyzed in your AWS account.   
Type: Integer

 ** [OpenProactiveInsights](#API_DescribeAccountHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeAccountHealth-response-OpenProactiveInsights"></a>
 An integer that specifies the number of open proactive insights in your AWS account.   
Type: Integer

 ** [OpenReactiveInsights](#API_DescribeAccountHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeAccountHealth-response-OpenReactiveInsights"></a>
 An integer that specifies the number of open reactive insights in your AWS account.   
Type: Integer

 ** [ResourceHours](#API_DescribeAccountHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeAccountHealth-response-ResourceHours"></a>
The number of Amazon DevOps Guru resource analysis hours billed to the current AWS account in the last hour.   
Type: Long

## Errors
<a name="API_DescribeAccountHealth_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeAccountHealth_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/devops-guru-2020-12-01/DescribeAccountHealth) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeAccountHealth) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeAccountHealth) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeAccountHealth) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeAccountHealth) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeAccountHealth) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeAccountHealth) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeAccountHealth) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeAccountHealth) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeAccountHealth) 

# DescribeAccountOverview
<a name="API_DescribeAccountOverview"></a>

 For the time range passed in, returns the number of open reactive insight that were created, the number of open proactive insights that were created, and the Mean Time to Recover (MTTR) for all closed reactive insights. 

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

```
POST /accounts/overview HTTP/1.1
Content-type: application/json

{
   "FromTime": number,
   "ToTime": number
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [FromTime](#API_DescribeAccountOverview_RequestSyntax) **   <a name="DevOpsGuru-DescribeAccountOverview-request-FromTime"></a>
 The start of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred after this day.   
Type: Timestamp  
Required: Yes

 ** [ToTime](#API_DescribeAccountOverview_RequestSyntax) **   <a name="DevOpsGuru-DescribeAccountOverview-request-ToTime"></a>
 The end of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred before this day. If this is not specified, then the current day is used.   
Type: Timestamp  
Required: No

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

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

{
   "MeanTimeToRecoverInMilliseconds": number,
   "ProactiveInsights": number,
   "ReactiveInsights": number
}
```

## Response Elements
<a name="API_DescribeAccountOverview_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.

 ** [MeanTimeToRecoverInMilliseconds](#API_DescribeAccountOverview_ResponseSyntax) **   <a name="DevOpsGuru-DescribeAccountOverview-response-MeanTimeToRecoverInMilliseconds"></a>
 The Mean Time to Recover (MTTR) for all closed insights that were created during the time range passed in.   
Type: Long

 ** [ProactiveInsights](#API_DescribeAccountOverview_ResponseSyntax) **   <a name="DevOpsGuru-DescribeAccountOverview-response-ProactiveInsights"></a>
 An integer that specifies the number of open proactive insights in your AWS account that were created during the time range passed in.   
Type: Integer

 ** [ReactiveInsights](#API_DescribeAccountOverview_ResponseSyntax) **   <a name="DevOpsGuru-DescribeAccountOverview-response-ReactiveInsights"></a>
 An integer that specifies the number of open reactive insights in your AWS account that were created during the time range passed in.   
Type: Integer

## Errors
<a name="API_DescribeAccountOverview_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeAccountOverview_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/devops-guru-2020-12-01/DescribeAccountOverview) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeAccountOverview) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeAccountOverview) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeAccountOverview) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeAccountOverview) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeAccountOverview) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeAccountOverview) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeAccountOverview) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeAccountOverview) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeAccountOverview) 

# DescribeAnomaly
<a name="API_DescribeAnomaly"></a>

 Returns details about an anomaly that you specify using its ID. 

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

```
GET /anomalies/Id?AccountId=AccountId HTTP/1.1
```

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

The request uses the following URI parameters.

 ** [AccountId](#API_DescribeAnomaly_RequestSyntax) **   <a name="DevOpsGuru-DescribeAnomaly-request-uri-AccountId"></a>
The ID of the member account.  
Length Constraints: Fixed length of 12.  
Pattern: `^\d{12}$` 

 ** [Id](#API_DescribeAnomaly_RequestSyntax) **   <a name="DevOpsGuru-DescribeAnomaly-request-uri-Id"></a>
 The ID of the anomaly.   
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[\w~.-]*$`   
Required: Yes

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

The request does not have a request body.

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

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

{
   "ProactiveAnomaly": { 
      "AnomalyReportedTimeRange": { 
         "CloseTime": number,
         "OpenTime": number
      },
      "AnomalyResources": [ 
         { 
            "Name": "string",
            "Type": "string"
         }
      ],
      "AnomalyTimeRange": { 
         "EndTime": number,
         "StartTime": number
      },
      "AssociatedInsightId": "string",
      "Description": "string",
      "Id": "string",
      "Limit": number,
      "PredictionTimeRange": { 
         "EndTime": number,
         "StartTime": number
      },
      "ResourceCollection": { 
         "CloudFormation": { 
            "StackNames": [ "string" ]
         },
         "Tags": [ 
            { 
               "AppBoundaryKey": "string",
               "TagValues": [ "string" ]
            }
         ]
      },
      "Severity": "string",
      "SourceDetails": { 
         "CloudWatchMetrics": [ 
            { 
               "Dimensions": [ 
                  { 
                     "Name": "string",
                     "Value": "string"
                  }
               ],
               "MetricDataSummary": { 
                  "StatusCode": "string",
                  "TimestampMetricValuePairList": [ 
                     { 
                        "MetricValue": number,
                        "Timestamp": number
                     }
                  ]
               },
               "MetricName": "string",
               "Namespace": "string",
               "Period": number,
               "Stat": "string",
               "Unit": "string"
            }
         ],
         "PerformanceInsightsMetrics": [ 
            { 
               "MetricDisplayName": "string",
               "MetricQuery": { 
                  "Filter": { 
                     "string" : "string" 
                  },
                  "GroupBy": { 
                     "Dimensions": [ "string" ],
                     "Group": "string",
                     "Limit": number
                  },
                  "Metric": "string"
               },
               "ReferenceData": [ 
                  { 
                     "ComparisonValues": { 
                        "ReferenceMetric": { 
                           "MetricQuery": { 
                              "Filter": { 
                                 "string" : "string" 
                              },
                              "GroupBy": { 
                                 "Dimensions": [ "string" ],
                                 "Group": "string",
                                 "Limit": number
                              },
                              "Metric": "string"
                           }
                        },
                        "ReferenceScalar": { 
                           "Value": number
                        }
                     },
                     "Name": "string"
                  }
               ],
               "StatsAtAnomaly": [ 
                  { 
                     "Type": "string",
                     "Value": number
                  }
               ],
               "StatsAtBaseline": [ 
                  { 
                     "Type": "string",
                     "Value": number
                  }
               ],
               "Unit": "string"
            }
         ]
      },
      "SourceMetadata": { 
         "Source": "string",
         "SourceResourceName": "string",
         "SourceResourceType": "string"
      },
      "Status": "string",
      "UpdateTime": number
   },
   "ReactiveAnomaly": { 
      "AnomalyReportedTimeRange": { 
         "CloseTime": number,
         "OpenTime": number
      },
      "AnomalyResources": [ 
         { 
            "Name": "string",
            "Type": "string"
         }
      ],
      "AnomalyTimeRange": { 
         "EndTime": number,
         "StartTime": number
      },
      "AssociatedInsightId": "string",
      "CausalAnomalyId": "string",
      "Description": "string",
      "Id": "string",
      "Name": "string",
      "ResourceCollection": { 
         "CloudFormation": { 
            "StackNames": [ "string" ]
         },
         "Tags": [ 
            { 
               "AppBoundaryKey": "string",
               "TagValues": [ "string" ]
            }
         ]
      },
      "Severity": "string",
      "SourceDetails": { 
         "CloudWatchMetrics": [ 
            { 
               "Dimensions": [ 
                  { 
                     "Name": "string",
                     "Value": "string"
                  }
               ],
               "MetricDataSummary": { 
                  "StatusCode": "string",
                  "TimestampMetricValuePairList": [ 
                     { 
                        "MetricValue": number,
                        "Timestamp": number
                     }
                  ]
               },
               "MetricName": "string",
               "Namespace": "string",
               "Period": number,
               "Stat": "string",
               "Unit": "string"
            }
         ],
         "PerformanceInsightsMetrics": [ 
            { 
               "MetricDisplayName": "string",
               "MetricQuery": { 
                  "Filter": { 
                     "string" : "string" 
                  },
                  "GroupBy": { 
                     "Dimensions": [ "string" ],
                     "Group": "string",
                     "Limit": number
                  },
                  "Metric": "string"
               },
               "ReferenceData": [ 
                  { 
                     "ComparisonValues": { 
                        "ReferenceMetric": { 
                           "MetricQuery": { 
                              "Filter": { 
                                 "string" : "string" 
                              },
                              "GroupBy": { 
                                 "Dimensions": [ "string" ],
                                 "Group": "string",
                                 "Limit": number
                              },
                              "Metric": "string"
                           }
                        },
                        "ReferenceScalar": { 
                           "Value": number
                        }
                     },
                     "Name": "string"
                  }
               ],
               "StatsAtAnomaly": [ 
                  { 
                     "Type": "string",
                     "Value": number
                  }
               ],
               "StatsAtBaseline": [ 
                  { 
                     "Type": "string",
                     "Value": number
                  }
               ],
               "Unit": "string"
            }
         ]
      },
      "Status": "string",
      "Type": "string"
   }
}
```

## Response Elements
<a name="API_DescribeAnomaly_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.

 ** [ProactiveAnomaly](#API_DescribeAnomaly_ResponseSyntax) **   <a name="DevOpsGuru-DescribeAnomaly-response-ProactiveAnomaly"></a>
 A `ProactiveAnomaly` object that represents the requested anomaly.   
Type: [ProactiveAnomaly](API_ProactiveAnomaly.md) object

 ** [ReactiveAnomaly](#API_DescribeAnomaly_ResponseSyntax) **   <a name="DevOpsGuru-DescribeAnomaly-response-ReactiveAnomaly"></a>
 A `ReactiveAnomaly` object that represents the requested anomaly.   
Type: [ReactiveAnomaly](API_ReactiveAnomaly.md) object

## Errors
<a name="API_DescribeAnomaly_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeAnomaly_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/devops-guru-2020-12-01/DescribeAnomaly) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeAnomaly) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeAnomaly) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeAnomaly) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeAnomaly) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeAnomaly) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeAnomaly) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeAnomaly) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeAnomaly) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeAnomaly) 

# DescribeEventSourcesConfig
<a name="API_DescribeEventSourcesConfig"></a>

Returns the integration status of services that are integrated with DevOps Guru as Consumer via EventBridge. The one service that can be integrated with DevOps Guru is Amazon CodeGuru Profiler, which can produce proactive recommendations which can be stored and viewed in DevOps Guru.

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

```
POST /event-sources HTTP/1.1
```

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

The request does not use any URI parameters.

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

The request does not have a request body.

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

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

{
   "EventSources": { 
      "AmazonCodeGuruProfiler": { 
         "Status": "string"
      }
   }
}
```

## Response Elements
<a name="API_DescribeEventSourcesConfig_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.

 ** [EventSources](#API_DescribeEventSourcesConfig_ResponseSyntax) **   <a name="DevOpsGuru-DescribeEventSourcesConfig-response-EventSources"></a>
Lists the event sources in the configuration.  
Type: [EventSourcesConfig](API_EventSourcesConfig.md) object

## Errors
<a name="API_DescribeEventSourcesConfig_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeEventSourcesConfig_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/devops-guru-2020-12-01/DescribeEventSourcesConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeEventSourcesConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeEventSourcesConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeEventSourcesConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeEventSourcesConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeEventSourcesConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeEventSourcesConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeEventSourcesConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeEventSourcesConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeEventSourcesConfig) 

# DescribeFeedback
<a name="API_DescribeFeedback"></a>

 Returns the most recent feedback submitted in the current AWS account and Region. 

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

```
POST /feedback HTTP/1.1
Content-type: application/json

{
   "InsightId": "string"
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [InsightId](#API_DescribeFeedback_RequestSyntax) **   <a name="DevOpsGuru-DescribeFeedback-request-InsightId"></a>
 The ID of the insight for which the feedback was provided.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[\w-]*$`   
Required: No

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

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

{
   "InsightFeedback": { 
      "Feedback": "string",
      "Id": "string"
   }
}
```

## Response Elements
<a name="API_DescribeFeedback_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.

 ** [InsightFeedback](#API_DescribeFeedback_ResponseSyntax) **   <a name="DevOpsGuru-DescribeFeedback-response-InsightFeedback"></a>
 Information about insight feedback received from a customer.   
Type: [InsightFeedback](API_InsightFeedback.md) object

## Errors
<a name="API_DescribeFeedback_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeFeedback_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/devops-guru-2020-12-01/DescribeFeedback) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeFeedback) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeFeedback) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeFeedback) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeFeedback) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeFeedback) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeFeedback) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeFeedback) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeFeedback) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeFeedback) 

# DescribeInsight
<a name="API_DescribeInsight"></a>

 Returns details about an insight that you specify using its ID. 

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

```
GET /insights/Id?AccountId=AccountId HTTP/1.1
```

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

The request uses the following URI parameters.

 ** [AccountId](#API_DescribeInsight_RequestSyntax) **   <a name="DevOpsGuru-DescribeInsight-request-uri-AccountId"></a>
The ID of the member account in the organization.  
Length Constraints: Fixed length of 12.  
Pattern: `^\d{12}$` 

 ** [Id](#API_DescribeInsight_RequestSyntax) **   <a name="DevOpsGuru-DescribeInsight-request-uri-Id"></a>
 The ID of the insight.   
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[\w-]*$`   
Required: Yes

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

The request does not have a request body.

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

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

{
   "ProactiveInsight": { 
      "Description": "string",
      "Id": "string",
      "InsightTimeRange": { 
         "EndTime": number,
         "StartTime": number
      },
      "Name": "string",
      "PredictionTimeRange": { 
         "EndTime": number,
         "StartTime": number
      },
      "ResourceCollection": { 
         "CloudFormation": { 
            "StackNames": [ "string" ]
         },
         "Tags": [ 
            { 
               "AppBoundaryKey": "string",
               "TagValues": [ "string" ]
            }
         ]
      },
      "Severity": "string",
      "SsmOpsItemId": "string",
      "Status": "string"
   },
   "ReactiveInsight": { 
      "Description": "string",
      "Id": "string",
      "InsightTimeRange": { 
         "EndTime": number,
         "StartTime": number
      },
      "Name": "string",
      "ResourceCollection": { 
         "CloudFormation": { 
            "StackNames": [ "string" ]
         },
         "Tags": [ 
            { 
               "AppBoundaryKey": "string",
               "TagValues": [ "string" ]
            }
         ]
      },
      "Severity": "string",
      "SsmOpsItemId": "string",
      "Status": "string"
   }
}
```

## Response Elements
<a name="API_DescribeInsight_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.

 ** [ProactiveInsight](#API_DescribeInsight_ResponseSyntax) **   <a name="DevOpsGuru-DescribeInsight-response-ProactiveInsight"></a>
 A `ProactiveInsight` object that represents the requested insight.   
Type: [ProactiveInsight](API_ProactiveInsight.md) object

 ** [ReactiveInsight](#API_DescribeInsight_ResponseSyntax) **   <a name="DevOpsGuru-DescribeInsight-response-ReactiveInsight"></a>
 A `ReactiveInsight` object that represents the requested insight.   
Type: [ReactiveInsight](API_ReactiveInsight.md) object

## Errors
<a name="API_DescribeInsight_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeInsight_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/devops-guru-2020-12-01/DescribeInsight) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeInsight) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeInsight) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeInsight) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeInsight) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeInsight) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeInsight) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeInsight) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeInsight) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeInsight) 

# DescribeOrganizationHealth
<a name="API_DescribeOrganizationHealth"></a>

Returns the number of metrics, insights, and resource hours DevOps Guru analyzed in the last hour.

There are two types of insights:
+  *Reactive*: A reactive insight identifies anomalous behavior as it occurs. It contains anomalies with recommendations, related metrics, and events to help you understand and address the issues now. 
+  *Proactive*: A proactive insight lets you know about anomalous behavior before it occurs. It contains anomalies with recommendations to help you address the issues before they are predicted to happen. 

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

```
POST /organization/health HTTP/1.1
Content-type: application/json

{
   "AccountIds": [ "string" ],
   "OrganizationalUnitIds": [ "string" ]
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [AccountIds](#API_DescribeOrganizationHealth_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationHealth-request-AccountIds"></a>
The ID of the AWS account.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 5 items.  
Length Constraints: Fixed length of 12.  
Pattern: `^\d{12}$`   
Required: No

 ** [OrganizationalUnitIds](#API_DescribeOrganizationHealth_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationHealth-request-OrganizationalUnitIds"></a>
The ID of the organizational unit.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 5 items.  
Length Constraints: Maximum length of 68.  
Pattern: `^ou-[0-9a-z]{4,32}-[a-z0-9]{8,32}$`   
Required: No

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

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

{
   "MetricsAnalyzed": number,
   "OpenProactiveInsights": number,
   "OpenReactiveInsights": number,
   "ResourceHours": number
}
```

## Response Elements
<a name="API_DescribeOrganizationHealth_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.

 ** [MetricsAnalyzed](#API_DescribeOrganizationHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationHealth-response-MetricsAnalyzed"></a>
An integer that specifies the number of metrics that have been analyzed in your organization.  
Type: Integer

 ** [OpenProactiveInsights](#API_DescribeOrganizationHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationHealth-response-OpenProactiveInsights"></a>
An integer that specifies the number of open proactive insights in your AWS account.  
Type: Integer

 ** [OpenReactiveInsights](#API_DescribeOrganizationHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationHealth-response-OpenReactiveInsights"></a>
An integer that specifies the number of open reactive insights in your AWS account.  
Type: Integer

 ** [ResourceHours](#API_DescribeOrganizationHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationHealth-response-ResourceHours"></a>
The number of Amazon DevOps Guru resource analysis hours billed to the current AWS account in the last hour.   
Type: Long

## Errors
<a name="API_DescribeOrganizationHealth_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeOrganizationHealth_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/devops-guru-2020-12-01/DescribeOrganizationHealth) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeOrganizationHealth) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeOrganizationHealth) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeOrganizationHealth) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeOrganizationHealth) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeOrganizationHealth) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeOrganizationHealth) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeOrganizationHealth) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeOrganizationHealth) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeOrganizationHealth) 

# DescribeOrganizationOverview
<a name="API_DescribeOrganizationOverview"></a>

Returns an overview of your organization's history based on the specified time range. The overview includes the total reactive and proactive insights.

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

```
POST /organization/overview HTTP/1.1
Content-type: application/json

{
   "AccountIds": [ "string" ],
   "FromTime": number,
   "OrganizationalUnitIds": [ "string" ],
   "ToTime": number
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [AccountIds](#API_DescribeOrganizationOverview_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationOverview-request-AccountIds"></a>
The ID of the AWS account.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 5 items.  
Length Constraints: Fixed length of 12.  
Pattern: `^\d{12}$`   
Required: No

 ** [FromTime](#API_DescribeOrganizationOverview_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationOverview-request-FromTime"></a>
 The start of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred after this day.   
Type: Timestamp  
Required: Yes

 ** [OrganizationalUnitIds](#API_DescribeOrganizationOverview_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationOverview-request-OrganizationalUnitIds"></a>
The ID of the organizational unit.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 5 items.  
Length Constraints: Maximum length of 68.  
Pattern: `^ou-[0-9a-z]{4,32}-[a-z0-9]{8,32}$`   
Required: No

 ** [ToTime](#API_DescribeOrganizationOverview_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationOverview-request-ToTime"></a>
 The end of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred before this day. If this is not specified, then the current day is used.   
Type: Timestamp  
Required: No

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

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

{
   "ProactiveInsights": number,
   "ReactiveInsights": number
}
```

## Response Elements
<a name="API_DescribeOrganizationOverview_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.

 ** [ProactiveInsights](#API_DescribeOrganizationOverview_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationOverview-response-ProactiveInsights"></a>
An integer that specifies the number of open proactive insights in your AWS account.  
Type: Integer

 ** [ReactiveInsights](#API_DescribeOrganizationOverview_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationOverview-response-ReactiveInsights"></a>
An integer that specifies the number of open reactive insights in your AWS account.  
Type: Integer

## Errors
<a name="API_DescribeOrganizationOverview_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeOrganizationOverview_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/devops-guru-2020-12-01/DescribeOrganizationOverview) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeOrganizationOverview) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeOrganizationOverview) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeOrganizationOverview) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeOrganizationOverview) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeOrganizationOverview) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeOrganizationOverview) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeOrganizationOverview) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeOrganizationOverview) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeOrganizationOverview) 

# DescribeOrganizationResourceCollectionHealth
<a name="API_DescribeOrganizationResourceCollectionHealth"></a>

Provides an overview of your system's health. If additional member accounts are part of your organization, you can filter those accounts using the `AccountIds` field.

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

```
POST /organization/health/resource-collection HTTP/1.1
Content-type: application/json

{
   "AccountIds": [ "string" ],
   "MaxResults": number,
   "NextToken": "string",
   "OrganizationalUnitIds": [ "string" ],
   "OrganizationResourceCollectionType": "string"
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [AccountIds](#API_DescribeOrganizationResourceCollectionHealth_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationResourceCollectionHealth-request-AccountIds"></a>
The ID of the AWS account.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 5 items.  
Length Constraints: Fixed length of 12.  
Pattern: `^\d{12}$`   
Required: No

 ** [MaxResults](#API_DescribeOrganizationResourceCollectionHealth_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationResourceCollectionHealth-request-MaxResults"></a>
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned `nextToken` value.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 500.  
Required: No

 ** [NextToken](#API_DescribeOrganizationResourceCollectionHealth_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationResourceCollectionHealth-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

 ** [OrganizationalUnitIds](#API_DescribeOrganizationResourceCollectionHealth_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationResourceCollectionHealth-request-OrganizationalUnitIds"></a>
The ID of the organizational unit.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 5 items.  
Length Constraints: Maximum length of 68.  
Pattern: `^ou-[0-9a-z]{4,32}-[a-z0-9]{8,32}$`   
Required: No

 ** [OrganizationResourceCollectionType](#API_DescribeOrganizationResourceCollectionHealth_RequestSyntax) **   <a name="DevOpsGuru-DescribeOrganizationResourceCollectionHealth-request-OrganizationResourceCollectionType"></a>
 An AWS resource collection type. This type specifies how analyzed AWS resources are defined. The two types of AWS resource collections supported are AWS CloudFormation stacks and AWS resources that contain the same AWS tag. DevOps Guru can be configured to analyze the AWS resources that are defined in the stacks or that are tagged using the same tag *key*. You can specify up to 1000 AWS CloudFormation stacks.   
Type: String  
Valid Values: `AWS_CLOUD_FORMATION | AWS_SERVICE | AWS_ACCOUNT | AWS_TAGS`   
Required: Yes

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

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

{
   "Account": [ 
      { 
         "AccountId": "string",
         "Insight": { 
            "OpenProactiveInsights": number,
            "OpenReactiveInsights": number
         }
      }
   ],
   "CloudFormation": [ 
      { 
         "AnalyzedResourceCount": number,
         "Insight": { 
            "MeanTimeToRecoverInMilliseconds": number,
            "OpenProactiveInsights": number,
            "OpenReactiveInsights": number
         },
         "StackName": "string"
      }
   ],
   "NextToken": "string",
   "Service": [ 
      { 
         "AnalyzedResourceCount": number,
         "Insight": { 
            "OpenProactiveInsights": number,
            "OpenReactiveInsights": number
         },
         "ServiceName": "string"
      }
   ],
   "Tags": [ 
      { 
         "AnalyzedResourceCount": number,
         "AppBoundaryKey": "string",
         "Insight": { 
            "MeanTimeToRecoverInMilliseconds": number,
            "OpenProactiveInsights": number,
            "OpenReactiveInsights": number
         },
         "TagValue": "string"
      }
   ]
}
```

## Response Elements
<a name="API_DescribeOrganizationResourceCollectionHealth_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.

 ** [Account](#API_DescribeOrganizationResourceCollectionHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationResourceCollectionHealth-response-Account"></a>
The name of the organization's account.  
Type: Array of [AccountHealth](API_AccountHealth.md) objects

 ** [CloudFormation](#API_DescribeOrganizationResourceCollectionHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationResourceCollectionHealth-response-CloudFormation"></a>
The returned `CloudFormationHealthOverview` object that contains an `InsightHealthOverview` object with the requested system health information.  
Type: Array of [CloudFormationHealth](API_CloudFormationHealth.md) objects

 ** [NextToken](#API_DescribeOrganizationResourceCollectionHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationResourceCollectionHealth-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [Service](#API_DescribeOrganizationResourceCollectionHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationResourceCollectionHealth-response-Service"></a>
An array of `ServiceHealth` objects that describes the health of the AWS services associated with the resources in the collection.  
Type: Array of [ServiceHealth](API_ServiceHealth.md) objects

 ** [Tags](#API_DescribeOrganizationResourceCollectionHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeOrganizationResourceCollectionHealth-response-Tags"></a>
Tags help you identify and organize your AWS resources. Many AWS services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an AWS Lambda function. For more information about using tags, see the [Tagging best practices](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html) whitepaper.   
Each AWS tag has two parts.   
+ A tag *key* (for example, `CostCenter`, `Environment`, `Project`, or `Secret`). Tag *keys* are case-sensitive.
+ An optional field known as a tag *value* (for example, `111122223333`, `Production`, or a team name). Omitting the tag *value* is the same as using an empty string. Like tag *keys*, tag *values* are case-sensitive.
Together these are known as *key*-*value* pairs.  
When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named `devops-guru-rds` and a *key* named `DevOps-Guru-RDS`, and these act as two different *keys*. Possible *key*/*value* pairs in your application might be `Devops-Guru-production-application/RDS` or `Devops-Guru-production-application/containers`.
Type: Array of [TagHealth](API_TagHealth.md) objects

## Errors
<a name="API_DescribeOrganizationResourceCollectionHealth_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeOrganizationResourceCollectionHealth_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/devops-guru-2020-12-01/DescribeOrganizationResourceCollectionHealth) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeOrganizationResourceCollectionHealth) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeOrganizationResourceCollectionHealth) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeOrganizationResourceCollectionHealth) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeOrganizationResourceCollectionHealth) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeOrganizationResourceCollectionHealth) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeOrganizationResourceCollectionHealth) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeOrganizationResourceCollectionHealth) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeOrganizationResourceCollectionHealth) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeOrganizationResourceCollectionHealth) 

# DescribeResourceCollectionHealth
<a name="API_DescribeResourceCollectionHealth"></a>

 Returns the number of open proactive insights, open reactive insights, and the Mean Time to Recover (MTTR) for all closed insights in resource collections in your account. You specify the type of AWS resources collection. The two types of AWS resource collections supported are AWS CloudFormation stacks and AWS resources that contain the same AWS tag. DevOps Guru can be configured to analyze the AWS resources that are defined in the stacks or that are tagged using the same tag *key*. You can specify up to 1000 AWS CloudFormation stacks. 

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

```
GET /accounts/health/resource-collection/ResourceCollectionType?NextToken=NextToken HTTP/1.1
```

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

The request uses the following URI parameters.

 ** [NextToken](#API_DescribeResourceCollectionHealth_RequestSyntax) **   <a name="DevOpsGuru-DescribeResourceCollectionHealth-request-uri-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [ResourceCollectionType](#API_DescribeResourceCollectionHealth_RequestSyntax) **   <a name="DevOpsGuru-DescribeResourceCollectionHealth-request-uri-ResourceCollectionType"></a>
 An AWS resource collection type. This type specifies how analyzed AWS resources are defined. The two types of AWS resource collections supported are AWS CloudFormation stacks and AWS resources that contain the same AWS tag. DevOps Guru can be configured to analyze the AWS resources that are defined in the stacks or that are tagged using the same tag *key*. You can specify up to 1000 AWS CloudFormation stacks.   
Valid Values: `AWS_CLOUD_FORMATION | AWS_SERVICE | AWS_TAGS`   
Required: Yes

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

The request does not have a request body.

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

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

{
   "CloudFormation": [ 
      { 
         "AnalyzedResourceCount": number,
         "Insight": { 
            "MeanTimeToRecoverInMilliseconds": number,
            "OpenProactiveInsights": number,
            "OpenReactiveInsights": number
         },
         "StackName": "string"
      }
   ],
   "NextToken": "string",
   "Service": [ 
      { 
         "AnalyzedResourceCount": number,
         "Insight": { 
            "OpenProactiveInsights": number,
            "OpenReactiveInsights": number
         },
         "ServiceName": "string"
      }
   ],
   "Tags": [ 
      { 
         "AnalyzedResourceCount": number,
         "AppBoundaryKey": "string",
         "Insight": { 
            "MeanTimeToRecoverInMilliseconds": number,
            "OpenProactiveInsights": number,
            "OpenReactiveInsights": number
         },
         "TagValue": "string"
      }
   ]
}
```

## Response Elements
<a name="API_DescribeResourceCollectionHealth_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.

 ** [CloudFormation](#API_DescribeResourceCollectionHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeResourceCollectionHealth-response-CloudFormation"></a>
 The returned `CloudFormationHealthOverview` object that contains an `InsightHealthOverview` object with the requested system health information.   
Type: Array of [CloudFormationHealth](API_CloudFormationHealth.md) objects

 ** [NextToken](#API_DescribeResourceCollectionHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeResourceCollectionHealth-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [Service](#API_DescribeResourceCollectionHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeResourceCollectionHealth-response-Service"></a>
An array of `ServiceHealth` objects that describes the health of the AWS services associated with the resources in the collection.  
Type: Array of [ServiceHealth](API_ServiceHealth.md) objects

 ** [Tags](#API_DescribeResourceCollectionHealth_ResponseSyntax) **   <a name="DevOpsGuru-DescribeResourceCollectionHealth-response-Tags"></a>
The AWS tags that are used by resources in the resource collection.  
Tags help you identify and organize your AWS resources. Many AWS services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an AWS Lambda function. For more information about using tags, see the [Tagging best practices](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html) whitepaper.   
Each AWS tag has two parts.   
+ A tag *key* (for example, `CostCenter`, `Environment`, `Project`, or `Secret`). Tag *keys* are case-sensitive.
+ An optional field known as a tag *value* (for example, `111122223333`, `Production`, or a team name). Omitting the tag *value* is the same as using an empty string. Like tag *keys*, tag *values* are case-sensitive.
Together these are known as *key*-*value* pairs.  
When you create a *key*, the case of characters in the *key* can be whatever you choose. After you create a *key*, it is case-sensitive. For example, DevOps Guru works with a *key* named `devops-guru-rds` and a *key* named `DevOps-Guru-RDS`, and these act as two different *keys*. Possible *key*/*value* pairs in your application might be `Devops-Guru-production-application/RDS` or `Devops-Guru-production-application/containers`.
Type: Array of [TagHealth](API_TagHealth.md) objects

## Errors
<a name="API_DescribeResourceCollectionHealth_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeResourceCollectionHealth_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/devops-guru-2020-12-01/DescribeResourceCollectionHealth) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeResourceCollectionHealth) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeResourceCollectionHealth) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeResourceCollectionHealth) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeResourceCollectionHealth) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeResourceCollectionHealth) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeResourceCollectionHealth) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeResourceCollectionHealth) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeResourceCollectionHealth) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeResourceCollectionHealth) 

# DescribeServiceIntegration
<a name="API_DescribeServiceIntegration"></a>

 Returns the integration status of services that are integrated with DevOps Guru.

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

```
GET /service-integrations HTTP/1.1
```

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

The request does not use any URI parameters.

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

The request does not have a request body.

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

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

{
   "ServiceIntegration": { 
      "KMSServerSideEncryption": { 
         "KMSKeyId": "string",
         "OptInStatus": "string",
         "Type": "string"
      },
      "LogsAnomalyDetection": { 
         "OptInStatus": "string"
      },
      "OpsCenter": { 
         "OptInStatus": "string"
      }
   }
}
```

## Response Elements
<a name="API_DescribeServiceIntegration_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.

 ** [ServiceIntegration](#API_DescribeServiceIntegration_ResponseSyntax) **   <a name="DevOpsGuru-DescribeServiceIntegration-response-ServiceIntegration"></a>
 Information about the integration of DevOps Guru with another AWS service, such as AWS Systems Manager.   
Type: [ServiceIntegrationConfig](API_ServiceIntegrationConfig.md) object

## Errors
<a name="API_DescribeServiceIntegration_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_DescribeServiceIntegration_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/devops-guru-2020-12-01/DescribeServiceIntegration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/DescribeServiceIntegration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/DescribeServiceIntegration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/DescribeServiceIntegration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/DescribeServiceIntegration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/DescribeServiceIntegration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/DescribeServiceIntegration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/DescribeServiceIntegration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/DescribeServiceIntegration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/DescribeServiceIntegration) 

# GetCostEstimation
<a name="API_GetCostEstimation"></a>

Returns an estimate of the monthly cost for DevOps Guru to analyze your AWS resources. For more information, see [Estimate your Amazon DevOps Guru costs](https://docs.aws.amazon.com/devops-guru/latest/userguide/cost-estimate.html) and [Amazon DevOps Guru pricing](http://aws.amazon.com/devops-guru/pricing/).

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

```
GET /cost-estimation?NextToken=NextToken HTTP/1.1
```

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

The request uses the following URI parameters.

 ** [NextToken](#API_GetCostEstimation_RequestSyntax) **   <a name="DevOpsGuru-GetCostEstimation-request-uri-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

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

The request does not have a request body.

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

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

{
   "Costs": [ 
      { 
         "Cost": number,
         "Count": number,
         "State": "string",
         "Type": "string",
         "UnitCost": number
      }
   ],
   "NextToken": "string",
   "ResourceCollection": { 
      "CloudFormation": { 
         "StackNames": [ "string" ]
      },
      "Tags": [ 
         { 
            "AppBoundaryKey": "string",
            "TagValues": [ "string" ]
         }
      ]
   },
   "Status": "string",
   "TimeRange": { 
      "EndTime": number,
      "StartTime": number
   },
   "TotalCost": number
}
```

## Response Elements
<a name="API_GetCostEstimation_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.

 ** [Costs](#API_GetCostEstimation_ResponseSyntax) **   <a name="DevOpsGuru-GetCostEstimation-response-Costs"></a>
An array of `ResourceCost` objects that each contains details about the monthly cost estimate to analyze one of your AWS resources.  
Type: Array of [ServiceResourceCost](API_ServiceResourceCost.md) objects

 ** [NextToken](#API_GetCostEstimation_ResponseSyntax) **   <a name="DevOpsGuru-GetCostEstimation-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [ResourceCollection](#API_GetCostEstimation_ResponseSyntax) **   <a name="DevOpsGuru-GetCostEstimation-response-ResourceCollection"></a>
The collection of the AWS resources used to create your monthly DevOps Guru cost estimate.  
Type: [CostEstimationResourceCollectionFilter](API_CostEstimationResourceCollectionFilter.md) object

 ** [Status](#API_GetCostEstimation_ResponseSyntax) **   <a name="DevOpsGuru-GetCostEstimation-response-Status"></a>
The status of creating this cost estimate. If it's still in progress, the status `ONGOING` is returned. If it is finished, the status `COMPLETED` is returned.  
Type: String  
Valid Values: `ONGOING | COMPLETED` 

 ** [TimeRange](#API_GetCostEstimation_ResponseSyntax) **   <a name="DevOpsGuru-GetCostEstimation-response-TimeRange"></a>
The start and end time of the cost estimation.  
Type: [CostEstimationTimeRange](API_CostEstimationTimeRange.md) object

 ** [TotalCost](#API_GetCostEstimation_ResponseSyntax) **   <a name="DevOpsGuru-GetCostEstimation-response-TotalCost"></a>
The estimated monthly cost to analyze the AWS resources. This value is the sum of the estimated costs to analyze each resource in the `Costs` object in this response.  
Type: Double

## Errors
<a name="API_GetCostEstimation_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_GetCostEstimation_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/devops-guru-2020-12-01/GetCostEstimation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/GetCostEstimation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/GetCostEstimation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/GetCostEstimation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/GetCostEstimation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/GetCostEstimation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/GetCostEstimation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/GetCostEstimation) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/GetCostEstimation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/GetCostEstimation) 

# GetResourceCollection
<a name="API_GetResourceCollection"></a>

 Returns lists of AWS resources that are of the specified resource collection type. The two types of AWS resource collections supported are AWS CloudFormation stacks and AWS resources that contain the same AWS tag. DevOps Guru can be configured to analyze the AWS resources that are defined in the stacks or that are tagged using the same tag *key*. You can specify up to 1000 AWS CloudFormation stacks. 

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

```
GET /resource-collections/ResourceCollectionType?NextToken=NextToken HTTP/1.1
```

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

The request uses the following URI parameters.

 ** [NextToken](#API_GetResourceCollection_RequestSyntax) **   <a name="DevOpsGuru-GetResourceCollection-request-uri-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [ResourceCollectionType](#API_GetResourceCollection_RequestSyntax) **   <a name="DevOpsGuru-GetResourceCollection-request-uri-ResourceCollectionType"></a>
 The type of AWS resource collection to return. You can use AWS CloudFormation stacks or AWS tags as a resource collection. You can use your resource collection to specify the resources you want DevOps Guru to analyze.   
Valid Values: `AWS_CLOUD_FORMATION | AWS_SERVICE | AWS_TAGS`   
Required: Yes

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

The request does not have a request body.

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

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

{
   "NextToken": "string",
   "ResourceCollection": { 
      "CloudFormation": { 
         "StackNames": [ "string" ]
      },
      "Tags": [ 
         { 
            "AppBoundaryKey": "string",
            "TagValues": [ "string" ]
         }
      ]
   }
}
```

## Response Elements
<a name="API_GetResourceCollection_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_GetResourceCollection_ResponseSyntax) **   <a name="DevOpsGuru-GetResourceCollection-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [ResourceCollection](#API_GetResourceCollection_ResponseSyntax) **   <a name="DevOpsGuru-GetResourceCollection-response-ResourceCollection"></a>
 The requested list of AWS resource collections. The two types of AWS resource collections supported are AWS CloudFormation stacks and AWS resources that contain the same AWS tag. DevOps Guru can be configured to analyze the AWS resources that are defined in the stacks or that are tagged using the same tag *key*. You can specify up to 1000 AWS CloudFormation stacks.   
Type: [ResourceCollectionFilter](API_ResourceCollectionFilter.md) object

## Errors
<a name="API_GetResourceCollection_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_GetResourceCollection_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/devops-guru-2020-12-01/GetResourceCollection) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/GetResourceCollection) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/GetResourceCollection) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/GetResourceCollection) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/GetResourceCollection) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/GetResourceCollection) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/GetResourceCollection) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/GetResourceCollection) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/GetResourceCollection) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/GetResourceCollection) 

# ListAnomaliesForInsight
<a name="API_ListAnomaliesForInsight"></a>

 Returns a list of the anomalies that belong to an insight that you specify using its ID. 

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

```
POST /anomalies/insight/InsightId HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "Filters": { 
      "ServiceCollection": { 
         "ServiceNames": [ "string" ]
      }
   },
   "MaxResults": number,
   "NextToken": "string",
   "StartTimeRange": { 
      "FromTime": number,
      "ToTime": number
   }
}
```

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

The request uses the following URI parameters.

 ** [InsightId](#API_ListAnomaliesForInsight_RequestSyntax) **   <a name="DevOpsGuru-ListAnomaliesForInsight-request-uri-InsightId"></a>
 The ID of the insight. The returned anomalies belong to this insight.   
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[\w-]*$`   
Required: Yes

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

The request accepts the following data in JSON format.

 ** [AccountId](#API_ListAnomaliesForInsight_RequestSyntax) **   <a name="DevOpsGuru-ListAnomaliesForInsight-request-AccountId"></a>
The ID of the AWS account.   
Type: String  
Length Constraints: Fixed length of 12.  
Pattern: `^\d{12}$`   
Required: No

 ** [Filters](#API_ListAnomaliesForInsight_RequestSyntax) **   <a name="DevOpsGuru-ListAnomaliesForInsight-request-Filters"></a>
 Specifies one or more service names that are used to list anomalies.   
Type: [ListAnomaliesForInsightFilters](API_ListAnomaliesForInsightFilters.md) object  
Required: No

 ** [MaxResults](#API_ListAnomaliesForInsight_RequestSyntax) **   <a name="DevOpsGuru-ListAnomaliesForInsight-request-MaxResults"></a>
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned `nextToken` value.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 500.  
Required: No

 ** [NextToken](#API_ListAnomaliesForInsight_RequestSyntax) **   <a name="DevOpsGuru-ListAnomaliesForInsight-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

 ** [StartTimeRange](#API_ListAnomaliesForInsight_RequestSyntax) **   <a name="DevOpsGuru-ListAnomaliesForInsight-request-StartTimeRange"></a>
 A time range used to specify when the requested anomalies started. All returned anomalies started during this time range.   
Type: [StartTimeRange](API_StartTimeRange.md) object  
Required: No

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

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

{
   "NextToken": "string",
   "ProactiveAnomalies": [ 
      { 
         "AnomalyReportedTimeRange": { 
            "CloseTime": number,
            "OpenTime": number
         },
         "AnomalyResources": [ 
            { 
               "Name": "string",
               "Type": "string"
            }
         ],
         "AnomalyTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "AssociatedInsightId": "string",
         "Description": "string",
         "Id": "string",
         "Limit": number,
         "PredictionTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "Severity": "string",
         "SourceDetails": { 
            "CloudWatchMetrics": [ 
               { 
                  "Dimensions": [ 
                     { 
                        "Name": "string",
                        "Value": "string"
                     }
                  ],
                  "MetricDataSummary": { 
                     "StatusCode": "string",
                     "TimestampMetricValuePairList": [ 
                        { 
                           "MetricValue": number,
                           "Timestamp": number
                        }
                     ]
                  },
                  "MetricName": "string",
                  "Namespace": "string",
                  "Period": number,
                  "Stat": "string",
                  "Unit": "string"
               }
            ],
            "PerformanceInsightsMetrics": [ 
               { 
                  "MetricDisplayName": "string",
                  "MetricQuery": { 
                     "Filter": { 
                        "string" : "string" 
                     },
                     "GroupBy": { 
                        "Dimensions": [ "string" ],
                        "Group": "string",
                        "Limit": number
                     },
                     "Metric": "string"
                  },
                  "ReferenceData": [ 
                     { 
                        "ComparisonValues": { 
                           "ReferenceMetric": { 
                              "MetricQuery": { 
                                 "Filter": { 
                                    "string" : "string" 
                                 },
                                 "GroupBy": { 
                                    "Dimensions": [ "string" ],
                                    "Group": "string",
                                    "Limit": number
                                 },
                                 "Metric": "string"
                              }
                           },
                           "ReferenceScalar": { 
                              "Value": number
                           }
                        },
                        "Name": "string"
                     }
                  ],
                  "StatsAtAnomaly": [ 
                     { 
                        "Type": "string",
                        "Value": number
                     }
                  ],
                  "StatsAtBaseline": [ 
                     { 
                        "Type": "string",
                        "Value": number
                     }
                  ],
                  "Unit": "string"
               }
            ]
         },
         "SourceMetadata": { 
            "Source": "string",
            "SourceResourceName": "string",
            "SourceResourceType": "string"
         },
         "Status": "string",
         "UpdateTime": number
      }
   ],
   "ReactiveAnomalies": [ 
      { 
         "AnomalyReportedTimeRange": { 
            "CloseTime": number,
            "OpenTime": number
         },
         "AnomalyResources": [ 
            { 
               "Name": "string",
               "Type": "string"
            }
         ],
         "AnomalyTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "AssociatedInsightId": "string",
         "CausalAnomalyId": "string",
         "Description": "string",
         "Id": "string",
         "Name": "string",
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "Severity": "string",
         "SourceDetails": { 
            "CloudWatchMetrics": [ 
               { 
                  "Dimensions": [ 
                     { 
                        "Name": "string",
                        "Value": "string"
                     }
                  ],
                  "MetricDataSummary": { 
                     "StatusCode": "string",
                     "TimestampMetricValuePairList": [ 
                        { 
                           "MetricValue": number,
                           "Timestamp": number
                        }
                     ]
                  },
                  "MetricName": "string",
                  "Namespace": "string",
                  "Period": number,
                  "Stat": "string",
                  "Unit": "string"
               }
            ],
            "PerformanceInsightsMetrics": [ 
               { 
                  "MetricDisplayName": "string",
                  "MetricQuery": { 
                     "Filter": { 
                        "string" : "string" 
                     },
                     "GroupBy": { 
                        "Dimensions": [ "string" ],
                        "Group": "string",
                        "Limit": number
                     },
                     "Metric": "string"
                  },
                  "ReferenceData": [ 
                     { 
                        "ComparisonValues": { 
                           "ReferenceMetric": { 
                              "MetricQuery": { 
                                 "Filter": { 
                                    "string" : "string" 
                                 },
                                 "GroupBy": { 
                                    "Dimensions": [ "string" ],
                                    "Group": "string",
                                    "Limit": number
                                 },
                                 "Metric": "string"
                              }
                           },
                           "ReferenceScalar": { 
                              "Value": number
                           }
                        },
                        "Name": "string"
                     }
                  ],
                  "StatsAtAnomaly": [ 
                     { 
                        "Type": "string",
                        "Value": number
                     }
                  ],
                  "StatsAtBaseline": [ 
                     { 
                        "Type": "string",
                        "Value": number
                     }
                  ],
                  "Unit": "string"
               }
            ]
         },
         "Status": "string",
         "Type": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListAnomaliesForInsight_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_ListAnomaliesForInsight_ResponseSyntax) **   <a name="DevOpsGuru-ListAnomaliesForInsight-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [ProactiveAnomalies](#API_ListAnomaliesForInsight_ResponseSyntax) **   <a name="DevOpsGuru-ListAnomaliesForInsight-response-ProactiveAnomalies"></a>
 An array of `ProactiveAnomalySummary` objects that represent the requested anomalies   
Type: Array of [ProactiveAnomalySummary](API_ProactiveAnomalySummary.md) objects

 ** [ReactiveAnomalies](#API_ListAnomaliesForInsight_ResponseSyntax) **   <a name="DevOpsGuru-ListAnomaliesForInsight-response-ReactiveAnomalies"></a>
 An array of `ReactiveAnomalySummary` objects that represent the requested anomalies   
Type: Array of [ReactiveAnomalySummary](API_ReactiveAnomalySummary.md) objects

## Errors
<a name="API_ListAnomaliesForInsight_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_ListAnomaliesForInsight_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/devops-guru-2020-12-01/ListAnomaliesForInsight) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/ListAnomaliesForInsight) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/ListAnomaliesForInsight) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/ListAnomaliesForInsight) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/ListAnomaliesForInsight) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/ListAnomaliesForInsight) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/ListAnomaliesForInsight) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/ListAnomaliesForInsight) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/ListAnomaliesForInsight) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/ListAnomaliesForInsight) 

# ListAnomalousLogGroups
<a name="API_ListAnomalousLogGroups"></a>

 Returns the list of log groups that contain log anomalies. 

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

```
POST /list-log-anomalies HTTP/1.1
Content-type: application/json

{
   "InsightId": "string",
   "MaxResults": number,
   "NextToken": "string"
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [InsightId](#API_ListAnomalousLogGroups_RequestSyntax) **   <a name="DevOpsGuru-ListAnomalousLogGroups-request-InsightId"></a>
 The ID of the insight containing the log groups.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[\w-]*$`   
Required: Yes

 ** [MaxResults](#API_ListAnomalousLogGroups_RequestSyntax) **   <a name="DevOpsGuru-ListAnomalousLogGroups-request-MaxResults"></a>
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned `nextToken` value.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 200.  
Required: No

 ** [NextToken](#API_ListAnomalousLogGroups_RequestSyntax) **   <a name="DevOpsGuru-ListAnomalousLogGroups-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

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

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

{
   "AnomalousLogGroups": [ 
      { 
         "ImpactEndTime": number,
         "ImpactStartTime": number,
         "LogAnomalyShowcases": [ 
            { 
               "LogAnomalyClasses": [ 
                  { 
                     "Explanation": "string",
                     "LogAnomalyToken": "string",
                     "LogAnomalyType": "string",
                     "LogEventId": "string",
                     "LogEventTimestamp": number,
                     "LogStreamName": "string",
                     "NumberOfLogLinesOccurrences": number
                  }
               ]
            }
         ],
         "LogGroupName": "string",
         "NumberOfLogLinesScanned": number
      }
   ],
   "InsightId": "string",
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListAnomalousLogGroups_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.

 ** [AnomalousLogGroups](#API_ListAnomalousLogGroups_ResponseSyntax) **   <a name="DevOpsGuru-ListAnomalousLogGroups-response-AnomalousLogGroups"></a>
 The list of Amazon CloudWatch log groups that are related to an insight.   
Type: Array of [AnomalousLogGroup](API_AnomalousLogGroup.md) objects

 ** [InsightId](#API_ListAnomalousLogGroups_ResponseSyntax) **   <a name="DevOpsGuru-ListAnomalousLogGroups-response-InsightId"></a>
 The ID of the insight containing the log groups.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[\w-]*$` 

 ** [NextToken](#API_ListAnomalousLogGroups_ResponseSyntax) **   <a name="DevOpsGuru-ListAnomalousLogGroups-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

## Errors
<a name="API_ListAnomalousLogGroups_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_ListAnomalousLogGroups_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/devops-guru-2020-12-01/ListAnomalousLogGroups) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/ListAnomalousLogGroups) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/ListAnomalousLogGroups) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/ListAnomalousLogGroups) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/ListAnomalousLogGroups) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/ListAnomalousLogGroups) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/ListAnomalousLogGroups) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/ListAnomalousLogGroups) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/ListAnomalousLogGroups) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/ListAnomalousLogGroups) 

# ListEvents
<a name="API_ListEvents"></a>

 Returns a list of the events emitted by the resources that are evaluated by DevOps Guru. You can use filters to specify which events are returned. 

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

```
POST /events HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "Filters": { 
      "DataSource": "string",
      "EventClass": "string",
      "EventSource": "string",
      "EventTimeRange": { 
         "FromTime": number,
         "ToTime": number
      },
      "InsightId": "string",
      "ResourceCollection": { 
         "CloudFormation": { 
            "StackNames": [ "string" ]
         },
         "Tags": [ 
            { 
               "AppBoundaryKey": "string",
               "TagValues": [ "string" ]
            }
         ]
      }
   },
   "MaxResults": number,
   "NextToken": "string"
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [AccountId](#API_ListEvents_RequestSyntax) **   <a name="DevOpsGuru-ListEvents-request-AccountId"></a>
The ID of the AWS account.   
Type: String  
Length Constraints: Fixed length of 12.  
Pattern: `^\d{12}$`   
Required: No

 ** [Filters](#API_ListEvents_RequestSyntax) **   <a name="DevOpsGuru-ListEvents-request-Filters"></a>
 A `ListEventsFilters` object used to specify which events to return.   
Type: [ListEventsFilters](API_ListEventsFilters.md) object  
Required: Yes

 ** [MaxResults](#API_ListEvents_RequestSyntax) **   <a name="DevOpsGuru-ListEvents-request-MaxResults"></a>
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned `nextToken` value.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 200.  
Required: No

 ** [NextToken](#API_ListEvents_RequestSyntax) **   <a name="DevOpsGuru-ListEvents-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

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

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

{
   "Events": [ 
      { 
         "DataSource": "string",
         "EventClass": "string",
         "EventSource": "string",
         "Id": "string",
         "Name": "string",
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "Resources": [ 
            { 
               "Arn": "string",
               "Name": "string",
               "Type": "string"
            }
         ],
         "Time": number
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListEvents_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.

 ** [Events](#API_ListEvents_ResponseSyntax) **   <a name="DevOpsGuru-ListEvents-response-Events"></a>
 A list of the requested events.   
Type: Array of [Event](API_Event.md) objects

 ** [NextToken](#API_ListEvents_ResponseSyntax) **   <a name="DevOpsGuru-ListEvents-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

## Errors
<a name="API_ListEvents_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_ListEvents_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/devops-guru-2020-12-01/ListEvents) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/ListEvents) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/ListEvents) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/ListEvents) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/ListEvents) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/ListEvents) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/ListEvents) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/ListEvents) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/ListEvents) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/ListEvents) 

# ListInsights
<a name="API_ListInsights"></a>

 Returns a list of insights in your AWS account. You can specify which insights are returned by their start time and status (`ONGOING`, `CLOSED`, or `ANY`). 

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

```
POST /insights HTTP/1.1
Content-type: application/json

{
   "MaxResults": number,
   "NextToken": "string",
   "StatusFilter": { 
      "Any": { 
         "StartTimeRange": { 
            "FromTime": number,
            "ToTime": number
         },
         "Type": "string"
      },
      "Closed": { 
         "EndTimeRange": { 
            "FromTime": number,
            "ToTime": number
         },
         "Type": "string"
      },
      "Ongoing": { 
         "Type": "string"
      }
   }
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [MaxResults](#API_ListInsights_RequestSyntax) **   <a name="DevOpsGuru-ListInsights-request-MaxResults"></a>
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned `nextToken` value.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_ListInsights_RequestSyntax) **   <a name="DevOpsGuru-ListInsights-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

 ** [StatusFilter](#API_ListInsights_RequestSyntax) **   <a name="DevOpsGuru-ListInsights-request-StatusFilter"></a>
 A filter used to filter the returned insights by their status. You can specify one status filter.   
Type: [ListInsightsStatusFilter](API_ListInsightsStatusFilter.md) object  
Required: Yes

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

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

{
   "NextToken": "string",
   "ProactiveInsights": [ 
      { 
         "AssociatedResourceArns": [ "string" ],
         "Id": "string",
         "InsightTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "Name": "string",
         "PredictionTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "ServiceCollection": { 
            "ServiceNames": [ "string" ]
         },
         "Severity": "string",
         "Status": "string"
      }
   ],
   "ReactiveInsights": [ 
      { 
         "AssociatedResourceArns": [ "string" ],
         "Id": "string",
         "InsightTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "Name": "string",
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "ServiceCollection": { 
            "ServiceNames": [ "string" ]
         },
         "Severity": "string",
         "Status": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListInsights_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_ListInsights_ResponseSyntax) **   <a name="DevOpsGuru-ListInsights-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [ProactiveInsights](#API_ListInsights_ResponseSyntax) **   <a name="DevOpsGuru-ListInsights-response-ProactiveInsights"></a>
 The returned list of proactive insights.   
Type: Array of [ProactiveInsightSummary](API_ProactiveInsightSummary.md) objects

 ** [ReactiveInsights](#API_ListInsights_ResponseSyntax) **   <a name="DevOpsGuru-ListInsights-response-ReactiveInsights"></a>
 The returned list of reactive insights.   
Type: Array of [ReactiveInsightSummary](API_ReactiveInsightSummary.md) objects

## Errors
<a name="API_ListInsights_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_ListInsights_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/devops-guru-2020-12-01/ListInsights) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/ListInsights) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/ListInsights) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/ListInsights) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/ListInsights) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/ListInsights) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/ListInsights) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/ListInsights) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/ListInsights) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/ListInsights) 

# ListMonitoredResources
<a name="API_ListMonitoredResources"></a>

 Returns the list of resources that are being monitored by DevOps Guru. 

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

```
POST /monitoredResources HTTP/1.1
Content-type: application/json

{
   "Filters": { 
      "ResourcePermission": "string",
      "ResourceTypeFilters": [ "string" ]
   },
   "MaxResults": number,
   "NextToken": "string"
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [Filters](#API_ListMonitoredResources_RequestSyntax) **   <a name="DevOpsGuru-ListMonitoredResources-request-Filters"></a>
 Filters to determine which monitored resources you want to retrieve. You can filter by resource type or resource permission status.   
Type: [ListMonitoredResourcesFilters](API_ListMonitoredResourcesFilters.md) object  
Required: No

 ** [MaxResults](#API_ListMonitoredResources_RequestSyntax) **   <a name="DevOpsGuru-ListMonitoredResources-request-MaxResults"></a>
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned `nextToken` value.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 50.  
Required: No

 ** [NextToken](#API_ListMonitoredResources_RequestSyntax) **   <a name="DevOpsGuru-ListMonitoredResources-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

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

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

{
   "MonitoredResourceIdentifiers": [ 
      { 
         "LastUpdated": number,
         "MonitoredResourceName": "string",
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "ResourcePermission": "string",
         "Type": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListMonitoredResources_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.

 ** [MonitoredResourceIdentifiers](#API_ListMonitoredResources_ResponseSyntax) **   <a name="DevOpsGuru-ListMonitoredResources-response-MonitoredResourceIdentifiers"></a>
 Information about the resource that is being monitored, including the name of the resource, the type of resource, and whether or not permission is given to DevOps Guru to access that resource.   
Type: Array of [MonitoredResourceIdentifier](API_MonitoredResourceIdentifier.md) objects

 ** [NextToken](#API_ListMonitoredResources_ResponseSyntax) **   <a name="DevOpsGuru-ListMonitoredResources-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

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

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

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_ListMonitoredResources_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/devops-guru-2020-12-01/ListMonitoredResources) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/ListMonitoredResources) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/ListMonitoredResources) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/ListMonitoredResources) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/ListMonitoredResources) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/ListMonitoredResources) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/ListMonitoredResources) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/ListMonitoredResources) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/ListMonitoredResources) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/ListMonitoredResources) 

# ListNotificationChannels
<a name="API_ListNotificationChannels"></a>

 Returns a list of notification channels configured for DevOps Guru. Each notification channel is used to notify you when DevOps Guru generates an insight that contains information about how to improve your operations. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS). 

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

```
POST /channels HTTP/1.1
Content-type: application/json

{
   "NextToken": "string"
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [NextToken](#API_ListNotificationChannels_RequestSyntax) **   <a name="DevOpsGuru-ListNotificationChannels-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

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

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

{
   "Channels": [ 
      { 
         "Config": { 
            "Filters": { 
               "MessageTypes": [ "string" ],
               "Severities": [ "string" ]
            },
            "Sns": { 
               "TopicArn": "string"
            }
         },
         "Id": "string"
      }
   ],
   "NextToken": "string"
}
```

## Response Elements
<a name="API_ListNotificationChannels_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.

 ** [Channels](#API_ListNotificationChannels_ResponseSyntax) **   <a name="DevOpsGuru-ListNotificationChannels-response-Channels"></a>
 An array that contains the requested notification channels.   
Type: Array of [NotificationChannel](API_NotificationChannel.md) objects

 ** [NextToken](#API_ListNotificationChannels_ResponseSyntax) **   <a name="DevOpsGuru-ListNotificationChannels-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

## Errors
<a name="API_ListNotificationChannels_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_ListNotificationChannels_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/devops-guru-2020-12-01/ListNotificationChannels) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/ListNotificationChannels) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/ListNotificationChannels) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/ListNotificationChannels) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/ListNotificationChannels) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/ListNotificationChannels) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/ListNotificationChannels) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/ListNotificationChannels) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/ListNotificationChannels) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/ListNotificationChannels) 

# ListOrganizationInsights
<a name="API_ListOrganizationInsights"></a>

Returns a list of insights associated with the account or OU Id.

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

```
POST /organization/insights HTTP/1.1
Content-type: application/json

{
   "AccountIds": [ "string" ],
   "MaxResults": number,
   "NextToken": "string",
   "OrganizationalUnitIds": [ "string" ],
   "StatusFilter": { 
      "Any": { 
         "StartTimeRange": { 
            "FromTime": number,
            "ToTime": number
         },
         "Type": "string"
      },
      "Closed": { 
         "EndTimeRange": { 
            "FromTime": number,
            "ToTime": number
         },
         "Type": "string"
      },
      "Ongoing": { 
         "Type": "string"
      }
   }
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [AccountIds](#API_ListOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-ListOrganizationInsights-request-AccountIds"></a>
The ID of the AWS account.   
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 1 item.  
Length Constraints: Fixed length of 12.  
Pattern: `^\d{12}$`   
Required: No

 ** [MaxResults](#API_ListOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-ListOrganizationInsights-request-MaxResults"></a>
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned `nextToken` value.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_ListOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-ListOrganizationInsights-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

 ** [OrganizationalUnitIds](#API_ListOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-ListOrganizationInsights-request-OrganizationalUnitIds"></a>
The ID of the organizational unit.  
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 1 item.  
Length Constraints: Maximum length of 68.  
Pattern: `^ou-[0-9a-z]{4,32}-[a-z0-9]{8,32}$`   
Required: No

 ** [StatusFilter](#API_ListOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-ListOrganizationInsights-request-StatusFilter"></a>
 A filter used by `ListInsights` to specify which insights to return.   
Type: [ListInsightsStatusFilter](API_ListInsightsStatusFilter.md) object  
Required: Yes

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

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

{
   "NextToken": "string",
   "ProactiveInsights": [ 
      { 
         "AccountId": "string",
         "Id": "string",
         "InsightTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "Name": "string",
         "OrganizationalUnitId": "string",
         "PredictionTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "ServiceCollection": { 
            "ServiceNames": [ "string" ]
         },
         "Severity": "string",
         "Status": "string"
      }
   ],
   "ReactiveInsights": [ 
      { 
         "AccountId": "string",
         "Id": "string",
         "InsightTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "Name": "string",
         "OrganizationalUnitId": "string",
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "ServiceCollection": { 
            "ServiceNames": [ "string" ]
         },
         "Severity": "string",
         "Status": "string"
      }
   ]
}
```

## Response Elements
<a name="API_ListOrganizationInsights_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_ListOrganizationInsights_ResponseSyntax) **   <a name="DevOpsGuru-ListOrganizationInsights-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [ProactiveInsights](#API_ListOrganizationInsights_ResponseSyntax) **   <a name="DevOpsGuru-ListOrganizationInsights-response-ProactiveInsights"></a>
An integer that specifies the number of open proactive insights in your AWS account.  
Type: Array of [ProactiveOrganizationInsightSummary](API_ProactiveOrganizationInsightSummary.md) objects

 ** [ReactiveInsights](#API_ListOrganizationInsights_ResponseSyntax) **   <a name="DevOpsGuru-ListOrganizationInsights-response-ReactiveInsights"></a>
An integer that specifies the number of open reactive insights in your AWS account.  
Type: Array of [ReactiveOrganizationInsightSummary](API_ReactiveOrganizationInsightSummary.md) objects

## Errors
<a name="API_ListOrganizationInsights_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_ListOrganizationInsights_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/devops-guru-2020-12-01/ListOrganizationInsights) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/ListOrganizationInsights) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/ListOrganizationInsights) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/ListOrganizationInsights) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/ListOrganizationInsights) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/ListOrganizationInsights) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/ListOrganizationInsights) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/ListOrganizationInsights) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/ListOrganizationInsights) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/ListOrganizationInsights) 

# ListRecommendations
<a name="API_ListRecommendations"></a>

 Returns a list of a specified insight's recommendations. Each recommendation includes a list of related metrics and a list of related events. 

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

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

{
   "AccountId": "string",
   "InsightId": "string",
   "Locale": "string",
   "NextToken": "string"
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [AccountId](#API_ListRecommendations_RequestSyntax) **   <a name="DevOpsGuru-ListRecommendations-request-AccountId"></a>
The ID of the AWS account.   
Type: String  
Length Constraints: Fixed length of 12.  
Pattern: `^\d{12}$`   
Required: No

 ** [InsightId](#API_ListRecommendations_RequestSyntax) **   <a name="DevOpsGuru-ListRecommendations-request-InsightId"></a>
 The ID of the requested insight.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[\w-]*$`   
Required: Yes

 ** [Locale](#API_ListRecommendations_RequestSyntax) **   <a name="DevOpsGuru-ListRecommendations-request-Locale"></a>
A locale that specifies the language to use for recommendations.  
Type: String  
Valid Values: `DE_DE | EN_US | EN_GB | ES_ES | FR_FR | IT_IT | JA_JP | KO_KR | PT_BR | ZH_CN | ZH_TW`   
Required: No

 ** [NextToken](#API_ListRecommendations_RequestSyntax) **   <a name="DevOpsGuru-ListRecommendations-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

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

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

{
   "NextToken": "string",
   "Recommendations": [ 
      { 
         "Category": "string",
         "Description": "string",
         "Link": "string",
         "Name": "string",
         "Reason": "string",
         "RelatedAnomalies": [ 
            { 
               "AnomalyId": "string",
               "Resources": [ 
                  { 
                     "Name": "string",
                     "Type": "string"
                  }
               ],
               "SourceDetails": [ 
                  { 
                     "CloudWatchMetrics": [ 
                        { 
                           "MetricName": "string",
                           "Namespace": "string"
                        }
                     ]
                  }
               ]
            }
         ],
         "RelatedEvents": [ 
            { 
               "Name": "string",
               "Resources": [ 
                  { 
                     "Name": "string",
                     "Type": "string"
                  }
               ]
            }
         ]
      }
   ]
}
```

## Response Elements
<a name="API_ListRecommendations_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_ListRecommendations_ResponseSyntax) **   <a name="DevOpsGuru-ListRecommendations-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [Recommendations](#API_ListRecommendations_ResponseSyntax) **   <a name="DevOpsGuru-ListRecommendations-response-Recommendations"></a>
 An array of the requested recommendations.   
Type: Array of [Recommendation](API_Recommendation.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 10 items.

## Errors
<a name="API_ListRecommendations_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_ListRecommendations_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/devops-guru-2020-12-01/ListRecommendations) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/ListRecommendations) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/ListRecommendations) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/ListRecommendations) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/ListRecommendations) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/ListRecommendations) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/ListRecommendations) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/ListRecommendations) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/ListRecommendations) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/ListRecommendations) 

# PutFeedback
<a name="API_PutFeedback"></a>

 Collects customer feedback about the specified insight. 

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

```
PUT /feedback HTTP/1.1
Content-type: application/json

{
   "InsightFeedback": { 
      "Feedback": "string",
      "Id": "string"
   }
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [InsightFeedback](#API_PutFeedback_RequestSyntax) **   <a name="DevOpsGuru-PutFeedback-request-InsightFeedback"></a>
 The feedback from customers is about the recommendations in this insight.   
Type: [InsightFeedback](API_InsightFeedback.md) object  
Required: No

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

```
HTTP/1.1 200
```

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

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

## Errors
<a name="API_PutFeedback_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** ConflictException **   
 An exception that is thrown when a conflict occurs.     
 ** ResourceId **   
 The ID of the AWS resource in which a conflict occurred.   
 ** ResourceType **   
 The type of the AWS resource in which a conflict occurred. 
HTTP Status Code: 409

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_PutFeedback_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/devops-guru-2020-12-01/PutFeedback) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/PutFeedback) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/PutFeedback) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/PutFeedback) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/PutFeedback) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/PutFeedback) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/PutFeedback) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/PutFeedback) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/PutFeedback) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/PutFeedback) 

# RemoveNotificationChannel
<a name="API_RemoveNotificationChannel"></a>

 Removes a notification channel from DevOps Guru. A notification channel is used to notify you when DevOps Guru generates an insight that contains information about how to improve your operations. 

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

```
DELETE /channels/Id HTTP/1.1
```

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

The request uses the following URI parameters.

 ** [Id](#API_RemoveNotificationChannel_RequestSyntax) **   <a name="DevOpsGuru-RemoveNotificationChannel-request-uri-Id"></a>
 The ID of the notification channel to be removed.   
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: Yes

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

The request does not have a request body.

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

```
HTTP/1.1 200
```

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

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

## Errors
<a name="API_RemoveNotificationChannel_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** ConflictException **   
 An exception that is thrown when a conflict occurs.     
 ** ResourceId **   
 The ID of the AWS resource in which a conflict occurred.   
 ** ResourceType **   
 The type of the AWS resource in which a conflict occurred. 
HTTP Status Code: 409

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_RemoveNotificationChannel_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/devops-guru-2020-12-01/RemoveNotificationChannel) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/RemoveNotificationChannel) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/RemoveNotificationChannel) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/RemoveNotificationChannel) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/RemoveNotificationChannel) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/RemoveNotificationChannel) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/RemoveNotificationChannel) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/RemoveNotificationChannel) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/RemoveNotificationChannel) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/RemoveNotificationChannel) 

# SearchInsights
<a name="API_SearchInsights"></a>

 Returns a list of insights in your AWS account. You can specify which insights are returned by their start time, one or more statuses (`ONGOING` or `CLOSED`), one or more severities (`LOW`, `MEDIUM`, and `HIGH`), and type (`REACTIVE` or `PROACTIVE`). 

 Use the `Filters` parameter to specify status and severity search parameters. Use the `Type` parameter to specify `REACTIVE` or `PROACTIVE` in your search. 

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

```
POST /insights/search HTTP/1.1
Content-type: application/json

{
   "Filters": { 
      "ResourceCollection": { 
         "CloudFormation": { 
            "StackNames": [ "string" ]
         },
         "Tags": [ 
            { 
               "AppBoundaryKey": "string",
               "TagValues": [ "string" ]
            }
         ]
      },
      "ServiceCollection": { 
         "ServiceNames": [ "string" ]
      },
      "Severities": [ "string" ],
      "Statuses": [ "string" ]
   },
   "MaxResults": number,
   "NextToken": "string",
   "StartTimeRange": { 
      "FromTime": number,
      "ToTime": number
   },
   "Type": "string"
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [Filters](#API_SearchInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchInsights-request-Filters"></a>
 A `SearchInsightsFilters` object that is used to set the severity and status filters on your insight search.   
Type: [SearchInsightsFilters](API_SearchInsightsFilters.md) object  
Required: No

 ** [MaxResults](#API_SearchInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchInsights-request-MaxResults"></a>
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned `nextToken` value.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_SearchInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchInsights-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

 ** [StartTimeRange](#API_SearchInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchInsights-request-StartTimeRange"></a>
 The start of the time range passed in. Returned insights occurred after this time.   
Type: [StartTimeRange](API_StartTimeRange.md) object  
Required: Yes

 ** [Type](#API_SearchInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchInsights-request-Type"></a>
 The type of insights you are searching for (`REACTIVE` or `PROACTIVE`).   
Type: String  
Valid Values: `REACTIVE | PROACTIVE`   
Required: Yes

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

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

{
   "NextToken": "string",
   "ProactiveInsights": [ 
      { 
         "AssociatedResourceArns": [ "string" ],
         "Id": "string",
         "InsightTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "Name": "string",
         "PredictionTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "ServiceCollection": { 
            "ServiceNames": [ "string" ]
         },
         "Severity": "string",
         "Status": "string"
      }
   ],
   "ReactiveInsights": [ 
      { 
         "AssociatedResourceArns": [ "string" ],
         "Id": "string",
         "InsightTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "Name": "string",
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "ServiceCollection": { 
            "ServiceNames": [ "string" ]
         },
         "Severity": "string",
         "Status": "string"
      }
   ]
}
```

## Response Elements
<a name="API_SearchInsights_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_SearchInsights_ResponseSyntax) **   <a name="DevOpsGuru-SearchInsights-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [ProactiveInsights](#API_SearchInsights_ResponseSyntax) **   <a name="DevOpsGuru-SearchInsights-response-ProactiveInsights"></a>
 The returned proactive insights.   
Type: Array of [ProactiveInsightSummary](API_ProactiveInsightSummary.md) objects

 ** [ReactiveInsights](#API_SearchInsights_ResponseSyntax) **   <a name="DevOpsGuru-SearchInsights-response-ReactiveInsights"></a>
 The returned reactive insights.   
Type: Array of [ReactiveInsightSummary](API_ReactiveInsightSummary.md) objects

## Errors
<a name="API_SearchInsights_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_SearchInsights_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/devops-guru-2020-12-01/SearchInsights) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/SearchInsights) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/SearchInsights) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/SearchInsights) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/SearchInsights) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/SearchInsights) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/SearchInsights) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/SearchInsights) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/SearchInsights) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/SearchInsights) 

# SearchOrganizationInsights
<a name="API_SearchOrganizationInsights"></a>

 Returns a list of insights in your organization. You can specify which insights are returned by their start time, one or more statuses (`ONGOING`, `CLOSED`, and `CLOSED`), one or more severities (`LOW`, `MEDIUM`, and `HIGH`), and type (`REACTIVE` or `PROACTIVE`). 

 Use the `Filters` parameter to specify status and severity search parameters. Use the `Type` parameter to specify `REACTIVE` or `PROACTIVE` in your search. 

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

```
POST /organization/insights/search HTTP/1.1
Content-type: application/json

{
   "AccountIds": [ "string" ],
   "Filters": { 
      "ResourceCollection": { 
         "CloudFormation": { 
            "StackNames": [ "string" ]
         },
         "Tags": [ 
            { 
               "AppBoundaryKey": "string",
               "TagValues": [ "string" ]
            }
         ]
      },
      "ServiceCollection": { 
         "ServiceNames": [ "string" ]
      },
      "Severities": [ "string" ],
      "Statuses": [ "string" ]
   },
   "MaxResults": number,
   "NextToken": "string",
   "StartTimeRange": { 
      "FromTime": number,
      "ToTime": number
   },
   "Type": "string"
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [AccountIds](#API_SearchOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchOrganizationInsights-request-AccountIds"></a>
The ID of the AWS account.   
Type: Array of strings  
Array Members: Fixed number of 1 item.  
Length Constraints: Fixed length of 12.  
Pattern: `^\d{12}$`   
Required: Yes

 ** [Filters](#API_SearchOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchOrganizationInsights-request-Filters"></a>
 A `SearchOrganizationInsightsFilters` object that is used to set the severity and status filters on your insight search.   
Type: [SearchOrganizationInsightsFilters](API_SearchOrganizationInsightsFilters.md) object  
Required: No

 ** [MaxResults](#API_SearchOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchOrganizationInsights-request-MaxResults"></a>
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned `nextToken` value.  
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 100.  
Required: No

 ** [NextToken](#API_SearchOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchOrganizationInsights-request-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$`   
Required: No

 ** [StartTimeRange](#API_SearchOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchOrganizationInsights-request-StartTimeRange"></a>
 A time range used to specify when the behavior of an insight or anomaly started.   
Type: [StartTimeRange](API_StartTimeRange.md) object  
Required: Yes

 ** [Type](#API_SearchOrganizationInsights_RequestSyntax) **   <a name="DevOpsGuru-SearchOrganizationInsights-request-Type"></a>
 The type of insights you are searching for (`REACTIVE` or `PROACTIVE`).   
Type: String  
Valid Values: `REACTIVE | PROACTIVE`   
Required: Yes

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

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

{
   "NextToken": "string",
   "ProactiveInsights": [ 
      { 
         "AssociatedResourceArns": [ "string" ],
         "Id": "string",
         "InsightTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "Name": "string",
         "PredictionTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "ServiceCollection": { 
            "ServiceNames": [ "string" ]
         },
         "Severity": "string",
         "Status": "string"
      }
   ],
   "ReactiveInsights": [ 
      { 
         "AssociatedResourceArns": [ "string" ],
         "Id": "string",
         "InsightTimeRange": { 
            "EndTime": number,
            "StartTime": number
         },
         "Name": "string",
         "ResourceCollection": { 
            "CloudFormation": { 
               "StackNames": [ "string" ]
            },
            "Tags": [ 
               { 
                  "AppBoundaryKey": "string",
                  "TagValues": [ "string" ]
               }
            ]
         },
         "ServiceCollection": { 
            "ServiceNames": [ "string" ]
         },
         "Severity": "string",
         "Status": "string"
      }
   ]
}
```

## Response Elements
<a name="API_SearchOrganizationInsights_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_SearchOrganizationInsights_ResponseSyntax) **   <a name="DevOpsGuru-SearchOrganizationInsights-response-NextToken"></a>
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.  
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$` 

 ** [ProactiveInsights](#API_SearchOrganizationInsights_ResponseSyntax) **   <a name="DevOpsGuru-SearchOrganizationInsights-response-ProactiveInsights"></a>
An integer that specifies the number of open proactive insights in your AWS account.  
Type: Array of [ProactiveInsightSummary](API_ProactiveInsightSummary.md) objects

 ** [ReactiveInsights](#API_SearchOrganizationInsights_ResponseSyntax) **   <a name="DevOpsGuru-SearchOrganizationInsights-response-ReactiveInsights"></a>
An integer that specifies the number of open reactive insights in your AWS account.  
Type: Array of [ReactiveInsightSummary](API_ReactiveInsightSummary.md) objects

## Errors
<a name="API_SearchOrganizationInsights_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_SearchOrganizationInsights_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/devops-guru-2020-12-01/SearchOrganizationInsights) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/SearchOrganizationInsights) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/SearchOrganizationInsights) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/SearchOrganizationInsights) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/SearchOrganizationInsights) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/SearchOrganizationInsights) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/SearchOrganizationInsights) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/SearchOrganizationInsights) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/SearchOrganizationInsights) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/SearchOrganizationInsights) 

# StartCostEstimation
<a name="API_StartCostEstimation"></a>

Starts the creation of an estimate of the monthly cost to analyze your AWS resources.

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

```
PUT /cost-estimation HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "ResourceCollection": { 
      "CloudFormation": { 
         "StackNames": [ "string" ]
      },
      "Tags": [ 
         { 
            "AppBoundaryKey": "string",
            "TagValues": [ "string" ]
         }
      ]
   }
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [ClientToken](#API_StartCostEstimation_RequestSyntax) **   <a name="DevOpsGuru-StartCostEstimation-request-ClientToken"></a>
The idempotency token used to identify each cost estimate request.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 100.  
Pattern: `^[a-zA-Z0-9]+[a-zA-Z0-9-]*$`   
Required: No

 ** [ResourceCollection](#API_StartCostEstimation_RequestSyntax) **   <a name="DevOpsGuru-StartCostEstimation-request-ResourceCollection"></a>
The collection of AWS resources used to create a monthly DevOps Guru cost estimate.  
Type: [CostEstimationResourceCollectionFilter](API_CostEstimationResourceCollectionFilter.md) object  
Required: Yes

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

```
HTTP/1.1 200
```

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

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

## Errors
<a name="API_StartCostEstimation_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** ConflictException **   
 An exception that is thrown when a conflict occurs.     
 ** ResourceId **   
 The ID of the AWS resource in which a conflict occurred.   
 ** ResourceType **   
 The type of the AWS resource in which a conflict occurred. 
HTTP Status Code: 409

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
A requested resource could not be found    
 ** ResourceId **   
 The ID of the AWS resource that could not be found.   
 ** ResourceType **   
 The type of the AWS resource that could not be found. 
HTTP Status Code: 404

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_StartCostEstimation_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/devops-guru-2020-12-01/StartCostEstimation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/StartCostEstimation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/StartCostEstimation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/StartCostEstimation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/StartCostEstimation) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/StartCostEstimation) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/StartCostEstimation) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/StartCostEstimation) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/StartCostEstimation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/StartCostEstimation) 

# UpdateEventSourcesConfig
<a name="API_UpdateEventSourcesConfig"></a>

Enables or disables integration with a service that can be integrated with DevOps Guru. The one service that can be integrated with DevOps Guru is Amazon CodeGuru Profiler, which can produce proactive recommendations which can be stored and viewed in DevOps Guru.

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

```
PUT /event-sources HTTP/1.1
Content-type: application/json

{
   "EventSources": { 
      "AmazonCodeGuruProfiler": { 
         "Status": "string"
      }
   }
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [EventSources](#API_UpdateEventSourcesConfig_RequestSyntax) **   <a name="DevOpsGuru-UpdateEventSourcesConfig-request-EventSources"></a>
Configuration information about the integration of DevOps Guru as the Consumer via EventBridge with another AWS Service.  
Type: [EventSourcesConfig](API_EventSourcesConfig.md) object  
Required: No

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

```
HTTP/1.1 200
```

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

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

## Errors
<a name="API_UpdateEventSourcesConfig_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_UpdateEventSourcesConfig_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/devops-guru-2020-12-01/UpdateEventSourcesConfig) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/UpdateEventSourcesConfig) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/UpdateEventSourcesConfig) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/UpdateEventSourcesConfig) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/UpdateEventSourcesConfig) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/UpdateEventSourcesConfig) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/UpdateEventSourcesConfig) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/UpdateEventSourcesConfig) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/UpdateEventSourcesConfig) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/UpdateEventSourcesConfig) 

# UpdateResourceCollection
<a name="API_UpdateResourceCollection"></a>

 Updates the collection of resources that DevOps Guru analyzes. The two types of AWS resource collections supported are AWS CloudFormation stacks and AWS resources that contain the same AWS tag. DevOps Guru can be configured to analyze the AWS resources that are defined in the stacks or that are tagged using the same tag *key*. You can specify up to 1000 AWS CloudFormation stacks. This method also creates the IAM role required for you to use DevOps Guru. 

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

```
PUT /resource-collections HTTP/1.1
Content-type: application/json

{
   "Action": "string",
   "ResourceCollection": { 
      "CloudFormation": { 
         "StackNames": [ "string" ]
      },
      "Tags": [ 
         { 
            "AppBoundaryKey": "string",
            "TagValues": [ "string" ]
         }
      ]
   }
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [Action](#API_UpdateResourceCollection_RequestSyntax) **   <a name="DevOpsGuru-UpdateResourceCollection-request-Action"></a>
 Specifies if the resource collection in the request is added or deleted to the resource collection.   
Type: String  
Valid Values: `ADD | REMOVE`   
Required: Yes

 ** [ResourceCollection](#API_UpdateResourceCollection_RequestSyntax) **   <a name="DevOpsGuru-UpdateResourceCollection-request-ResourceCollection"></a>
 Contains information used to update a collection of AWS resources.   
Type: [UpdateResourceCollectionFilter](API_UpdateResourceCollectionFilter.md) object  
Required: Yes

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

```
HTTP/1.1 200
```

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

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

## Errors
<a name="API_UpdateResourceCollection_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** ConflictException **   
 An exception that is thrown when a conflict occurs.     
 ** ResourceId **   
 The ID of the AWS resource in which a conflict occurred.   
 ** ResourceType **   
 The type of the AWS resource in which a conflict occurred. 
HTTP Status Code: 409

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_UpdateResourceCollection_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/devops-guru-2020-12-01/UpdateResourceCollection) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/UpdateResourceCollection) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/UpdateResourceCollection) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/UpdateResourceCollection) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/UpdateResourceCollection) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/UpdateResourceCollection) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/UpdateResourceCollection) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/UpdateResourceCollection) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/UpdateResourceCollection) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/UpdateResourceCollection) 

# UpdateServiceIntegration
<a name="API_UpdateServiceIntegration"></a>

 Enables or disables integration with a service that can be integrated with DevOps Guru. 

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

```
PUT /service-integrations HTTP/1.1
Content-type: application/json

{
   "ServiceIntegration": { 
      "KMSServerSideEncryption": { 
         "KMSKeyId": "string",
         "OptInStatus": "string",
         "Type": "string"
      },
      "LogsAnomalyDetection": { 
         "OptInStatus": "string"
      },
      "OpsCenter": { 
         "OptInStatus": "string"
      }
   }
}
```

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

The request does not use any URI parameters.

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

The request accepts the following data in JSON format.

 ** [ServiceIntegration](#API_UpdateServiceIntegration_RequestSyntax) **   <a name="DevOpsGuru-UpdateServiceIntegration-request-ServiceIntegration"></a>
 An `IntegratedServiceConfig` object used to specify the integrated service you want to update, and whether you want to update it to enabled or disabled.   
Type: [UpdateServiceIntegrationConfig](API_UpdateServiceIntegrationConfig.md) object  
Required: Yes

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

```
HTTP/1.1 200
```

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

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

## Errors
<a name="API_UpdateServiceIntegration_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. For more information, see [Access Management](https://docs.aws.amazon.com/IAM/latest/UserGuide/access.html) in the *IAM User Guide*.   
HTTP Status Code: 403

 ** ConflictException **   
 An exception that is thrown when a conflict occurs.     
 ** ResourceId **   
 The ID of the AWS resource in which a conflict occurred.   
 ** ResourceType **   
 The type of the AWS resource in which a conflict occurred. 
HTTP Status Code: 409

 ** InternalServerException **   
An internal failure in an Amazon service occurred.    
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the internal server exception can be retried. 
HTTP Status Code: 500

 ** ThrottlingException **   
The request was denied due to a request throttling.    
 ** QuotaCode **   
 The code of the quota that was exceeded, causing the throttling exception.   
 ** RetryAfterSeconds **   
 The number of seconds after which the action that caused the throttling exception can be retried.   
 ** ServiceCode **   
 The code of the service that caused the throttling exception. 
HTTP Status Code: 429

 ** ValidationException **   
 Contains information about data passed in to a field during a request that is not valid.     
 ** Fields **   
 An array of fields that are associated with the validation exception.   
 ** Message **   
 A message that describes the validation exception.   
 ** Reason **   
 The reason the validation exception was thrown. 
HTTP Status Code: 400

## See Also
<a name="API_UpdateServiceIntegration_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/devops-guru-2020-12-01/UpdateServiceIntegration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/devops-guru-2020-12-01/UpdateServiceIntegration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/devops-guru-2020-12-01/UpdateServiceIntegration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/devops-guru-2020-12-01/UpdateServiceIntegration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/devops-guru-2020-12-01/UpdateServiceIntegration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/devops-guru-2020-12-01/UpdateServiceIntegration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/devops-guru-2020-12-01/UpdateServiceIntegration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/devops-guru-2020-12-01/UpdateServiceIntegration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/devops-guru-2020-12-01/UpdateServiceIntegration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/devops-guru-2020-12-01/UpdateServiceIntegration)