Amazon DevOps Guru is a fully managed service that helps you identify anomalous behavior in business critical operational applications. You specify the AWS resources that you want DevOps Guru to cover, then the Amazon CloudWatch metrics and AWS CloudTrail events related to those resources are analyzed. When anomalous behavior is detected, DevOps Guru creates an insight that includes recommendations, related events, and related metrics that can help you improve your operational applications. For more information, see What is Amazon DevOps Guru.
You can specify 1 or 2 Amazon Simple Notification Service topics so you are notified every time a new insight is created. You can also enable DevOps Guru to generate an OpsItem in AWS Systems Manager for each insight to help you manage and track your work addressing insights.
To learn about the DevOps Guru workflow, see How DevOps Guru works. To learn about DevOps Guru concepts, see Concepts in DevOps Guru.
", + "operations": { + "AddNotificationChannel": "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 it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
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.
", + "DescribeAccountHealth": "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.
", + "DescribeAccountOverview": "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.
", + "DescribeAnomaly": "Returns details about an anomaly that you specify using its ID.
", + "DescribeInsight": "Returns details about an insight that you specify using its ID.
", + "DescribeResourceCollectionHealth": "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 one type of AWS resource collection supported is AWS CloudFormation stacks. DevOps Guru can be configured to analyze only the AWS resources that are defined in the stacks.
", + "DescribeServiceIntegration": "Returns the integration status of services that are integrated with DevOps Guru. The one service that can be integrated with DevOps Guru is AWS Systems Manager, which can be used to create an OpsItem for each generated insight.
", + "GetResourceCollection": "Returns lists AWS resources that are of the specified resource collection type. The one type of AWS resource collection supported is AWS CloudFormation stacks. DevOps Guru can be configured to analyze only the AWS resources that are defined in the stacks.
", + "ListAnomaliesForInsight": "Returns a list of the anomalies that belong to an insight that you specify using its ID.
", + "ListEvents": "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.
", + "ListInsights": " 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).
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).
", + "ListRecommendations": "Returns a list of a specified insight's recommendations. Each recommendation includes a list of related metrics and a list of related events.
", + "PutFeedback": "Collects customer feedback about the specified insight.
", + "RemoveNotificationChannel": "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.
", + "SearchInsights": " 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, 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.
Updates the collection of resources that DevOps Guru analyzes. The one type of AWS resource collection supported is AWS CloudFormation stacks. DevOps Guru can be configured to analyze only the AWS resources that are defined in the stacks. This method also creates the IAM role required for you to use DevOps Guru.
", + "UpdateServiceIntegration": "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 AWS Systems Manager, which can be used to create an OpsItem for each generated insight.
" }, - "shapes" : { - "AccessDeniedException" : { - "base" : null, - "refs" : { } + "shapes": { + "AccessDeniedException": { + "base": "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 in the IAM User Guide.
", + "refs": { + } + }, + "AddNotificationChannelRequest": { + "base": null, + "refs": { + } + }, + "AddNotificationChannelResponse": { + "base": null, + "refs": { + } + }, + "AnomalyId": { + "base": null, + "refs": { + "DescribeAnomalyRequest$Id": "The ID of the anomaly.
", + "ProactiveAnomaly$Id": "The ID of a proactive anomaly.
", + "ProactiveAnomalySummary$Id": "The ID of the anomaly.
", + "ReactiveAnomaly$Id": "The ID of the reactive anomaly.
", + "ReactiveAnomalySummary$Id": "The ID of the reactive anomaly.
" + } + }, + "AnomalyLimit": { + "base": null, + "refs": { + "ProactiveAnomaly$Limit": "A threshold that was exceeded by behavior in analyzed resources. Exceeding this threshold is related to the anomalous behavior that generated this anomaly.
", + "ProactiveAnomalySummary$Limit": "A threshold that was exceeded by behavior in analyzed resources. Exceeding this threshold is related to the anomalous behavior that generated this anomaly.
" + } + }, + "AnomalySeverity": { + "base": null, + "refs": { + "ProactiveAnomaly$Severity": "The severity of a proactive anomaly.
", + "ProactiveAnomalySummary$Severity": "The severity of the anomaly.
", + "ReactiveAnomaly$Severity": "The severity of the anomaly.
", + "ReactiveAnomalySummary$Severity": "The severity of the reactive anomaly.
" + } + }, + "AnomalySourceDetails": { + "base": "Details about the source of the anomalous operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
", + "refs": { + "ProactiveAnomaly$SourceDetails": "Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
", + "ProactiveAnomalySummary$SourceDetails": "Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
", + "ReactiveAnomaly$SourceDetails": "Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
", + "ReactiveAnomalySummary$SourceDetails": "Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
" + } + }, + "AnomalyStatus": { + "base": null, + "refs": { + "ProactiveAnomaly$Status": "The status of a proactive anomaly.
", + "ProactiveAnomalySummary$Status": "The status of the anomaly.
", + "ReactiveAnomaly$Status": "The status of the anomaly.
", + "ReactiveAnomalySummary$Status": "The status of the reactive anomaly.
" + } + }, + "AnomalyTimeRange": { + "base": "A time range that specifies when the observed unusual behavior in an anomaly started and ended.
", + "refs": { + "ProactiveAnomaly$AnomalyTimeRange": null, + "ProactiveAnomalySummary$AnomalyTimeRange": null, + "ReactiveAnomaly$AnomalyTimeRange": null, + "ReactiveAnomalySummary$AnomalyTimeRange": null + } + }, + "Channels": { + "base": null, + "refs": { + "ListNotificationChannelsResponse$Channels": "An array that contains the requested notification channels.
" + } + }, + "CloudFormationCollection": { + "base": "Information about AWS CloudFormation stacks. You can use stacks to specify which AWS resources in your account to analyze. For more information, see Stacks in the AWS CloudFormation User Guide.
", + "refs": { + "ResourceCollection$CloudFormation": "An array of the names of AWS CloudFormation stacks. The stacks define AWS resources that DevOps Guru analyzes.
" + } + }, + "CloudFormationCollectionFilter": { + "base": "Information about AWS CloudFormation stacks. You can use stacks to specify which AWS resources in your account to analyze. For more information, see Stacks in the AWS CloudFormation User Guide.
", + "refs": { + "ResourceCollectionFilter$CloudFormation": "Information about AWS CloudFormation stacks. You can use stacks to specify which AWS resources in your account to analyze. For more information, see Stacks in the AWS CloudFormation User Guide.
" + } + }, + "CloudFormationHealth": { + "base": "Information about the health of AWS resources in your account that are specified by an AWS CloudFormation stack.
", + "refs": { + "CloudFormationHealths$member": null + } + }, + "CloudFormationHealths": { + "base": null, + "refs": { + "DescribeResourceCollectionHealthResponse$CloudFormation": " The returned CloudFormationHealthOverview object that contains an InsightHealthOverview object with the requested system health information.
Information about an Amazon CloudWatch metric.
", + "refs": { + "CloudWatchMetricsDetails$member": null + } + }, + "CloudWatchMetricsDetails": { + "base": null, + "refs": { + "AnomalySourceDetails$CloudWatchMetrics": " An array of CloudWatchMetricsDetail object that contains information about the analyzed metrics that displayed anomalous behavior.
The dimension of a Amazon CloudWatch metric that is used when DevOps Guru analyzes the resources in your account for operational problems and anomalous behaviour. A dimension is a name/value pair that is part of the identity of a metric. A metric can have up to 10 dimensions. For more information, see Dimensions in the Amazon CloudWatch User Guide.
", + "refs": { + "CloudWatchMetricsDimensions$member": null + } + }, + "CloudWatchMetricsDimensionName": { + "base": null, + "refs": { + "CloudWatchMetricsDimension$Name": "The name of the CloudWatch dimension.
" + } + }, + "CloudWatchMetricsDimensionValue": { + "base": null, + "refs": { + "CloudWatchMetricsDimension$Value": "The value of the CloudWatch dimension.
" + } }, - "AddNotificationChannelRequest" : { - "base" : null, - "refs" : { } + "CloudWatchMetricsDimensions": { + "base": null, + "refs": { + "CloudWatchMetricsDetail$Dimensions": "An array of CloudWatch dimensions associated with
" + } }, - "AddNotificationChannelResponse" : { - "base" : null, - "refs" : { } + "CloudWatchMetricsMetricName": { + "base": null, + "refs": { + "CloudWatchMetricsDetail$MetricName": "The name of the CloudWatch metric.
" + } }, - "AnomalySeverity" : { - "base" : null, - "refs" : { - "ProactiveAnomaly$Severity" : null, - "ProactiveAnomalySummary$Severity" : null, - "ReactiveAnomaly$Severity" : null, - "ReactiveAnomalySummary$Severity" : null + "CloudWatchMetricsNamespace": { + "base": null, + "refs": { + "CloudWatchMetricsDetail$Namespace": "The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
" } }, - "AnomalySourceDetails" : { - "base" : null, - "refs" : { - "ProactiveAnomaly$SourceDetails" : null, - "ProactiveAnomalySummary$SourceDetails" : null, - "ReactiveAnomaly$SourceDetails" : null, - "ReactiveAnomalySummary$SourceDetails" : null + "CloudWatchMetricsPeriod": { + "base": null, + "refs": { + "CloudWatchMetricsDetail$Period": "The length of time associated with the CloudWatch metric in number of seconds.
" } }, - "AnomalyStatus" : { - "base" : null, - "refs" : { - "ProactiveAnomaly$Status" : null, - "ProactiveAnomalySummary$Status" : null, - "ReactiveAnomaly$Status" : null, - "ReactiveAnomalySummary$Status" : null + "CloudWatchMetricsStat": { + "base": null, + "refs": { + "CloudWatchMetricsDetail$Stat": "The type of statistic associated with the CloudWatch metric. For more information, see Statistics in the Amazon CloudWatch User Guide.
" } }, - "AnomalyTimeRange" : { - "base" : null, - "refs" : { - "ProactiveAnomaly$AnomalyTimeRange" : null, - "ProactiveAnomalySummary$AnomalyTimeRange" : null, - "ReactiveAnomaly$AnomalyTimeRange" : null, - "ReactiveAnomalySummary$AnomalyTimeRange" : null + "CloudWatchMetricsUnit": { + "base": null, + "refs": { + "CloudWatchMetricsDetail$Unit": " The unit of measure used for the CloudWatch metric. For example, Bytes, Seconds, Count, and Percent.
An exception that is thrown when a conflict occurs.
", + "refs": { } }, - "CloudFormationCollectionFilter" : { - "base" : null, - "refs" : { - "ResourceCollectionFilter$CloudFormation" : null + "DescribeAccountHealthRequest": { + "base": null, + "refs": { } }, - "CloudFormationHealth" : { - "base" : null, - "refs" : { - "__listOfCloudFormationHealth$member" : null + "DescribeAccountHealthResponse": { + "base": null, + "refs": { } }, - "CloudWatchMetricsDetail" : { - "base" : null, - "refs" : { - "__listOfCloudWatchMetricsDetail$member" : null + "DescribeAccountOverviewRequest": { + "base": null, + "refs": { } }, - "CloudWatchMetricsDimension" : { - "base" : null, - "refs" : { - "__listOfCloudWatchMetricsDimension$member" : null + "DescribeAccountOverviewResponse": { + "base": null, + "refs": { } }, - "CloudWatchMetricsStat" : { - "base" : null, - "refs" : { - "CloudWatchMetricsDetail$Stat" : null + "DescribeAnomalyRequest": { + "base": null, + "refs": { } }, - "ConflictException" : { - "base" : null, - "refs" : { } + "DescribeAnomalyResponse": { + "base": null, + "refs": { + } }, - "DescribeAccountHealthResponse" : { - "base" : null, - "refs" : { } + "DescribeInsightRequest": { + "base": null, + "refs": { + } }, - "DescribeAccountOverviewRequest" : { - "base" : null, - "refs" : { } + "DescribeInsightResponse": { + "base": null, + "refs": { + } }, - "DescribeAccountOverviewResponse" : { - "base" : null, - "refs" : { } + "DescribeResourceCollectionHealthRequest": { + "base": null, + "refs": { + } }, - "DescribeAnomalyResponse" : { - "base" : null, - "refs" : { } + "DescribeResourceCollectionHealthResponse": { + "base": null, + "refs": { + } }, - "DescribeInsightResponse" : { - "base" : null, - "refs" : { } + "DescribeServiceIntegrationRequest": { + "base": null, + "refs": { + } }, - "DescribeResourceCollectionHealthResponse" : { - "base" : null, - "refs" : { } + "DescribeServiceIntegrationResponse": { + "base": null, + "refs": { + } }, - "DescribeServiceIntegrationResponse" : { - "base" : null, - "refs" : { } + "EndTimeRange": { + "base": "A range of time that specifies when anomalous behavior in an anomaly or insight ended.
", + "refs": { + "ListInsightsClosedStatusFilter$EndTimeRange": "A time range used to specify when the behavior of the filtered insights ended.
" + } }, - "EndTimeRange" : { - "base" : null, - "refs" : { - "ListInsightsClosedStatusFilter$EndTimeRange" : null + "ErrorMessageString": { + "base": null, + "refs": { + "AccessDeniedException$Message": null, + "ConflictException$Message": null, + "InternalServerException$Message": null, + "ResourceNotFoundException$Message": null, + "ServiceQuotaExceededException$Message": null, + "ThrottlingException$Message": null, + "ValidationException$Message": "A message that describes the validation exception.
", + "ValidationExceptionField$Message": "The message associated with the validation exception with information to help determine its cause.
" } }, - "Event" : { - "base" : null, - "refs" : { - "__listOfEvent$member" : null + "ErrorNameString": { + "base": null, + "refs": { + "ValidationExceptionField$Name": "The name of the field.
" } }, - "EventClass" : { - "base" : null, - "refs" : { - "Event$EventClass" : null, - "ListEventsFilters$EventClass" : null + "ErrorQuotaCodeString": { + "base": null, + "refs": { + "ThrottlingException$QuotaCode": "The code of the quota that was exceeded, causing the throttling exception.
" } }, - "EventDataSource" : { - "base" : null, - "refs" : { - "Event$DataSource" : null, - "ListEventsFilters$DataSource" : null + "ErrorServiceCodeString": { + "base": null, + "refs": { + "ThrottlingException$ServiceCode": "The code of the service that caused the throttling exception.
" } }, - "EventResource" : { - "base" : null, - "refs" : { - "__listOfEventResource$member" : null + "Event": { + "base": "An AWS resource event. AWS resource events and metrics are analyzed by DevOps Guru to find anomalous behavior and provide recommendations to improve your operational solutions.
", + "refs": { + "Events$member": null } }, - "EventTimeRange" : { - "base" : null, - "refs" : { - "ListEventsFilters$EventTimeRange" : null + "EventClass": { + "base": null, + "refs": { + "Event$EventClass": "The class of the event. The class specifies what the event is related to, such as an infrastructure change, a deployment, or a schema change.
", + "ListEventsFilters$EventClass": "The class of the events you want to filter for, such as an infrastructure change, a deployment, or a schema change.
" } }, - "GetResourceCollectionResponse" : { - "base" : null, - "refs" : { } + "EventDataSource": { + "base": null, + "refs": { + "Event$DataSource": " The source, AWS_CLOUD_TRAIL or AWS_CODE_DEPLOY, where DevOps Guru analysis found the event.
The source, AWS_CLOUD_TRAIL or AWS_CODE_DEPLOY, of the events you want returned.
The ID of the event.
" } }, - "InsightFeedbackOption" : { - "base" : null, - "refs" : { - "InsightFeedback$Feedback" : null + "EventName": { + "base": null, + "refs": { + "Event$Name": "The name of the event.
" } }, - "InsightHealth" : { - "base" : null, - "refs" : { - "CloudFormationHealth$Insight" : null + "EventResource": { + "base": "The AWS resource that emitted an event. AWS resource events and metrics are analyzed by DevOps Guru to find anomalous behavior and provide recommendations to improve your operational solutions.
", + "refs": { + "EventResources$member": null } }, - "InsightSeverity" : { - "base" : null, - "refs" : { - "ProactiveInsight$Severity" : null, - "ProactiveInsightSummary$Severity" : null, - "ReactiveInsight$Severity" : null, - "ReactiveInsightSummary$Severity" : null, - "__listOfInsightSeverity$member" : null + "EventResourceArn": { + "base": null, + "refs": { + "EventResource$Arn": "The Amazon Resource Name (ARN) of the resource that emitted an event.
" } }, - "InsightStatus" : { - "base" : null, - "refs" : { - "ProactiveInsight$Status" : null, - "ProactiveInsightSummary$Status" : null, - "ReactiveInsight$Status" : null, - "ReactiveInsightSummary$Status" : null, - "__listOfInsightStatus$member" : null + "EventResourceName": { + "base": null, + "refs": { + "EventResource$Name": "The name of the resource that emitted an event.
" } }, - "InsightTimeRange" : { - "base" : null, - "refs" : { - "ProactiveInsight$InsightTimeRange" : null, - "ProactiveInsightSummary$InsightTimeRange" : null, - "ReactiveInsight$InsightTimeRange" : null, - "ReactiveInsightSummary$InsightTimeRange" : null + "EventResourceType": { + "base": null, + "refs": { + "EventResource$Type": "The type of resource that emitted an event.
" } }, - "InsightType" : { - "base" : null, - "refs" : { - "ListInsightsAnyStatusFilter$Type" : null, - "ListInsightsClosedStatusFilter$Type" : null, - "ListInsightsOngoingStatusFilter$Type" : null, - "SearchInsightsRequest$Type" : null + "EventResources": { + "base": null, + "refs": { + "Event$Resources": " An EventResource object that contains information about the resource that emitted the event.
The AWS source that emitted the event.
", + "ListEventsFilters$EventSource": "The AWS source that emitted the events you want to filter for.
" + } }, - "ListAnomaliesForInsightRequest" : { - "base" : null, - "refs" : { } + "EventTimeRange": { + "base": "The time range during which an AWS event occurred. AWS resource events and metrics are analyzed by DevOps Guru to find anomalous behavior and provide recommendations to improve your operational solutions.
", + "refs": { + "ListEventsFilters$EventTimeRange": "A time range during which you want the filtered events to have occurred.
" + } }, - "ListAnomaliesForInsightResponse" : { - "base" : null, - "refs" : { } + "Events": { + "base": null, + "refs": { + "ListEventsResponse$Events": "A list of the requested events.
" + } }, - "ListEventsFilters" : { - "base" : null, - "refs" : { - "ListEventsRequest$Filters" : null + "GetResourceCollectionRequest": { + "base": null, + "refs": { } }, - "ListEventsRequest" : { - "base" : null, - "refs" : { } + "GetResourceCollectionResponse": { + "base": null, + "refs": { + } }, - "ListEventsResponse" : { - "base" : null, - "refs" : { } + "InsightFeedback": { + "base": "Information about insight feedback received from a customer.
", + "refs": { + "PutFeedbackRequest$InsightFeedback": "The feedback from customers is about the recommendations in this insight.
" + } }, - "ListInsightsAnyStatusFilter" : { - "base" : null, - "refs" : { - "ListInsightsStatusFilter$Any" : null + "InsightFeedbackOption": { + "base": null, + "refs": { + "InsightFeedback$Feedback": "The feedback provided by the customer.
" } }, - "ListInsightsClosedStatusFilter" : { - "base" : null, - "refs" : { - "ListInsightsStatusFilter$Closed" : null + "InsightHealth": { + "base": "Information about the number of open reactive and proactive insights that can be used to gauge the health of your system.
", + "refs": { + "CloudFormationHealth$Insight": "Information about the health of the AWS resources in your account that are specified by an AWS CloudFormation stack, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights.
" } }, - "ListInsightsOngoingStatusFilter" : { - "base" : null, - "refs" : { - "ListInsightsStatusFilter$Ongoing" : null + "InsightId": { + "base": null, + "refs": { + "DescribeInsightRequest$Id": "The ID of the insight.
", + "InsightFeedback$Id": "The insight feedback ID.
", + "ListAnomaliesForInsightRequest$InsightId": "The ID of the insight. The returned anomalies belong to this insight.
", + "ListEventsFilters$InsightId": "An ID of an insight that is related to the events you want to filter for.
", + "ListRecommendationsRequest$InsightId": "The ID of the requested insight.
", + "ProactiveAnomaly$AssociatedInsightId": "The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
", + "ProactiveAnomalySummary$AssociatedInsightId": "The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
", + "ProactiveInsight$Id": "The ID of the proactive insight.
", + "ProactiveInsightSummary$Id": "The ID of the proactive insight.
", + "ReactiveAnomaly$AssociatedInsightId": "The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
", + "ReactiveAnomalySummary$AssociatedInsightId": "The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
", + "ReactiveInsight$Id": "The ID of a reactive insight.
", + "ReactiveInsightSummary$Id": "The ID of a reactive summary.
" } }, - "ListInsightsRequest" : { - "base" : null, - "refs" : { } + "InsightName": { + "base": null, + "refs": { + "ProactiveInsight$Name": "The name of the proactive insight.
", + "ProactiveInsightSummary$Name": "The name of the proactive insight.
", + "ReactiveInsight$Name": "The name of a reactive insight.
", + "ReactiveInsightSummary$Name": "The name of a reactive insight.
" + } }, - "ListInsightsResponse" : { - "base" : null, - "refs" : { } + "InsightSeverities": { + "base": null, + "refs": { + "SearchInsightsFilters$Severities": "An array of severity values used to search for insights.
" + } }, - "ListInsightsStatusFilter" : { - "base" : null, - "refs" : { - "ListInsightsRequest$StatusFilter" : null + "InsightSeverity": { + "base": null, + "refs": { + "InsightSeverities$member": null, + "ProactiveInsight$Severity": "The severity of the proactive insight.
", + "ProactiveInsightSummary$Severity": "The severity of the proactive insight.
", + "ReactiveInsight$Severity": "The severity of a reactive insight.
", + "ReactiveInsightSummary$Severity": "The severity of a reactive insight.
" } }, - "ListNotificationChannelsRequest" : { - "base" : null, - "refs" : { } + "InsightStatus": { + "base": null, + "refs": { + "InsightStatuses$member": null, + "ProactiveInsight$Status": "The status of the proactive insight.
", + "ProactiveInsightSummary$Status": "The status of the proactive insight.
", + "ReactiveInsight$Status": "The status of a reactive insight.
", + "ReactiveInsightSummary$Status": "The status of a reactive insight.
" + } }, - "ListNotificationChannelsResponse" : { - "base" : null, - "refs" : { } + "InsightStatuses": { + "base": null, + "refs": { + "SearchInsightsFilters$Statuses": "An array of status values used to search for insights.
" + } }, - "ListRecommendationsRequest" : { - "base" : null, - "refs" : { } + "InsightTimeRange": { + "base": "A time ranged that specifies when the observed behavior in an insight started and ended.
", + "refs": { + "ProactiveInsight$InsightTimeRange": null, + "ProactiveInsightSummary$InsightTimeRange": null, + "ReactiveInsight$InsightTimeRange": null, + "ReactiveInsightSummary$InsightTimeRange": null + } }, - "ListRecommendationsResponse" : { - "base" : null, - "refs" : { } + "InsightType": { + "base": null, + "refs": { + "ListInsightsAnyStatusFilter$Type": " Use to filter for either REACTIVE or PROACTIVE insights.
Use to filter for either REACTIVE or PROACTIVE insights.
Use to filter for either REACTIVE or PROACTIVE insights.
The type of insights you are searching for (REACTIVE or PROACTIVE).
An internal failure in an Amazon service occurred.
", + "refs": { } }, - "NotificationChannelConfig" : { - "base" : null, - "refs" : { - "AddNotificationChannelRequest$Config" : null, - "NotificationChannel$Config" : null + "ListAnomaliesForInsightMaxResults": { + "base": null, + "refs": { + "ListAnomaliesForInsightRequest$MaxResults": "The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.
Filters you can use to specify which events are returned when ListEvents is called.
A ListEventsFilters object used to specify which events to return.
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.
Used to filter for insights that have any status.
", + "refs": { + "ListInsightsStatusFilter$Any": " A ListInsightsAnyStatusFilter that specifies insights of any status that are either REACTIVE or PROACTIVE.
Used to filter for insights that have the status CLOSED.
A ListInsightsClosedStatusFilter that specifies closed insights that are either REACTIVE or PROACTIVE.
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.
Used to filter for insights that have the status ONGOING.
A ListInsightsAnyStatusFilter that specifies ongoing insights that are either REACTIVE or PROACTIVE.
A filter used by ListInsights to specify which insights to return.
A filter used to filter the returned insights by their status. You can specify one status filter.
" } }, - "ReactiveInsightSummary" : { - "base" : null, - "refs" : { - "__listOfReactiveInsightSummary$member" : null + "ListNotificationChannelsRequest": { + "base": null, + "refs": { } }, - "Recommendation" : { - "base" : null, - "refs" : { - "__listOfRecommendation$member" : null + "ListNotificationChannelsResponse": { + "base": null, + "refs": { } }, - "RecommendationRelatedAnomaly" : { - "base" : null, - "refs" : { - "__listOfRecommendationRelatedAnomaly$member" : null + "ListRecommendationsRequest": { + "base": null, + "refs": { } }, - "RecommendationRelatedAnomalyResource" : { - "base" : null, - "refs" : { - "__listOfRecommendationRelatedAnomalyResource$member" : null + "ListRecommendationsResponse": { + "base": null, + "refs": { } }, - "RecommendationRelatedAnomalySourceDetail" : { - "base" : null, - "refs" : { - "__listOfRecommendationRelatedAnomalySourceDetail$member" : null + "MeanTimeToRecoverInMilliseconds": { + "base": null, + "refs": { + "DescribeAccountOverviewResponse$MeanTimeToRecoverInMilliseconds": "The Mean Time to Recover (MTTR) for all closed insights that were created during the time range passed in.
", + "InsightHealth$MeanTimeToRecoverInMilliseconds": "The Meant Time to Recover (MTTR) for the insight.
" } }, - "RecommendationRelatedCloudWatchMetricsSourceDetail" : { - "base" : null, - "refs" : { - "__listOfRecommendationRelatedCloudWatchMetricsSourceDetail$member" : null + "NotificationChannel": { + "base": "Information about a notification channel. A notification channel is used to notify you when DevOps Guru creates an insight. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS).
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
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.
", + "refs": { + "Channels$member": null } }, - "RecommendationRelatedEvent" : { - "base" : null, - "refs" : { - "__listOfRecommendationRelatedEvent$member" : null + "NotificationChannelConfig": { + "base": "Information about notification channels you have configured with DevOps Guru. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS).
", + "refs": { + "AddNotificationChannelRequest$Config": " A NotificationChannelConfig object that specifies what type of notification channel to add. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS).
A NotificationChannelConfig object that contains information about configured notification channels.
The ID of the added notification channel.
", + "NotificationChannel$Id": "The ID of a notification channel.
", + "RemoveNotificationChannelRequest$Id": "The ID of the notification channel to be removed.
" } }, - "RemoveNotificationChannelResponse" : { - "base" : null, - "refs" : { } + "NumMetricsAnalyzed": { + "base": null, + "refs": { + "DescribeAccountHealthResponse$MetricsAnalyzed": "An integer that specifies the number of metrics that have been analyzed in your AWS account.
" + } }, - "ResourceCollection" : { - "base" : null, - "refs" : { - "Event$ResourceCollection" : null, - "ListEventsFilters$ResourceCollection" : null, - "ProactiveAnomaly$ResourceCollection" : null, - "ProactiveAnomalySummary$ResourceCollection" : null, - "ProactiveInsight$ResourceCollection" : null, - "ProactiveInsightSummary$ResourceCollection" : null, - "ReactiveAnomaly$ResourceCollection" : null, - "ReactiveAnomalySummary$ResourceCollection" : null, - "ReactiveInsight$ResourceCollection" : null, - "ReactiveInsightSummary$ResourceCollection" : null, - "SearchInsightsFilters$ResourceCollection" : null + "NumOpenProactiveInsights": { + "base": null, + "refs": { + "DescribeAccountHealthResponse$OpenProactiveInsights": "An integer that specifies the number of open proactive insights in your AWS account.
", + "InsightHealth$OpenProactiveInsights": "The number of open proactive insights.
" } }, - "ResourceCollectionFilter" : { - "base" : null, - "refs" : { - "GetResourceCollectionResponse$ResourceCollection" : null + "NumOpenReactiveInsights": { + "base": null, + "refs": { + "DescribeAccountHealthResponse$OpenReactiveInsights": "An integer that specifies the number of open reactive insights in your AWS account.
", + "InsightHealth$OpenReactiveInsights": "The number of open reactive insights.
" } }, - "ResourceNotFoundException" : { - "base" : null, - "refs" : { } + "NumProactiveInsights": { + "base": null, + "refs": { + "DescribeAccountOverviewResponse$ProactiveInsights": "An integer that specifies the number of open proactive insights in your AWS account that were created during the time range passed in.
" + } }, - "SearchInsightsFilters" : { - "base" : null, - "refs" : { - "SearchInsightsRequest$Filters" : null + "NumReactiveInsights": { + "base": null, + "refs": { + "DescribeAccountOverviewResponse$ReactiveInsights": "An integer that specifies the number of open reactive insights in your AWS account that were created during the time range passed in.
" } }, - "SearchInsightsRequest" : { - "base" : null, - "refs" : { } + "OpsCenterIntegration": { + "base": "Information about whether DevOps Guru is configured to create an OpsItem in AWS Systems Manager OpsCenter for each created insight.
", + "refs": { + "ServiceIntegrationConfig$OpsCenter": "Information about whether DevOps Guru is configured to create an OpsItem in AWS Systems Manager OpsCenter for each created insight.
" + } }, - "SearchInsightsResponse" : { - "base" : null, - "refs" : { } + "OpsCenterIntegrationConfig": { + "base": "Information about whether DevOps Guru is configured to create an OpsItem in AWS Systems Manager OpsCenter for each created insight.
", + "refs": { + "UpdateServiceIntegrationConfig$OpsCenter": null + } }, - "ServiceIntegrationConfig" : { - "base" : null, - "refs" : { - "DescribeServiceIntegrationResponse$ServiceIntegration" : null + "OptInStatus": { + "base": "Specifies if DevOps Guru is enabled to create an AWS Systems Manager OpsItem for each created insight.
", + "refs": { + "OpsCenterIntegration$OptInStatus": "Specifies if DevOps Guru is enabled to create an AWS Systems Manager OpsItem for each created insight.
", + "OpsCenterIntegrationConfig$OptInStatus": "Specifies if DevOps Guru is enabled to create an AWS Systems Manager OpsItem for each created insight.
" } }, - "ServiceQuotaExceededException" : { - "base" : null, - "refs" : { } + "PredictionTimeRange": { + "base": "The time range during which anomalous behavior in a proactive anomaly or an insight is expected to occur.
", + "refs": { + "ProactiveAnomaly$PredictionTimeRange": null, + "ProactiveAnomalySummary$PredictionTimeRange": null, + "ProactiveInsight$PredictionTimeRange": null, + "ProactiveInsightSummary$PredictionTimeRange": null + } }, - "SnsChannelConfig" : { - "base" : null, - "refs" : { - "NotificationChannelConfig$Sns" : null + "ProactiveAnomalies": { + "base": null, + "refs": { + "ListAnomaliesForInsightResponse$ProactiveAnomalies": " An array of ProactiveAnomalySummary objects that represent the requested anomalies
Information about an anomaly. This object is returned by ListAnomalies.
An ReactiveAnomaly object that represents the requested anomaly.
Details about a proactive anomaly. This object is returned by DescribeAnomaly.
Details about a proactive insight. This object is returned by ListInsights.
An ProactiveInsight object that represents the requested insight.
Details about a proactive insight. This object is returned by DescribeInsight.
The returned list of proactive insights.
", + "SearchInsightsResponse$ProactiveInsights": "The returned proactive insights.
" } }, - "UpdateResourceCollectionRequest" : { - "base" : null, - "refs" : { } + "PutFeedbackRequest": { + "base": null, + "refs": { + } }, - "UpdateResourceCollectionResponse" : { - "base" : null, - "refs" : { } + "PutFeedbackResponse": { + "base": null, + "refs": { + } }, - "UpdateServiceIntegrationConfig" : { - "base" : null, - "refs" : { - "UpdateServiceIntegrationRequest$ServiceIntegration" : null + "ReactiveAnomalies": { + "base": null, + "refs": { + "ListAnomaliesForInsightResponse$ReactiveAnomalies": " An array of ReactiveAnomalySummary objects that represent the requested anomalies
Details about a reactive anomaly. This object is returned by ListAnomalies.
An ProactiveAnomaly object that represents the requested anomaly.
Details about a reactive anomaly. This object is returned by DescribeAnomaly.
Information about a reactive insight. This object is returned by ListInsights.
An ReactiveInsight object that represents the requested insight.
Information about a reactive insight. This object is returned by DescribeInsight.
The returned list of reactive insights.
", + "SearchInsightsResponse$ReactiveInsights": "The returned reactive insights.
" } }, - "__double" : { - "base" : null, - "refs" : { - "AnomalyTimeRange$EndTime" : null, - "AnomalyTimeRange$StartTime" : null, - "DescribeAccountOverviewRequest$FromTime" : null, - "DescribeAccountOverviewRequest$ToTime" : null, - "EndTimeRange$FromTime" : null, - "EndTimeRange$ToTime" : null, - "Event$Time" : null, - "EventTimeRange$FromTime" : null, - "EventTimeRange$ToTime" : null, - "InsightTimeRange$EndTime" : null, - "InsightTimeRange$StartTime" : null, - "PredictionTimeRange$EndTime" : null, - "PredictionTimeRange$StartTime" : null, - "ProactiveAnomaly$Limit" : null, - "ProactiveAnomaly$UpdateTime" : null, - "ProactiveAnomalySummary$Limit" : null, - "ProactiveAnomalySummary$UpdateTime" : null, - "StartTimeRange$FromTime" : null, - "StartTimeRange$ToTime" : null + "Recommendation": { + "base": "Recommendation information to help you remediate detected anomalous behavior that generated an insight.
", + "refs": { + "Recommendations$member": null } }, - "__integer" : { - "base" : null, - "refs" : { - "CloudWatchMetricsDetail$Period" : null, - "DescribeAccountHealthResponse$MetricsAnalyzed" : null, - "DescribeAccountHealthResponse$OpenProactiveInsights" : null, - "DescribeAccountHealthResponse$OpenReactiveInsights" : null, - "DescribeAccountOverviewResponse$ProactiveInsights" : null, - "DescribeAccountOverviewResponse$ReactiveInsights" : null, - "InsightHealth$OpenProactiveInsights" : null, - "InsightHealth$OpenReactiveInsights" : null + "RecommendationDescription": { + "base": null, + "refs": { + "Recommendation$Description": "A description of the problem.
" } }, - "__integerMin1Max100" : { - "base" : null, - "refs" : { - "ListInsightsRequest$MaxResults" : null, - "SearchInsightsRequest$MaxResults" : null + "RecommendationLink": { + "base": null, + "refs": { + "Recommendation$Link": "A hyperlink to information to help you address the problem.
" } }, - "__integerMin1Max200" : { - "base" : null, - "refs" : { - "ListEventsRequest$MaxResults" : null + "RecommendationName": { + "base": null, + "refs": { + "Recommendation$Name": "The name of the recommendation.
" } }, - "__integerMin1Max500" : { - "base" : null, - "refs" : { - "ListAnomaliesForInsightRequest$MaxResults" : null + "RecommendationReason": { + "base": null, + "refs": { + "Recommendation$Reason": "The reason DevOps Guru flagged the anomalous behavior as a problem.
" } }, - "__listOfCloudFormationHealth" : { - "base" : null, - "refs" : { - "DescribeResourceCollectionHealthResponse$CloudFormation" : null + "RecommendationRelatedAnomalies": { + "base": null, + "refs": { + "Recommendation$RelatedAnomalies": "Anomalies that are related to the problem. Use these Anomalies to learn more about what's happening and to help address the issue.
" } }, - "__listOfCloudWatchMetricsDetail" : { - "base" : null, - "refs" : { - "AnomalySourceDetails$CloudWatchMetrics" : null + "RecommendationRelatedAnomaly": { + "base": "Information about an anomaly that is related to a recommendation.
", + "refs": { + "RecommendationRelatedAnomalies$member": null } }, - "__listOfCloudWatchMetricsDimension" : { - "base" : null, - "refs" : { - "CloudWatchMetricsDetail$Dimensions" : null + "RecommendationRelatedAnomalyResource": { + "base": "Information about a resource in which DevOps Guru detected anomalous behavior.
", + "refs": { + "RecommendationRelatedAnomalyResources$member": null } }, - "__listOfEvent" : { - "base" : null, - "refs" : { - "ListEventsResponse$Events" : null + "RecommendationRelatedAnomalyResourceName": { + "base": null, + "refs": { + "RecommendationRelatedAnomalyResource$Name": "The name of the resource.
" } }, - "__listOfEventResource" : { - "base" : null, - "refs" : { - "Event$Resources" : null + "RecommendationRelatedAnomalyResourceType": { + "base": null, + "refs": { + "RecommendationRelatedAnomalyResource$Type": "The type of the resource.
" } }, - "__listOfInsightSeverity" : { - "base" : null, - "refs" : { - "SearchInsightsFilters$Severities" : null + "RecommendationRelatedAnomalyResources": { + "base": null, + "refs": { + "RecommendationRelatedAnomaly$Resources": "An array of objects that represent resources in which DevOps Guru detected anomalous behavior. Each object contains the name and type of the resource.
" } }, - "__listOfInsightStatus" : { - "base" : null, - "refs" : { - "SearchInsightsFilters$Statuses" : null + "RecommendationRelatedAnomalySourceDetail": { + "base": " Contains an array of RecommendationRelatedCloudWatchMetricsSourceDetail objects that contain the name and namespace of an Amazon CloudWatch metric.
Information about an Amazon CloudWatch metric that is analyzed by DevOps Guru. It is one of many analyzed metrics that are used to generate insights.
", + "refs": { + "RecommendationRelatedCloudWatchMetricsSourceDetails$member": null } }, - "__listOfProactiveAnomalySummary" : { - "base" : null, - "refs" : { - "ListAnomaliesForInsightResponse$ProactiveAnomalies" : null + "RecommendationRelatedCloudWatchMetricsSourceDetails": { + "base": null, + "refs": { + "RecommendationRelatedAnomalySourceDetail$CloudWatchMetrics": " An array of CloudWatchMetricsDetail objects that contains information about the analyzed metrics that displayed anomalous behavior.
The name of the CloudWatch metric.
" } }, - "__listOfReactiveAnomalySummary" : { - "base" : null, - "refs" : { - "ListAnomaliesForInsightResponse$ReactiveAnomalies" : null + "RecommendationRelatedCloudWatchMetricsSourceNamespace": { + "base": null, + "refs": { + "RecommendationRelatedCloudWatchMetricsSourceDetail$Namespace": "The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
" } }, - "__listOfReactiveInsightSummary" : { - "base" : null, - "refs" : { - "ListInsightsResponse$ReactiveInsights" : null, - "SearchInsightsResponse$ReactiveInsights" : null + "RecommendationRelatedEvent": { + "base": "Information about an event that is related to a recommendation.
", + "refs": { + "RecommendationRelatedEvents$member": null } }, - "__listOfRecommendation" : { - "base" : null, - "refs" : { - "ListRecommendationsResponse$Recommendations" : null + "RecommendationRelatedEventName": { + "base": null, + "refs": { + "RecommendationRelatedEvent$Name": " The name of the event. This corresponds to the Name field in an Event object.
Information about an AWS resource that emitted and event that is related to a recommendation in an insight.
", + "refs": { + "RecommendationRelatedEventResources$member": null } }, - "__listOfRecommendationRelatedAnomalyResource" : { - "base" : null, - "refs" : { - "RecommendationRelatedAnomaly$Resources" : null + "RecommendationRelatedEventResourceName": { + "base": null, + "refs": { + "RecommendationRelatedEventResource$Name": " The name of the resource that emitted the event. This corresponds to the Name field in an EventResource object.
The type of the resource that emitted the event. This corresponds to the Type field in an EventResource object.
A ResourceCollection object that contains arrays of the names of AWS CloudFormation stacks.
Events that are related to the problem. Use these events to learn more about what's happening and to help address the issue.
" } }, - "__listOfRecommendationRelatedEventResource" : { - "base" : null, - "refs" : { - "RecommendationRelatedEvent$Resources" : null + "Recommendations": { + "base": null, + "refs": { + "ListRecommendationsResponse$Recommendations": "An array of the requested recommendations.
" } }, - "__listOfValidationExceptionField" : { - "base" : null, - "refs" : { - "ValidationException$Fields" : null + "RelatedAnomalySourceDetails": { + "base": null, + "refs": { + "RecommendationRelatedAnomaly$SourceDetails": "Information about where the anomalous behavior related the recommendation was found. For example, details in Amazon CloudWatch metrics.
" } }, - "__listOf__stringMin1Max128PatternAZAZAZAZ09" : { - "base" : null, - "refs" : { - "CloudFormationCollection$StackNames" : null, - "CloudFormationCollectionFilter$StackNames" : null, - "UpdateCloudFormationCollectionFilter$StackNames" : null + "RemoveNotificationChannelRequest": { + "base": null, + "refs": { } - }, - "__long" : { - "base" : null, - "refs" : { - "DescribeAccountOverviewResponse$MeanTimeToRecoverInMilliseconds" : null, - "InsightHealth$MeanTimeToRecoverInMilliseconds" : null - } - }, - "__string" : { - "base" : null, - "refs" : { - "AccessDeniedException$Message" : null, - "CloudWatchMetricsDetail$MetricName" : null, - "CloudWatchMetricsDetail$Namespace" : null, - "CloudWatchMetricsDetail$Unit" : null, - "CloudWatchMetricsDimension$Name" : null, - "CloudWatchMetricsDimension$Value" : null, - "ConflictException$Message" : null, - "ConflictException$ResourceId" : null, - "ConflictException$ResourceType" : null, - "Event$Id" : null, - "InternalServerException$Message" : null, - "Recommendation$Description" : null, - "Recommendation$Link" : null, - "Recommendation$Name" : null, - "Recommendation$Reason" : null, - "RecommendationRelatedAnomalyResource$Name" : null, - "RecommendationRelatedAnomalyResource$Type" : null, - "RecommendationRelatedCloudWatchMetricsSourceDetail$MetricName" : null, - "RecommendationRelatedCloudWatchMetricsSourceDetail$Namespace" : null, - "RecommendationRelatedEvent$Name" : null, - "RecommendationRelatedEventResource$Name" : null, - "RecommendationRelatedEventResource$Type" : null, - "ResourceNotFoundException$Message" : null, - "ResourceNotFoundException$ResourceId" : null, - "ResourceNotFoundException$ResourceType" : null, - "ServiceQuotaExceededException$Message" : null, - "ThrottlingException$Message" : null, - "ThrottlingException$QuotaCode" : null, - "ThrottlingException$ServiceCode" : null, - "ValidationException$Message" : null, - "ValidationExceptionField$Message" : null, - "ValidationExceptionField$Name" : null - } - }, - "__stringMin0Max2048Pattern" : { - "base" : null, - "refs" : { - "EventResource$Name" : null, - "EventResource$Type" : null - } - }, - "__stringMin0Max50" : { - "base" : null, - "refs" : { - "Event$Name" : null - } - }, - "__stringMin10Max50PatternAZAZ09AmazonawsComAwsEvents" : { - "base" : null, - "refs" : { - "Event$EventSource" : null, - "ListEventsFilters$EventSource" : null - } - }, - "__stringMin1Max100Pattern" : { - "base" : null, - "refs" : { - "ProactiveInsight$SsmOpsItemId" : null, - "ReactiveInsight$SsmOpsItemId" : null - } - }, - "__stringMin1Max100PatternW" : { - "base" : null, - "refs" : { - "InsightFeedback$Id" : null, - "ListEventsFilters$InsightId" : null, - "ListRecommendationsRequest$InsightId" : null, - "ProactiveAnomaly$AssociatedInsightId" : null, - "ProactiveAnomaly$Id" : null, - "ProactiveAnomalySummary$AssociatedInsightId" : null, - "ProactiveAnomalySummary$Id" : null, - "ProactiveInsight$Id" : null, - "ProactiveInsightSummary$Id" : null, - "ReactiveAnomaly$AssociatedInsightId" : null, - "ReactiveAnomaly$Id" : null, - "ReactiveAnomalySummary$AssociatedInsightId" : null, - "ReactiveAnomalySummary$Id" : null, - "ReactiveInsight$Id" : null, - "ReactiveInsightSummary$Id" : null - } - }, - "__stringMin1Max128PatternAZAZAZAZ09" : { - "base" : null, - "refs" : { - "CloudFormationHealth$StackName" : null, - "__listOf__stringMin1Max128PatternAZAZAZAZ09$member" : null - } - }, - "__stringMin1Max530PatternSS" : { - "base" : null, - "refs" : { - "ProactiveInsight$Name" : null, - "ProactiveInsightSummary$Name" : null, - "ReactiveInsight$Name" : null, - "ReactiveInsightSummary$Name" : null - } - }, - "__stringMin36Max1024PatternArnAwsAZ09SnsAZ09D12" : { - "base" : null, - "refs" : { - "SnsChannelConfig$TopicArn" : null - } - }, - "__stringMin36Max2048PatternArnAwsAZAZ09AZ09D12" : { - "base" : null, - "refs" : { - "EventResource$Arn" : null - } - }, - "__stringMin36Max36PatternAF098AF094AF094AF094AF0912" : { - "base" : null, - "refs" : { - "AddNotificationChannelResponse$Id" : null, - "DescribeResourceCollectionHealthResponse$NextToken" : null, - "GetResourceCollectionResponse$NextToken" : null, - "ListAnomaliesForInsightRequest$NextToken" : null, - "ListAnomaliesForInsightResponse$NextToken" : null, - "ListEventsRequest$NextToken" : null, - "ListEventsResponse$NextToken" : null, - "ListInsightsRequest$NextToken" : null, - "ListInsightsResponse$NextToken" : null, - "ListNotificationChannelsRequest$NextToken" : null, - "ListNotificationChannelsResponse$NextToken" : null, - "ListRecommendationsRequest$NextToken" : null, - "ListRecommendationsResponse$NextToken" : null, - "NotificationChannel$Id" : null, - "SearchInsightsRequest$NextToken" : null, - "SearchInsightsResponse$NextToken" : null + }, + "RemoveNotificationChannelResponse": { + "base": null, + "refs": { + } + }, + "ResourceCollection": { + "base": "A collection of AWS resources supported by DevOps Guru. The one type of AWS resource collection supported is AWS CloudFormation stacks. DevOps Guru can be configured to analyze only the AWS resources that are defined in the stacks.
", + "refs": { + "Event$ResourceCollection": null, + "ListEventsFilters$ResourceCollection": null, + "ProactiveAnomaly$ResourceCollection": null, + "ProactiveAnomalySummary$ResourceCollection": null, + "ProactiveInsight$ResourceCollection": null, + "ProactiveInsightSummary$ResourceCollection": null, + "ReactiveAnomaly$ResourceCollection": null, + "ReactiveAnomalySummary$ResourceCollection": null, + "ReactiveInsight$ResourceCollection": null, + "ReactiveInsightSummary$ResourceCollection": null, + "SearchInsightsFilters$ResourceCollection": null + } + }, + "ResourceCollectionFilter": { + "base": "Information about a filter used to specify which AWS resources are analyzed for anomalous behavior by DevOps Guru.
", + "refs": { + "GetResourceCollectionResponse$ResourceCollection": "The requested list of AWS resource collections. The one type of AWS resource collection supported is AWS CloudFormation stacks. DevOps Guru can be configured to analyze only the AWS resources that are defined in the stacks.
" + } + }, + "ResourceCollectionType": { + "base": null, + "refs": { + "DescribeResourceCollectionHealthRequest$ResourceCollectionType": "An AWS resource collection type. This type specifies how analyzed AWS resources are defined. The one type of AWS resource collection supported is AWS CloudFormation stacks. DevOps Guru can be configured to analyze only the AWS resources that are defined in the stacks.
", + "GetResourceCollectionRequest$ResourceCollectionType": " The type of AWS resource collections to return. The one valid value is CLOUD_FORMATION for AWS CloudFormation stacks.
The ID of the AWS resource in which a conflict occurred.
", + "ResourceNotFoundException$ResourceId": "The ID of the AWS resource that could not be found.
" + } + }, + "ResourceIdType": { + "base": null, + "refs": { + "ConflictException$ResourceType": "The type of the AWS resource in which a conflict occurred.
", + "ResourceNotFoundException$ResourceType": "The type of the AWS resource that could not be found.
" + } + }, + "ResourceNotFoundException": { + "base": "A requested resource could not be found
", + "refs": { + } + }, + "RetryAfterSeconds": { + "base": null, + "refs": { + "InternalServerException$RetryAfterSeconds": "The number of seconds after which the action that caused the internal server exception can be retried.
", + "ThrottlingException$RetryAfterSeconds": "The number of seconds after which the action that caused the throttling exception can be retried.
" + } + }, + "SearchInsightsFilters": { + "base": "Specifies one or more severity values and one or more status values that are used to search for insights.
", + "refs": { + "SearchInsightsRequest$Filters": " A SearchInsightsFilters object that is used to set the severity and status filters on your insight search.
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.
Information about the integration of DevOps Guru with another AWS service, such as AWS Systems Manager.
", + "refs": { + "DescribeServiceIntegrationResponse$ServiceIntegration": null + } + }, + "ServiceQuotaExceededException": { + "base": "The request contains a value that exceeds a maximum quota.
", + "refs": { + } + }, + "SnsChannelConfig": { + "base": "Contains the Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
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.
", + "refs": { + "NotificationChannelConfig$Sns": "Information about a notification channel configured in DevOps Guru to send notifications when insights are created.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. For more information, see Permissions for cross account Amazon SNS topics.
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.
" + } + }, + "SsmOpsItemId": { + "base": null, + "refs": { + "ProactiveInsight$SsmOpsItemId": "The ID of the AWS System Manager OpsItem created for this insight. You must enable the creation of OpstItems insights before they are created for each insight.
", + "ReactiveInsight$SsmOpsItemId": "The ID of the AWS System Manager OpsItem created for this insight. You must enable the creation of OpstItems insights before they are created for each insight.
" + } + }, + "StackName": { + "base": null, + "refs": { + "CloudFormationHealth$StackName": "The name of the CloudFormation stack.
", + "StackNames$member": null, + "UpdateStackNames$member": null + } + }, + "StackNames": { + "base": null, + "refs": { + "CloudFormationCollection$StackNames": "An array of CloudFormation stack names.
", + "CloudFormationCollectionFilter$StackNames": "An array of CloudFormation stack names.
" + } + }, + "StartTimeRange": { + "base": "A time range used to specify when the behavior of an insight or anomaly started.
", + "refs": { + "ListAnomaliesForInsightRequest$StartTimeRange": "A time range used to specify when the requested anomalies started. All returned anomalies started during this time range.
", + "ListInsightsAnyStatusFilter$StartTimeRange": "A time range used to specify when the behavior of the filtered insights started.
", + "SearchInsightsRequest$StartTimeRange": "The start of the time range passed in. Returned insights occurred after this time.
" + } + }, + "ThrottlingException": { + "base": "The request was denied due to a request throttling.
", + "refs": { + } + }, + "Timestamp": { + "base": null, + "refs": { + "AnomalyTimeRange$StartTime": "The time when the anomalous behavior started.
", + "AnomalyTimeRange$EndTime": "The time when the anomalous behavior ended.
", + "DescribeAccountOverviewRequest$FromTime": "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.
", + "DescribeAccountOverviewRequest$ToTime": "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.
", + "EndTimeRange$FromTime": "The earliest end time in the time range.
", + "EndTimeRange$ToTime": "The latest end time in the time range.
", + "Event$Time": " A Timestamp that specifies the time the event occurred.
The time when the event started.
", + "EventTimeRange$ToTime": "The time when the event ended.
", + "InsightTimeRange$StartTime": "The time when the behavior described in an insight started.
", + "InsightTimeRange$EndTime": "The time when the behavior described in an insight ended.
", + "PredictionTimeRange$StartTime": "The time range during which a metric limit is expected to be exceeded. This applies to proactive insights only.
", + "PredictionTimeRange$EndTime": "The time when the behavior in a proactive insight is expected to end.
", + "ProactiveAnomaly$UpdateTime": "The time of the anomaly's most recent update.
", + "ProactiveAnomalySummary$UpdateTime": "The time of the anomaly's most recent update.
", + "StartTimeRange$FromTime": "The start time of the time range.
", + "StartTimeRange$ToTime": "The end time of the time range.
" + } + }, + "TopicArn": { + "base": null, + "refs": { + "SnsChannelConfig$TopicArn": "The Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic.
" + } + }, + "UpdateCloudFormationCollectionFilter": { + "base": "Contains the names of AWS CloudFormation stacks used to update a collection of stacks.
", + "refs": { + "UpdateResourceCollectionFilter$CloudFormation": "An collection of AWS CloudFormation stacks.
" + } + }, + "UpdateResourceCollectionAction": { + "base": null, + "refs": { + "UpdateResourceCollectionRequest$Action": "Specifies if the resource collection in the request is added or deleted to the resource collection.
" + } + }, + "UpdateResourceCollectionFilter": { + "base": "Contains information used to update a collection of AWS resources.
", + "refs": { + "UpdateResourceCollectionRequest$ResourceCollection": null + } + }, + "UpdateResourceCollectionRequest": { + "base": null, + "refs": { + } + }, + "UpdateResourceCollectionResponse": { + "base": null, + "refs": { + } + }, + "UpdateServiceIntegrationConfig": { + "base": "Information about updating the integration status of an AWS service, such as AWS Systems Manager, with DevOps Guru.
", + "refs": { + "UpdateServiceIntegrationRequest$ServiceIntegration": " An IntegratedServiceConfig object used to specify the integrated service you want to update, and whether you want to update it to enabled or disabled.
An array of the name of stacks to update.
" + } + }, + "UuidNextToken": { + "base": null, + "refs": { + "DescribeResourceCollectionHealthRequest$NextToken": "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.
", + "DescribeResourceCollectionHealthResponse$NextToken": "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.
", + "GetResourceCollectionRequest$NextToken": "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.
", + "GetResourceCollectionResponse$NextToken": "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.
", + "ListAnomaliesForInsightRequest$NextToken": "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.
", + "ListAnomaliesForInsightResponse$NextToken": "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.
", + "ListEventsRequest$NextToken": "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.
", + "ListEventsResponse$NextToken": "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.
", + "ListInsightsRequest$NextToken": "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.
", + "ListInsightsResponse$NextToken": "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.
", + "ListNotificationChannelsRequest$NextToken": "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.
", + "ListNotificationChannelsResponse$NextToken": "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.
", + "ListRecommendationsRequest$NextToken": "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.
", + "ListRecommendationsResponse$NextToken": "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.
", + "SearchInsightsRequest$NextToken": "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.
", + "SearchInsightsResponse$NextToken": "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.
" + } + }, + "ValidationException": { + "base": "Contains information about data passed in to a field during a request that is not valid.
", + "refs": { + } + }, + "ValidationExceptionField": { + "base": "The field associated with the validation exception.
", + "refs": { + "ValidationExceptionFields$member": null + } + }, + "ValidationExceptionFields": { + "base": "An array of fields that are associated with the validation exception.
", + "refs": { + "ValidationException$Fields": null + } + }, + "ValidationExceptionReason": { + "base": null, + "refs": { + "ValidationException$Reason": "The reason the validation exception was thrown.
" } } } -} \ No newline at end of file +} diff --git a/models/apis/devops-guru/2020-12-01/examples-1.json b/models/apis/devops-guru/2020-12-01/examples-1.json new file mode 100644 index 0000000000..0ea7e3b0bb --- /dev/null +++ b/models/apis/devops-guru/2020-12-01/examples-1.json @@ -0,0 +1,5 @@ +{ + "version": "1.0", + "examples": { + } +} diff --git a/models/apis/devops-guru/2020-12-01/paginators-1.json b/models/apis/devops-guru/2020-12-01/paginators-1.json index 0360337d2f..6e9b69977b 100644 --- a/models/apis/devops-guru/2020-12-01/paginators-1.json +++ b/models/apis/devops-guru/2020-12-01/paginators-1.json @@ -9,18 +9,18 @@ }, "GetResourceCollection": { "input_token": "NextToken", + "non_aggregate_keys": [ + "ResourceCollection" + ], "output_token": "NextToken", "result_key": [ "ResourceCollection.CloudFormation.StackNames" - ], - "non_aggregate_keys": [ - "ResourceCollection" ] }, "ListAnomaliesForInsight": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxResults", + "output_token": "NextToken", "result_key": [ "ReactiveAnomalies", "ProactiveAnomalies" @@ -28,14 +28,14 @@ }, "ListEvents": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxResults", + "output_token": "NextToken", "result_key": "Events" }, "ListInsights": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxResults", + "output_token": "NextToken", "result_key": [ "ProactiveInsights", "ReactiveInsights" @@ -53,8 +53,8 @@ }, "SearchInsights": { "input_token": "NextToken", - "output_token": "NextToken", "limit_key": "MaxResults", + "output_token": "NextToken", "result_key": [ "ProactiveInsights", "ReactiveInsights" diff --git a/models/apis/ec2/2016-11-15/api-2.json b/models/apis/ec2/2016-11-15/api-2.json index a7c45e3df9..f5b4fa4f3c 100755 --- a/models/apis/ec2/2016-11-15/api-2.json +++ b/models/apis/ec2/2016-11-15/api-2.json @@ -19874,6 +19874,7 @@ "c5n.4xlarge", "c5n.9xlarge", "c5n.18xlarge", + "c5n.metal", "c6g.metal", "c6g.medium", "c6g.large", diff --git a/models/apis/globalaccelerator/2018-08-08/paginators-1.json b/models/apis/globalaccelerator/2018-08-08/paginators-1.json index d5ab47d079..b8d23c6746 100644 --- a/models/apis/globalaccelerator/2018-08-08/paginators-1.json +++ b/models/apis/globalaccelerator/2018-08-08/paginators-1.json @@ -3,12 +3,20 @@ "ListAccelerators": { "input_token": "NextToken", "output_token": "NextToken", - "limit_key": "MaxResults" + "limit_key": "MaxResults", + "result_key": "Accelerators" + }, + "ListByoipCidrs": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults", + "result_key": "ByoipCidrs" }, "ListCustomRoutingAccelerators": { "input_token": "NextToken", "output_token": "NextToken", - "limit_key": "MaxResults" + "limit_key": "MaxResults", + "result_key": "Accelerators" }, "ListCustomRoutingEndpointGroups": { "input_token": "NextToken", @@ -18,27 +26,32 @@ "ListCustomRoutingListeners": { "input_token": "NextToken", "output_token": "NextToken", - "limit_key": "MaxResults" + "limit_key": "MaxResults", + "result_key": "Listeners" }, "ListCustomRoutingPortMappings": { "input_token": "NextToken", "output_token": "NextToken", - "limit_key": "MaxResults" + "limit_key": "MaxResults", + "result_key": "PortMappings" }, "ListCustomRoutingPortMappingsByDestination": { "input_token": "NextToken", "output_token": "NextToken", - "limit_key": "MaxResults" + "limit_key": "MaxResults", + "result_key": "DestinationPortMappings" }, "ListEndpointGroups": { "input_token": "NextToken", "output_token": "NextToken", - "limit_key": "MaxResults" + "limit_key": "MaxResults", + "result_key": "EndpointGroups" }, "ListListeners": { "input_token": "NextToken", "output_token": "NextToken", - "limit_key": "MaxResults" + "limit_key": "MaxResults", + "result_key": "Listeners" } } } diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index 8127531c63..336d02015d 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -5419,6 +5419,7 @@ }, "servicediscovery" : { "endpoints" : { + "af-south-1" : { }, "ap-east-1" : { }, "ap-northeast-1" : { }, "ap-northeast-2" : { }, @@ -5428,6 +5429,7 @@ "ca-central-1" : { }, "eu-central-1" : { }, "eu-north-1" : { }, + "eu-south-1" : { }, "eu-west-1" : { }, "eu-west-2" : { }, "eu-west-3" : { }, diff --git a/service/devopsguru/api.go b/service/devopsguru/api.go index fde93c7c07..5b587edb93 100644 --- a/service/devopsguru/api.go +++ b/service/devopsguru/api.go @@ -57,6 +57,21 @@ func (c *DevOpsGuru) AddNotificationChannelRequest(input *AddNotificationChannel // AddNotificationChannel API operation for Amazon DevOps Guru. // +// 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 it notifications. DevOps Guru +// adds the required policy on your behalf to send notifications using Amazon +// SNS in your account. For more information, see Permissions for cross account +// 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). +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -65,19 +80,31 @@ func (c *DevOpsGuru) AddNotificationChannelRequest(input *AddNotificationChannel // API operation AddNotificationChannel for usage and error information. // // Returned Error Types: -// * ValidationException -// -// * InternalServerException +// * 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. // -// * ServiceQuotaExceededException +// * ConflictException +// An exception that is thrown when a conflict occurs. // -// * AccessDeniedException +// * InternalServerException +// An internal failure in an Amazon service occurred. // // * ResourceNotFoundException +// A requested resource could not be found +// +// * ServiceQuotaExceededException +// The request contains a value that exceeds a maximum quota. // // * ThrottlingException +// The request was denied due to a request throttling. // -// * ConflictException +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/AddNotificationChannel func (c *DevOpsGuru) AddNotificationChannel(input *AddNotificationChannelInput) (*AddNotificationChannelOutput, error) { @@ -145,6 +172,10 @@ func (c *DevOpsGuru) DescribeAccountHealthRequest(input *DescribeAccountHealthIn // DescribeAccountHealth API operation for Amazon DevOps Guru. // +// 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. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -153,13 +184,22 @@ func (c *DevOpsGuru) DescribeAccountHealthRequest(input *DescribeAccountHealthIn // API operation DescribeAccountHealth for usage and error information. // // Returned Error Types: -// * ThrottlingException -// -// * ValidationException +// * 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. // // * InternalServerException +// An internal failure in an Amazon service occurred. // -// * AccessDeniedException +// * ThrottlingException +// The request was denied due to a request throttling. +// +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeAccountHealth func (c *DevOpsGuru) DescribeAccountHealth(input *DescribeAccountHealthInput) (*DescribeAccountHealthOutput, error) { @@ -227,6 +267,10 @@ func (c *DevOpsGuru) DescribeAccountOverviewRequest(input *DescribeAccountOvervi // DescribeAccountOverview API operation for Amazon DevOps Guru. // +// 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. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -235,13 +279,22 @@ func (c *DevOpsGuru) DescribeAccountOverviewRequest(input *DescribeAccountOvervi // API operation DescribeAccountOverview for usage and error information. // // Returned Error Types: -// * ThrottlingException -// -// * ValidationException +// * 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. // // * InternalServerException +// An internal failure in an Amazon service occurred. // -// * AccessDeniedException +// * ThrottlingException +// The request was denied due to a request throttling. +// +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeAccountOverview func (c *DevOpsGuru) DescribeAccountOverview(input *DescribeAccountOverviewInput) (*DescribeAccountOverviewOutput, error) { @@ -309,6 +362,8 @@ func (c *DevOpsGuru) DescribeAnomalyRequest(input *DescribeAnomalyInput) (req *r // DescribeAnomaly API operation for Amazon DevOps Guru. // +// Returns details about an anomaly that you specify using its ID. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -317,15 +372,25 @@ func (c *DevOpsGuru) DescribeAnomalyRequest(input *DescribeAnomalyInput) (req *r // API operation DescribeAnomaly for usage and error information. // // Returned Error Types: +// * 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. +// +// * InternalServerException +// An internal failure in an Amazon service occurred. +// // * ResourceNotFoundException +// A requested resource could not be found // // * ThrottlingException +// The request was denied due to a request throttling. // // * ValidationException -// -// * InternalServerException -// -// * AccessDeniedException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeAnomaly func (c *DevOpsGuru) DescribeAnomaly(input *DescribeAnomalyInput) (*DescribeAnomalyOutput, error) { @@ -393,6 +458,8 @@ func (c *DevOpsGuru) DescribeInsightRequest(input *DescribeInsightInput) (req *r // DescribeInsight API operation for Amazon DevOps Guru. // +// Returns details about an insight that you specify using its ID. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -401,15 +468,25 @@ func (c *DevOpsGuru) DescribeInsightRequest(input *DescribeInsightInput) (req *r // API operation DescribeInsight for usage and error information. // // Returned Error Types: +// * 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. +// +// * InternalServerException +// An internal failure in an Amazon service occurred. +// // * ResourceNotFoundException +// A requested resource could not be found // // * ThrottlingException +// The request was denied due to a request throttling. // // * ValidationException -// -// * InternalServerException -// -// * AccessDeniedException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeInsight func (c *DevOpsGuru) DescribeInsight(input *DescribeInsightInput) (*DescribeInsightOutput, error) { @@ -483,6 +560,13 @@ func (c *DevOpsGuru) DescribeResourceCollectionHealthRequest(input *DescribeReso // DescribeResourceCollectionHealth API operation for Amazon DevOps Guru. // +// 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 one +// type of AWS resource collection supported is AWS CloudFormation stacks. DevOps +// Guru can be configured to analyze only the AWS resources that are defined +// in the stacks. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -491,13 +575,22 @@ func (c *DevOpsGuru) DescribeResourceCollectionHealthRequest(input *DescribeReso // API operation DescribeResourceCollectionHealth for usage and error information. // // Returned Error Types: -// * ThrottlingException -// -// * ValidationException +// * 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. // // * InternalServerException +// An internal failure in an Amazon service occurred. // -// * AccessDeniedException +// * ThrottlingException +// The request was denied due to a request throttling. +// +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeResourceCollectionHealth func (c *DevOpsGuru) DescribeResourceCollectionHealth(input *DescribeResourceCollectionHealthInput) (*DescribeResourceCollectionHealthOutput, error) { @@ -617,6 +710,10 @@ func (c *DevOpsGuru) DescribeServiceIntegrationRequest(input *DescribeServiceInt // DescribeServiceIntegration API operation for Amazon DevOps Guru. // +// Returns the integration status of services that are integrated with DevOps +// Guru. The one service that can be integrated with DevOps Guru is AWS Systems +// Manager, which can be used to create an OpsItem for each generated insight. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -625,13 +722,22 @@ func (c *DevOpsGuru) DescribeServiceIntegrationRequest(input *DescribeServiceInt // API operation DescribeServiceIntegration for usage and error information. // // Returned Error Types: -// * ThrottlingException -// -// * ValidationException +// * 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. // // * InternalServerException +// An internal failure in an Amazon service occurred. // -// * AccessDeniedException +// * ThrottlingException +// The request was denied due to a request throttling. +// +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/DescribeServiceIntegration func (c *DevOpsGuru) DescribeServiceIntegration(input *DescribeServiceIntegrationInput) (*DescribeServiceIntegrationOutput, error) { @@ -705,6 +811,11 @@ func (c *DevOpsGuru) GetResourceCollectionRequest(input *GetResourceCollectionIn // GetResourceCollection API operation for Amazon DevOps Guru. // +// Returns lists AWS resources that are of the specified resource collection +// type. The one type of AWS resource collection supported is AWS CloudFormation +// stacks. DevOps Guru can be configured to analyze only the AWS resources that +// are defined in the stacks. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -713,15 +824,25 @@ func (c *DevOpsGuru) GetResourceCollectionRequest(input *GetResourceCollectionIn // API operation GetResourceCollection for usage and error information. // // Returned Error Types: +// * 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. +// +// * InternalServerException +// An internal failure in an Amazon service occurred. +// // * ResourceNotFoundException +// A requested resource could not be found // // * ThrottlingException +// The request was denied due to a request throttling. // // * ValidationException -// -// * InternalServerException -// -// * AccessDeniedException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/GetResourceCollection func (c *DevOpsGuru) GetResourceCollection(input *GetResourceCollectionInput) (*GetResourceCollectionOutput, error) { @@ -847,6 +968,9 @@ func (c *DevOpsGuru) ListAnomaliesForInsightRequest(input *ListAnomaliesForInsig // ListAnomaliesForInsight API operation for Amazon DevOps Guru. // +// Returns a list of the anomalies that belong to an insight that you specify +// using its ID. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -855,15 +979,25 @@ func (c *DevOpsGuru) ListAnomaliesForInsightRequest(input *ListAnomaliesForInsig // API operation ListAnomaliesForInsight for usage and error information. // // Returned Error Types: +// * 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. +// +// * InternalServerException +// An internal failure in an Amazon service occurred. +// // * ResourceNotFoundException +// A requested resource could not be found // // * ThrottlingException +// The request was denied due to a request throttling. // // * ValidationException -// -// * InternalServerException -// -// * AccessDeniedException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListAnomaliesForInsight func (c *DevOpsGuru) ListAnomaliesForInsight(input *ListAnomaliesForInsightInput) (*ListAnomaliesForInsightOutput, error) { @@ -989,6 +1123,9 @@ func (c *DevOpsGuru) ListEventsRequest(input *ListEventsInput) (req *request.Req // ListEvents API operation for Amazon DevOps Guru. // +// 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. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -997,15 +1134,25 @@ func (c *DevOpsGuru) ListEventsRequest(input *ListEventsInput) (req *request.Req // API operation ListEvents for usage and error information. // // Returned Error Types: +// * 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. +// +// * InternalServerException +// An internal failure in an Amazon service occurred. +// // * ResourceNotFoundException +// A requested resource could not be found // // * ThrottlingException +// The request was denied due to a request throttling. // // * ValidationException -// -// * InternalServerException -// -// * AccessDeniedException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListEvents func (c *DevOpsGuru) ListEvents(input *ListEventsInput) (*ListEventsOutput, error) { @@ -1131,6 +1278,9 @@ func (c *DevOpsGuru) ListInsightsRequest(input *ListInsightsInput) (req *request // ListInsights API operation for Amazon DevOps Guru. // +// 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). +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -1139,13 +1289,22 @@ func (c *DevOpsGuru) ListInsightsRequest(input *ListInsightsInput) (req *request // API operation ListInsights for usage and error information. // // Returned Error Types: -// * ThrottlingException -// -// * ValidationException +// * 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. // // * InternalServerException +// An internal failure in an Amazon service occurred. // -// * AccessDeniedException +// * ThrottlingException +// The request was denied due to a request throttling. +// +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListInsights func (c *DevOpsGuru) ListInsights(input *ListInsightsInput) (*ListInsightsOutput, error) { @@ -1271,6 +1430,12 @@ func (c *DevOpsGuru) ListNotificationChannelsRequest(input *ListNotificationChan // ListNotificationChannels API operation for Amazon DevOps Guru. // +// 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). +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -1279,13 +1444,22 @@ func (c *DevOpsGuru) ListNotificationChannelsRequest(input *ListNotificationChan // API operation ListNotificationChannels for usage and error information. // // Returned Error Types: -// * ThrottlingException -// -// * ValidationException +// * 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. // // * InternalServerException +// An internal failure in an Amazon service occurred. // -// * AccessDeniedException +// * ThrottlingException +// The request was denied due to a request throttling. +// +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListNotificationChannels func (c *DevOpsGuru) ListNotificationChannels(input *ListNotificationChannelsInput) (*ListNotificationChannelsOutput, error) { @@ -1411,6 +1585,9 @@ func (c *DevOpsGuru) ListRecommendationsRequest(input *ListRecommendationsInput) // ListRecommendations API operation for Amazon DevOps Guru. // +// Returns a list of a specified insight's recommendations. Each recommendation +// includes a list of related metrics and a list of related events. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -1419,15 +1596,25 @@ func (c *DevOpsGuru) ListRecommendationsRequest(input *ListRecommendationsInput) // API operation ListRecommendations for usage and error information. // // Returned Error Types: +// * 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. +// +// * InternalServerException +// An internal failure in an Amazon service occurred. +// // * ResourceNotFoundException +// A requested resource could not be found // // * ThrottlingException +// The request was denied due to a request throttling. // // * ValidationException -// -// * InternalServerException -// -// * AccessDeniedException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/ListRecommendations func (c *DevOpsGuru) ListRecommendations(input *ListRecommendationsInput) (*ListRecommendationsOutput, error) { @@ -1548,6 +1735,8 @@ func (c *DevOpsGuru) PutFeedbackRequest(input *PutFeedbackInput) (req *request.R // PutFeedback API operation for Amazon DevOps Guru. // +// Collects customer feedback about the specified insight. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -1556,17 +1745,28 @@ func (c *DevOpsGuru) PutFeedbackRequest(input *PutFeedbackInput) (req *request.R // API operation PutFeedback for usage and error information. // // Returned Error Types: -// * ValidationException +// * 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. // -// * InternalServerException +// * ConflictException +// An exception that is thrown when a conflict occurs. // -// * AccessDeniedException +// * InternalServerException +// An internal failure in an Amazon service occurred. // // * ResourceNotFoundException +// A requested resource could not be found // // * ThrottlingException +// The request was denied due to a request throttling. // -// * ConflictException +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/PutFeedback func (c *DevOpsGuru) PutFeedback(input *PutFeedbackInput) (*PutFeedbackOutput, error) { @@ -1635,6 +1835,10 @@ func (c *DevOpsGuru) RemoveNotificationChannelRequest(input *RemoveNotificationC // RemoveNotificationChannel API operation for Amazon DevOps Guru. // +// 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. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -1643,17 +1847,28 @@ func (c *DevOpsGuru) RemoveNotificationChannelRequest(input *RemoveNotificationC // API operation RemoveNotificationChannel for usage and error information. // // Returned Error Types: -// * ValidationException +// * 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. // -// * InternalServerException +// * ConflictException +// An exception that is thrown when a conflict occurs. // -// * AccessDeniedException +// * InternalServerException +// An internal failure in an Amazon service occurred. // // * ResourceNotFoundException +// A requested resource could not be found // // * ThrottlingException +// The request was denied due to a request throttling. // -// * ConflictException +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/RemoveNotificationChannel func (c *DevOpsGuru) RemoveNotificationChannel(input *RemoveNotificationChannelInput) (*RemoveNotificationChannelOutput, error) { @@ -1727,6 +1942,14 @@ func (c *DevOpsGuru) SearchInsightsRequest(input *SearchInsightsInput) (req *req // SearchInsights API operation for Amazon DevOps Guru. // +// 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, 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. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -1735,13 +1958,22 @@ func (c *DevOpsGuru) SearchInsightsRequest(input *SearchInsightsInput) (req *req // API operation SearchInsights for usage and error information. // // Returned Error Types: -// * ThrottlingException -// -// * ValidationException +// * 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. // // * InternalServerException +// An internal failure in an Amazon service occurred. // -// * AccessDeniedException +// * ThrottlingException +// The request was denied due to a request throttling. +// +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/SearchInsights func (c *DevOpsGuru) SearchInsights(input *SearchInsightsInput) (*SearchInsightsOutput, error) { @@ -1862,6 +2094,12 @@ func (c *DevOpsGuru) UpdateResourceCollectionRequest(input *UpdateResourceCollec // UpdateResourceCollection API operation for Amazon DevOps Guru. // +// Updates the collection of resources that DevOps Guru analyzes. The one type +// of AWS resource collection supported is AWS CloudFormation stacks. DevOps +// Guru can be configured to analyze only the AWS resources that are defined +// in the stacks. This method also creates the IAM role required for you to +// use DevOps Guru. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -1870,15 +2108,25 @@ func (c *DevOpsGuru) UpdateResourceCollectionRequest(input *UpdateResourceCollec // API operation UpdateResourceCollection for usage and error information. // // Returned Error Types: -// * ThrottlingException +// * 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. // -// * ValidationException +// * ConflictException +// An exception that is thrown when a conflict occurs. // // * InternalServerException +// An internal failure in an Amazon service occurred. // -// * ConflictException +// * ThrottlingException +// The request was denied due to a request throttling. // -// * AccessDeniedException +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/UpdateResourceCollection func (c *DevOpsGuru) UpdateResourceCollection(input *UpdateResourceCollectionInput) (*UpdateResourceCollectionOutput, error) { @@ -1947,6 +2195,11 @@ func (c *DevOpsGuru) UpdateServiceIntegrationRequest(input *UpdateServiceIntegra // UpdateServiceIntegration API operation for Amazon DevOps Guru. // +// 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 AWS +// Systems Manager, which can be used to create an OpsItem for each generated +// insight. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -1955,15 +2208,25 @@ func (c *DevOpsGuru) UpdateServiceIntegrationRequest(input *UpdateServiceIntegra // API operation UpdateServiceIntegration for usage and error information. // // Returned Error Types: -// * ThrottlingException +// * 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. // -// * ValidationException +// * ConflictException +// An exception that is thrown when a conflict occurs. // // * InternalServerException +// An internal failure in an Amazon service occurred. // -// * ConflictException +// * ThrottlingException +// The request was denied due to a request throttling. // -// * AccessDeniedException +// * ValidationException +// Contains information about data passed in to a field during a request that +// is not valid. // // See also, https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01/UpdateServiceIntegration func (c *DevOpsGuru) UpdateServiceIntegration(input *UpdateServiceIntegrationInput) (*UpdateServiceIntegrationOutput, error) { @@ -1987,6 +2250,11 @@ func (c *DevOpsGuru) UpdateServiceIntegrationWithContext(ctx aws.Context, input return out, req.Send() } +// 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. type AccessDeniedException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -2045,6 +2313,10 @@ func (s *AccessDeniedException) RequestID() string { type AddNotificationChannelInput struct { _ struct{} `type:"structure"` + // A NotificationChannelConfig object that specifies what type of notification + // channel to add. The one supported notification channel is Amazon Simple Notification + // Service (Amazon SNS). + // // Config is a required field Config *NotificationChannelConfig `type:"structure" required:"true"` } @@ -2086,7 +2358,10 @@ func (s *AddNotificationChannelInput) SetConfig(v *NotificationChannelConfig) *A type AddNotificationChannelOutput struct { _ struct{} `type:"structure"` - Id *string `min:"36" type:"string"` + // The ID of the added notification channel. + // + // Id is a required field + Id *string `min:"36" type:"string" required:"true"` } // String returns the string representation @@ -2105,9 +2380,13 @@ func (s *AddNotificationChannelOutput) SetId(v string) *AddNotificationChannelOu return s } +// Details about the source of the anomalous operational data that triggered +// the anomaly. The one supported source is Amazon CloudWatch metrics. type AnomalySourceDetails struct { _ struct{} `type:"structure"` + // An array of CloudWatchMetricsDetail object that contains information about + // the analyzed metrics that displayed anomalous behavior. CloudWatchMetrics []*CloudWatchMetricsDetail `type:"list"` } @@ -2127,13 +2406,18 @@ func (s *AnomalySourceDetails) SetCloudWatchMetrics(v []*CloudWatchMetricsDetail return s } +// A time range that specifies when the observed unusual behavior in an anomaly +// started and ended. type AnomalyTimeRange struct { _ struct{} `type:"structure"` - EndTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // The time when the anomalous behavior ended. + EndTime *time.Time `type:"timestamp"` + // The time when the anomalous behavior started. + // // StartTime is a required field - StartTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp" required:"true"` + StartTime *time.Time `type:"timestamp" required:"true"` } // String returns the string representation @@ -2158,9 +2442,14 @@ func (s *AnomalyTimeRange) SetStartTime(v time.Time) *AnomalyTimeRange { return s } +// Information about AWS CloudFormation stacks. You can use stacks to specify +// which AWS resources in your account to analyze. For more information, see +// Stacks (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html) +// in the AWS CloudFormation User Guide. type CloudFormationCollection struct { _ struct{} `type:"structure"` + // An array of CloudFormation stack names. StackNames []*string `type:"list"` } @@ -2180,9 +2469,14 @@ func (s *CloudFormationCollection) SetStackNames(v []*string) *CloudFormationCol return s } +// Information about AWS CloudFormation stacks. You can use stacks to specify +// which AWS resources in your account to analyze. For more information, see +// Stacks (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html) +// in the AWS CloudFormation User Guide. type CloudFormationCollectionFilter struct { _ struct{} `type:"structure"` + // An array of CloudFormation stack names. StackNames []*string `type:"list"` } @@ -2202,11 +2496,17 @@ func (s *CloudFormationCollectionFilter) SetStackNames(v []*string) *CloudFormat return s } +// Information about the health of AWS resources in your account that are specified +// by an AWS CloudFormation stack. type CloudFormationHealth struct { _ struct{} `type:"structure"` + // Information about the health of the AWS resources in your account that are + // specified by an AWS CloudFormation stack, including the number of open proactive, + // open reactive insights, and the Mean Time to Recover (MTTR) of closed insights. Insight *InsightHealth `type:"structure"` + // The name of the CloudFormation stack. StackName *string `min:"1" type:"string"` } @@ -2232,19 +2532,30 @@ func (s *CloudFormationHealth) SetStackName(v string) *CloudFormationHealth { return s } +// Information about an Amazon CloudWatch metric. type CloudWatchMetricsDetail struct { _ struct{} `type:"structure"` + // An array of CloudWatch dimensions associated with Dimensions []*CloudWatchMetricsDimension `type:"list"` + // The name of the CloudWatch metric. MetricName *string `type:"string"` + // The namespace of the CloudWatch metric. A namespace is a container for CloudWatch + // metrics. Namespace *string `type:"string"` + // The length of time associated with the CloudWatch metric in number of seconds. Period *int64 `type:"integer"` + // The type of statistic associated with the CloudWatch metric. For more information, + // see Statistics (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Statistic) + // in the Amazon CloudWatch User Guide. Stat *string `type:"string" enum:"CloudWatchMetricsStat"` + // The unit of measure used for the CloudWatch metric. For example, Bytes, Seconds, + // Count, and Percent. Unit *string `type:"string"` } @@ -2294,11 +2605,19 @@ func (s *CloudWatchMetricsDetail) SetUnit(v string) *CloudWatchMetricsDetail { return s } +// The dimension of a Amazon CloudWatch metric that is used when DevOps Guru +// analyzes the resources in your account for operational problems and anomalous +// behaviour. A dimension is a name/value pair that is part of the identity +// of a metric. A metric can have up to 10 dimensions. For more information, +// see Dimensions (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) +// in the Amazon CloudWatch User Guide. type CloudWatchMetricsDimension struct { _ struct{} `type:"structure"` + // The name of the CloudWatch dimension. Name *string `type:"string"` + // The value of the CloudWatch dimension. Value *string `type:"string"` } @@ -2324,15 +2643,20 @@ func (s *CloudWatchMetricsDimension) SetValue(v string) *CloudWatchMetricsDimens return s } +// An exception that is thrown when a conflict occurs. type ConflictException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` Message_ *string `locationName:"Message" type:"string"` + // The ID of the AWS resource in which a conflict occurred. + // // ResourceId is a required field ResourceId *string `type:"string" required:"true"` + // The type of the AWS resource in which a conflict occurred. + // // ResourceType is a required field ResourceType *string `type:"string" required:"true"` } @@ -2402,11 +2726,23 @@ func (s DescribeAccountHealthInput) GoString() string { type DescribeAccountHealthOutput struct { _ struct{} `type:"structure"` - MetricsAnalyzed *int64 `type:"integer"` + // An integer that specifies the number of metrics that have been analyzed in + // your AWS account. + // + // MetricsAnalyzed is a required field + MetricsAnalyzed *int64 `type:"integer" required:"true"` - OpenProactiveInsights *int64 `type:"integer"` + // An integer that specifies the number of open proactive insights in your AWS + // account. + // + // OpenProactiveInsights is a required field + OpenProactiveInsights *int64 `type:"integer" required:"true"` - OpenReactiveInsights *int64 `type:"integer"` + // An integer that specifies the number of open reactive insights in your AWS + // account. + // + // OpenReactiveInsights is a required field + OpenReactiveInsights *int64 `type:"integer" required:"true"` } // String returns the string representation @@ -2440,10 +2776,17 @@ func (s *DescribeAccountHealthOutput) SetOpenReactiveInsights(v int64) *Describe type DescribeAccountOverviewInput struct { _ struct{} `type:"structure"` + // 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. + // // FromTime is a required field - FromTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp" required:"true"` + FromTime *time.Time `type:"timestamp" required:"true"` - ToTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // 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. + ToTime *time.Time `type:"timestamp"` } // String returns the string representation @@ -2484,11 +2827,23 @@ func (s *DescribeAccountOverviewInput) SetToTime(v time.Time) *DescribeAccountOv type DescribeAccountOverviewOutput struct { _ struct{} `type:"structure"` - MeanTimeToRecoverInMilliseconds *int64 `type:"long"` + // The Mean Time to Recover (MTTR) for all closed insights that were created + // during the time range passed in. + // + // MeanTimeToRecoverInMilliseconds is a required field + MeanTimeToRecoverInMilliseconds *int64 `type:"long" required:"true"` - ProactiveInsights *int64 `type:"integer"` + // An integer that specifies the number of open proactive insights in your AWS + // account that were created during the time range passed in. + // + // ProactiveInsights is a required field + ProactiveInsights *int64 `type:"integer" required:"true"` - ReactiveInsights *int64 `type:"integer"` + // An integer that specifies the number of open reactive insights in your AWS + // account that were created during the time range passed in. + // + // ReactiveInsights is a required field + ReactiveInsights *int64 `type:"integer" required:"true"` } // String returns the string representation @@ -2522,8 +2877,10 @@ func (s *DescribeAccountOverviewOutput) SetReactiveInsights(v int64) *DescribeAc type DescribeAnomalyInput struct { _ struct{} `type:"structure"` + // The ID of the anomaly. + // // Id is a required field - Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` + Id *string `location:"uri" locationName:"Id" min:"1" type:"string" required:"true"` } // String returns the string representation @@ -2561,8 +2918,10 @@ func (s *DescribeAnomalyInput) SetId(v string) *DescribeAnomalyInput { type DescribeAnomalyOutput struct { _ struct{} `type:"structure"` + // An ReactiveAnomaly object that represents the requested anomaly. ProactiveAnomaly *ProactiveAnomaly `type:"structure"` + // An ProactiveAnomaly object that represents the requested anomaly. ReactiveAnomaly *ReactiveAnomaly `type:"structure"` } @@ -2591,8 +2950,10 @@ func (s *DescribeAnomalyOutput) SetReactiveAnomaly(v *ReactiveAnomaly) *Describe type DescribeInsightInput struct { _ struct{} `type:"structure"` + // The ID of the insight. + // // Id is a required field - Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` + Id *string `location:"uri" locationName:"Id" min:"1" type:"string" required:"true"` } // String returns the string representation @@ -2630,8 +2991,10 @@ func (s *DescribeInsightInput) SetId(v string) *DescribeInsightInput { type DescribeInsightOutput struct { _ struct{} `type:"structure"` + // An ProactiveInsight object that represents the requested insight. ProactiveInsight *ProactiveInsight `type:"structure"` + // An ReactiveInsight object that represents the requested insight. ReactiveInsight *ReactiveInsight `type:"structure"` } @@ -2660,10 +3023,17 @@ func (s *DescribeInsightOutput) SetReactiveInsight(v *ReactiveInsight) *Describe type DescribeResourceCollectionHealthInput struct { _ struct{} `type:"structure"` - NextToken *string `location:"querystring" locationName:"NextToken" type:"string"` + // 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. + NextToken *string `location:"querystring" locationName:"NextToken" min:"36" type:"string"` + // An AWS resource collection type. This type specifies how analyzed AWS resources + // are defined. The one type of AWS resource collection supported is AWS CloudFormation + // stacks. DevOps Guru can be configured to analyze only the AWS resources that + // are defined in the stacks. + // // ResourceCollectionType is a required field - ResourceCollectionType *string `location:"uri" locationName:"ResourceCollectionType" type:"string" required:"true"` + ResourceCollectionType *string `location:"uri" locationName:"ResourceCollectionType" type:"string" required:"true" enum:"ResourceCollectionType"` } // String returns the string representation @@ -2679,6 +3049,9 @@ func (s DescribeResourceCollectionHealthInput) GoString() string { // Validate inspects the fields of the type to determine if they are valid. func (s *DescribeResourceCollectionHealthInput) Validate() error { invalidParams := request.ErrInvalidParams{Context: "DescribeResourceCollectionHealthInput"} + if s.NextToken != nil && len(*s.NextToken) < 36 { + invalidParams.Add(request.NewErrParamMinLen("NextToken", 36)) + } if s.ResourceCollectionType == nil { invalidParams.Add(request.NewErrParamRequired("ResourceCollectionType")) } @@ -2707,8 +3080,14 @@ func (s *DescribeResourceCollectionHealthInput) SetResourceCollectionType(v stri type DescribeResourceCollectionHealthOutput struct { _ struct{} `type:"structure"` - CloudFormation []*CloudFormationHealth `type:"list"` + // The returned CloudFormationHealthOverview object that contains an InsightHealthOverview + // object with the requested system health information. + // + // CloudFormation is a required field + CloudFormation []*CloudFormationHealth `type:"list" required:"true"` + // 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. NextToken *string `min:"36" type:"string"` } @@ -2751,6 +3130,8 @@ func (s DescribeServiceIntegrationInput) GoString() string { type DescribeServiceIntegrationOutput struct { _ struct{} `type:"structure"` + // Information about the integration of DevOps Guru with another AWS service, + // such as AWS Systems Manager. ServiceIntegration *ServiceIntegrationConfig `type:"structure"` } @@ -2770,12 +3151,16 @@ func (s *DescribeServiceIntegrationOutput) SetServiceIntegration(v *ServiceInteg return s } +// A range of time that specifies when anomalous behavior in an anomaly or insight +// ended. type EndTimeRange struct { _ struct{} `type:"structure"` - FromTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // The earliest end time in the time range. + FromTime *time.Time `type:"timestamp"` - ToTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // The latest end time in the time range. + ToTime *time.Time `type:"timestamp"` } // String returns the string representation @@ -2800,24 +3185,40 @@ func (s *EndTimeRange) SetToTime(v time.Time) *EndTimeRange { return s } +// An AWS resource event. AWS resource events and metrics are analyzed by DevOps +// Guru to find anomalous behavior and provide recommendations to improve your +// operational solutions. type Event struct { _ struct{} `type:"structure"` + // The source, AWS_CLOUD_TRAIL or AWS_CODE_DEPLOY, where DevOps Guru analysis + // found the event. DataSource *string `type:"string" enum:"EventDataSource"` + // The class of the event. The class specifies what the event is related to, + // such as an infrastructure change, a deployment, or a schema change. EventClass *string `type:"string" enum:"EventClass"` + // The AWS source that emitted the event. EventSource *string `min:"10" type:"string"` + // The ID of the event. Id *string `type:"string"` + // The name of the event. Name *string `type:"string"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` + // An EventResource object that contains information about the resource that + // emitted the event. Resources []*EventResource `type:"list"` - Time *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // A Timestamp that specifies the time the event occurred. + Time *time.Time `type:"timestamp"` } // String returns the string representation @@ -2878,13 +3279,19 @@ func (s *Event) SetTime(v time.Time) *Event { return s } +// The AWS resource that emitted an event. AWS resource events and metrics are +// analyzed by DevOps Guru to find anomalous behavior and provide recommendations +// to improve your operational solutions. type EventResource struct { _ struct{} `type:"structure"` + // The Amazon Resource Name (ARN) of the resource that emitted an event. Arn *string `min:"36" type:"string"` + // The name of the resource that emitted an event. Name *string `type:"string"` + // The type of resource that emitted an event. Type *string `type:"string"` } @@ -2916,14 +3323,21 @@ func (s *EventResource) SetType(v string) *EventResource { return s } +// The time range during which an AWS event occurred. AWS resource events and +// metrics are analyzed by DevOps Guru to find anomalous behavior and provide +// recommendations to improve your operational solutions. type EventTimeRange struct { _ struct{} `type:"structure"` + // The time when the event started. + // // FromTime is a required field - FromTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp" required:"true"` + FromTime *time.Time `type:"timestamp" required:"true"` + // The time when the event ended. + // // ToTime is a required field - ToTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp" required:"true"` + ToTime *time.Time `type:"timestamp" required:"true"` } // String returns the string representation @@ -2967,10 +3381,15 @@ func (s *EventTimeRange) SetToTime(v time.Time) *EventTimeRange { type GetResourceCollectionInput struct { _ struct{} `type:"structure"` - NextToken *string `location:"querystring" locationName:"NextToken" type:"string"` + // 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. + NextToken *string `location:"querystring" locationName:"NextToken" min:"36" type:"string"` + // The type of AWS resource collections to return. The one valid value is CLOUD_FORMATION + // for AWS CloudFormation stacks. + // // ResourceCollectionType is a required field - ResourceCollectionType *string `location:"uri" locationName:"ResourceCollectionType" type:"string" required:"true"` + ResourceCollectionType *string `location:"uri" locationName:"ResourceCollectionType" type:"string" required:"true" enum:"ResourceCollectionType"` } // String returns the string representation @@ -2986,6 +3405,9 @@ func (s GetResourceCollectionInput) GoString() string { // Validate inspects the fields of the type to determine if they are valid. func (s *GetResourceCollectionInput) Validate() error { invalidParams := request.ErrInvalidParams{Context: "GetResourceCollectionInput"} + if s.NextToken != nil && len(*s.NextToken) < 36 { + invalidParams.Add(request.NewErrParamMinLen("NextToken", 36)) + } if s.ResourceCollectionType == nil { invalidParams.Add(request.NewErrParamRequired("ResourceCollectionType")) } @@ -3014,8 +3436,13 @@ func (s *GetResourceCollectionInput) SetResourceCollectionType(v string) *GetRes type GetResourceCollectionOutput struct { _ struct{} `type:"structure"` + // 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. NextToken *string `min:"36" type:"string"` + // The requested list of AWS resource collections. The one type of AWS resource + // collection supported is AWS CloudFormation stacks. DevOps Guru can be configured + // to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollectionFilter `type:"structure"` } @@ -3041,11 +3468,14 @@ func (s *GetResourceCollectionOutput) SetResourceCollection(v *ResourceCollectio return s } +// Information about insight feedback received from a customer. type InsightFeedback struct { _ struct{} `type:"structure"` + // The feedback provided by the customer. Feedback *string `type:"string" enum:"InsightFeedbackOption"` + // The insight feedback ID. Id *string `min:"1" type:"string"` } @@ -3084,13 +3514,18 @@ func (s *InsightFeedback) SetId(v string) *InsightFeedback { return s } +// Information about the number of open reactive and proactive insights that +// can be used to gauge the health of your system. type InsightHealth struct { _ struct{} `type:"structure"` + // The Meant Time to Recover (MTTR) for the insight. MeanTimeToRecoverInMilliseconds *int64 `type:"long"` + // The number of open proactive insights. OpenProactiveInsights *int64 `type:"integer"` + // The number of open reactive insights. OpenReactiveInsights *int64 `type:"integer"` } @@ -3122,13 +3557,18 @@ func (s *InsightHealth) SetOpenReactiveInsights(v int64) *InsightHealth { return s } +// A time ranged that specifies when the observed behavior in an insight started +// and ended. type InsightTimeRange struct { _ struct{} `type:"structure"` - EndTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // The time when the behavior described in an insight ended. + EndTime *time.Time `type:"timestamp"` + // The time when the behavior described in an insight started. + // // StartTime is a required field - StartTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp" required:"true"` + StartTime *time.Time `type:"timestamp" required:"true"` } // String returns the string representation @@ -3153,11 +3593,16 @@ func (s *InsightTimeRange) SetStartTime(v time.Time) *InsightTimeRange { return s } +// An internal failure in an Amazon service occurred. type InternalServerException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` Message_ *string `locationName:"Message" type:"string"` + + // The number of seconds after which the action that caused the internal server + // exception can be retried. + RetryAfterSeconds *int64 `location:"header" locationName:"Retry-After" type:"integer"` } // String returns the string representation @@ -3195,7 +3640,7 @@ func (s *InternalServerException) OrigErr() error { } func (s *InternalServerException) Error() string { - return fmt.Sprintf("%s: %s", s.Code(), s.Message()) + return fmt.Sprintf("%s: %s\n%s", s.Code(), s.Message(), s.String()) } // Status code returns the HTTP status code for the request's response error. @@ -3211,13 +3656,21 @@ func (s *InternalServerException) RequestID() string { type ListAnomaliesForInsightInput struct { _ struct{} `type:"structure"` + // The ID of the insight. The returned anomalies belong to this insight. + // // InsightId is a required field - InsightId *string `location:"uri" locationName:"InsightId" type:"string" required:"true"` + InsightId *string `location:"uri" locationName:"InsightId" min:"1" type:"string" required:"true"` + // The maximum number of results to return with a single call. To retrieve the + // remaining results, make another call with the returned nextToken value. MaxResults *int64 `min:"1" type:"integer"` + // 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. NextToken *string `min:"36" type:"string"` + // A time range used to specify when the requested anomalies started. All returned + // anomalies started during this time range. StartTimeRange *StartTimeRange `type:"structure"` } @@ -3280,10 +3733,15 @@ func (s *ListAnomaliesForInsightInput) SetStartTimeRange(v *StartTimeRange) *Lis type ListAnomaliesForInsightOutput struct { _ struct{} `type:"structure"` + // 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. NextToken *string `min:"36" type:"string"` + // An array of ProactiveAnomalySummary objects that represent the requested + // anomalies ProactiveAnomalies []*ProactiveAnomalySummary `type:"list"` + // An array of ReactiveAnomalySummary objects that represent the requested anomalies ReactiveAnomalies []*ReactiveAnomalySummary `type:"list"` } @@ -3315,19 +3773,30 @@ func (s *ListAnomaliesForInsightOutput) SetReactiveAnomalies(v []*ReactiveAnomal return s } +// Filters you can use to specify which events are returned when ListEvents +// is called. type ListEventsFilters struct { _ struct{} `type:"structure"` + // The source, AWS_CLOUD_TRAIL or AWS_CODE_DEPLOY, of the events you want returned. DataSource *string `type:"string" enum:"EventDataSource"` + // The class of the events you want to filter for, such as an infrastructure + // change, a deployment, or a schema change. EventClass *string `type:"string" enum:"EventClass"` + // The AWS source that emitted the events you want to filter for. EventSource *string `min:"10" type:"string"` + // A time range during which you want the filtered events to have occurred. EventTimeRange *EventTimeRange `type:"structure"` + // An ID of an insight that is related to the events you want to filter for. InsightId *string `min:"1" type:"string"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` } @@ -3401,11 +3870,17 @@ func (s *ListEventsFilters) SetResourceCollection(v *ResourceCollection) *ListEv type ListEventsInput struct { _ struct{} `type:"structure"` + // A ListEventsFilters object used to specify which events to return. + // // Filters is a required field Filters *ListEventsFilters `type:"structure" required:"true"` + // The maximum number of results to return with a single call. To retrieve the + // remaining results, make another call with the returned nextToken value. MaxResults *int64 `min:"1" type:"integer"` + // 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. NextToken *string `min:"36" type:"string"` } @@ -3464,8 +3939,13 @@ func (s *ListEventsInput) SetNextToken(v string) *ListEventsInput { type ListEventsOutput struct { _ struct{} `type:"structure"` - Events []*Event `type:"list"` + // A list of the requested events. + // + // Events is a required field + Events []*Event `type:"list" required:"true"` + // 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. NextToken *string `min:"36" type:"string"` } @@ -3491,12 +3971,17 @@ func (s *ListEventsOutput) SetNextToken(v string) *ListEventsOutput { return s } +// Used to filter for insights that have any status. type ListInsightsAnyStatusFilter struct { _ struct{} `type:"structure"` + // A time range used to specify when the behavior of the filtered insights started. + // // StartTimeRange is a required field StartTimeRange *StartTimeRange `type:"structure" required:"true"` + // Use to filter for either REACTIVE or PROACTIVE insights. + // // Type is a required field Type *string `type:"string" required:"true" enum:"InsightType"` } @@ -3539,12 +4024,17 @@ func (s *ListInsightsAnyStatusFilter) SetType(v string) *ListInsightsAnyStatusFi return s } +// Used to filter for insights that have the status CLOSED. type ListInsightsClosedStatusFilter struct { _ struct{} `type:"structure"` + // A time range used to specify when the behavior of the filtered insights ended. + // // EndTimeRange is a required field EndTimeRange *EndTimeRange `type:"structure" required:"true"` + // Use to filter for either REACTIVE or PROACTIVE insights. + // // Type is a required field Type *string `type:"string" required:"true" enum:"InsightType"` } @@ -3590,10 +4080,17 @@ func (s *ListInsightsClosedStatusFilter) SetType(v string) *ListInsightsClosedSt type ListInsightsInput struct { _ struct{} `type:"structure"` + // The maximum number of results to return with a single call. To retrieve the + // remaining results, make another call with the returned nextToken value. MaxResults *int64 `min:"1" type:"integer"` + // 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. NextToken *string `min:"36" type:"string"` + // A filter used to filter the returned insights by their status. You can specify + // one status filter. + // // StatusFilter is a required field StatusFilter *ListInsightsStatusFilter `type:"structure" required:"true"` } @@ -3650,9 +4147,12 @@ func (s *ListInsightsInput) SetStatusFilter(v *ListInsightsStatusFilter) *ListIn return s } +// Used to filter for insights that have the status ONGOING. type ListInsightsOngoingStatusFilter struct { _ struct{} `type:"structure"` + // Use to filter for either REACTIVE or PROACTIVE insights. + // // Type is a required field Type *string `type:"string" required:"true" enum:"InsightType"` } @@ -3689,10 +4189,14 @@ func (s *ListInsightsOngoingStatusFilter) SetType(v string) *ListInsightsOngoing type ListInsightsOutput struct { _ struct{} `type:"structure"` + // 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. NextToken *string `min:"36" type:"string"` + // The returned list of proactive insights. ProactiveInsights []*ProactiveInsightSummary `type:"list"` + // The returned list of reactive insights. ReactiveInsights []*ReactiveInsightSummary `type:"list"` } @@ -3724,13 +4228,20 @@ func (s *ListInsightsOutput) SetReactiveInsights(v []*ReactiveInsightSummary) *L return s } +// A filter used by ListInsights to specify which insights to return. type ListInsightsStatusFilter struct { _ struct{} `type:"structure"` + // A ListInsightsAnyStatusFilter that specifies insights of any status that + // are either REACTIVE or PROACTIVE. Any *ListInsightsAnyStatusFilter `type:"structure"` + // A ListInsightsClosedStatusFilter that specifies closed insights that are + // either REACTIVE or PROACTIVE. Closed *ListInsightsClosedStatusFilter `type:"structure"` + // A ListInsightsAnyStatusFilter that specifies ongoing insights that are either + // REACTIVE or PROACTIVE. Ongoing *ListInsightsOngoingStatusFilter `type:"structure"` } @@ -3790,6 +4301,8 @@ func (s *ListInsightsStatusFilter) SetOngoing(v *ListInsightsOngoingStatusFilter type ListNotificationChannelsInput struct { _ struct{} `type:"structure"` + // 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. NextToken *string `min:"36" type:"string"` } @@ -3825,8 +4338,11 @@ func (s *ListNotificationChannelsInput) SetNextToken(v string) *ListNotification type ListNotificationChannelsOutput struct { _ struct{} `type:"structure"` + // An array that contains the requested notification channels. Channels []*NotificationChannel `type:"list"` + // 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. NextToken *string `min:"36" type:"string"` } @@ -3855,9 +4371,13 @@ func (s *ListNotificationChannelsOutput) SetNextToken(v string) *ListNotificatio type ListRecommendationsInput struct { _ struct{} `type:"structure"` + // The ID of the requested insight. + // // InsightId is a required field InsightId *string `min:"1" type:"string" required:"true"` + // 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. NextToken *string `min:"36" type:"string"` } @@ -3905,8 +4425,11 @@ func (s *ListRecommendationsInput) SetNextToken(v string) *ListRecommendationsIn type ListRecommendationsOutput struct { _ struct{} `type:"structure"` + // 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. NextToken *string `min:"36" type:"string"` + // An array of the requested recommendations. Recommendations []*Recommendation `type:"list"` } @@ -3932,11 +4455,28 @@ func (s *ListRecommendationsOutput) SetRecommendations(v []*Recommendation) *Lis return s } +// Information about a notification channel. A notification channel is used +// to notify you when DevOps Guru creates an insight. The one supported notification +// channel is Amazon Simple Notification Service (Amazon SNS). +// +// If you use an Amazon SNS topic in another account, you must attach a policy +// to it that grants DevOps Guru permission to it notifications. DevOps Guru +// adds the required policy on your behalf to send notifications using Amazon +// SNS in your account. For more information, see Permissions for cross account +// 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). type NotificationChannel struct { _ struct{} `type:"structure"` + // A NotificationChannelConfig object that contains information about configured + // notification channels. Config *NotificationChannelConfig `type:"structure"` + // The ID of a notification channel. Id *string `min:"36" type:"string"` } @@ -3962,9 +4502,26 @@ func (s *NotificationChannel) SetId(v string) *NotificationChannel { return s } +// Information about notification channels you have configured with DevOps Guru. +// The one supported notification channel is Amazon Simple Notification Service +// (Amazon SNS). type NotificationChannelConfig struct { _ struct{} `type:"structure"` + // Information about a notification channel configured in DevOps Guru to send + // notifications when insights are created. + // + // If you use an Amazon SNS topic in another account, you must attach a policy + // to it that grants DevOps Guru permission to it notifications. DevOps Guru + // adds the required policy on your behalf to send notifications using Amazon + // SNS in your account. For more information, see Permissions for cross account + // 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). + // // Sns is a required field Sns *SnsChannelConfig `type:"structure" required:"true"` } @@ -4003,9 +4560,13 @@ func (s *NotificationChannelConfig) SetSns(v *SnsChannelConfig) *NotificationCha return s } +// Information about whether DevOps Guru is configured to create an OpsItem +// in AWS Systems Manager OpsCenter for each created insight. type OpsCenterIntegration struct { _ struct{} `type:"structure"` + // Specifies if DevOps Guru is enabled to create an AWS Systems Manager OpsItem + // for each created insight. OptInStatus *string `type:"string" enum:"OptInStatus"` } @@ -4025,9 +4586,13 @@ func (s *OpsCenterIntegration) SetOptInStatus(v string) *OpsCenterIntegration { return s } +// Information about whether DevOps Guru is configured to create an OpsItem +// in AWS Systems Manager OpsCenter for each created insight. type OpsCenterIntegrationConfig struct { _ struct{} `type:"structure"` + // Specifies if DevOps Guru is enabled to create an AWS Systems Manager OpsItem + // for each created insight. OptInStatus *string `type:"string" enum:"OptInStatus"` } @@ -4047,13 +4612,19 @@ func (s *OpsCenterIntegrationConfig) SetOptInStatus(v string) *OpsCenterIntegrat return s } +// The time range during which anomalous behavior in a proactive anomaly or +// an insight is expected to occur. type PredictionTimeRange struct { _ struct{} `type:"structure"` - EndTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // The time when the behavior in a proactive insight is expected to end. + EndTime *time.Time `type:"timestamp"` + // The time range during which a metric limit is expected to be exceeded. This + // applies to proactive insights only. + // // StartTime is a required field - StartTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp" required:"true"` + StartTime *time.Time `type:"timestamp" required:"true"` } // String returns the string representation @@ -4078,28 +4649,46 @@ func (s *PredictionTimeRange) SetStartTime(v time.Time) *PredictionTimeRange { return s } +// Information about an anomaly. This object is returned by ListAnomalies. type ProactiveAnomaly struct { _ struct{} `type:"structure"` + // A time range that specifies when the observed unusual behavior in an anomaly + // started and ended. AnomalyTimeRange *AnomalyTimeRange `type:"structure"` + // The ID of the insight that contains this anomaly. An insight is composed + // of related anomalies. AssociatedInsightId *string `min:"1" type:"string"` + // The ID of a proactive anomaly. Id *string `min:"1" type:"string"` + // A threshold that was exceeded by behavior in analyzed resources. Exceeding + // this threshold is related to the anomalous behavior that generated this anomaly. Limit *float64 `type:"double"` + // The time range during which anomalous behavior in a proactive anomaly or + // an insight is expected to occur. PredictionTimeRange *PredictionTimeRange `type:"structure"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` + // The severity of a proactive anomaly. Severity *string `type:"string" enum:"AnomalySeverity"` + // Details about the source of the analyzed operational data that triggered + // the anomaly. The one supported source is Amazon CloudWatch metrics. SourceDetails *AnomalySourceDetails `type:"structure"` + // The status of a proactive anomaly. Status *string `type:"string" enum:"AnomalyStatus"` - UpdateTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // The time of the anomaly's most recent update. + UpdateTime *time.Time `type:"timestamp"` } // String returns the string representation @@ -4172,28 +4761,46 @@ func (s *ProactiveAnomaly) SetUpdateTime(v time.Time) *ProactiveAnomaly { return s } +// Details about a proactive anomaly. This object is returned by DescribeAnomaly. type ProactiveAnomalySummary struct { _ struct{} `type:"structure"` + // A time range that specifies when the observed unusual behavior in an anomaly + // started and ended. AnomalyTimeRange *AnomalyTimeRange `type:"structure"` + // The ID of the insight that contains this anomaly. An insight is composed + // of related anomalies. AssociatedInsightId *string `min:"1" type:"string"` + // The ID of the anomaly. Id *string `min:"1" type:"string"` + // A threshold that was exceeded by behavior in analyzed resources. Exceeding + // this threshold is related to the anomalous behavior that generated this anomaly. Limit *float64 `type:"double"` + // The time range during which anomalous behavior in a proactive anomaly or + // an insight is expected to occur. PredictionTimeRange *PredictionTimeRange `type:"structure"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` + // The severity of the anomaly. Severity *string `type:"string" enum:"AnomalySeverity"` + // Details about the source of the analyzed operational data that triggered + // the anomaly. The one supported source is Amazon CloudWatch metrics. SourceDetails *AnomalySourceDetails `type:"structure"` + // The status of the anomaly. Status *string `type:"string" enum:"AnomalyStatus"` - UpdateTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // The time of the anomaly's most recent update. + UpdateTime *time.Time `type:"timestamp"` } // String returns the string representation @@ -4266,23 +4873,38 @@ func (s *ProactiveAnomalySummary) SetUpdateTime(v time.Time) *ProactiveAnomalySu return s } +// Details about a proactive insight. This object is returned by ListInsights. type ProactiveInsight struct { _ struct{} `type:"structure"` + // The ID of the proactive insight. Id *string `min:"1" type:"string"` + // A time ranged that specifies when the observed behavior in an insight started + // and ended. InsightTimeRange *InsightTimeRange `type:"structure"` + // The name of the proactive insight. Name *string `min:"1" type:"string"` + // The time range during which anomalous behavior in a proactive anomaly or + // an insight is expected to occur. PredictionTimeRange *PredictionTimeRange `type:"structure"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` + // The severity of the proactive insight. Severity *string `type:"string" enum:"InsightSeverity"` + // The ID of the AWS System Manager OpsItem created for this insight. You must + // enable the creation of OpstItems insights before they are created for each + // insight. SsmOpsItemId *string `min:"1" type:"string"` + // The status of the proactive insight. Status *string `type:"string" enum:"InsightStatus"` } @@ -4344,21 +4966,33 @@ func (s *ProactiveInsight) SetStatus(v string) *ProactiveInsight { return s } +// Details about a proactive insight. This object is returned by DescribeInsight. type ProactiveInsightSummary struct { _ struct{} `type:"structure"` + // The ID of the proactive insight. Id *string `min:"1" type:"string"` + // A time ranged that specifies when the observed behavior in an insight started + // and ended. InsightTimeRange *InsightTimeRange `type:"structure"` + // The name of the proactive insight. Name *string `min:"1" type:"string"` + // The time range during which anomalous behavior in a proactive anomaly or + // an insight is expected to occur. PredictionTimeRange *PredictionTimeRange `type:"structure"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` + // The severity of the proactive insight. Severity *string `type:"string" enum:"InsightSeverity"` + // The status of the proactive insight. Status *string `type:"string" enum:"InsightStatus"` } @@ -4417,6 +5051,7 @@ func (s *ProactiveInsightSummary) SetStatus(v string) *ProactiveInsightSummary { type PutFeedbackInput struct { _ struct{} `type:"structure"` + // The feedback from customers is about the recommendations in this insight. InsightFeedback *InsightFeedback `type:"structure"` } @@ -4465,21 +5100,34 @@ func (s PutFeedbackOutput) GoString() string { return s.String() } +// Details about a reactive anomaly. This object is returned by ListAnomalies. type ReactiveAnomaly struct { _ struct{} `type:"structure"` + // A time range that specifies when the observed unusual behavior in an anomaly + // started and ended. AnomalyTimeRange *AnomalyTimeRange `type:"structure"` + // The ID of the insight that contains this anomaly. An insight is composed + // of related anomalies. AssociatedInsightId *string `min:"1" type:"string"` + // The ID of the reactive anomaly. Id *string `min:"1" type:"string"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` + // The severity of the anomaly. Severity *string `type:"string" enum:"AnomalySeverity"` + // Details about the source of the analyzed operational data that triggered + // the anomaly. The one supported source is Amazon CloudWatch metrics. SourceDetails *AnomalySourceDetails `type:"structure"` + // The status of the anomaly. Status *string `type:"string" enum:"AnomalyStatus"` } @@ -4535,21 +5183,34 @@ func (s *ReactiveAnomaly) SetStatus(v string) *ReactiveAnomaly { return s } +// Details about a reactive anomaly. This object is returned by DescribeAnomaly. type ReactiveAnomalySummary struct { _ struct{} `type:"structure"` + // A time range that specifies when the observed unusual behavior in an anomaly + // started and ended. AnomalyTimeRange *AnomalyTimeRange `type:"structure"` + // The ID of the insight that contains this anomaly. An insight is composed + // of related anomalies. AssociatedInsightId *string `min:"1" type:"string"` + // The ID of the reactive anomaly. Id *string `min:"1" type:"string"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` + // The severity of the reactive anomaly. Severity *string `type:"string" enum:"AnomalySeverity"` + // Details about the source of the analyzed operational data that triggered + // the anomaly. The one supported source is Amazon CloudWatch metrics. SourceDetails *AnomalySourceDetails `type:"structure"` + // The status of the reactive anomaly. Status *string `type:"string" enum:"AnomalyStatus"` } @@ -4605,21 +5266,34 @@ func (s *ReactiveAnomalySummary) SetStatus(v string) *ReactiveAnomalySummary { return s } +// Information about a reactive insight. This object is returned by ListInsights. type ReactiveInsight struct { _ struct{} `type:"structure"` + // The ID of a reactive insight. Id *string `min:"1" type:"string"` + // A time ranged that specifies when the observed behavior in an insight started + // and ended. InsightTimeRange *InsightTimeRange `type:"structure"` + // The name of a reactive insight. Name *string `min:"1" type:"string"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` + // The severity of a reactive insight. Severity *string `type:"string" enum:"InsightSeverity"` + // The ID of the AWS System Manager OpsItem created for this insight. You must + // enable the creation of OpstItems insights before they are created for each + // insight. SsmOpsItemId *string `min:"1" type:"string"` + // The status of a reactive insight. Status *string `type:"string" enum:"InsightStatus"` } @@ -4675,19 +5349,29 @@ func (s *ReactiveInsight) SetStatus(v string) *ReactiveInsight { return s } +// Information about a reactive insight. This object is returned by DescribeInsight. type ReactiveInsightSummary struct { _ struct{} `type:"structure"` + // The ID of a reactive summary. Id *string `min:"1" type:"string"` + // A time ranged that specifies when the observed behavior in an insight started + // and ended. InsightTimeRange *InsightTimeRange `type:"structure"` + // The name of a reactive insight. Name *string `min:"1" type:"string"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` + // The severity of a reactive insight. Severity *string `type:"string" enum:"InsightSeverity"` + // The status of a reactive insight. Status *string `type:"string" enum:"InsightStatus"` } @@ -4737,19 +5421,29 @@ func (s *ReactiveInsightSummary) SetStatus(v string) *ReactiveInsightSummary { return s } +// Recommendation information to help you remediate detected anomalous behavior +// that generated an insight. type Recommendation struct { _ struct{} `type:"structure"` + // A description of the problem. Description *string `type:"string"` + // A hyperlink to information to help you address the problem. Link *string `type:"string"` + // The name of the recommendation. Name *string `type:"string"` + // The reason DevOps Guru flagged the anomalous behavior as a problem. Reason *string `type:"string"` + // Anomalies that are related to the problem. Use these Anomalies to learn more + // about what's happening and to help address the issue. RelatedAnomalies []*RecommendationRelatedAnomaly `type:"list"` + // Events that are related to the problem. Use these events to learn more about + // what's happening and to help address the issue. RelatedEvents []*RecommendationRelatedEvent `type:"list"` } @@ -4799,11 +5493,16 @@ func (s *Recommendation) SetRelatedEvents(v []*RecommendationRelatedEvent) *Reco return s } +// Information about an anomaly that is related to a recommendation. type RecommendationRelatedAnomaly struct { _ struct{} `type:"structure"` + // An array of objects that represent resources in which DevOps Guru detected + // anomalous behavior. Each object contains the name and type of the resource. Resources []*RecommendationRelatedAnomalyResource `type:"list"` + // Information about where the anomalous behavior related the recommendation + // was found. For example, details in Amazon CloudWatch metrics. SourceDetails []*RecommendationRelatedAnomalySourceDetail `type:"list"` } @@ -4829,11 +5528,14 @@ func (s *RecommendationRelatedAnomaly) SetSourceDetails(v []*RecommendationRelat return s } +// Information about a resource in which DevOps Guru detected anomalous behavior. type RecommendationRelatedAnomalyResource struct { _ struct{} `type:"structure"` + // The name of the resource. Name *string `type:"string"` + // The type of the resource. Type *string `type:"string"` } @@ -4859,9 +5561,13 @@ func (s *RecommendationRelatedAnomalyResource) SetType(v string) *Recommendation return s } +// Contains an array of RecommendationRelatedCloudWatchMetricsSourceDetail objects +// that contain the name and namespace of an Amazon CloudWatch metric. type RecommendationRelatedAnomalySourceDetail struct { _ struct{} `type:"structure"` + // An array of CloudWatchMetricsDetail objects that contains information about + // the analyzed metrics that displayed anomalous behavior. CloudWatchMetrics []*RecommendationRelatedCloudWatchMetricsSourceDetail `type:"list"` } @@ -4881,11 +5587,16 @@ func (s *RecommendationRelatedAnomalySourceDetail) SetCloudWatchMetrics(v []*Rec return s } +// Information about an Amazon CloudWatch metric that is analyzed by DevOps +// Guru. It is one of many analyzed metrics that are used to generate insights. type RecommendationRelatedCloudWatchMetricsSourceDetail struct { _ struct{} `type:"structure"` + // The name of the CloudWatch metric. MetricName *string `type:"string"` + // The namespace of the CloudWatch metric. A namespace is a container for CloudWatch + // metrics. Namespace *string `type:"string"` } @@ -4911,11 +5622,15 @@ func (s *RecommendationRelatedCloudWatchMetricsSourceDetail) SetNamespace(v stri return s } +// Information about an event that is related to a recommendation. type RecommendationRelatedEvent struct { _ struct{} `type:"structure"` + // The name of the event. This corresponds to the Name field in an Event object. Name *string `type:"string"` + // A ResourceCollection object that contains arrays of the names of AWS CloudFormation + // stacks. Resources []*RecommendationRelatedEventResource `type:"list"` } @@ -4941,11 +5656,17 @@ func (s *RecommendationRelatedEvent) SetResources(v []*RecommendationRelatedEven return s } +// Information about an AWS resource that emitted and event that is related +// to a recommendation in an insight. type RecommendationRelatedEventResource struct { _ struct{} `type:"structure"` + // The name of the resource that emitted the event. This corresponds to the + // Name field in an EventResource object. Name *string `type:"string"` + // The type of the resource that emitted the event. This corresponds to the + // Type field in an EventResource object. Type *string `type:"string"` } @@ -4974,8 +5695,10 @@ func (s *RecommendationRelatedEventResource) SetType(v string) *RecommendationRe type RemoveNotificationChannelInput struct { _ struct{} `type:"structure"` + // The ID of the notification channel to be removed. + // // Id is a required field - Id *string `location:"uri" locationName:"Id" type:"string" required:"true"` + Id *string `location:"uri" locationName:"Id" min:"36" type:"string" required:"true"` } // String returns the string representation @@ -4994,8 +5717,8 @@ func (s *RemoveNotificationChannelInput) Validate() error { if s.Id == nil { invalidParams.Add(request.NewErrParamRequired("Id")) } - if s.Id != nil && len(*s.Id) < 1 { - invalidParams.Add(request.NewErrParamMinLen("Id", 1)) + if s.Id != nil && len(*s.Id) < 36 { + invalidParams.Add(request.NewErrParamMinLen("Id", 36)) } if invalidParams.Len() > 0 { @@ -5024,9 +5747,14 @@ func (s RemoveNotificationChannelOutput) GoString() string { return s.String() } +// A collection of AWS resources supported by DevOps Guru. The one type of AWS +// resource collection supported is AWS CloudFormation stacks. DevOps Guru can +// be configured to analyze only the AWS resources that are defined in the stacks. type ResourceCollection struct { _ struct{} `type:"structure"` + // An array of the names of AWS CloudFormation stacks. The stacks define AWS + // resources that DevOps Guru analyzes. CloudFormation *CloudFormationCollection `type:"structure"` } @@ -5046,9 +5774,15 @@ func (s *ResourceCollection) SetCloudFormation(v *CloudFormationCollection) *Res return s } +// Information about a filter used to specify which AWS resources are analyzed +// for anomalous behavior by DevOps Guru. type ResourceCollectionFilter struct { _ struct{} `type:"structure"` + // Information about AWS CloudFormation stacks. You can use stacks to specify + // which AWS resources in your account to analyze. For more information, see + // Stacks (https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html) + // in the AWS CloudFormation User Guide. CloudFormation *CloudFormationCollectionFilter `type:"structure"` } @@ -5068,15 +5802,20 @@ func (s *ResourceCollectionFilter) SetCloudFormation(v *CloudFormationCollection return s } +// A requested resource could not be found type ResourceNotFoundException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` Message_ *string `locationName:"Message" type:"string"` + // The ID of the AWS resource that could not be found. + // // ResourceId is a required field ResourceId *string `type:"string" required:"true"` + // The type of the AWS resource that could not be found. + // // ResourceType is a required field ResourceType *string `type:"string" required:"true"` } @@ -5129,13 +5868,20 @@ func (s *ResourceNotFoundException) RequestID() string { return s.RespMetadata.RequestID } +// Specifies one or more severity values and one or more status values that +// are used to search for insights. type SearchInsightsFilters struct { _ struct{} `type:"structure"` + // A collection of AWS resources supported by DevOps Guru. The one type of AWS + // resource collection supported is AWS CloudFormation stacks. DevOps Guru can + // be configured to analyze only the AWS resources that are defined in the stacks. ResourceCollection *ResourceCollection `type:"structure"` + // An array of severity values used to search for insights. Severities []*string `type:"list"` + // An array of status values used to search for insights. Statuses []*string `type:"list"` } @@ -5170,15 +5916,26 @@ func (s *SearchInsightsFilters) SetStatuses(v []*string) *SearchInsightsFilters type SearchInsightsInput struct { _ struct{} `type:"structure"` + // A SearchInsightsFilters object that is used to set the severity and status + // filters on your insight search. Filters *SearchInsightsFilters `type:"structure"` + // The maximum number of results to return with a single call. To retrieve the + // remaining results, make another call with the returned nextToken value. MaxResults *int64 `min:"1" type:"integer"` + // 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. NextToken *string `min:"36" type:"string"` + // The start of the time range passed in. Returned insights occurred after this + // time. + // // StartTimeRange is a required field StartTimeRange *StartTimeRange `type:"structure" required:"true"` + // The type of insights you are searching for (REACTIVE or PROACTIVE). + // // Type is a required field Type *string `type:"string" required:"true" enum:"InsightType"` } @@ -5248,10 +6005,14 @@ func (s *SearchInsightsInput) SetType(v string) *SearchInsightsInput { type SearchInsightsOutput struct { _ struct{} `type:"structure"` + // 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. NextToken *string `min:"36" type:"string"` + // The returned proactive insights. ProactiveInsights []*ProactiveInsightSummary `type:"list"` + // The returned reactive insights. ReactiveInsights []*ReactiveInsightSummary `type:"list"` } @@ -5283,9 +6044,13 @@ func (s *SearchInsightsOutput) SetReactiveInsights(v []*ReactiveInsightSummary) return s } +// Information about the integration of DevOps Guru with another AWS service, +// such as AWS Systems Manager. type ServiceIntegrationConfig struct { _ struct{} `type:"structure"` + // Information about whether DevOps Guru is configured to create an OpsItem + // in AWS Systems Manager OpsCenter for each created insight. OpsCenter *OpsCenterIntegration `type:"structure"` } @@ -5305,6 +6070,7 @@ func (s *ServiceIntegrationConfig) SetOpsCenter(v *OpsCenterIntegration) *Servic return s } +// The request contains a value that exceeds a maximum quota. type ServiceQuotaExceededException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -5360,9 +6126,23 @@ func (s *ServiceQuotaExceededException) RequestID() string { return s.RespMetadata.RequestID } +// Contains the Amazon Resource Name (ARN) of an Amazon Simple Notification +// Service topic. +// +// If you use an Amazon SNS topic in another account, you must attach a policy +// to it that grants DevOps Guru permission to it notifications. DevOps Guru +// adds the required policy on your behalf to send notifications using Amazon +// SNS in your account. For more information, see Permissions for cross account +// 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). type SnsChannelConfig struct { _ struct{} `type:"structure"` + // The Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic. TopicArn *string `min:"36" type:"string"` } @@ -5395,12 +6175,15 @@ func (s *SnsChannelConfig) SetTopicArn(v string) *SnsChannelConfig { return s } +// A time range used to specify when the behavior of an insight or anomaly started. type StartTimeRange struct { _ struct{} `type:"structure"` - FromTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // The start time of the time range. + FromTime *time.Time `type:"timestamp"` - ToTime *time.Time `type:"timestamp" timestampFormat:"unixTimestamp"` + // The end time of the time range. + ToTime *time.Time `type:"timestamp"` } // String returns the string representation @@ -5425,14 +6208,21 @@ func (s *StartTimeRange) SetToTime(v time.Time) *StartTimeRange { return s } +// The request was denied due to a request throttling. type ThrottlingException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` Message_ *string `locationName:"Message" type:"string"` + // The code of the quota that was exceeded, causing the throttling exception. QuotaCode *string `type:"string"` + // The number of seconds after which the action that caused the throttling exception + // can be retried. + RetryAfterSeconds *int64 `location:"header" locationName:"Retry-After" type:"integer"` + + // The code of the service that caused the throttling exception. ServiceCode *string `type:"string"` } @@ -5484,9 +6274,12 @@ func (s *ThrottlingException) RequestID() string { return s.RespMetadata.RequestID } +// Contains the names of AWS CloudFormation stacks used to update a collection +// of stacks. type UpdateCloudFormationCollectionFilter struct { _ struct{} `type:"structure"` + // An array of the name of stacks to update. StackNames []*string `type:"list"` } @@ -5506,9 +6299,11 @@ func (s *UpdateCloudFormationCollectionFilter) SetStackNames(v []*string) *Updat return s } +// Contains information used to update a collection of AWS resources. type UpdateResourceCollectionFilter struct { _ struct{} `type:"structure"` + // An collection of AWS CloudFormation stacks. CloudFormation *UpdateCloudFormationCollectionFilter `type:"structure"` } @@ -5531,9 +6326,14 @@ func (s *UpdateResourceCollectionFilter) SetCloudFormation(v *UpdateCloudFormati type UpdateResourceCollectionInput struct { _ struct{} `type:"structure"` + // Specifies if the resource collection in the request is added or deleted to + // the resource collection. + // // Action is a required field Action *string `type:"string" required:"true" enum:"UpdateResourceCollectionAction"` + // Contains information used to update a collection of AWS resources. + // // ResourceCollection is a required field ResourceCollection *UpdateResourceCollectionFilter `type:"structure" required:"true"` } @@ -5590,9 +6390,13 @@ func (s UpdateResourceCollectionOutput) GoString() string { return s.String() } +// Information about updating the integration status of an AWS service, such +// as AWS Systems Manager, with DevOps Guru. type UpdateServiceIntegrationConfig struct { _ struct{} `type:"structure"` + // Information about whether DevOps Guru is configured to create an OpsItem + // in AWS Systems Manager OpsCenter for each created insight. OpsCenter *OpsCenterIntegrationConfig `type:"structure"` } @@ -5615,6 +6419,9 @@ func (s *UpdateServiceIntegrationConfig) SetOpsCenter(v *OpsCenterIntegrationCon type UpdateServiceIntegrationInput struct { _ struct{} `type:"structure"` + // An IntegratedServiceConfig object used to specify the integrated service + // you want to update, and whether you want to update it to enabled or disabled. + // // ServiceIntegration is a required field ServiceIntegration *UpdateServiceIntegrationConfig `type:"structure" required:"true"` } @@ -5662,14 +6469,19 @@ func (s UpdateServiceIntegrationOutput) GoString() string { return s.String() } +// Contains information about data passed in to a field during a request that +// is not valid. type ValidationException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` + // An array of fields that are associated with the validation exception. Fields []*ValidationExceptionField `type:"list"` + // A message that describes the validation exception. Message_ *string `locationName:"Message" type:"string"` + // The reason the validation exception was thrown. Reason *string `type:"string" enum:"ValidationExceptionReason"` } @@ -5721,12 +6533,18 @@ func (s *ValidationException) RequestID() string { return s.RespMetadata.RequestID } +// The field associated with the validation exception. type ValidationExceptionField struct { _ struct{} `type:"structure"` + // The message associated with the validation exception with information to + // help determine its cause. + // // Message is a required field Message *string `type:"string" required:"true"` + // The name of the field. + // // Name is a required field Name *string `type:"string" required:"true"` } @@ -5953,6 +6771,8 @@ func InsightType_Values() []string { } } +// Specifies if DevOps Guru is enabled to create an AWS Systems Manager OpsItem +// for each created insight. const ( // OptInStatusEnabled is a OptInStatus enum value OptInStatusEnabled = "ENABLED" @@ -5969,6 +6789,18 @@ func OptInStatus_Values() []string { } } +const ( + // ResourceCollectionTypeAwsCloudFormation is a ResourceCollectionType enum value + ResourceCollectionTypeAwsCloudFormation = "AWS_CLOUD_FORMATION" +) + +// ResourceCollectionType_Values returns all elements of the ResourceCollectionType enum +func ResourceCollectionType_Values() []string { + return []string{ + ResourceCollectionTypeAwsCloudFormation, + } +} + const ( // UpdateResourceCollectionActionAdd is a UpdateResourceCollectionAction enum value UpdateResourceCollectionActionAdd = "ADD" diff --git a/service/devopsguru/doc.go b/service/devopsguru/doc.go index 1134e8c74c..12d2347c0f 100644 --- a/service/devopsguru/doc.go +++ b/service/devopsguru/doc.go @@ -3,6 +3,23 @@ // Package devopsguru provides the client and types for making API // requests to Amazon DevOps Guru. // +// Amazon DevOps Guru is a fully managed service that helps you identify anomalous +// behavior in business critical operational applications. You specify the AWS +// resources that you want DevOps Guru to cover, then the Amazon CloudWatch +// metrics and AWS CloudTrail events related to those resources are analyzed. +// When anomalous behavior is detected, DevOps Guru creates an insight that +// includes recommendations, related events, and related metrics that can help +// you improve your operational applications. For more information, see What +// is Amazon DevOps Guru (https://docs.aws.amazon.com/devops-guru/latest/userguide/welcome.html). +// +// You can specify 1 or 2 Amazon Simple Notification Service topics so you are +// notified every time a new insight is created. You can also enable DevOps +// Guru to generate an OpsItem in AWS Systems Manager for each insight to help +// you manage and track your work addressing insights. +// +// To learn about the DevOps Guru workflow, see How DevOps Guru works (https://docs.aws.amazon.com/devops-guru/latest/userguide/welcome.html#how-it-works). +// To learn about DevOps Guru concepts, see Concepts in DevOps Guru (https://docs.aws.amazon.com/devops-guru/latest/userguide/concepts.html). +// // See https://docs.aws.amazon.com/goto/WebAPI/devops-guru-2020-12-01 for more information on this service. // // See devopsguru package documentation for more information. diff --git a/service/devopsguru/errors.go b/service/devopsguru/errors.go index dff0281af1..6a7d9e78f1 100644 --- a/service/devopsguru/errors.go +++ b/service/devopsguru/errors.go @@ -10,30 +10,49 @@ const ( // ErrCodeAccessDeniedException for service response error code // "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. ErrCodeAccessDeniedException = "AccessDeniedException" // ErrCodeConflictException for service response error code // "ConflictException". + // + // An exception that is thrown when a conflict occurs. ErrCodeConflictException = "ConflictException" // ErrCodeInternalServerException for service response error code // "InternalServerException". + // + // An internal failure in an Amazon service occurred. ErrCodeInternalServerException = "InternalServerException" // ErrCodeResourceNotFoundException for service response error code // "ResourceNotFoundException". + // + // A requested resource could not be found ErrCodeResourceNotFoundException = "ResourceNotFoundException" // ErrCodeServiceQuotaExceededException for service response error code // "ServiceQuotaExceededException". + // + // The request contains a value that exceeds a maximum quota. ErrCodeServiceQuotaExceededException = "ServiceQuotaExceededException" // ErrCodeThrottlingException for service response error code // "ThrottlingException". + // + // The request was denied due to a request throttling. ErrCodeThrottlingException = "ThrottlingException" // ErrCodeValidationException for service response error code // "ValidationException". + // + // Contains information about data passed in to a field during a request that + // is not valid. ErrCodeValidationException = "ValidationException" ) diff --git a/service/ec2/api.go b/service/ec2/api.go index a8eca361a1..a3bff97b6e 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -123655,6 +123655,9 @@ const ( // InstanceTypeC5n18xlarge is a InstanceType enum value InstanceTypeC5n18xlarge = "c5n.18xlarge" + // InstanceTypeC5nMetal is a InstanceType enum value + InstanceTypeC5nMetal = "c5n.metal" + // InstanceTypeC6gMetal is a InstanceType enum value InstanceTypeC6gMetal = "c6g.metal" @@ -124399,6 +124402,7 @@ func InstanceType_Values() []string { InstanceTypeC5n4xlarge, InstanceTypeC5n9xlarge, InstanceTypeC5n18xlarge, + InstanceTypeC5nMetal, InstanceTypeC6gMetal, InstanceTypeC6gMedium, InstanceTypeC6gLarge, diff --git a/service/globalaccelerator/api.go b/service/globalaccelerator/api.go index 0172aa58f3..0faae6957f 100644 --- a/service/globalaccelerator/api.go +++ b/service/globalaccelerator/api.go @@ -2522,6 +2522,12 @@ func (c *GlobalAccelerator) ListByoipCidrsRequest(input *ListByoipCidrsInput) (r Name: opListByoipCidrs, HTTPMethod: "POST", HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, } if input == nil { @@ -2581,6 +2587,58 @@ func (c *GlobalAccelerator) ListByoipCidrsWithContext(ctx aws.Context, input *Li return out, req.Send() } +// ListByoipCidrsPages iterates over the pages of a ListByoipCidrs operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListByoipCidrs method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListByoipCidrs operation. +// pageNum := 0 +// err := client.ListByoipCidrsPages(params, +// func(page *globalaccelerator.ListByoipCidrsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *GlobalAccelerator) ListByoipCidrsPages(input *ListByoipCidrsInput, fn func(*ListByoipCidrsOutput, bool) bool) error { + return c.ListByoipCidrsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListByoipCidrsPagesWithContext same as ListByoipCidrsPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *GlobalAccelerator) ListByoipCidrsPagesWithContext(ctx aws.Context, input *ListByoipCidrsInput, fn func(*ListByoipCidrsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListByoipCidrsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListByoipCidrsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + for p.Next() { + if !fn(p.Page().(*ListByoipCidrsOutput), !p.HasNextPage()) { + break + } + } + + return p.Err() +} + const opListCustomRoutingAccelerators = "ListCustomRoutingAccelerators" // ListCustomRoutingAcceleratorsRequest generates a "aws/request.Request" representing the diff --git a/service/globalaccelerator/globalacceleratoriface/interface.go b/service/globalaccelerator/globalacceleratoriface/interface.go index e7b45ccbee..4efa4f3fe4 100644 --- a/service/globalaccelerator/globalacceleratoriface/interface.go +++ b/service/globalaccelerator/globalacceleratoriface/interface.go @@ -171,6 +171,9 @@ type GlobalAcceleratorAPI interface { ListByoipCidrsWithContext(aws.Context, *globalaccelerator.ListByoipCidrsInput, ...request.Option) (*globalaccelerator.ListByoipCidrsOutput, error) ListByoipCidrsRequest(*globalaccelerator.ListByoipCidrsInput) (*request.Request, *globalaccelerator.ListByoipCidrsOutput) + ListByoipCidrsPages(*globalaccelerator.ListByoipCidrsInput, func(*globalaccelerator.ListByoipCidrsOutput, bool) bool) error + ListByoipCidrsPagesWithContext(aws.Context, *globalaccelerator.ListByoipCidrsInput, func(*globalaccelerator.ListByoipCidrsOutput, bool) bool, ...request.Option) error + ListCustomRoutingAccelerators(*globalaccelerator.ListCustomRoutingAcceleratorsInput) (*globalaccelerator.ListCustomRoutingAcceleratorsOutput, error) ListCustomRoutingAcceleratorsWithContext(aws.Context, *globalaccelerator.ListCustomRoutingAcceleratorsInput, ...request.Option) (*globalaccelerator.ListCustomRoutingAcceleratorsOutput, error) ListCustomRoutingAcceleratorsRequest(*globalaccelerator.ListCustomRoutingAcceleratorsInput) (*request.Request, *globalaccelerator.ListCustomRoutingAcceleratorsOutput)