String accountId
The ID of the Amazon Web Services account.
AccountInsightHealth insight
Information about the health of the Amazon Web Services resources in your account, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights.
Integer openProactiveInsights
An integer that specifies the number of open proactive insights in your Amazon Web Services account.
Integer openReactiveInsights
An integer that specifies the number of open reactive insights in your Amazon Web Services account.
NotificationChannelConfig config
A NotificationChannelConfig object that specifies what type of notification channel to add. The one
supported notification channel is Amazon Simple Notification Service (Amazon SNS).
String id
The ID of the added notification channel.
String status
The status of the CodeGuru Profiler integration. Specifies if DevOps Guru is enabled to consume recommendations that are generated from Amazon CodeGuru Profiler.
String logGroupName
The name of the CloudWatch log group.
Date impactStartTime
The time the anomalous log events began. The impact start time indicates the time of the first log anomaly event that occurs.
Date impactEndTime
The time the anomalous log events stopped.
Integer numberOfLogLinesScanned
The number of log lines that were scanned for anomalous log events.
List<E> logAnomalyShowcases
The log anomalies in the log group. Each log anomaly displayed represents a cluster of similar anomalous log events.
List<E> cloudWatchMetrics
An array of CloudWatchMetricsDetail objects that contain information about analyzed CloudWatch
metrics that show anomalous behavior.
List<E> performanceInsightsMetrics
An array of PerformanceInsightsMetricsDetail objects that contain information about analyzed
Performance Insights metrics that show anomalous behavior.
String stackName
The name of the CloudFormation stack.
InsightHealth insight
Information about the health of the Amazon Web Services resources in your account that are specified by an Amazon Web Services CloudFormation stack, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights.
Long analyzedResourceCount
Number of resources that DevOps Guru is monitoring in your account that are specified by an Amazon Web Services CloudFormation stack.
String metricName
The name of the CloudWatch metric.
String namespace
The namespace of the CloudWatch metric. A namespace is a container for CloudWatch metrics.
List<E> dimensions
An array of CloudWatch dimensions associated with
String stat
The type of statistic associated with the CloudWatch metric. For more information, see Statistics in the Amazon CloudWatch User Guide.
String unit
The unit of measure used for the CloudWatch metric. For example, Bytes, Seconds,
Count, and Percent.
Integer period
The length of time associated with the CloudWatch metric in number of seconds.
CloudWatchMetricsDataSummary metricDataSummary
This object returns anomaly metric data.
CloudFormationCostEstimationResourceCollectionFilter cloudFormation
An object that specifies the CloudFormation stack that defines the Amazon Web Services resources used to create a monthly estimate for DevOps Guru.
List<E> tags
The Amazon Web Services tags used to filter the resource collection that is used for a cost estimate.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or
Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production,
or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag
values are case-sensitive.
Together these are known as key-value pairs.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
String id
The ID of the insight.
Integer openReactiveInsights
An integer that specifies the number of open reactive insights in your Amazon Web Services account.
Integer openProactiveInsights
An integer that specifies the number of open proactive insights in your Amazon Web Services account.
Integer metricsAnalyzed
An integer that specifies the number of metrics that have been analyzed in your Amazon Web Services account.
Long resourceHours
The number of Amazon DevOps Guru resource analysis hours billed to the current Amazon Web Services account in the last hour.
Long analyzedResourceCount
Number of resources that DevOps Guru is monitoring in your Amazon Web Services account.
Date fromTime
The start of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred after this day.
Date toTime
The end of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred before this day. If this is not specified, then the current day is used.
Integer reactiveInsights
An integer that specifies the number of open reactive insights in your Amazon Web Services account that were created during the time range passed in.
Integer proactiveInsights
An integer that specifies the number of open proactive insights in your Amazon Web Services account that were created during the time range passed in.
Long meanTimeToRecoverInMilliseconds
The Mean Time to Recover (MTTR) for all closed insights that were created during the time range passed in.
ProactiveAnomaly proactiveAnomaly
A ProactiveAnomaly object that represents the requested anomaly.
ReactiveAnomaly reactiveAnomaly
A ReactiveAnomaly object that represents the requested anomaly.
EventSourcesConfig eventSources
Lists the event sources in the configuration.
String insightId
The ID of the insight for which the feedback was provided.
InsightFeedback insightFeedback
ProactiveInsight proactiveInsight
A ProactiveInsight object that represents the requested insight.
ReactiveInsight reactiveInsight
A ReactiveInsight object that represents the requested insight.
Integer openReactiveInsights
An integer that specifies the number of open reactive insights in your Amazon Web Services account.
Integer openProactiveInsights
An integer that specifies the number of open proactive insights in your Amazon Web Services account.
Integer metricsAnalyzed
An integer that specifies the number of metrics that have been analyzed in your organization.
Long resourceHours
The number of Amazon DevOps Guru resource analysis hours billed to the current Amazon Web Services account in the last hour.
Date fromTime
The start of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred after this day.
Date toTime
The end of the time range passed in. The start time granularity is at the day level. The floor of the start time is used. Returned information occurred before this day. If this is not specified, then the current day is used.
List<E> accountIds
The ID of the Amazon Web Services account.
List<E> organizationalUnitIds
The ID of the organizational unit.
String organizationResourceCollectionType
An Amazon Web Services resource collection type. This type specifies how analyzed Amazon Web Services resources are defined. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks.
List<E> accountIds
The ID of the Amazon Web Services account.
List<E> organizationalUnitIds
The ID of the organizational unit.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
Integer maxResults
The maximum number of results to return with a single call. To retrieve the remaining results, make another call
with the returned nextToken value.
List<E> cloudFormation
The returned CloudFormationHealthOverview object that contains an InsightHealthOverview
object with the requested system health information.
List<E> service
An array of ServiceHealth objects that describes the health of the Amazon Web Services services
associated with the resources in the collection.
List<E> account
The name of the organization's account.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
List<E> tags
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or
Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production,
or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag
values are case-sensitive.
Together these are known as key-value pairs.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
String resourceCollectionType
An Amazon Web Services resource collection type. This type specifies how analyzed Amazon Web Services resources are defined. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
List<E> cloudFormation
The returned CloudFormationHealthOverview object that contains an InsightHealthOverview
object with the requested system health information.
List<E> service
An array of ServiceHealth objects that describes the health of the Amazon Web Services services
associated with the resources in the collection.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
List<E> tags
The Amazon Web Services tags that are used by resources in the resource collection.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or
Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production,
or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag
values are case-sensitive.
Together these are known as key-value pairs.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
ServiceIntegrationConfig serviceIntegration
ResourceCollection resourceCollection
String id
The ID of the event.
Date time
A Timestamp that specifies the time the event occurred.
String eventSource
The Amazon Web Services source that emitted the event.
String name
The name of the event.
String dataSource
The source, AWS_CLOUD_TRAIL or AWS_CODE_DEPLOY, where DevOps Guru analysis found the
event.
String eventClass
The class of the event. The class specifies what the event is related to, such as an infrastructure change, a deployment, or a schema change.
List<E> resources
An EventResource object that contains information about the resource that emitted the event.
AmazonCodeGuruProfilerIntegration amazonCodeGuruProfiler
Information about whether DevOps Guru is configured to consume recommendations which are generated from AWS CodeGuru Profiler.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
CostEstimationResourceCollectionFilter resourceCollection
The collection of the Amazon Web Services resources used to create your monthly DevOps Guru cost estimate.
String status
The status of creating this cost estimate. If it's still in progress, the status ONGOING is
returned. If it is finished, the status COMPLETED is returned.
List<E> costs
An array of ResourceCost objects that each contains details about the monthly cost estimate to
analyze one of your Amazon Web Services resources.
CostEstimationTimeRange timeRange
The start and end time of the cost estimation.
Double totalCost
The estimated monthly cost to analyze the Amazon Web Services resources. This value is the sum of the estimated
costs to analyze each resource in the Costs object in this response.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
String resourceCollectionType
The type of Amazon Web Services resource collections to return. The one valid value is
CLOUD_FORMATION for Amazon Web Services CloudFormation stacks.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
ResourceCollectionFilter resourceCollection
The requested list of Amazon Web Services resource collections. The two types of Amazon Web Services resource collections supported are Amazon Web Services CloudFormation stacks and Amazon Web Services resources that contain the same Amazon Web Services tag. DevOps Guru can be configured to analyze the Amazon Web Services resources that are defined in the stacks or that are tagged using the same tag key. You can specify up to 500 Amazon Web Services CloudFormation stacks.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
Integer retryAfterSeconds
The number of seconds after which the action that caused the internal server exception can be retried.
ServiceCollection serviceCollection
String insightId
The ID of the insight. The returned anomalies belong to this insight.
StartTimeRange startTimeRange
A time range used to specify when the requested anomalies started. All returned anomalies started during this time range.
Integer maxResults
The maximum number of results to return with a single call. To retrieve the remaining results, make another call
with the returned nextToken value.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
String accountId
The ID of the Amazon Web Services account.
ListAnomaliesForInsightFilters filters
Specifies one or more service names that are used to list anomalies.
List<E> proactiveAnomalies
An array of ProactiveAnomalySummary objects that represent the requested anomalies
List<E> reactiveAnomalies
An array of ReactiveAnomalySummary objects that represent the requested anomalies
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
String insightId
The ID of the insight containing the log groups.
Integer maxResults
The maximum number of results to return with a single call. To retrieve the remaining results, make another call
with the returned nextToken value.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
String insightId
The ID of the insight containing the log groups.
List<E> anomalousLogGroups
The list of Amazon CloudWatch log groups that are related to an insight.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
String insightId
An ID of an insight that is related to the events you want to filter for.
EventTimeRange eventTimeRange
A time range during which you want the filtered events to have occurred.
String eventClass
The class of the events you want to filter for, such as an infrastructure change, a deployment, or a schema change.
String eventSource
The Amazon Web Services source that emitted the events you want to filter for.
String dataSource
The source, AWS_CLOUD_TRAIL or AWS_CODE_DEPLOY, of the events you want returned.
ResourceCollection resourceCollection
ListEventsFilters filters
A ListEventsFilters object used to specify which events to return.
Integer maxResults
The maximum number of results to return with a single call. To retrieve the remaining results, make another call
with the returned nextToken value.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
String accountId
The ID of the Amazon Web Services account.
String type
Use to filter for either REACTIVE or PROACTIVE insights.
StartTimeRange startTimeRange
A time range used to specify when the behavior of the filtered insights started.
String type
Use to filter for either REACTIVE or PROACTIVE insights.
EndTimeRange endTimeRange
A time range used to specify when the behavior of the filtered insights ended.
String type
Use to filter for either REACTIVE or PROACTIVE insights.
ListInsightsStatusFilter statusFilter
A filter used to filter the returned insights by their status. You can specify one status filter.
Integer maxResults
The maximum number of results to return with a single call. To retrieve the remaining results, make another call
with the returned nextToken value.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
List<E> proactiveInsights
The returned list of proactive insights.
List<E> reactiveInsights
The returned list of reactive insights.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
ListInsightsOngoingStatusFilter ongoing
A ListInsightsAnyStatusFilter that specifies ongoing insights that are either REACTIVE
or PROACTIVE.
ListInsightsClosedStatusFilter closed
A ListInsightsClosedStatusFilter that specifies closed insights that are either
REACTIVE or PROACTIVE.
ListInsightsAnyStatusFilter any
A ListInsightsAnyStatusFilter that specifies insights of any status that are either
REACTIVE or PROACTIVE.
ListMonitoredResourcesFilters filters
Filters to determine which monitored resources you want to retrieve. You can filter by resource type or resource permission status.
Integer maxResults
The maximum number of results to return with a single call. To retrieve the remaining results, make another call
with the returned nextToken value.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
List<E> monitoredResourceIdentifiers
Information about the resource that is being monitored, including the name of the resource, the type of resource, and whether or not permission is given to DevOps Guru to access that resource.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
ListInsightsStatusFilter statusFilter
Integer maxResults
The maximum number of results to return with a single call. To retrieve the remaining results, make another call
with the returned nextToken value.
List<E> accountIds
The ID of the Amazon Web Services account.
List<E> organizationalUnitIds
The ID of the organizational unit.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
List<E> proactiveInsights
An integer that specifies the number of open proactive insights in your Amazon Web Services account.
List<E> reactiveInsights
An integer that specifies the number of open reactive insights in your Amazon Web Services account.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
String insightId
The ID of the requested insight.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
String locale
A locale that specifies the language to use for recommendations.
String accountId
The ID of the Amazon Web Services account.
String logStreamName
The name of the Amazon CloudWatch log stream that the anomalous log event belongs to. A log stream is a sequence of log events that share the same source.
String logAnomalyType
The type of log anomaly that has been detected.
String logAnomalyToken
The token where the anomaly was detected. This may refer to an exception or another location, or it may be blank for log anomalies such as format anomalies.
String logEventId
The ID of the log event.
String explanation
The explanation for why the log event is considered an anomaly.
Integer numberOfLogLinesOccurrences
The number of log lines where this anomalous log event occurs.
Date logEventTimestamp
The time of the first occurrence of the anomalous log event.
String optInStatus
Specifies if DevOps Guru is configured to perform log anomaly detection on CloudWatch log groups.
String optInStatus
Specifies if DevOps Guru is configured to perform log anomaly detection on CloudWatch log groups.
String monitoredResourceName
The name of the resource being monitored.
String type
The type of resource being monitored.
String resourcePermission
The permission status of a resource.
Date lastUpdated
The time at which DevOps Guru last updated this resource.
ResourceCollection resourceCollection
String id
The ID of a notification channel.
NotificationChannelConfig config
A NotificationChannelConfig object that contains information about configured notification channels.
SnsChannelConfig sns
Information about a notification channel configured in DevOps Guru to send notifications when insights are created.
If you use an Amazon SNS topic in another account, you must attach a policy to it that grants DevOps Guru permission to it notifications. DevOps Guru adds the required policy on your behalf to send notifications using Amazon SNS in your account. DevOps Guru only supports standard SNS topics. For more information, see Permissions for cross account Amazon SNS topics.
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 Amazon Web Services Key Management Service customer-managed key (CMK), then you must add permissions to the CMK. For more information, see Permissions for Amazon Web Services KMS–encrypted Amazon SNS topics.
NotificationFilterConfig filters
The filter configurations for the Amazon SNS notification topic you use with DevOps Guru. If you do not provide
filter configurations, the default configurations are to receive notifications for all message types of
High or Medium severity.
List<E> severities
The severity levels that you want to receive notifications for. For example, you can choose to receive
notifications only for insights with HIGH and MEDIUM severity levels. For more
information, see Understanding insight severities.
List<E> messageTypes
The events that you want to receive notifications for. For example, you can choose to receive notifications only when the severity level is upgraded or a new insight is created.
String optInStatus
Specifies if DevOps Guru is enabled to create an Amazon Web Services Systems Manager OpsItem for each created insight.
String optInStatus
Specifies if DevOps Guru is enabled to create an Amazon Web Services Systems Manager OpsItem for each created insight.
String group
The name of the dimension group. Its valid values are:
db - The name of the database to which the client is connected (only Aurora PostgreSQL, Amazon RDS
PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.application - The name of the application that is connected to the database (only Aurora
PostgreSQL and RDS PostgreSQL)
db.host - The host name of the connected client (all engines)
db.session_type - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql - The SQL that is currently executing (all engines)
db.sql_tokenized - The SQL digest (all engines)
db.wait_event - The event for which the database backend is waiting (all engines)
db.wait_event_type - The type of event for which the database backend is waiting (all engines)
db.user - The user logged in to the database (all engines)
List<E> dimensions
A list of specific dimensions from a dimension group. If this parameter is not present, then it signifies that all of the dimensions in the group were requested or are present in the response.
Valid values for elements in the Dimensions array are:
db.application.name - The name of the application that is connected to the database (only Aurora
PostgreSQL and RDS PostgreSQL)
db.host.id - The host ID of the connected client (all engines)
db.host.name - The host name of the connected client (all engines)
db.name - The name of the database to which the client is connected (only Aurora PostgreSQL, Amazon
RDS PostgreSQL, Aurora MySQL, Amazon RDS MySQL, and MariaDB)
db.session_type.name - The type of the current session (only Aurora PostgreSQL and RDS PostgreSQL)
db.sql.id - The SQL ID generated by Performance Insights (all engines)
db.sql.db_id - The SQL ID generated by the database (all engines)
db.sql.statement - The SQL text that is being executed (all engines)
db.sql.tokenized_id
db.sql_tokenized.id - The SQL digest ID generated by Performance Insights (all engines)
db.sql_tokenized.db_id - SQL digest ID generated by the database (all engines)
db.sql_tokenized.statement - The SQL digest text (all engines)
db.user.id - The ID of the user logged in to the database (all engines)
db.user.name - The name of the user logged in to the database (all engines)
db.wait_event.name - The event for which the backend is waiting (all engines)
db.wait_event.type - The type of event for which the backend is waiting (all engines)
db.wait_event_type.name - The name of the event type for which the backend is waiting (all engines)
Integer limit
The maximum number of items to fetch for this dimension group.
String metric
The name of the meteric used used when querying an Performance Insights GetResourceMetrics API for
anomaly metrics.
Valid values for Metric are:
db.load.avg - a scaled representation of the number of active sessions for the database engine.
db.sampledload.avg - the raw number of active sessions for the database engine.
If the number of active sessions is less than an internal Performance Insights threshold,
db.load.avg and db.sampledload.avg are the same value. If the number of active sessions
is greater than the internal threshold, Performance Insights samples the active sessions, with
db.load.avg showing the scaled values, db.sampledload.avg showing the raw values, and
db.sampledload.avg less than db.load.avg. For most use cases, you can query
db.load.avg only.
PerformanceInsightsMetricDimensionGroup groupBy
The specification for how to aggregate the data points from a Performance Insights
GetResourceMetrics API query. The Performance Insights query returns all of the dimensions within
that group, unless you provide the names of specific dimensions within that group. You can also request that
Performance Insights return a limited number of values for a dimension.
Map<K,V> filter
One or more filters to apply to a Performance Insights GetResourceMetrics API query. Restrictions:
Any number of filters by the same dimension, as specified in the GroupBy parameter.
A single filter for any other dimension in this dimension group.
String metricDisplayName
The name used for a specific Performance Insights metric.
String unit
The unit of measure for a metric. For example, a session or a process.
PerformanceInsightsMetricQuery metricQuery
A single query to be processed for the metric. For more information, see
PerformanceInsightsMetricQuery
.
List<E> referenceData
For more information, see
PerformanceInsightsReferenceData
.
List<E> statsAtAnomaly
The metric statistics during the anomalous period detected by DevOps Guru;
List<E> statsAtBaseline
Typical metric statistics that are not considered anomalous. When DevOps Guru analyzes metrics, it compares them
to StatsAtBaseline to help determine if they are anomalous.
PerformanceInsightsReferenceScalar referenceScalar
A scalar value DevOps Guru for a metric that DevOps Guru compares to actual metric values. This reference value is used to determine if an actual metric value should be considered anomalous.
PerformanceInsightsReferenceMetric referenceMetric
A metric that DevOps Guru compares to actual metric values. This reference metric is used to determine if an actual metric should be considered anomalous.
String name
The name of the reference data.
PerformanceInsightsReferenceComparisonValues comparisonValues
The specific reference values used to evaluate the Performance Insights. For more information, see
PerformanceInsightsReferenceComparisonValues
.
PerformanceInsightsMetricQuery metricQuery
A query to be processed on the metric.
Double value
The reference value.
String id
The ID of a proactive anomaly.
String severity
The severity of the anomaly. The severity of anomalies that generate an insight determine that insight's severity. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
String status
The status of a proactive anomaly.
Date updateTime
The time of the anomaly's most recent update.
AnomalyTimeRange anomalyTimeRange
AnomalyReportedTimeRange anomalyReportedTimeRange
An AnomalyReportedTimeRange object that specifies the time range between when the anomaly is opened
and the time when it is closed.
PredictionTimeRange predictionTimeRange
AnomalySourceDetails sourceDetails
Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
String associatedInsightId
The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
ResourceCollection resourceCollection
Double limit
A threshold that was exceeded by behavior in analyzed resources. Exceeding this threshold is related to the anomalous behavior that generated this anomaly.
AnomalySourceMetadata sourceMetadata
The metadata for the anomaly.
List<E> anomalyResources
Information about a resource in which DevOps Guru detected anomalous behavior.
String description
A description of the proactive anomaly.
String id
The ID of the anomaly.
String severity
The severity of the anomaly. The severity of anomalies that generate an insight determine that insight's severity. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
String status
The status of the anomaly.
Date updateTime
The time of the anomaly's most recent update.
AnomalyTimeRange anomalyTimeRange
AnomalyReportedTimeRange anomalyReportedTimeRange
An AnomalyReportedTimeRange object that specifies the time range between when the anomaly is opened
and the time when it is closed.
PredictionTimeRange predictionTimeRange
AnomalySourceDetails sourceDetails
Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
String associatedInsightId
The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
ResourceCollection resourceCollection
Double limit
A threshold that was exceeded by behavior in analyzed resources. Exceeding this threshold is related to the anomalous behavior that generated this anomaly.
AnomalySourceMetadata sourceMetadata
The metadata of the source which detects proactive anomalies.
List<E> anomalyResources
Information about a resource in which DevOps Guru detected anomalous behavior.
String description
A description of the proactive anomaly.
String id
The ID of the proactive insight.
String name
The name of the proactive insight.
String severity
The severity of the insight. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
String status
The status of the proactive insight.
InsightTimeRange insightTimeRange
PredictionTimeRange predictionTimeRange
ResourceCollection resourceCollection
String ssmOpsItemId
The ID of the Amazon Web Services System Manager OpsItem created for this insight. You must enable the creation of OpstItems insights before they are created for each insight.
String description
Describes the proactive insight.
String id
The ID of the proactive insight.
String name
The name of the proactive insight.
String severity
The severity of the insight. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
String status
The status of the proactive insight.
InsightTimeRange insightTimeRange
PredictionTimeRange predictionTimeRange
ResourceCollection resourceCollection
ServiceCollection serviceCollection
A collection of the names of Amazon Web Services services.
List<E> associatedResourceArns
The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight.
String id
The ID of the insight summary.
String accountId
The ID of the Amazon Web Services account.
String organizationalUnitId
The ID of the organizational unit.
String name
The name of the insight summary.
String severity
An array of severity values used to search for insights. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
String status
An array of status values used to search for insights.
InsightTimeRange insightTimeRange
PredictionTimeRange predictionTimeRange
ResourceCollection resourceCollection
ServiceCollection serviceCollection
InsightFeedback insightFeedback
The feedback from customers is about the recommendations in this insight.
String id
The ID of the reactive anomaly.
String severity
The severity of the anomaly. The severity of anomalies that generate an insight determine that insight's severity. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
String status
The status of the anomaly.
AnomalyTimeRange anomalyTimeRange
AnomalyReportedTimeRange anomalyReportedTimeRange
An AnomalyReportedTimeRange object that specifies the time range between when the anomaly is opened
and the time when it is closed.
AnomalySourceDetails sourceDetails
Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
String associatedInsightId
The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
ResourceCollection resourceCollection
String type
The type of the reactive anomaly. It can be one of the following types.
CAUSAL - the anomaly can cause a new insight.
CONTEXTUAL - the anomaly contains additional information about an insight or its causal anomaly.
String name
The name of the reactive anomaly.
String description
A description of the reactive anomaly.
String causalAnomalyId
The ID of the causal anomaly that is associated with this reactive anomaly. The ID of a `CAUSAL` anomaly is always `NULL`.
List<E> anomalyResources
The Amazon Web Services resources in which anomalous behavior was detected by DevOps Guru.
String id
The ID of the reactive anomaly.
String severity
The severity of the anomaly. The severity of anomalies that generate an insight determine that insight's severity. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
String status
The status of the reactive anomaly.
AnomalyTimeRange anomalyTimeRange
AnomalyReportedTimeRange anomalyReportedTimeRange
An AnomalyReportedTimeRange object that specifies the time range between when the anomaly is opened
and the time when it is closed.
AnomalySourceDetails sourceDetails
Details about the source of the analyzed operational data that triggered the anomaly. The one supported source is Amazon CloudWatch metrics.
String associatedInsightId
The ID of the insight that contains this anomaly. An insight is composed of related anomalies.
ResourceCollection resourceCollection
String type
The type of the reactive anomaly. It can be one of the following types.
CAUSAL - the anomaly can cause a new insight.
CONTEXTUAL - the anomaly contains additional information about an insight or its causal anomaly.
String name
The name of the reactive anomaly.
String description
A description of the reactive anomaly.
String causalAnomalyId
The ID of the causal anomaly that is associated with this reactive anomaly. The ID of a `CAUSAL` anomaly is always `NULL`.
List<E> anomalyResources
The Amazon Web Services resources in which anomalous behavior was detected by DevOps Guru.
String id
The ID of a reactive insight.
String name
The name of a reactive insight.
String severity
The severity of the insight. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
String status
The status of a reactive insight.
InsightTimeRange insightTimeRange
ResourceCollection resourceCollection
String ssmOpsItemId
The ID of the Amazon Web Services System Manager OpsItem created for this insight. You must enable the creation of OpstItems insights before they are created for each insight.
String description
Describes the reactive insight.
String id
The ID of a reactive summary.
String name
The name of a reactive insight.
String severity
The severity of the insight. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
String status
The status of a reactive insight.
InsightTimeRange insightTimeRange
ResourceCollection resourceCollection
ServiceCollection serviceCollection
A collection of the names of Amazon Web Services services.
List<E> associatedResourceArns
The Amazon Resource Names (ARNs) of the Amazon Web Services resources that generated this insight.
String id
The ID of the insight summary.
String accountId
The ID of the Amazon Web Services account.
String organizationalUnitId
The ID of the organizational unit.
String name
The name of the insight summary.
String severity
An array of severity values used to search for insights. For more information, see Understanding insight severities in the Amazon DevOps Guru User Guide.
String status
An array of status values used to search for insights.
InsightTimeRange insightTimeRange
ResourceCollection resourceCollection
ServiceCollection serviceCollection
String description
A description of the problem.
String link
A hyperlink to information to help you address the problem.
String name
The name of the recommendation.
String reason
The reason DevOps Guru flagged the anomalous behavior as a problem.
List<E> relatedEvents
Events that are related to the problem. Use these events to learn more about what's happening and to help address the issue.
List<E> relatedAnomalies
Anomalies that are related to the problem. Use these Anomalies to learn more about what's happening and to help address the issue.
String category
The category type of the recommendation.
List<E> resources
An array of objects that represent resources in which DevOps Guru detected anomalous behavior. Each object contains the name and type of the resource.
List<E> sourceDetails
Information about where the anomalous behavior related the recommendation was found. For example, details in Amazon CloudWatch metrics.
String anomalyId
The ID of an anomaly that generated the insight with this recommendation.
String name
The name of the resource.
String type
The type of the resource. Resource types take the same form that is used by Amazon Web Services CloudFormation
resource type identifiers, service-provider::service-name::data-type-name. For example,
AWS::RDS::DBCluster. For more information, see Amazon
Web Services resource and property types reference in the Amazon Web Services CloudFormation User
Guide.
String id
The ID of the notification channel to be removed.
CloudFormationCollection cloudFormation
An array of the names of Amazon Web Services CloudFormation stacks. The stacks define Amazon Web Services resources that DevOps Guru analyzes. You can specify up to 500 Amazon Web Services CloudFormation stacks.
List<E> tags
The Amazon Web Services tags that are used by resources in the resource collection.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or
Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production,
or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag
values are case-sensitive.
Together these are known as key-value pairs.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
CloudFormationCollectionFilter cloudFormation
Information about Amazon Web Services CloudFormation stacks. You can use up to 500 stacks to specify which Amazon Web Services resources in your account to analyze. For more information, see Stacks in the Amazon Web Services CloudFormation User Guide.
List<E> tags
The Amazon Web Services tags used to filter the resources in the resource collection.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or
Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production,
or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag
values are case-sensitive.
Together these are known as key-value pairs.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
List<E> severities
An array of severity values used to search for insights.
List<E> statuses
An array of status values used to search for insights.
ResourceCollection resourceCollection
ServiceCollection serviceCollection
A collection of the names of Amazon Web Services services.
StartTimeRange startTimeRange
The start of the time range passed in. Returned insights occurred after this time.
SearchInsightsFilters filters
A SearchInsightsFilters object that is used to set the severity and status filters on your insight
search.
Integer maxResults
The maximum number of results to return with a single call. To retrieve the remaining results, make another call
with the returned nextToken value.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
String type
The type of insights you are searching for (REACTIVE or PROACTIVE).
List<E> proactiveInsights
The returned proactive insights.
List<E> reactiveInsights
The returned reactive insights.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
List<E> severities
An array of severity values used to search for insights.
List<E> statuses
An array of status values used to search for insights.
ResourceCollection resourceCollection
ServiceCollection serviceCollection
List<E> accountIds
The ID of the Amazon Web Services account.
StartTimeRange startTimeRange
SearchOrganizationInsightsFilters filters
A SearchOrganizationInsightsFilters object that is used to set the severity and status filters on
your insight search.
Integer maxResults
The maximum number of results to return with a single call. To retrieve the remaining results, make another call
with the returned nextToken value.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.
String type
The type of insights you are searching for (REACTIVE or PROACTIVE).
List<E> proactiveInsights
An integer that specifies the number of open proactive insights in your Amazon Web Services account.
List<E> reactiveInsights
An integer that specifies the number of open reactive insights in your Amazon Web Services account.
String nextToken
The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.
String serviceName
The name of the Amazon Web Services service.
ServiceInsightHealth insight
Represents the health of an Amazon Web Services service. This is a ServiceInsightHealth that
contains the number of open proactive and reactive insights for this service.
Long analyzedResourceCount
Number of resources that DevOps Guru is monitoring in an analyzed Amazon Web Services service.
OpsCenterIntegration opsCenter
Information about whether DevOps Guru is configured to create an OpsItem in Amazon Web Services Systems Manager OpsCenter for each created insight.
LogsAnomalyDetectionIntegration logsAnomalyDetection
Information about whether DevOps Guru is configured to perform log anomaly detection on Amazon CloudWatch log groups.
String type
The type of the Amazon Web Services resource.
String state
The state of the resource. The resource is ACTIVE if it produces metrics, events, or logs within an
hour, otherwise it is INACTIVE. You pay for the number of active Amazon Web Services resource hours
analyzed for each resource. Inactive resources are not charged.
Integer count
The number of active resources analyzed for this service to create a monthly cost estimate.
Double unitCost
The price per hour to analyze the resources in the service. For more information, see Estimate your Amazon DevOps Guru costs and Amazon DevOps Guru pricing.
Double cost
The total estimated monthly cost to analyze the active resources for this resource.
String topicArn
The Amazon Resource Name (ARN) of an Amazon Simple Notification Service topic.
CostEstimationResourceCollectionFilter resourceCollection
The collection of Amazon Web Services resources used to create a monthly DevOps Guru cost estimate.
String clientToken
The idempotency token used to identify each cost estimate request.
String appBoundaryKey
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
List<E> tagValues
The values in an Amazon Web Services tag collection.
The tag's value is an optional field used to associate a string with the tag key (for example,
111122223333, Production, or a team name). The key and value are the
tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys,
tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
String appBoundaryKey
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
List<E> tagValues
The values in an Amazon Web Services tag collection.
The tag's value is an optional field used to associate a string with the tag key (for example,
111122223333, Production, or a team name). The key and value are the
tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys,
tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
String appBoundaryKey
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
List<E> tagValues
The values in an Amazon Web Services tag collection.
The tag's value is an optional field used to associate a string with the tag key (for example,
111122223333, Production, or a team name). The key and value are the
tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys,
tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
String appBoundaryKey
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
String tagValue
The value in an Amazon Web Services tag.
The tag's value is an optional field used to associate a string with the tag key (for example,
111122223333, Production, or a team name). The key and value are the
tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys,
tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
InsightHealth insight
Information about the health of the Amazon Web Services resources in your account that are specified by an Amazon Web Services tag, including the number of open proactive, open reactive insights, and the Mean Time to Recover (MTTR) of closed insights.
Long analyzedResourceCount
Number of resources that DevOps Guru is monitoring in your account that are specified by an Amazon Web Services tag.
String quotaCode
The code of the quota that was exceeded, causing the throttling exception.
String serviceCode
The code of the service that caused the throttling exception.
Integer retryAfterSeconds
The number of seconds after which the action that caused the throttling exception can be retried.
EventSourcesConfig eventSources
Configuration information about the integration of DevOps Guru as the Consumer via EventBridge with another AWS Service.
UpdateCloudFormationCollectionFilter cloudFormation
A collection of Amazon Web Services CloudFormation stacks. You can specify up to 500 Amazon Web Services CloudFormation stacks.
List<E> tags
The updated Amazon Web Services tags used to filter the resources in the resource collection.
Tags help you identify and organize your Amazon Web Services resources. Many Amazon Web Services services support tagging, so you can assign the same tag to resources from different services to indicate that the resources are related. For example, you can assign the same tag to an Amazon DynamoDB table resource that you assign to an Lambda function. For more information about using tags, see the Tagging best practices whitepaper.
Each Amazon Web Services tag has two parts.
A tag key (for example, CostCenter, Environment, Project, or
Secret). Tag keys are case-sensitive.
An optional field known as a tag value (for example, 111122223333, Production,
or a team name). Omitting the tag value is the same as using an empty string. Like tag keys, tag
values are case-sensitive.
Together these are known as key-value pairs.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
String action
Specifies if the resource collection in the request is added or deleted to the resource collection.
UpdateResourceCollectionFilter resourceCollection
OpsCenterIntegrationConfig opsCenter
LogsAnomalyDetectionIntegrationConfig logsAnomalyDetection
Information about whether DevOps Guru is configured to perform log anomaly detection on Amazon CloudWatch log groups.
UpdateServiceIntegrationConfig serviceIntegration
An IntegratedServiceConfig object used to specify the integrated service you want to update, and
whether you want to update it to enabled or disabled.
String appBoundaryKey
An Amazon Web Services tag key that is used to identify the Amazon Web Services resources that DevOps Guru analyzes. All Amazon Web Services resources in your account and Region tagged with this key make up your DevOps Guru application and analysis boundary.
The string used for a key in a tag that you use to define your resource coverage must begin with the
prefix Devops-guru-. The tag key might be DevOps-Guru-deployment-application or
devops-guru-rds-application. When you create a key, the case of characters in the key
can be whatever you choose. After you create a key, it is case-sensitive. For example, DevOps Guru works
with a key named devops-guru-rds and a key named DevOps-Guru-RDS, and
these act as two different keys. Possible key/value pairs in your application might be
Devops-Guru-production-application/RDS or Devops-Guru-production-application/containers
.
List<E> tagValues
The values in an Amazon Web Services tag collection.
The tag's value is an optional field used to associate a string with the tag key (for example,
111122223333, Production, or a team name). The key and value are the
tag's key pair. Omitting the tag value is the same as using an empty string. Like tag keys,
tag values are case-sensitive. You can specify a maximum of 256 characters for a tag value.
Copyright © 2023. All rights reserved.