From b1dd7d1f9683666b6dc2271db2846368d5e9c8e3 Mon Sep 17 00:00:00 2001 From: awssdkgo Date: Tue, 17 Aug 2021 18:17:54 +0000 Subject: [PATCH] Release v1.40.24 (2021-08-17) === ### Service Client Updates * `service/ce`: Updates service API and documentation * `service/cloud9`: Updates service API and documentation * Added DryRun parameter to CreateEnvironmentEC2 API. Added ManagedCredentialsActions parameter to UpdateEnvironment API * `service/clouddirectory`: Updates service documentation * Documentation updates for clouddirectory * `service/ec2`: Updates service API and documentation * This release adds support for EC2 ED25519 key pairs for authentication * `service/logs`: Updates service documentation * Documentation-only update for CloudWatch Logs --- CHANGELOG.md | 14 + aws/version.go | 2 +- models/apis/ce/2017-10-25/api-2.json | 68 +- models/apis/ce/2017-10-25/docs-2.json | 687 +++++----- models/apis/cloud9/2017-09-23/api-2.json | 14 +- models/apis/cloud9/2017-09-23/docs-2.json | 12 + .../clouddirectory/2017-01-11/docs-2.json | 24 +- models/apis/ec2/2016-11-15/api-2.json | 12 + models/apis/ec2/2016-11-15/docs-2.json | 21 +- models/apis/logs/2014-03-28/docs-2.json | 48 +- service/cloud9/api.go | 47 + service/clouddirectory/api.go | 292 +++- service/clouddirectory/errors.go | 4 +- service/cloudwatchlogs/api.go | 130 +- service/cloudwatchlogs/doc.go | 10 +- service/cloudwatchlogs/errors.go | 3 +- service/costexplorer/api.go | 1211 ++++++++++------- service/costexplorer/doc.go | 12 +- service/ec2/api.go | 103 +- 19 files changed, 1728 insertions(+), 986 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 6b4f9926f44..b1d940e4864 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,17 @@ +Release v1.40.24 (2021-08-17) +=== + +### Service Client Updates +* `service/ce`: Updates service API and documentation +* `service/cloud9`: Updates service API and documentation + * Added DryRun parameter to CreateEnvironmentEC2 API. Added ManagedCredentialsActions parameter to UpdateEnvironment API +* `service/clouddirectory`: Updates service documentation + * Documentation updates for clouddirectory +* `service/ec2`: Updates service API and documentation + * This release adds support for EC2 ED25519 key pairs for authentication +* `service/logs`: Updates service documentation + * Documentation-only update for CloudWatch Logs + Release v1.40.23 (2021-08-16) === diff --git a/aws/version.go b/aws/version.go index 32debd633c5..2a9ad155f95 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.40.23" +const SDKVersion = "1.40.24" diff --git a/models/apis/ce/2017-10-25/api-2.json b/models/apis/ce/2017-10-25/api-2.json index f49916099ad..bf3053d0507 100644 --- a/models/apis/ce/2017-10-25/api-2.json +++ b/models/apis/ce/2017-10-25/api-2.json @@ -585,6 +585,7 @@ "Name":{"shape":"CostCategoryName"}, "RuleVersion":{"shape":"CostCategoryRuleVersion"}, "Rules":{"shape":"CostCategoryRulesList"}, + "SplitChargeRules":{"shape":"CostCategorySplitChargeRulesList"}, "ProcessingStatus":{"shape":"CostCategoryProcessingStatusList"}, "DefaultValue":{"shape":"CostCategoryValue"} } @@ -672,6 +673,67 @@ "max":500, "min":1 }, + "CostCategorySplitChargeMethod":{ + "type":"string", + "enum":[ + "FIXED", + "PROPORTIONAL", + "EVEN" + ] + }, + "CostCategorySplitChargeRule":{ + "type":"structure", + "required":[ + "Source", + "Targets", + "Method" + ], + "members":{ + "Source":{"shape":"GenericString"}, + "Targets":{"shape":"CostCategorySplitChargeRuleTargetsList"}, + "Method":{"shape":"CostCategorySplitChargeMethod"}, + "Parameters":{"shape":"CostCategorySplitChargeRuleParametersList"} + } + }, + "CostCategorySplitChargeRuleParameter":{ + "type":"structure", + "required":[ + "Type", + "Values" + ], + "members":{ + "Type":{"shape":"CostCategorySplitChargeRuleParameterType"}, + "Values":{"shape":"CostCategorySplitChargeRuleParameterValuesList"} + } + }, + "CostCategorySplitChargeRuleParameterType":{ + "type":"string", + "enum":["ALLOCATION_PERCENTAGES"] + }, + "CostCategorySplitChargeRuleParameterValuesList":{ + "type":"list", + "member":{"shape":"GenericString"}, + "max":500, + "min":1 + }, + "CostCategorySplitChargeRuleParametersList":{ + "type":"list", + "member":{"shape":"CostCategorySplitChargeRuleParameter"}, + "max":10, + "min":1 + }, + "CostCategorySplitChargeRuleTargetsList":{ + "type":"list", + "member":{"shape":"GenericString"}, + "max":500, + "min":1 + }, + "CostCategorySplitChargeRulesList":{ + "type":"list", + "member":{"shape":"CostCategorySplitChargeRule"}, + "max":10, + "min":1 + }, "CostCategoryStatus":{ "type":"string", "enum":[ @@ -786,7 +848,8 @@ "Name":{"shape":"CostCategoryName"}, "RuleVersion":{"shape":"CostCategoryRuleVersion"}, "Rules":{"shape":"CostCategoryRulesList"}, - "DefaultValue":{"shape":"CostCategoryValue"} + "DefaultValue":{"shape":"CostCategoryValue"}, + "SplitChargeRules":{"shape":"CostCategorySplitChargeRulesList"} } }, "CreateCostCategoryDefinitionResponse":{ @@ -2427,7 +2490,8 @@ "CostCategoryArn":{"shape":"Arn"}, "RuleVersion":{"shape":"CostCategoryRuleVersion"}, "Rules":{"shape":"CostCategoryRulesList"}, - "DefaultValue":{"shape":"CostCategoryValue"} + "DefaultValue":{"shape":"CostCategoryValue"}, + "SplitChargeRules":{"shape":"CostCategorySplitChargeRulesList"} } }, "UpdateCostCategoryDefinitionResponse":{ diff --git a/models/apis/ce/2017-10-25/docs-2.json b/models/apis/ce/2017-10-25/docs-2.json index f43c9463d0d..7c03040c9c5 100644 --- a/models/apis/ce/2017-10-25/docs-2.json +++ b/models/apis/ce/2017-10-25/docs-2.json @@ -1,6 +1,6 @@ { "version": "2.0", - "service": "

The Cost Explorer API enables you to programmatically query your cost and usage data. You can query for aggregated data such as total monthly costs or total daily usage. You can also query for granular data, such as the number of daily write operations for Amazon DynamoDB database tables in your production environment.

Service Endpoint

The Cost Explorer API provides the following endpoint:

For information about costs associated with the Cost Explorer API, see AWS Cost Management Pricing.

", + "service": "

You can use the Cost Explorer API to programmatically query your cost and usage data. You can query for aggregated data such as total monthly costs or total daily usage. You can also query for granular data. This might include the number of daily write operations for Amazon DynamoDB database tables in your production environment.

Service Endpoint

The Cost Explorer API provides the following endpoint:

For information about the costs that are associated with the Cost Explorer API, see Amazon Web Services Cost Management Pricing.

", "operations": { "CreateAnomalyMonitor": "

Creates a new cost anomaly detection monitor with the requested type and monitor specification.

", "CreateAnomalySubscription": "

Adds a subscription to a cost anomaly detection monitor. You can use each subscription to define subscribers with email or SNS notifications. Email subscribers can set a dollar threshold and a time frequency for receiving notifications.

", @@ -9,18 +9,18 @@ "DeleteAnomalySubscription": "

Deletes a cost anomaly subscription.

", "DeleteCostCategoryDefinition": "

Deletes a Cost Category. Expenses from this month going forward will no longer be categorized with this Cost Category.

", "DescribeCostCategoryDefinition": "

Returns the name, ARN, rules, definition, and effective dates of a Cost Category that's defined in the account.

You have the option to use EffectiveOn to return a Cost Category that is active on a specific date. If there is no EffectiveOn specified, you’ll see a Cost Category that is effective on the current date. If Cost Category is still effective, EffectiveEnd is omitted in the response.

", - "GetAnomalies": "

Retrieves all of the cost anomalies detected on your account, during the time period specified by the DateInterval object.

", + "GetAnomalies": "

Retrieves all of the cost anomalies detected on your account during the time period that's specified by the DateInterval object.

", "GetAnomalyMonitors": "

Retrieves the cost anomaly monitor definitions for your account. You can filter using a list of cost anomaly monitor Amazon Resource Names (ARNs).

", "GetAnomalySubscriptions": "

Retrieves the cost anomaly subscription objects for your account. You can filter using a list of cost anomaly monitor Amazon Resource Names (ARNs).

", - "GetCostAndUsage": "

Retrieves cost and usage metrics for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in AWS Organizations have access to all member accounts.

For information about filter limitations, see Quotas and restrictions in the Billing and Cost Management User Guide.

", - "GetCostAndUsageWithResources": "

Retrieves cost and usage metrics with resources for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in AWS Organizations have access to all member accounts. This API is currently available for the Amazon Elastic Compute Cloud – Compute service only.

This is an opt-in only feature. You can enable this feature from the Cost Explorer Settings page. For information on how to access the Settings page, see Controlling Access for Cost Explorer in the AWS Billing and Cost Management User Guide.

", + "GetCostAndUsage": "

Retrieves cost and usage metrics for your account. You can specify which cost and usage-related metric that you want the request to return. For example, you can specify BlendedCosts or UsageQuantity. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts.

For information about filter limitations, see Quotas and restrictions in the Billing and Cost Management User Guide.

", + "GetCostAndUsageWithResources": "

Retrieves cost and usage metrics with resources for your account. You can specify which cost and usage-related metric, such as BlendedCosts or UsageQuantity, that you want the request to return. You can also filter and group your data by various dimensions, such as SERVICE or AZ, in a specific time range. For a complete list of valid dimensions, see the GetDimensionValues operation. Management account in an organization in Organizations have access to all member accounts. This API is currently available for the Amazon Elastic Compute Cloud – Compute service only.

This is an opt-in only feature. You can enable this feature from the Cost Explorer Settings page. For information on how to access the Settings page, see Controlling Access for Cost Explorer in the Billing and Cost Management User Guide.

", "GetCostCategories": "

Retrieves an array of Cost Category names and values incurred cost.

If some Cost Category names and values are not associated with any cost, they will not be returned by this API.

", "GetCostForecast": "

Retrieves a forecast for how much Amazon Web Services predicts that you will spend over the forecast time period that you select, based on your past costs.

", "GetDimensionValues": "

Retrieves all available filter values for a specified filter over a period of time. You can search the dimension values for an arbitrary string.

", "GetReservationCoverage": "

Retrieves the reservation coverage for your account. This enables you to see how much of your Amazon Elastic Compute Cloud, Amazon ElastiCache, Amazon Relational Database Service, or Amazon Redshift usage is covered by a reservation. An organization's management account can see the coverage of the associated member accounts. This supports dimensions, Cost Categories, and nested expressions. For any time period, you can filter data about reservation usage by the following dimensions:

To determine valid values for a dimension, use the GetDimensionValues operation.

", - "GetReservationPurchaseRecommendation": "

Gets recommendations for which reservations to purchase. These recommendations could help you reduce your costs. Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing.

AWS generates your recommendations by identifying your On-Demand usage during a specific time period and collecting your usage into categories that are eligible for a reservation. After AWS has these categories, it simulates every combination of reservations in each category of usage to identify the best number of each type of RI to purchase to maximize your estimated savings.

For example, AWS automatically aggregates your Amazon EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible regional reservations to apply to the c4 family usage. AWS recommends the smallest size instance in an instance family. This makes it easier to purchase a size-flexible RI. AWS also shows the equal number of normalized units so that you can purchase any instance size that you want. For this example, your RI recommendation would be for c4.large because that is the smallest size instance in the c4 instance family.

", + "GetReservationPurchaseRecommendation": "

Gets recommendations for which reservations to purchase. These recommendations could help you reduce your costs. Reservations provide a discounted hourly rate (up to 75%) compared to On-Demand pricing.

Amazon Web Services generates your recommendations by identifying your On-Demand usage during a specific time period and collecting your usage into categories that are eligible for a reservation. After Amazon Web Services has these categories, it simulates every combination of reservations in each category of usage to identify the best number of each type of RI to purchase to maximize your estimated savings.

For example, Amazon Web Services automatically aggregates your Amazon EC2 Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region and recommends that you buy size-flexible regional reservations to apply to the c4 family usage. Amazon Web Services recommends the smallest size instance in an instance family. This makes it easier to purchase a size-flexible RI. Amazon Web Services also shows the equal number of normalized units so that you can purchase any instance size that you want. For this example, your RI recommendation would be for c4.large because that is the smallest size instance in the c4 instance family.

", "GetReservationUtilization": "

Retrieves the reservation utilization for your account. Management account in an organization have access to member accounts. You can filter data by dimensions in a time period. You can use GetDimensionValues to determine the possible dimension values. Currently, you can group only by SUBSCRIPTION_ID.

", - "GetRightsizingRecommendation": "

Creates recommendations that help you save cost by identifying idle and underutilized Amazon EC2 instances.

Recommendations are generated to either downsize or terminate instances, along with providing savings detail and metrics. For details on calculation and function, see Optimizing Your Cost with Rightsizing Recommendations in the AWS Billing and Cost Management User Guide.

", + "GetRightsizingRecommendation": "

Creates recommendations that help you save cost by identifying idle and underutilized Amazon EC2 instances.

Recommendations are generated to either downsize or terminate instances, along with providing savings detail and metrics. For details on calculation and function, see Optimizing Your Cost with Rightsizing Recommendations in the Billing and Cost Management User Guide.

", "GetSavingsPlansCoverage": "

Retrieves the Savings Plans covered for your account. This enables you to see how much of your cost is covered by a Savings Plan. An organization’s management account can see the coverage of the associated member accounts. This supports dimensions, Cost Categories, and nested expressions. For any time period, you can filter data for Savings Plans usage with the following dimensions:

To determine valid values for a dimension, use the GetDimensionValues operation.

", "GetSavingsPlansPurchaseRecommendation": "

Retrieves your request parameters, Savings Plan Recommendations Summary and Details.

", "GetSavingsPlansUtilization": "

Retrieves the Savings Plans utilization for your account across date ranges with daily or monthly granularity. Management account in an organization have access to member accounts. You can use GetDimensionValues in SAVINGS_PLANS to determine the possible dimension values.

You cannot group by any dimension values for GetSavingsPlansUtilization.

", @@ -29,8 +29,8 @@ "GetUsageForecast": "

Retrieves a forecast for how much Amazon Web Services predicts that you will use over the forecast time period that you select, based on your past usage.

", "ListCostCategoryDefinitions": "

Returns the name, ARN, NumberOfRules and effective dates of all Cost Categories defined in the account. You have the option to use EffectiveOn to return a list of Cost Categories that were active on a specific date. If there is no EffectiveOn specified, you’ll see Cost Categories that are effective on the current date. If Cost Category is still effective, EffectiveEnd is omitted in the response. ListCostCategoryDefinitions supports pagination. The request can have a MaxResults range up to 100.

", "ProvideAnomalyFeedback": "

Modifies the feedback property of a given cost anomaly.

", - "UpdateAnomalyMonitor": "

Updates an existing cost anomaly monitor. The changes made are applied going forward, and does not change anomalies detected in the past.

", - "UpdateAnomalySubscription": "

Updates an existing cost anomaly monitor subscription.

", + "UpdateAnomalyMonitor": "

Updates an existing cost anomaly monitor. The changes made are applied going forward, and doesn'tt change anomalies detected in the past.

", + "UpdateAnomalySubscription": "

Updates an existing cost anomaly monitor subscription.

", "UpdateCostCategoryDefinition": "

Updates an existing Cost Category. Changes made to the Cost Category rules will be used to categorize the current month’s expenses and future expenses. This won’t change categorization for the previous months.

" }, "shapes": { @@ -39,36 +39,36 @@ "refs": { "GetReservationPurchaseRecommendationRequest$AccountScope": "

The account scope that you want your recommendations for. Amazon Web Services calculates recommendations including the management account and member accounts if the value is set to PAYER. If the value is LINKED, recommendations are calculated for individual member accounts only.

", "GetSavingsPlansPurchaseRecommendationRequest$AccountScope": "

The account scope that you want your recommendations for. Amazon Web Services calculates recommendations including the management account and member accounts if the value is set to PAYER. If the value is LINKED, recommendations are calculated for individual member accounts only.

", - "ReservationPurchaseRecommendation$AccountScope": "

The account scope that AWS recommends that you purchase this instance for. For example, you can purchase this reservation for an entire organization in AWS Organizations.

", - "SavingsPlansPurchaseRecommendation$AccountScope": "

The account scope that you want your recommendations for. Amazon Web Services calculates recommendations including the management account and member accounts if the value is set to PAYER. If the value is LINKED, recommendations are calculated for individual member accounts only.

" + "ReservationPurchaseRecommendation$AccountScope": "

The account scope that Amazon Web Services recommends that you purchase this instance for. For example, you can purchase this reservation for an entire organization in Amazon Web Services Organizations.

", + "SavingsPlansPurchaseRecommendation$AccountScope": "

The account scope that you want your recommendations for. Amazon Web Services calculates recommendations that include the management account and member accounts if the value is set to PAYER. If the value is LINKED, recommendations are calculated for individual member accounts only.

" } }, "AmortizedRecurringFee": { "base": null, "refs": { - "ReservationAggregates$AmortizedRecurringFee": "

The monthly cost of your reservation, amortized over the reservation period.

" + "ReservationAggregates$AmortizedRecurringFee": "

The monthly cost of your reservation. It's amortized over the reservation period.

" } }, "AmortizedUpfrontFee": { "base": null, "refs": { - "ReservationAggregates$AmortizedUpfrontFee": "

The upfront cost of your reservation, amortized over the reservation period.

" + "ReservationAggregates$AmortizedUpfrontFee": "

The upfront cost of your reservation. It's amortized over the reservation period.

" } }, "Anomalies": { "base": null, "refs": { - "GetAnomaliesResponse$Anomalies": "

A list of cost anomalies.

" + "GetAnomaliesResponse$Anomalies": "

A list of cost anomalies.

" } }, "Anomaly": { - "base": "

An unusual cost pattern. This consists of the detailed metadata and the current status of the anomaly object.

", + "base": "

An unusual cost pattern. This consists of the detailed metadata and the current status of the anomaly object.

", "refs": { "Anomalies$member": null } }, "AnomalyDateInterval": { - "base": "

The time period for an anomaly.

", + "base": "

The time period for an anomaly.

", "refs": { "GetAnomaliesRequest$DateInterval": "

Assigns the start and end dates for retrieving cost anomalies. The returned anomaly object will have an AnomalyEndDate in the specified time range.

" } @@ -76,55 +76,55 @@ "AnomalyFeedbackType": { "base": null, "refs": { - "Anomaly$Feedback": "

The feedback value.

", + "Anomaly$Feedback": "

The feedback value.

", "GetAnomaliesRequest$Feedback": "

Filters anomaly results by the feedback field on the anomaly object.

", "ProvideAnomalyFeedbackRequest$Feedback": "

Describes whether the cost anomaly was a planned activity or you considered it an anomaly.

" } }, "AnomalyMonitor": { - "base": "

This object continuously inspects your account's cost data for anomalies, based on MonitorType and MonitorSpecification. The content consists of detailed metadata and the current status of the monitor object.

", + "base": "

This object continuously inspects your account's cost data for anomalies. It's based on MonitorType and MonitorSpecification. The content consists of detailed metadata and the current status of the monitor object.

", "refs": { "AnomalyMonitors$member": null, - "CreateAnomalyMonitorRequest$AnomalyMonitor": "

The cost anomaly detection monitor object that you want to create.

" + "CreateAnomalyMonitorRequest$AnomalyMonitor": "

The cost anomaly detection monitor object that you want to create.

" } }, "AnomalyMonitors": { "base": null, "refs": { - "GetAnomalyMonitorsResponse$AnomalyMonitors": "

A list of cost anomaly monitors that includes the detailed metadata for each monitor.

" + "GetAnomalyMonitorsResponse$AnomalyMonitors": "

A list of cost anomaly monitors that includes the detailed metadata for each monitor.

" } }, "AnomalyScore": { - "base": "

Quantifies the anomaly. The higher score means that it is more anomalous.

", + "base": "

Quantifies the anomaly. The higher score means that it's more anomalous.

", "refs": { - "Anomaly$AnomalyScore": "

The latest and maximum score for the anomaly.

" + "Anomaly$AnomalyScore": "

The latest and maximum score for the anomaly.

" } }, "AnomalySubscription": { - "base": "

The association between a monitor, threshold, and list of subscribers used to deliver notifications about anomalies detected by a monitor that exceeds a threshold. The content consists of the detailed metadata and the current status of the AnomalySubscription object.

", + "base": "

The association between a monitor, threshold, and list of subscribers used to deliver notifications about anomalies detected by a monitor that exceeds a threshold. The content consists of the detailed metadata and the current status of the AnomalySubscription object.

", "refs": { "AnomalySubscriptions$member": null, - "CreateAnomalySubscriptionRequest$AnomalySubscription": "

The cost anomaly subscription object that you want to create.

" + "CreateAnomalySubscriptionRequest$AnomalySubscription": "

The cost anomaly subscription object that you want to create.

" } }, "AnomalySubscriptionFrequency": { "base": null, "refs": { - "AnomalySubscription$Frequency": "

The frequency at which anomaly reports are sent over email.

", - "UpdateAnomalySubscriptionRequest$Frequency": "

The update to the frequency value at which subscribers will receive notifications.

" + "AnomalySubscription$Frequency": "

The frequency that anomaly reports are sent over email.

", + "UpdateAnomalySubscriptionRequest$Frequency": "

The update to the frequency value that subscribers receive notifications.

" } }, "AnomalySubscriptions": { "base": null, "refs": { - "GetAnomalySubscriptionsResponse$AnomalySubscriptions": "

A list of cost anomaly subscriptions that includes the detailed metadata for each one.

" + "GetAnomalySubscriptionsResponse$AnomalySubscriptions": "

A list of cost anomaly subscriptions that includes the detailed metadata for each one.

" } }, "Arn": { "base": null, "refs": { - "CostCategory$CostCategoryArn": "

The unique identifier for your Cost Category.

", - "CostCategoryReference$CostCategoryArn": "

The unique identifier for your Cost Category.

", + "CostCategory$CostCategoryArn": "

The unique identifier for your Cost Category.

", + "CostCategoryReference$CostCategoryArn": "

The unique identifier for your Cost Category.

", "CreateCostCategoryDefinitionResponse$CostCategoryArn": "

The unique identifier for your newly created Cost Category.

", "DeleteCostCategoryDefinitionRequest$CostCategoryArn": "

The unique identifier for your Cost Category.

", "DeleteCostCategoryDefinitionResponse$CostCategoryArn": "

The unique identifier for your Cost Category.

", @@ -164,7 +164,7 @@ "Context": { "base": null, "refs": { - "GetDimensionValuesRequest$Context": "

The context for the call to GetDimensionValues. This can be RESERVATIONS or COST_AND_USAGE. The default value is COST_AND_USAGE. If the context is set to RESERVATIONS, the resulting dimension values can be used in the GetReservationUtilization operation. If the context is set to COST_AND_USAGE, the resulting dimension values can be used in the GetCostAndUsage operation.

If you set the context to COST_AND_USAGE, you can use the following dimensions for searching:

If you set the context to RESERVATIONS, you can use the following dimensions for searching:

If you set the context to SAVINGS_PLANS, you can use the following dimensions for searching:

" + "GetDimensionValuesRequest$Context": "

The context for the call to GetDimensionValues. This can be RESERVATIONS or COST_AND_USAGE. The default value is COST_AND_USAGE. If the context is set to RESERVATIONS, the resulting dimension values can be used in the GetReservationUtilization operation. If the context is set to COST_AND_USAGE, the resulting dimension values can be used in the GetCostAndUsage operation.

If you set the context to COST_AND_USAGE, you can use the following dimensions for searching:

If you set the context to RESERVATIONS, you can use the following dimensions for searching:

If you set the context to SAVINGS_PLANS, you can use the following dimensions for searching:

" } }, "CostCategory": { @@ -174,15 +174,15 @@ } }, "CostCategoryInheritedValueDimension": { - "base": "

When creating or updating a cost category, you can define the CostCategoryRule rule type as INHERITED_VALUE. This rule type adds the flexibility of defining a rule that dynamically inherits the cost category value from the dimension value defined by CostCategoryInheritedValueDimension. For example, if you wanted to dynamically group costs based on the value of a specific tag key, you would first choose an inherited value rule type, then choose the tag dimension and specify the tag key to use.

", + "base": "

When creating or updating a cost category, you can define the CostCategoryRule rule type as INHERITED_VALUE. This rule type adds the flexibility of defining a rule that dynamically inherits the cost category value from the dimension value defined by CostCategoryInheritedValueDimension. For example, if you want to dynamically group costs that are based on the value of a specific tag key, first choose an inherited value rule type, then choose the tag dimension and specify the tag key to use.

", "refs": { - "CostCategoryRule$InheritedValue": "

The value the line item will be categorized as, if the line item contains the matched dimension.

" + "CostCategoryRule$InheritedValue": "

The value the line item is categorized as if the line item contains the matched dimension.

" } }, "CostCategoryInheritedValueDimensionName": { "base": null, "refs": { - "CostCategoryInheritedValueDimension$DimensionName": "

The name of dimension for which to group costs.

If you specify LINKED_ACCOUNT_NAME, the cost category value will be based on account name. If you specify TAG, the cost category value will be based on the value of the specified tag key.

" + "CostCategoryInheritedValueDimension$DimensionName": "

The name of the dimension that's used to group costs.

If you specify LINKED_ACCOUNT_NAME, the cost category value is based on account name. If you specify TAG, the cost category value will be based on the value of the specified tag key.

" } }, "CostCategoryMaxResults": { @@ -209,7 +209,7 @@ } }, "CostCategoryProcessingStatus": { - "base": "

The list of processing statuses for Cost Management products for a specific cost category.

", + "base": "

The list of processing statuses for Cost Management products for a specific cost category.

", "refs": { "CostCategoryProcessingStatusList$member": null } @@ -217,8 +217,8 @@ "CostCategoryProcessingStatusList": { "base": null, "refs": { - "CostCategory$ProcessingStatus": "

The list of processing statuses for Cost Management products for a specific cost category.

", - "CostCategoryReference$ProcessingStatus": "

The list of processing statuses for Cost Management products for a specific cost category.

" + "CostCategory$ProcessingStatus": "

The list of processing statuses for Cost Management products for a specific cost category.

", + "CostCategoryReference$ProcessingStatus": "

The list of processing statuses for Cost Management products for a specific cost category.

" } }, "CostCategoryReference": { @@ -242,7 +242,7 @@ "CostCategoryRuleType": { "base": null, "refs": { - "CostCategoryRule$Type": "

You can define the CostCategoryRule rule type as either REGULAR or INHERITED_VALUE. The INHERITED_VALUE rule type adds the flexibility of defining a rule that dynamically inherits the cost category value from the dimension value defined by CostCategoryInheritedValueDimension. For example, if you wanted to dynamically group costs based on the value of a specific tag key, you would first choose an inherited value rule type, then choose the tag dimension and specify the tag key to use.

" + "CostCategoryRule$Type": "

You can define the CostCategoryRule rule type as either REGULAR or INHERITED_VALUE. The INHERITED_VALUE rule type adds the flexibility of defining a rule that dynamically inherits the cost category value from the dimension value defined by CostCategoryInheritedValueDimension. For example, if you want to dynamically group costs based on the value of a specific tag key, first choose an inherited value rule type, then choose the tag dimension and specify the tag key to use.

" } }, "CostCategoryRuleVersion": { @@ -256,21 +256,71 @@ "CostCategoryRulesList": { "base": null, "refs": { - "CostCategory$Rules": "

Rules are processed in order. If there are multiple rules that match the line item, then the first rule to match is used to determine that Cost Category value.

", + "CostCategory$Rules": "

The rules are processed in order. If there are multiple rules that match the line item, then the first rule to match is used to determine that Cost Category value.

", "CreateCostCategoryDefinitionRequest$Rules": "

The Cost Category rules used to categorize costs. For more information, see CostCategoryRule.

", "UpdateCostCategoryDefinitionRequest$Rules": "

The Expression object used to categorize costs. For more information, see CostCategoryRule .

" } }, + "CostCategorySplitChargeMethod": { + "base": null, + "refs": { + "CostCategorySplitChargeRule$Method": "

The method that's used to define how to split your source costs across your targets.

Proportional - Allocates charges across your targets based on the proportional weighted cost of each target.

Fixed - Allocates charges across your targets based on your defined allocation percentage.

>Even - Allocates costs evenly across all targets.

" + } + }, + "CostCategorySplitChargeRule": { + "base": "

Use the split charge rule to split the cost of one Cost Category value across several other target values.

", + "refs": { + "CostCategorySplitChargeRulesList$member": null + } + }, + "CostCategorySplitChargeRuleParameter": { + "base": "

The parameters for a split charge method.

", + "refs": { + "CostCategorySplitChargeRuleParametersList$member": null + } + }, + "CostCategorySplitChargeRuleParameterType": { + "base": null, + "refs": { + "CostCategorySplitChargeRuleParameter$Type": "

The parameter type.

" + } + }, + "CostCategorySplitChargeRuleParameterValuesList": { + "base": null, + "refs": { + "CostCategorySplitChargeRuleParameter$Values": "

The parameter values.

" + } + }, + "CostCategorySplitChargeRuleParametersList": { + "base": null, + "refs": { + "CostCategorySplitChargeRule$Parameters": "

The parameters for a split charge method. This is only required for the FIXED method.

" + } + }, + "CostCategorySplitChargeRuleTargetsList": { + "base": null, + "refs": { + "CostCategorySplitChargeRule$Targets": "

The Cost Category values that you want to split costs across. These values can't be used as a source in other split charge rules.

" + } + }, + "CostCategorySplitChargeRulesList": { + "base": null, + "refs": { + "CostCategory$SplitChargeRules": "

The split charge rules that are used to allocate your charges between your Cost Category values.

", + "CreateCostCategoryDefinitionRequest$SplitChargeRules": "

The split charge rules used to allocate your charges between your Cost Category values.

", + "UpdateCostCategoryDefinitionRequest$SplitChargeRules": "

The split charge rules used to allocate your charges between your Cost Category values.

" + } + }, "CostCategoryStatus": { "base": null, "refs": { - "CostCategoryProcessingStatus$Status": "

The process status for a specific cost category.

" + "CostCategoryProcessingStatus$Status": "

The process status for a specific cost category.

" } }, "CostCategoryStatusComponent": { "base": null, "refs": { - "CostCategoryProcessingStatus$Component": "

The Cost Management product name of the applied status.

" + "CostCategoryProcessingStatus$Component": "

The Cost Management product name of the applied status.

" } }, "CostCategoryValue": { @@ -285,15 +335,15 @@ } }, "CostCategoryValues": { - "base": "

The Cost Categories values used for filtering the costs.

If Values and Key are not specified, the ABSENT MatchOption is applied to all Cost Categories. That is, filtering on resources that are not mapped to any Cost Categories.

If Values is provided and Key is not specified, the ABSENT MatchOption is applied to the Cost Categories Key only. That is, filtering on resources without the given Cost Categories key.

", + "base": "

The Cost Categories values used for filtering the costs.

If Values and Key are not specified, the ABSENT MatchOption is applied to all Cost Categories. That is, it filters on resources that aren't mapped to any Cost Categories.

If Values is provided and Key isn't specified, the ABSENT MatchOption is applied to the Cost Categories Key only. That is, it filters on resources without the given Cost Categories key.

", "refs": { - "Expression$CostCategories": "

The filter based on CostCategory values.

" + "Expression$CostCategories": "

The filter that's based on CostCategory values.

" } }, "CostCategoryValuesList": { "base": null, "refs": { - "CostCategoryReference$Values": "

A list of unique cost category values in a specific cost category.

", + "CostCategoryReference$Values": "

A list of unique cost category values in a specific cost category.

", "GetCostCategoriesResponse$CostCategoryValues": "

The Cost Category values.

CostCategoryValues are not returned if CostCategoryName is not specified in the request.

" } }, @@ -330,7 +380,7 @@ } }, "CoverageNormalizedUnits": { - "base": "

The amount of instance usage, in normalized units. Normalized units enable you to see your EC2 usage for multiple sizes of instances in a uniform way. For example, suppose you run an xlarge instance and a 2xlarge instance. If you run both instances for the same amount of time, the 2xlarge instance uses twice as much of your reservation as the xlarge instance, even though both instances show only one instance-hour. Using normalized units instead of instance-hours, the xlarge instance used 8 normalized units, and the 2xlarge instance used 16 normalized units.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide for Linux Instances.

", + "base": "

The amount of instance usage, in normalized units. You can use normalized units to see your EC2 usage for multiple sizes of instances in a uniform way. For example, suppose that you run an xlarge instance and a 2xlarge instance. If you run both instances for the same amount of time, the 2xlarge instance uses twice as much of your reservation as the xlarge instance, even though both instances show only one instance-hour. When you use normalized units instead of instance-hours, the xlarge instance used 8 normalized units, and the 2xlarge instance used 16 normalized units.

For more information, see Modifying Reserved Instances in the Amazon Elastic Compute Cloud User Guide for Linux Instances.

", "refs": { "Coverage$CoverageNormalizedUnits": "

The amount of instance usage that the reservation covered, in normalized units.

" } @@ -380,7 +430,7 @@ "CurrentInstance": { "base": "

Context about the current instance.

", "refs": { - "RightsizingRecommendation$CurrentInstance": "

Context regarding the current instance.

" + "RightsizingRecommendation$CurrentInstance": "

Context regarding the current instance.

" } }, "DataUnavailableException": { @@ -393,11 +443,11 @@ "refs": { "CoverageByTime$TimePeriod": "

The period that this coverage was used over.

", "ForecastResult$TimePeriod": "

The period of time that the forecast covers.

", - "GetCostAndUsageRequest$TimePeriod": "

Sets the start and end dates for retrieving AWS costs. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

", + "GetCostAndUsageRequest$TimePeriod": "

Sets the start date and end date for retrieving Amazon Web Services costs. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

", "GetCostAndUsageWithResourcesRequest$TimePeriod": "

Sets the start and end dates for retrieving Amazon Web Services costs. The range must be within the last 14 days (the start date cannot be earlier than 14 days ago). The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

", "GetCostCategoriesRequest$TimePeriod": null, "GetCostForecastRequest$TimePeriod": "

The period of time that you want the forecast to cover. The start date must be equal to or no later than the current date to avoid a validation error.

", - "GetDimensionValuesRequest$TimePeriod": "

The start and end dates for retrieving the dimension values. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

", + "GetDimensionValuesRequest$TimePeriod": "

The start date and end date for retrieving the dimension values. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

", "GetReservationCoverageRequest$TimePeriod": "

The start and end dates of the period that you want to retrieve data about reservation coverage for. You can retrieve data for a maximum of 13 months: the last 12 months and the current month. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

", "GetReservationUtilizationRequest$TimePeriod": "

Sets the start and end dates for retrieving RI utilization. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.

", "GetSavingsPlansCoverageRequest$TimePeriod": "

The time period that you want the usage and costs for. The Start date must be within 13 months. The End date must be after the Start date, and before the current date. Future dates can't be used as an End date.

", @@ -476,55 +526,55 @@ "refs": { "GetCostAndUsageResponse$DimensionValueAttributes": "

The attributes that apply to a specific dimension value. For example, if the value is a linked account, the attribute is that account name.

", "GetCostAndUsageWithResourcesResponse$DimensionValueAttributes": "

The attributes that apply to a specific dimension value. For example, if the value is a linked account, the attribute is that account name.

", - "GetDimensionValuesResponse$DimensionValues": "

The filters that you used to filter your request. Some dimensions are available only for a specific context.

If you set the context to COST_AND_USAGE, you can use the following dimensions for searching:

If you set the context to RESERVATIONS, you can use the following dimensions for searching:

If you set the context to SAVINGS_PLANS, you can use the following dimensions for searching:

" + "GetDimensionValuesResponse$DimensionValues": "

The filters that you used to filter your request. Some dimensions are available only for a specific context.

If you set the context to COST_AND_USAGE, you can use the following dimensions for searching:

If you set the context to RESERVATIONS, you can use the following dimensions for searching:

If you set the context to SAVINGS_PLANS, you can use the following dimensions for searching:

" } }, "DiskResourceUtilization": { - "base": "

The field that contains a list of disk (local storage) metrics associated with the current instance.

", + "base": "

The field that contains a list of disk (local storage) metrics that are associated with the current instance.

", "refs": { - "EC2ResourceUtilization$DiskResourceUtilization": "

The field that contains a list of disk (local storage) metrics associated with the current instance.

" + "EC2ResourceUtilization$DiskResourceUtilization": "

The field that contains a list of disk (local storage) metrics that are associated with the current instance.

" } }, "EBSResourceUtilization": { - "base": "

The EBS field that contains a list of EBS metrics associated with the current instance.

", + "base": "

The EBS field that contains a list of EBS metrics that are associated with the current instance.

", "refs": { - "EC2ResourceUtilization$EBSResourceUtilization": "

The EBS field that contains a list of EBS metrics associated with the current instance.

" + "EC2ResourceUtilization$EBSResourceUtilization": "

The EBS field that contains a list of EBS metrics that are associated with the current instance.

" } }, "EC2InstanceDetails": { - "base": "

Details about the Amazon EC2 instances that AWS recommends that you purchase.

", + "base": "

Details about the Amazon EC2 instances that Amazon Web Services recommends that you purchase.

", "refs": { - "InstanceDetails$EC2InstanceDetails": "

The Amazon EC2 instances that AWS recommends that you purchase.

" + "InstanceDetails$EC2InstanceDetails": "

The Amazon EC2 instances that Amazon Web Services recommends that you purchase.

" } }, "EC2ResourceDetails": { - "base": "

Details on the Amazon EC2 Resource.

", + "base": "

Details on the Amazon EC2 Resource.

", "refs": { "ResourceDetails$EC2ResourceDetails": "

Details on the Amazon EC2 resource.

" } }, "EC2ResourceUtilization": { - "base": "

Utilization metrics of the instance.

", + "base": "

Utilization metrics of the instance.

", "refs": { - "ResourceUtilization$EC2ResourceUtilization": "

Utilization of current Amazon EC2 instance.

" + "ResourceUtilization$EC2ResourceUtilization": "

The utilization of current Amazon EC2 instance.

" } }, "EC2Specification": { - "base": "

The Amazon EC2 hardware specifications that you want AWS to provide recommendations for.

", + "base": "

The Amazon EC2 hardware specifications that you want Amazon Web Services to provide recommendations for.

", "refs": { - "ServiceSpecification$EC2Specification": "

The Amazon EC2 hardware specifications that you want AWS to provide recommendations for.

" + "ServiceSpecification$EC2Specification": "

The Amazon EC2 hardware specifications that you want Amazon Web Services to provide recommendations for.

" } }, "ESInstanceDetails": { - "base": "

Details about the Amazon ES instances that AWS recommends that you purchase.

", + "base": "

Details about the Amazon ES instances that Amazon Web Services recommends that you purchase.

", "refs": { - "InstanceDetails$ESInstanceDetails": "

The Amazon ES instances that AWS recommends that you purchase.

" + "InstanceDetails$ESInstanceDetails": "

The Amazon ES instances that Amazon Web Services recommends that you purchase.

" } }, "ElastiCacheInstanceDetails": { - "base": "

Details about the Amazon ElastiCache instances that AWS recommends that you purchase.

", + "base": "

Details about the Amazon ElastiCache instances that Amazon Web Services recommends that you purchase.

", "refs": { - "InstanceDetails$ElastiCacheInstanceDetails": "

The ElastiCache instances that AWS recommends that you purchase.

" + "InstanceDetails$ElastiCacheInstanceDetails": "

The ElastiCache instances that Amazon Web Services recommends that you purchase.

" } }, "Entity": { @@ -551,17 +601,17 @@ "Estimated": { "base": null, "refs": { - "ResultByTime$Estimated": "

Whether the result is estimated.

" + "ResultByTime$Estimated": "

Determines whether the result is estimated.

" } }, "Expression": { - "base": "

Use Expression to filter by cost or by usage. There are two patterns:

For the GetRightsizingRecommendation action, a combination of OR and NOT is not supported. OR is not supported between different dimensions, or dimensions and tags. NOT operators aren't supported. Dimensions are also limited to LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE.

For the GetReservationPurchaseRecommendation action, only NOT is supported. AND and OR are not supported. Dimensions are limited to LINKED_ACCOUNT.

", + "base": "

Use Expression to filter by cost or by usage. There are two patterns:

For the GetRightsizingRecommendation action, a combination of OR and NOT isn't supported. OR isn't supported between different dimensions, or dimensions and tags. NOT operators aren't supported. Dimensions are also limited to LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE.

For the GetReservationPurchaseRecommendation action, only NOT is supported. AND and OR aren't supported. Dimensions are limited to LINKED_ACCOUNT.

", "refs": { "AnomalyMonitor$MonitorSpecification": null, - "CostCategoryRule$Rule": "

An Expression object used to categorize costs. This supports dimensions, tags, and nested expressions. Currently the only dimensions supported are LINKED_ACCOUNT, SERVICE_CODE, RECORD_TYPE, and LINKED_ACCOUNT_NAME.

Root level OR is not supported. We recommend that you create a separate rule instead.

RECORD_TYPE is a dimension used for Cost Explorer APIs, and is also supported for Cost Category expressions. This dimension uses different terms, depending on whether you're using the console or API/JSON editor. For a detailed comparison, see Term Comparisons in the AWS Billing and Cost Management User Guide.

", + "CostCategoryRule$Rule": "

An Expression object used to categorize costs. This supports dimensions, tags, and nested expressions. Currently the only dimensions supported are LINKED_ACCOUNT, SERVICE_CODE, RECORD_TYPE, and LINKED_ACCOUNT_NAME.

Root level OR isn't supported. We recommend that you create a separate rule instead.

RECORD_TYPE is a dimension used for Cost Explorer APIs, and is also supported for Cost Category expressions. This dimension uses different terms, depending on whether you're using the console or API/JSON editor. For a detailed comparison, see Term Comparisons in the Billing and Cost Management User Guide.

", "Expression$Not": "

Return results that don't match a Dimension object.

", "Expressions$member": null, - "GetCostAndUsageRequest$Filter": "

Filters AWS costs by different dimensions. For example, you can specify SERVICE and LINKED_ACCOUNT and get the costs that are associated with that account's usage of that service. You can nest Expression objects to define any combination of dimension filters. For more information, see Expression.

", + "GetCostAndUsageRequest$Filter": "

Filters Amazon Web Services costs by different dimensions. For example, you can specify SERVICE and LINKED_ACCOUNT and get the costs that are associated with that account's usage of that service. You can nest Expression objects to define any combination of dimension filters. For more information, see Expression.

", "GetCostAndUsageWithResourcesRequest$Filter": "

Filters Amazon Web Services costs by different dimensions. For example, you can specify SERVICE and LINKED_ACCOUNT and get the costs that are associated with that account's usage of that service. You can nest Expression objects to define any combination of dimension filters. For more information, see Expression.

The GetCostAndUsageWithResources operation requires that you either group by or filter by a ResourceId. It requires the Expression \"SERVICE = Amazon Elastic Compute Cloud - Compute\" in the filter.

", "GetCostCategoriesRequest$Filter": null, "GetCostForecastRequest$Filter": "

The filters that you want to use to filter your forecast. The GetCostForecast API supports filtering by the following dimensions:

", @@ -598,7 +648,7 @@ } }, "ForecastResult": { - "base": "

The forecast created for your query.

", + "base": "

The forecast that's created for your query.

", "refs": { "ForecastResultsByTime$member": null } @@ -613,203 +663,206 @@ "GenericBoolean": { "base": null, "refs": { - "EC2InstanceDetails$CurrentGeneration": "

Whether the recommendation is for a current-generation instance.

", - "EC2InstanceDetails$SizeFlexEligible": "

Whether the recommended reservation is size flexible.

", - "ESInstanceDetails$CurrentGeneration": "

Whether the recommendation is for a current-generation instance.

", - "ESInstanceDetails$SizeFlexEligible": "

Whether the recommended reservation is size flexible.

", - "ElastiCacheInstanceDetails$CurrentGeneration": "

Whether the recommendation is for a current generation instance.

", - "ElastiCacheInstanceDetails$SizeFlexEligible": "

Whether the recommended reservation is size flexible.

", - "RDSInstanceDetails$CurrentGeneration": "

Whether the recommendation is for a current-generation instance.

", - "RDSInstanceDetails$SizeFlexEligible": "

Whether the recommended reservation is size flexible.

", - "RedshiftInstanceDetails$CurrentGeneration": "

Whether the recommendation is for a current-generation instance.

", - "RedshiftInstanceDetails$SizeFlexEligible": "

Whether the recommended reservation is size flexible.

", - "RightsizingRecommendationConfiguration$BenefitsConsidered": "

The option to consider RI or Savings Plans discount benefits in your savings calculation. The default value is TRUE.

", - "TargetInstance$DefaultTargetInstance": "

Indicates whether this recommendation is the defaulted AWS recommendation.

" + "EC2InstanceDetails$CurrentGeneration": "

Determines whether the recommendation is for a current-generation instance.

", + "EC2InstanceDetails$SizeFlexEligible": "

Determines whether the recommended reservation is size flexible.

", + "ESInstanceDetails$CurrentGeneration": "

Determines whether the recommendation is for a current-generation instance.

", + "ESInstanceDetails$SizeFlexEligible": "

Determines whether the recommended reservation is size flexible.

", + "ElastiCacheInstanceDetails$CurrentGeneration": "

Determines whether the recommendation is for a current generation instance.

", + "ElastiCacheInstanceDetails$SizeFlexEligible": "

Determines whether the recommended reservation is size flexible.

", + "RDSInstanceDetails$CurrentGeneration": "

Determines whether the recommendation is for a current-generation instance.

", + "RDSInstanceDetails$SizeFlexEligible": "

Determines whether the recommended reservation is size flexible.

", + "RedshiftInstanceDetails$CurrentGeneration": "

Determines whether the recommendation is for a current-generation instance.

", + "RedshiftInstanceDetails$SizeFlexEligible": "

Determines whether the recommended reservation is size flexible.

", + "RightsizingRecommendationConfiguration$BenefitsConsidered": "

The option to consider RI or Savings Plans discount benefits in your savings calculation. The default value is TRUE.

", + "TargetInstance$DefaultTargetInstance": "

Determines whether this recommendation is the defaulted Amazon Web Services recommendation.

" } }, "GenericDouble": { "base": null, "refs": { - "AnomalyScore$MaxScore": "

The maximum score observed during the AnomalyDateInterval.

", - "AnomalyScore$CurrentScore": "

The last observed score.

", - "Impact$MaxImpact": "

The maximum dollar value observed for an anomaly.

", - "Impact$TotalImpact": "

The cumulative dollar value observed for an anomaly.

", - "TotalImpactFilter$StartValue": "

The lower bound dollar value used in the filter.

", - "TotalImpactFilter$EndValue": "

The upper bound dollar value used in the filter.

" + "AnomalyScore$MaxScore": "

The maximum score that's observed during the AnomalyDateInterval.

", + "AnomalyScore$CurrentScore": "

The last observed score.

", + "Impact$MaxImpact": "

The maximum dollar value that's observed for an anomaly.

", + "Impact$TotalImpact": "

The cumulative dollar value that's observed for an anomaly.

", + "TotalImpactFilter$StartValue": "

The lower bound dollar value that's used in the filter.

", + "TotalImpactFilter$EndValue": "

The upper bound dollar value that's used in the filter.

" } }, "GenericString": { "base": null, "refs": { - "Anomaly$AnomalyId": "

The unique identifier for the anomaly.

", - "Anomaly$DimensionValue": "

The dimension for the anomaly. For example, an AWS service in a service monitor.

", - "Anomaly$MonitorArn": "

The Amazon Resource Name (ARN) for the cost monitor that generated this anomaly.

", - "AnomalyMonitor$MonitorArn": "

The Amazon Resource Name (ARN) value.

", - "AnomalyMonitor$MonitorName": "

The name of the monitor.

", - "AnomalySubscription$SubscriptionArn": "

The AnomalySubscription Amazon Resource Name (ARN).

", - "AnomalySubscription$AccountId": "

Your unique account identifier.

", - "AnomalySubscription$SubscriptionName": "

The name for the subscription.

", + "Anomaly$AnomalyId": "

The unique identifier for the anomaly.

", + "Anomaly$DimensionValue": "

The dimension for the anomaly (for example, an Amazon Web Services service in a service monitor).

", + "Anomaly$MonitorArn": "

The Amazon Resource Name (ARN) for the cost monitor that generated this anomaly.

", + "AnomalyMonitor$MonitorArn": "

The Amazon Resource Name (ARN) value.

", + "AnomalyMonitor$MonitorName": "

The name of the monitor.

", + "AnomalySubscription$SubscriptionArn": "

The AnomalySubscription Amazon Resource Name (ARN).

", + "AnomalySubscription$AccountId": "

Your unique account identifier.

", + "AnomalySubscription$SubscriptionName": "

The name for the subscription.

", "CostCategoryInheritedValueDimension$DimensionKey": "

The key to extract cost category values.

", - "CreateAnomalyMonitorResponse$MonitorArn": "

The unique identifier of your newly created cost anomaly detection monitor.

", - "CreateAnomalySubscriptionResponse$SubscriptionArn": "

The unique identifier of your newly created cost anomaly subscription.

", + "CostCategorySplitChargeRule$Source": "

The Cost Category value that you want to split. That value can't be used as a source or a target in other split charge rules. To indicate uncategorized costs, you can use an empty string as the source.

", + "CostCategorySplitChargeRuleParameterValuesList$member": null, + "CostCategorySplitChargeRuleTargetsList$member": null, + "CreateAnomalyMonitorResponse$MonitorArn": "

The unique identifier of your newly created cost anomaly detection monitor.

", + "CreateAnomalySubscriptionResponse$SubscriptionArn": "

The unique identifier of your newly created cost anomaly subscription.

", "CurrentInstance$ResourceId": "

Resource ID of the current instance.

", - "CurrentInstance$InstanceName": "

The name you've given an instance. This field will show as blank if you haven't given the instance a name.

", - "CurrentInstance$ReservationCoveredHoursInLookbackPeriod": "

Number of hours during the lookback period covered by reservations.

", - "CurrentInstance$SavingsPlansCoveredHoursInLookbackPeriod": "

Number of hours during the lookback period covered by Savings Plans.

", - "CurrentInstance$OnDemandHoursInLookbackPeriod": "

Number of hours during the lookback period billed at On-Demand rates.

", - "CurrentInstance$TotalRunningHoursInLookbackPeriod": "

The total number of hours the instance ran during the lookback period.

", - "CurrentInstance$MonthlyCost": "

Current On-Demand cost of operating this instance on a monthly basis.

", - "CurrentInstance$CurrencyCode": "

The currency code that AWS used to calculate the costs for this instance.

", - "DeleteAnomalyMonitorRequest$MonitorArn": "

The unique identifier of the cost anomaly monitor that you want to delete.

", - "DeleteAnomalySubscriptionRequest$SubscriptionArn": "

The unique identifier of the cost anomaly subscription that you want to delete.

", + "CurrentInstance$InstanceName": "

The name that you given an instance. This field shows as blank if you haven't given the instance a name.

", + "CurrentInstance$ReservationCoveredHoursInLookbackPeriod": "

The number of hours during the lookback period that's covered by reservations.

", + "CurrentInstance$SavingsPlansCoveredHoursInLookbackPeriod": "

The number of hours during the lookback period that's covered by Savings Plans.

", + "CurrentInstance$OnDemandHoursInLookbackPeriod": "

The number of hours during the lookback period that's billed at On-Demand rates.

", + "CurrentInstance$TotalRunningHoursInLookbackPeriod": "

The total number of hours that the instance ran during the lookback period.

", + "CurrentInstance$MonthlyCost": "

The current On-Demand cost of operating this instance on a monthly basis.

", + "CurrentInstance$CurrencyCode": "

The currency code that Amazon Web Services used to calculate the costs for this instance.

", + "DeleteAnomalyMonitorRequest$MonitorArn": "

The unique identifier of the cost anomaly monitor that you want to delete.

", + "DeleteAnomalySubscriptionRequest$SubscriptionArn": "

The unique identifier of the cost anomaly subscription that you want to delete.

", "DiskResourceUtilization$DiskReadOpsPerSecond": "

The maximum number of read operations per second.

", "DiskResourceUtilization$DiskWriteOpsPerSecond": "

The maximum number of write operations per second.

", "DiskResourceUtilization$DiskReadBytesPerSecond": "

The maximum read throughput operations per second.

", "DiskResourceUtilization$DiskWriteBytesPerSecond": "

The maximum write throughput operations per second.

", - "EBSResourceUtilization$EbsReadOpsPerSecond": "

The maximum number of read operations per second.

", - "EBSResourceUtilization$EbsWriteOpsPerSecond": "

The maximum number of write operations per second.

", - "EBSResourceUtilization$EbsReadBytesPerSecond": "

The maximum size of read operations per second

", - "EBSResourceUtilization$EbsWriteBytesPerSecond": "

The maximum size of write operations per second.

", + "EBSResourceUtilization$EbsReadOpsPerSecond": "

The maximum number of read operations per second.

", + "EBSResourceUtilization$EbsWriteOpsPerSecond": "

The maximum number of write operations per second.

", + "EBSResourceUtilization$EbsReadBytesPerSecond": "

The maximum size of read operations per second

", + "EBSResourceUtilization$EbsWriteBytesPerSecond": "

The maximum size of write operations per second.

", "EC2InstanceDetails$Family": "

The instance family of the recommended reservation.

", - "EC2InstanceDetails$InstanceType": "

The type of instance that AWS recommends.

", - "EC2InstanceDetails$Region": "

The AWS Region of the recommended reservation.

", + "EC2InstanceDetails$InstanceType": "

The type of instance that Amazon Web Services recommends.

", + "EC2InstanceDetails$Region": "

The Amazon Web Services Region of the recommended reservation.

", "EC2InstanceDetails$AvailabilityZone": "

The Availability Zone of the recommended reservation.

", "EC2InstanceDetails$Platform": "

The platform of the recommended reservation. The platform is the specific combination of operating system, license model, and software on an instance.

", - "EC2InstanceDetails$Tenancy": "

Whether the recommended reservation is dedicated or shared.

", - "EC2ResourceDetails$HourlyOnDemandRate": "

Hourly public On-Demand rate for the instance type.

", - "EC2ResourceDetails$InstanceType": "

The type of AWS instance.

", - "EC2ResourceDetails$Platform": "

The platform of the AWS instance. The platform is the specific combination of operating system, license model, and software on an instance.

", - "EC2ResourceDetails$Region": "

The AWS Region of the instance.

", - "EC2ResourceDetails$Sku": "

The SKU of the product.

", - "EC2ResourceDetails$Memory": "

Memory capacity of the AWS instance.

", - "EC2ResourceDetails$NetworkPerformance": "

Network performance capacity of the AWS instance.

", - "EC2ResourceDetails$Storage": "

The disk storage of the AWS instance (not EBS storage).

", - "EC2ResourceDetails$Vcpu": "

Number of VCPU cores in the AWS instance type.

", - "EC2ResourceUtilization$MaxCpuUtilizationPercentage": "

Maximum observed or expected CPU utilization of the instance.

", - "EC2ResourceUtilization$MaxMemoryUtilizationPercentage": "

Maximum observed or expected memory utilization of the instance.

", - "EC2ResourceUtilization$MaxStorageUtilizationPercentage": "

Maximum observed or expected storage utilization of the instance (does not measure EBS storage).

", - "ESInstanceDetails$InstanceClass": "

The class of instance that AWS recommends.

", - "ESInstanceDetails$InstanceSize": "

The size of instance that AWS recommends.

", - "ESInstanceDetails$Region": "

The AWS Region of the recommended reservation.

", + "EC2InstanceDetails$Tenancy": "

Determines whether the recommended reservation is dedicated or shared.

", + "EC2ResourceDetails$HourlyOnDemandRate": "

The hourly public On-Demand rate for the instance type.

", + "EC2ResourceDetails$InstanceType": "

The type of Amazon Web Services instance.

", + "EC2ResourceDetails$Platform": "

The platform of the Amazon Web Services instance. The platform is the specific combination of operating system, license model, and software on an instance.

", + "EC2ResourceDetails$Region": "

The Amazon Web Services Region of the instance.

", + "EC2ResourceDetails$Sku": "

The SKU of the product.

", + "EC2ResourceDetails$Memory": "

The memory capacity of the Amazon Web Services instance.

", + "EC2ResourceDetails$NetworkPerformance": "

The network performance capacity of the Amazon Web Services instance.

", + "EC2ResourceDetails$Storage": "

The disk storage of the Amazon Web Services instance. This doesn't include EBS storage.

", + "EC2ResourceDetails$Vcpu": "

The number of VCPU cores in the Amazon Web Services instance type.

", + "EC2ResourceUtilization$MaxCpuUtilizationPercentage": "

The maximum observed or expected CPU utilization of the instance.

", + "EC2ResourceUtilization$MaxMemoryUtilizationPercentage": "

The maximum observed or expected memory utilization of the instance.

", + "EC2ResourceUtilization$MaxStorageUtilizationPercentage": "

The maximum observed or expected storage utilization of the instance. This doesn't include EBS storage.

", + "ESInstanceDetails$InstanceClass": "

The class of instance that Amazon Web Services recommends.

", + "ESInstanceDetails$InstanceSize": "

The size of instance that Amazon Web Services recommends.

", + "ESInstanceDetails$Region": "

The Amazon Web Services Region of the recommended reservation.

", "ElastiCacheInstanceDetails$Family": "

The instance family of the recommended reservation.

", - "ElastiCacheInstanceDetails$NodeType": "

The type of node that AWS recommends.

", - "ElastiCacheInstanceDetails$Region": "

The AWS Region of the recommended reservation.

", + "ElastiCacheInstanceDetails$NodeType": "

The type of node that Amazon Web Services recommends.

", + "ElastiCacheInstanceDetails$Region": "

The Amazon Web Services Region of the recommended reservation.

", "ElastiCacheInstanceDetails$ProductDescription": "

The description of the recommended reservation.

", "ForecastResult$MeanValue": "

The mean value of the forecast.

", "ForecastResult$PredictionIntervalLowerBound": "

The lower limit for the prediction interval.

", "ForecastResult$PredictionIntervalUpperBound": "

The upper limit for the prediction interval.

", "GetAnomaliesRequest$MonitorArn": "

Retrieves all of the cost anomalies detected for a specific cost anomaly monitor Amazon Resource Name (ARN).

", - "GetAnomalySubscriptionsRequest$MonitorArn": "

Cost anomaly monitor ARNs.

", + "GetAnomalySubscriptionsRequest$MonitorArn": "

Cost anomaly monitor ARNs.

", "GetReservationPurchaseRecommendationRequest$AccountId": "

The account ID that is associated with the recommendation.

", "GetReservationPurchaseRecommendationRequest$Service": "

The specific service that you want recommendations for.

", "GetRightsizingRecommendationRequest$Service": "

The specific service that you want recommendations for. The only valid value for GetRightsizingRecommendation is \"AmazonEC2\".

", - "NetworkResourceUtilization$NetworkInBytesPerSecond": "

The network ingress throughput utilization measured in Bytes per second.

", - "NetworkResourceUtilization$NetworkOutBytesPerSecond": "

The network outgress throughput utilization measured in Bytes per second.

", - "NetworkResourceUtilization$NetworkPacketsInPerSecond": "

The network ingress packets measured in packets per second.

", - "NetworkResourceUtilization$NetworkPacketsOutPerSecond": "

The network outgress packets measured in packets per second.

", - "ProvideAnomalyFeedbackRequest$AnomalyId": "

A cost anomaly ID.

", - "ProvideAnomalyFeedbackResponse$AnomalyId": "

The ID of the modified cost anomaly.

", + "NetworkResourceUtilization$NetworkInBytesPerSecond": "

The network inbound throughput utilization measured in Bytes per second.

", + "NetworkResourceUtilization$NetworkOutBytesPerSecond": "

The network outbound throughput utilization measured in Bytes per second.

", + "NetworkResourceUtilization$NetworkPacketsInPerSecond": "

The network ingress packets that are measured in packets per second.

", + "NetworkResourceUtilization$NetworkPacketsOutPerSecond": "

The network outgress packets that are measured in packets per second.

", + "ProvideAnomalyFeedbackRequest$AnomalyId": "

A cost anomaly ID.

", + "ProvideAnomalyFeedbackResponse$AnomalyId": "

The ID of the modified cost anomaly.

", "RDSInstanceDetails$Family": "

The instance family of the recommended reservation.

", - "RDSInstanceDetails$InstanceType": "

The type of instance that AWS recommends.

", - "RDSInstanceDetails$Region": "

The AWS Region of the recommended reservation.

", + "RDSInstanceDetails$InstanceType": "

The type of instance that Amazon Web Services recommends.

", + "RDSInstanceDetails$Region": "

The Amazon Web Services Region of the recommended reservation.

", "RDSInstanceDetails$DatabaseEngine": "

The database engine that the recommended reservation supports.

", "RDSInstanceDetails$DatabaseEdition": "

The database edition that the recommended reservation supports.

", - "RDSInstanceDetails$DeploymentOption": "

Whether the recommendation is for a reservation in a single Availability Zone or a reservation with a backup in a second Availability Zone.

", + "RDSInstanceDetails$DeploymentOption": "

Determines whether the recommendation is for a reservation in a single Availability Zone or a reservation with a backup in a second Availability Zone.

", "RDSInstanceDetails$LicenseModel": "

The license model that the recommended reservation supports.

", "RedshiftInstanceDetails$Family": "

The instance family of the recommended reservation.

", - "RedshiftInstanceDetails$NodeType": "

The type of node that AWS recommends.

", - "RedshiftInstanceDetails$Region": "

The AWS Region of the recommended reservation.

", + "RedshiftInstanceDetails$NodeType": "

The type of node that Amazon Web Services recommends.

", + "RedshiftInstanceDetails$Region": "

The Amazon Web Services Region of the recommended reservation.

", "ReservationPurchaseRecommendationDetail$AccountId": "

The account that this RI recommendation is for.

", - "ReservationPurchaseRecommendationDetail$RecommendedNumberOfInstancesToPurchase": "

The number of instances that AWS recommends that you purchase.

", - "ReservationPurchaseRecommendationDetail$RecommendedNormalizedUnitsToPurchase": "

The number of normalized units that AWS recommends that you purchase.

", - "ReservationPurchaseRecommendationDetail$MinimumNumberOfInstancesUsedPerHour": "

The minimum number of instances that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

", - "ReservationPurchaseRecommendationDetail$MinimumNormalizedUnitsUsedPerHour": "

The minimum number of normalized units that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

", - "ReservationPurchaseRecommendationDetail$MaximumNumberOfInstancesUsedPerHour": "

The maximum number of instances that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

", - "ReservationPurchaseRecommendationDetail$MaximumNormalizedUnitsUsedPerHour": "

The maximum number of normalized units that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

", - "ReservationPurchaseRecommendationDetail$AverageNumberOfInstancesUsedPerHour": "

The average number of instances that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

", - "ReservationPurchaseRecommendationDetail$AverageNormalizedUnitsUsedPerHour": "

The average number of normalized units that you used in an hour during the historical period. AWS uses this to calculate your recommended reservation purchases.

", - "ReservationPurchaseRecommendationDetail$AverageUtilization": "

The average utilization of your instances. AWS uses this to calculate your recommended reservation purchases.

", - "ReservationPurchaseRecommendationDetail$EstimatedBreakEvenInMonths": "

How long AWS estimates that it takes for this instance to start saving you money, in months.

", - "ReservationPurchaseRecommendationDetail$CurrencyCode": "

The currency code that AWS used to calculate the costs for this instance.

", - "ReservationPurchaseRecommendationDetail$EstimatedMonthlySavingsAmount": "

How much AWS estimates that this specific recommendation could save you in a month.

", - "ReservationPurchaseRecommendationDetail$EstimatedMonthlySavingsPercentage": "

How much AWS estimates that this specific recommendation could save you in a month, as a percentage of your overall costs.

", - "ReservationPurchaseRecommendationDetail$EstimatedMonthlyOnDemandCost": "

How much AWS estimates that you spend on On-Demand Instances in a month.

", - "ReservationPurchaseRecommendationDetail$EstimatedReservationCostForLookbackPeriod": "

How much AWS estimates that you would have spent for all usage during the specified historical period if you had a reservation.

", + "ReservationPurchaseRecommendationDetail$RecommendedNumberOfInstancesToPurchase": "

The number of instances that Amazon Web Services recommends that you purchase.

", + "ReservationPurchaseRecommendationDetail$RecommendedNormalizedUnitsToPurchase": "

The number of normalized units that Amazon Web Services recommends that you purchase.

", + "ReservationPurchaseRecommendationDetail$MinimumNumberOfInstancesUsedPerHour": "

The minimum number of instances that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.

", + "ReservationPurchaseRecommendationDetail$MinimumNormalizedUnitsUsedPerHour": "

The minimum number of normalized units that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.

", + "ReservationPurchaseRecommendationDetail$MaximumNumberOfInstancesUsedPerHour": "

The maximum number of instances that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.

", + "ReservationPurchaseRecommendationDetail$MaximumNormalizedUnitsUsedPerHour": "

The maximum number of normalized units that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.

", + "ReservationPurchaseRecommendationDetail$AverageNumberOfInstancesUsedPerHour": "

The average number of instances that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.

", + "ReservationPurchaseRecommendationDetail$AverageNormalizedUnitsUsedPerHour": "

The average number of normalized units that you used in an hour during the historical period. Amazon Web Services uses this to calculate your recommended reservation purchases.

", + "ReservationPurchaseRecommendationDetail$AverageUtilization": "

The average utilization of your instances. Amazon Web Services uses this to calculate your recommended reservation purchases.

", + "ReservationPurchaseRecommendationDetail$EstimatedBreakEvenInMonths": "

How long Amazon Web Services estimates that it takes for this instance to start saving you money, in months.

", + "ReservationPurchaseRecommendationDetail$CurrencyCode": "

The currency code that Amazon Web Services used to calculate the costs for this instance.

", + "ReservationPurchaseRecommendationDetail$EstimatedMonthlySavingsAmount": "

How much Amazon Web Services estimates that this specific recommendation could save you in a month.

", + "ReservationPurchaseRecommendationDetail$EstimatedMonthlySavingsPercentage": "

How much Amazon Web Services estimates that this specific recommendation could save you in a month, as a percentage of your overall costs.

", + "ReservationPurchaseRecommendationDetail$EstimatedMonthlyOnDemandCost": "

How much Amazon Web Services estimates that you spend on On-Demand Instances in a month.

", + "ReservationPurchaseRecommendationDetail$EstimatedReservationCostForLookbackPeriod": "

How much Amazon Web Services estimates that you would have spent for all usage during the specified historical period if you had a reservation.

", "ReservationPurchaseRecommendationDetail$UpfrontCost": "

How much purchasing this instance costs you upfront.

", "ReservationPurchaseRecommendationDetail$RecurringStandardMonthlyCost": "

How much purchasing this instance costs you on a monthly basis.

", "ReservationPurchaseRecommendationMetadata$RecommendationId": "

The ID for this specific recommendation.

", - "ReservationPurchaseRecommendationMetadata$GenerationTimestamp": "

The timestamp for when AWS made this recommendation.

", - "ReservationPurchaseRecommendationSummary$TotalEstimatedMonthlySavingsAmount": "

The total amount that AWS estimates that this recommendation could save you in a month.

", - "ReservationPurchaseRecommendationSummary$TotalEstimatedMonthlySavingsPercentage": "

The total amount that AWS estimates that this recommendation could save you in a month, as a percentage of your costs.

", + "ReservationPurchaseRecommendationMetadata$GenerationTimestamp": "

The timestamp for when Amazon Web Services made this recommendation.

", + "ReservationPurchaseRecommendationSummary$TotalEstimatedMonthlySavingsAmount": "

The total amount that Amazon Web Services estimates that this recommendation could save you in a month.

", + "ReservationPurchaseRecommendationSummary$TotalEstimatedMonthlySavingsPercentage": "

The total amount that Amazon Web Services estimates that this recommendation could save you in a month, as a percentage of your costs.

", "ReservationPurchaseRecommendationSummary$CurrencyCode": "

The currency code used for this recommendation.

", "RightsizingRecommendation$AccountId": "

The account that this recommendation is for.

", - "RightsizingRecommendationMetadata$RecommendationId": "

The ID for this specific recommendation.

", - "RightsizingRecommendationMetadata$GenerationTimestamp": "

The timestamp for when AWS made this recommendation.

", - "RightsizingRecommendationMetadata$AdditionalMetadata": "

Additional metadata that may be applicable to the recommendation.

", - "RightsizingRecommendationSummary$TotalRecommendationCount": "

Total number of instance recommendations.

", - "RightsizingRecommendationSummary$EstimatedTotalMonthlySavingsAmount": "

Estimated total savings resulting from modifications, on a monthly basis.

", - "RightsizingRecommendationSummary$SavingsCurrencyCode": "

The currency code that AWS used to calculate the savings.

", - "RightsizingRecommendationSummary$SavingsPercentage": "

Savings percentage based on the recommended modifications, relative to the total On-Demand costs associated with these instances.

", - "RootCause$Service": "

The AWS service name associated with the cost anomaly.

", - "RootCause$Region": "

The AWS Region associated with the cost anomaly.

", - "RootCause$LinkedAccount": "

The linked account value associated with the cost anomaly.

", - "RootCause$UsageType": "

The UsageType value associated with the cost anomaly.

", + "RightsizingRecommendationMetadata$RecommendationId": "

The ID for this specific recommendation.

", + "RightsizingRecommendationMetadata$GenerationTimestamp": "

The timestamp for when Amazon Web Services made this recommendation.

", + "RightsizingRecommendationMetadata$AdditionalMetadata": "

Additional metadata that might be applicable to the recommendation.

", + "RightsizingRecommendationSummary$TotalRecommendationCount": "

The total number of instance recommendations.

", + "RightsizingRecommendationSummary$EstimatedTotalMonthlySavingsAmount": "

The estimated total savings resulting from modifications, on a monthly basis.

", + "RightsizingRecommendationSummary$SavingsCurrencyCode": "

The currency code that Amazon Web Services used to calculate the savings.

", + "RightsizingRecommendationSummary$SavingsPercentage": "

The savings percentage based on the recommended modifications. It's relative to the total On-Demand costs that are associated with these instances.

", + "RootCause$Service": "

The Amazon Web Services service name that's associated with the cost anomaly.

", + "RootCause$Region": "

The Amazon Web Services Region that's associated with the cost anomaly.

", + "RootCause$LinkedAccount": "

The member account value that's associated with the cost anomaly.

", + "RootCause$UsageType": "

The UsageType value that's associated with the cost anomaly.

", "SavingsPlansAmortizedCommitment$AmortizedRecurringCommitment": "

The amortized amount of your Savings Plans commitment that was purchased with either a Partial or a NoUpfront.

", "SavingsPlansAmortizedCommitment$AmortizedUpfrontCommitment": "

The amortized amount of your Savings Plans commitment that was purchased with an Upfront or PartialUpfront Savings Plans.

", "SavingsPlansAmortizedCommitment$TotalAmortizedCommitment": "

The total amortized amount of your Savings Plans commitment, regardless of your Savings Plans purchase method.

", - "SavingsPlansCoverageData$SpendCoveredBySavingsPlans": "

The amount of your AWS usage that is covered by a Savings Plans.

", - "SavingsPlansCoverageData$OnDemandCost": "

The cost of your AWS usage at the public On-Demand rate.

", - "SavingsPlansCoverageData$TotalCost": "

The total cost of your AWS usage, regardless of your purchase option.

", - "SavingsPlansCoverageData$CoveragePercentage": "

The percentage of your existing Savings Plans covered usage, divided by all of your eligible Savings Plans usage in an account(or set of accounts).

", - "SavingsPlansDetails$Region": "

A collection of AWS resources in a geographic area. Each AWS Region is isolated and independent of the other Regions.

", + "SavingsPlansCoverageData$SpendCoveredBySavingsPlans": "

The amount of your Amazon Web Services usage that is covered by a Savings Plans.

", + "SavingsPlansCoverageData$OnDemandCost": "

The cost of your Amazon Web Services usage at the public On-Demand rate.

", + "SavingsPlansCoverageData$TotalCost": "

The total cost of your Amazon Web Services usage, regardless of your purchase option.

", + "SavingsPlansCoverageData$CoveragePercentage": "

The percentage of your existing Savings Plans covered usage, divided by all of your eligible Savings Plans usage in an account (or set of accounts).

", + "SavingsPlansDetails$Region": "

A collection of Amazon Web Services resources in a geographic area. Each Amazon Web Services Region is isolated and independent of the other Regions.

", "SavingsPlansDetails$InstanceFamily": "

A group of instance types that Savings Plans applies to.

", - "SavingsPlansDetails$OfferingId": "

The unique ID used to distinguish Savings Plans from one another.

", + "SavingsPlansDetails$OfferingId": "

The unique ID that's used to distinguish Savings Plans from one another.

", "SavingsPlansPurchaseRecommendationDetail$AccountId": "

The AccountID the recommendation is generated for.

", "SavingsPlansPurchaseRecommendationDetail$UpfrontCost": "

The upfront cost of the recommended Savings Plans, based on the selected payment option.

", - "SavingsPlansPurchaseRecommendationDetail$EstimatedROI": "

The estimated return on investment based on the recommended Savings Plans purchased. This is calculated as estimatedSavingsAmount/ estimatedSPCost*100.

", - "SavingsPlansPurchaseRecommendationDetail$CurrencyCode": "

The currency code AWS used to generate the recommendations and present potential savings.

", + "SavingsPlansPurchaseRecommendationDetail$EstimatedROI": "

The estimated return on investment that's based on the recommended Savings Plans that you purchased. This is calculated as estimatedSavingsAmount/ estimatedSPCost*100.

", + "SavingsPlansPurchaseRecommendationDetail$CurrencyCode": "

The currency code that Amazon Web Services used to generate the recommendations and present potential savings.

", "SavingsPlansPurchaseRecommendationDetail$EstimatedSPCost": "

The cost of the recommended Savings Plans over the length of the lookback period.

", "SavingsPlansPurchaseRecommendationDetail$EstimatedOnDemandCost": "

The remaining On-Demand cost estimated to not be covered by the recommended Savings Plans, over the length of the lookback period.

", "SavingsPlansPurchaseRecommendationDetail$EstimatedOnDemandCostWithCurrentCommitment": "

The estimated On-Demand costs you would expect with no additional commitment, based on your usage of the selected time period and the Savings Plans you own.

", - "SavingsPlansPurchaseRecommendationDetail$EstimatedSavingsAmount": "

The estimated savings amount based on the recommended Savings Plans over the length of the lookback period.

", + "SavingsPlansPurchaseRecommendationDetail$EstimatedSavingsAmount": "

The estimated savings amount that's based on the recommended Savings Plans over the length of the lookback period.

", "SavingsPlansPurchaseRecommendationDetail$EstimatedSavingsPercentage": "

The estimated savings percentage relative to the total cost of applicable On-Demand usage over the lookback period.

", - "SavingsPlansPurchaseRecommendationDetail$HourlyCommitmentToPurchase": "

The recommended hourly commitment level for the Savings Plans type, and configuration based on the usage during the lookback period.

", + "SavingsPlansPurchaseRecommendationDetail$HourlyCommitmentToPurchase": "

The recommended hourly commitment level for the Savings Plans type and the configuration that's based on the usage during the lookback period.

", "SavingsPlansPurchaseRecommendationDetail$EstimatedAverageUtilization": "

The estimated utilization of the recommended Savings Plans.

", - "SavingsPlansPurchaseRecommendationDetail$EstimatedMonthlySavingsAmount": "

The estimated monthly savings amount, based on the recommended Savings Plans.

", + "SavingsPlansPurchaseRecommendationDetail$EstimatedMonthlySavingsAmount": "

The estimated monthly savings amount based on the recommended Savings Plans.

", "SavingsPlansPurchaseRecommendationDetail$CurrentMinimumHourlyOnDemandSpend": "

The lowest value of hourly On-Demand spend over the lookback period of the applicable usage type.

", "SavingsPlansPurchaseRecommendationDetail$CurrentMaximumHourlyOnDemandSpend": "

The highest value of hourly On-Demand spend over the lookback period of the applicable usage type.

", "SavingsPlansPurchaseRecommendationDetail$CurrentAverageHourlyOnDemandSpend": "

The average value of hourly On-Demand spend over the lookback period of the applicable usage type.

", "SavingsPlansPurchaseRecommendationMetadata$RecommendationId": "

The unique identifier for the recommendation set.

", "SavingsPlansPurchaseRecommendationMetadata$GenerationTimestamp": "

The timestamp showing when the recommendations were generated.

", - "SavingsPlansPurchaseRecommendationMetadata$AdditionalMetadata": "

Additional metadata that may be applicable to the recommendation.

", - "SavingsPlansPurchaseRecommendationSummary$EstimatedROI": "

The estimated return on investment based on the recommended Savings Plans and estimated savings.

", - "SavingsPlansPurchaseRecommendationSummary$CurrencyCode": "

The currency code AWS used to generate the recommendations and present potential savings.

", + "SavingsPlansPurchaseRecommendationMetadata$AdditionalMetadata": "

Additional metadata that might be applicable to the recommendation.

", + "SavingsPlansPurchaseRecommendationSummary$EstimatedROI": "

The estimated return on investment that's based on the recommended Savings Plans and estimated savings.

", + "SavingsPlansPurchaseRecommendationSummary$CurrencyCode": "

The currency code that Amazon Web Services used to generate the recommendations and present potential savings.

", "SavingsPlansPurchaseRecommendationSummary$EstimatedTotalCost": "

The estimated total cost of the usage after purchasing the recommended Savings Plans. This is a sum of the cost of Savings Plans during this term, and the remaining On-Demand usage.

", "SavingsPlansPurchaseRecommendationSummary$CurrentOnDemandSpend": "

The current total on demand spend of the applicable usage types over the lookback period.

", "SavingsPlansPurchaseRecommendationSummary$EstimatedSavingsAmount": "

The estimated total savings over the lookback period, based on the purchase of the recommended Savings Plans.

", "SavingsPlansPurchaseRecommendationSummary$TotalRecommendationCount": "

The aggregate number of Savings Plans recommendations that exist for your account.

", "SavingsPlansPurchaseRecommendationSummary$DailyCommitmentToPurchase": "

The recommended Savings Plans cost on a daily (24 hourly) basis.

", - "SavingsPlansPurchaseRecommendationSummary$HourlyCommitmentToPurchase": "

The recommended hourly commitment based on the recommendation parameters.

", + "SavingsPlansPurchaseRecommendationSummary$HourlyCommitmentToPurchase": "

The recommended hourly commitment that's based on the recommendation parameters.

", "SavingsPlansPurchaseRecommendationSummary$EstimatedSavingsPercentage": "

The estimated savings relative to the total cost of On-Demand usage, over the lookback period. This is calculated as estimatedSavingsAmount/ CurrentOnDemandSpend*100.

", - "SavingsPlansPurchaseRecommendationSummary$EstimatedMonthlySavingsAmount": "

The estimated monthly savings amount, based on the recommended Savings Plans purchase.

", - "SavingsPlansPurchaseRecommendationSummary$EstimatedOnDemandCostWithCurrentCommitment": "

The estimated On-Demand costs you would expect with no additional commitment, based on your usage of the selected time period and the Savings Plans you own.

", - "SavingsPlansSavings$NetSavings": "

The savings amount that you are accumulating for the usage that is covered by a Savings Plans, when compared to the On-Demand equivalent of the same usage.

", + "SavingsPlansPurchaseRecommendationSummary$EstimatedMonthlySavingsAmount": "

The estimated monthly savings amount that's based on the recommended Savings Plans purchase.

", + "SavingsPlansPurchaseRecommendationSummary$EstimatedOnDemandCostWithCurrentCommitment": "

The estimated On-Demand costs you would expect with no additional commitment. It's based on your usage of the selected time period and the Savings Plans you own.

", + "SavingsPlansSavings$NetSavings": "

The savings amount that you're accumulating for the usage that's covered by a Savings Plans, when compared to the On-Demand equivalent of the same usage.

", "SavingsPlansSavings$OnDemandCostEquivalent": "

How much the amount that the usage would have cost if it was accrued at the On-Demand rate.

", "SavingsPlansUtilization$TotalCommitment": "

The total amount of Savings Plans commitment that's been purchased in an account (or set of accounts).

", "SavingsPlansUtilization$UsedCommitment": "

The amount of your Savings Plans commitment that was consumed from Savings Plans eligible usage in a specific period.

", - "SavingsPlansUtilization$UnusedCommitment": "

The amount of your Savings Plans commitment that was not consumed from Savings Plans eligible usage in a specific period.

", + "SavingsPlansUtilization$UnusedCommitment": "

The amount of your Savings Plans commitment that wasn't consumed from Savings Plans eligible usage in a specific period.

", "SavingsPlansUtilization$UtilizationPercentage": "

The amount of UsedCommitment divided by the TotalCommitment for your Savings Plans.

", - "TargetInstance$EstimatedMonthlyCost": "

Expected cost to operate this instance type on a monthly basis.

", - "TargetInstance$EstimatedMonthlySavings": "

Estimated savings resulting from modification, on a monthly basis.

", - "TargetInstance$CurrencyCode": "

The currency code that AWS used to calculate the costs for this instance.

", - "TerminateRecommendationDetail$EstimatedMonthlySavings": "

Estimated savings resulting from modification, on a monthly basis.

", - "TerminateRecommendationDetail$CurrencyCode": "

The currency code that AWS used to calculate the costs for this instance.

", - "UpdateAnomalyMonitorRequest$MonitorArn": "

Cost anomaly monitor Amazon Resource Names (ARNs).

", - "UpdateAnomalyMonitorRequest$MonitorName": "

The new name for the cost anomaly monitor.

", - "UpdateAnomalyMonitorResponse$MonitorArn": "

A cost anomaly monitor ARN.

", - "UpdateAnomalySubscriptionRequest$SubscriptionArn": "

A cost anomaly subscription Amazon Resource Name (ARN).

", - "UpdateAnomalySubscriptionRequest$SubscriptionName": "

The subscription's new name.

", - "UpdateAnomalySubscriptionResponse$SubscriptionArn": "

A cost anomaly subscription ARN.

" + "TargetInstance$EstimatedMonthlyCost": "

The expected cost to operate this instance type on a monthly basis.

", + "TargetInstance$EstimatedMonthlySavings": "

The estimated savings that result from modification, on a monthly basis.

", + "TargetInstance$CurrencyCode": "

The currency code that Amazon Web Services used to calculate the costs for this instance.

", + "TerminateRecommendationDetail$EstimatedMonthlySavings": "

The estimated savings that result from modification, on a monthly basis.

", + "TerminateRecommendationDetail$CurrencyCode": "

The currency code that Amazon Web Services used to calculate the costs for this instance.

", + "UpdateAnomalyMonitorRequest$MonitorArn": "

Cost anomaly monitor Amazon Resource Names (ARNs).

", + "UpdateAnomalyMonitorRequest$MonitorName": "

The new name for the cost anomaly monitor.

", + "UpdateAnomalyMonitorResponse$MonitorArn": "

A cost anomaly monitor ARN.

", + "UpdateAnomalySubscriptionRequest$SubscriptionArn": "

A cost anomaly subscription Amazon Resource Name (ARN).

", + "UpdateAnomalySubscriptionRequest$SubscriptionName": "

The new name of the subscription.

", + "UpdateAnomalySubscriptionResponse$SubscriptionArn": "

A cost anomaly subscription ARN.

" } }, "GetAnomaliesRequest": { @@ -995,10 +1048,10 @@ "Granularity": { "base": null, "refs": { - "GetCostAndUsageRequest$Granularity": "

Sets the AWS cost granularity to MONTHLY or DAILY, or HOURLY. If Granularity isn't set, the response object doesn't include the Granularity, either MONTHLY or DAILY, or HOURLY.

", - "GetCostAndUsageWithResourcesRequest$Granularity": "

Sets the AWS cost granularity to MONTHLY, DAILY, or HOURLY. If Granularity isn't set, the response object doesn't include the Granularity, MONTHLY, DAILY, or HOURLY.

", + "GetCostAndUsageRequest$Granularity": "

Sets the Amazon Web Services cost granularity to MONTHLY or DAILY, or HOURLY. If Granularity isn't set, the response object doesn't include the Granularity, either MONTHLY or DAILY, or HOURLY.

", + "GetCostAndUsageWithResourcesRequest$Granularity": "

Sets the Amazon Web Services cost granularity to MONTHLY, DAILY, or HOURLY. If Granularity isn't set, the response object doesn't include the Granularity, MONTHLY, DAILY, or HOURLY.

", "GetCostForecastRequest$Granularity": "

How granular you want the forecast to be. You can get 3 months of DAILY forecasts or 12 months of MONTHLY forecasts.

The GetCostForecast operation supports only DAILY and MONTHLY granularities.

", - "GetReservationCoverageRequest$Granularity": "

The granularity of the AWS cost data for the reservation. Valid values are MONTHLY and DAILY.

If GroupBy is set, Granularity can't be set. If Granularity isn't set, the response object doesn't include Granularity, either MONTHLY or DAILY.

The GetReservationCoverage operation supports only DAILY and MONTHLY granularities.

", + "GetReservationCoverageRequest$Granularity": "

The granularity of the Amazon Web Services cost data for the reservation. Valid values are MONTHLY and DAILY.

If GroupBy is set, Granularity can't be set. If Granularity isn't set, the response object doesn't include Granularity, either MONTHLY or DAILY.

The GetReservationCoverage operation supports only DAILY and MONTHLY granularities.

", "GetReservationUtilizationRequest$Granularity": "

If GroupBy is set, Granularity can't be set. If Granularity isn't set, the response object doesn't include Granularity, either MONTHLY or DAILY. If both GroupBy and Granularity aren't set, GetReservationUtilization defaults to DAILY.

The GetReservationUtilization operation supports only DAILY and MONTHLY granularities.

", "GetSavingsPlansCoverageRequest$Granularity": "

The granularity of the Amazon Web Services cost data for your Savings Plans. Granularity can't be set if GroupBy is set.

The GetSavingsPlansCoverage operation supports only DAILY and MONTHLY granularities.

", "GetSavingsPlansUtilizationRequest$Granularity": "

The granularity of the Amazon Web Services utillization data for your Savings Plans.

The GetSavingsPlansUtilization operation supports only DAILY and MONTHLY granularities.

", @@ -1032,7 +1085,7 @@ "GroupDefinitions": { "base": null, "refs": { - "GetCostAndUsageRequest$GroupBy": "

You can group AWS costs using up to two different groups, either dimensions, tag keys, cost categories, or any two group by types.

When you group by tag key, you get all tag values, including empty strings.

Valid values are AZ, INSTANCE_TYPE, LEGAL_ENTITY_NAME, LINKED_ACCOUNT, OPERATION, PLATFORM, PURCHASE_TYPE, SERVICE, TAGS, TENANCY, RECORD_TYPE, and USAGE_TYPE.

", + "GetCostAndUsageRequest$GroupBy": "

You can group Amazon Web Services costs using up to two different groups, either dimensions, tag keys, cost categories, or any two group by types.

Valid values for the DIMENSION type are AZ, INSTANCE_TYPE, LEGAL_ENTITY_NAME, LINKED_ACCOUNT, OPERATION, PLATFORM, PURCHASE_TYPE, SERVICE, TENANCY, RECORD_TYPE, and USAGE_TYPE.

When you group by the TAG type and include a valid tag key, you get all tag values, including empty strings.

", "GetCostAndUsageResponse$GroupDefinitions": "

The groups that are specified by the Filter or GroupBy parameters in the request.

", "GetCostAndUsageWithResourcesRequest$GroupBy": "

You can group Amazon Web Services costs using up to two different groups: DIMENSION, TAG, COST_CATEGORY.

", "GetCostAndUsageWithResourcesResponse$GroupDefinitions": "

The groups that are specified by the Filter or GroupBy parameters in the request.

", @@ -1048,15 +1101,15 @@ } }, "Impact": { - "base": "

The anomaly's dollar value.

", + "base": "

The dollar value of the anomaly.

", "refs": { - "Anomaly$Impact": "

The dollar impact for the anomaly.

" + "Anomaly$Impact": "

The dollar impact for the anomaly.

" } }, "InstanceDetails": { - "base": "

Details about the instances that AWS recommends that you purchase.

", + "base": "

Details about the instances that Amazon Web Services recommends that you purchase.

", "refs": { - "ReservationPurchaseRecommendationDetail$InstanceDetails": "

Details about the instances that AWS recommends that you purchase.

" + "ReservationPurchaseRecommendationDetail$InstanceDetails": "

Details about the instances that Amazon Web Services recommends that you purchase.

" } }, "InvalidNextTokenException": { @@ -1094,10 +1147,10 @@ "LookbackPeriodInDays": { "base": null, "refs": { - "GetReservationPurchaseRecommendationRequest$LookbackPeriodInDays": "

The number of previous days that you want AWS to consider when it calculates your recommendations.

", + "GetReservationPurchaseRecommendationRequest$LookbackPeriodInDays": "

The number of previous days that you want Amazon Web Services to consider when it calculates your recommendations.

", "GetSavingsPlansPurchaseRecommendationRequest$LookbackPeriodInDays": "

The lookback period used to generate the recommendation.

", - "ReservationPurchaseRecommendation$LookbackPeriodInDays": "

How many days of previous usage that AWS considers when making this recommendation.

", - "RightsizingRecommendationMetadata$LookbackPeriodInDays": "

How many days of previous usage that AWS considers when making this recommendation.

", + "ReservationPurchaseRecommendation$LookbackPeriodInDays": "

How many days of previous usage that Amazon Web Services considers when making this recommendation.

", + "RightsizingRecommendationMetadata$LookbackPeriodInDays": "

The number of days of previous usage that Amazon Web Services considers when making this recommendation.

", "SavingsPlansPurchaseRecommendation$LookbackPeriodInDays": "

The lookback period in days, used to generate the recommendation.

" } }, @@ -1110,7 +1163,7 @@ "MatchOptions": { "base": null, "refs": { - "CostCategoryValues$MatchOptions": "

The match options that you can use to filter your results. MatchOptions is only applicable for actions related to cost category. The default values for MatchOptions is EQUALS and CASE_SENSITIVE.

", + "CostCategoryValues$MatchOptions": "

The match options that you can use to filter your results. MatchOptions is only applicable for actions related to cost category. The default values for MatchOptions is EQUALS and CASE_SENSITIVE.

", "DimensionValues$MatchOptions": "

The match options that you can use to filter your results. MatchOptions is only applicable for actions related to Cost Category. The default values for MatchOptions are EQUALS and CASE_SENSITIVE.

", "TagValues$MatchOptions": "

The match options that you can use to filter your results. MatchOptions is only applicable for actions related to Cost Category. The default values for MatchOptions are EQUALS and CASE_SENSITIVE.

" } @@ -1120,8 +1173,8 @@ "refs": { "GetCostCategoriesRequest$MaxResults": "

This field is only used when SortBy is provided in the request.

The maximum number of objects that to be returned for this request. If MaxResults is not specified with SortBy, the request will return 1000 results as the default value for this parameter.

For GetCostCategories, MaxResults has an upper limit of 1000.

", "GetDimensionValuesRequest$MaxResults": "

This field is only used when SortBy is provided in the request. The maximum number of objects that to be returned for this request. If MaxResults is not specified with SortBy, the request will return 1000 results as the default value for this parameter.

For GetDimensionValues, MaxResults has an upper limit of 1000.

", - "GetReservationCoverageRequest$MaxResults": "

The maximum number of objects that you returned for this request. If more objects are available, in the response, AWS provides a NextPageToken value that you can use in a subsequent call to get the next batch of objects.

", - "GetReservationUtilizationRequest$MaxResults": "

The maximum number of objects that you returned for this request. If more objects are available, in the response, AWS provides a NextPageToken value that you can use in a subsequent call to get the next batch of objects.

", + "GetReservationCoverageRequest$MaxResults": "

The maximum number of objects that you returned for this request. If more objects are available, in the response, Amazon Web Services provides a NextPageToken value that you can use in a subsequent call to get the next batch of objects.

", + "GetReservationUtilizationRequest$MaxResults": "

The maximum number of objects that you returned for this request. If more objects are available, in the response, Amazon Web Services provides a NextPageToken value that you can use in a subsequent call to get the next batch of objects.

", "GetSavingsPlansCoverageRequest$MaxResults": "

The number of items to be returned in a response. The default is 20, with a minimum value of 1.

", "GetSavingsPlansUtilizationDetailsRequest$MaxResults": "

The number of items to be returned in a response. The default is 20, with a minimum value of 1.

", "GetTagsRequest$MaxResults": "

This field is only used when SortBy is provided in the request. The maximum number of objects that to be returned for this request. If MaxResults is not specified with SortBy, the request will return 1000 results as the default value for this parameter.

For GetTags, MaxResults has an upper limit of 1000.

" @@ -1150,7 +1203,7 @@ "MetricNames": { "base": null, "refs": { - "GetCostAndUsageRequest$Metrics": "

Which metrics are returned in the query. For more information about blended and unblended rates, see Why does the \"blended\" annotation appear on some line items in my bill?.

Valid values are AmortizedCost, BlendedCost, NetAmortizedCost, NetUnblendedCost, NormalizedUsageAmount, UnblendedCost, and UsageQuantity.

If you return the UsageQuantity metric, the service aggregates all usage numbers without taking into account the units. For example, if you aggregate usageQuantity across all of Amazon EC2, the results aren't meaningful because Amazon EC2 compute hours and data transfer are measured in different units (for example, hours vs. GB). To get more meaningful UsageQuantity metrics, filter by UsageType or UsageTypeGroups.

Metrics is required for GetCostAndUsage requests.

", + "GetCostAndUsageRequest$Metrics": "

Which metrics are returned in the query. For more information about blended and unblended rates, see Why does the \"blended\" annotation appear on some line items in my bill?.

Valid values are AmortizedCost, BlendedCost, NetAmortizedCost, NetUnblendedCost, NormalizedUsageAmount, UnblendedCost, and UsageQuantity.

If you return the UsageQuantity metric, the service aggregates all usage numbers without taking into account the units. For example, if you aggregate usageQuantity across all of Amazon EC2, the results aren't meaningful because Amazon EC2 compute hours and data transfer are measured in different units (for example, hours and GB). To get more meaningful UsageQuantity metrics, filter by UsageType or UsageTypeGroups.

Metrics is required for GetCostAndUsage requests.

", "GetCostAndUsageWithResourcesRequest$Metrics": "

Which metrics are returned in the query. For more information about blended and unblended rates, see Why does the \"blended\" annotation appear on some line items in my bill?.

Valid values are AmortizedCost, BlendedCost, NetAmortizedCost, NetUnblendedCost, NormalizedUsageAmount, UnblendedCost, and UsageQuantity.

If you return the UsageQuantity metric, the service aggregates all usage numbers without taking the units into account. For example, if you aggregate usageQuantity across all of Amazon EC2, the results aren't meaningful because Amazon EC2 compute hours and data transfer are measured in different units (for example, hours vs. GB). To get more meaningful UsageQuantity metrics, filter by UsageType or UsageTypeGroups.

Metrics is required for GetCostAndUsageWithResources requests.

", "GetReservationCoverageRequest$Metrics": "

The measurement that you want your reservation coverage reported in.

Valid values are Hour, Unit, and Cost. You can use multiple values in a request.

", "GetSavingsPlansCoverageRequest$Metrics": "

The measurement that you want your Savings Plans coverage reported in. The only valid value is SpendCoveredBySavingsPlans.

" @@ -1180,73 +1233,73 @@ "ModifyRecommendationDetail": { "base": "

Details on the modification recommendation.

", "refs": { - "RightsizingRecommendation$ModifyRecommendationDetail": "

Details for modification recommendations.

" + "RightsizingRecommendation$ModifyRecommendationDetail": "

The details for the modification recommendations.

" } }, "MonitorArnList": { "base": null, "refs": { - "AnomalySubscription$MonitorArnList": "

A list of cost anomaly monitors.

", - "UpdateAnomalySubscriptionRequest$MonitorArnList": "

A list of cost anomaly monitor ARNs.

" + "AnomalySubscription$MonitorArnList": "

A list of cost anomaly monitors.

", + "UpdateAnomalySubscriptionRequest$MonitorArnList": "

A list of cost anomaly monitor ARNs.

" } }, "MonitorDimension": { "base": null, "refs": { - "AnomalyMonitor$MonitorDimension": "

The dimensions to evaluate.

" + "AnomalyMonitor$MonitorDimension": "

The dimensions to evaluate.

" } }, "MonitorType": { "base": null, "refs": { - "AnomalyMonitor$MonitorType": "

The possible type values.

" + "AnomalyMonitor$MonitorType": "

The possible type values.

" } }, "NetRISavings": { "base": null, "refs": { - "ReservationAggregates$NetRISavings": "

How much you saved due to purchasing and utilizing reservation. AWS calculates this by subtracting TotalAmortizedFee from OnDemandCostOfRIHoursUsed.

" + "ReservationAggregates$NetRISavings": "

How much you saved due to purchasing and utilizing reservation. Amazon Web Services calculates this by subtracting TotalAmortizedFee from OnDemandCostOfRIHoursUsed.

" } }, "NetworkResourceUtilization": { - "base": "

The network field that contains a list of network metrics associated with the current instance.

", + "base": "

The network field that contains a list of network metrics that are associated with the current instance.

", "refs": { - "EC2ResourceUtilization$NetworkResourceUtilization": "

The network field that contains a list of network metrics associated with the current instance.

" + "EC2ResourceUtilization$NetworkResourceUtilization": "

The network field that contains a list of network metrics that are associated with the current instance.

" } }, "NextPageToken": { "base": null, "refs": { - "GetAnomaliesRequest$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetAnomaliesResponse$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetAnomalyMonitorsRequest$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetAnomalyMonitorsResponse$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetAnomalySubscriptionsRequest$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetAnomalySubscriptionsResponse$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetCostAndUsageRequest$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetCostAndUsageResponse$NextPageToken": "

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetCostAndUsageWithResourcesRequest$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetCostAndUsageWithResourcesResponse$NextPageToken": "

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetCostCategoriesRequest$NextPageToken": "

If the number of objects that are still available for retrieval exceeds the limit, AWS returns a NextPageToken value in the response. To retrieve the next batch of objects, provide the NextPageToken from the prior call in your next request.

", - "GetCostCategoriesResponse$NextPageToken": "

If the number of objects that are still available for retrieval exceeds the limit, AWS returns a NextPageToken value in the response. To retrieve the next batch of objects, provide the marker from the prior call in your next request.

", - "GetDimensionValuesRequest$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetDimensionValuesResponse$NextPageToken": "

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetReservationCoverageRequest$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetReservationCoverageResponse$NextPageToken": "

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", + "GetAnomaliesRequest$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetAnomaliesResponse$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetAnomalyMonitorsRequest$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetAnomalyMonitorsResponse$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetAnomalySubscriptionsRequest$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetAnomalySubscriptionsResponse$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetCostAndUsageRequest$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetCostAndUsageResponse$NextPageToken": "

The token for the next set of retrievable results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetCostAndUsageWithResourcesRequest$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetCostAndUsageWithResourcesResponse$NextPageToken": "

The token for the next set of retrievable results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetCostCategoriesRequest$NextPageToken": "

If the number of objects that are still available for retrieval exceeds the limit, Amazon Web Services returns a NextPageToken value in the response. To retrieve the next batch of objects, provide the NextPageToken from the prior call in your next request.

", + "GetCostCategoriesResponse$NextPageToken": "

If the number of objects that are still available for retrieval exceeds the limit, Amazon Web Services returns a NextPageToken value in the response. To retrieve the next batch of objects, provide the marker from the prior call in your next request.

", + "GetDimensionValuesRequest$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetDimensionValuesResponse$NextPageToken": "

The token for the next set of retrievable results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetReservationCoverageRequest$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetReservationCoverageResponse$NextPageToken": "

The token for the next set of retrievable results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", "GetReservationPurchaseRecommendationRequest$NextPageToken": "

The pagination token that indicates the next set of results that you want to retrieve.

", "GetReservationPurchaseRecommendationResponse$NextPageToken": "

The pagination token for the next set of retrievable results.

", - "GetReservationUtilizationRequest$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetReservationUtilizationResponse$NextPageToken": "

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", + "GetReservationUtilizationRequest$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetReservationUtilizationResponse$NextPageToken": "

The token for the next set of retrievable results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", "GetRightsizingRecommendationRequest$NextPageToken": "

The pagination token that indicates the next set of results that you want to retrieve.

", "GetRightsizingRecommendationResponse$NextPageToken": "

The token to retrieve the next set of results.

", "GetSavingsPlansCoverageRequest$NextToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", "GetSavingsPlansCoverageResponse$NextToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", "GetSavingsPlansPurchaseRecommendationRequest$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", - "GetSavingsPlansPurchaseRecommendationResponse$NextPageToken": "

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", + "GetSavingsPlansPurchaseRecommendationResponse$NextPageToken": "

The token for the next set of retrievable results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", "GetSavingsPlansUtilizationDetailsRequest$NextToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", "GetSavingsPlansUtilizationDetailsResponse$NextToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", - "GetTagsRequest$NextPageToken": "

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", - "GetTagsResponse$NextPageToken": "

The token for the next set of retrievable results. AWS provides the token when the response from a previous call has more results than the maximum page size.

", + "GetTagsRequest$NextPageToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", + "GetTagsResponse$NextPageToken": "

The token for the next set of retrievable results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", "ListCostCategoryDefinitionsRequest$NextToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

", "ListCostCategoryDefinitionsResponse$NextToken": "

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

" } @@ -1254,8 +1307,8 @@ "NonNegativeInteger": { "base": null, "refs": { - "AnomalyMonitor$DimensionalValueCount": "

The value for evaluated dimensions.

", - "CostCategoryReference$NumberOfRules": "

The number of rules associated with a specific Cost Category.

", + "AnomalyMonitor$DimensionalValueCount": "

The value for evaluated dimensions.

", + "CostCategoryReference$NumberOfRules": "

The number of rules that are associated with a specific Cost Category.

", "GetReservationPurchaseRecommendationRequest$PageSize": "

The number of recommendations that you want returned in a single response object.

", "GetRightsizingRecommendationRequest$PageSize": "

The number of recommendations that you want returned in a single response object.

", "GetSavingsPlansPurchaseRecommendationRequest$PageSize": "

The number of recommendations that you want returned in a single response object.

" @@ -1264,20 +1317,20 @@ "NullableNonNegativeDouble": { "base": null, "refs": { - "AnomalySubscription$Threshold": "

The dollar value that triggers a notification if the threshold is exceeded.

", - "UpdateAnomalySubscriptionRequest$Threshold": "

The update to the threshold value for receiving notifications.

" + "AnomalySubscription$Threshold": "

The dollar value that triggers a notification if the threshold is exceeded.

", + "UpdateAnomalySubscriptionRequest$Threshold": "

The update to the threshold value for receiving notifications.

" } }, "NumericOperator": { "base": null, "refs": { - "TotalImpactFilter$NumericOperator": "

The comparing value used in the filter.

" + "TotalImpactFilter$NumericOperator": "

The comparing value that's used in the filter.

" } }, "OfferingClass": { "base": null, "refs": { - "EC2Specification$OfferingClass": "

Whether you want a recommendation for standard or convertible reservations.

" + "EC2Specification$OfferingClass": "

Indicates whether you want a recommendation for standard or convertible reservations.

" } }, "OnDemandCost": { @@ -1289,7 +1342,7 @@ "OnDemandCostOfRIHoursUsed": { "base": null, "refs": { - "ReservationAggregates$OnDemandCostOfRIHoursUsed": "

How much your reservation would cost if charged On-Demand rates.

" + "ReservationAggregates$OnDemandCostOfRIHoursUsed": "

How much your reservation costs if charged On-Demand rates.

" } }, "OnDemandHours": { @@ -1307,14 +1360,14 @@ "PageSize": { "base": null, "refs": { - "GetAnomaliesRequest$MaxResults": "

The number of entries a paginated response contains.

", - "GetAnomalyMonitorsRequest$MaxResults": "

The number of entries a paginated response contains.

", - "GetAnomalySubscriptionsRequest$MaxResults": "

The number of entries a paginated response contains.

", + "GetAnomaliesRequest$MaxResults": "

The number of entries a paginated response contains.

", + "GetAnomalyMonitorsRequest$MaxResults": "

The number of entries that a paginated response contains.

", + "GetAnomalySubscriptionsRequest$MaxResults": "

The number of entries a paginated response contains.

", "GetCostCategoriesResponse$ReturnSize": "

The number of objects returned.

", "GetCostCategoriesResponse$TotalSize": "

The total number of objects.

", - "GetDimensionValuesResponse$ReturnSize": "

The number of results that AWS returned at one time.

", + "GetDimensionValuesResponse$ReturnSize": "

The number of results that Amazon Web Services returned at one time.

", "GetDimensionValuesResponse$TotalSize": "

The total number of search results.

", - "GetTagsResponse$ReturnSize": "

The number of query results that AWS returns at a time.

", + "GetTagsResponse$ReturnSize": "

The number of query results that Amazon Web Services returns at a time.

", "GetTagsResponse$TotalSize": "

The total number of query results.

" } }, @@ -1323,7 +1376,7 @@ "refs": { "GetReservationPurchaseRecommendationRequest$PaymentOption": "

The reservation purchase option that you want recommendations for.

", "GetSavingsPlansPurchaseRecommendationRequest$PaymentOption": "

The payment option used to generate these recommendations.

", - "ReservationPurchaseRecommendation$PaymentOption": "

The payment option for the reservation. For example, AllUpfront or NoUpfront.

", + "ReservationPurchaseRecommendation$PaymentOption": "

The payment option for the reservation (for example, AllUpfront or NoUpfront).

", "SavingsPlansPurchaseRecommendation$PaymentOption": "

The payment option used to generate the recommendation.

" } }, @@ -1365,13 +1418,13 @@ "PurchasedUnits": { "base": null, "refs": { - "ReservationAggregates$PurchasedUnits": "

How many Amazon EC2 reservation hours that you purchased, converted to normalized units. Normalized units are available only for Amazon EC2 usage after November 11, 2017.

" + "ReservationAggregates$PurchasedUnits": "

The number of Amazon EC2 reservation hours that you purchased. It's converted to normalized units. Normalized units are available only for Amazon EC2 usage after November 11, 2017.

" } }, "RDSInstanceDetails": { - "base": "

Details about the Amazon RDS instances that AWS recommends that you purchase.

", + "base": "

Details about the Amazon RDS instances that Amazon Web Services recommends that you purchase.

", "refs": { - "InstanceDetails$RDSInstanceDetails": "

The Amazon RDS instances that AWS recommends that you purchase.

" + "InstanceDetails$RDSInstanceDetails": "

The Amazon RDS instances that Amazon Web Services recommends that you purchase.

" } }, "RICostForUnusedHours": { @@ -1383,19 +1436,19 @@ "RealizedSavings": { "base": null, "refs": { - "ReservationAggregates$RealizedSavings": "

The realized savings due to purchasing and using a reservation.

" + "ReservationAggregates$RealizedSavings": "

The realized savings because of purchasing and using a reservation.

" } }, "RecommendationTarget": { "base": null, "refs": { - "RightsizingRecommendationConfiguration$RecommendationTarget": "

The option to see recommendations within the same instance family, or recommendations for instances across other families. The default value is SAME_INSTANCE_FAMILY.

" + "RightsizingRecommendationConfiguration$RecommendationTarget": "

The option to see recommendations within the same instance family or recommendations for instances across other families. The default value is SAME_INSTANCE_FAMILY.

" } }, "RedshiftInstanceDetails": { - "base": "

Details about the Amazon Redshift instances that AWS recommends that you purchase.

", + "base": "

Details about the Amazon Redshift instances that Amazon Web Services recommends that you purchase.

", "refs": { - "InstanceDetails$RedshiftInstanceDetails": "

The Amazon Redshift instances that AWS recommends that you purchase.

" + "InstanceDetails$RedshiftInstanceDetails": "

The Amazon Redshift instances that Amazon Web Services recommends that you purchase.

" } }, "RequestChangedException": { @@ -1436,7 +1489,7 @@ } }, "ReservationPurchaseRecommendation": { - "base": "

A specific reservation that AWS recommends for purchase.

", + "base": "

A specific reservation that Amazon Web Services recommends for purchase.

", "refs": { "ReservationPurchaseRecommendations$member": null } @@ -1454,13 +1507,13 @@ } }, "ReservationPurchaseRecommendationMetadata": { - "base": "

Information about this specific recommendation, such as the timestamp for when AWS made a specific recommendation.

", + "base": "

Information about this specific recommendation, such as the timestamp for when Amazon Web Services made a specific recommendation.

", "refs": { "GetReservationPurchaseRecommendationResponse$Metadata": "

Information about this specific recommendation call, such as the time stamp for when Cost Explorer generated this recommendation.

" } }, "ReservationPurchaseRecommendationSummary": { - "base": "

A summary about this recommendation, such as the currency code, the amount that AWS estimates that you could save, and the total amount of reservation to purchase.

", + "base": "

A summary about this recommendation, such as the currency code, the amount that Amazon Web Services estimates that you could save, and the total amount of reservation to purchase.

", "refs": { "ReservationPurchaseRecommendation$RecommendationSummary": "

A summary about the recommended purchase.

" } @@ -1498,8 +1551,8 @@ "ResourceDetails": { "base": "

Details on the resource.

", "refs": { - "CurrentInstance$ResourceDetails": "

Details about the resource and utilization.

", - "TargetInstance$ResourceDetails": "

Details on the target instance type.

" + "CurrentInstance$ResourceDetails": "

Details about the resource and utilization.

", + "TargetInstance$ResourceDetails": "

Details on the target instance type.

" } }, "ResourceNotFoundException": { @@ -1510,12 +1563,12 @@ "ResourceUtilization": { "base": "

Resource utilization of current resource.

", "refs": { - "CurrentInstance$ResourceUtilization": "

Utilization information of the current instance during the lookback period.

", - "TargetInstance$ExpectedResourceUtilization": "

Expected utilization metrics for target instance type.

" + "CurrentInstance$ResourceUtilization": "

Utilization information of the current instance during the lookback period.

", + "TargetInstance$ExpectedResourceUtilization": "

The expected utilization metrics for target instance type.

" } }, "ResultByTime": { - "base": "

The result that is associated with a time period.

", + "base": "

The result that's associated with a time period.

", "refs": { "ResultsByTime$member": null } @@ -1523,7 +1576,7 @@ "ResultsByTime": { "base": null, "refs": { - "GetCostAndUsageResponse$ResultsByTime": "

The time period that is covered by the results in the response.

", + "GetCostAndUsageResponse$ResultsByTime": "

The time period that's covered by the results in the response.

", "GetCostAndUsageWithResourcesResponse$ResultsByTime": "

The time period that is covered by the results in the response.

" } }, @@ -1534,7 +1587,7 @@ } }, "RightsizingRecommendationConfiguration": { - "base": "

Enables you to customize recommendations across two attributes. You can choose to view recommendations for instances within the same instance families or across different instance families. You can also choose to view your estimated savings associated with recommendations with consideration of existing Savings Plans or RI benefits, or neither.

", + "base": "

You can use RightsizingRecommendationConfiguration to customize recommendations across two attributes. You can choose to view recommendations for instances within the same instance families or across different instance families. You can also choose to view your estimated savings that are associated with recommendations with consideration of existing Savings Plans or RI benefits, or neither.

", "refs": { "GetRightsizingRecommendationRequest$Configuration": "

Enables you to customize recommendations across two attributes. You can choose to view recommendations for instances within the same instance families or across different instance families. You can also choose to view your estimated savings associated with recommendations with consideration of existing Savings Plans or RI benefits, or neither.

", "GetRightsizingRecommendationResponse$Configuration": "

Enables you to customize recommendations across two attributes. You can choose to view recommendations for instances within the same instance families or across different instance families. You can also choose to view your estimated savings associated with recommendations with consideration of existing Savings Plans or RI benefits, or neither.

" @@ -1553,7 +1606,7 @@ } }, "RightsizingRecommendationSummary": { - "base": "

Summary of rightsizing recommendations

", + "base": "

The summary of rightsizing recommendations

", "refs": { "GetRightsizingRecommendationResponse$Summary": "

Summary of this recommendation set.

" } @@ -1561,11 +1614,11 @@ "RightsizingType": { "base": null, "refs": { - "RightsizingRecommendation$RightsizingType": "

Recommendation to either terminate or modify the resource.

" + "RightsizingRecommendation$RightsizingType": "

A recommendation to either terminate or modify the resource.

" } }, "RootCause": { - "base": "

The combination of AWS service, linked account, Region, and usage type where a cost anomaly is observed.

", + "base": "

The combination of Amazon Web Services service, linked account, Region, and usage type where a cost anomaly is observed.

", "refs": { "RootCauses$member": null } @@ -1573,7 +1626,7 @@ "RootCauses": { "base": null, "refs": { - "Anomaly$RootCauses": "

The list of identified root causes for the anomaly.

" + "Anomaly$RootCauses": "

The list of identified root causes for the anomaly.

" } }, "SavingsPlanArn": { @@ -1621,7 +1674,7 @@ } }, "SavingsPlansDetails": { - "base": "

Attribute details on a specific Savings Plan.

", + "base": "

The attribute details on a specific Savings Plan.

", "refs": { "SavingsPlansPurchaseRecommendationDetail$SavingsPlansDetails": "

Details for your recommended Savings Plans.

" } @@ -1657,7 +1710,7 @@ } }, "SavingsPlansSavings": { - "base": "

The amount of savings you're accumulating, against the public On-Demand rate of the usage accrued in an account.

", + "base": "

The amount of savings that you're accumulating, against the public On-Demand rate of the usage accrued in an account.

", "refs": { "SavingsPlansUtilizationAggregates$Savings": "

The amount saved by using existing Savings Plans. Savings returns both net savings from Savings Plans, as well as the onDemandCostEquivalent of the Savings Plans when considering the utilization rate.

", "SavingsPlansUtilizationByTime$Savings": "

The amount saved by using existing Savings Plans. Savings returns both net savings from Savings Plans as well as the onDemandCostEquivalent of the Savings Plans when considering the utilization rate.

", @@ -1665,7 +1718,7 @@ } }, "SavingsPlansUtilization": { - "base": "

The measurement of how well you are using your existing Savings Plans.

", + "base": "

The measurement of how well you're using your existing Savings Plans.

", "refs": { "SavingsPlansUtilizationAggregates$Utilization": "

A ratio of your effectiveness of using existing Savings Plans to apply to workloads that are Savings Plans eligible.

", "SavingsPlansUtilizationByTime$Utilization": "

A ratio of your effectiveness of using existing Savings Plans to apply to workloads that are Savings Plans eligible.

", @@ -1737,7 +1790,7 @@ "SortDefinitionKey": { "base": null, "refs": { - "SortDefinition$Key": "

The key by which to sort the data.

" + "SortDefinition$Key": "

The key that's used to sort the data.

" } }, "SortDefinitions": { @@ -1751,11 +1804,11 @@ "SortOrder": { "base": null, "refs": { - "SortDefinition$SortOrder": "

The order in which to sort the data.

" + "SortDefinition$SortOrder": "

The order that's used to sort the data.

" } }, "Subscriber": { - "base": "

The recipient of AnomalySubscription notifications.

", + "base": "

The recipient of AnomalySubscription notifications.

", "refs": { "Subscribers$member": null } @@ -1763,26 +1816,26 @@ "SubscriberAddress": { "base": null, "refs": { - "Subscriber$Address": "

The email address or SNS Amazon Resource Name (ARN), depending on the Type.

" + "Subscriber$Address": "

The email address or SNS Amazon Resource Name (ARN). This depends on the Type.

" } }, "SubscriberStatus": { "base": null, "refs": { - "Subscriber$Status": "

Indicates if the subscriber accepts the notifications.

" + "Subscriber$Status": "

Indicates if the subscriber accepts the notifications.

" } }, "SubscriberType": { "base": null, "refs": { - "Subscriber$Type": "

The notification delivery channel.

" + "Subscriber$Type": "

The notification delivery channel.

" } }, "Subscribers": { "base": null, "refs": { - "AnomalySubscription$Subscribers": "

A list of subscribers to notify.

", - "UpdateAnomalySubscriptionRequest$Subscribers": "

The update to the subscriber list.

" + "AnomalySubscription$Subscribers": "

A list of subscribers to notify.

", + "UpdateAnomalySubscriptionRequest$Subscribers": "

The update to the subscriber list.

" } }, "SupportedSavingsPlansType": { @@ -1806,7 +1859,7 @@ } }, "TagValues": { - "base": "

The values that are available for a tag.

If Values and Key are not specified, the ABSENT MatchOption is applied to all tags. That is, filtering on resources with no tags.

If Values is provided and Key is not specified, the ABSENT MatchOption is applied to the tag Key only. That is, filtering on resources without the given tag key.

", + "base": "

The values that are available for a tag.

If Values and Key aren't specified, the ABSENT MatchOption is applied to all tags. That is, it's filtered on resources with no tags.

If Values is provided and Key isn't specified, the ABSENT MatchOption is applied to the tag Key only. That is, it's filtered on resources without the given tag key.

", "refs": { "Expression$Tags": "

The specific Tag to use for Expression.

", "TagValuesList$member": null @@ -1815,11 +1868,11 @@ "TagValuesList": { "base": null, "refs": { - "CurrentInstance$Tags": "

Cost allocation resource tags applied to the instance.

" + "CurrentInstance$Tags": "

Cost allocation resource tags that are applied to the instance.

" } }, "TargetInstance": { - "base": "

Details on recommended instance.

", + "base": "

Details on recommended instance.

", "refs": { "TargetInstancesList$member": null } @@ -1827,7 +1880,7 @@ "TargetInstancesList": { "base": null, "refs": { - "ModifyRecommendationDetail$TargetInstances": "

Identifies whether this instance type is the AWS default recommendation.

" + "ModifyRecommendationDetail$TargetInstances": "

Determines whether this instance type is the Amazon Web Services default recommendation.

" } }, "TermInYears": { @@ -1836,13 +1889,13 @@ "GetReservationPurchaseRecommendationRequest$TermInYears": "

The reservation term that you want recommendations for.

", "GetSavingsPlansPurchaseRecommendationRequest$TermInYears": "

The savings plan recommendation term used to generate these recommendations.

", "ReservationPurchaseRecommendation$TermInYears": "

The term of the reservation that you want recommendations for, in years.

", - "SavingsPlansPurchaseRecommendation$TermInYears": "

The Savings Plans recommendation term in years, used to generate the recommendation.

" + "SavingsPlansPurchaseRecommendation$TermInYears": "

The Savings Plans recommendation term in years. It's used to generate the recommendation.

" } }, "TerminateRecommendationDetail": { - "base": "

Details on termination recommendation.

", + "base": "

Details on termination recommendation.

", "refs": { - "RightsizingRecommendation$TerminateRecommendationDetail": "

Details for termination recommendations.

" + "RightsizingRecommendation$TerminateRecommendationDetail": "

The details for termination recommendations.

" } }, "TotalActualHours": { @@ -1854,17 +1907,17 @@ "TotalActualUnits": { "base": null, "refs": { - "ReservationAggregates$TotalActualUnits": "

The total number of Amazon EC2 reservation hours that you used, converted to normalized units. Normalized units are available only for Amazon EC2 usage after November 11, 2017.

" + "ReservationAggregates$TotalActualUnits": "

The total number of Amazon EC2 reservation hours that you used. It's converted to normalized units. Normalized units are available only for Amazon EC2 usage after November 11, 2017.

" } }, "TotalAmortizedFee": { "base": null, "refs": { - "ReservationAggregates$TotalAmortizedFee": "

The total cost of your reservation, amortized over the reservation period.

" + "ReservationAggregates$TotalAmortizedFee": "

The total cost of your reservation. It's amortized over the reservation period.

" } }, "TotalImpactFilter": { - "base": "

Filters cost anomalies based on the total impact.

", + "base": "

Filters cost anomalies based on the total impact.

", "refs": { "GetAnomaliesRequest$TotalImpact": "

Filters anomaly results by the total impact field on the anomaly object. For example, you can filter anomalies GREATER_THAN 200.00 to retrieve anomalies, with an estimated dollar impact greater than 200.

" } @@ -1872,7 +1925,7 @@ "TotalPotentialRISavings": { "base": null, "refs": { - "ReservationAggregates$TotalPotentialRISavings": "

How much you could save if you use your entire reservation.

" + "ReservationAggregates$TotalPotentialRISavings": "

How much you might save if you use your entire reservation.

" } }, "TotalRunningHours": { @@ -1900,7 +1953,7 @@ "UnrealizedSavings": { "base": null, "refs": { - "ReservationAggregates$UnrealizedSavings": "

The unrealized savings due to purchasing and using a reservation.

" + "ReservationAggregates$UnrealizedSavings": "

The unrealized savings because of purchasing and using a reservation.

" } }, "UnresolvableUsageUnitException": { @@ -1917,7 +1970,7 @@ "UnusedUnits": { "base": null, "refs": { - "ReservationAggregates$UnusedUnits": "

The number of Amazon EC2 reservation hours that you didn't use, converted to normalized units. Normalized units are available only for Amazon EC2 usage after November 11, 2017.

" + "ReservationAggregates$UnusedUnits": "

The number of Amazon EC2 reservation hours that you didn't use. It's converted to normalized units. Normalized units are available only for Amazon EC2 usage after November 11, 2017.

" } }, "UpdateAnomalyMonitorRequest": { @@ -1965,7 +2018,7 @@ "UtilizationPercentageInUnits": { "base": null, "refs": { - "ReservationAggregates$UtilizationPercentageInUnits": "

The percentage of Amazon EC2 reservation time that you used, converted to normalized units. Normalized units are available only for Amazon EC2 usage after November 11, 2017.

" + "ReservationAggregates$UtilizationPercentageInUnits": "

The percentage of Amazon EC2 reservation time that you used. It's converted to normalized units. Normalized units are available only for Amazon EC2 usage after November 11, 2017.

" } }, "UtilizationsByTime": { @@ -1986,32 +2039,32 @@ "refs": { "CostCategoryValues$Values": "

The specific value of the Cost Category.

", "DimensionValues$Values": "

The metadata values that you can use to filter and group your results. You can use GetDimensionValues to find specific values.

", - "GetAnomalyMonitorsRequest$MonitorArnList": "

A list of cost anomaly monitor ARNs.

", - "GetAnomalySubscriptionsRequest$SubscriptionArnList": "

A list of cost anomaly subscription ARNs.

", + "GetAnomalyMonitorsRequest$MonitorArnList": "

A list of cost anomaly monitor ARNs.

", + "GetAnomalySubscriptionsRequest$SubscriptionArnList": "

A list of cost anomaly subscription ARNs.

", "TagValues$Values": "

The specific value of the tag.

" } }, "YearMonthDay": { "base": null, "refs": { - "Anomaly$AnomalyStartDate": "

The first day the anomaly is detected.

", - "Anomaly$AnomalyEndDate": "

The last day the anomaly is detected.

", - "AnomalyDateInterval$StartDate": "

The first date an anomaly was observed.

", - "AnomalyDateInterval$EndDate": "

The last date an anomaly was observed.

", - "AnomalyMonitor$CreationDate": "

The date when the monitor was created.

", - "AnomalyMonitor$LastUpdatedDate": "

The date when the monitor was last updated.

", - "AnomalyMonitor$LastEvaluatedDate": "

The date when the monitor last evaluated for anomalies.

", - "DateInterval$Start": "

The beginning of the time period. The start date is inclusive. For example, if start is 2017-01-01, AWS retrieves cost and usage data starting at 2017-01-01 up to the end date. The start date must be equal to or no later than the current date to avoid a validation error.

", - "DateInterval$End": "

The end of the time period. The end date is exclusive. For example, if end is 2017-05-01, AWS retrieves cost and usage data from the start date up to, but not including, 2017-05-01.

" + "Anomaly$AnomalyStartDate": "

The first day the anomaly is detected.

", + "Anomaly$AnomalyEndDate": "

The last day the anomaly is detected.

", + "AnomalyDateInterval$StartDate": "

The first date an anomaly was observed.

", + "AnomalyDateInterval$EndDate": "

The last date an anomaly was observed.

", + "AnomalyMonitor$CreationDate": "

The date when the monitor was created.

", + "AnomalyMonitor$LastUpdatedDate": "

The date when the monitor was last updated.

", + "AnomalyMonitor$LastEvaluatedDate": "

The date when the monitor last evaluated for anomalies.

", + "DateInterval$Start": "

The beginning of the time period. The start date is inclusive. For example, if start is 2017-01-01, Amazon Web Services retrieves cost and usage data starting at 2017-01-01 up to the end date. The start date must be equal to or no later than the current date to avoid a validation error.

", + "DateInterval$End": "

The end of the time period. The end date is exclusive. For example, if end is 2017-05-01, Amazon Web Services retrieves cost and usage data from the start date up to, but not including, 2017-05-01.

" } }, "ZonedDateTime": { "base": "

The time period that you want the usage and costs for.

", "refs": { - "CostCategory$EffectiveStart": "

The Cost Category's effective start date.

", - "CostCategory$EffectiveEnd": "

The Cost Category's effective end date.

", - "CostCategoryReference$EffectiveStart": "

The Cost Category's effective start date.

", - "CostCategoryReference$EffectiveEnd": "

The Cost Category's effective end date.

", + "CostCategory$EffectiveStart": "

The effective state data of your Cost Category.

", + "CostCategory$EffectiveEnd": "

The effective end data of your Cost Category.

", + "CostCategoryReference$EffectiveStart": "

The Cost Category's effective start date.

", + "CostCategoryReference$EffectiveEnd": "

The Cost Category's effective end date.

", "CreateCostCategoryDefinitionResponse$EffectiveStart": "

The Cost Category's effective start date.

", "DeleteCostCategoryDefinitionResponse$EffectiveEnd": "

The effective end date of the Cost Category as a result of deleting it. No costs after this date will be categorized by the deleted Cost Category.

", "DescribeCostCategoryDefinitionRequest$EffectiveOn": "

The date when the Cost Category was effective.

", diff --git a/models/apis/cloud9/2017-09-23/api-2.json b/models/apis/cloud9/2017-09-23/api-2.json index d798c3c8d6c..02f121e0e72 100644 --- a/models/apis/cloud9/2017-09-23/api-2.json +++ b/models/apis/cloud9/2017-09-23/api-2.json @@ -300,7 +300,8 @@ "automaticStopTimeMinutes":{"shape":"AutomaticStopTimeMinutes"}, "ownerArn":{"shape":"UserArn"}, "tags":{"shape":"TagList"}, - "connectionType":{"shape":"ConnectionType"} + "connectionType":{"shape":"ConnectionType"}, + "dryRun":{"shape":"NullableBoolean"} } }, "CreateEnvironmentEC2Result":{ @@ -563,6 +564,13 @@ "Tags":{"shape":"TagList"} } }, + "ManagedCredentialsAction":{ + "type":"string", + "enum":[ + "ENABLE", + "DISABLE" + ] + }, "ManagedCredentialsStatus":{ "type":"string", "enum":[ @@ -598,6 +606,7 @@ }, "exception":true }, + "NullableBoolean":{"type":"boolean"}, "Permissions":{ "type":"string", "enum":[ @@ -719,7 +728,8 @@ "members":{ "environmentId":{"shape":"EnvironmentId"}, "name":{"shape":"EnvironmentName"}, - "description":{"shape":"EnvironmentDescription"} + "description":{"shape":"EnvironmentDescription"}, + "managedCredentialsAction":{"shape":"ManagedCredentialsAction"} } }, "UpdateEnvironmentResult":{ diff --git a/models/apis/cloud9/2017-09-23/docs-2.json b/models/apis/cloud9/2017-09-23/docs-2.json index 45d21c61481..d1e567a0ab3 100644 --- a/models/apis/cloud9/2017-09-23/docs-2.json +++ b/models/apis/cloud9/2017-09-23/docs-2.json @@ -271,6 +271,12 @@ "refs": { } }, + "ManagedCredentialsAction": { + "base": null, + "refs": { + "UpdateEnvironmentRequest$managedCredentialsAction": "

Allows the environment owner to turn on or turn off the Amazon Web Services managed temporary credentials for an Cloud9 environment by using one of the following values:

Only the environment owner can change the status of managed temporary credentials. An AccessDeniedException is thrown if an attempt to turn on or turn off managed temporary credentials is made by an account that's not the environment owner.

" + } + }, "ManagedCredentialsStatus": { "base": null, "refs": { @@ -296,6 +302,12 @@ "refs": { } }, + "NullableBoolean": { + "base": null, + "refs": { + "CreateEnvironmentEC2Request$dryRun": "

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

" + } + }, "Permissions": { "base": null, "refs": { diff --git a/models/apis/clouddirectory/2017-01-11/docs-2.json b/models/apis/clouddirectory/2017-01-11/docs-2.json index 576c03b9fdc..c320bc1c8d2 100644 --- a/models/apis/clouddirectory/2017-01-11/docs-2.json +++ b/models/apis/clouddirectory/2017-01-11/docs-2.json @@ -71,7 +71,7 @@ }, "shapes": { "AccessDeniedException": { - "base": "

Access denied. Check your permissions.

", + "base": "

Access denied or directory not found. Either you don't have permissions for this directory or the directory does not exist. Try calling ListDirectories and check your permissions.

", "refs": { } }, @@ -166,7 +166,7 @@ "PutSchemaFromJsonRequest$SchemaArn": "

The ARN of the schema to update.

", "PutSchemaFromJsonResponse$Arn": "

The ARN of the schema to update.

", "RemoveFacetFromObjectRequest$DirectoryArn": "

The ARN of the directory in which the object resides.

", - "SchemaFacet$SchemaArn": "

The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions.

", + "SchemaFacet$SchemaArn": "

The ARN of the schema that contains the facet with no minor component. See arns and In-Place Schema Upgrade for a description of when to provide minor versions. If this value is set, FacetName must also be set.

", "TagResourceRequest$ResourceArn": "

The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.

", "TypedLinkSchemaAndFacetName$SchemaArn": "

The Amazon Resource Name (ARN) that is associated with the schema. For more information, see arns.

", "UntagResourceRequest$ResourceArn": "

The Amazon Resource Name (ARN) of the resource. Tagging is only supported for directories.

", @@ -564,15 +564,15 @@ } }, "BatchListObjectParents": { - "base": null, + "base": "

Lists parent objects that are associated with a given object in pagination fashion.

", "refs": { - "BatchReadOperation$ListObjectParents": null + "BatchReadOperation$ListObjectParents": "

Lists parent objects that are associated with a given object in pagination fashion.

" } }, "BatchListObjectParentsResponse": { - "base": null, + "base": "

Represents the output of a ListObjectParents response operation.

", "refs": { - "BatchReadSuccessfulResponse$ListObjectParents": null + "BatchReadSuccessfulResponse$ListObjectParents": "

The list of parent objects to retrieve.

" } }, "BatchListObjectPolicies": { @@ -1163,7 +1163,7 @@ "FacetNameList$member": null, "GetFacetRequest$Name": "

The name of the facet to retrieve.

", "ListFacetAttributesRequest$Name": "

The name of the facet whose attributes will be retrieved.

", - "SchemaFacet$FacetName": "

The name of the facet.

", + "SchemaFacet$FacetName": "

The name of the facet. If this value is set, SchemaArn must also be set.

", "UpdateFacetRequest$Name": "

The name of the facet.

" } }, @@ -1612,8 +1612,8 @@ "BatchListObjectChildrenResponse$NextToken": "

The pagination token.

", "BatchListObjectParentPaths$NextToken": "

The pagination token.

", "BatchListObjectParentPathsResponse$NextToken": "

The pagination token.

", - "BatchListObjectParents$NextToken": null, - "BatchListObjectParentsResponse$NextToken": null, + "BatchListObjectParents$NextToken": "

The pagination token.

", + "BatchListObjectParentsResponse$NextToken": "

The pagination token.

", "BatchListObjectPolicies$NextToken": "

The pagination token.

", "BatchListObjectPoliciesResponse$NextToken": "

The pagination token.

", "BatchListOutgoingTypedLinks$NextToken": "

The pagination token.

", @@ -1696,7 +1696,7 @@ "BatchListObjectAttributes$MaxResults": "

The maximum number of items to be retrieved in a single call. This is an approximate number.

", "BatchListObjectChildren$MaxResults": "

Maximum number of items to be retrieved in a single call. This is an approximate number.

", "BatchListObjectParentPaths$MaxResults": "

The maximum number of results to retrieve.

", - "BatchListObjectParents$MaxResults": null, + "BatchListObjectParents$MaxResults": "

The maximum number of items to be retrieved in a single call. This is an approximate number.

", "BatchListObjectPolicies$MaxResults": "

The maximum number of results to retrieve.

", "BatchListOutgoingTypedLinks$MaxResults": "

The maximum number of results to retrieve.

", "BatchListPolicyAttachments$MaxResults": "

The maximum number of results to retrieve.

", @@ -1792,7 +1792,7 @@ "ObjectIdentifierAndLinkNameList": { "base": null, "refs": { - "BatchListObjectParentsResponse$ParentLinks": null, + "BatchListObjectParentsResponse$ParentLinks": "

Returns a list of parent reference and LinkName Tuples.

", "ListObjectParentsResponse$ParentLinks": "

Returns a list of parent reference and LinkName Tuples.

" } }, @@ -2102,7 +2102,7 @@ "SelectorObjectReference": { "base": null, "refs": { - "ObjectReference$Selector": "

A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects. You can identify an object in one of the following ways:

" + "ObjectReference$Selector": "

A path selector supports easy selection of an object by the parent/child links leading to it from the directory root. Use the link names from each parent/child link to construct the path. Path selectors start with a slash (/) and link names are separated by slashes. For more information about paths, see Access Objects. You can identify an object in one of the following ways:

" } }, "StillContainsLinksException": { diff --git a/models/apis/ec2/2016-11-15/api-2.json b/models/apis/ec2/2016-11-15/api-2.json index 1ea66f79b84..590072afab1 100755 --- a/models/apis/ec2/2016-11-15/api-2.json +++ b/models/apis/ec2/2016-11-15/api-2.json @@ -8173,6 +8173,7 @@ "shape":"Boolean", "locationName":"dryRun" }, + "KeyType":{"shape":"KeyType"}, "TagSpecifications":{ "shape":"TagSpecificationList", "locationName":"TagSpecification" @@ -21984,6 +21985,10 @@ "shape":"String", "locationName":"keyName" }, + "KeyType":{ + "shape":"KeyType", + "locationName":"keyType" + }, "Tags":{ "shape":"TagList", "locationName":"tagSet" @@ -21998,6 +22003,13 @@ } }, "KeyPairName":{"type":"string"}, + "KeyType":{ + "type":"string", + "enum":[ + "rsa", + "ed25519" + ] + }, "KmsKeyId":{"type":"string"}, "LastError":{ "type":"structure", diff --git a/models/apis/ec2/2016-11-15/docs-2.json b/models/apis/ec2/2016-11-15/docs-2.json index 979a1408d0e..da195bdf420 100755 --- a/models/apis/ec2/2016-11-15/docs-2.json +++ b/models/apis/ec2/2016-11-15/docs-2.json @@ -63,7 +63,7 @@ "CreateInstanceEventWindow": "

Creates an event window in which scheduled events for the associated Amazon EC2 instances can run.

You can define either a set of time ranges or a cron expression when creating the event window, but not both. All event window times are in UTC.

You can create up to 200 event windows per Amazon Web Services Region.

When you create the event window, targets (instance IDs, Dedicated Host IDs, or tags) are not yet associated with it. To ensure that the event window can be used, you must associate one or more targets with it by using the AssociateInstanceEventWindow API.

Event windows are applicable only for scheduled events that stop, reboot, or terminate instances.

Event windows are not applicable for:

For more information, see Define event windows for scheduled events in the Amazon EC2 User Guide.

", "CreateInstanceExportTask": "

Exports a running or stopped instance to an Amazon S3 bucket.

For information about the supported operating systems, image formats, and known limitations for the types of instances you can export, see Exporting an instance as a VM Using VM Import/Export in the VM Import/Export User Guide.

", "CreateInternetGateway": "

Creates an internet gateway for use with a VPC. After creating the internet gateway, you attach it to a VPC using AttachInternetGateway.

For more information about your VPC and internet gateway, see the Amazon Virtual Private Cloud User Guide.

", - "CreateKeyPair": "

Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#1 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

You can have up to five thousand key pairs per Region.

The key pair returned to you is available only in the Region in which you create it. If you prefer, you can create your own key pair using a third-party tool and upload it to any Region using ImportKeyPair.

For more information, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

", + "CreateKeyPair": "

Creates an ED25519 or 2048-bit RSA key pair with the specified name. Amazon EC2 stores the public key and displays the private key for you to save to a file. The private key is returned as an unencrypted PEM encoded PKCS#1 private key. If a key with the specified name already exists, Amazon EC2 returns an error.

The key pair returned to you is available only in the Amazon Web Services Region in which you create it. If you prefer, you can create your own key pair using a third-party tool and upload it to any Region using ImportKeyPair.

You can have up to 5,000 key pairs per Amazon Web Services Region.

For more information, see Amazon EC2 key pairs in the Amazon Elastic Compute Cloud User Guide.

", "CreateLaunchTemplate": "

Creates a launch template. A launch template contains the parameters to launch an instance. When you launch an instance using RunInstances, you can specify a launch template instead of providing the launch parameters in the request. For more information, see Launching an instance from a launch templatein the Amazon Elastic Compute Cloud User Guide.

", "CreateLaunchTemplateVersion": "

Creates a new version for a launch template. You can specify an existing version of launch template from which to base the new version.

Launch template versions are numbered in the order in which they are created. You cannot specify, change, or replace the numbering of launch template versions.

For more information, see Managing launch template versionsin the Amazon Elastic Compute Cloud User Guide.

", "CreateLocalGatewayRoute": "

Creates a static route for the specified local gateway route table.

", @@ -81,7 +81,7 @@ "CreateRestoreImageTask": "

Starts a task that restores an AMI from an S3 object that was previously created by using CreateStoreImageTask.

To use this API, you must have the required permissions. For more information, see Permissions for storing and restoring AMIs using S3 in the Amazon Elastic Compute Cloud User Guide.

For more information, see Store and restore an AMI using S3 in the Amazon Elastic Compute Cloud User Guide.

", "CreateRoute": "

Creates a route in a route table within a VPC.

You must specify one of the following targets: internet gateway or virtual private gateway, NAT instance, NAT gateway, VPC peering connection, network interface, egress-only internet gateway, or transit gateway.

When determining how to route traffic, we use the route with the most specific match. For example, traffic is destined for the IPv4 address 192.0.2.3, and the route table includes the following two IPv4 routes:

Both routes apply to the traffic destined for 192.0.2.3. However, the second route in the list covers a smaller number of IP addresses and is therefore more specific, so we use that route to determine where to target the traffic.

For more information about route tables, see Route tables in the Amazon Virtual Private Cloud User Guide.

", "CreateRouteTable": "

Creates a route table for the specified VPC. After you create a route table, you can add routes and associate the table with a subnet.

For more information, see Route tables in the Amazon Virtual Private Cloud User Guide.

", - "CreateSecurityGroup": "

Creates a security group.

A security group acts as a virtual firewall for your instance to control inbound and outbound traffic. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

For more information about VPC security group limits, see Amazon VPC Limits.

", + "CreateSecurityGroup": "

Creates a security group.

A security group acts as a virtual firewall for your instance to control inbound and outbound traffic. For more information, see Amazon EC2 security groups in the Amazon Elastic Compute Cloud User Guide and Security groups for your VPC in the Amazon Virtual Private Cloud User Guide.

When you create a security group, you specify a friendly name of your choice. You can have a security group for use in EC2-Classic with the same name as a security group for use in a VPC. However, you can't have two security groups for use in EC2-Classic with the same name or two security groups for use in a VPC with the same name.

You have a default security group for use in EC2-Classic and a default security group for use in your VPC. If you don't specify a security group when you launch an instance, the instance is launched into the appropriate default security group. A default security group includes a default rule that grants instances unrestricted network access to each other.

You can add or remove rules from your security groups using AuthorizeSecurityGroupIngress, AuthorizeSecurityGroupEgress, RevokeSecurityGroupIngress, and RevokeSecurityGroupEgress.

For more information about VPC security group limits, see Amazon VPC Limits.

", "CreateSnapshot": "

Creates a snapshot of an EBS volume and stores it in Amazon S3. You can use snapshots for backups, to make copies of EBS volumes, and to save data before shutting down an instance.

You can create snapshots of volumes in a Region and volumes on an Outpost. If you create a snapshot of a volume in a Region, the snapshot must be stored in the same Region as the volume. If you create a snapshot of a volume on an Outpost, the snapshot can be stored on the same Outpost as the volume, or in the Region for that Outpost.

When a snapshot is created, any Amazon Web Services Marketplace product codes that are associated with the source volume are propagated to the snapshot.

You can take a snapshot of an attached volume that is in use. However, snapshots only capture data that has been written to your Amazon EBS volume at the time the snapshot command is issued; this might exclude any data that has been cached by any applications or the operating system. If you can pause any file systems on the volume long enough to take a snapshot, your snapshot should be complete. However, if you cannot pause all file writes to the volume, you should unmount the volume from within the instance, issue the snapshot command, and then remount the volume to ensure a consistent and complete snapshot. You may remount and use your volume while the snapshot status is pending.

To create a snapshot for Amazon EBS volumes that serve as root devices, you should stop the instance before taking the snapshot.

Snapshots that are taken from encrypted volumes are automatically encrypted. Volumes that are created from encrypted snapshots are also automatically encrypted. Your encrypted volumes and any associated snapshots always remain protected.

You can tag your snapshots during creation. For more information, see Tag your Amazon EC2 resources in the Amazon Elastic Compute Cloud User Guide.

For more information, see Amazon Elastic Block Store and Amazon EBS encryption in the Amazon Elastic Compute Cloud User Guide.

", "CreateSnapshots": "

Creates crash-consistent snapshots of multiple EBS volumes and stores the data in S3. Volumes are chosen by specifying an instance. Any attached volumes will produce one snapshot each that is crash-consistent across the instance. Boot volumes can be excluded by changing the parameters.

You can create multi-volume snapshots of instances in a Region and instances on an Outpost. If you create snapshots from an instance in a Region, the snapshots must be stored in the same Region as the instance. If you create snapshots from an instance on an Outpost, the snapshots can be stored on the same Outpost as the instance, or in the Region for that Outpost.

", "CreateSpotDatafeedSubscription": "

Creates a data feed for Spot Instances, enabling you to view Spot Instance usage logs. You can create one data feed per Amazon Web Services account. For more information, see Spot Instance data feed in the Amazon EC2 User Guide for Linux Instances.

", @@ -222,7 +222,7 @@ "DescribeInstances": "

Describes the specified instances or all instances.

If you specify instance IDs, the output includes information for only the specified instances. If you specify filters, the output includes information for only those instances that meet the filter criteria. If you do not specify instance IDs or filters, the output includes information for all instances, which can affect performance. We recommend that you use pagination to ensure that the operation returns quickly and successfully.

If you specify an instance ID that is not valid, an error is returned. If you specify an instance that you do not own, it is not included in the output.

Recently terminated instances might appear in the returned results. This interval is usually less than one hour.

If you describe instances in the rare case where an Availability Zone is experiencing a service disruption and you specify instance IDs that are in the affected zone, or do not specify any instance IDs at all, the call fails. If you describe instances and specify only instance IDs that are in an unaffected zone, the call works normally.

", "DescribeInternetGateways": "

Describes one or more of your internet gateways.

", "DescribeIpv6Pools": "

Describes your IPv6 address pools.

", - "DescribeKeyPairs": "

Describes the specified key pairs or all of your key pairs.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

", + "DescribeKeyPairs": "

Describes the specified key pairs or all of your key pairs.

For more information about key pairs, see Amazon EC2 key pairs in the Amazon Elastic Compute Cloud User Guide.

", "DescribeLaunchTemplateVersions": "

Describes one or more versions of a specified launch template. You can describe all versions, individual versions, or a range of versions. You can also describe all the latest versions or all the default versions of all the launch templates in your account.

", "DescribeLaunchTemplates": "

Describes one or more launch templates.

", "DescribeLocalGatewayRouteTableVirtualInterfaceGroupAssociations": "

Describes the associations between virtual interface groups and local gateway route tables.

", @@ -255,7 +255,7 @@ "DescribeScheduledInstances": "

Describes the specified Scheduled Instances or all your Scheduled Instances.

", "DescribeSecurityGroupReferences": "

[VPC only] Describes the VPCs on the other side of a VPC peering connection that are referencing the security groups you've specified in this request.

", "DescribeSecurityGroupRules": "

Describes one or more of your security group rules.

", - "DescribeSecurityGroups": "

Describes the specified security groups or all of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 Security Groups in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your VPC in the Amazon Virtual Private Cloud User Guide.

", + "DescribeSecurityGroups": "

Describes the specified security groups or all of your security groups.

A security group is for use with instances either in the EC2-Classic platform or in a specific VPC. For more information, see Amazon EC2 security groups in the Amazon Elastic Compute Cloud User Guide and Security groups for your VPC in the Amazon Virtual Private Cloud User Guide.

", "DescribeSnapshotAttribute": "

Describes the specified attribute of the specified snapshot. You can specify only one attribute at a time.

For more information about EBS snapshots, see Amazon EBS snapshots in the Amazon Elastic Compute Cloud User Guide.

", "DescribeSnapshots": "

Describes the specified EBS snapshots available to you or all of the EBS snapshots available to you.

The snapshots available to you include public snapshots, private snapshots that you own, and private snapshots owned by other Amazon Web Services accounts for which you have explicit create volume permissions.

The create volume permissions fall into the following categories:

The list of snapshots returned can be filtered by specifying snapshot IDs, snapshot owners, or Amazon Web Services accounts with create volume permissions. If no options are specified, Amazon EC2 returns all snapshots for which you have create volume permissions.

If you specify one or more snapshot IDs, only snapshots that have the specified IDs are returned. If you specify an invalid snapshot ID, an error is returned. If you specify a snapshot ID for which you do not have access, it is not included in the returned results.

If you specify one or more snapshot owners using the OwnerIds option, only snapshots from the specified owners and for which you have access are returned. The results can include the Amazon Web Services account IDs of the specified owners, amazon for snapshots owned by Amazon, or self for snapshots that you own.

If you specify a list of restorable users, only snapshots with create snapshot permissions for those users are returned. You can specify Amazon Web Services account IDs (if you own the snapshots), self for snapshots for which you own or have explicit permissions, or all for public snapshots.

If you are describing a long list of snapshots, we recommend that you paginate the output to make the list more manageable. The MaxResults parameter sets the maximum number of results returned in a single page. If the list of results exceeds your MaxResults value, then that number of results is returned along with a NextToken value that can be passed to a subsequent DescribeSnapshots request to retrieve the remaining results.

To get the state of fast snapshot restores for a snapshot, use DescribeFastSnapshotRestores.

For more information about EBS snapshots, see Amazon EBS snapshots in the Amazon Elastic Compute Cloud User Guide.

", "DescribeSpotDatafeedSubscription": "

Describes the data feed for Spot Instances. For more information, see Spot Instance data feed in the Amazon EC2 User Guide for Linux Instances.

", @@ -361,7 +361,7 @@ "ImportClientVpnClientCertificateRevocationList": "

Uploads a client certificate revocation list to the specified Client VPN endpoint. Uploading a client certificate revocation list overwrites the existing client certificate revocation list.

Uploading a client certificate revocation list resets existing client connections.

", "ImportImage": "

Import single or multi-volume disk images or EBS snapshots into an Amazon Machine Image (AMI).

For more information, see Importing a VM as an image using VM Import/Export in the VM Import/Export User Guide.

", "ImportInstance": "

Creates an import instance task using metadata from the specified disk image.

This API action supports only single-volume VMs. To import multi-volume VMs, use ImportImage instead.

This API action is not supported by the AWS Command Line Interface (AWS CLI). For information about using the Amazon EC2 CLI, which is deprecated, see Importing a VM to Amazon EC2 in the Amazon EC2 CLI Reference PDF file.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", - "ImportKeyPair": "

Imports the public key from an RSA key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which Amazon Web Services creates the key pair and gives the keys to you (Amazon Web Services keeps a copy of the public key). With ImportKeyPair, you create the key pair and give Amazon Web Services just the public key. The private key is never transferred between you and Amazon Web Services.

For more information about key pairs, see Key Pairs in the Amazon Elastic Compute Cloud User Guide.

", + "ImportKeyPair": "

Imports the public key from an RSA or ED25519 key pair that you created with a third-party tool. Compare this with CreateKeyPair, in which Amazon Web Services creates the key pair and gives the keys to you (Amazon Web Services keeps a copy of the public key). With ImportKeyPair, you create the key pair and give Amazon Web Services just the public key. The private key is never transferred between you and Amazon Web Services.

For more information about key pairs, see Amazon EC2 key pairs in the Amazon Elastic Compute Cloud User Guide.

", "ImportSnapshot": "

Imports a disk into an EBS snapshot.

For more information, see Importing a disk as a snapshot using VM Import/Export in the VM Import/Export User Guide.

", "ImportVolume": "

Creates an import volume task using metadata from the specified disk image.

This API action supports only single-volume VMs. To import multi-volume VMs, use ImportImage instead. To import a disk to a snapshot, use ImportSnapshot instead.

This API action is not supported by the AWS Command Line Interface (AWS CLI). For information about using the Amazon EC2 CLI, which is deprecated, see Importing Disks to Amazon EBS in the Amazon EC2 CLI Reference PDF file.

For information about the import manifest referenced by this API action, see VM Import Manifest.

", "ModifyAddressAttribute": "

Modifies an attribute of the specified Elastic IP address. For requirements, see Using reverse DNS for email applications.

", @@ -9674,6 +9674,13 @@ "ScheduledInstancesLaunchSpecification$KeyName": "

The name of the key pair.

" } }, + "KeyType": { + "base": null, + "refs": { + "CreateKeyPairRequest$KeyType": "

The type of key pair. Note that ED25519 keys are not supported for Windows instances, EC2 Instance Connect, and EC2 Serial Console.

Default: rsa

", + "KeyPairInfo$KeyType": "

The type of key pair.

" + } + }, "KmsKeyId": { "base": null, "refs": { @@ -13581,7 +13588,7 @@ "SensitiveUserData": { "base": null, "refs": { - "KeyPair$KeyMaterial": "

An unencrypted PEM encoded RSA private key.

" + "KeyPair$KeyMaterial": "

An unencrypted PEM encoded RSA or ED25519 private key.

" } }, "ServiceConfiguration": { @@ -14990,7 +14997,7 @@ "KeyPair$KeyName": "

The name of the key pair.

", "KeyPair$KeyPairId": "

The ID of the key pair.

", "KeyPairInfo$KeyPairId": "

The ID of the key pair.

", - "KeyPairInfo$KeyFingerprint": "

If you used CreateKeyPair to create the key pair, this is the SHA-1 digest of the DER encoded private key. If you used ImportKeyPair to provide Amazon Web Services the public key, this is the MD5 public key fingerprint as specified in section 4 of RFC4716.

", + "KeyPairInfo$KeyFingerprint": "

If you used CreateKeyPair to create the key pair:

If you used ImportKeyPair to provide Amazon Web Services the public key:

", "KeyPairInfo$KeyName": "

The name of the key pair.

", "LastError$Message": "

The error message for the VPC endpoint error.

", "LastError$Code": "

The error code for the VPC endpoint error.

", diff --git a/models/apis/logs/2014-03-28/docs-2.json b/models/apis/logs/2014-03-28/docs-2.json index f2135843337..d64620ef47d 100644 --- a/models/apis/logs/2014-03-28/docs-2.json +++ b/models/apis/logs/2014-03-28/docs-2.json @@ -1,11 +1,11 @@ { "version": "2.0", - "service": "

You can use Amazon CloudWatch Logs to monitor, store, and access your log files from EC2 instances, AWS CloudTrail, and other sources. You can then retrieve the associated log data from CloudWatch Logs using the CloudWatch console, CloudWatch Logs commands in the AWS CLI, CloudWatch Logs API, or CloudWatch Logs SDK.

You can use CloudWatch Logs to:

", + "service": "

You can use Amazon CloudWatch Logs to monitor, store, and access your log files from EC2 instances, CloudTrail, and other sources. You can then retrieve the associated log data from CloudWatch Logs using the CloudWatch console, CloudWatch Logs commands in the Amazon Web Services CLI, CloudWatch Logs API, or CloudWatch Logs SDK.

You can use CloudWatch Logs to:

", "operations": { - "AssociateKmsKey": "

Associates the specified AWS Key Management Service (AWS KMS) customer master key (CMK) with the specified log group.

Associating an AWS KMS CMK with a log group overrides any existing associations between the log group and a CMK. After a CMK is associated with a log group, all newly ingested data for the log group is encrypted using the CMK. This association is stored as long as the data encrypted with the CMK is still within Amazon CloudWatch Logs. This enables Amazon CloudWatch Logs to decrypt this data whenever it is requested.

CloudWatch Logs supports only symmetric CMKs. Do not use an associate an asymmetric CMK with your log group. For more information, see Using Symmetric and Asymmetric Keys.

It can take up to 5 minutes for this operation to take effect.

If you attempt to associate a CMK with a log group but the CMK does not exist or the CMK is disabled, you receive an InvalidParameterException error.

", + "AssociateKmsKey": "

Associates the specified Key Management Service customer master key (CMK) with the specified log group.

Associating an KMS CMK with a log group overrides any existing associations between the log group and a CMK. After a CMK is associated with a log group, all newly ingested data for the log group is encrypted using the CMK. This association is stored as long as the data encrypted with the CMK is still within CloudWatch Logs. This enables CloudWatch Logs to decrypt this data whenever it is requested.

CloudWatch Logs supports only symmetric CMKs. Do not use an associate an asymmetric CMK with your log group. For more information, see Using Symmetric and Asymmetric Keys.

It can take up to 5 minutes for this operation to take effect.

If you attempt to associate a CMK with a log group but the CMK does not exist or the CMK is disabled, you receive an InvalidParameterException error.

", "CancelExportTask": "

Cancels the specified export task.

The task must be in the PENDING or RUNNING state.

", "CreateExportTask": "

Creates an export task, which allows you to efficiently export data from a log group to an Amazon S3 bucket. When you perform a CreateExportTask operation, you must use credentials that have permission to write to the S3 bucket that you specify as the destination.

This is an asynchronous call. If all the required information is provided, this operation initiates an export task and responds with the ID of the task. After the task has started, you can use DescribeExportTasks to get the status of the export task. Each account can only have one active (RUNNING or PENDING) export task at a time. To cancel an export task, use CancelExportTask.

You can export logs from multiple log groups or multiple time ranges to the same S3 bucket. To separate out log data for each export task, you can specify a prefix to be used as the Amazon S3 key prefix for all exported objects.

Exporting to S3 buckets that are encrypted with AES-256 is supported. Exporting to S3 buckets encrypted with SSE-KMS is not supported.

", - "CreateLogGroup": "

Creates a log group with the specified name. You can create up to 20,000 log groups per account.

You must use the following guidelines when naming a log group:

When you create a log group, by default the log events in the log group never expire. To set a retention policy so that events expire and are deleted after a specified time, use PutRetentionPolicy.

If you associate a AWS Key Management Service (AWS KMS) customer master key (CMK) with the log group, ingested data is encrypted using the CMK. This association is stored as long as the data encrypted with the CMK is still within Amazon CloudWatch Logs. This enables Amazon CloudWatch Logs to decrypt this data whenever it is requested.

If you attempt to associate a CMK with the log group but the CMK does not exist or the CMK is disabled, you receive an InvalidParameterException error.

CloudWatch Logs supports only symmetric CMKs. Do not associate an asymmetric CMK with your log group. For more information, see Using Symmetric and Asymmetric Keys.

", + "CreateLogGroup": "

Creates a log group with the specified name. You can create up to 20,000 log groups per account.

You must use the following guidelines when naming a log group:

When you create a log group, by default the log events in the log group never expire. To set a retention policy so that events expire and are deleted after a specified time, use PutRetentionPolicy.

If you associate a Key Management Service customer master key (CMK) with the log group, ingested data is encrypted using the CMK. This association is stored as long as the data encrypted with the CMK is still within CloudWatch Logs. This enables CloudWatch Logs to decrypt this data whenever it is requested.

If you attempt to associate a CMK with the log group but the CMK does not exist or the CMK is disabled, you receive an InvalidParameterException error.

CloudWatch Logs supports only symmetric CMKs. Do not associate an asymmetric CMK with your log group. For more information, see Using Symmetric and Asymmetric Keys.

", "CreateLogStream": "

Creates a log stream for the specified log group. A log stream is a sequence of log events that originate from a single source, such as an application instance or a resource that is being monitored.

There is no limit on the number of log streams that you can create for a log group. There is a limit of 50 TPS on CreateLogStream operations, after which transactions are throttled.

You must use the following guidelines when naming a log stream:

", "DeleteDestination": "

Deletes the specified destination, and eventually disables all the subscription filters that publish to it. This operation does not delete the physical resource encapsulated by the destination.

", "DeleteLogGroup": "

Deletes the specified log group and permanently deletes all the archived log events associated with the log group.

", @@ -17,14 +17,14 @@ "DeleteSubscriptionFilter": "

Deletes the specified subscription filter.

", "DescribeDestinations": "

Lists all your destinations. The results are ASCII-sorted by destination name.

", "DescribeExportTasks": "

Lists the specified export tasks. You can list all your export tasks or filter the results based on task ID or task status.

", - "DescribeLogGroups": "

Lists the specified log groups. You can list all your log groups or filter the results by prefix. The results are ASCII-sorted by log group name.

", + "DescribeLogGroups": "

Lists the specified log groups. You can list all your log groups or filter the results by prefix. The results are ASCII-sorted by log group name.

CloudWatch Logs doesn’t support IAM policies that control access to the DescribeLogGroups action by using the aws:ResourceTag/key-name condition key. Other CloudWatch Logs actions do support the use of the aws:ResourceTag/key-name condition key to control access. For more information about using tags to control access, see Controlling access to Amazon Web Services resources using tags.

", "DescribeLogStreams": "

Lists the log streams for the specified log group. You can list all the log streams or filter the results by prefix. You can also control how the results are ordered.

This operation has a limit of five transactions per second, after which transactions are throttled.

", "DescribeMetricFilters": "

Lists the specified metric filters. You can list all of the metric filters or filter the results by log name, prefix, metric name, or metric namespace. The results are ASCII-sorted by filter name.

", "DescribeQueries": "

Returns a list of CloudWatch Logs Insights queries that are scheduled, executing, or have been executed recently in this account. You can request all queries or limit it to queries of a specific log group or queries with a certain status.

", "DescribeQueryDefinitions": "

This operation returns a paginated list of your saved CloudWatch Logs Insights query definitions.

You can use the queryDefinitionNamePrefix parameter to limit the results to only the query definitions that have names that start with a certain string.

", "DescribeResourcePolicies": "

Lists the resource policies in this account.

", "DescribeSubscriptionFilters": "

Lists the subscription filters for the specified log group. You can list all the subscription filters or filter the results by prefix. The results are ASCII-sorted by filter name.

", - "DisassociateKmsKey": "

Disassociates the associated AWS Key Management Service (AWS KMS) customer master key (CMK) from the specified log group.

After the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.

Note that it can take up to 5 minutes for this operation to take effect.

", + "DisassociateKmsKey": "

Disassociates the associated Key Management Service customer master key (CMK) from the specified log group.

After the KMS CMK is disassociated from the log group, CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.

Note that it can take up to 5 minutes for this operation to take effect.

", "FilterLogEvents": "

Lists log events from the specified log group. You can list all the log events or filter the results using a filter pattern, a time range, and the name of the log stream.

By default, this operation returns as many log events as can fit in 1 MB (up to 10,000 log events) or all the events found within the time range that you specify. If the results include a token, then there are more log events available, and you can get additional results by specifying the token in a subsequent call. This operation can return empty results while there are more log events available through the token.

The returned log events are sorted by event timestamp, the timestamp when the event was ingested by CloudWatch Logs, and the ID of the PutLogEvents request.

", "GetLogEvents": "

Lists log events from the specified log stream. You can list all of the log events or filter using a time range.

By default, this operation returns as many log events as can fit in a response size of 1MB (up to 10,000 log events). You can get additional log events by specifying one of the tokens in a subsequent call. This operation can return empty results while there are more log events available through the token.

", "GetLogGroupFields": "

Returns a list of the fields that are included in log events in the specified log group, along with the percentage of log events that contain each field. The search is limited to a time period that you specify.

In the results, fields that start with @ are fields generated by CloudWatch Logs. For example, @timestamp is the timestamp of each log event. For more information about the fields that are generated by CloudWatch logs, see Supported Logs and Discovered Fields.

The response results are sorted by the frequency percentage, starting with the highest percentage.

", @@ -32,24 +32,24 @@ "GetQueryResults": "

Returns the results from the specified query.

Only the fields requested in the query are returned, along with a @ptr field, which is the identifier for the log record. You can use the value of @ptr in a GetLogRecord operation to get the full log record.

GetQueryResults does not start a query execution. To run a query, use StartQuery.

If the value of the Status field in the output is Running, this operation returns only partial results. If you see a value of Scheduled or Running for the status, you can retry the operation later to see the final results.

", "ListTagsLogGroup": "

Lists the tags for the specified log group.

", "PutDestination": "

Creates or updates a destination. This operation is used only to create destinations for cross-account subscriptions.

A destination encapsulates a physical resource (such as an Amazon Kinesis stream) and enables you to subscribe to a real-time stream of log events for a different account, ingested using PutLogEvents.

Through an access policy, a destination controls what is written to it. By default, PutDestination does not set any access policy with the destination, which means a cross-account user cannot call PutSubscriptionFilter against this destination. To enable this, the destination owner must call PutDestinationPolicy after PutDestination.

To perform a PutDestination operation, you must also have the iam:PassRole permission.

", - "PutDestinationPolicy": "

Creates or updates an access policy associated with an existing destination. An access policy is an IAM policy document that is used to authorize claims to register a subscription filter against a given destination.

If multiple AWS accounts are sending logs to this destination, each sender account must be listed separately in the policy. The policy does not support specifying * as the Principal or the use of the aws:PrincipalOrgId global key.

", - "PutLogEvents": "

Uploads a batch of log events to the specified log stream.

You must include the sequence token obtained from the response of the previous call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token in the expectedSequenceToken field from InvalidSequenceTokenException. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls might be successful or one might be rejected.

The batch of events must satisfy the following constraints:

If a call to PutLogEvents returns \"UnrecognizedClientException\" the most likely cause is an invalid AWS access key ID or secret key.

", - "PutMetricFilter": "

Creates or updates a metric filter and associates it with the specified log group. Metric filters allow you to configure rules to extract metric data from log events ingested through PutLogEvents.

The maximum number of metric filters that can be associated with a log group is 100.

When you create a metric filter, you can also optionally assign a unit and dimensions to the metric that is created.

Metrics extracted from log events are charged as custom metrics. To prevent unexpected high charges, do not specify high-cardinality fields such as IPAddress or requestID as dimensions. Each different value found for a dimension is treated as a separate metric and accrues charges as a separate custom metric.

To help prevent accidental high charges, Amazon disables a metric filter if it generates 1000 different name/value pairs for the dimensions that you have specified within a certain amount of time.

You can also set up a billing alarm to alert you if your charges are higher than expected. For more information, see Creating a Billing Alarm to Monitor Your Estimated AWS Charges.

", + "PutDestinationPolicy": "

Creates or updates an access policy associated with an existing destination. An access policy is an IAM policy document that is used to authorize claims to register a subscription filter against a given destination.

If multiple Amazon Web Services accounts are sending logs to this destination, each sender account must be listed separately in the policy. The policy does not support specifying * as the Principal or the use of the aws:PrincipalOrgId global key.

", + "PutLogEvents": "

Uploads a batch of log events to the specified log stream.

You must include the sequence token obtained from the response of the previous call. An upload in a newly created log stream does not require a sequence token. You can also get the sequence token in the expectedSequenceToken field from InvalidSequenceTokenException. If you call PutLogEvents twice within a narrow time period using the same value for sequenceToken, both calls might be successful or one might be rejected.

The batch of events must satisfy the following constraints:

If a call to PutLogEvents returns \"UnrecognizedClientException\" the most likely cause is an invalid Amazon Web Services access key ID or secret key.

", + "PutMetricFilter": "

Creates or updates a metric filter and associates it with the specified log group. Metric filters allow you to configure rules to extract metric data from log events ingested through PutLogEvents.

The maximum number of metric filters that can be associated with a log group is 100.

When you create a metric filter, you can also optionally assign a unit and dimensions to the metric that is created.

Metrics extracted from log events are charged as custom metrics. To prevent unexpected high charges, do not specify high-cardinality fields such as IPAddress or requestID as dimensions. Each different value found for a dimension is treated as a separate metric and accrues charges as a separate custom metric.

To help prevent accidental high charges, Amazon disables a metric filter if it generates 1000 different name/value pairs for the dimensions that you have specified within a certain amount of time.

You can also set up a billing alarm to alert you if your charges are higher than expected. For more information, see Creating a Billing Alarm to Monitor Your Estimated Amazon Web Services Charges.

", "PutQueryDefinition": "

Creates or updates a query definition for CloudWatch Logs Insights. For more information, see Analyzing Log Data with CloudWatch Logs Insights.

To update a query definition, specify its queryDefinitionId in your request. The values of name, queryString, and logGroupNames are changed to the values that you specify in your update operation. No current values are retained from the current query definition. For example, if you update a current query definition that includes log groups, and you don't specify the logGroupNames parameter in your update operation, the query definition changes to contain no log groups.

You must have the logs:PutQueryDefinition permission to be able to perform this operation.

", - "PutResourcePolicy": "

Creates or updates a resource policy allowing other AWS services to put log events to this account, such as Amazon Route 53. An account can have up to 10 resource policies per AWS Region.

", + "PutResourcePolicy": "

Creates or updates a resource policy allowing other Amazon Web Services services to put log events to this account, such as Amazon Route 53. An account can have up to 10 resource policies per Amazon Web Services Region.

", "PutRetentionPolicy": "

Sets the retention of the specified log group. A retention policy allows you to configure the number of days for which to retain log events in the specified log group.

", - "PutSubscriptionFilter": "

Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through PutLogEvents and have them delivered to a specific destination. When log events are sent to the receiving service, they are Base64 encoded and compressed with the gzip format.

The following destinations are supported for subscription filters:

Each log group can have up to two subscription filters associated with it. If you are updating an existing filter, you must specify the correct name in filterName.

To perform a PutSubscriptionFilter operation, you must also have the iam:PassRole permission.

", + "PutSubscriptionFilter": "

Creates or updates a subscription filter and associates it with the specified log group. Subscription filters allow you to subscribe to a real-time stream of log events ingested through PutLogEvents and have them delivered to a specific destination. When log events are sent to the receiving service, they are Base64 encoded and compressed with the gzip format.

The following destinations are supported for subscription filters:

Each log group can have up to two subscription filters associated with it. If you are updating an existing filter, you must specify the correct name in filterName.

To perform a PutSubscriptionFilter operation, you must also have the iam:PassRole permission.

", "StartQuery": "

Schedules a query of a log group using CloudWatch Logs Insights. You specify the log group and time range to query and the query string to use.

For more information, see CloudWatch Logs Insights Query Syntax.

Queries time out after 15 minutes of execution. If your queries are timing out, reduce the time range being searched or partition your query into a number of queries.

", "StopQuery": "

Stops a CloudWatch Logs Insights query that is in progress. If the query has already ended, the operation returns an error indicating that the specified query is not running.

", - "TagLogGroup": "

Adds or updates the specified tags for the specified log group.

To list the tags for a log group, use ListTagsLogGroup. To remove tags, use UntagLogGroup.

For more information about tags, see Tag Log Groups in Amazon CloudWatch Logs in the Amazon CloudWatch Logs User Guide.

", + "TagLogGroup": "

Adds or updates the specified tags for the specified log group.

To list the tags for a log group, use ListTagsLogGroup. To remove tags, use UntagLogGroup.

For more information about tags, see Tag Log Groups in Amazon CloudWatch Logs in the Amazon CloudWatch Logs User Guide.

CloudWatch Logs doesn’t support IAM policies that prevent users from assigning specified tags to log groups using the aws:Resource/key-name or aws:TagKeys condition keys. For more information about using tags to control access, see Controlling access to Amazon Web Services resources using tags.

", "TestMetricFilter": "

Tests the filter pattern of a metric filter against a sample of log event messages. You can use this operation to validate the correctness of a metric filter pattern.

", - "UntagLogGroup": "

Removes the specified tags from the specified log group.

To list the tags for a log group, use ListTagsLogGroup. To add tags, use TagLogGroup.

" + "UntagLogGroup": "

Removes the specified tags from the specified log group.

To list the tags for a log group, use ListTagsLogGroup. To add tags, use TagLogGroup.

CloudWatch Logs doesn’t support IAM policies that prevent users from assigning specified tags to log groups using the aws:Resource/key-name or aws:TagKeys condition keys.

" }, "shapes": { "AccessPolicy": { "base": null, "refs": { - "Destination$accessPolicy": "

An IAM policy document that governs which AWS accounts can create subscription filters against this destination.

", + "Destination$accessPolicy": "

An IAM policy document that governs which Amazon Web Services accounts can create subscription filters against this destination.

", "PutDestinationPolicyRequest$accessPolicy": "

An IAM policy document that authorizes cross-account users to deliver their log events to the associated destination. This can be up to 5120 bytes.

" } }, @@ -97,7 +97,7 @@ } }, "Days": { - "base": "

The number of days to retain the log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, and 3653.

If you omit retentionInDays in a PutRetentionPolicy operation, the events in the log group are always retained and never expire.

", + "base": "

The number of days to retain the log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1827, and 3653.

To set a log group to never have log events expire, use DeleteRetentionPolicy.

", "refs": { "LogGroup$retentionInDays": null, "PutRetentionPolicyRequest$retentionInDays": null @@ -278,7 +278,7 @@ "DestinationArn": { "base": null, "refs": { - "PutSubscriptionFilterRequest$destinationArn": "

The ARN of the destination to deliver matching log events to. Currently, the supported destinations are:

", + "PutSubscriptionFilterRequest$destinationArn": "

The ARN of the destination to deliver matching log events to. Currently, the supported destinations are:

", "SubscriptionFilter$destinationArn": "

The Amazon Resource Name (ARN) of the destination.

" } }, @@ -301,7 +301,7 @@ "Dimensions": { "base": null, "refs": { - "MetricTransformation$dimensions": "

The fields to use as dimensions for the metric. One metric filter can include as many as three dimensions.

Metrics extracted from log events are charged as custom metrics. To prevent unexpected high charges, do not specify high-cardinality fields such as IPAddress or requestID as dimensions. Each different value found for a dimension is treated as a separate metric and accrues charges as a separate custom metric.

To help prevent accidental high charges, Amazon disables a metric filter if it generates 1000 different name/value pairs for the dimensions that you have specified within a certain amount of time.

You can also set up a billing alarm to alert you if your charges are higher than expected. For more information, see Creating a Billing Alarm to Monitor Your Estimated AWS Charges.

" + "MetricTransformation$dimensions": "

The fields to use as dimensions for the metric. One metric filter can include as many as three dimensions.

Metrics extracted from log events are charged as custom metrics. To prevent unexpected high charges, do not specify high-cardinality fields such as IPAddress or requestID as dimensions. Each different value found for a dimension is treated as a separate metric and accrues charges as a separate custom metric.

To help prevent accidental high charges, Amazon disables a metric filter if it generates 1000 different name/value pairs for the dimensions that you have specified within a certain amount of time.

You can also set up a billing alarm to alert you if your charges are higher than expected. For more information, see Creating a Billing Alarm to Monitor Your Estimated Amazon Web Services Charges.

" } }, "DimensionsKey": { @@ -361,7 +361,7 @@ "ExportDestinationBucket": { "base": null, "refs": { - "CreateExportTaskRequest$destination": "

The name of S3 bucket for the exported log data. The bucket must be in the same AWS region.

", + "CreateExportTaskRequest$destination": "

The name of S3 bucket for the exported log data. The bucket must be in the same Amazon Web Services region.

", "ExportTask$destination": "

The name of the S3 bucket to which the log data was exported.

" } }, @@ -573,8 +573,8 @@ "KmsKeyId": { "base": null, "refs": { - "AssociateKmsKeyRequest$kmsKeyId": "

The Amazon Resource Name (ARN) of the CMK to use when encrypting log data. This must be a symmetric CMK. For more information, see Amazon Resource Names - AWS Key Management Service (AWS KMS) and Using Symmetric and Asymmetric Keys.

", - "CreateLogGroupRequest$kmsKeyId": "

The Amazon Resource Name (ARN) of the CMK to use when encrypting log data. For more information, see Amazon Resource Names - AWS Key Management Service (AWS KMS).

", + "AssociateKmsKeyRequest$kmsKeyId": "

The Amazon Resource Name (ARN) of the CMK to use when encrypting log data. This must be a symmetric CMK. For more information, see Amazon Resource Names - Key Management Service and Using Symmetric and Asymmetric Keys.

", + "CreateLogGroupRequest$kmsKeyId": "

The Amazon Resource Name (ARN) of the CMK to use when encrypting log data. For more information, see Amazon Resource Names - Key Management Service.

", "LogGroup$kmsKeyId": "

The Amazon Resource Name (ARN) of the CMK to use when encrypting log data.

" } }, @@ -807,7 +807,7 @@ "DescribeSubscriptionFiltersResponse$nextToken": null, "FilterLogEventsRequest$nextToken": "

The token for the next set of events to return. (You received this token from a previous call.)

", "FilterLogEventsResponse$nextToken": "

The token to use when requesting the next set of items. The token expires after 24 hours.

", - "GetLogEventsRequest$nextToken": "

The token for the next set of items to return. (You received this token from a previous call.)

Using this token works only when you specify true for startFromHead.

", + "GetLogEventsRequest$nextToken": "

The token for the next set of items to return. (You received this token from a previous call.)

", "GetLogEventsResponse$nextForwardToken": "

The token for the next set of items in the forward direction. The token expires after 24 hours. If you have reached the end of the stream, it returns the same token you passed in.

", "GetLogEventsResponse$nextBackwardToken": "

The token for the next set of items in the backward direction. The token expires after 24 hours. This token is never null. If you have reached the end of the stream, it returns the same token you passed in.

" } @@ -844,7 +844,7 @@ "PolicyDocument": { "base": null, "refs": { - "PutResourcePolicyRequest$policyDocument": "

Details of the new policy, including the identity of the principal that is enabled to put logs to this account. This is formatted as a JSON string. This parameter is required.

The following example creates a resource policy enabling the Route 53 service to put DNS query logs in to the specified log group. Replace \"logArn\" with the ARN of your CloudWatch Logs resource, such as a log group or log stream.

{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"Route53LogsToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"route53.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"logArn\" } ] }

", + "PutResourcePolicyRequest$policyDocument": "

Details of the new policy, including the identity of the principal that is enabled to put logs to this account. This is formatted as a JSON string. This parameter is required.

The following example creates a resource policy enabling the Route 53 service to put DNS query logs in to the specified log group. Replace \"logArn\" with the ARN of your CloudWatch Logs resource, such as a log group or log stream.

CloudWatch Logs also supports aws:SourceArn and aws:SourceAccount condition context keys.

In the example resource policy, you would replace the value of SourceArn with the resource making the call from Route 53 to CloudWatch Logs and replace the value of SourceAccount with the Amazon Web Services account ID making that call.

{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"Route53LogsToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"route53.amazonaws.com\" ] }, \"Action\": \"logs:PutLogEvents\", \"Resource\": \"logArn\", \"Condition\": { \"ArnLike\": { \"aws:SourceArn\": \"myRoute53ResourceArn\" }, \"StringEquals\": { \"aws:SourceAccount\": \"myAwsAccountId\" } } } ] }

", "ResourcePolicy$policyDocument": "

The details of the policy.

" } }, @@ -1106,7 +1106,7 @@ "StartFromHead": { "base": null, "refs": { - "GetLogEventsRequest$startFromHead": "

If the value is true, the earliest log events are returned first. If the value is false, the latest log events are returned first. The default value is false.

If you are using nextToken in this operation, you must specify true for startFromHead.

" + "GetLogEventsRequest$startFromHead": "

If the value is true, the earliest log events are returned first. If the value is false, the latest log events are returned first. The default value is false.

If you are using a previous nextForwardToken value as the nextToken in this operation, you must specify true for startFromHead.

" } }, "StartQueryRequest": { @@ -1190,7 +1190,7 @@ "Tags": { "base": null, "refs": { - "CreateLogGroupRequest$tags": "

The key-value pairs to use for the tags.

", + "CreateLogGroupRequest$tags": "

The key-value pairs to use for the tags.

CloudWatch Logs doesn’t support IAM policies that prevent users from assigning specified tags to log groups using the aws:Resource/key-name or aws:TagKeys condition keys. For more information about using tags to control access, see Controlling access to Amazon Web Services resources using tags.

", "ListTagsLogGroupResponse$tags": "

The tags for the log group.

", "TagLogGroupRequest$tags": "

The key-value pairs to use for the tags.

" } @@ -1259,7 +1259,7 @@ } }, "UnrecognizedClientException": { - "base": "

The most likely cause is an invalid AWS access key ID or secret key.

", + "base": "

The most likely cause is an invalid Amazon Web Services access key ID or secret key.

", "refs": { } }, diff --git a/service/cloud9/api.go b/service/cloud9/api.go index 128df1dfa23..646a1ab7954 100644 --- a/service/cloud9/api.go +++ b/service/cloud9/api.go @@ -1565,6 +1565,12 @@ type CreateEnvironmentEC2Input struct { // The description of the environment to create. Description *string `locationName:"description" type:"string" sensitive:"true"` + // Checks whether you have the required permissions for the action, without + // actually making the request, and provides an error response. If you have + // the required permissions, the error response is DryRunOperation. Otherwise, + // it is UnauthorizedOperation. + DryRun *bool `locationName:"dryRun" type:"boolean"` + // The identifier for the Amazon Machine Image (AMI) that's used to create the // EC2 instance. To choose an AMI for the instance, you must specify a valid // AMI alias or a valid Amazon EC2 Systems Manager (SSM) path. @@ -1686,6 +1692,12 @@ func (s *CreateEnvironmentEC2Input) SetDescription(v string) *CreateEnvironmentE return s } +// SetDryRun sets the DryRun field's value. +func (s *CreateEnvironmentEC2Input) SetDryRun(v bool) *CreateEnvironmentEC2Input { + s.DryRun = &v + return s +} + // SetImageId sets the ImageId field's value. func (s *CreateEnvironmentEC2Input) SetImageId(v string) *CreateEnvironmentEC2Input { s.ImageId = &v @@ -3112,6 +3124,19 @@ type UpdateEnvironmentInput struct { // EnvironmentId is a required field EnvironmentId *string `locationName:"environmentId" type:"string" required:"true"` + // Allows the environment owner to turn on or turn off the Amazon Web Services + // managed temporary credentials for an Cloud9 environment by using one of the + // following values: + // + // * ENABLE + // + // * DISABLE + // + // Only the environment owner can change the status of managed temporary credentials. + // An AccessDeniedException is thrown if an attempt to turn on or turn off managed + // temporary credentials is made by an account that's not the environment owner. + ManagedCredentialsAction *string `locationName:"managedCredentialsAction" type:"string" enum:"ManagedCredentialsAction"` + // A replacement name for the environment. Name *string `locationName:"name" min:"1" type:"string"` } @@ -3154,6 +3179,12 @@ func (s *UpdateEnvironmentInput) SetEnvironmentId(v string) *UpdateEnvironmentIn return s } +// SetManagedCredentialsAction sets the ManagedCredentialsAction field's value. +func (s *UpdateEnvironmentInput) SetManagedCredentialsAction(v string) *UpdateEnvironmentInput { + s.ManagedCredentialsAction = &v + return s +} + // SetName sets the Name field's value. func (s *UpdateEnvironmentInput) SetName(v string) *UpdateEnvironmentInput { s.Name = &v @@ -3366,6 +3397,22 @@ func EnvironmentType_Values() []string { } } +const ( + // ManagedCredentialsActionEnable is a ManagedCredentialsAction enum value + ManagedCredentialsActionEnable = "ENABLE" + + // ManagedCredentialsActionDisable is a ManagedCredentialsAction enum value + ManagedCredentialsActionDisable = "DISABLE" +) + +// ManagedCredentialsAction_Values returns all elements of the ManagedCredentialsAction enum +func ManagedCredentialsAction_Values() []string { + return []string{ + ManagedCredentialsActionEnable, + ManagedCredentialsActionDisable, + } +} + const ( // ManagedCredentialsStatusEnabledOnCreate is a ManagedCredentialsStatus enum value ManagedCredentialsStatusEnabledOnCreate = "ENABLED_ON_CREATE" diff --git a/service/clouddirectory/api.go b/service/clouddirectory/api.go index cefd3c08d5e..14484cbbb6b 100644 --- a/service/clouddirectory/api.go +++ b/service/clouddirectory/api.go @@ -95,7 +95,9 @@ func (c *CloudDirectory) AddFacetToObjectRequest(input *AddFacetToObjectInput) ( // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -210,7 +212,9 @@ func (c *CloudDirectory) ApplySchemaRequest(input *ApplySchemaInput) (req *reque // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * SchemaAlreadyExistsException // Indicates that a schema could not be created due to a naming conflict. Please @@ -331,7 +335,9 @@ func (c *CloudDirectory) AttachObjectRequest(input *AttachObjectInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -460,7 +466,9 @@ func (c *CloudDirectory) AttachPolicyRequest(input *AttachPolicyInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -573,7 +581,9 @@ func (c *CloudDirectory) AttachToIndexRequest(input *AttachToIndexInput) (req *r // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -700,7 +710,9 @@ func (c *CloudDirectory) AttachTypedLinkRequest(input *AttachTypedLinkInput) (re // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -823,7 +835,9 @@ func (c *CloudDirectory) BatchReadRequest(input *BatchReadInput) (req *request.R // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -931,7 +945,9 @@ func (c *CloudDirectory) BatchWriteRequest(input *BatchWriteInput) (req *request // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -1046,7 +1062,9 @@ func (c *CloudDirectory) CreateDirectoryRequest(input *CreateDirectoryInput) (re // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryAlreadyExistsException // Indicates that a Directory could not be created due to a naming conflict. @@ -1159,7 +1177,9 @@ func (c *CloudDirectory) CreateFacetRequest(input *CreateFacetInput) (req *reque // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -1277,7 +1297,9 @@ func (c *CloudDirectory) CreateIndexRequest(input *CreateIndexInput) (req *reque // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -1401,7 +1423,9 @@ func (c *CloudDirectory) CreateObjectRequest(input *CreateObjectInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -1534,14 +1558,18 @@ func (c *CloudDirectory) CreateSchemaRequest(input *CreateSchemaInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * SchemaAlreadyExistsException // Indicates that a schema could not be created due to a naming conflict. Please // select a different name and then try again. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // See also, https://docs.aws.amazon.com/goto/WebAPI/clouddirectory-2017-01-11/CreateSchema func (c *CloudDirectory) CreateSchema(input *CreateSchemaInput) (*CreateSchemaOutput, error) { @@ -1646,7 +1674,9 @@ func (c *CloudDirectory) CreateTypedLinkFacetRequest(input *CreateTypedLinkFacet // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -1759,7 +1789,9 @@ func (c *CloudDirectory) DeleteDirectoryRequest(input *DeleteDirectoryInput) (re // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryDeletedException // A directory that has been deleted and to which access has been attempted. @@ -1880,7 +1912,9 @@ func (c *CloudDirectory) DeleteFacetRequest(input *DeleteFacetInput) (req *reque // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -1998,7 +2032,9 @@ func (c *CloudDirectory) DeleteObjectRequest(input *DeleteObjectInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -2113,7 +2149,9 @@ func (c *CloudDirectory) DeleteSchemaRequest(input *DeleteSchemaInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -2225,7 +2263,9 @@ func (c *CloudDirectory) DeleteTypedLinkFacetRequest(input *DeleteTypedLinkFacet // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -2335,7 +2375,9 @@ func (c *CloudDirectory) DetachFromIndexRequest(input *DetachFromIndexInput) (re // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -2452,7 +2494,9 @@ func (c *CloudDirectory) DetachObjectRequest(input *DetachObjectInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -2567,7 +2611,9 @@ func (c *CloudDirectory) DetachPolicyRequest(input *DetachPolicyInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -2682,7 +2728,9 @@ func (c *CloudDirectory) DetachTypedLinkRequest(input *DetachTypedLinkInput) (re // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -2794,7 +2842,9 @@ func (c *CloudDirectory) DisableDirectoryRequest(input *DisableDirectoryInput) ( // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * RetryableConflictException // Occurs when a conflict with a previous successful write is detected. For @@ -2906,7 +2956,9 @@ func (c *CloudDirectory) EnableDirectoryRequest(input *EnableDirectoryInput) (re // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * RetryableConflictException // Occurs when a conflict with a previous successful write is detected. For @@ -3022,7 +3074,9 @@ func (c *CloudDirectory) GetAppliedSchemaVersionRequest(input *GetAppliedSchemaV // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -3129,7 +3183,9 @@ func (c *CloudDirectory) GetDirectoryRequest(input *GetDirectoryInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // See also, https://docs.aws.amazon.com/goto/WebAPI/clouddirectory-2017-01-11/GetDirectory func (c *CloudDirectory) GetDirectory(input *GetDirectoryInput) (*GetDirectoryOutput, error) { @@ -3235,7 +3291,9 @@ func (c *CloudDirectory) GetFacetRequest(input *GetFacetInput) (req *request.Req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -3345,7 +3403,9 @@ func (c *CloudDirectory) GetLinkAttributesRequest(input *GetLinkAttributesInput) // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -3459,7 +3519,9 @@ func (c *CloudDirectory) GetObjectAttributesRequest(input *GetObjectAttributesIn // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -3573,7 +3635,9 @@ func (c *CloudDirectory) GetObjectInformationRequest(input *GetObjectInformation // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -3684,7 +3748,9 @@ func (c *CloudDirectory) GetSchemaAsJsonRequest(input *GetSchemaAsJsonInput) (re // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -3796,7 +3862,9 @@ func (c *CloudDirectory) GetTypedLinkFacetInformationRequest(input *GetTypedLink // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -3916,7 +3984,9 @@ func (c *CloudDirectory) ListAppliedSchemaArnsRequest(input *ListAppliedSchemaAr // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -4084,7 +4154,9 @@ func (c *CloudDirectory) ListAttachedIndicesRequest(input *ListAttachedIndicesIn // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -4252,7 +4324,9 @@ func (c *CloudDirectory) ListDevelopmentSchemaArnsRequest(input *ListDevelopment // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -4420,7 +4494,9 @@ func (c *CloudDirectory) ListDirectoriesRequest(input *ListDirectoriesInput) (re // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * InvalidNextTokenException // Indicates that the NextToken value is not valid. @@ -4585,7 +4661,9 @@ func (c *CloudDirectory) ListFacetAttributesRequest(input *ListFacetAttributesIn // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -4756,7 +4834,9 @@ func (c *CloudDirectory) ListFacetNamesRequest(input *ListFacetNamesInput) (req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -4920,7 +5000,9 @@ func (c *CloudDirectory) ListIncomingTypedLinksRequest(input *ListIncomingTypedL // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -5047,7 +5129,9 @@ func (c *CloudDirectory) ListIndexRequest(input *ListIndexInput) (req *request.R // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -5211,7 +5295,9 @@ func (c *CloudDirectory) ListManagedSchemaArnsRequest(input *ListManagedSchemaAr // message. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -5379,7 +5465,9 @@ func (c *CloudDirectory) ListObjectAttributesRequest(input *ListObjectAttributes // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -5555,7 +5643,9 @@ func (c *CloudDirectory) ListObjectChildrenRequest(input *ListObjectChildrenInpu // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -5740,7 +5830,9 @@ func (c *CloudDirectory) ListObjectParentPathsRequest(input *ListObjectParentPat // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -5912,7 +6004,9 @@ func (c *CloudDirectory) ListObjectParentsRequest(input *ListObjectParentsInput) // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -6086,7 +6180,9 @@ func (c *CloudDirectory) ListObjectPoliciesRequest(input *ListObjectPoliciesInpu // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -6253,7 +6349,9 @@ func (c *CloudDirectory) ListOutgoingTypedLinksRequest(input *ListOutgoingTypedL // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -6376,7 +6474,9 @@ func (c *CloudDirectory) ListPolicyAttachmentsRequest(input *ListPolicyAttachmen // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -6552,7 +6652,9 @@ func (c *CloudDirectory) ListPublishedSchemaArnsRequest(input *ListPublishedSche // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -6722,7 +6824,9 @@ func (c *CloudDirectory) ListTagsForResourceRequest(input *ListTagsForResourceIn // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -6893,7 +6997,9 @@ func (c *CloudDirectory) ListTypedLinkFacetAttributesRequest(input *ListTypedLin // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -7065,7 +7171,9 @@ func (c *CloudDirectory) ListTypedLinkFacetNamesRequest(input *ListTypedLinkFace // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -7239,7 +7347,9 @@ func (c *CloudDirectory) LookupPolicyRequest(input *LookupPolicyInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -7405,7 +7515,9 @@ func (c *CloudDirectory) PublishSchemaRequest(input *PublishSchemaInput) (req *r // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -7517,7 +7629,9 @@ func (c *CloudDirectory) PutSchemaFromJsonRequest(input *PutSchemaFromJsonInput) // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * InvalidSchemaDocException // Indicates that the provided SchemaDoc value is not valid. @@ -7628,7 +7742,9 @@ func (c *CloudDirectory) RemoveFacetFromObjectRequest(input *RemoveFacetFromObje // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -7743,7 +7859,9 @@ func (c *CloudDirectory) TagResourceRequest(input *TagResourceInput) (req *reque // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -7856,7 +7974,9 @@ func (c *CloudDirectory) UntagResourceRequest(input *UntagResourceInput) (req *r // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -7975,7 +8095,9 @@ func (c *CloudDirectory) UpdateFacetRequest(input *UpdateFacetInput) (req *reque // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * InvalidFacetUpdateException // An attempt to modify a Facet resulted in an invalid schema exception. @@ -8097,7 +8219,9 @@ func (c *CloudDirectory) UpdateLinkAttributesRequest(input *UpdateLinkAttributes // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -8211,7 +8335,9 @@ func (c *CloudDirectory) UpdateObjectAttributesRequest(input *UpdateObjectAttrib // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * DirectoryNotEnabledException // Operations are only permitted on enabled directories. @@ -8330,7 +8456,9 @@ func (c *CloudDirectory) UpdateSchemaRequest(input *UpdateSchemaInput) (req *req // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -8438,7 +8566,9 @@ func (c *CloudDirectory) UpdateTypedLinkFacetRequest(input *UpdateTypedLinkFacet // for more information. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * FacetValidationException // The Facet that you provided was not well formed or could not be validated @@ -8564,7 +8694,9 @@ func (c *CloudDirectory) UpgradeAppliedSchemaRequest(input *UpgradeAppliedSchema // the directory. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -8682,7 +8814,9 @@ func (c *CloudDirectory) UpgradePublishedSchemaRequest(input *UpgradePublishedSc // the directory. // // * AccessDeniedException -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. // // * ResourceNotFoundException // The specified resource could not be found. @@ -8718,7 +8852,9 @@ func (c *CloudDirectory) UpgradePublishedSchemaWithContext(ctx aws.Context, inpu return out, req.Send() } -// Access denied. Check your permissions. +// Access denied or directory not found. Either you don't have permissions for +// this directory or the directory does not exist. Try calling ListDirectories +// and check your permissions. type AccessDeniedException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -11523,11 +11659,16 @@ func (s *BatchListObjectParentPathsResponse) SetPathToObjectIdentifiersList(v [] return s } +// Lists parent objects that are associated with a given object in pagination +// fashion. type BatchListObjectParents struct { _ struct{} `type:"structure"` + // The maximum number of items to be retrieved in a single call. This is an + // approximate number. MaxResults *int64 `min:"1" type:"integer"` + // The pagination token. NextToken *string `type:"string"` // The reference that identifies an object. @@ -11580,11 +11721,14 @@ func (s *BatchListObjectParents) SetObjectReference(v *ObjectReference) *BatchLi return s } +// Represents the output of a ListObjectParents response operation. type BatchListObjectParentsResponse struct { _ struct{} `type:"structure"` + // The pagination token. NextToken *string `type:"string"` + // Returns a list of parent reference and LinkName Tuples. ParentLinks []*ObjectIdentifierAndLinkNameTuple `type:"list"` } @@ -12170,6 +12314,8 @@ type BatchReadOperation struct { // see Directory Structure (https://docs.aws.amazon.com/clouddirectory/latest/developerguide/key_concepts_directorystructure.html). ListObjectParentPaths *BatchListObjectParentPaths `type:"structure"` + // Lists parent objects that are associated with a given object in pagination + // fashion. ListObjectParents *BatchListObjectParents `type:"structure"` // Returns policies attached to an object in pagination fashion. @@ -12459,6 +12605,7 @@ type BatchReadSuccessfulResponse struct { // see Directory Structure (https://docs.aws.amazon.com/clouddirectory/latest/developerguide/key_concepts_directorystructure.html). ListObjectParentPaths *BatchListObjectParentPathsResponse `type:"structure"` + // The list of parent objects to retrieve. ListObjectParents *BatchListObjectParentsResponse `type:"structure"` // Returns policies attached to an object in pagination fashion. @@ -19912,7 +20059,9 @@ type ObjectReference struct { // * $ObjectIdentifier - An object identifier is an opaque string provided // by Amazon Cloud Directory. When creating objects, the system will provide // you with the identifier of the created object. An object’s identifier - // is immutable and no two objects will ever share the same object identifier + // is immutable and no two objects will ever share the same object identifier. + // To identify an object with ObjectIdentifier, the ObjectIdentifier must + // be wrapped in double quotes. // // * /some/path - Identifies the object based on path // @@ -20584,12 +20733,13 @@ func (s *SchemaAlreadyPublishedException) RequestID() string { type SchemaFacet struct { _ struct{} `type:"structure"` - // The name of the facet. + // The name of the facet. If this value is set, SchemaArn must also be set. FacetName *string `min:"1" type:"string"` // The ARN of the schema that contains the facet with no minor component. See // arns and In-Place Schema Upgrade (https://docs.aws.amazon.com/clouddirectory/latest/developerguide/schemas_inplaceschemaupgrade.html) - // for a description of when to provide minor versions. + // for a description of when to provide minor versions. If this value is set, + // FacetName must also be set. SchemaArn *string `type:"string"` } diff --git a/service/clouddirectory/errors.go b/service/clouddirectory/errors.go index 53ef79f9b7e..17f1ee1e82f 100644 --- a/service/clouddirectory/errors.go +++ b/service/clouddirectory/errors.go @@ -11,7 +11,9 @@ const ( // ErrCodeAccessDeniedException for service response error code // "AccessDeniedException". // - // Access denied. Check your permissions. + // Access denied or directory not found. Either you don't have permissions for + // this directory or the directory does not exist. Try calling ListDirectories + // and check your permissions. ErrCodeAccessDeniedException = "AccessDeniedException" // ErrCodeBatchWriteException for service response error code diff --git a/service/cloudwatchlogs/api.go b/service/cloudwatchlogs/api.go index f797ee79b84..d4933ca2c01 100644 --- a/service/cloudwatchlogs/api.go +++ b/service/cloudwatchlogs/api.go @@ -57,15 +57,15 @@ func (c *CloudWatchLogs) AssociateKmsKeyRequest(input *AssociateKmsKeyInput) (re // AssociateKmsKey API operation for Amazon CloudWatch Logs. // -// Associates the specified AWS Key Management Service (AWS KMS) customer master -// key (CMK) with the specified log group. +// Associates the specified Key Management Service customer master key (CMK) +// with the specified log group. // -// Associating an AWS KMS CMK with a log group overrides any existing associations +// Associating an KMS CMK with a log group overrides any existing associations // between the log group and a CMK. After a CMK is associated with a log group, // all newly ingested data for the log group is encrypted using the CMK. This // association is stored as long as the data encrypted with the CMK is still -// within Amazon CloudWatch Logs. This enables Amazon CloudWatch Logs to decrypt -// this data whenever it is requested. +// within CloudWatch Logs. This enables CloudWatch Logs to decrypt this data +// whenever it is requested. // // CloudWatch Logs supports only symmetric CMKs. Do not use an associate an // asymmetric CMK with your log group. For more information, see Using Symmetric @@ -370,7 +370,8 @@ func (c *CloudWatchLogs) CreateLogGroupRequest(input *CreateLogGroupInput) (req // // You must use the following guidelines when naming a log group: // -// * Log group names must be unique within a region for an AWS account. +// * Log group names must be unique within a region for an Amazon Web Services +// account. // // * Log group names can be between 1 and 512 characters long. // @@ -382,11 +383,10 @@ func (c *CloudWatchLogs) CreateLogGroupRequest(input *CreateLogGroupInput) (req // expire. To set a retention policy so that events expire and are deleted after // a specified time, use PutRetentionPolicy (https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutRetentionPolicy.html). // -// If you associate a AWS Key Management Service (AWS KMS) customer master key -// (CMK) with the log group, ingested data is encrypted using the CMK. This -// association is stored as long as the data encrypted with the CMK is still -// within Amazon CloudWatch Logs. This enables Amazon CloudWatch Logs to decrypt -// this data whenever it is requested. +// If you associate a Key Management Service customer master key (CMK) with +// the log group, ingested data is encrypted using the CMK. This association +// is stored as long as the data encrypted with the CMK is still within CloudWatch +// Logs. This enables CloudWatch Logs to decrypt this data whenever it is requested. // // If you attempt to associate a CMK with the log group but the CMK does not // exist or the CMK is disabled, you receive an InvalidParameterException error. @@ -1540,6 +1540,13 @@ func (c *CloudWatchLogs) DescribeLogGroupsRequest(input *DescribeLogGroupsInput) // Lists the specified log groups. You can list all your log groups or filter // the results by prefix. The results are ASCII-sorted by log group name. // +// CloudWatch Logs doesn’t support IAM policies that control access to the +// DescribeLogGroups action by using the aws:ResourceTag/key-name condition +// key. Other CloudWatch Logs actions do support the use of the aws:ResourceTag/key-name +// condition key to control access. For more information about using tags to +// control access, see Controlling access to Amazon Web Services resources using +// tags (https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html). +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -2371,13 +2378,13 @@ func (c *CloudWatchLogs) DisassociateKmsKeyRequest(input *DisassociateKmsKeyInpu // DisassociateKmsKey API operation for Amazon CloudWatch Logs. // -// Disassociates the associated AWS Key Management Service (AWS KMS) customer -// master key (CMK) from the specified log group. +// Disassociates the associated Key Management Service customer master key (CMK) +// from the specified log group. // -// After the AWS KMS CMK is disassociated from the log group, AWS CloudWatch -// Logs stops encrypting newly ingested data for the log group. All previously -// ingested data remains encrypted, and AWS CloudWatch Logs requires permissions -// for the CMK whenever the encrypted data is requested. +// After the KMS CMK is disassociated from the log group, CloudWatch Logs stops +// encrypting newly ingested data for the log group. All previously ingested +// data remains encrypted, and CloudWatch Logs requires permissions for the +// CMK whenever the encrypted data is requested. // // Note that it can take up to 5 minutes for this operation to take effect. // @@ -3251,10 +3258,10 @@ func (c *CloudWatchLogs) PutDestinationPolicyRequest(input *PutDestinationPolicy // that is used to authorize claims to register a subscription filter against // a given destination. // -// If multiple AWS accounts are sending logs to this destination, each sender -// account must be listed separately in the policy. The policy does not support -// specifying * as the Principal or the use of the aws:PrincipalOrgId global -// key. +// If multiple Amazon Web Services accounts are sending logs to this destination, +// each sender account must be listed separately in the policy. The policy does +// not support specifying * as the Principal or the use of the aws:PrincipalOrgId +// global key. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3361,9 +3368,10 @@ func (c *CloudWatchLogs) PutLogEventsRequest(input *PutLogEventsInput) (req *req // // * The log events in the batch must be in chronological order by their // timestamp. The timestamp is the time the event occurred, expressed as -// the number of milliseconds after Jan 1, 1970 00:00:00 UTC. (In AWS Tools -// for PowerShell and the AWS SDK for .NET, the timestamp is specified in -// .NET format: yyyy-mm-ddThh:mm:ss. For example, 2017-09-15T13:45:30.) +// the number of milliseconds after Jan 1, 1970 00:00:00 UTC. (In Amazon +// Web Services Tools for PowerShell and the Amazon Web Services SDK for +// .NET, the timestamp is specified in .NET format: yyyy-mm-ddThh:mm:ss. +// For example, 2017-09-15T13:45:30.) // // * A batch of log events in a single request cannot span more than 24 hours. // Otherwise, the operation fails. @@ -3374,7 +3382,7 @@ func (c *CloudWatchLogs) PutLogEventsRequest(input *PutLogEventsInput) (req *req // requests are throttled. This quota can't be changed. // // If a call to PutLogEvents returns "UnrecognizedClientException" the most -// likely cause is an invalid AWS access key ID or secret key. +// likely cause is an invalid Amazon Web Services access key ID or secret key. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3401,7 +3409,8 @@ func (c *CloudWatchLogs) PutLogEventsRequest(input *PutLogEventsInput) (req *req // The service cannot complete the request. // // * UnrecognizedClientException -// The most likely cause is an invalid AWS access key ID or secret key. +// The most likely cause is an invalid Amazon Web Services access key ID or +// secret key. // // See also, https://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutLogEvents func (c *CloudWatchLogs) PutLogEvents(input *PutLogEventsInput) (*PutLogEventsOutput, error) { @@ -3491,7 +3500,7 @@ func (c *CloudWatchLogs) PutMetricFilterRequest(input *PutMetricFilterInput) (re // // You can also set up a billing alarm to alert you if your charges are higher // than expected. For more information, see Creating a Billing Alarm to Monitor -// Your Estimated AWS Charges (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html). +// Your Estimated Amazon Web Services Charges (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3679,9 +3688,9 @@ func (c *CloudWatchLogs) PutResourcePolicyRequest(input *PutResourcePolicyInput) // PutResourcePolicy API operation for Amazon CloudWatch Logs. // -// Creates or updates a resource policy allowing other AWS services to put log -// events to this account, such as Amazon Route 53. An account can have up to -// 10 resource policies per AWS Region. +// Creates or updates a resource policy allowing other Amazon Web Services services +// to put log events to this account, such as Amazon Route 53. An account can +// have up to 10 resource policies per Amazon Web Services Region. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3876,7 +3885,7 @@ func (c *CloudWatchLogs) PutSubscriptionFilterRequest(input *PutSubscriptionFilt // * An Amazon Kinesis Firehose delivery stream that belongs to the same // account as the subscription filter, for same-account delivery. // -// * An AWS Lambda function that belongs to the same account as the subscription +// * An Lambda function that belongs to the same account as the subscription // filter, for same-account delivery. // // Each log group can have up to two subscription filters associated with it. @@ -4174,6 +4183,11 @@ func (c *CloudWatchLogs) TagLogGroupRequest(input *TagLogGroupInput) (req *reque // Logs (https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#log-group-tagging) // in the Amazon CloudWatch Logs User Guide. // +// CloudWatch Logs doesn’t support IAM policies that prevent users from assigning +// specified tags to log groups using the aws:Resource/key-name or aws:TagKeys +// condition keys. For more information about using tags to control access, +// see Controlling access to Amazon Web Services resources using tags (https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html). +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -4344,6 +4358,10 @@ func (c *CloudWatchLogs) UntagLogGroupRequest(input *UntagLogGroupInput) (req *r // To list the tags for a log group, use ListTagsLogGroup (https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsLogGroup.html). // To add tags, use TagLogGroup (https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TagLogGroup.html). // +// CloudWatch Logs doesn’t support IAM policies that prevent users from assigning +// specified tags to log groups using the aws:Resource/key-name or aws:TagKeys +// condition keys. +// // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about // the error. @@ -4382,7 +4400,7 @@ type AssociateKmsKeyInput struct { // The Amazon Resource Name (ARN) of the CMK to use when encrypting log data. // This must be a symmetric CMK. For more information, see Amazon Resource Names - // - AWS Key Management Service (AWS KMS) (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-kms) + // - Key Management Service (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-kms) // and Using Symmetric and Asymmetric Keys (https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html). // // KmsKeyId is a required field @@ -4508,7 +4526,7 @@ type CreateExportTaskInput struct { _ struct{} `type:"structure"` // The name of S3 bucket for the exported log data. The bucket must be in the - // same AWS region. + // same Amazon Web Services region. // // Destination is a required field Destination *string `locationName:"destination" min:"1" type:"string" required:"true"` @@ -4657,8 +4675,8 @@ type CreateLogGroupInput struct { _ struct{} `type:"structure"` // The Amazon Resource Name (ARN) of the CMK to use when encrypting log data. - // For more information, see Amazon Resource Names - AWS Key Management Service - // (AWS KMS) (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-kms). + // For more information, see Amazon Resource Names - Key Management Service + // (https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html#arn-syntax-kms). KmsKeyId *string `locationName:"kmsKeyId" type:"string"` // The name of the log group. @@ -4667,6 +4685,11 @@ type CreateLogGroupInput struct { LogGroupName *string `locationName:"logGroupName" min:"1" type:"string" required:"true"` // The key-value pairs to use for the tags. + // + // CloudWatch Logs doesn’t support IAM policies that prevent users from assigning + // specified tags to log groups using the aws:Resource/key-name or aws:TagKeys + // condition keys. For more information about using tags to control access, + // see Controlling access to Amazon Web Services resources using tags (https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html). Tags map[string]*string `locationName:"tags" min:"1" type:"map"` } @@ -6315,8 +6338,8 @@ func (s *DescribeSubscriptionFiltersOutput) SetSubscriptionFilters(v []*Subscrip type Destination struct { _ struct{} `type:"structure"` - // An IAM policy document that governs which AWS accounts can create subscription - // filters against this destination. + // An IAM policy document that governs which Amazon Web Services accounts can + // create subscription filters against this destination. AccessPolicy *string `locationName:"accessPolicy" min:"1" type:"string"` // The ARN of this destination. @@ -6888,15 +6911,14 @@ type GetLogEventsInput struct { // The token for the next set of items to return. (You received this token from // a previous call.) - // - // Using this token works only when you specify true for startFromHead. NextToken *string `locationName:"nextToken" min:"1" type:"string"` // If the value is true, the earliest log events are returned first. If the // value is false, the latest log events are returned first. The default value // is false. // - // If you are using nextToken in this operation, you must specify true for startFromHead. + // If you are using a previous nextForwardToken value as the nextToken in this + // operation, you must specify true for startFromHead. StartFromHead *bool `locationName:"startFromHead" type:"boolean"` // The start of the time range, expressed as the number of milliseconds after @@ -7640,8 +7662,8 @@ type LogGroup struct { // values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, // 1827, and 3653. // - // If you omit retentionInDays in a PutRetentionPolicy operation, the events - // in the log group are always retained and never expire. + // To set a log group to never have log events expire, use DeleteRetentionPolicy + // (https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteRetentionPolicy.html). RetentionInDays *int64 `locationName:"retentionInDays" type:"integer"` // The number of bytes stored. @@ -8029,7 +8051,7 @@ type MetricTransformation struct { // // You can also set up a billing alarm to alert you if your charges are higher // than expected. For more information, see Creating a Billing Alarm to Monitor - // Your Estimated AWS Charges (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html). + // Your Estimated Amazon Web Services Charges (https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html). Dimensions map[string]*string `locationName:"dimensions" type:"map"` // The name of the CloudWatch metric. @@ -8761,9 +8783,20 @@ type PutResourcePolicyInput struct { // to put DNS query logs in to the specified log group. Replace "logArn" with // the ARN of your CloudWatch Logs resource, such as a log group or log stream. // + // CloudWatch Logs also supports aws:SourceArn (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn) + // and aws:SourceAccount (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount) + // condition context keys. + // + // In the example resource policy, you would replace the value of SourceArn + // with the resource making the call from Route 53 to CloudWatch Logs and replace + // the value of SourceAccount with the Amazon Web Services account ID making + // that call. + // // { "Version": "2012-10-17", "Statement": [ { "Sid": "Route53LogsToCloudWatchLogs", // "Effect": "Allow", "Principal": { "Service": [ "route53.amazonaws.com" ] - // }, "Action":"logs:PutLogEvents", "Resource": "logArn" } ] } + // }, "Action": "logs:PutLogEvents", "Resource": "logArn", "Condition": { "ArnLike": + // { "aws:SourceArn": "myRoute53ResourceArn" }, "StringEquals": { "aws:SourceAccount": + // "myAwsAccountId" } } } ] } PolicyDocument *string `locationName:"policyDocument" min:"1" type:"string"` // Name of the new policy. This parameter is required. @@ -8840,8 +8873,8 @@ type PutRetentionPolicyInput struct { // values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, // 1827, and 3653. // - // If you omit retentionInDays in a PutRetentionPolicy operation, the events - // in the log group are always retained and never expire. + // To set a log group to never have log events expire, use DeleteRetentionPolicy + // (https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteRetentionPolicy.html). // // RetentionInDays is a required field RetentionInDays *int64 `locationName:"retentionInDays" type:"integer" required:"true"` @@ -8920,7 +8953,7 @@ type PutSubscriptionFilterInput struct { // * An Amazon Kinesis Firehose delivery stream belonging to the same account // as the subscription filter, for same-account delivery. // - // * An AWS Lambda function belonging to the same account as the subscription + // * A Lambda function belonging to the same account as the subscription // filter, for same-account delivery. // // DestinationArn is a required field @@ -10041,7 +10074,8 @@ func (s *TestMetricFilterOutput) SetMatches(v []*MetricFilterMatchRecord) *TestM return s } -// The most likely cause is an invalid AWS access key ID or secret key. +// The most likely cause is an invalid Amazon Web Services access key ID or +// secret key. type UnrecognizedClientException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` diff --git a/service/cloudwatchlogs/doc.go b/service/cloudwatchlogs/doc.go index 25a2f52ef29..2c26e3ed204 100644 --- a/service/cloudwatchlogs/doc.go +++ b/service/cloudwatchlogs/doc.go @@ -4,10 +4,10 @@ // requests to Amazon CloudWatch Logs. // // You can use Amazon CloudWatch Logs to monitor, store, and access your log -// files from EC2 instances, AWS CloudTrail, and other sources. You can then -// retrieve the associated log data from CloudWatch Logs using the CloudWatch -// console, CloudWatch Logs commands in the AWS CLI, CloudWatch Logs API, or -// CloudWatch Logs SDK. +// files from EC2 instances, CloudTrail, and other sources. You can then retrieve +// the associated log data from CloudWatch Logs using the CloudWatch console, +// CloudWatch Logs commands in the Amazon Web Services CLI, CloudWatch Logs +// API, or CloudWatch Logs SDK. // // You can use CloudWatch Logs to: // @@ -23,7 +23,7 @@ // the term you are searching for is found, CloudWatch Logs reports the data // to a CloudWatch metric that you specify. // -// * Monitor AWS CloudTrail logged events: You can create alarms in CloudWatch +// * Monitor CloudTrail logged events: You can create alarms in CloudWatch // and receive notifications of particular API activity as captured by CloudTrail. // You can use the notification to perform troubleshooting. // diff --git a/service/cloudwatchlogs/errors.go b/service/cloudwatchlogs/errors.go index 44e3bb576f1..52e58e3c68d 100644 --- a/service/cloudwatchlogs/errors.go +++ b/service/cloudwatchlogs/errors.go @@ -76,7 +76,8 @@ const ( // ErrCodeUnrecognizedClientException for service response error code // "UnrecognizedClientException". // - // The most likely cause is an invalid AWS access key ID or secret key. + // The most likely cause is an invalid Amazon Web Services access key ID or + // secret key. ErrCodeUnrecognizedClientException = "UnrecognizedClientException" ) diff --git a/service/costexplorer/api.go b/service/costexplorer/api.go index e9c16871066..81594deea89 100644 --- a/service/costexplorer/api.go +++ b/service/costexplorer/api.go @@ -641,8 +641,8 @@ func (c *CostExplorer) GetAnomaliesRequest(input *GetAnomaliesInput) (req *reque // GetAnomalies API operation for AWS Cost Explorer Service. // -// Retrieves all of the cost anomalies detected on your account, during the -// time period specified by the DateInterval object. +// Retrieves all of the cost anomalies detected on your account during the time +// period that's specified by the DateInterval object. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -897,12 +897,13 @@ func (c *CostExplorer) GetCostAndUsageRequest(input *GetCostAndUsageInput) (req // GetCostAndUsage API operation for AWS Cost Explorer Service. // // Retrieves cost and usage metrics for your account. You can specify which -// cost and usage-related metric, such as BlendedCosts or UsageQuantity, that -// you want the request to return. You can also filter and group your data by -// various dimensions, such as SERVICE or AZ, in a specific time range. For -// a complete list of valid dimensions, see the GetDimensionValues (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html) -// operation. Management account in an organization in AWS Organizations have -// access to all member accounts. +// cost and usage-related metric that you want the request to return. For example, +// you can specify BlendedCosts or UsageQuantity. You can also filter and group +// your data by various dimensions, such as SERVICE or AZ, in a specific time +// range. For a complete list of valid dimensions, see the GetDimensionValues +// (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html) +// operation. Management account in an organization in Organizations have access +// to all member accounts. // // For information about filter limitations, see Quotas and restrictions (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-limits.html) // in the Billing and Cost Management User Guide. @@ -1002,14 +1003,14 @@ func (c *CostExplorer) GetCostAndUsageWithResourcesRequest(input *GetCostAndUsag // that you want the request to return. You can also filter and group your data // by various dimensions, such as SERVICE or AZ, in a specific time range. For // a complete list of valid dimensions, see the GetDimensionValues (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html) -// operation. Management account in an organization in AWS Organizations have -// access to all member accounts. This API is currently available for the Amazon -// Elastic Compute Cloud – Compute service only. +// operation. Management account in an organization in Organizations have access +// to all member accounts. This API is currently available for the Amazon Elastic +// Compute Cloud – Compute service only. // // This is an opt-in only feature. You can enable this feature from the Cost // Explorer Settings page. For information on how to access the Settings page, // see Controlling Access for Cost Explorer (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/ce-access.html) -// in the AWS Billing and Cost Management User Guide. +// in the Billing and Cost Management User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1493,20 +1494,22 @@ func (c *CostExplorer) GetReservationPurchaseRecommendationRequest(input *GetRes // could help you reduce your costs. Reservations provide a discounted hourly // rate (up to 75%) compared to On-Demand pricing. // -// AWS generates your recommendations by identifying your On-Demand usage during -// a specific time period and collecting your usage into categories that are -// eligible for a reservation. After AWS has these categories, it simulates -// every combination of reservations in each category of usage to identify the -// best number of each type of RI to purchase to maximize your estimated savings. -// -// For example, AWS automatically aggregates your Amazon EC2 Linux, shared tenancy, -// and c4 family usage in the US West (Oregon) Region and recommends that you -// buy size-flexible regional reservations to apply to the c4 family usage. -// AWS recommends the smallest size instance in an instance family. This makes -// it easier to purchase a size-flexible RI. AWS also shows the equal number -// of normalized units so that you can purchase any instance size that you want. -// For this example, your RI recommendation would be for c4.large because that -// is the smallest size instance in the c4 instance family. +// Amazon Web Services generates your recommendations by identifying your On-Demand +// usage during a specific time period and collecting your usage into categories +// that are eligible for a reservation. After Amazon Web Services has these +// categories, it simulates every combination of reservations in each category +// of usage to identify the best number of each type of RI to purchase to maximize +// your estimated savings. +// +// For example, Amazon Web Services automatically aggregates your Amazon EC2 +// Linux, shared tenancy, and c4 family usage in the US West (Oregon) Region +// and recommends that you buy size-flexible regional reservations to apply +// to the c4 family usage. Amazon Web Services recommends the smallest size +// instance in an instance family. This makes it easier to purchase a size-flexible +// RI. Amazon Web Services also shows the equal number of normalized units so +// that you can purchase any instance size that you want. For this example, +// your RI recommendation would be for c4.large because that is the smallest +// size instance in the c4 instance family. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1685,7 +1688,7 @@ func (c *CostExplorer) GetRightsizingRecommendationRequest(input *GetRightsizing // Recommendations are generated to either downsize or terminate instances, // along with providing savings detail and metrics. For details on calculation // and function, see Optimizing Your Cost with Rightsizing Recommendations (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/ce-rightsizing.html) -// in the AWS Billing and Cost Management User Guide. +// in the Billing and Cost Management User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2649,7 +2652,7 @@ func (c *CostExplorer) UpdateAnomalyMonitorRequest(input *UpdateAnomalyMonitorIn // UpdateAnomalyMonitor API operation for AWS Cost Explorer Service. // // Updates an existing cost anomaly monitor. The changes made are applied going -// forward, and does not change anomalies detected in the past. +// forward, and doesn'tt change anomalies detected in the past. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2881,7 +2884,8 @@ type Anomaly struct { // The first day the anomaly is detected. AnomalyStartDate *string `type:"string"` - // The dimension for the anomaly. For example, an AWS service in a service monitor. + // The dimension for the anomaly (for example, an Amazon Web Services service + // in a service monitor). DimensionValue *string `type:"string"` // The feedback value. @@ -3013,9 +3017,9 @@ func (s *AnomalyDateInterval) SetStartDate(v string) *AnomalyDateInterval { return s } -// This object continuously inspects your account's cost data for anomalies, -// based on MonitorType and MonitorSpecification. The content consists of detailed -// metadata and the current status of the monitor object. +// This object continuously inspects your account's cost data for anomalies. +// It's based on MonitorType and MonitorSpecification. The content consists +// of detailed metadata and the current status of the monitor object. type AnomalyMonitor struct { _ struct{} `type:"structure"` @@ -3048,7 +3052,7 @@ type AnomalyMonitor struct { // for the filters that you plan to use. For example, you can filter for // REGION==us-east-1 OR REGION==us-west-1. For GetRightsizingRecommendation, // the Region is a full name (for example, REGION==US East (N. Virginia). - // The Expression example looks like: { "Dimensions": { "Key": "REGION", + // The Expression example is as follows: { "Dimensions": { "Key": "REGION", // "Values": [ "us-east-1", “us-west-1” ] } } The list of dimension values // are OR'd together to retrieve cost or usage data. You can create Expression // and DimensionValues objects using either with* methods or set* methods @@ -3056,10 +3060,10 @@ type AnomalyMonitor struct { // // * Compound dimension values with logical operations - You can use multiple // Expression types and the logical operators AND/OR/NOT to create a list - // of one or more Expression objects. This allows you to filter on more advanced - // options. For example, you can filter on ((REGION == us-east-1 OR REGION - // == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). - // The Expression for that looks like this: { "And": [ {"Or": [ {"Dimensions": + // of one or more Expression objects. By doing this, you can filter on more + // advanced options. For example, you can filter on ((REGION == us-east-1 + // OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). + // The Expression for that is as follows: { "And": [ {"Or": [ {"Dimensions": // { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": // { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": // { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] } Because each @@ -3069,12 +3073,12 @@ type AnomalyMonitor struct { // "USAGE_TYPE", "Values": [ "DataTransfer" ] } } // // For the GetRightsizingRecommendation action, a combination of OR and NOT - // is not supported. OR is not supported between different dimensions, or dimensions + // isn't supported. OR isn't supported between different dimensions, or dimensions // and tags. NOT operators aren't supported. Dimensions are also limited to // LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE. // // For the GetReservationPurchaseRecommendation action, only NOT is supported. - // AND and OR are not supported. Dimensions are limited to LINKED_ACCOUNT. + // AND and OR aren't supported. Dimensions are limited to LINKED_ACCOUNT. MonitorSpecification *Expression `type:"structure"` // The possible type values. @@ -3168,7 +3172,7 @@ func (s *AnomalyMonitor) SetMonitorType(v string) *AnomalyMonitor { return s } -// Quantifies the anomaly. The higher score means that it is more anomalous. +// Quantifies the anomaly. The higher score means that it's more anomalous. type AnomalyScore struct { _ struct{} `type:"structure"` @@ -3177,7 +3181,7 @@ type AnomalyScore struct { // CurrentScore is a required field CurrentScore *float64 `type:"double" required:"true"` - // The maximum score observed during the AnomalyDateInterval. + // The maximum score that's observed during the AnomalyDateInterval. // // MaxScore is a required field MaxScore *float64 `type:"double" required:"true"` @@ -3215,7 +3219,7 @@ type AnomalySubscription struct { // Your unique account identifier. AccountId *string `type:"string"` - // The frequency at which anomaly reports are sent over email. + // The frequency that anomaly reports are sent over email. // // Frequency is a required field Frequency *string `type:"string" required:"true" enum:"AnomalySubscriptionFrequency"` @@ -3400,10 +3404,10 @@ type CostCategory struct { // The default value for the cost category. DefaultValue *string `min:"1" type:"string"` - // The Cost Category's effective end date. + // The effective end data of your Cost Category. EffectiveEnd *string `min:"20" type:"string"` - // The Cost Category's effective start date. + // The effective state data of your Cost Category. // // EffectiveStart is a required field EffectiveStart *string `min:"20" type:"string" required:"true"` @@ -3422,12 +3426,16 @@ type CostCategory struct { // RuleVersion is a required field RuleVersion *string `type:"string" required:"true" enum:"CostCategoryRuleVersion"` - // Rules are processed in order. If there are multiple rules that match the - // line item, then the first rule to match is used to determine that Cost Category - // value. + // The rules are processed in order. If there are multiple rules that match + // the line item, then the first rule to match is used to determine that Cost + // Category value. // // Rules is a required field Rules []*CostCategoryRule `min:"1" type:"list" required:"true"` + + // The split charge rules that are used to allocate your charges between your + // Cost Category values. + SplitChargeRules []*CostCategorySplitChargeRule `min:"1" type:"list"` } // String returns the string representation @@ -3488,24 +3496,30 @@ func (s *CostCategory) SetRules(v []*CostCategoryRule) *CostCategory { return s } +// SetSplitChargeRules sets the SplitChargeRules field's value. +func (s *CostCategory) SetSplitChargeRules(v []*CostCategorySplitChargeRule) *CostCategory { + s.SplitChargeRules = v + return s +} + // When creating or updating a cost category, you can define the CostCategoryRule // rule type as INHERITED_VALUE. This rule type adds the flexibility of defining // a rule that dynamically inherits the cost category value from the dimension // value defined by CostCategoryInheritedValueDimension. For example, if you -// wanted to dynamically group costs based on the value of a specific tag key, -// you would first choose an inherited value rule type, then choose the tag -// dimension and specify the tag key to use. +// want to dynamically group costs that are based on the value of a specific +// tag key, first choose an inherited value rule type, then choose the tag dimension +// and specify the tag key to use. type CostCategoryInheritedValueDimension struct { _ struct{} `type:"structure"` // The key to extract cost category values. DimensionKey *string `type:"string"` - // The name of dimension for which to group costs. + // The name of the dimension that's used to group costs. // - // If you specify LINKED_ACCOUNT_NAME, the cost category value will be based - // on account name. If you specify TAG, the cost category value will be based - // on the value of the specified tag key. + // If you specify LINKED_ACCOUNT_NAME, the cost category value is based on account + // name. If you specify TAG, the cost category value will be based on the value + // of the specified tag key. DimensionName *string `type:"string" enum:"CostCategoryInheritedValueDimensionName"` } @@ -3588,7 +3602,7 @@ type CostCategoryReference struct { // The unique name of the Cost Category. Name *string `min:"1" type:"string"` - // The number of rules associated with a specific Cost Category. + // The number of rules that are associated with a specific Cost Category. NumberOfRules *int64 `type:"integer"` // The list of processing statuses for Cost Management products for a specific @@ -3663,8 +3677,8 @@ func (s *CostCategoryReference) SetValues(v []*string) *CostCategoryReference { type CostCategoryRule struct { _ struct{} `type:"structure"` - // The value the line item will be categorized as, if the line item contains - // the matched dimension. + // The value the line item is categorized as if the line item contains the matched + // dimension. InheritedValue *CostCategoryInheritedValueDimension `type:"structure"` // An Expression (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html) @@ -3672,23 +3686,23 @@ type CostCategoryRule struct { // expressions. Currently the only dimensions supported are LINKED_ACCOUNT, // SERVICE_CODE, RECORD_TYPE, and LINKED_ACCOUNT_NAME. // - // Root level OR is not supported. We recommend that you create a separate rule + // Root level OR isn't supported. We recommend that you create a separate rule // instead. // // RECORD_TYPE is a dimension used for Cost Explorer APIs, and is also supported // for Cost Category expressions. This dimension uses different terms, depending // on whether you're using the console or API/JSON editor. For a detailed comparison, // see Term Comparisons (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/manage-cost-categories.html#cost-categories-terms) - // in the AWS Billing and Cost Management User Guide. + // in the Billing and Cost Management User Guide. Rule *Expression `type:"structure"` // You can define the CostCategoryRule rule type as either REGULAR or INHERITED_VALUE. // The INHERITED_VALUE rule type adds the flexibility of defining a rule that // dynamically inherits the cost category value from the dimension value defined - // by CostCategoryInheritedValueDimension. For example, if you wanted to dynamically - // group costs based on the value of a specific tag key, you would first choose - // an inherited value rule type, then choose the tag dimension and specify the - // tag key to use. + // by CostCategoryInheritedValueDimension. For example, if you want to dynamically + // group costs based on the value of a specific tag key, first choose an inherited + // value rule type, then choose the tag dimension and specify the tag key to + // use. Type *string `type:"string" enum:"CostCategoryRuleType"` // The default value for the cost category. @@ -3747,14 +3761,176 @@ func (s *CostCategoryRule) SetValue(v string) *CostCategoryRule { return s } +// Use the split charge rule to split the cost of one Cost Category value across +// several other target values. +type CostCategorySplitChargeRule struct { + _ struct{} `type:"structure"` + + // The method that's used to define how to split your source costs across your + // targets. + // + // Proportional - Allocates charges across your targets based on the proportional + // weighted cost of each target. + // + // Fixed - Allocates charges across your targets based on your defined allocation + // percentage. + // + // >Even - Allocates costs evenly across all targets. + // + // Method is a required field + Method *string `type:"string" required:"true" enum:"CostCategorySplitChargeMethod"` + + // The parameters for a split charge method. This is only required for the FIXED + // method. + Parameters []*CostCategorySplitChargeRuleParameter `min:"1" type:"list"` + + // The Cost Category value that you want to split. That value can't be used + // as a source or a target in other split charge rules. To indicate uncategorized + // costs, you can use an empty string as the source. + // + // Source is a required field + Source *string `type:"string" required:"true"` + + // The Cost Category values that you want to split costs across. These values + // can't be used as a source in other split charge rules. + // + // Targets is a required field + Targets []*string `min:"1" type:"list" required:"true"` +} + +// String returns the string representation +func (s CostCategorySplitChargeRule) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CostCategorySplitChargeRule) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CostCategorySplitChargeRule) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CostCategorySplitChargeRule"} + if s.Method == nil { + invalidParams.Add(request.NewErrParamRequired("Method")) + } + if s.Parameters != nil && len(s.Parameters) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Parameters", 1)) + } + if s.Source == nil { + invalidParams.Add(request.NewErrParamRequired("Source")) + } + if s.Targets == nil { + invalidParams.Add(request.NewErrParamRequired("Targets")) + } + if s.Targets != nil && len(s.Targets) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Targets", 1)) + } + if s.Parameters != nil { + for i, v := range s.Parameters { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Parameters", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetMethod sets the Method field's value. +func (s *CostCategorySplitChargeRule) SetMethod(v string) *CostCategorySplitChargeRule { + s.Method = &v + return s +} + +// SetParameters sets the Parameters field's value. +func (s *CostCategorySplitChargeRule) SetParameters(v []*CostCategorySplitChargeRuleParameter) *CostCategorySplitChargeRule { + s.Parameters = v + return s +} + +// SetSource sets the Source field's value. +func (s *CostCategorySplitChargeRule) SetSource(v string) *CostCategorySplitChargeRule { + s.Source = &v + return s +} + +// SetTargets sets the Targets field's value. +func (s *CostCategorySplitChargeRule) SetTargets(v []*string) *CostCategorySplitChargeRule { + s.Targets = v + return s +} + +// The parameters for a split charge method. +type CostCategorySplitChargeRuleParameter struct { + _ struct{} `type:"structure"` + + // The parameter type. + // + // Type is a required field + Type *string `type:"string" required:"true" enum:"CostCategorySplitChargeRuleParameterType"` + + // The parameter values. + // + // Values is a required field + Values []*string `min:"1" type:"list" required:"true"` +} + +// String returns the string representation +func (s CostCategorySplitChargeRuleParameter) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s CostCategorySplitChargeRuleParameter) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CostCategorySplitChargeRuleParameter) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CostCategorySplitChargeRuleParameter"} + if s.Type == nil { + invalidParams.Add(request.NewErrParamRequired("Type")) + } + if s.Values == nil { + invalidParams.Add(request.NewErrParamRequired("Values")) + } + if s.Values != nil && len(s.Values) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Values", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetType sets the Type field's value. +func (s *CostCategorySplitChargeRuleParameter) SetType(v string) *CostCategorySplitChargeRuleParameter { + s.Type = &v + return s +} + +// SetValues sets the Values field's value. +func (s *CostCategorySplitChargeRuleParameter) SetValues(v []*string) *CostCategorySplitChargeRuleParameter { + s.Values = v + return s +} + // The Cost Categories values used for filtering the costs. // // If Values and Key are not specified, the ABSENT MatchOption is applied to -// all Cost Categories. That is, filtering on resources that are not mapped +// all Cost Categories. That is, it filters on resources that aren't mapped // to any Cost Categories. // -// If Values is provided and Key is not specified, the ABSENT MatchOption is -// applied to the Cost Categories Key only. That is, filtering on resources +// If Values is provided and Key isn't specified, the ABSENT MatchOption is +// applied to the Cost Categories Key only. That is, it filters on resources // without the given Cost Categories key. type CostCategoryValues struct { _ struct{} `type:"structure"` @@ -3972,14 +4148,14 @@ func (s *CoverageHours) SetTotalRunningHours(v string) *CoverageHours { return s } -// The amount of instance usage, in normalized units. Normalized units enable -// you to see your EC2 usage for multiple sizes of instances in a uniform way. -// For example, suppose you run an xlarge instance and a 2xlarge instance. If -// you run both instances for the same amount of time, the 2xlarge instance +// The amount of instance usage, in normalized units. You can use normalized +// units to see your EC2 usage for multiple sizes of instances in a uniform +// way. For example, suppose that you run an xlarge instance and a 2xlarge instance. +// If you run both instances for the same amount of time, the 2xlarge instance // uses twice as much of your reservation as the xlarge instance, even though -// both instances show only one instance-hour. Using normalized units instead -// of instance-hours, the xlarge instance used 8 normalized units, and the 2xlarge -// instance used 16 normalized units. +// both instances show only one instance-hour. When you use normalized units +// instead of instance-hours, the xlarge instance used 8 normalized units, and +// the 2xlarge instance used 16 normalized units. // // For more information, see Modifying Reserved Instances (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ri-modifying.html) // in the Amazon Elastic Compute Cloud User Guide for Linux Instances. @@ -4192,6 +4368,10 @@ type CreateCostCategoryDefinitionInput struct { // // Rules is a required field Rules []*CostCategoryRule `min:"1" type:"list" required:"true"` + + // The split charge rules used to allocate your charges between your Cost Category + // values. + SplitChargeRules []*CostCategorySplitChargeRule `min:"1" type:"list"` } // String returns the string representation @@ -4225,6 +4405,9 @@ func (s *CreateCostCategoryDefinitionInput) Validate() error { if s.Rules != nil && len(s.Rules) < 1 { invalidParams.Add(request.NewErrParamMinLen("Rules", 1)) } + if s.SplitChargeRules != nil && len(s.SplitChargeRules) < 1 { + invalidParams.Add(request.NewErrParamMinLen("SplitChargeRules", 1)) + } if s.Rules != nil { for i, v := range s.Rules { if v == nil { @@ -4235,6 +4418,16 @@ func (s *CreateCostCategoryDefinitionInput) Validate() error { } } } + if s.SplitChargeRules != nil { + for i, v := range s.SplitChargeRules { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "SplitChargeRules", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -4266,6 +4459,12 @@ func (s *CreateCostCategoryDefinitionInput) SetRules(v []*CostCategoryRule) *Cre return s } +// SetSplitChargeRules sets the SplitChargeRules field's value. +func (s *CreateCostCategoryDefinitionInput) SetSplitChargeRules(v []*CostCategorySplitChargeRule) *CreateCostCategoryDefinitionInput { + s.SplitChargeRules = v + return s +} + type CreateCostCategoryDefinitionOutput struct { _ struct{} `type:"structure"` @@ -4302,20 +4501,22 @@ func (s *CreateCostCategoryDefinitionOutput) SetEffectiveStart(v string) *Create type CurrentInstance struct { _ struct{} `type:"structure"` - // The currency code that AWS used to calculate the costs for this instance. + // The currency code that Amazon Web Services used to calculate the costs for + // this instance. CurrencyCode *string `type:"string"` - // The name you've given an instance. This field will show as blank if you haven't + // The name that you given an instance. This field shows as blank if you haven't // given the instance a name. InstanceName *string `type:"string"` - // Current On-Demand cost of operating this instance on a monthly basis. + // The current On-Demand cost of operating this instance on a monthly basis. MonthlyCost *string `type:"string"` - // Number of hours during the lookback period billed at On-Demand rates. + // The number of hours during the lookback period that's billed at On-Demand + // rates. OnDemandHoursInLookbackPeriod *string `type:"string"` - // Number of hours during the lookback period covered by reservations. + // The number of hours during the lookback period that's covered by reservations. ReservationCoveredHoursInLookbackPeriod *string `type:"string"` // Details about the resource and utilization. @@ -4327,13 +4528,14 @@ type CurrentInstance struct { // Utilization information of the current instance during the lookback period. ResourceUtilization *ResourceUtilization `type:"structure"` - // Number of hours during the lookback period covered by Savings Plans. + // The number of hours during the lookback period that's covered by Savings + // Plans. SavingsPlansCoveredHoursInLookbackPeriod *string `type:"string"` - // Cost allocation resource tags applied to the instance. + // Cost allocation resource tags that are applied to the instance. Tags []*TagValues `type:"list"` - // The total number of hours the instance ran during the lookback period. + // The total number of hours that the instance ran during the lookback period. TotalRunningHoursInLookbackPeriod *string `type:"string"` } @@ -4474,16 +4676,16 @@ type DateInterval struct { _ struct{} `type:"structure"` // The end of the time period. The end date is exclusive. For example, if end - // is 2017-05-01, AWS retrieves cost and usage data from the start date up to, - // but not including, 2017-05-01. + // is 2017-05-01, Amazon Web Services retrieves cost and usage data from the + // start date up to, but not including, 2017-05-01. // // End is a required field End *string `type:"string" required:"true"` // The beginning of the time period. The start date is inclusive. For example, - // if start is 2017-01-01, AWS retrieves cost and usage data starting at 2017-01-01 - // up to the end date. The start date must be equal to or no later than the - // current date to avoid a validation error. + // if start is 2017-01-01, Amazon Web Services retrieves cost and usage data + // starting at 2017-01-01 up to the end date. The start date must be equal to + // or no later than the current date to avoid a validation error. // // Start is a required field Start *string `type:"string" required:"true"` @@ -4863,7 +5065,7 @@ func (s *DimensionValuesWithAttributes) SetValue(v string) *DimensionValuesWithA return s } -// The field that contains a list of disk (local storage) metrics associated +// The field that contains a list of disk (local storage) metrics that are associated // with the current instance. type DiskResourceUtilization struct { _ struct{} `type:"structure"` @@ -4915,8 +5117,8 @@ func (s *DiskResourceUtilization) SetDiskWriteOpsPerSecond(v string) *DiskResour return s } -// The EBS field that contains a list of EBS metrics associated with the current -// instance. +// The EBS field that contains a list of EBS metrics that are associated with +// the current instance. type EBSResourceUtilization struct { _ struct{} `type:"structure"` @@ -4967,33 +5169,34 @@ func (s *EBSResourceUtilization) SetEbsWriteOpsPerSecond(v string) *EBSResourceU return s } -// Details about the Amazon EC2 instances that AWS recommends that you purchase. +// Details about the Amazon EC2 instances that Amazon Web Services recommends +// that you purchase. type EC2InstanceDetails struct { _ struct{} `type:"structure"` // The Availability Zone of the recommended reservation. AvailabilityZone *string `type:"string"` - // Whether the recommendation is for a current-generation instance. + // Determines whether the recommendation is for a current-generation instance. CurrentGeneration *bool `type:"boolean"` // The instance family of the recommended reservation. Family *string `type:"string"` - // The type of instance that AWS recommends. + // The type of instance that Amazon Web Services recommends. InstanceType *string `type:"string"` // The platform of the recommended reservation. The platform is the specific // combination of operating system, license model, and software on an instance. Platform *string `type:"string"` - // The AWS Region of the recommended reservation. + // The Amazon Web Services Region of the recommended reservation. Region *string `type:"string"` - // Whether the recommended reservation is size flexible. + // Determines whether the recommended reservation is size flexible. SizeFlexEligible *bool `type:"boolean"` - // Whether the recommended reservation is dedicated or shared. + // Determines whether the recommended reservation is dedicated or shared. Tenancy *string `type:"string"` } @@ -5059,32 +5262,33 @@ func (s *EC2InstanceDetails) SetTenancy(v string) *EC2InstanceDetails { type EC2ResourceDetails struct { _ struct{} `type:"structure"` - // Hourly public On-Demand rate for the instance type. + // The hourly public On-Demand rate for the instance type. HourlyOnDemandRate *string `type:"string"` - // The type of AWS instance. + // The type of Amazon Web Services instance. InstanceType *string `type:"string"` - // Memory capacity of the AWS instance. + // The memory capacity of the Amazon Web Services instance. Memory *string `type:"string"` - // Network performance capacity of the AWS instance. + // The network performance capacity of the Amazon Web Services instance. NetworkPerformance *string `type:"string"` - // The platform of the AWS instance. The platform is the specific combination - // of operating system, license model, and software on an instance. + // The platform of the Amazon Web Services instance. The platform is the specific + // combination of operating system, license model, and software on an instance. Platform *string `type:"string"` - // The AWS Region of the instance. + // The Amazon Web Services Region of the instance. Region *string `type:"string"` // The SKU of the product. Sku *string `type:"string"` - // The disk storage of the AWS instance (not EBS storage). + // The disk storage of the Amazon Web Services instance. This doesn't include + // EBS storage. Storage *string `type:"string"` - // Number of VCPU cores in the AWS instance type. + // The number of VCPU cores in the Amazon Web Services instance type. Vcpu *string `type:"string"` } @@ -5156,26 +5360,26 @@ func (s *EC2ResourceDetails) SetVcpu(v string) *EC2ResourceDetails { type EC2ResourceUtilization struct { _ struct{} `type:"structure"` - // The field that contains a list of disk (local storage) metrics associated + // The field that contains a list of disk (local storage) metrics that are associated // with the current instance. DiskResourceUtilization *DiskResourceUtilization `type:"structure"` - // The EBS field that contains a list of EBS metrics associated with the current - // instance. + // The EBS field that contains a list of EBS metrics that are associated with + // the current instance. EBSResourceUtilization *EBSResourceUtilization `type:"structure"` - // Maximum observed or expected CPU utilization of the instance. + // The maximum observed or expected CPU utilization of the instance. MaxCpuUtilizationPercentage *string `type:"string"` - // Maximum observed or expected memory utilization of the instance. + // The maximum observed or expected memory utilization of the instance. MaxMemoryUtilizationPercentage *string `type:"string"` - // Maximum observed or expected storage utilization of the instance (does not - // measure EBS storage). + // The maximum observed or expected storage utilization of the instance. This + // doesn't include EBS storage. MaxStorageUtilizationPercentage *string `type:"string"` - // The network field that contains a list of network metrics associated with - // the current instance. + // The network field that contains a list of network metrics that are associated + // with the current instance. NetworkResourceUtilization *NetworkResourceUtilization `type:"structure"` } @@ -5225,12 +5429,12 @@ func (s *EC2ResourceUtilization) SetNetworkResourceUtilization(v *NetworkResourc return s } -// The Amazon EC2 hardware specifications that you want AWS to provide recommendations -// for. +// The Amazon EC2 hardware specifications that you want Amazon Web Services +// to provide recommendations for. type EC2Specification struct { _ struct{} `type:"structure"` - // Whether you want a recommendation for standard or convertible reservations. + // Indicates whether you want a recommendation for standard or convertible reservations. OfferingClass *string `type:"string" enum:"OfferingClass"` } @@ -5250,23 +5454,24 @@ func (s *EC2Specification) SetOfferingClass(v string) *EC2Specification { return s } -// Details about the Amazon ES instances that AWS recommends that you purchase. +// Details about the Amazon ES instances that Amazon Web Services recommends +// that you purchase. type ESInstanceDetails struct { _ struct{} `type:"structure"` - // Whether the recommendation is for a current-generation instance. + // Determines whether the recommendation is for a current-generation instance. CurrentGeneration *bool `type:"boolean"` - // The class of instance that AWS recommends. + // The class of instance that Amazon Web Services recommends. InstanceClass *string `type:"string"` - // The size of instance that AWS recommends. + // The size of instance that Amazon Web Services recommends. InstanceSize *string `type:"string"` - // The AWS Region of the recommended reservation. + // The Amazon Web Services Region of the recommended reservation. Region *string `type:"string"` - // Whether the recommended reservation is size flexible. + // Determines whether the recommended reservation is size flexible. SizeFlexEligible *bool `type:"boolean"` } @@ -5310,27 +5515,27 @@ func (s *ESInstanceDetails) SetSizeFlexEligible(v bool) *ESInstanceDetails { return s } -// Details about the Amazon ElastiCache instances that AWS recommends that you -// purchase. +// Details about the Amazon ElastiCache instances that Amazon Web Services recommends +// that you purchase. type ElastiCacheInstanceDetails struct { _ struct{} `type:"structure"` - // Whether the recommendation is for a current generation instance. + // Determines whether the recommendation is for a current generation instance. CurrentGeneration *bool `type:"boolean"` // The instance family of the recommended reservation. Family *string `type:"string"` - // The type of node that AWS recommends. + // The type of node that Amazon Web Services recommends. NodeType *string `type:"string"` // The description of the recommended reservation. ProductDescription *string `type:"string"` - // The AWS Region of the recommended reservation. + // The Amazon Web Services Region of the recommended reservation. Region *string `type:"string"` - // Whether the recommended reservation is size flexible. + // Determines whether the recommended reservation is size flexible. SizeFlexEligible *bool `type:"boolean"` } @@ -5386,7 +5591,7 @@ func (s *ElastiCacheInstanceDetails) SetSizeFlexEligible(v bool) *ElastiCacheIns // for the filters that you plan to use. For example, you can filter for // REGION==us-east-1 OR REGION==us-west-1. For GetRightsizingRecommendation, // the Region is a full name (for example, REGION==US East (N. Virginia). -// The Expression example looks like: { "Dimensions": { "Key": "REGION", +// The Expression example is as follows: { "Dimensions": { "Key": "REGION", // "Values": [ "us-east-1", “us-west-1” ] } } The list of dimension values // are OR'd together to retrieve cost or usage data. You can create Expression // and DimensionValues objects using either with* methods or set* methods @@ -5394,10 +5599,10 @@ func (s *ElastiCacheInstanceDetails) SetSizeFlexEligible(v bool) *ElastiCacheIns // // * Compound dimension values with logical operations - You can use multiple // Expression types and the logical operators AND/OR/NOT to create a list -// of one or more Expression objects. This allows you to filter on more advanced -// options. For example, you can filter on ((REGION == us-east-1 OR REGION -// == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). -// The Expression for that looks like this: { "And": [ {"Or": [ {"Dimensions": +// of one or more Expression objects. By doing this, you can filter on more +// advanced options. For example, you can filter on ((REGION == us-east-1 +// OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). +// The Expression for that is as follows: { "And": [ {"Or": [ {"Dimensions": // { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": // { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": // { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] } Because each @@ -5407,19 +5612,19 @@ func (s *ElastiCacheInstanceDetails) SetSizeFlexEligible(v bool) *ElastiCacheIns // "USAGE_TYPE", "Values": [ "DataTransfer" ] } } // // For the GetRightsizingRecommendation action, a combination of OR and NOT -// is not supported. OR is not supported between different dimensions, or dimensions +// isn't supported. OR isn't supported between different dimensions, or dimensions // and tags. NOT operators aren't supported. Dimensions are also limited to // LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE. // // For the GetReservationPurchaseRecommendation action, only NOT is supported. -// AND and OR are not supported. Dimensions are limited to LINKED_ACCOUNT. +// AND and OR aren't supported. Dimensions are limited to LINKED_ACCOUNT. type Expression struct { _ struct{} `type:"structure"` // Return results that match both Dimension objects. And []*Expression `type:"list"` - // The filter based on CostCategory values. + // The filter that's based on CostCategory values. CostCategories *CostCategoryValues `type:"structure"` // The specific Dimension to use for Expression. @@ -5511,7 +5716,7 @@ func (s *Expression) SetTags(v *TagValues) *Expression { return s } -// The forecast created for your query. +// The forecast that's created for your query. type ForecastResult struct { _ struct{} `type:"structure"` @@ -5581,9 +5786,9 @@ type GetAnomaliesInput struct { // monitor Amazon Resource Name (ARN). MonitorArn *string `type:"string"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // Filters anomaly results by the total impact field on the anomaly object. @@ -5669,9 +5874,9 @@ type GetAnomaliesOutput struct { // Anomalies is a required field Anomalies []*Anomaly `type:"list" required:"true"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` } @@ -5700,15 +5905,15 @@ func (s *GetAnomaliesOutput) SetNextPageToken(v string) *GetAnomaliesOutput { type GetAnomalyMonitorsInput struct { _ struct{} `type:"structure"` - // The number of entries a paginated response contains. + // The number of entries that a paginated response contains. MaxResults *int64 `type:"integer"` // A list of cost anomaly monitor ARNs. MonitorArnList []*string `type:"list"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` } @@ -5749,9 +5954,9 @@ type GetAnomalyMonitorsOutput struct { // AnomalyMonitors is a required field AnomalyMonitors []*AnomalyMonitor `type:"list" required:"true"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` } @@ -5786,9 +5991,9 @@ type GetAnomalySubscriptionsInput struct { // Cost anomaly monitor ARNs. MonitorArn *string `type:"string"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // A list of cost anomaly subscription ARNs. @@ -5838,9 +6043,9 @@ type GetAnomalySubscriptionsOutput struct { // AnomalySubscriptions is a required field AnomalySubscriptions []*AnomalySubscription `type:"list" required:"true"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` } @@ -5869,26 +6074,29 @@ func (s *GetAnomalySubscriptionsOutput) SetNextPageToken(v string) *GetAnomalySu type GetCostAndUsageInput struct { _ struct{} `type:"structure"` - // Filters AWS costs by different dimensions. For example, you can specify SERVICE - // and LINKED_ACCOUNT and get the costs that are associated with that account's - // usage of that service. You can nest Expression objects to define any combination - // of dimension filters. For more information, see Expression (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html). + // Filters Amazon Web Services costs by different dimensions. For example, you + // can specify SERVICE and LINKED_ACCOUNT and get the costs that are associated + // with that account's usage of that service. You can nest Expression objects + // to define any combination of dimension filters. For more information, see + // Expression (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html). Filter *Expression `type:"structure"` - // Sets the AWS cost granularity to MONTHLY or DAILY, or HOURLY. If Granularity - // isn't set, the response object doesn't include the Granularity, either MONTHLY - // or DAILY, or HOURLY. + // Sets the Amazon Web Services cost granularity to MONTHLY or DAILY, or HOURLY. + // If Granularity isn't set, the response object doesn't include the Granularity, + // either MONTHLY or DAILY, or HOURLY. // // Granularity is a required field Granularity *string `type:"string" required:"true" enum:"Granularity"` - // You can group AWS costs using up to two different groups, either dimensions, - // tag keys, cost categories, or any two group by types. + // You can group Amazon Web Services costs using up to two different groups, + // either dimensions, tag keys, cost categories, or any two group by types. // - // When you group by tag key, you get all tag values, including empty strings. + // Valid values for the DIMENSION type are AZ, INSTANCE_TYPE, LEGAL_ENTITY_NAME, + // LINKED_ACCOUNT, OPERATION, PLATFORM, PURCHASE_TYPE, SERVICE, TENANCY, RECORD_TYPE, + // and USAGE_TYPE. // - // Valid values are AZ, INSTANCE_TYPE, LEGAL_ENTITY_NAME, LINKED_ACCOUNT, OPERATION, - // PLATFORM, PURCHASE_TYPE, SERVICE, TAGS, TENANCY, RECORD_TYPE, and USAGE_TYPE. + // When you group by the TAG type and include a valid tag key, you get all tag + // values, including empty strings. GroupBy []*GroupDefinition `type:"list"` // Which metrics are returned in the query. For more information about blended @@ -5902,7 +6110,7 @@ type GetCostAndUsageInput struct { // numbers without taking into account the units. For example, if you aggregate // usageQuantity across all of Amazon EC2, the results aren't meaningful because // Amazon EC2 compute hours and data transfer are measured in different units - // (for example, hours vs. GB). To get more meaningful UsageQuantity metrics, + // (for example, hours and GB). To get more meaningful UsageQuantity metrics, // filter by UsageType or UsageTypeGroups. // // Metrics is required for GetCostAndUsage requests. @@ -5910,15 +6118,16 @@ type GetCostAndUsageInput struct { // Metrics is a required field Metrics []*string `type:"list" required:"true"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` - // Sets the start and end dates for retrieving AWS costs. The start date is - // inclusive, but the end date is exclusive. For example, if start is 2017-01-01 - // and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 - // up to and including 2017-04-30 but not including 2017-05-01. + // Sets the start date and end date for retrieving Amazon Web Services costs. + // The start date is inclusive, but the end date is exclusive. For example, + // if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data + // is retrieved from 2017-01-01 up to and including 2017-04-30 but not including + // 2017-05-01. // // TimePeriod is a required field TimePeriod *DateInterval `type:"structure" required:"true"` @@ -6010,12 +6219,12 @@ type GetCostAndUsageOutput struct { // request. GroupDefinitions []*GroupDefinition `type:"list"` - // The token for the next set of retrievable results. AWS provides the token - // when the response from a previous call has more results than the maximum - // page size. + // The token for the next set of retrievable results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` - // The time period that is covered by the results in the response. + // The time period that's covered by the results in the response. ResultsByTime []*ResultByTime `type:"list"` } @@ -6069,9 +6278,9 @@ type GetCostAndUsageWithResourcesInput struct { // Filter is a required field Filter *Expression `type:"structure" required:"true"` - // Sets the AWS cost granularity to MONTHLY, DAILY, or HOURLY. If Granularity - // isn't set, the response object doesn't include the Granularity, MONTHLY, - // DAILY, or HOURLY. + // Sets the Amazon Web Services cost granularity to MONTHLY, DAILY, or HOURLY. + // If Granularity isn't set, the response object doesn't include the Granularity, + // MONTHLY, DAILY, or HOURLY. // // Granularity is a required field Granularity *string `type:"string" required:"true" enum:"Granularity"` @@ -6097,9 +6306,9 @@ type GetCostAndUsageWithResourcesInput struct { // Metrics is required for GetCostAndUsageWithResources requests. Metrics []*string `type:"list"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // Sets the start and end dates for retrieving Amazon Web Services costs. The @@ -6199,9 +6408,9 @@ type GetCostAndUsageWithResourcesOutput struct { // request. GroupDefinitions []*GroupDefinition `type:"list"` - // The token for the next set of retrievable results. AWS provides the token - // when the response from a previous call has more results than the maximum - // page size. + // The token for the next set of retrievable results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // The time period that is covered by the results in the response. @@ -6254,7 +6463,7 @@ type GetCostCategoriesInput struct { // for the filters that you plan to use. For example, you can filter for // REGION==us-east-1 OR REGION==us-west-1. For GetRightsizingRecommendation, // the Region is a full name (for example, REGION==US East (N. Virginia). - // The Expression example looks like: { "Dimensions": { "Key": "REGION", + // The Expression example is as follows: { "Dimensions": { "Key": "REGION", // "Values": [ "us-east-1", “us-west-1” ] } } The list of dimension values // are OR'd together to retrieve cost or usage data. You can create Expression // and DimensionValues objects using either with* methods or set* methods @@ -6262,10 +6471,10 @@ type GetCostCategoriesInput struct { // // * Compound dimension values with logical operations - You can use multiple // Expression types and the logical operators AND/OR/NOT to create a list - // of one or more Expression objects. This allows you to filter on more advanced - // options. For example, you can filter on ((REGION == us-east-1 OR REGION - // == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). - // The Expression for that looks like this: { "And": [ {"Or": [ {"Dimensions": + // of one or more Expression objects. By doing this, you can filter on more + // advanced options. For example, you can filter on ((REGION == us-east-1 + // OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). + // The Expression for that is as follows: { "And": [ {"Or": [ {"Dimensions": // { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": // { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": // { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] } Because each @@ -6275,12 +6484,12 @@ type GetCostCategoriesInput struct { // "USAGE_TYPE", "Values": [ "DataTransfer" ] } } // // For the GetRightsizingRecommendation action, a combination of OR and NOT - // is not supported. OR is not supported between different dimensions, or dimensions + // isn't supported. OR isn't supported between different dimensions, or dimensions // and tags. NOT operators aren't supported. Dimensions are also limited to // LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE. // // For the GetReservationPurchaseRecommendation action, only NOT is supported. - // AND and OR are not supported. Dimensions are limited to LINKED_ACCOUNT. + // AND and OR aren't supported. Dimensions are limited to LINKED_ACCOUNT. Filter *Expression `type:"structure"` // This field is only used when SortBy is provided in the request. @@ -6293,9 +6502,9 @@ type GetCostCategoriesInput struct { MaxResults *int64 `min:"1" type:"integer"` // If the number of objects that are still available for retrieval exceeds the - // limit, AWS returns a NextPageToken value in the response. To retrieve the - // next batch of objects, provide the NextPageToken from the prior call in your - // next request. + // limit, Amazon Web Services returns a NextPageToken value in the response. + // To retrieve the next batch of objects, provide the NextPageToken from the + // prior call in your next request. NextPageToken *string `type:"string"` // The value that you want to search the filter values for. @@ -6439,9 +6648,9 @@ type GetCostCategoriesOutput struct { CostCategoryValues []*string `type:"list"` // If the number of objects that are still available for retrieval exceeds the - // limit, AWS returns a NextPageToken value in the response. To retrieve the - // next batch of objects, provide the marker from the prior call in your next - // request. + // limit, Amazon Web Services returns a NextPageToken value in the response. + // To retrieve the next batch of objects, provide the marker from the prior + // call in your next request. NextPageToken *string `type:"string"` // The number of objects returned. @@ -6713,12 +6922,12 @@ type GetDimensionValuesInput struct { // // * INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge. // - // * LEGAL_ENTITY_NAME - The name of the organization that sells you AWS - // services, such as Amazon Web Services. + // * LEGAL_ENTITY_NAME - The name of the organization that sells you Amazon + // Web Services services, such as Amazon Web Services. // // * LINKED_ACCOUNT - The description in the attribute map that includes - // the full name of the member account. The value field contains the AWS - // ID of the member account. + // the full name of the member account. The value field contains the Amazon + // Web Services ID of the member account. // // * OPERATING_SYSTEM - The operating system. Examples are Windows or Linux. // @@ -6731,7 +6940,7 @@ type GetDimensionValuesInput struct { // is related. Examples include On-Demand Instances and Standard Reserved // Instances. // - // * SERVICE - The AWS service such as Amazon DynamoDB. + // * SERVICE - The Amazon Web Services service such as Amazon DynamoDB. // // * USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. // The response for the GetDimensionValues operation includes a unit attribute. @@ -6741,7 +6950,7 @@ type GetDimensionValuesInput struct { // Amazon EC2: CloudWatch – Alarms. The response for this operation includes // a unit attribute. // - // * REGION - The AWS Region. + // * REGION - The Amazon Web Services Region. // // * RECORD_TYPE - The different types of charges such as RI fees, usage // costs, tax refunds, and credits. @@ -6763,13 +6972,13 @@ type GetDimensionValuesInput struct { // * INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge. // // * LINKED_ACCOUNT - The description in the attribute map that includes - // the full name of the member account. The value field contains the AWS - // ID of the member account. + // the full name of the member account. The value field contains the Amazon + // Web Services ID of the member account. // // * PLATFORM - The Amazon EC2 operating system. Examples are Windows or // Linux. // - // * REGION - The AWS Region. + // * REGION - The Amazon Web Services Region. // // * SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values // are regional or a single Availability Zone. @@ -6787,13 +6996,13 @@ type GetDimensionValuesInput struct { // * PAYMENT_OPTION - Payment option for the given Savings Plans (for example, // All Upfront) // - // * REGION - The AWS Region. + // * REGION - The Amazon Web Services Region. // // * INSTANCE_TYPE_FAMILY - The family of instances (For example, m5) // // * LINKED_ACCOUNT - The description in the attribute map that includes - // the full name of the member account. The value field contains the AWS - // ID of the member account. + // the full name of the member account. The value field contains the Amazon + // Web Services ID of the member account. // // * SAVINGS_PLAN_ARN - The unique identifier for your Savings Plan Context *string `type:"string" enum:"Context"` @@ -6810,7 +7019,7 @@ type GetDimensionValuesInput struct { // for the filters that you plan to use. For example, you can filter for // REGION==us-east-1 OR REGION==us-west-1. For GetRightsizingRecommendation, // the Region is a full name (for example, REGION==US East (N. Virginia). - // The Expression example looks like: { "Dimensions": { "Key": "REGION", + // The Expression example is as follows: { "Dimensions": { "Key": "REGION", // "Values": [ "us-east-1", “us-west-1” ] } } The list of dimension values // are OR'd together to retrieve cost or usage data. You can create Expression // and DimensionValues objects using either with* methods or set* methods @@ -6818,10 +7027,10 @@ type GetDimensionValuesInput struct { // // * Compound dimension values with logical operations - You can use multiple // Expression types and the logical operators AND/OR/NOT to create a list - // of one or more Expression objects. This allows you to filter on more advanced - // options. For example, you can filter on ((REGION == us-east-1 OR REGION - // == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). - // The Expression for that looks like this: { "And": [ {"Or": [ {"Dimensions": + // of one or more Expression objects. By doing this, you can filter on more + // advanced options. For example, you can filter on ((REGION == us-east-1 + // OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). + // The Expression for that is as follows: { "And": [ {"Or": [ {"Dimensions": // { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": // { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": // { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] } Because each @@ -6831,12 +7040,12 @@ type GetDimensionValuesInput struct { // "USAGE_TYPE", "Values": [ "DataTransfer" ] } } // // For the GetRightsizingRecommendation action, a combination of OR and NOT - // is not supported. OR is not supported between different dimensions, or dimensions + // isn't supported. OR isn't supported between different dimensions, or dimensions // and tags. NOT operators aren't supported. Dimensions are also limited to // LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE. // // For the GetReservationPurchaseRecommendation action, only NOT is supported. - // AND and OR are not supported. Dimensions are limited to LINKED_ACCOUNT. + // AND and OR aren't supported. Dimensions are limited to LINKED_ACCOUNT. Filter *Expression `type:"structure"` // This field is only used when SortBy is provided in the request. The maximum @@ -6847,9 +7056,9 @@ type GetDimensionValuesInput struct { // For GetDimensionValues, MaxResults has an upper limit of 1000. MaxResults *int64 `min:"1" type:"integer"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // The value that you want to search the filter values for. @@ -6879,10 +7088,10 @@ type GetDimensionValuesInput struct { // Further, when using SortBy, NextPageToken and SearchString are not supported. SortBy []*SortDefinition `type:"list"` - // The start and end dates for retrieving the dimension values. The start date - // is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 - // and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 - // up to and including 2017-04-30 but not including 2017-05-01. + // The start date and end date for retrieving the dimension values. The start + // date is inclusive, but the end date is exclusive. For example, if start is + // 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved + // from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01. // // TimePeriod is a required field TimePeriod *DateInterval `type:"structure" required:"true"` @@ -7001,12 +7210,12 @@ type GetDimensionValuesOutput struct { // // * INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge. // - // * LEGAL_ENTITY_NAME - The name of the organization that sells you AWS - // services, such as Amazon Web Services. + // * LEGAL_ENTITY_NAME - The name of the organization that sells you Amazon + // Web Services services, such as Amazon Web Services. // // * LINKED_ACCOUNT - The description in the attribute map that includes - // the full name of the member account. The value field contains the AWS - // ID of the member account. + // the full name of the member account. The value field contains the Amazon + // Web Services ID of the member account. // // * OPERATING_SYSTEM - The operating system. Examples are Windows or Linux. // @@ -7019,7 +7228,7 @@ type GetDimensionValuesOutput struct { // is related. Examples include On-Demand Instances and Standard Reserved // Instances. // - // * SERVICE - The AWS service such as Amazon DynamoDB. + // * SERVICE - The Amazon Web Services service such as Amazon DynamoDB. // // * USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. // The response for the GetDimensionValues operation includes a unit attribute. @@ -7049,13 +7258,13 @@ type GetDimensionValuesOutput struct { // * INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge. // // * LINKED_ACCOUNT - The description in the attribute map that includes - // the full name of the member account. The value field contains the AWS - // ID of the member account. + // the full name of the member account. The value field contains the Amazon + // Web Services ID of the member account. // // * PLATFORM - The Amazon EC2 operating system. Examples are Windows or // Linux. // - // * REGION - The AWS Region. + // * REGION - The Amazon Web Services Region. // // * SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values // are regional or a single Availability Zone. @@ -7073,25 +7282,25 @@ type GetDimensionValuesOutput struct { // * PAYMENT_OPTION - Payment option for the given Savings Plans (for example, // All Upfront) // - // * REGION - The AWS Region. + // * REGION - The Amazon Web Services Region. // // * INSTANCE_TYPE_FAMILY - The family of instances (For example, m5) // // * LINKED_ACCOUNT - The description in the attribute map that includes - // the full name of the member account. The value field contains the AWS - // ID of the member account. + // the full name of the member account. The value field contains the Amazon + // Web Services ID of the member account. // // * SAVINGS_PLAN_ARN - The unique identifier for your Savings Plan // // DimensionValues is a required field DimensionValues []*DimensionValuesWithAttributes `type:"list" required:"true"` - // The token for the next set of retrievable results. AWS provides the token - // when the response from a previous call has more results than the maximum - // page size. + // The token for the next set of retrievable results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` - // The number of results that AWS returned at one time. + // The number of results that Amazon Web Services returned at one time. // // ReturnSize is a required field ReturnSize *int64 `type:"integer" required:"true"` @@ -7177,8 +7386,8 @@ type GetReservationCoverageInput struct { // Cost category is also supported. Filter *Expression `type:"structure"` - // The granularity of the AWS cost data for the reservation. Valid values are - // MONTHLY and DAILY. + // The granularity of the Amazon Web Services cost data for the reservation. + // Valid values are MONTHLY and DAILY. // // If GroupBy is set, Granularity can't be set. If Granularity isn't set, the // response object doesn't include Granularity, either MONTHLY or DAILY. @@ -7210,8 +7419,8 @@ type GetReservationCoverageInput struct { GroupBy []*GroupDefinition `type:"list"` // The maximum number of objects that you returned for this request. If more - // objects are available, in the response, AWS provides a NextPageToken value - // that you can use in a subsequent call to get the next batch of objects. + // objects are available, in the response, Amazon Web Services provides a NextPageToken + // value that you can use in a subsequent call to get the next batch of objects. MaxResults *int64 `min:"1" type:"integer"` // The measurement that you want your reservation coverage reported in. @@ -7219,9 +7428,9 @@ type GetReservationCoverageInput struct { // Valid values are Hour, Unit, and Cost. You can use multiple values in a request. Metrics []*string `type:"list"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // The value by which you want to sort the data. @@ -7359,9 +7568,9 @@ type GetReservationCoverageOutput struct { // CoveragesByTime is a required field CoveragesByTime []*CoverageByTime `type:"list" required:"true"` - // The token for the next set of retrievable results. AWS provides the token - // when the response from a previous call has more results than the maximum - // page size. + // The token for the next set of retrievable results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // The total amount of instance usage that a reservation covered. @@ -7414,7 +7623,7 @@ type GetReservationPurchaseRecommendationInput struct { // for the filters that you plan to use. For example, you can filter for // REGION==us-east-1 OR REGION==us-west-1. For GetRightsizingRecommendation, // the Region is a full name (for example, REGION==US East (N. Virginia). - // The Expression example looks like: { "Dimensions": { "Key": "REGION", + // The Expression example is as follows: { "Dimensions": { "Key": "REGION", // "Values": [ "us-east-1", “us-west-1” ] } } The list of dimension values // are OR'd together to retrieve cost or usage data. You can create Expression // and DimensionValues objects using either with* methods or set* methods @@ -7422,10 +7631,10 @@ type GetReservationPurchaseRecommendationInput struct { // // * Compound dimension values with logical operations - You can use multiple // Expression types and the logical operators AND/OR/NOT to create a list - // of one or more Expression objects. This allows you to filter on more advanced - // options. For example, you can filter on ((REGION == us-east-1 OR REGION - // == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). - // The Expression for that looks like this: { "And": [ {"Or": [ {"Dimensions": + // of one or more Expression objects. By doing this, you can filter on more + // advanced options. For example, you can filter on ((REGION == us-east-1 + // OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). + // The Expression for that is as follows: { "And": [ {"Or": [ {"Dimensions": // { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": // { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": // { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] } Because each @@ -7435,16 +7644,16 @@ type GetReservationPurchaseRecommendationInput struct { // "USAGE_TYPE", "Values": [ "DataTransfer" ] } } // // For the GetRightsizingRecommendation action, a combination of OR and NOT - // is not supported. OR is not supported between different dimensions, or dimensions + // isn't supported. OR isn't supported between different dimensions, or dimensions // and tags. NOT operators aren't supported. Dimensions are also limited to // LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE. // // For the GetReservationPurchaseRecommendation action, only NOT is supported. - // AND and OR are not supported. Dimensions are limited to LINKED_ACCOUNT. + // AND and OR aren't supported. Dimensions are limited to LINKED_ACCOUNT. Filter *Expression `type:"structure"` - // The number of previous days that you want AWS to consider when it calculates - // your recommendations. + // The number of previous days that you want Amazon Web Services to consider + // when it calculates your recommendations. LookbackPeriodInDays *string `type:"string" enum:"LookbackPeriodInDays"` // The pagination token that indicates the next set of results that you want @@ -7646,13 +7855,13 @@ type GetReservationUtilizationInput struct { GroupBy []*GroupDefinition `type:"list"` // The maximum number of objects that you returned for this request. If more - // objects are available, in the response, AWS provides a NextPageToken value - // that you can use in a subsequent call to get the next batch of objects. + // objects are available, in the response, Amazon Web Services provides a NextPageToken + // value that you can use in a subsequent call to get the next batch of objects. MaxResults *int64 `min:"1" type:"integer"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // The value by which you want to sort the data. @@ -7791,9 +8000,9 @@ func (s *GetReservationUtilizationInput) SetTimePeriod(v *DateInterval) *GetRese type GetReservationUtilizationOutput struct { _ struct{} `type:"structure"` - // The token for the next set of retrievable results. AWS provides the token - // when the response from a previous call has more results than the maximum - // page size. + // The token for the next set of retrievable results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // The total amount of time that you used your RIs. @@ -7849,7 +8058,7 @@ type GetRightsizingRecommendationInput struct { // for the filters that you plan to use. For example, you can filter for // REGION==us-east-1 OR REGION==us-west-1. For GetRightsizingRecommendation, // the Region is a full name (for example, REGION==US East (N. Virginia). - // The Expression example looks like: { "Dimensions": { "Key": "REGION", + // The Expression example is as follows: { "Dimensions": { "Key": "REGION", // "Values": [ "us-east-1", “us-west-1” ] } } The list of dimension values // are OR'd together to retrieve cost or usage data. You can create Expression // and DimensionValues objects using either with* methods or set* methods @@ -7857,10 +8066,10 @@ type GetRightsizingRecommendationInput struct { // // * Compound dimension values with logical operations - You can use multiple // Expression types and the logical operators AND/OR/NOT to create a list - // of one or more Expression objects. This allows you to filter on more advanced - // options. For example, you can filter on ((REGION == us-east-1 OR REGION - // == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). - // The Expression for that looks like this: { "And": [ {"Or": [ {"Dimensions": + // of one or more Expression objects. By doing this, you can filter on more + // advanced options. For example, you can filter on ((REGION == us-east-1 + // OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). + // The Expression for that is as follows: { "And": [ {"Or": [ {"Dimensions": // { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": // { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": // { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] } Because each @@ -7870,12 +8079,12 @@ type GetRightsizingRecommendationInput struct { // "USAGE_TYPE", "Values": [ "DataTransfer" ] } } // // For the GetRightsizingRecommendation action, a combination of OR and NOT - // is not supported. OR is not supported between different dimensions, or dimensions + // isn't supported. OR isn't supported between different dimensions, or dimensions // and tags. NOT operators aren't supported. Dimensions are also limited to // LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE. // // For the GetReservationPurchaseRecommendation action, only NOT is supported. - // AND and OR are not supported. Dimensions are limited to LINKED_ACCOUNT. + // AND and OR aren't supported. Dimensions are limited to LINKED_ACCOUNT. Filter *Expression `type:"structure"` // The pagination token that indicates the next set of results that you want @@ -8358,9 +8567,9 @@ type GetSavingsPlansPurchaseRecommendationOutput struct { // Information regarding this specific recommendation set. Metadata *SavingsPlansPurchaseRecommendationMetadata `type:"structure"` - // The token for the next set of retrievable results. AWS provides the token - // when the response from a previous call has more results than the maximum - // page size. + // The token for the next set of retrievable results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // Contains your request parameters, Savings Plan Recommendations Summary, and @@ -8752,7 +8961,7 @@ type GetTagsInput struct { // for the filters that you plan to use. For example, you can filter for // REGION==us-east-1 OR REGION==us-west-1. For GetRightsizingRecommendation, // the Region is a full name (for example, REGION==US East (N. Virginia). - // The Expression example looks like: { "Dimensions": { "Key": "REGION", + // The Expression example is as follows: { "Dimensions": { "Key": "REGION", // "Values": [ "us-east-1", “us-west-1” ] } } The list of dimension values // are OR'd together to retrieve cost or usage data. You can create Expression // and DimensionValues objects using either with* methods or set* methods @@ -8760,10 +8969,10 @@ type GetTagsInput struct { // // * Compound dimension values with logical operations - You can use multiple // Expression types and the logical operators AND/OR/NOT to create a list - // of one or more Expression objects. This allows you to filter on more advanced - // options. For example, you can filter on ((REGION == us-east-1 OR REGION - // == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). - // The Expression for that looks like this: { "And": [ {"Or": [ {"Dimensions": + // of one or more Expression objects. By doing this, you can filter on more + // advanced options. For example, you can filter on ((REGION == us-east-1 + // OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer). + // The Expression for that is as follows: { "And": [ {"Or": [ {"Dimensions": // { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": // { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": // { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] } Because each @@ -8773,12 +8982,12 @@ type GetTagsInput struct { // "USAGE_TYPE", "Values": [ "DataTransfer" ] } } // // For the GetRightsizingRecommendation action, a combination of OR and NOT - // is not supported. OR is not supported between different dimensions, or dimensions + // isn't supported. OR isn't supported between different dimensions, or dimensions // and tags. NOT operators aren't supported. Dimensions are also limited to // LINKED_ACCOUNT, REGION, or RIGHTSIZING_TYPE. // // For the GetReservationPurchaseRecommendation action, only NOT is supported. - // AND and OR are not supported. Dimensions are limited to LINKED_ACCOUNT. + // AND and OR aren't supported. Dimensions are limited to LINKED_ACCOUNT. Filter *Expression `type:"structure"` // This field is only used when SortBy is provided in the request. The maximum @@ -8789,9 +8998,9 @@ type GetTagsInput struct { // For GetTags, MaxResults has an upper limit of 1000. MaxResults *int64 `min:"1" type:"integer"` - // The token to retrieve the next set of results. AWS provides the token when - // the response from a previous call has more results than the maximum page - // size. + // The token to retrieve the next set of results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` // The value that you want to search for. @@ -8923,12 +9132,12 @@ func (s *GetTagsInput) SetTimePeriod(v *DateInterval) *GetTagsInput { type GetTagsOutput struct { _ struct{} `type:"structure"` - // The token for the next set of retrievable results. AWS provides the token - // when the response from a previous call has more results than the maximum - // page size. + // The token for the next set of retrievable results. Amazon Web Services provides + // the token when the response from a previous call has more results than the + // maximum page size. NextPageToken *string `type:"string"` - // The number of query results that AWS returns at a time. + // The number of query results that Amazon Web Services returns at a time. // // ReturnSize is a required field ReturnSize *int64 `type:"integer" required:"true"` @@ -9240,16 +9449,16 @@ func (s *GroupDefinition) SetType(v string) *GroupDefinition { return s } -// The anomaly's dollar value. +// The dollar value of the anomaly. type Impact struct { _ struct{} `type:"structure"` - // The maximum dollar value observed for an anomaly. + // The maximum dollar value that's observed for an anomaly. // // MaxImpact is a required field MaxImpact *float64 `type:"double" required:"true"` - // The cumulative dollar value observed for an anomaly. + // The cumulative dollar value that's observed for an anomaly. TotalImpact *float64 `type:"double"` } @@ -9275,23 +9484,25 @@ func (s *Impact) SetTotalImpact(v float64) *Impact { return s } -// Details about the instances that AWS recommends that you purchase. +// Details about the instances that Amazon Web Services recommends that you +// purchase. type InstanceDetails struct { _ struct{} `type:"structure"` - // The Amazon EC2 instances that AWS recommends that you purchase. + // The Amazon EC2 instances that Amazon Web Services recommends that you purchase. EC2InstanceDetails *EC2InstanceDetails `type:"structure"` - // The Amazon ES instances that AWS recommends that you purchase. + // The Amazon ES instances that Amazon Web Services recommends that you purchase. ESInstanceDetails *ESInstanceDetails `type:"structure"` - // The ElastiCache instances that AWS recommends that you purchase. + // The ElastiCache instances that Amazon Web Services recommends that you purchase. ElastiCacheInstanceDetails *ElastiCacheInstanceDetails `type:"structure"` - // The Amazon RDS instances that AWS recommends that you purchase. + // The Amazon RDS instances that Amazon Web Services recommends that you purchase. RDSInstanceDetails *RDSInstanceDetails `type:"structure"` - // The Amazon Redshift instances that AWS recommends that you purchase. + // The Amazon Redshift instances that Amazon Web Services recommends that you + // purchase. RedshiftInstanceDetails *RedshiftInstanceDetails `type:"structure"` } @@ -9578,7 +9789,8 @@ func (s *MetricValue) SetUnit(v string) *MetricValue { type ModifyRecommendationDetail struct { _ struct{} `type:"structure"` - // Identifies whether this instance type is the AWS default recommendation. + // Determines whether this instance type is the Amazon Web Services default + // recommendation. TargetInstances []*TargetInstance `type:"list"` } @@ -9598,21 +9810,21 @@ func (s *ModifyRecommendationDetail) SetTargetInstances(v []*TargetInstance) *Mo return s } -// The network field that contains a list of network metrics associated with -// the current instance. +// The network field that contains a list of network metrics that are associated +// with the current instance. type NetworkResourceUtilization struct { _ struct{} `type:"structure"` - // The network ingress throughput utilization measured in Bytes per second. + // The network inbound throughput utilization measured in Bytes per second. NetworkInBytesPerSecond *string `type:"string"` - // The network outgress throughput utilization measured in Bytes per second. + // The network outbound throughput utilization measured in Bytes per second. NetworkOutBytesPerSecond *string `type:"string"` - // The network ingress packets measured in packets per second. + // The network ingress packets that are measured in packets per second. NetworkPacketsInPerSecond *string `type:"string"` - // The network outgress packets measured in packets per second. + // The network outgress packets that are measured in packets per second. NetworkPacketsOutPerSecond *string `type:"string"` } @@ -9728,11 +9940,12 @@ func (s *ProvideAnomalyFeedbackOutput) SetAnomalyId(v string) *ProvideAnomalyFee return s } -// Details about the Amazon RDS instances that AWS recommends that you purchase. +// Details about the Amazon RDS instances that Amazon Web Services recommends +// that you purchase. type RDSInstanceDetails struct { _ struct{} `type:"structure"` - // Whether the recommendation is for a current-generation instance. + // Determines whether the recommendation is for a current-generation instance. CurrentGeneration *bool `type:"boolean"` // The database edition that the recommended reservation supports. @@ -9741,23 +9954,23 @@ type RDSInstanceDetails struct { // The database engine that the recommended reservation supports. DatabaseEngine *string `type:"string"` - // Whether the recommendation is for a reservation in a single Availability + // Determines whether the recommendation is for a reservation in a single Availability // Zone or a reservation with a backup in a second Availability Zone. DeploymentOption *string `type:"string"` // The instance family of the recommended reservation. Family *string `type:"string"` - // The type of instance that AWS recommends. + // The type of instance that Amazon Web Services recommends. InstanceType *string `type:"string"` // The license model that the recommended reservation supports. LicenseModel *string `type:"string"` - // The AWS Region of the recommended reservation. + // The Amazon Web Services Region of the recommended reservation. Region *string `type:"string"` - // Whether the recommended reservation is size flexible. + // Determines whether the recommended reservation is size flexible. SizeFlexEligible *bool `type:"boolean"` } @@ -9825,24 +10038,24 @@ func (s *RDSInstanceDetails) SetSizeFlexEligible(v bool) *RDSInstanceDetails { return s } -// Details about the Amazon Redshift instances that AWS recommends that you -// purchase. +// Details about the Amazon Redshift instances that Amazon Web Services recommends +// that you purchase. type RedshiftInstanceDetails struct { _ struct{} `type:"structure"` - // Whether the recommendation is for a current-generation instance. + // Determines whether the recommendation is for a current-generation instance. CurrentGeneration *bool `type:"boolean"` // The instance family of the recommended reservation. Family *string `type:"string"` - // The type of node that AWS recommends. + // The type of node that Amazon Web Services recommends. NodeType *string `type:"string"` - // The AWS Region of the recommended reservation. + // The Amazon Web Services Region of the recommended reservation. Region *string `type:"string"` - // Whether the recommended reservation is size flexible. + // Determines whether the recommended reservation is size flexible. SizeFlexEligible *bool `type:"boolean"` } @@ -9947,54 +10160,56 @@ func (s *RequestChangedException) RequestID() string { type ReservationAggregates struct { _ struct{} `type:"structure"` - // The monthly cost of your reservation, amortized over the reservation period. + // The monthly cost of your reservation. It's amortized over the reservation + // period. AmortizedRecurringFee *string `type:"string"` - // The upfront cost of your reservation, amortized over the reservation period. + // The upfront cost of your reservation. It's amortized over the reservation + // period. AmortizedUpfrontFee *string `type:"string"` - // How much you saved due to purchasing and utilizing reservation. AWS calculates - // this by subtracting TotalAmortizedFee from OnDemandCostOfRIHoursUsed. + // How much you saved due to purchasing and utilizing reservation. Amazon Web + // Services calculates this by subtracting TotalAmortizedFee from OnDemandCostOfRIHoursUsed. NetRISavings *string `type:"string"` - // How much your reservation would cost if charged On-Demand rates. + // How much your reservation costs if charged On-Demand rates. OnDemandCostOfRIHoursUsed *string `type:"string"` // How many reservation hours that you purchased. PurchasedHours *string `type:"string"` - // How many Amazon EC2 reservation hours that you purchased, converted to normalized - // units. Normalized units are available only for Amazon EC2 usage after November - // 11, 2017. + // The number of Amazon EC2 reservation hours that you purchased. It's converted + // to normalized units. Normalized units are available only for Amazon EC2 usage + // after November 11, 2017. PurchasedUnits *string `type:"string"` // The cost of unused hours for your reservation. RICostForUnusedHours *string `type:"string"` - // The realized savings due to purchasing and using a reservation. + // The realized savings because of purchasing and using a reservation. RealizedSavings *string `type:"string"` // The total number of reservation hours that you used. TotalActualHours *string `type:"string"` - // The total number of Amazon EC2 reservation hours that you used, converted + // The total number of Amazon EC2 reservation hours that you used. It's converted // to normalized units. Normalized units are available only for Amazon EC2 usage // after November 11, 2017. TotalActualUnits *string `type:"string"` - // The total cost of your reservation, amortized over the reservation period. + // The total cost of your reservation. It's amortized over the reservation period. TotalAmortizedFee *string `type:"string"` - // How much you could save if you use your entire reservation. + // How much you might save if you use your entire reservation. TotalPotentialRISavings *string `type:"string"` - // The unrealized savings due to purchasing and using a reservation. + // The unrealized savings because of purchasing and using a reservation. UnrealizedSavings *string `type:"string"` // The number of reservation hours that you didn't use. UnusedHours *string `type:"string"` - // The number of Amazon EC2 reservation hours that you didn't use, converted + // The number of Amazon EC2 reservation hours that you didn't use. It's converted // to normalized units. Normalized units are available only for Amazon EC2 usage // after November 11, 2017. UnusedUnits *string `type:"string"` @@ -10002,8 +10217,8 @@ type ReservationAggregates struct { // The percentage of reservation time that you used. UtilizationPercentage *string `type:"string"` - // The percentage of Amazon EC2 reservation time that you used, converted to - // normalized units. Normalized units are available only for Amazon EC2 usage + // The percentage of Amazon EC2 reservation time that you used. It's converted + // to normalized units. Normalized units are available only for Amazon EC2 usage // after November 11, 2017. UtilizationPercentageInUnits *string `type:"string"` } @@ -10153,19 +10368,20 @@ func (s *ReservationCoverageGroup) SetCoverage(v *Coverage) *ReservationCoverage return s } -// A specific reservation that AWS recommends for purchase. +// A specific reservation that Amazon Web Services recommends for purchase. type ReservationPurchaseRecommendation struct { _ struct{} `type:"structure"` - // The account scope that AWS recommends that you purchase this instance for. - // For example, you can purchase this reservation for an entire organization - // in AWS Organizations. + // The account scope that Amazon Web Services recommends that you purchase this + // instance for. For example, you can purchase this reservation for an entire + // organization in Amazon Web Services Organizations. AccountScope *string `type:"string" enum:"AccountScope"` - // How many days of previous usage that AWS considers when making this recommendation. + // How many days of previous usage that Amazon Web Services considers when making + // this recommendation. LookbackPeriodInDays *string `type:"string" enum:"LookbackPeriodInDays"` - // The payment option for the reservation. For example, AllUpfront or NoUpfront. + // The payment option for the reservation (for example, AllUpfront or NoUpfront). PaymentOption *string `type:"string" enum:"PaymentOption"` // Details about the recommended purchases. @@ -10241,65 +10457,72 @@ type ReservationPurchaseRecommendationDetail struct { AccountId *string `type:"string"` // The average number of normalized units that you used in an hour during the - // historical period. AWS uses this to calculate your recommended reservation - // purchases. + // historical period. Amazon Web Services uses this to calculate your recommended + // reservation purchases. AverageNormalizedUnitsUsedPerHour *string `type:"string"` // The average number of instances that you used in an hour during the historical - // period. AWS uses this to calculate your recommended reservation purchases. + // period. Amazon Web Services uses this to calculate your recommended reservation + // purchases. AverageNumberOfInstancesUsedPerHour *string `type:"string"` - // The average utilization of your instances. AWS uses this to calculate your - // recommended reservation purchases. + // The average utilization of your instances. Amazon Web Services uses this + // to calculate your recommended reservation purchases. AverageUtilization *string `type:"string"` - // The currency code that AWS used to calculate the costs for this instance. + // The currency code that Amazon Web Services used to calculate the costs for + // this instance. CurrencyCode *string `type:"string"` - // How long AWS estimates that it takes for this instance to start saving you - // money, in months. + // How long Amazon Web Services estimates that it takes for this instance to + // start saving you money, in months. EstimatedBreakEvenInMonths *string `type:"string"` - // How much AWS estimates that you spend on On-Demand Instances in a month. + // How much Amazon Web Services estimates that you spend on On-Demand Instances + // in a month. EstimatedMonthlyOnDemandCost *string `type:"string"` - // How much AWS estimates that this specific recommendation could save you in - // a month. + // How much Amazon Web Services estimates that this specific recommendation + // could save you in a month. EstimatedMonthlySavingsAmount *string `type:"string"` - // How much AWS estimates that this specific recommendation could save you in - // a month, as a percentage of your overall costs. + // How much Amazon Web Services estimates that this specific recommendation + // could save you in a month, as a percentage of your overall costs. EstimatedMonthlySavingsPercentage *string `type:"string"` - // How much AWS estimates that you would have spent for all usage during the - // specified historical period if you had a reservation. + // How much Amazon Web Services estimates that you would have spent for all + // usage during the specified historical period if you had a reservation. EstimatedReservationCostForLookbackPeriod *string `type:"string"` - // Details about the instances that AWS recommends that you purchase. + // Details about the instances that Amazon Web Services recommends that you + // purchase. InstanceDetails *InstanceDetails `type:"structure"` // The maximum number of normalized units that you used in an hour during the - // historical period. AWS uses this to calculate your recommended reservation - // purchases. + // historical period. Amazon Web Services uses this to calculate your recommended + // reservation purchases. MaximumNormalizedUnitsUsedPerHour *string `type:"string"` // The maximum number of instances that you used in an hour during the historical - // period. AWS uses this to calculate your recommended reservation purchases. + // period. Amazon Web Services uses this to calculate your recommended reservation + // purchases. MaximumNumberOfInstancesUsedPerHour *string `type:"string"` // The minimum number of normalized units that you used in an hour during the - // historical period. AWS uses this to calculate your recommended reservation - // purchases. + // historical period. Amazon Web Services uses this to calculate your recommended + // reservation purchases. MinimumNormalizedUnitsUsedPerHour *string `type:"string"` // The minimum number of instances that you used in an hour during the historical - // period. AWS uses this to calculate your recommended reservation purchases. + // period. Amazon Web Services uses this to calculate your recommended reservation + // purchases. MinimumNumberOfInstancesUsedPerHour *string `type:"string"` - // The number of normalized units that AWS recommends that you purchase. + // The number of normalized units that Amazon Web Services recommends that you + // purchase. RecommendedNormalizedUnitsToPurchase *string `type:"string"` - // The number of instances that AWS recommends that you purchase. + // The number of instances that Amazon Web Services recommends that you purchase. RecommendedNumberOfInstancesToPurchase *string `type:"string"` // How much purchasing this instance costs you on a monthly basis. @@ -10434,11 +10657,11 @@ func (s *ReservationPurchaseRecommendationDetail) SetUpfrontCost(v string) *Rese } // Information about this specific recommendation, such as the timestamp for -// when AWS made a specific recommendation. +// when Amazon Web Services made a specific recommendation. type ReservationPurchaseRecommendationMetadata struct { _ struct{} `type:"structure"` - // The timestamp for when AWS made this recommendation. + // The timestamp for when Amazon Web Services made this recommendation. GenerationTimestamp *string `type:"string"` // The ID for this specific recommendation. @@ -10468,20 +10691,20 @@ func (s *ReservationPurchaseRecommendationMetadata) SetRecommendationId(v string } // A summary about this recommendation, such as the currency code, the amount -// that AWS estimates that you could save, and the total amount of reservation -// to purchase. +// that Amazon Web Services estimates that you could save, and the total amount +// of reservation to purchase. type ReservationPurchaseRecommendationSummary struct { _ struct{} `type:"structure"` // The currency code used for this recommendation. CurrencyCode *string `type:"string"` - // The total amount that AWS estimates that this recommendation could save you - // in a month. + // The total amount that Amazon Web Services estimates that this recommendation + // could save you in a month. TotalEstimatedMonthlySavingsAmount *string `type:"string"` - // The total amount that AWS estimates that this recommendation could save you - // in a month, as a percentage of your costs. + // The total amount that Amazon Web Services estimates that this recommendation + // could save you in a month, as a percentage of your costs. TotalEstimatedMonthlySavingsPercentage *string `type:"string"` } @@ -10648,7 +10871,7 @@ func (s *ResourceNotFoundException) RequestID() string { type ResourceUtilization struct { _ struct{} `type:"structure"` - // Utilization of current Amazon EC2 instance. + // The utilization of current Amazon EC2 instance. EC2ResourceUtilization *EC2ResourceUtilization `type:"structure"` } @@ -10668,11 +10891,11 @@ func (s *ResourceUtilization) SetEC2ResourceUtilization(v *EC2ResourceUtilizatio return s } -// The result that is associated with a time period. +// The result that's associated with a time period. type ResultByTime struct { _ struct{} `type:"structure"` - // Whether the result is estimated. + // Determines whether the result is estimated. Estimated *bool `type:"boolean"` // The groups that this time period includes. @@ -10734,13 +10957,13 @@ type RightsizingRecommendation struct { // Network). FindingReasonCodes []*string `type:"list"` - // Details for modification recommendations. + // The details for the modification recommendations. ModifyRecommendationDetail *ModifyRecommendationDetail `type:"structure"` - // Recommendation to either terminate or modify the resource. + // A recommendation to either terminate or modify the resource. RightsizingType *string `type:"string" enum:"RightsizingType"` - // Details for termination recommendations. + // The details for termination recommendations. TerminateRecommendationDetail *TerminateRecommendationDetail `type:"structure"` } @@ -10790,11 +11013,12 @@ func (s *RightsizingRecommendation) SetTerminateRecommendationDetail(v *Terminat return s } -// Enables you to customize recommendations across two attributes. You can choose -// to view recommendations for instances within the same instance families or -// across different instance families. You can also choose to view your estimated -// savings associated with recommendations with consideration of existing Savings -// Plans or RI benefits, or neither. +// You can use RightsizingRecommendationConfiguration to customize recommendations +// across two attributes. You can choose to view recommendations for instances +// within the same instance families or across different instance families. +// You can also choose to view your estimated savings that are associated with +// recommendations with consideration of existing Savings Plans or RI benefits, +// or neither. type RightsizingRecommendationConfiguration struct { _ struct{} `type:"structure"` @@ -10804,7 +11028,7 @@ type RightsizingRecommendationConfiguration struct { // BenefitsConsidered is a required field BenefitsConsidered *bool `type:"boolean" required:"true"` - // The option to see recommendations within the same instance family, or recommendations + // The option to see recommendations within the same instance family or recommendations // for instances across other families. The default value is SAME_INSTANCE_FAMILY. // // RecommendationTarget is a required field @@ -10853,13 +11077,14 @@ func (s *RightsizingRecommendationConfiguration) SetRecommendationTarget(v strin type RightsizingRecommendationMetadata struct { _ struct{} `type:"structure"` - // Additional metadata that may be applicable to the recommendation. + // Additional metadata that might be applicable to the recommendation. AdditionalMetadata *string `type:"string"` - // The timestamp for when AWS made this recommendation. + // The timestamp for when Amazon Web Services made this recommendation. GenerationTimestamp *string `type:"string"` - // How many days of previous usage that AWS considers when making this recommendation. + // The number of days of previous usage that Amazon Web Services considers when + // making this recommendation. LookbackPeriodInDays *string `type:"string" enum:"LookbackPeriodInDays"` // The ID for this specific recommendation. @@ -10900,21 +11125,21 @@ func (s *RightsizingRecommendationMetadata) SetRecommendationId(v string) *Right return s } -// Summary of rightsizing recommendations +// The summary of rightsizing recommendations type RightsizingRecommendationSummary struct { _ struct{} `type:"structure"` - // Estimated total savings resulting from modifications, on a monthly basis. + // The estimated total savings resulting from modifications, on a monthly basis. EstimatedTotalMonthlySavingsAmount *string `type:"string"` - // The currency code that AWS used to calculate the savings. + // The currency code that Amazon Web Services used to calculate the savings. SavingsCurrencyCode *string `type:"string"` - // Savings percentage based on the recommended modifications, relative to the - // total On-Demand costs associated with these instances. + // The savings percentage based on the recommended modifications. It's relative + // to the total On-Demand costs that are associated with these instances. SavingsPercentage *string `type:"string"` - // Total number of instance recommendations. + // The total number of instance recommendations. TotalRecommendationCount *string `type:"string"` } @@ -10952,21 +11177,21 @@ func (s *RightsizingRecommendationSummary) SetTotalRecommendationCount(v string) return s } -// The combination of AWS service, linked account, Region, and usage type where -// a cost anomaly is observed. +// The combination of Amazon Web Services service, linked account, Region, and +// usage type where a cost anomaly is observed. type RootCause struct { _ struct{} `type:"structure"` - // The linked account value associated with the cost anomaly. + // The member account value that's associated with the cost anomaly. LinkedAccount *string `type:"string"` - // The AWS Region associated with the cost anomaly. + // The Amazon Web Services Region that's associated with the cost anomaly. Region *string `type:"string"` - // The AWS service name associated with the cost anomaly. + // The Amazon Web Services service name that's associated with the cost anomaly. Service *string `type:"string"` - // The UsageType value associated with the cost anomaly. + // The UsageType value that's associated with the cost anomaly. UsageType *string `type:"string"` } @@ -11100,16 +11325,18 @@ type SavingsPlansCoverageData struct { _ struct{} `type:"structure"` // The percentage of your existing Savings Plans covered usage, divided by all - // of your eligible Savings Plans usage in an account(or set of accounts). + // of your eligible Savings Plans usage in an account (or set of accounts). CoveragePercentage *string `type:"string"` - // The cost of your AWS usage at the public On-Demand rate. + // The cost of your Amazon Web Services usage at the public On-Demand rate. OnDemandCost *string `type:"string"` - // The amount of your AWS usage that is covered by a Savings Plans. + // The amount of your Amazon Web Services usage that is covered by a Savings + // Plans. SpendCoveredBySavingsPlans *string `type:"string"` - // The total cost of your AWS usage, regardless of your purchase option. + // The total cost of your Amazon Web Services usage, regardless of your purchase + // option. TotalCost *string `type:"string"` } @@ -11147,18 +11374,18 @@ func (s *SavingsPlansCoverageData) SetTotalCost(v string) *SavingsPlansCoverageD return s } -// Attribute details on a specific Savings Plan. +// The attribute details on a specific Savings Plan. type SavingsPlansDetails struct { _ struct{} `type:"structure"` // A group of instance types that Savings Plans applies to. InstanceFamily *string `type:"string"` - // The unique ID used to distinguish Savings Plans from one another. + // The unique ID that's used to distinguish Savings Plans from one another. OfferingId *string `type:"string"` - // A collection of AWS resources in a geographic area. Each AWS Region is isolated - // and independent of the other Regions. + // A collection of Amazon Web Services resources in a geographic area. Each + // Amazon Web Services Region is isolated and independent of the other Regions. Region *string `type:"string"` } @@ -11196,9 +11423,9 @@ type SavingsPlansPurchaseRecommendation struct { _ struct{} `type:"structure"` // The account scope that you want your recommendations for. Amazon Web Services - // calculates recommendations including the management account and member accounts - // if the value is set to PAYER. If the value is LINKED, recommendations are - // calculated for individual member accounts only. + // calculates recommendations that include the management account and member + // accounts if the value is set to PAYER. If the value is LINKED, recommendations + // are calculated for individual member accounts only. AccountScope *string `type:"string" enum:"AccountScope"` // The lookback period in days, used to generate the recommendation. @@ -11217,7 +11444,8 @@ type SavingsPlansPurchaseRecommendation struct { // The requested Savings Plans recommendation type. SavingsPlansType *string `type:"string" enum:"SupportedSavingsPlansType"` - // The Savings Plans recommendation term in years, used to generate the recommendation. + // The Savings Plans recommendation term in years. It's used to generate the + // recommendation. TermInYears *string `type:"string" enum:"TermInYears"` } @@ -11280,8 +11508,8 @@ type SavingsPlansPurchaseRecommendationDetail struct { // The AccountID the recommendation is generated for. AccountId *string `type:"string"` - // The currency code AWS used to generate the recommendations and present potential - // savings. + // The currency code that Amazon Web Services used to generate the recommendations + // and present potential savings. CurrencyCode *string `type:"string"` // The average value of hourly On-Demand spend over the lookback period of the @@ -11299,7 +11527,7 @@ type SavingsPlansPurchaseRecommendationDetail struct { // The estimated utilization of the recommended Savings Plans. EstimatedAverageUtilization *string `type:"string"` - // The estimated monthly savings amount, based on the recommended Savings Plans. + // The estimated monthly savings amount based on the recommended Savings Plans. EstimatedMonthlySavingsAmount *string `type:"string"` // The remaining On-Demand cost estimated to not be covered by the recommended @@ -11311,24 +11539,24 @@ type SavingsPlansPurchaseRecommendationDetail struct { // own. EstimatedOnDemandCostWithCurrentCommitment *string `type:"string"` - // The estimated return on investment based on the recommended Savings Plans - // purchased. This is calculated as estimatedSavingsAmount/ estimatedSPCost*100. + // The estimated return on investment that's based on the recommended Savings + // Plans that you purchased. This is calculated as estimatedSavingsAmount/ estimatedSPCost*100. EstimatedROI *string `type:"string"` // The cost of the recommended Savings Plans over the length of the lookback // period. EstimatedSPCost *string `type:"string"` - // The estimated savings amount based on the recommended Savings Plans over - // the length of the lookback period. + // The estimated savings amount that's based on the recommended Savings Plans + // over the length of the lookback period. EstimatedSavingsAmount *string `type:"string"` // The estimated savings percentage relative to the total cost of applicable // On-Demand usage over the lookback period. EstimatedSavingsPercentage *string `type:"string"` - // The recommended hourly commitment level for the Savings Plans type, and configuration - // based on the usage during the lookback period. + // The recommended hourly commitment level for the Savings Plans type and the + // configuration that's based on the usage during the lookback period. HourlyCommitmentToPurchase *string `type:"string"` // Details for your recommended Savings Plans. @@ -11449,7 +11677,7 @@ func (s *SavingsPlansPurchaseRecommendationDetail) SetUpfrontCost(v string) *Sav type SavingsPlansPurchaseRecommendationMetadata struct { _ struct{} `type:"structure"` - // Additional metadata that may be applicable to the recommendation. + // Additional metadata that might be applicable to the recommendation. AdditionalMetadata *string `type:"string"` // The timestamp showing when the recommendations were generated. @@ -11491,8 +11719,8 @@ func (s *SavingsPlansPurchaseRecommendationMetadata) SetRecommendationId(v strin type SavingsPlansPurchaseRecommendationSummary struct { _ struct{} `type:"structure"` - // The currency code AWS used to generate the recommendations and present potential - // savings. + // The currency code that Amazon Web Services used to generate the recommendations + // and present potential savings. CurrencyCode *string `type:"string"` // The current total on demand spend of the applicable usage types over the @@ -11502,17 +11730,17 @@ type SavingsPlansPurchaseRecommendationSummary struct { // The recommended Savings Plans cost on a daily (24 hourly) basis. DailyCommitmentToPurchase *string `type:"string"` - // The estimated monthly savings amount, based on the recommended Savings Plans - // purchase. + // The estimated monthly savings amount that's based on the recommended Savings + // Plans purchase. EstimatedMonthlySavingsAmount *string `type:"string"` - // The estimated On-Demand costs you would expect with no additional commitment, - // based on your usage of the selected time period and the Savings Plans you - // own. + // The estimated On-Demand costs you would expect with no additional commitment. + // It's based on your usage of the selected time period and the Savings Plans + // you own. EstimatedOnDemandCostWithCurrentCommitment *string `type:"string"` - // The estimated return on investment based on the recommended Savings Plans - // and estimated savings. + // The estimated return on investment that's based on the recommended Savings + // Plans and estimated savings. EstimatedROI *string `type:"string"` // The estimated total savings over the lookback period, based on the purchase @@ -11528,7 +11756,7 @@ type SavingsPlansPurchaseRecommendationSummary struct { // remaining On-Demand usage. EstimatedTotalCost *string `type:"string"` - // The recommended hourly commitment based on the recommendation parameters. + // The recommended hourly commitment that's based on the recommendation parameters. HourlyCommitmentToPurchase *string `type:"string"` // The aggregate number of Savings Plans recommendations that exist for your @@ -11612,12 +11840,12 @@ func (s *SavingsPlansPurchaseRecommendationSummary) SetTotalRecommendationCount( return s } -// The amount of savings you're accumulating, against the public On-Demand rate -// of the usage accrued in an account. +// The amount of savings that you're accumulating, against the public On-Demand +// rate of the usage accrued in an account. type SavingsPlansSavings struct { _ struct{} `type:"structure"` - // The savings amount that you are accumulating for the usage that is covered + // The savings amount that you're accumulating for the usage that's covered // by a Savings Plans, when compared to the On-Demand equivalent of the same // usage. NetSavings *string `type:"string"` @@ -11649,7 +11877,7 @@ func (s *SavingsPlansSavings) SetOnDemandCostEquivalent(v string) *SavingsPlansS return s } -// The measurement of how well you are using your existing Savings Plans. +// The measurement of how well you're using your existing Savings Plans. type SavingsPlansUtilization struct { _ struct{} `type:"structure"` @@ -11657,7 +11885,7 @@ type SavingsPlansUtilization struct { // account (or set of accounts). TotalCommitment *string `type:"string"` - // The amount of your Savings Plans commitment that was not consumed from Savings + // The amount of your Savings Plans commitment that wasn't consumed from Savings // Plans eligible usage in a specific period. UnusedCommitment *string `type:"string"` @@ -11939,8 +12167,8 @@ func (s *ServiceQuotaExceededException) RequestID() string { type ServiceSpecification struct { _ struct{} `type:"structure"` - // The Amazon EC2 hardware specifications that you want AWS to provide recommendations - // for. + // The Amazon EC2 hardware specifications that you want Amazon Web Services + // to provide recommendations for. EC2Specification *EC2Specification `type:"structure"` } @@ -11964,12 +12192,12 @@ func (s *ServiceSpecification) SetEC2Specification(v *EC2Specification) *Service type SortDefinition struct { _ struct{} `type:"structure"` - // The key by which to sort the data. + // The key that's used to sort the data. // // Key is a required field Key *string `type:"string" required:"true"` - // The order in which to sort the data. + // The order that's used to sort the data. SortOrder *string `type:"string" enum:"SortOrder"` } @@ -12012,7 +12240,8 @@ func (s *SortDefinition) SetSortOrder(v string) *SortDefinition { type Subscriber struct { _ struct{} `type:"structure"` - // The email address or SNS Amazon Resource Name (ARN), depending on the Type. + // The email address or SNS Amazon Resource Name (ARN). This depends on the + // Type. Address *string `min:"6" type:"string"` // Indicates if the subscriber accepts the notifications. @@ -12065,12 +12294,12 @@ func (s *Subscriber) SetType(v string) *Subscriber { // The values that are available for a tag. // -// If Values and Key are not specified, the ABSENT MatchOption is applied to -// all tags. That is, filtering on resources with no tags. +// If Values and Key aren't specified, the ABSENT MatchOption is applied to +// all tags. That is, it's filtered on resources with no tags. // -// If Values is provided and Key is not specified, the ABSENT MatchOption is -// applied to the tag Key only. That is, filtering on resources without the -// given tag key. +// If Values is provided and Key isn't specified, the ABSENT MatchOption is +// applied to the tag Key only. That is, it's filtered on resources without +// the given tag key. type TagValues struct { _ struct{} `type:"structure"` @@ -12118,19 +12347,21 @@ func (s *TagValues) SetValues(v []*string) *TagValues { type TargetInstance struct { _ struct{} `type:"structure"` - // The currency code that AWS used to calculate the costs for this instance. + // The currency code that Amazon Web Services used to calculate the costs for + // this instance. CurrencyCode *string `type:"string"` - // Indicates whether this recommendation is the defaulted AWS recommendation. + // Determines whether this recommendation is the defaulted Amazon Web Services + // recommendation. DefaultTargetInstance *bool `type:"boolean"` - // Expected cost to operate this instance type on a monthly basis. + // The expected cost to operate this instance type on a monthly basis. EstimatedMonthlyCost *string `type:"string"` - // Estimated savings resulting from modification, on a monthly basis. + // The estimated savings that result from modification, on a monthly basis. EstimatedMonthlySavings *string `type:"string"` - // Expected utilization metrics for target instance type. + // The expected utilization metrics for target instance type. ExpectedResourceUtilization *ResourceUtilization `type:"structure"` // Explains the actions you might need to take in order to successfully migrate @@ -12198,10 +12429,11 @@ func (s *TargetInstance) SetResourceDetails(v *ResourceDetails) *TargetInstance type TerminateRecommendationDetail struct { _ struct{} `type:"structure"` - // The currency code that AWS used to calculate the costs for this instance. + // The currency code that Amazon Web Services used to calculate the costs for + // this instance. CurrencyCode *string `type:"string"` - // Estimated savings resulting from modification, on a monthly basis. + // The estimated savings that result from modification, on a monthly basis. EstimatedMonthlySavings *string `type:"string"` } @@ -12231,15 +12463,15 @@ func (s *TerminateRecommendationDetail) SetEstimatedMonthlySavings(v string) *Te type TotalImpactFilter struct { _ struct{} `type:"structure"` - // The upper bound dollar value used in the filter. + // The upper bound dollar value that's used in the filter. EndValue *float64 `type:"double"` - // The comparing value used in the filter. + // The comparing value that's used in the filter. // // NumericOperator is a required field NumericOperator *string `type:"string" required:"true" enum:"NumericOperator"` - // The lower bound dollar value used in the filter. + // The lower bound dollar value that's used in the filter. // // StartValue is a required field StartValue *float64 `type:"double" required:"true"` @@ -12533,7 +12765,7 @@ func (s *UpdateAnomalyMonitorOutput) SetMonitorArn(v string) *UpdateAnomalyMonit type UpdateAnomalySubscriptionInput struct { _ struct{} `type:"structure"` - // The update to the frequency value at which subscribers will receive notifications. + // The update to the frequency value that subscribers receive notifications. Frequency *string `type:"string" enum:"AnomalySubscriptionFrequency"` // A list of cost anomaly monitor ARNs. @@ -12547,7 +12779,7 @@ type UpdateAnomalySubscriptionInput struct { // SubscriptionArn is a required field SubscriptionArn *string `type:"string" required:"true"` - // The subscription's new name. + // The new name of the subscription. SubscriptionName *string `type:"string"` // The update to the threshold value for receiving notifications. @@ -12669,6 +12901,10 @@ type UpdateCostCategoryDefinitionInput struct { // // Rules is a required field Rules []*CostCategoryRule `min:"1" type:"list" required:"true"` + + // The split charge rules used to allocate your charges between your Cost Category + // values. + SplitChargeRules []*CostCategorySplitChargeRule `min:"1" type:"list"` } // String returns the string representation @@ -12702,6 +12938,9 @@ func (s *UpdateCostCategoryDefinitionInput) Validate() error { if s.Rules != nil && len(s.Rules) < 1 { invalidParams.Add(request.NewErrParamMinLen("Rules", 1)) } + if s.SplitChargeRules != nil && len(s.SplitChargeRules) < 1 { + invalidParams.Add(request.NewErrParamMinLen("SplitChargeRules", 1)) + } if s.Rules != nil { for i, v := range s.Rules { if v == nil { @@ -12712,6 +12951,16 @@ func (s *UpdateCostCategoryDefinitionInput) Validate() error { } } } + if s.SplitChargeRules != nil { + for i, v := range s.SplitChargeRules { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "SplitChargeRules", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -12743,6 +12992,12 @@ func (s *UpdateCostCategoryDefinitionInput) SetRules(v []*CostCategoryRule) *Upd return s } +// SetSplitChargeRules sets the SplitChargeRules field's value. +func (s *UpdateCostCategoryDefinitionInput) SetSplitChargeRules(v []*CostCategorySplitChargeRule) *UpdateCostCategoryDefinitionInput { + s.SplitChargeRules = v + return s +} + type UpdateCostCategoryDefinitionOutput struct { _ struct{} `type:"structure"` @@ -12938,6 +13193,38 @@ func CostCategoryRuleVersion_Values() []string { } } +const ( + // CostCategorySplitChargeMethodFixed is a CostCategorySplitChargeMethod enum value + CostCategorySplitChargeMethodFixed = "FIXED" + + // CostCategorySplitChargeMethodProportional is a CostCategorySplitChargeMethod enum value + CostCategorySplitChargeMethodProportional = "PROPORTIONAL" + + // CostCategorySplitChargeMethodEven is a CostCategorySplitChargeMethod enum value + CostCategorySplitChargeMethodEven = "EVEN" +) + +// CostCategorySplitChargeMethod_Values returns all elements of the CostCategorySplitChargeMethod enum +func CostCategorySplitChargeMethod_Values() []string { + return []string{ + CostCategorySplitChargeMethodFixed, + CostCategorySplitChargeMethodProportional, + CostCategorySplitChargeMethodEven, + } +} + +const ( + // CostCategorySplitChargeRuleParameterTypeAllocationPercentages is a CostCategorySplitChargeRuleParameterType enum value + CostCategorySplitChargeRuleParameterTypeAllocationPercentages = "ALLOCATION_PERCENTAGES" +) + +// CostCategorySplitChargeRuleParameterType_Values returns all elements of the CostCategorySplitChargeRuleParameterType enum +func CostCategorySplitChargeRuleParameterType_Values() []string { + return []string{ + CostCategorySplitChargeRuleParameterTypeAllocationPercentages, + } +} + const ( // CostCategoryStatusProcessing is a CostCategoryStatus enum value CostCategoryStatusProcessing = "PROCESSING" diff --git a/service/costexplorer/doc.go b/service/costexplorer/doc.go index b019d4cd494..6f6a07b864f 100644 --- a/service/costexplorer/doc.go +++ b/service/costexplorer/doc.go @@ -3,11 +3,11 @@ // Package costexplorer provides the client and types for making API // requests to AWS Cost Explorer Service. // -// The Cost Explorer API enables you to programmatically query your cost and +// You can use the Cost Explorer API to programmatically query your cost and // usage data. You can query for aggregated data such as total monthly costs -// or total daily usage. You can also query for granular data, such as the number -// of daily write operations for Amazon DynamoDB database tables in your production -// environment. +// or total daily usage. You can also query for granular data. This might include +// the number of daily write operations for Amazon DynamoDB database tables +// in your production environment. // // Service Endpoint // @@ -15,8 +15,8 @@ // // * https://ce.us-east-1.amazonaws.com // -// For information about costs associated with the Cost Explorer API, see AWS -// Cost Management Pricing (http://aws.amazon.com/aws-cost-management/pricing/). +// For information about the costs that are associated with the Cost Explorer +// API, see Amazon Web Services Cost Management Pricing (http://aws.amazon.com/aws-cost-management/pricing/). // // See https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25 for more information on this service. // diff --git a/service/ec2/api.go b/service/ec2/api.go index e84fda30309..b15d00639bc 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -5133,18 +5133,19 @@ func (c *EC2) CreateKeyPairRequest(input *CreateKeyPairInput) (req *request.Requ // CreateKeyPair API operation for Amazon Elastic Compute Cloud. // -// Creates a 2048-bit RSA key pair with the specified name. Amazon EC2 stores -// the public key and displays the private key for you to save to a file. The -// private key is returned as an unencrypted PEM encoded PKCS#1 private key. -// If a key with the specified name already exists, Amazon EC2 returns an error. +// Creates an ED25519 or 2048-bit RSA key pair with the specified name. Amazon +// EC2 stores the public key and displays the private key for you to save to +// a file. The private key is returned as an unencrypted PEM encoded PKCS#1 +// private key. If a key with the specified name already exists, Amazon EC2 +// returns an error. // -// You can have up to five thousand key pairs per Region. +// The key pair returned to you is available only in the Amazon Web Services +// Region in which you create it. If you prefer, you can create your own key +// pair using a third-party tool and upload it to any Region using ImportKeyPair. // -// The key pair returned to you is available only in the Region in which you -// create it. If you prefer, you can create your own key pair using a third-party -// tool and upload it to any Region using ImportKeyPair. +// You can have up to 5,000 key pairs per Amazon Web Services Region. // -// For more information, see Key Pairs (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) +// For more information, see Amazon EC2 key pairs (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) // in the Amazon Elastic Compute Cloud User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -6613,9 +6614,9 @@ func (c *EC2) CreateSecurityGroupRequest(input *CreateSecurityGroupInput) (req * // Creates a security group. // // A security group acts as a virtual firewall for your instance to control -// inbound and outbound traffic. For more information, see Amazon EC2 Security -// Groups (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html) -// in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your +// inbound and outbound traffic. For more information, see Amazon EC2 security +// groups (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html) +// in the Amazon Elastic Compute Cloud User Guide and Security groups for your // VPC (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html) // in the Amazon Virtual Private Cloud User Guide. // @@ -19644,7 +19645,7 @@ func (c *EC2) DescribeKeyPairsRequest(input *DescribeKeyPairsInput) (req *reques // // Describes the specified key pairs or all of your key pairs. // -// For more information about key pairs, see Key Pairs (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) +// For more information about key pairs, see Amazon EC2 key pairs (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) // in the Amazon Elastic Compute Cloud User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -23707,9 +23708,9 @@ func (c *EC2) DescribeSecurityGroupsRequest(input *DescribeSecurityGroupsInput) // Describes the specified security groups or all of your security groups. // // A security group is for use with instances either in the EC2-Classic platform -// or in a specific VPC. For more information, see Amazon EC2 Security Groups +// or in a specific VPC. For more information, see Amazon EC2 security groups // (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-network-security.html) -// in the Amazon Elastic Compute Cloud User Guide and Security Groups for Your +// in the Amazon Elastic Compute Cloud User Guide and Security groups for your // VPC (https://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_SecurityGroups.html) // in the Amazon Virtual Private Cloud User Guide. // @@ -34346,14 +34347,14 @@ func (c *EC2) ImportKeyPairRequest(input *ImportKeyPairInput) (req *request.Requ // ImportKeyPair API operation for Amazon Elastic Compute Cloud. // -// Imports the public key from an RSA key pair that you created with a third-party -// tool. Compare this with CreateKeyPair, in which Amazon Web Services creates -// the key pair and gives the keys to you (Amazon Web Services keeps a copy -// of the public key). With ImportKeyPair, you create the key pair and give -// Amazon Web Services just the public key. The private key is never transferred -// between you and Amazon Web Services. +// Imports the public key from an RSA or ED25519 key pair that you created with +// a third-party tool. Compare this with CreateKeyPair, in which Amazon Web +// Services creates the key pair and gives the keys to you (Amazon Web Services +// keeps a copy of the public key). With ImportKeyPair, you create the key pair +// and give Amazon Web Services just the public key. The private key is never +// transferred between you and Amazon Web Services. // -// For more information about key pairs, see Key Pairs (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) +// For more information about key pairs, see Amazon EC2 key pairs (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) // in the Amazon Elastic Compute Cloud User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -54199,6 +54200,12 @@ type CreateKeyPairInput struct { // KeyName is a required field KeyName *string `type:"string" required:"true"` + // The type of key pair. Note that ED25519 keys are not supported for Windows + // instances, EC2 Instance Connect, and EC2 Serial Console. + // + // Default: rsa + KeyType *string `type:"string" enum:"KeyType"` + // The tags to apply to the new key pair. TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` } @@ -54238,6 +54245,12 @@ func (s *CreateKeyPairInput) SetKeyName(v string) *CreateKeyPairInput { return s } +// SetKeyType sets the KeyType field's value. +func (s *CreateKeyPairInput) SetKeyType(v string) *CreateKeyPairInput { + s.KeyType = &v + return s +} + // SetTagSpecifications sets the TagSpecifications field's value. func (s *CreateKeyPairInput) SetTagSpecifications(v []*TagSpecification) *CreateKeyPairInput { s.TagSpecifications = v @@ -54251,7 +54264,7 @@ type CreateKeyPairOutput struct { // The SHA-1 digest of the DER encoded private key. KeyFingerprint *string `locationName:"keyFingerprint" type:"string"` - // An unencrypted PEM encoded RSA private key. + // An unencrypted PEM encoded RSA or ED25519 private key. KeyMaterial *string `locationName:"keyMaterial" type:"string" sensitive:"true"` // The name of the key pair. @@ -96821,10 +96834,21 @@ func (s *Ipv6Range) SetDescription(v string) *Ipv6Range { type KeyPairInfo struct { _ struct{} `type:"structure"` - // If you used CreateKeyPair to create the key pair, this is the SHA-1 digest - // of the DER encoded private key. If you used ImportKeyPair to provide Amazon - // Web Services the public key, this is the MD5 public key fingerprint as specified - // in section 4 of RFC4716. + // If you used CreateKeyPair to create the key pair: + // + // * For RSA key pairs, the key fingerprint is the SHA-1 digest of the DER + // encoded private key. + // + // * For ED25519 key pairs, the key fingerprint is the base64-encoded SHA-256 + // digest, which is the default for OpenSSH, starting with OpenSSH 6.8 (http://www.openssh.com/txt/release-6.8). + // + // If you used ImportKeyPair to provide Amazon Web Services the public key: + // + // * For RSA key pairs, the key fingerprint is the MD5 public key fingerprint + // as specified in section 4 of RFC4716. + // + // * For ED25519 key pairs, the key fingerprint is the base64-encoded SHA-256 + // digest, which is the default for OpenSSH, starting with OpenSSH 6.8 (http://www.openssh.com/txt/release-6.8). KeyFingerprint *string `locationName:"keyFingerprint" type:"string"` // The name of the key pair. @@ -96833,6 +96857,9 @@ type KeyPairInfo struct { // The ID of the key pair. KeyPairId *string `locationName:"keyPairId" type:"string"` + // The type of key pair. + KeyType *string `locationName:"keyType" type:"string" enum:"KeyType"` + // Any tags applied to the key pair. Tags []*Tag `locationName:"tagSet" locationNameList:"item" type:"list"` } @@ -96865,6 +96892,12 @@ func (s *KeyPairInfo) SetKeyPairId(v string) *KeyPairInfo { return s } +// SetKeyType sets the KeyType field's value. +func (s *KeyPairInfo) SetKeyType(v string) *KeyPairInfo { + s.KeyType = &v + return s +} + // SetTags sets the Tags field's value. func (s *KeyPairInfo) SetTags(v []*Tag) *KeyPairInfo { s.Tags = v @@ -132570,6 +132603,22 @@ func Ipv6SupportValue_Values() []string { } } +const ( + // KeyTypeRsa is a KeyType enum value + KeyTypeRsa = "rsa" + + // KeyTypeEd25519 is a KeyType enum value + KeyTypeEd25519 = "ed25519" +) + +// KeyType_Values returns all elements of the KeyType enum +func KeyType_Values() []string { + return []string{ + KeyTypeRsa, + KeyTypeEd25519, + } +} + const ( // LaunchTemplateErrorCodeLaunchTemplateIdDoesNotExist is a LaunchTemplateErrorCode enum value LaunchTemplateErrorCodeLaunchTemplateIdDoesNotExist = "launchTemplateIdDoesNotExist"