diff --git a/.changes/2.810.0.json b/.changes/2.810.0.json new file mode 100644 index 0000000000..ade31652fc --- /dev/null +++ b/.changes/2.810.0.json @@ -0,0 +1,17 @@ +[ + { + "type": "feature", + "category": "DevOpsGuru", + "description": "Documentation updates for DevOps Guru." + }, + { + "type": "feature", + "category": "EC2", + "description": "Add c5n.metal to ec2 instance types list" + }, + { + "type": "feature", + "category": "GlobalAccelerator", + "description": "This release adds support for custom routing accelerators" + } +] \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index d45e9ecc72..479b6818e6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,7 +1,12 @@ # Changelog for AWS SDK for JavaScript - + +## 2.810.0 +* feature: DevOpsGuru: Documentation updates for DevOps Guru. +* feature: EC2: Add c5n.metal to ec2 instance types list +* feature: GlobalAccelerator: This release adds support for custom routing accelerators + ## 2.809.0 * feature: AutoScaling: Documentation updates and corrections for Amazon EC2 Auto Scaling API Reference and SDKs. * feature: CloudTrail: CloudTrailInvalidClientTokenIdException is now thrown when a call results in the InvalidClientTokenId error code. The Name parameter of the AdvancedEventSelector data type is now optional. diff --git a/README.md b/README.md index 67abe74a1c..2d8c7184b3 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ version. To use the SDK in the browser, simply add the following script tag to your HTML pages: - + You can also build a custom browser SDK with your specified set of AWS services. This can allow you to reduce the SDK's size, specify different API versions of diff --git a/apis/devops-guru-2020-12-01.examples.json b/apis/devops-guru-2020-12-01.examples.json new file mode 100644 index 0000000000..0ea7e3b0bb --- /dev/null +++ b/apis/devops-guru-2020-12-01.examples.json @@ -0,0 +1,5 @@ +{ + "version": "1.0", + "examples": { + } +} diff --git a/apis/devops-guru-2020-12-01.min.json b/apis/devops-guru-2020-12-01.min.json index 57f5fc1e18..94f2a292c5 100644 --- a/apis/devops-guru-2020-12-01.min.json +++ b/apis/devops-guru-2020-12-01.min.json @@ -1,14 +1,15 @@ { + "version": "2.0", "metadata": { "apiVersion": "2020-12-01", "endpointPrefix": "devops-guru", - "signingName": "devops-guru", + "jsonVersion": "1.1", + "protocol": "rest-json", "serviceFullName": "Amazon DevOps Guru", "serviceId": "DevOps Guru", - "protocol": "rest-json", - "jsonVersion": "1.1", - "uid": "devops-guru-2020-12-01", - "signatureVersion": "v4" + "signatureVersion": "v4", + "signingName": "devops-guru", + "uid": "devops-guru-2020-12-01" }, "operations": { "AddNotificationChannel": { @@ -19,17 +20,20 @@ }, "input": { "type": "structure", + "required": [ + "Config" + ], "members": { "Config": { "shape": "S2" } - }, - "required": [ - "Config" - ] + } }, "output": { "type": "structure", + "required": [ + "Id" + ], "members": { "Id": {} } @@ -47,14 +51,19 @@ }, "output": { "type": "structure", + "required": [ + "OpenReactiveInsights", + "OpenProactiveInsights", + "MetricsAnalyzed" + ], "members": { - "MetricsAnalyzed": { + "OpenReactiveInsights": { "type": "integer" }, "OpenProactiveInsights": { "type": "integer" }, - "OpenReactiveInsights": { + "MetricsAnalyzed": { "type": "integer" } } @@ -67,29 +76,34 @@ }, "input": { "type": "structure", + "required": [ + "FromTime" + ], "members": { "FromTime": { - "shape": "Sb" + "type": "timestamp" }, "ToTime": { - "shape": "Sb" + "type": "timestamp" } - }, - "required": [ - "FromTime" - ] + } }, "output": { "type": "structure", + "required": [ + "ReactiveInsights", + "ProactiveInsights", + "MeanTimeToRecoverInMilliseconds" + ], "members": { - "MeanTimeToRecoverInMilliseconds": { - "type": "long" + "ReactiveInsights": { + "type": "integer" }, "ProactiveInsights": { "type": "integer" }, - "ReactiveInsights": { - "type": "integer" + "MeanTimeToRecoverInMilliseconds": { + "type": "long" } } } @@ -102,15 +116,15 @@ }, "input": { "type": "structure", + "required": [ + "Id" + ], "members": { "Id": { "location": "uri", "locationName": "Id" } - }, - "required": [ - "Id" - ] + } }, "output": { "type": "structure", @@ -118,46 +132,46 @@ "ProactiveAnomaly": { "type": "structure", "members": { - "AnomalyTimeRange": { - "shape": "Si" - }, - "AssociatedInsightId": {}, "Id": {}, - "Limit": { - "type": "double" + "Severity": {}, + "Status": {}, + "UpdateTime": { + "type": "timestamp" }, - "PredictionTimeRange": { - "shape": "Sl" + "AnomalyTimeRange": { + "shape": "So" }, - "ResourceCollection": { - "shape": "Sm" + "PredictionTimeRange": { + "shape": "Sp" }, - "Severity": {}, "SourceDetails": { - "shape": "Sr" + "shape": "Sq" }, - "Status": {}, - "UpdateTime": { - "shape": "Sb" + "AssociatedInsightId": {}, + "ResourceCollection": { + "shape": "S13" + }, + "Limit": { + "type": "double" } } }, "ReactiveAnomaly": { "type": "structure", "members": { - "AnomalyTimeRange": { - "shape": "Si" - }, - "AssociatedInsightId": {}, "Id": {}, - "ResourceCollection": { - "shape": "Sm" - }, "Severity": {}, + "Status": {}, + "AnomalyTimeRange": { + "shape": "So" + }, "SourceDetails": { - "shape": "Sr" + "shape": "Sq" }, - "Status": {} + "AssociatedInsightId": {}, + "ResourceCollection": { + "shape": "S13" + } } } } @@ -171,15 +185,15 @@ }, "input": { "type": "structure", + "required": [ + "Id" + ], "members": { "Id": { "location": "uri", "locationName": "Id" } - }, - "required": [ - "Id" - ] + } }, "output": { "type": "structure", @@ -188,35 +202,35 @@ "type": "structure", "members": { "Id": {}, + "Name": {}, + "Severity": {}, + "Status": {}, "InsightTimeRange": { - "shape": "S12" + "shape": "S1f" }, - "Name": {}, "PredictionTimeRange": { - "shape": "Sl" + "shape": "Sp" }, "ResourceCollection": { - "shape": "Sm" + "shape": "S13" }, - "Severity": {}, - "SsmOpsItemId": {}, - "Status": {} + "SsmOpsItemId": {} } }, "ReactiveInsight": { "type": "structure", "members": { "Id": {}, + "Name": {}, + "Severity": {}, + "Status": {}, "InsightTimeRange": { - "shape": "S12" + "shape": "S1f" }, - "Name": {}, "ResourceCollection": { - "shape": "Sm" + "shape": "S13" }, - "Severity": {}, - "SsmOpsItemId": {}, - "Status": {} + "SsmOpsItemId": {} } } } @@ -230,43 +244,46 @@ }, "input": { "type": "structure", + "required": [ + "ResourceCollectionType" + ], "members": { - "NextToken": { - "location": "querystring", - "locationName": "NextToken" - }, "ResourceCollectionType": { "location": "uri", "locationName": "ResourceCollectionType" + }, + "NextToken": { + "location": "querystring", + "locationName": "NextToken" } - }, - "required": [ - "ResourceCollectionType" - ] + } }, "output": { "type": "structure", + "required": [ + "CloudFormation" + ], "members": { "CloudFormation": { "type": "list", "member": { "type": "structure", "members": { + "StackName": {}, "Insight": { "type": "structure", "members": { - "MeanTimeToRecoverInMilliseconds": { - "type": "long" - }, "OpenProactiveInsights": { "type": "integer" }, "OpenReactiveInsights": { "type": "integer" + }, + "MeanTimeToRecoverInMilliseconds": { + "type": "long" } } - }, - "StackName": {} + } } } }, @@ -309,24 +326,23 @@ }, "input": { "type": "structure", + "required": [ + "ResourceCollectionType" + ], "members": { - "NextToken": { - "location": "querystring", - "locationName": "NextToken" - }, "ResourceCollectionType": { "location": "uri", "locationName": "ResourceCollectionType" + }, + "NextToken": { + "location": "querystring", + "locationName": "NextToken" } - }, - "required": [ - "ResourceCollectionType" - ] + } }, "output": { "type": "structure", "members": { - "NextToken": {}, "ResourceCollection": { "type": "structure", "members": { @@ -334,12 +350,13 @@ "type": "structure", "members": { "StackNames": { - "shape": "So" + "shape": "S15" } } } } - } + }, + "NextToken": {} } } }, @@ -350,53 +367,52 @@ }, "input": { "type": "structure", + "required": [ + "InsightId" + ], "members": { "InsightId": { "location": "uri", "locationName": "InsightId" }, + "StartTimeRange": { + "shape": "S1z" + }, "MaxResults": { "type": "integer" }, - "NextToken": {}, - "StartTimeRange": { - "shape": "S1o" - } - }, - "required": [ - "InsightId" - ] + "NextToken": {} + } }, "output": { "type": "structure", "members": { - "NextToken": {}, "ProactiveAnomalies": { "type": "list", "member": { "type": "structure", "members": { - "AnomalyTimeRange": { - "shape": "Si" - }, - "AssociatedInsightId": {}, "Id": {}, - "Limit": { - "type": "double" + "Severity": {}, + "Status": {}, + "UpdateTime": { + "type": "timestamp" }, - "PredictionTimeRange": { - "shape": "Sl" + "AnomalyTimeRange": { + "shape": "So" }, - "ResourceCollection": { - "shape": "Sm" + "PredictionTimeRange": { + "shape": "Sp" }, - "Severity": {}, "SourceDetails": { - "shape": "Sr" + "shape": "Sq" }, - "Status": {}, - "UpdateTime": { - "shape": "Sb" + "AssociatedInsightId": {}, + "ResourceCollection": { + "shape": "S13" + }, + "Limit": { + "type": "double" } } } @@ -406,22 +422,23 @@ "member": { "type": "structure", "members": { - "AnomalyTimeRange": { - "shape": "Si" - }, - "AssociatedInsightId": {}, "Id": {}, - "ResourceCollection": { - "shape": "Sm" - }, "Severity": {}, + "Status": {}, + "AnomalyTimeRange": { + "shape": "So" + }, "SourceDetails": { - "shape": "Sr" + "shape": "Sq" }, - "Status": {} + "AssociatedInsightId": {}, + "ResourceCollection": { + "shape": "S13" + } } } - } + }, + "NextToken": {} } } }, @@ -432,31 +449,34 @@ }, "input": { "type": "structure", + "required": [ + "Filters" + ], "members": { "Filters": { "type": "structure", "members": { - "DataSource": {}, - "EventClass": {}, - "EventSource": {}, + "InsightId": {}, "EventTimeRange": { "type": "structure", + "required": [ + "FromTime", + "ToTime" + ], "members": { "FromTime": { - "shape": "Sb" + "type": "timestamp" }, "ToTime": { - "shape": "Sb" + "type": "timestamp" } - }, - "required": [ - "ToTime", - "FromTime" - ] + } }, - "InsightId": {}, + "EventClass": {}, + "EventSource": {}, + "DataSource": {}, "ResourceCollection": { - "shape": "Sm" + "shape": "S13" } } }, @@ -464,40 +484,40 @@ "type": "integer" }, "NextToken": {} - }, - "required": [ - "Filters" - ] + } }, "output": { "type": "structure", + "required": [ + "Events" + ], "members": { "Events": { "type": "list", "member": { "type": "structure", "members": { - "DataSource": {}, - "EventClass": {}, - "EventSource": {}, - "Id": {}, - "Name": {}, "ResourceCollection": { - "shape": "Sm" + "shape": "S13" }, + "Id": {}, + "Time": { + "type": "timestamp" + }, + "EventSource": {}, + "Name": {}, + "DataSource": {}, + "EventClass": {}, "Resources": { "type": "list", "member": { "type": "structure", "members": { - "Arn": {}, + "Type": {}, "Name": {}, - "Type": {} + "Arn": {} } } - }, - "Time": { - "shape": "Sb" } } } @@ -513,74 +533,74 @@ }, "input": { "type": "structure", + "required": [ + "StatusFilter" + ], "members": { - "MaxResults": { - "type": "integer" - }, - "NextToken": {}, "StatusFilter": { "type": "structure", "members": { - "Any": { + "Ongoing": { "type": "structure", + "required": [ + "Type" + ], "members": { - "StartTimeRange": { - "shape": "S1o" - }, "Type": {} - }, - "required": [ - "Type", - "StartTimeRange" - ] + } }, "Closed": { "type": "structure", + "required": [ + "Type", + "EndTimeRange" + ], "members": { + "Type": {}, "EndTimeRange": { "type": "structure", "members": { "FromTime": { - "shape": "Sb" + "type": "timestamp" }, "ToTime": { - "shape": "Sb" + "type": "timestamp" } } - }, - "Type": {} - }, - "required": [ - "Type", - "EndTimeRange" - ] + } + } }, - "Ongoing": { + "Any": { "type": "structure", - "members": { - "Type": {} - }, "required": [ - "Type" - ] + "Type", + "StartTimeRange" + ], + "members": { + "Type": {}, + "StartTimeRange": { + "shape": "S1z" + } + } } } - } - }, - "required": [ - "StatusFilter" - ] + }, + "MaxResults": { + "type": "integer" + }, + "NextToken": {} + } }, "output": { "type": "structure", "members": { - "NextToken": {}, "ProactiveInsights": { - "shape": "S2i" + "shape": "S2w" }, "ReactiveInsights": { - "shape": "S2k" - } + "shape": "S2y" + }, + "NextToken": {} } } }, @@ -603,10 +623,10 @@ "member": { "type": "structure", "members": { + "Id": {}, "Config": { "shape": "S2" - }, - "Id": {} + } } } }, @@ -621,18 +641,17 @@ }, "input": { "type": "structure", + "required": [ + "InsightId" + ], "members": { "InsightId": {}, "NextToken": {} - }, - "required": [ - "InsightId" - ] + } }, "output": { "type": "structure", "members": { - "NextToken": {}, "Recommendations": { "type": "list", "member": { @@ -642,6 +661,25 @@ "Link": {}, "Name": {}, "Reason": {}, + "RelatedEvents": { + "type": "list", + "member": { + "type": "structure", + "members": { + "Name": {}, + "Resources": { + "type": "list", + "member": { + "type": "structure", + "members": { + "Name": {}, + "Type": {} + } + } + } + } + } + }, "RelatedAnomalies": { "type": "list", "member": { @@ -677,29 +715,11 @@ } } } - }, - "RelatedEvents": { - "type": "list", - "member": { - "type": "structure", - "members": { - "Name": {}, - "Resources": { - "type": "list", - "member": { - "type": "structure", - "members": { - "Name": {}, - "Type": {} - } - } - } - } - } } } } - } + }, + "NextToken": {} } } }, @@ -715,8 +735,8 @@ "InsightFeedback": { "type": "structure", "members": { - "Feedback": {}, - "Id": {} + "Id": {}, + "Feedback": {} } } } @@ -734,15 +754,15 @@ }, "input": { "type": "structure", + "required": [ + "Id" + ], "members": { "Id": { "location": "uri", "locationName": "Id" } - }, - "required": [ - "Id" - ] + } }, "output": { "type": "structure", @@ -756,13 +776,17 @@ }, "input": { "type": "structure", + "required": [ + "StartTimeRange", + "Type" + ], "members": { + "StartTimeRange": { + "shape": "S1z" + }, "Filters": { "type": "structure", "members": { - "ResourceCollection": { - "shape": "Sm" - }, "Severities": { "type": "list", "member": {} @@ -770,6 +794,9 @@ "Statuses": { "type": "list", "member": {} + }, + "ResourceCollection": { + "shape": "S13" } } }, @@ -777,26 +804,19 @@ "type": "integer" }, "NextToken": {}, - "StartTimeRange": { - "shape": "S1o" - }, "Type": {} - }, - "required": [ - "Type", - "StartTimeRange" - ] + } }, "output": { "type": "structure", "members": { - "NextToken": {}, "ProactiveInsights": { - "shape": "S2i" + "shape": "S2w" }, "ReactiveInsights": { - "shape": "S2k" - } + "shape": "S2y" + }, + "NextToken": {} } } }, @@ -808,6 +828,10 @@ }, "input": { "type": "structure", + "required": [ + "Action", + "ResourceCollection" + ], "members": { "Action": {}, "ResourceCollection": { @@ -817,17 +841,14 @@ "type": "structure", "members": { "StackNames": { - "shape": "So" + "type": "list", + "member": {} } } } } } - }, - "required": [ - "Action", - "ResourceCollection" - ] + } }, "output": { "type": "structure", @@ -842,6 +863,9 @@ }, "input": { "type": "structure", + "required": [ + "ServiceIntegration" + ], "members": { "ServiceIntegration": { "type": "structure", @@ -854,10 +878,7 @@ } } } - }, - "required": [ - "ServiceIntegration" - ] + } }, "output": { "type": "structure", @@ -868,6 +889,9 @@ "shapes": { "S2": { "type": "structure", + "required": [ + "Sns" + ], "members": { "Sns": { "type": "structure", @@ -875,61 +899,37 @@ "TopicArn": {} } } - }, - "required": [ - "Sns" - ] - }, - "Sb": { - "type": "timestamp", - "timestampFormat": "unixTimestamp" + } }, - "Si": { + "So": { "type": "structure", - "members": { - "EndTime": { - "shape": "Sb" - }, - "StartTime": { - "shape": "Sb" - } - }, "required": [ "StartTime" - ] - }, - "Sl": { - "type": "structure", + ], "members": { - "EndTime": { - "shape": "Sb" - }, "StartTime": { - "shape": "Sb" + "type": "timestamp" + }, + "EndTime": { + "type": "timestamp" } - }, - "required": [ - "StartTime" - ] + } }, - "Sm": { + "Sp": { "type": "structure", + "required": [ + "StartTime" + ], "members": { - "CloudFormation": { - "type": "structure", - "members": { - "StackNames": { - "shape": "So" - } - } + "StartTime": { + "type": "timestamp" + }, + "EndTime": { + "type": "timestamp" } } }, - "So": { - "type": "list", - "member": {} - }, - "Sr": { + "Sq": { "type": "structure", "members": { "CloudWatchMetrics": { @@ -937,6 +937,8 @@ "member": { "type": "structure", "members": { + "MetricName": {}, + "Namespace": {}, "Dimensions": { "type": "list", "member": { @@ -947,79 +949,94 @@ } } }, - "MetricName": {}, - "Namespace": {}, + "Stat": {}, + "Unit": {}, "Period": { "type": "integer" - }, - "Stat": {}, - "Unit": {} + } } } } } }, - "S12": { + "S13": { "type": "structure", "members": { - "EndTime": { - "shape": "Sb" - }, - "StartTime": { - "shape": "Sb" + "CloudFormation": { + "type": "structure", + "members": { + "StackNames": { + "shape": "S15" + } + } } - }, + } + }, + "S15": { + "type": "list", + "member": {} + }, + "S1f": { + "type": "structure", "required": [ "StartTime" - ] + ], + "members": { + "StartTime": { + "type": "timestamp" + }, + "EndTime": { + "type": "timestamp" + } + } }, - "S1o": { + "S1z": { "type": "structure", "members": { "FromTime": { - "shape": "Sb" + "type": "timestamp" }, "ToTime": { - "shape": "Sb" + "type": "timestamp" } } }, - "S2i": { + "S2w": { "type": "list", "member": { "type": "structure", "members": { "Id": {}, + "Name": {}, + "Severity": {}, + "Status": {}, "InsightTimeRange": { - "shape": "S12" + "shape": "S1f" }, - "Name": {}, "PredictionTimeRange": { - "shape": "Sl" + "shape": "Sp" }, "ResourceCollection": { - "shape": "Sm" - }, - "Severity": {}, - "Status": {} + "shape": "S13" + } } } }, - "S2k": { + "S2y": { "type": "list", "member": { "type": "structure", "members": { "Id": {}, + "Name": {}, + "Severity": {}, + "Status": {}, "InsightTimeRange": { - "shape": "S12" + "shape": "S1f" }, - "Name": {}, "ResourceCollection": { - "shape": "Sm" - }, - "Severity": {}, - "Status": {} + "shape": "S13" + } } } } diff --git a/apis/devops-guru-2020-12-01.normal.json b/apis/devops-guru-2020-12-01.normal.json index efb35139b7..a10bd13d6f 100644 --- a/apis/devops-guru-2020-12-01.normal.json +++ b/apis/devops-guru-2020-12-01.normal.json @@ -1,14 +1,15 @@ { + "version": "2.0", "metadata": { "apiVersion": "2020-12-01", "endpointPrefix": "devops-guru", - "signingName": "devops-guru", + "jsonVersion": "1.1", + "protocol": "rest-json", "serviceFullName": "Amazon DevOps Guru", "serviceId": "DevOps Guru", - "protocol": "rest-json", - "jsonVersion": "1.1", - "uid": "devops-guru-2020-12-01", - "signatureVersion": "v4" + "signatureVersion": "v4", + "signingName": "devops-guru", + "uid": "devops-guru-2020-12-01" }, "operations": { "AddNotificationChannel": { @@ -26,27 +27,28 @@ }, "errors": [ { - "shape": "ValidationException" + "shape": "AccessDeniedException" }, { - "shape": "InternalServerException" + "shape": "ConflictException" }, { - "shape": "ServiceQuotaExceededException" + "shape": "InternalServerException" }, { - "shape": "AccessDeniedException" + "shape": "ResourceNotFoundException" }, { - "shape": "ResourceNotFoundException" + "shape": "ServiceQuotaExceededException" }, { "shape": "ThrottlingException" }, { - "shape": "ConflictException" + "shape": "ValidationException" } - ] + ], + "documentation": "
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": { "name": "DescribeAccountHealth", @@ -63,18 +65,19 @@ }, "errors": [ { - "shape": "ThrottlingException" + "shape": "AccessDeniedException" }, { - "shape": "ValidationException" + "shape": "InternalServerException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "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": { "name": "DescribeAccountOverview", @@ -91,18 +94,19 @@ }, "errors": [ { - "shape": "ThrottlingException" + "shape": "AccessDeniedException" }, { - "shape": "ValidationException" + "shape": "InternalServerException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "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": { "name": "DescribeAnomaly", @@ -119,21 +123,22 @@ }, "errors": [ { - "shape": "ResourceNotFoundException" + "shape": "AccessDeniedException" }, { - "shape": "ThrottlingException" + "shape": "InternalServerException" }, { - "shape": "ValidationException" + "shape": "ResourceNotFoundException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "Returns details about an anomaly that you specify using its ID.
" }, "DescribeInsight": { "name": "DescribeInsight", @@ -150,21 +155,22 @@ }, "errors": [ { - "shape": "ResourceNotFoundException" + "shape": "AccessDeniedException" }, { - "shape": "ThrottlingException" + "shape": "InternalServerException" }, { - "shape": "ValidationException" + "shape": "ResourceNotFoundException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "Returns details about an insight that you specify using its ID.
" }, "DescribeResourceCollectionHealth": { "name": "DescribeResourceCollectionHealth", @@ -181,18 +187,19 @@ }, "errors": [ { - "shape": "ThrottlingException" + "shape": "AccessDeniedException" }, { - "shape": "ValidationException" + "shape": "InternalServerException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "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": { "name": "DescribeServiceIntegration", @@ -209,18 +216,19 @@ }, "errors": [ { - "shape": "ThrottlingException" + "shape": "AccessDeniedException" }, { - "shape": "ValidationException" + "shape": "InternalServerException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "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": { "name": "GetResourceCollection", @@ -237,21 +245,22 @@ }, "errors": [ { - "shape": "ResourceNotFoundException" + "shape": "AccessDeniedException" }, { - "shape": "ThrottlingException" + "shape": "InternalServerException" }, { - "shape": "ValidationException" + "shape": "ResourceNotFoundException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "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": { "name": "ListAnomaliesForInsight", @@ -268,21 +277,22 @@ }, "errors": [ { - "shape": "ResourceNotFoundException" + "shape": "AccessDeniedException" }, { - "shape": "ThrottlingException" + "shape": "InternalServerException" }, { - "shape": "ValidationException" + "shape": "ResourceNotFoundException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "Returns a list of the anomalies that belong to an insight that you specify using its ID.
" }, "ListEvents": { "name": "ListEvents", @@ -299,21 +309,22 @@ }, "errors": [ { - "shape": "ResourceNotFoundException" + "shape": "AccessDeniedException" }, { - "shape": "ThrottlingException" + "shape": "InternalServerException" }, { - "shape": "ValidationException" + "shape": "ResourceNotFoundException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "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": { "name": "ListInsights", @@ -330,18 +341,19 @@ }, "errors": [ { - "shape": "ThrottlingException" + "shape": "AccessDeniedException" }, { - "shape": "ValidationException" + "shape": "InternalServerException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": " 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": { "name": "ListRecommendations", @@ -386,21 +399,22 @@ }, "errors": [ { - "shape": "ResourceNotFoundException" + "shape": "AccessDeniedException" }, { - "shape": "ThrottlingException" + "shape": "InternalServerException" }, { - "shape": "ValidationException" + "shape": "ResourceNotFoundException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "Returns a list of a specified insight's recommendations. Each recommendation includes a list of related metrics and a list of related events.
" }, "PutFeedback": { "name": "PutFeedback", @@ -417,13 +431,13 @@ }, "errors": [ { - "shape": "ValidationException" + "shape": "AccessDeniedException" }, { - "shape": "InternalServerException" + "shape": "ConflictException" }, { - "shape": "AccessDeniedException" + "shape": "InternalServerException" }, { "shape": "ResourceNotFoundException" @@ -432,9 +446,10 @@ "shape": "ThrottlingException" }, { - "shape": "ConflictException" + "shape": "ValidationException" } - ] + ], + "documentation": "Collects customer feedback about the specified insight.
" }, "RemoveNotificationChannel": { "name": "RemoveNotificationChannel", @@ -451,13 +466,13 @@ }, "errors": [ { - "shape": "ValidationException" + "shape": "AccessDeniedException" }, { - "shape": "InternalServerException" + "shape": "ConflictException" }, { - "shape": "AccessDeniedException" + "shape": "InternalServerException" }, { "shape": "ResourceNotFoundException" @@ -466,9 +481,10 @@ "shape": "ThrottlingException" }, { - "shape": "ConflictException" + "shape": "ValidationException" } - ] + ], + "documentation": "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": { "name": "SearchInsights", @@ -485,18 +501,19 @@ }, "errors": [ { - "shape": "ThrottlingException" + "shape": "AccessDeniedException" }, { - "shape": "ValidationException" + "shape": "InternalServerException" }, { - "shape": "InternalServerException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": " 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": { "name": "UpdateServiceIntegration", @@ -544,43 +562,59 @@ }, "errors": [ { - "shape": "ThrottlingException" + "shape": "AccessDeniedException" }, { - "shape": "ValidationException" + "shape": "ConflictException" }, { "shape": "InternalServerException" }, { - "shape": "ConflictException" + "shape": "ThrottlingException" }, { - "shape": "AccessDeniedException" + "shape": "ValidationException" } - ] + ], + "documentation": "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": { "AddNotificationChannelRequest": { "type": "structure", + "required": [ + "Config" + ], "members": { "Config": { - "shape": "NotificationChannelConfig" + "shape": "NotificationChannelConfig", + "documentation": " A NotificationChannelConfig
object that specifies what type of notification channel to add. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS).
The ID of the added notification channel.
" } } }, + "AnomalyId": { + "type": "string", + "max": 100, + "min": 1, + "pattern": "^[\\w-]*$" + }, + "AnomalyLimit": { + "type": "double", + "box": true + }, "AnomalySeverity": { "type": "string", "enum": [ @@ -593,9 +627,11 @@ "type": "structure", "members": { "CloudWatchMetrics": { - "shape": "__listOfCloudWatchMetricsDetail" + "shape": "CloudWatchMetricsDetails", + "documentation": " An array of CloudWatchMetricsDetail
object that contains information about the analyzed metrics that displayed anomalous behavior.
Details about the source of the anomalous operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
" }, "AnomalyStatus": { "type": "string", @@ -606,79 +642,138 @@ }, "AnomalyTimeRange": { "type": "structure", + "required": [ + "StartTime" + ], "members": { - "EndTime": { - "shape": "__timestampUnix" - }, "StartTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "The time when the anomalous behavior started.
" + }, + "EndTime": { + "shape": "Timestamp", + "documentation": "The time when the anomalous behavior ended.
" } }, - "required": [ - "StartTime" - ] + "documentation": "A time range that specifies when the observed unusual behavior in an anomaly started and ended.
" + }, + "Channels": { + "type": "list", + "member": { + "shape": "NotificationChannel" + } }, "CloudFormationCollection": { "type": "structure", "members": { "StackNames": { - "shape": "__listOf__stringMin1Max128PatternAZAZAZAZ09" + "shape": "StackNames", + "documentation": "An array of CloudFormation stack names.
" } - } + }, + "documentation": "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.
" }, "CloudFormationCollectionFilter": { "type": "structure", "members": { "StackNames": { - "shape": "__listOf__stringMin1Max128PatternAZAZAZAZ09" + "shape": "StackNames", + "documentation": "An array of CloudFormation stack names.
" } - } + }, + "documentation": "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": { "type": "structure", "members": { - "Insight": { - "shape": "InsightHealth" - }, "StackName": { - "shape": "__stringMin1Max128PatternAZAZAZAZ09" + "shape": "StackName", + "documentation": "The name of the CloudFormation stack.
" + }, + "Insight": { + "shape": "InsightHealth", + "documentation": "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.
" } + }, + "documentation": "Information about the health of AWS resources in your account that are specified by an AWS CloudFormation stack.
" + }, + "CloudFormationHealths": { + "type": "list", + "member": { + "shape": "CloudFormationHealth" } }, "CloudWatchMetricsDetail": { "type": "structure", "members": { - "Dimensions": { - "shape": "__listOfCloudWatchMetricsDimension" - }, "MetricName": { - "shape": "__string" + "shape": "CloudWatchMetricsMetricName", + "documentation": "The name of the CloudWatch metric.
" }, "Namespace": { - "shape": "__string" + "shape": "CloudWatchMetricsNamespace", + "documentation": "The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
" }, - "Period": { - "shape": "__integer" + "Dimensions": { + "shape": "CloudWatchMetricsDimensions", + "documentation": "An array of CloudWatch dimensions associated with
" }, "Stat": { - "shape": "CloudWatchMetricsStat" + "shape": "CloudWatchMetricsStat", + "documentation": "The type of statistic associated with the CloudWatch metric. For more information, see Statistics in the Amazon CloudWatch User Guide.
" }, "Unit": { - "shape": "__string" + "shape": "CloudWatchMetricsUnit", + "documentation": " The unit of measure used for the CloudWatch metric. For example, Bytes
, Seconds
, Count
, and Percent
.
The length of time associated with the CloudWatch metric in number of seconds.
" } + }, + "documentation": "Information about an Amazon CloudWatch metric.
" + }, + "CloudWatchMetricsDetails": { + "type": "list", + "member": { + "shape": "CloudWatchMetricsDetail" } }, "CloudWatchMetricsDimension": { "type": "structure", "members": { "Name": { - "shape": "__string" + "shape": "CloudWatchMetricsDimensionName", + "documentation": "The name of the CloudWatch dimension.
" }, "Value": { - "shape": "__string" + "shape": "CloudWatchMetricsDimensionValue", + "documentation": "The value of the CloudWatch dimension.
" } + }, + "documentation": "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.
" + }, + "CloudWatchMetricsDimensionName": { + "type": "string" + }, + "CloudWatchMetricsDimensionValue": { + "type": "string" + }, + "CloudWatchMetricsDimensions": { + "type": "list", + "member": { + "shape": "CloudWatchMetricsDimension" } }, + "CloudWatchMetricsMetricName": { + "type": "string" + }, + "CloudWatchMetricsNamespace": { + "type": "string" + }, + "CloudWatchMetricsPeriod": { + "type": "integer" + }, "CloudWatchMetricsStat": { "type": "string", "enum": [ @@ -692,126 +787,160 @@ "p50" ] }, + "CloudWatchMetricsUnit": { + "type": "string" + }, "DescribeAccountHealthRequest": { "type": "structure", "members": {} }, "DescribeAccountHealthResponse": { "type": "structure", + "required": [ + "OpenReactiveInsights", + "OpenProactiveInsights", + "MetricsAnalyzed" + ], "members": { - "MetricsAnalyzed": { - "shape": "__integer" + "OpenReactiveInsights": { + "shape": "NumOpenReactiveInsights", + "documentation": "An integer that specifies the number of open reactive insights in your AWS account.
" }, "OpenProactiveInsights": { - "shape": "__integer" + "shape": "NumOpenProactiveInsights", + "documentation": "An integer that specifies the number of open proactive insights in your AWS account.
" }, - "OpenReactiveInsights": { - "shape": "__integer" + "MetricsAnalyzed": { + "shape": "NumMetricsAnalyzed", + "documentation": "An integer that specifies the number of metrics that have been analyzed in your AWS account.
" } } }, "DescribeAccountOverviewRequest": { "type": "structure", + "required": [ + "FromTime" + ], "members": { "FromTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "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.
" }, "ToTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "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.
" } - }, - "required": [ - "FromTime" - ] + } }, "DescribeAccountOverviewResponse": { "type": "structure", + "required": [ + "ReactiveInsights", + "ProactiveInsights", + "MeanTimeToRecoverInMilliseconds" + ], "members": { - "MeanTimeToRecoverInMilliseconds": { - "shape": "__long" + "ReactiveInsights": { + "shape": "NumReactiveInsights", + "documentation": "An integer that specifies the number of open reactive insights in your AWS account that were created during the time range passed in.
" }, "ProactiveInsights": { - "shape": "__integer" + "shape": "NumProactiveInsights", + "documentation": "An integer that specifies the number of open proactive insights in your AWS account that were created during the time range passed in.
" }, - "ReactiveInsights": { - "shape": "__integer" + "MeanTimeToRecoverInMilliseconds": { + "shape": "MeanTimeToRecoverInMilliseconds", + "documentation": "The Mean Time to Recover (MTTR) for all closed insights that were created during the time range passed in.
" } } }, "DescribeAnomalyRequest": { "type": "structure", + "required": [ + "Id" + ], "members": { "Id": { - "shape": "__string", + "shape": "AnomalyId", + "documentation": "The ID of the anomaly.
", "location": "uri", "locationName": "Id" } - }, - "required": [ - "Id" - ] + } }, "DescribeAnomalyResponse": { "type": "structure", "members": { "ProactiveAnomaly": { - "shape": "ProactiveAnomaly" + "shape": "ProactiveAnomaly", + "documentation": " An ReactiveAnomaly
object that represents the requested anomaly.
An ProactiveAnomaly
object that represents the requested anomaly.
The ID of the insight.
", "location": "uri", "locationName": "Id" } - }, - "required": [ - "Id" - ] + } }, "DescribeInsightResponse": { "type": "structure", "members": { "ProactiveInsight": { - "shape": "ProactiveInsight" + "shape": "ProactiveInsight", + "documentation": " An ProactiveInsight
object that represents the requested insight.
An ReactiveInsight
object that represents the requested insight.
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.
", "location": "uri", "locationName": "ResourceCollectionType" + }, + "NextToken": { + "shape": "UuidNextToken", + "documentation": "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.
", + "location": "querystring", + "locationName": "NextToken" } - }, - "required": [ - "ResourceCollectionType" - ] + } }, "DescribeResourceCollectionHealthResponse": { "type": "structure", + "required": [ + "CloudFormation" + ], "members": { "CloudFormation": { - "shape": "__listOfCloudFormationHealth" + "shape": "CloudFormationHealths", + "documentation": " The returned CloudFormationHealthOverview
object that contains an InsightHealthOverview
object with the requested system health information.
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.
" } } }, @@ -831,41 +960,52 @@ "type": "structure", "members": { "FromTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "The earliest end time in the time range.
" }, "ToTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "The latest end time in the time range.
" } - } + }, + "documentation": "A range of time that specifies when anomalous behavior in an anomaly or insight ended.
" }, "Event": { "type": "structure", "members": { - "DataSource": { - "shape": "EventDataSource" + "ResourceCollection": { + "shape": "ResourceCollection" }, - "EventClass": { - "shape": "EventClass" + "Id": { + "shape": "EventId", + "documentation": "The ID of the event.
" }, - "EventSource": { - "shape": "__stringMin10Max50PatternAZAZ09AmazonawsComAwsEvents" + "Time": { + "shape": "Timestamp", + "documentation": " A Timestamp
that specifies the time the event occurred.
The AWS source that emitted the event.
" }, "Name": { - "shape": "__stringMin0Max50" + "shape": "EventName", + "documentation": "The name of the event.
" }, - "ResourceCollection": { - "shape": "ResourceCollection" + "DataSource": { + "shape": "EventDataSource", + "documentation": " The source, AWS_CLOUD_TRAIL
or AWS_CODE_DEPLOY
, where DevOps Guru analysis found the event.
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.
" }, - "Time": { - "shape": "__timestampUnix" + "Resources": { + "shape": "EventResources", + "documentation": " An EventResource
object that contains information about the resource that emitted the event.
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.
" }, "EventClass": { "type": "string", @@ -884,74 +1024,132 @@ "AWS_CODE_DEPLOY" ] }, + "EventId": { + "type": "string" + }, + "EventName": { + "type": "string", + "max": 50, + "min": 0 + }, "EventResource": { "type": "structure", "members": { - "Arn": { - "shape": "__stringMin36Max2048PatternArnAwsAZAZ09AZ09D12" + "Type": { + "shape": "EventResourceType", + "documentation": "The type of resource that emitted an event.
" }, "Name": { - "shape": "__stringMin0Max2048Pattern" + "shape": "EventResourceName", + "documentation": "The name of the resource that emitted an event.
" }, - "Type": { - "shape": "__stringMin0Max2048Pattern" + "Arn": { + "shape": "EventResourceArn", + "documentation": "The Amazon Resource Name (ARN) of the resource that emitted an event.
" } + }, + "documentation": "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.
" + }, + "EventResourceArn": { + "type": "string", + "max": 2048, + "min": 36, + "pattern": "^arn:aws[-a-z]*:[a-z0-9-]*:[a-z0-9-]*:\\d{12}:.*$" + }, + "EventResourceName": { + "type": "string", + "max": 2048, + "min": 0, + "pattern": "^.*$" + }, + "EventResourceType": { + "type": "string", + "max": 2048, + "min": 0, + "pattern": "^.*$" + }, + "EventResources": { + "type": "list", + "member": { + "shape": "EventResource" } }, + "EventSource": { + "type": "string", + "max": 50, + "min": 10, + "pattern": "^[a-z]+[a-z0-9]*\\.amazonaws\\.com|aws\\.events$" + }, "EventTimeRange": { "type": "structure", + "required": [ + "FromTime", + "ToTime" + ], "members": { "FromTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "The time when the event started.
" }, "ToTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "The time when the event ended.
" } }, - "required": [ - "ToTime", - "FromTime" - ] + "documentation": "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.
" + }, + "Events": { + "type": "list", + "member": { + "shape": "Event" + } }, "GetResourceCollectionRequest": { "type": "structure", + "required": [ + "ResourceCollectionType" + ], "members": { - "NextToken": { - "shape": "__string", - "location": "querystring", - "locationName": "NextToken" - }, "ResourceCollectionType": { - "shape": "__string", + "shape": "ResourceCollectionType", + "documentation": " The type of AWS resource collections to return. The one valid value is CLOUD_FORMATION
for AWS CloudFormation stacks.
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.
", + "location": "querystring", + "locationName": "NextToken" } - }, - "required": [ - "ResourceCollectionType" - ] + } }, "GetResourceCollectionResponse": { "type": "structure", "members": { - "NextToken": { - "shape": "__stringMin36Max36PatternAF098AF094AF094AF094AF0912" - }, "ResourceCollection": { - "shape": "ResourceCollectionFilter" + "shape": "ResourceCollectionFilter", + "documentation": "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.
" + }, + "NextToken": { + "shape": "UuidNextToken", + "documentation": "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.
" } } }, "InsightFeedback": { "type": "structure", "members": { - "Feedback": { - "shape": "InsightFeedbackOption" - }, "Id": { - "shape": "__stringMin1Max100PatternW" + "shape": "InsightId", + "documentation": "The insight feedback ID.
" + }, + "Feedback": { + "shape": "InsightFeedbackOption", + "documentation": "The feedback provided by the customer.
" } - } + }, + "documentation": "Information about insight feedback received from a customer.
" }, "InsightFeedbackOption": { "type": "string", @@ -966,16 +1164,40 @@ "InsightHealth": { "type": "structure", "members": { - "MeanTimeToRecoverInMilliseconds": { - "shape": "__long" - }, "OpenProactiveInsights": { - "shape": "__integer" + "shape": "NumOpenProactiveInsights", + "documentation": "The number of open proactive insights.
" }, "OpenReactiveInsights": { - "shape": "__integer" + "shape": "NumOpenReactiveInsights", + "documentation": "The number of open reactive insights.
" + }, + "MeanTimeToRecoverInMilliseconds": { + "shape": "MeanTimeToRecoverInMilliseconds", + "documentation": "The Meant Time to Recover (MTTR) for the insight.
" } - } + }, + "documentation": "Information about the number of open reactive and proactive insights that can be used to gauge the health of your system.
" + }, + "InsightId": { + "type": "string", + "max": 100, + "min": 1, + "pattern": "^[\\w-]*$" + }, + "InsightName": { + "type": "string", + "max": 530, + "min": 1, + "pattern": "^[\\s\\S]*$" + }, + "InsightSeverities": { + "type": "list", + "member": { + "shape": "InsightSeverity" + }, + "max": 3, + "min": 0 }, "InsightSeverity": { "type": "string", @@ -992,19 +1214,30 @@ "CLOSED" ] }, + "InsightStatuses": { + "type": "list", + "member": { + "shape": "InsightStatus" + }, + "max": 2, + "min": 0 + }, "InsightTimeRange": { "type": "structure", + "required": [ + "StartTime" + ], "members": { - "EndTime": { - "shape": "__timestampUnix" - }, "StartTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "The time when the behavior described in an insight started.
" + }, + "EndTime": { + "shape": "Timestamp", + "documentation": "The time when the behavior described in an insight ended.
" } }, - "required": [ - "StartTime" - ] + "documentation": "A time ranged that specifies when the observed behavior in an insight started and ended.
" }, "InsightType": { "type": "string", @@ -1013,184 +1246,239 @@ "PROACTIVE" ] }, + "ListAnomaliesForInsightMaxResults": { + "type": "integer", + "max": 500, + "min": 1 + }, "ListAnomaliesForInsightRequest": { "type": "structure", + "required": [ + "InsightId" + ], "members": { "InsightId": { - "shape": "__string", + "shape": "InsightId", + "documentation": "The ID of the insight. The returned anomalies belong to this insight.
", "location": "uri", "locationName": "InsightId" }, + "StartTimeRange": { + "shape": "StartTimeRange", + "documentation": "A time range used to specify when the requested anomalies started. All returned anomalies started during this time range.
" + }, "MaxResults": { - "shape": "__integerMin1Max500" + "shape": "ListAnomaliesForInsightMaxResults", + "documentation": "The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken
value.
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.
" } - }, - "required": [ - "InsightId" - ] + } }, "ListAnomaliesForInsightResponse": { "type": "structure", "members": { - "NextToken": { - "shape": "__stringMin36Max36PatternAF098AF094AF094AF094AF0912" - }, "ProactiveAnomalies": { - "shape": "__listOfProactiveAnomalySummary" + "shape": "ProactiveAnomalies", + "documentation": " An array of ProactiveAnomalySummary
objects that represent the requested anomalies
An array of ReactiveAnomalySummary
objects that represent the requested anomalies
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.
" } } }, "ListEventsFilters": { "type": "structure", "members": { - "DataSource": { - "shape": "EventDataSource" + "InsightId": { + "shape": "InsightId", + "documentation": "An ID of an insight that is related to the events you want to filter for.
" + }, + "EventTimeRange": { + "shape": "EventTimeRange", + "documentation": "A time range during which you want the filtered events to have occurred.
" }, "EventClass": { - "shape": "EventClass" + "shape": "EventClass", + "documentation": "The class of the events you want to filter for, such as an infrastructure change, a deployment, or a schema change.
" }, "EventSource": { - "shape": "__stringMin10Max50PatternAZAZ09AmazonawsComAwsEvents" - }, - "EventTimeRange": { - "shape": "EventTimeRange" + "shape": "EventSource", + "documentation": "The AWS source that emitted the events you want to filter for.
" }, - "InsightId": { - "shape": "__stringMin1Max100PatternW" + "DataSource": { + "shape": "EventDataSource", + "documentation": " The source, AWS_CLOUD_TRAIL
or AWS_CODE_DEPLOY
, of the events you want returned.
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.
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.
" } - }, - "required": [ - "Filters" - ] + } }, "ListEventsResponse": { "type": "structure", + "required": [ + "Events" + ], "members": { "Events": { - "shape": "__listOfEvent" + "shape": "Events", + "documentation": "A list of the requested events.
" }, "NextToken": { - "shape": "__stringMin36Max36PatternAF098AF094AF094AF094AF0912" + "shape": "UuidNextToken", + "documentation": "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.
" } } }, "ListInsightsAnyStatusFilter": { "type": "structure", + "required": [ + "Type", + "StartTimeRange" + ], "members": { - "StartTimeRange": { - "shape": "StartTimeRange" - }, "Type": { - "shape": "InsightType" + "shape": "InsightType", + "documentation": " Use to filter for either REACTIVE
or PROACTIVE
insights.
A time range used to specify when the behavior of the filtered insights started.
" } }, - "required": [ - "Type", - "StartTimeRange" - ] + "documentation": "Used to filter for insights that have any status.
" }, "ListInsightsClosedStatusFilter": { "type": "structure", + "required": [ + "Type", + "EndTimeRange" + ], "members": { - "EndTimeRange": { - "shape": "EndTimeRange" - }, "Type": { - "shape": "InsightType" + "shape": "InsightType", + "documentation": " Use to filter for either REACTIVE
or PROACTIVE
insights.
A time range used to specify when the behavior of the filtered insights ended.
" } }, - "required": [ - "Type", - "EndTimeRange" - ] + "documentation": " Used to filter for insights that have the status CLOSED
.
Use to filter for either REACTIVE
or PROACTIVE
insights.
Used to filter for insights that have the status ONGOING
.
A filter used to filter the returned insights by their status. You can specify one status filter.
" + }, "MaxResults": { - "shape": "__integerMin1Max100" + "shape": "ListInsightsMaxResults", + "documentation": "The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken
value.
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.
" } - }, - "required": [ - "StatusFilter" - ] + } }, "ListInsightsResponse": { "type": "structure", "members": { - "NextToken": { - "shape": "__stringMin36Max36PatternAF098AF094AF094AF094AF0912" - }, "ProactiveInsights": { - "shape": "__listOfProactiveInsightSummary" + "shape": "ProactiveInsights", + "documentation": "The returned list of proactive insights.
" }, "ReactiveInsights": { - "shape": "__listOfReactiveInsightSummary" + "shape": "ReactiveInsights", + "documentation": "The returned list of reactive insights.
" + }, + "NextToken": { + "shape": "UuidNextToken", + "documentation": "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.
" } } }, "ListInsightsStatusFilter": { "type": "structure", "members": { - "Any": { - "shape": "ListInsightsAnyStatusFilter" + "Ongoing": { + "shape": "ListInsightsOngoingStatusFilter", + "documentation": " A ListInsightsAnyStatusFilter
that specifies ongoing insights that are either REACTIVE
or PROACTIVE
.
A ListInsightsClosedStatusFilter
that specifies closed insights that are either REACTIVE
or PROACTIVE
.
A ListInsightsAnyStatusFilter
that specifies insights of any status that are either REACTIVE
or PROACTIVE
.
A filter used by ListInsights
to specify which insights to return.
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.
" } } }, @@ -1198,78 +1486,118 @@ "type": "structure", "members": { "Channels": { - "shape": "__listOfNotificationChannel" + "shape": "Channels", + "documentation": "An array that contains the requested notification channels.
" }, "NextToken": { - "shape": "__stringMin36Max36PatternAF098AF094AF094AF094AF0912" + "shape": "UuidNextToken", + "documentation": "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": { "type": "structure", + "required": [ + "InsightId" + ], "members": { "InsightId": { - "shape": "__stringMin1Max100PatternW" + "shape": "InsightId", + "documentation": "The ID of the requested insight.
" }, "NextToken": { - "shape": "__stringMin36Max36PatternAF098AF094AF094AF094AF0912" + "shape": "UuidNextToken", + "documentation": "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.
" } - }, - "required": [ - "InsightId" - ] + } }, "ListRecommendationsResponse": { "type": "structure", "members": { - "NextToken": { - "shape": "__stringMin36Max36PatternAF098AF094AF094AF094AF0912" - }, "Recommendations": { - "shape": "__listOfRecommendation" + "shape": "Recommendations", + "documentation": "An array of the requested recommendations.
" + }, + "NextToken": { + "shape": "UuidNextToken", + "documentation": "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.
" } } }, + "MeanTimeToRecoverInMilliseconds": { + "type": "long" + }, "NotificationChannel": { "type": "structure", "members": { - "Config": { - "shape": "NotificationChannelConfig" - }, "Id": { - "shape": "__stringMin36Max36PatternAF098AF094AF094AF094AF0912" + "shape": "NotificationChannelId", + "documentation": "The ID of a notification channel.
" + }, + "Config": { + "shape": "NotificationChannelConfig", + "documentation": " A NotificationChannelConfig
object that contains information about configured notification channels.
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.
" }, "NotificationChannelConfig": { "type": "structure", + "required": [ + "Sns" + ], "members": { "Sns": { - "shape": "SnsChannelConfig" + "shape": "SnsChannelConfig", + "documentation": "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.
" } }, - "required": [ - "Sns" - ] + "documentation": "Information about notification channels you have configured with DevOps Guru. The one supported notification channel is Amazon Simple Notification Service (Amazon SNS).
" + }, + "NotificationChannelId": { + "type": "string", + "max": 36, + "min": 36, + "pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$" + }, + "NumMetricsAnalyzed": { + "type": "integer" + }, + "NumOpenProactiveInsights": { + "type": "integer" + }, + "NumOpenReactiveInsights": { + "type": "integer" + }, + "NumProactiveInsights": { + "type": "integer" + }, + "NumReactiveInsights": { + "type": "integer" }, "OpsCenterIntegration": { "type": "structure", "members": { "OptInStatus": { - "shape": "OptInStatus" + "shape": "OptInStatus", + "documentation": "Specifies if DevOps Guru is enabled to create an AWS Systems Manager OpsItem for each created insight.
" } - } + }, + "documentation": "Information about whether DevOps Guru is configured to create an OpsItem in AWS Systems Manager OpsCenter for each created insight.
" }, "OpsCenterIntegrationConfig": { "type": "structure", "members": { "OptInStatus": { - "shape": "OptInStatus" + "shape": "OptInStatus", + "documentation": "Specifies if DevOps Guru is enabled to create an AWS Systems Manager OpsItem for each created insight.
" } - } + }, + "documentation": "Information about whether DevOps Guru is configured to create an OpsItem in AWS Systems Manager OpsCenter for each created insight.
" }, "OptInStatus": { "type": "string", + "documentation": "Specifies if DevOps Guru is enabled to create an AWS Systems Manager OpsItem for each created insight.
", "enum": [ "ENABLED", "DISABLED" @@ -1277,148 +1605,191 @@ }, "PredictionTimeRange": { "type": "structure", + "required": [ + "StartTime" + ], "members": { - "EndTime": { - "shape": "__timestampUnix" - }, "StartTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "The time range during which a metric limit is expected to be exceeded. This applies to proactive insights only.
" + }, + "EndTime": { + "shape": "Timestamp", + "documentation": "The time when the behavior in a proactive insight is expected to end.
" } }, - "required": [ - "StartTime" - ] + "documentation": "The time range during which anomalous behavior in a proactive anomaly or an insight is expected to occur.
" + }, + "ProactiveAnomalies": { + "type": "list", + "member": { + "shape": "ProactiveAnomalySummary" + } }, "ProactiveAnomaly": { "type": "structure", "members": { - "AnomalyTimeRange": { - "shape": "AnomalyTimeRange" + "Id": { + "shape": "AnomalyId", + "documentation": "The ID of a proactive anomaly.
" }, - "AssociatedInsightId": { - "shape": "__stringMin1Max100PatternW" + "Severity": { + "shape": "AnomalySeverity", + "documentation": "The severity of a proactive anomaly.
" }, - "Id": { - "shape": "__stringMin1Max100PatternW" + "Status": { + "shape": "AnomalyStatus", + "documentation": "The status of a proactive anomaly.
" }, - "Limit": { - "shape": "__double" + "UpdateTime": { + "shape": "Timestamp", + "documentation": "The time of the anomaly's most recent update.
" + }, + "AnomalyTimeRange": { + "shape": "AnomalyTimeRange" }, "PredictionTimeRange": { "shape": "PredictionTimeRange" }, - "ResourceCollection": { - "shape": "ResourceCollection" - }, - "Severity": { - "shape": "AnomalySeverity" - }, "SourceDetails": { - "shape": "AnomalySourceDetails" + "shape": "AnomalySourceDetails", + "documentation": "Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
" }, - "Status": { - "shape": "AnomalyStatus" + "AssociatedInsightId": { + "shape": "InsightId", + "documentation": "The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
" }, - "UpdateTime": { - "shape": "__timestampUnix" + "ResourceCollection": { + "shape": "ResourceCollection" + }, + "Limit": { + "shape": "AnomalyLimit", + "documentation": "A threshold that was exceeded by behavior in analyzed resources. Exceeding this threshold is related to the anomalous behavior that generated this anomaly.
" } - } + }, + "documentation": "Information about an anomaly. This object is returned by ListAnomalies
.
The ID of the anomaly.
" }, - "AssociatedInsightId": { - "shape": "__stringMin1Max100PatternW" + "Severity": { + "shape": "AnomalySeverity", + "documentation": "The severity of the anomaly.
" }, - "Id": { - "shape": "__stringMin1Max100PatternW" + "Status": { + "shape": "AnomalyStatus", + "documentation": "The status of the anomaly.
" }, - "Limit": { - "shape": "__double" + "UpdateTime": { + "shape": "Timestamp", + "documentation": "The time of the anomaly's most recent update.
" + }, + "AnomalyTimeRange": { + "shape": "AnomalyTimeRange" }, "PredictionTimeRange": { "shape": "PredictionTimeRange" }, - "ResourceCollection": { - "shape": "ResourceCollection" - }, - "Severity": { - "shape": "AnomalySeverity" - }, "SourceDetails": { - "shape": "AnomalySourceDetails" + "shape": "AnomalySourceDetails", + "documentation": "Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
" }, - "Status": { - "shape": "AnomalyStatus" + "AssociatedInsightId": { + "shape": "InsightId", + "documentation": "The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
" }, - "UpdateTime": { - "shape": "__timestampUnix" + "ResourceCollection": { + "shape": "ResourceCollection" + }, + "Limit": { + "shape": "AnomalyLimit", + "documentation": "A threshold that was exceeded by behavior in analyzed resources. Exceeding this threshold is related to the anomalous behavior that generated this anomaly.
" } - } + }, + "documentation": "Details about a proactive anomaly. This object is returned by DescribeAnomaly.
The ID of the proactive insight.
" + }, + "Name": { + "shape": "InsightName", + "documentation": "The name of the proactive insight.
" + }, + "Severity": { + "shape": "InsightSeverity", + "documentation": "The severity of the proactive insight.
" + }, + "Status": { + "shape": "InsightStatus", + "documentation": "The status of the proactive insight.
" }, "InsightTimeRange": { "shape": "InsightTimeRange" }, - "Name": { - "shape": "__stringMin1Max530PatternSS" - }, "PredictionTimeRange": { "shape": "PredictionTimeRange" }, "ResourceCollection": { "shape": "ResourceCollection" }, - "Severity": { - "shape": "InsightSeverity" - }, "SsmOpsItemId": { - "shape": "__stringMin1Max100Pattern" - }, - "Status": { - "shape": "InsightStatus" + "shape": "SsmOpsItemId", + "documentation": "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.
" } - } + }, + "documentation": "Details about a proactive insight. This object is returned by ListInsights
.
The ID of the proactive insight.
" + }, + "Name": { + "shape": "InsightName", + "documentation": "The name of the proactive insight.
" + }, + "Severity": { + "shape": "InsightSeverity", + "documentation": "The severity of the proactive insight.
" + }, + "Status": { + "shape": "InsightStatus", + "documentation": "The status of the proactive insight.
" }, "InsightTimeRange": { "shape": "InsightTimeRange" }, - "Name": { - "shape": "__stringMin1Max530PatternSS" - }, "PredictionTimeRange": { "shape": "PredictionTimeRange" }, "ResourceCollection": { "shape": "ResourceCollection" - }, - "Severity": { - "shape": "InsightSeverity" - }, - "Status": { - "shape": "InsightStatus" } + }, + "documentation": "Details about a proactive insight. This object is returned by DescribeInsight.
The feedback from customers is about the recommendations in this insight.
" } } }, @@ -1426,205 +1797,342 @@ "type": "structure", "members": {} }, + "ReactiveAnomalies": { + "type": "list", + "member": { + "shape": "ReactiveAnomalySummary" + } + }, "ReactiveAnomaly": { "type": "structure", "members": { + "Id": { + "shape": "AnomalyId", + "documentation": "The ID of the reactive anomaly.
" + }, + "Severity": { + "shape": "AnomalySeverity", + "documentation": "The severity of the anomaly.
" + }, + "Status": { + "shape": "AnomalyStatus", + "documentation": "The status of the anomaly.
" + }, "AnomalyTimeRange": { "shape": "AnomalyTimeRange" }, - "AssociatedInsightId": { - "shape": "__stringMin1Max100PatternW" + "SourceDetails": { + "shape": "AnomalySourceDetails", + "documentation": "Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
" }, - "Id": { - "shape": "__stringMin1Max100PatternW" + "AssociatedInsightId": { + "shape": "InsightId", + "documentation": "The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
" }, "ResourceCollection": { "shape": "ResourceCollection" - }, - "Severity": { - "shape": "AnomalySeverity" - }, - "SourceDetails": { - "shape": "AnomalySourceDetails" - }, - "Status": { - "shape": "AnomalyStatus" } - } + }, + "documentation": "Details about a reactive anomaly. This object is returned by ListAnomalies
.
The ID of the reactive anomaly.
" + }, + "Severity": { + "shape": "AnomalySeverity", + "documentation": "The severity of the reactive anomaly.
" + }, + "Status": { + "shape": "AnomalyStatus", + "documentation": "The status of the reactive anomaly.
" + }, "AnomalyTimeRange": { "shape": "AnomalyTimeRange" }, - "AssociatedInsightId": { - "shape": "__stringMin1Max100PatternW" + "SourceDetails": { + "shape": "AnomalySourceDetails", + "documentation": "Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
" }, - "Id": { - "shape": "__stringMin1Max100PatternW" + "AssociatedInsightId": { + "shape": "InsightId", + "documentation": "The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
" }, "ResourceCollection": { "shape": "ResourceCollection" - }, - "Severity": { - "shape": "AnomalySeverity" - }, - "SourceDetails": { - "shape": "AnomalySourceDetails" - }, - "Status": { - "shape": "AnomalyStatus" } - } + }, + "documentation": "Details about a reactive anomaly. This object is returned by DescribeAnomaly.
The ID of a reactive insight.
" + }, + "Name": { + "shape": "InsightName", + "documentation": "The name of a reactive insight.
" + }, + "Severity": { + "shape": "InsightSeverity", + "documentation": "The severity of a reactive insight.
" + }, + "Status": { + "shape": "InsightStatus", + "documentation": "The status of a reactive insight.
" }, "InsightTimeRange": { "shape": "InsightTimeRange" }, - "Name": { - "shape": "__stringMin1Max530PatternSS" - }, "ResourceCollection": { "shape": "ResourceCollection" }, - "Severity": { - "shape": "InsightSeverity" - }, "SsmOpsItemId": { - "shape": "__stringMin1Max100Pattern" - }, - "Status": { - "shape": "InsightStatus" + "shape": "SsmOpsItemId", + "documentation": "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.
" } - } + }, + "documentation": " Information about a reactive insight. This object is returned by ListInsights
.
The ID of a reactive summary.
" }, "Name": { - "shape": "__stringMin1Max530PatternSS" - }, - "ResourceCollection": { - "shape": "ResourceCollection" + "shape": "InsightName", + "documentation": "The name of a reactive insight.
" }, "Severity": { - "shape": "InsightSeverity" + "shape": "InsightSeverity", + "documentation": "The severity of a reactive insight.
" }, "Status": { - "shape": "InsightStatus" + "shape": "InsightStatus", + "documentation": "The status of a reactive insight.
" + }, + "InsightTimeRange": { + "shape": "InsightTimeRange" + }, + "ResourceCollection": { + "shape": "ResourceCollection" } + }, + "documentation": " Information about a reactive insight. This object is returned by DescribeInsight.
A description of the problem.
" }, "Link": { - "shape": "__string" + "shape": "RecommendationLink", + "documentation": "A hyperlink to information to help you address the problem.
" }, "Name": { - "shape": "__string" + "shape": "RecommendationName", + "documentation": "The name of the recommendation.
" }, "Reason": { - "shape": "__string" - }, - "RelatedAnomalies": { - "shape": "__listOfRecommendationRelatedAnomaly" + "shape": "RecommendationReason", + "documentation": "The reason DevOps Guru flagged the anomalous behavior as a problem.
" }, "RelatedEvents": { - "shape": "__listOfRecommendationRelatedEvent" + "shape": "RecommendationRelatedEvents", + "documentation": "Events that are related to the problem. Use these events to learn more about what's happening and to help address the issue.
" + }, + "RelatedAnomalies": { + "shape": "RecommendationRelatedAnomalies", + "documentation": "Anomalies that are related to the problem. Use these Anomalies to learn more about what's happening and to help address the issue.
" } + }, + "documentation": "Recommendation information to help you remediate detected anomalous behavior that generated an insight.
" + }, + "RecommendationDescription": { + "type": "string" + }, + "RecommendationLink": { + "type": "string" + }, + "RecommendationName": { + "type": "string" + }, + "RecommendationReason": { + "type": "string" + }, + "RecommendationRelatedAnomalies": { + "type": "list", + "member": { + "shape": "RecommendationRelatedAnomaly" } }, "RecommendationRelatedAnomaly": { "type": "structure", "members": { "Resources": { - "shape": "__listOfRecommendationRelatedAnomalyResource" + "shape": "RecommendationRelatedAnomalyResources", + "documentation": "An array of objects that represent resources in which DevOps Guru detected anomalous behavior. Each object contains the name and type of the resource.
" }, "SourceDetails": { - "shape": "__listOfRecommendationRelatedAnomalySourceDetail" + "shape": "RelatedAnomalySourceDetails", + "documentation": "Information about where the anomalous behavior related the recommendation was found. For example, details in Amazon CloudWatch metrics.
" } - } + }, + "documentation": "Information about an anomaly that is related to a recommendation.
" }, "RecommendationRelatedAnomalyResource": { "type": "structure", "members": { "Name": { - "shape": "__string" + "shape": "RecommendationRelatedAnomalyResourceName", + "documentation": "The name of the resource.
" }, "Type": { - "shape": "__string" + "shape": "RecommendationRelatedAnomalyResourceType", + "documentation": "The type of the resource.
" } + }, + "documentation": "Information about a resource in which DevOps Guru detected anomalous behavior.
" + }, + "RecommendationRelatedAnomalyResourceName": { + "type": "string" + }, + "RecommendationRelatedAnomalyResourceType": { + "type": "string" + }, + "RecommendationRelatedAnomalyResources": { + "type": "list", + "member": { + "shape": "RecommendationRelatedAnomalyResource" } }, "RecommendationRelatedAnomalySourceDetail": { "type": "structure", "members": { "CloudWatchMetrics": { - "shape": "__listOfRecommendationRelatedCloudWatchMetricsSourceDetail" + "shape": "RecommendationRelatedCloudWatchMetricsSourceDetails", + "documentation": " An array of CloudWatchMetricsDetail
objects that contains information about the analyzed metrics that displayed anomalous behavior.
Contains an array of RecommendationRelatedCloudWatchMetricsSourceDetail
objects that contain the name and namespace of an Amazon CloudWatch metric.
The name of the CloudWatch metric.
" }, "Namespace": { - "shape": "__string" + "shape": "RecommendationRelatedCloudWatchMetricsSourceNamespace", + "documentation": "The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
" } + }, + "documentation": "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.
" + }, + "RecommendationRelatedCloudWatchMetricsSourceDetails": { + "type": "list", + "member": { + "shape": "RecommendationRelatedCloudWatchMetricsSourceDetail" } }, + "RecommendationRelatedCloudWatchMetricsSourceMetricName": { + "type": "string" + }, + "RecommendationRelatedCloudWatchMetricsSourceNamespace": { + "type": "string" + }, "RecommendationRelatedEvent": { "type": "structure", "members": { "Name": { - "shape": "__string" + "shape": "RecommendationRelatedEventName", + "documentation": " The name of the event. This corresponds to the Name
field in an Event
object.
A ResourceCollection
object that contains arrays of the names of AWS CloudFormation stacks.
Information about an event that is related to a recommendation.
" }, - "RecommendationRelatedEventResource": { + "RecommendationRelatedEventName": { + "type": "string" + }, + "RecommendationRelatedEventResource": { "type": "structure", "members": { "Name": { - "shape": "__string" + "shape": "RecommendationRelatedEventResourceName", + "documentation": " 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.
Information about an AWS resource that emitted and event that is related to a recommendation in an insight.
" + }, + "RecommendationRelatedEventResourceName": { + "type": "string" + }, + "RecommendationRelatedEventResourceType": { + "type": "string" + }, + "RecommendationRelatedEventResources": { + "type": "list", + "member": { + "shape": "RecommendationRelatedEventResource" + } + }, + "RecommendationRelatedEvents": { + "type": "list", + "member": { + "shape": "RecommendationRelatedEvent" + } + }, + "Recommendations": { + "type": "list", + "member": { + "shape": "Recommendation" + }, + "max": 10, + "min": 0 + }, + "RelatedAnomalySourceDetails": { + "type": "list", + "member": { + "shape": "RecommendationRelatedAnomalySourceDetail" } }, "RemoveNotificationChannelRequest": { "type": "structure", + "required": [ + "Id" + ], "members": { "Id": { - "shape": "__string", + "shape": "NotificationChannelId", + "documentation": "The ID of the notification channel to be removed.
", "location": "uri", "locationName": "Id" } - }, - "required": [ - "Id" - ] + } }, "RemoveNotificationChannelResponse": { "type": "structure", @@ -1634,67 +2142,93 @@ "type": "structure", "members": { "CloudFormation": { - "shape": "CloudFormationCollection" + "shape": "CloudFormationCollection", + "documentation": "An array of the names of AWS CloudFormation stacks. The stacks define AWS resources that DevOps Guru analyzes.
" } - } + }, + "documentation": "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.
" }, "ResourceCollectionFilter": { "type": "structure", "members": { "CloudFormation": { - "shape": "CloudFormationCollectionFilter" + "shape": "CloudFormationCollectionFilter", + "documentation": "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.
" } - } + }, + "documentation": "Information about a filter used to specify which AWS resources are analyzed for anomalous behavior by DevOps Guru.
" + }, + "ResourceCollectionType": { + "type": "string", + "enum": [ + "AWS_CLOUD_FORMATION" + ] }, "SearchInsightsFilters": { "type": "structure", "members": { - "ResourceCollection": { - "shape": "ResourceCollection" - }, "Severities": { - "shape": "__listOfInsightSeverity" + "shape": "InsightSeverities", + "documentation": "An array of severity values used to search for insights.
" }, "Statuses": { - "shape": "__listOfInsightStatus" + "shape": "InsightStatuses", + "documentation": "An array of status values used to search for insights.
" + }, + "ResourceCollection": { + "shape": "ResourceCollection" } - } + }, + "documentation": "Specifies one or more severity values and one or more status values that are used to search for insights.
" + }, + "SearchInsightsMaxResults": { + "type": "integer", + "max": 100, + "min": 1 }, "SearchInsightsRequest": { "type": "structure", + "required": [ + "StartTimeRange", + "Type" + ], "members": { + "StartTimeRange": { + "shape": "StartTimeRange", + "documentation": "The start of the time range passed in. Returned insights occurred after this time.
" + }, "Filters": { - "shape": "SearchInsightsFilters" + "shape": "SearchInsightsFilters", + "documentation": " 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.
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
" }, "Type": { - "shape": "InsightType" + "shape": "InsightType", + "documentation": " The type of insights you are searching for (REACTIVE
or PROACTIVE
).
The returned proactive insights.
" }, "ReactiveInsights": { - "shape": "__listOfReactiveInsightSummary" + "shape": "ReactiveInsights", + "documentation": "The returned reactive insights.
" + }, + "NextToken": { + "shape": "UuidNextToken", + "documentation": "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.
" } } }, @@ -1702,36 +2236,72 @@ "type": "structure", "members": { "OpsCenter": { - "shape": "OpsCenterIntegration" + "shape": "OpsCenterIntegration", + "documentation": "Information about whether DevOps Guru is configured to create an OpsItem in AWS Systems Manager OpsCenter for each created insight.
" } - } + }, + "documentation": "Information about the integration of DevOps Guru with another AWS service, such as AWS Systems Manager.
" }, "SnsChannelConfig": { "type": "structure", "members": { "TopicArn": { - "shape": "__stringMin36Max1024PatternArnAwsAZ09SnsAZ09D12" + "shape": "TopicArn", + "documentation": "The Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic.
" } + }, + "documentation": "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.
" + }, + "SsmOpsItemId": { + "type": "string", + "max": 100, + "min": 1, + "pattern": "^.*$" + }, + "StackName": { + "type": "string", + "max": 128, + "min": 1, + "pattern": "^[a-zA-Z*]+[a-zA-Z0-9-]*$" + }, + "StackNames": { + "type": "list", + "member": { + "shape": "StackName" } }, "StartTimeRange": { "type": "structure", "members": { "FromTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "The start time of the time range.
" }, "ToTime": { - "shape": "__timestampUnix" + "shape": "Timestamp", + "documentation": "The end time of the time range.
" } - } + }, + "documentation": "A time range used to specify when the behavior of an insight or anomaly started.
" + }, + "Timestamp": { + "type": "timestamp" + }, + "TopicArn": { + "type": "string", + "max": 1024, + "min": 36, + "pattern": "^arn:aws[a-z0-9-]*:sns:[a-z0-9-]+:\\d{12}:[^:]+$" }, "UpdateCloudFormationCollectionFilter": { "type": "structure", "members": { "StackNames": { - "shape": "__listOf__stringMin1Max128PatternAZAZAZAZ09" + "shape": "UpdateStackNames", + "documentation": "An array of the name of stacks to update.
" } - } + }, + "documentation": "Contains the names of AWS CloudFormation stacks used to update a collection of stacks.
" }, "UpdateResourceCollectionAction": { "type": "string", @@ -1744,24 +2314,27 @@ "type": "structure", "members": { "CloudFormation": { - "shape": "UpdateCloudFormationCollectionFilter" + "shape": "UpdateCloudFormationCollectionFilter", + "documentation": "An collection of AWS CloudFormation stacks.
" } - } + }, + "documentation": "Contains information used to update a collection of AWS resources.
" }, "UpdateResourceCollectionRequest": { "type": "structure", + "required": [ + "Action", + "ResourceCollection" + ], "members": { "Action": { - "shape": "UpdateResourceCollectionAction" + "shape": "UpdateResourceCollectionAction", + "documentation": "Specifies if the resource collection in the request is added or deleted to the resource collection.
" }, "ResourceCollection": { "shape": "UpdateResourceCollectionFilter" } - }, - "required": [ - "Action", - "ResourceCollection" - ] + } }, "UpdateResourceCollectionResponse": { "type": "structure", @@ -1773,232 +2346,39 @@ "OpsCenter": { "shape": "OpsCenterIntegrationConfig" } - } + }, + "documentation": "Information about updating the integration status of an AWS service, such as AWS Systems Manager, with DevOps Guru.
" }, "UpdateServiceIntegrationRequest": { "type": "structure", + "required": [ + "ServiceIntegration" + ], "members": { "ServiceIntegration": { - "shape": "UpdateServiceIntegrationConfig" + "shape": "UpdateServiceIntegrationConfig", + "documentation": " An IntegratedServiceConfig
object used to specify the integrated service you want to update, and whether you want to update it to enabled or disabled.
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.
" } \ No newline at end of file diff --git a/apis/devops-guru-2020-12-01.paginators.json b/apis/devops-guru-2020-12-01.paginators.json index 0360337d2f..6e9b69977b 100644 --- a/apis/devops-guru-2020-12-01.paginators.json +++ b/apis/devops-guru-2020-12-01.paginators.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/apis/ec2-2016-11-15.normal.json b/apis/ec2-2016-11-15.normal.json index b4a6d04137..13c3f8e737 100644 --- a/apis/ec2-2016-11-15.normal.json +++ b/apis/ec2-2016-11-15.normal.json @@ -27446,6 +27446,7 @@ "c5n.4xlarge", "c5n.9xlarge", "c5n.18xlarge", + "c5n.metal", "c6g.metal", "c6g.medium", "c6g.large", diff --git a/apis/globalaccelerator-2018-08-08.paginators.json b/apis/globalaccelerator-2018-08-08.paginators.json index d5ab47d079..b8d23c6746 100644 --- a/apis/globalaccelerator-2018-08-08.paginators.json +++ b/apis/globalaccelerator-2018-08-08.paginators.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/clients/devopsguru.d.ts b/clients/devopsguru.d.ts index 73c2d0ec32..a5273cea62 100644 --- a/clients/devopsguru.d.ts +++ b/clients/devopsguru.d.ts @@ -12,226 +12,343 @@ declare class DevOpsGuru extends Service { constructor(options?: DevOpsGuru.Types.ClientConfiguration) config: Config & DevOpsGuru.Types.ClientConfiguration; /** - * + * 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. */ addNotificationChannel(params: DevOpsGuru.Types.AddNotificationChannelRequest, callback?: (err: AWSError, data: DevOpsGuru.Types.AddNotificationChannelResponse) => void): Request>1,l=23===a?Math.pow(2,-24)-Math.pow(2,-77):0,d=i?0:s-1,y=i?1:-1,b=t<0||0===t&&1/t<0?1:0;for(t=Math.abs(t),isNaN(t)||t===1/0?(n=isNaN(t)?1:0,o=m):(o=Math.floor(Math.log(t)/Math.LN2),t*(u=Math.pow(2,-o))<1&&(o--,u*=2),t+=o+c>=1?l/u:l*Math.pow(2,1-c),t*u>=2&&(o++,u/=2),o+c>=m?(n=0,o=m):o+c>=1?(n=(t*u-1)*Math.pow(2,a),o+=c):(n=t*Math.pow(2,c-1)*Math.pow(2,a),o=0));a>=8;e[r+d]=255&n,d+=y,n/=256,a-=8);for(o=o<0;e[r+d]=255&o,d+=y,o/=256,p-=8);e[r+d-y]|=128*b}},{}],415:[function(e,t,r){var i={}.toString;t.exports=Array.isArray||function(e){return"[object Array]"==i.call(e)}},{}],416:[function(e,t,r){!function(e){"use strict";function t(e){return null!==e&&"[object Array]"===Object.prototype.toString.call(e)}function r(e){return null!==e&&"[object Object]"===Object.prototype.toString.call(e)}function i(e,a){if(e===a)return!0;if(Object.prototype.toString.call(e)!==Object.prototype.toString.call(a))return!1;if(!0===t(e)){if(e.length!==a.length)return!1;for(var s=0;s G((f-r)/g)&&a("overflow"),r+=(p-t)*g,t=p,u=0;u =0?(c=b.substr(0,S),l=b.substr(S+1)):(c=b,l=""),d=decodeURIComponent(c),y=decodeURIComponent(l),i(o,d)?a(o[d])?o[d].push(y):o[d]=[o[d],y]:o[d]=y}return o};var a=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],420:[function(e,t,r){"use strict";function i(e,t){if(e.map)return e.map(t);for(var r=[],i=0;i=55296&&t<=56319&&a65535&&(e-=65536,t+=w(e>>>10&1023|55296),e=56320|1023&e),t+=w(e)}).join("")}function p(e){return e-48<10?e-22:e-65<26?e-65:e-97<26?e-97:T}function m(e,t){return e+22+75*(e<26)-((0!=t)<<5)}function c(e,t,r){var i=0;for(e=r?G(e/R):e>>1,e+=G(e/t);e>L*k>>1;i+=T)e=G(e/L);return G(i+(L+1)*e/(e+v))}function l(e){var t,r,i,s,o,n,m,l,d,y,b=[],S=e.length,g=0,h=D,I=A;for(r=e.lastIndexOf(P),r<0&&(r=0),i=0;i=S&&a("invalid-input"),l=p(e.charCodeAt(s++)),(l>=T||l>G((f-g)/n))&&a("overflow"),g+=l*n,d=m<=I?C:m>=I+k?k:m-I,!(l=t&&bf&&a("overflow"),b==t){for(l=r,d=T;y=d<=o?C:d>=o+k?k:d-o,!(l>>((3&t)<<3)&255;return s}}},{}],433:[function(e,t,r){function i(e,t,r){var i=t&&r||0,m=t||[];e=e||{};var c=e.node||a,l=void 0!==e.clockseq?e.clockseq:s;if(null==c||null==l){var d=o();null==c&&(c=a=[1|d[0],d[1],d[2],d[3],d[4],d[5]]),null==l&&(l=s=16383&(d[6]<<8|d[7]))}var y=void 0!==e.msecs?e.msecs:(new Date).getTime(),b=void 0!==e.nsecs?e.nsecs:p+1,S=y-u+(b-p)/1e4;if(S<0&&void 0===e.clockseq&&(l=l+1&16383),(S<0||y>u)&&void 0===e.nsecs&&(b=0),b>=1e4)throw new Error("uuid.v1(): Can't create more than 10M uuids/sec");u=y,p=b,s=l,y+=122192928e5;var g=(1e4*(268435455&y)+b)%4294967296;m[i++]=g>>>24&255,m[i++]=g>>>16&255,m[i++]=g>>>8&255,m[i++]=255&g;var h=y/4294967296*1e4&268435455;m[i++]=h>>>8&255,m[i++]=255&h,m[i++]=h>>>24&15|16,m[i++]=h>>>16&255,m[i++]=l>>>8|128,m[i++]=255&l;for(var I=0;I<6;++I)m[i+I]=c[I];return t||n(m)}var a,s,o=e("./lib/rng"),n=e("./lib/bytesToUuid"),u=0,p=0;t.exports=i},{"./lib/bytesToUuid":431,"./lib/rng":432}],434:[function(e,t,r){function i(e,t,r){var i=t&&r||0;"string"==typeof e&&(t="binary"===e?new Array(16):null,e=null),e=e||{};var o=e.random||(e.rng||a)();if(o[6]=15&o[6]|64,o[8]=63&o[8]|128,t)for(var n=0;n<16;++n)t[i+n]=o[n];return t||s(o)}var a=e("./lib/rng"),s=e("./lib/bytesToUuid");t.exports=i},{"./lib/bytesToUuid":431,"./lib/rng":432}],435:[function(e,t,r){"use strict";Object.defineProperty(r,"__esModule",{value:!0});var i=e("./utils/LRU"),a=1e3,s=function(){function e(e){void 0===e&&(e=a),this.maxSize=e,this.cache=new i.LRUCache(e)}return Object.defineProperty(e.prototype,"size",{get:function(){return this.cache.length},enumerable:!0,configurable:!0}),e.prototype.put=function(t,r){var i="string"!=typeof t?e.getKeyString(t):t,a=this.populateValue(r);this.cache.put(i,a)},e.prototype.get=function(t){var r="string"!=typeof t?e.getKeyString(t):t,i=Date.now(),a=this.cache.get(r);if(a)for(var s=0;s>>8*(i?a:1-a)}function B(e,t,r,i){t<0&&(t=4294967295+t+1);for(var a=0,s=Math.min(e.length-r,4);a>>8*(i?a:3-a)&255}function U(e,t,r,i,a,s){if(r+i>e.length)throw new RangeError("Index out of range");if(r<0)throw new RangeError("Index out of range")}function _(e,t,r,i,a){return a||U(e,t,r,4,3.4028234663852886e38,-3.4028234663852886e38),X.write(e,t,r,i,23,4),r+4}function F(e,t,r,i,a){return a||U(e,t,r,8,1.7976931348623157e308,-1.7976931348623157e308),X.write(e,t,r,i,52,8),r+8}function O(e){if(e=V(e).replace(ee,""),e.length<2)return"";for(;e.length%4!=0;)e+="=";return e}function V(e){return e.trim?e.trim():e.replace(/^\s+|\s+$/g,"")}function z(e){return e<16?"0"+e.toString(16):e.toString(16)}function K(e,t){t=t||1/0;for(var r,i=e.length,a=null,s=[],o=0;o55295&&r<57344){if(!a){if(r>56319){(t-=3)>-1&&s.push(239,191,189);continue}if(o+1===i){(t-=3)>-1&&s.push(239,191,189);continue}a=r;continue}if(r<56320){(t-=3)>-1&&s.push(239,191,189),a=r;continue}r=65536+(a-55296<<10|r-56320)}else a&&(t-=3)>-1&&s.push(239,191,189);if(a=null,r<128){if((t-=1)<0)break;s.push(r)}else if(r<2048){if((t-=2)<0)break;s.push(r>>6|192,63&r|128)}else if(r<65536){if((t-=3)<0)break;s.push(r>>12|224,r>>6&63|128,63&r|128)}else{if(!(r<1114112))throw new Error("Invalid code point");if((t-=4)<0)break;s.push(r>>18|240,r>>12&63|128,r>>6&63|128,63&r|128)}}return s}function j(e){for(var t=[],r=0;r