From 5cb80a8227e76a3d85ffb97389eda841c61a6a28 Mon Sep 17 00:00:00 2001 From: AWS SDK for Ruby Date: Tue, 7 Jun 2022 18:03:27 +0000 Subject: [PATCH] Updated API models and rebuilt service gems. --- apis/auditmanager/2017-07-25/api-2.json | 16 +- apis/auditmanager/2017-07-25/docs-2.json | 12 +- apis/ce/2017-10-25/api-2.json | 133 +++++ apis/ce/2017-10-25/docs-2.json | 335 +++++++---- apis/ce/2017-10-25/paginators-1.json | 5 + gems/aws-partitions/CHANGELOG.md | 5 + gems/aws-partitions/VERSION | 2 +- gems/aws-partitions/partitions.json | 5 + gems/aws-sdk-auditmanager/CHANGELOG.md | 5 + gems/aws-sdk-auditmanager/VERSION | 2 +- .../lib/aws-sdk-auditmanager.rb | 2 +- .../lib/aws-sdk-auditmanager/client.rb | 49 +- .../lib/aws-sdk-auditmanager/client_api.rb | 9 +- .../lib/aws-sdk-auditmanager/errors.rb | 16 + .../lib/aws-sdk-auditmanager/types.rb | 32 +- gems/aws-sdk-costexplorer/CHANGELOG.md | 5 + gems/aws-sdk-costexplorer/VERSION | 2 +- .../lib/aws-sdk-costexplorer.rb | 2 +- .../lib/aws-sdk-costexplorer/client.rb | 368 +++++++----- .../lib/aws-sdk-costexplorer/client_api.rb | 78 +++ .../lib/aws-sdk-costexplorer/types.rb | 555 ++++++++++++------ 21 files changed, 1179 insertions(+), 459 deletions(-) diff --git a/apis/auditmanager/2017-07-25/api-2.json b/apis/auditmanager/2017-07-25/api-2.json index 03c5db184a0..f13f9b0b471 100644 --- a/apis/auditmanager/2017-07-25/api-2.json +++ b/apis/auditmanager/2017-07-25/api-2.json @@ -712,7 +712,8 @@ {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"InternalServerException"}, - {"shape":"ResourceNotFoundException"} + {"shape":"ResourceNotFoundException"}, + {"shape":"ThrottlingException"} ] }, "RegisterOrganizationAdminAccount":{ @@ -3024,6 +3025,10 @@ }, "Role":{ "type":"structure", + "required":[ + "roleType", + "roleArn" + ], "members":{ "roleType":{"shape":"RoleType"}, "roleArn":{"shape":"IamArn"} @@ -3253,6 +3258,15 @@ "max":1000, "pattern":"^[\\w\\W\\s\\S]*$" }, + "ThrottlingException":{ + "type":"structure", + "required":["message"], + "members":{ + "message":{"shape":"String"} + }, + "error":{"httpStatusCode":400}, + "exception":true + }, "Timestamp":{"type":"timestamp"}, "TimestampUUID":{ "type":"string", diff --git a/apis/auditmanager/2017-07-25/docs-2.json b/apis/auditmanager/2017-07-25/docs-2.json index 79450f442af..16d2764924a 100644 --- a/apis/auditmanager/2017-07-25/docs-2.json +++ b/apis/auditmanager/2017-07-25/docs-2.json @@ -35,7 +35,7 @@ "GetInsights": "

Gets the latest analytics data for all your current active assessments.

", "GetInsightsByAssessment": "

Gets the latest analytics data for a specific active assessment.

", "GetOrganizationAdminAccount": "

Returns the name of the delegated Amazon Web Services administrator account for the organization.

", - "GetServicesInScope": "

Returns a list of the in-scope Amazon Web Services services for the specified assessment.

", + "GetServicesInScope": "

Returns a list of the in-scope Amazon Web Services for the specified assessment.

", "GetSettings": "

Returns the settings for the specified Amazon Web Services account.

", "ListAssessmentControlInsightsByControlDomain": "

Lists the latest analytics data for controls within a specific control domain and a specific active assessment.

Control insights are listed only if the control belongs to the control domain and assessment that was specified. Moreover, the control must have collected evidence on the lastUpdated date of controlInsightsByAssessment. If neither of these conditions are met, no data is listed for that control.

", "ListAssessmentFrameworkShareRequests": "

Returns a list of sent or received share requests for custom frameworks in Audit Manager.

", @@ -51,7 +51,7 @@ "ListTagsForResource": "

Returns a list of tags for the specified resource in Audit Manager.

", "RegisterAccount": "

Enables Audit Manager for the specified Amazon Web Services account.

", "RegisterOrganizationAdminAccount": "

Enables an Amazon Web Services account within the organization as the delegated administrator for Audit Manager.

", - "StartAssessmentFrameworkShare": "

Creates a share request for a custom framework in Audit Manager.

The share request specifies a recipient and notifies them that a custom framework is available. Recipients have 120 days to accept or decline the request. If no action is taken, the share request expires.

When you invoke the StartAssessmentFrameworkShare API, you are about to share a custom framework with another Amazon Web Services account. You may not share a custom framework that is derived from a standard framework if the standard framework is designated as not eligible for sharing by Amazon Web Services, unless you have obtained permission to do so from the owner of the standard framework. To learn more about which standard frameworks are eligible for sharing, see Framework sharing eligibility in the Audit Manager User Guide.

", + "StartAssessmentFrameworkShare": "

Creates a share request for a custom framework in Audit Manager.

The share request specifies a recipient and notifies them that a custom framework is available. Recipients have 120 days to accept or decline the request. If no action is taken, the share request expires.

When you create a share request, Audit Manager stores a snapshot of your custom framework in the US East (N. Virginia) Amazon Web Services Region. Audit Manager also stores a backup of the same snapshot in the US West (Oregon) Amazon Web Services Region.

Audit Manager deletes the snapshot and the backup snapshot when one of the following events occurs:

When a sender resends a share request, the snapshot is replaced with an updated version that corresponds with the latest version of the custom framework.

When a recipient accepts a share request, the snapshot is replicated into their Amazon Web Services account under the Amazon Web Services Region that was specified in the share request.

When you invoke the StartAssessmentFrameworkShare API, you are about to share a custom framework with another Amazon Web Services account. You may not share a custom framework that is derived from a standard framework if the standard framework is designated as not eligible for sharing by Amazon Web Services, unless you have obtained permission to do so from the owner of the standard framework. To learn more about which standard frameworks are eligible for sharing, see Framework sharing eligibility in the Audit Manager User Guide.

", "TagResource": "

Tags the specified resource in Audit Manager.

", "UntagResource": "

Removes a tag from a resource in Audit Manager.

", "UpdateAssessment": "

Edits an Audit Manager assessment.

", @@ -1281,7 +1281,7 @@ "AssessmentEvidenceFolder$totalEvidence": "

The total amount of evidence in the evidence folder.

", "AssessmentEvidenceFolder$assessmentReportSelectionCount": "

The total count of evidence that's included in the assessment report.

", "AssessmentEvidenceFolder$evidenceResourcesIncludedCount": "

The amount of evidence that's included in the evidence folder.

", - "AssessmentEvidenceFolder$evidenceByTypeConfigurationDataCount": "

The number of evidence that falls under the configuration data category. This evidence is collected from configuration snapshots of other Amazon Web Services services such as Amazon EC2, Amazon S3, or IAM.

", + "AssessmentEvidenceFolder$evidenceByTypeConfigurationDataCount": "

The number of evidence that falls under the configuration data category. This evidence is collected from configuration snapshots of other Amazon Web Services such as Amazon EC2, Amazon S3, or IAM.

", "AssessmentEvidenceFolder$evidenceByTypeManualCount": "

The number of evidence that falls under the manual category. This evidence is imported manually.

", "AssessmentEvidenceFolder$evidenceByTypeComplianceCheckCount": "

The number of evidence that falls under the compliance check category. This evidence is collected from Config or Security Hub.

", "AssessmentEvidenceFolder$evidenceByTypeComplianceCheckIssuesCount": "

The total number of issues that were reported directly from Security Hub, Config, or both.

", @@ -1769,6 +1769,7 @@ "ResourceNotFoundException$message": null, "ResourceNotFoundException$resourceId": "

The unique identifier for the resource.

", "ResourceNotFoundException$resourceType": "

The type of resource that's affected by the error.

", + "ThrottlingException$message": null, "UpdateAssessmentControlSetStatusRequest$controlSetId": "

The unique identifier for the control set.

", "ValidateAssessmentReportIntegrityResponse$signatureAlgorithm": "

The signature algorithm that's used to code sign the assessment report file.

", "ValidateAssessmentReportIntegrityResponse$signatureDateTime": "

The date and time signature that specifies when the assessment report was created.

", @@ -1828,6 +1829,11 @@ "UpdateControlRequest$testingInformation": "

The steps that you should follow to determine if the control is met.

" } }, + "ThrottlingException": { + "base": "

The request was denied due to request throttling.

", + "refs": { + } + }, "Timestamp": { "base": null, "refs": { diff --git a/apis/ce/2017-10-25/api-2.json b/apis/ce/2017-10-25/api-2.json index f2897894137..fa628d361da 100644 --- a/apis/ce/2017-10-25/api-2.json +++ b/apis/ce/2017-10-25/api-2.json @@ -361,6 +361,19 @@ {"shape":"UnresolvableUsageUnitException"} ] }, + "ListCostAllocationTags":{ + "name":"ListCostAllocationTags", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListCostAllocationTagsRequest"}, + "output":{"shape":"ListCostAllocationTagsResponse"}, + "errors":[ + {"shape":"LimitExceededException"}, + {"shape":"InvalidNextTokenException"} + ] + }, "ListCostCategoryDefinitions":{ "name":"ListCostCategoryDefinitions", "http":{ @@ -452,6 +465,18 @@ {"shape":"UnknownSubscriptionException"} ] }, + "UpdateCostAllocationTagsStatus":{ + "name":"UpdateCostAllocationTagsStatus", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"UpdateCostAllocationTagsStatusRequest"}, + "output":{"shape":"UpdateCostAllocationTagsStatusResponse"}, + "errors":[ + {"shape":"LimitExceededException"} + ] + }, "UpdateCostCategoryDefinition":{ "name":"UpdateCostCategoryDefinition", "http":{ @@ -609,6 +634,67 @@ "SAVINGS_PLANS" ] }, + "CostAllocationTag":{ + "type":"structure", + "required":[ + "TagKey", + "Type", + "Status" + ], + "members":{ + "TagKey":{"shape":"TagKey"}, + "Type":{"shape":"CostAllocationTagType"}, + "Status":{"shape":"CostAllocationTagStatus"} + } + }, + "CostAllocationTagKeyList":{ + "type":"list", + "member":{"shape":"TagKey"}, + "max":100, + "min":1 + }, + "CostAllocationTagList":{ + "type":"list", + "member":{"shape":"CostAllocationTag"}, + "max":100, + "min":0 + }, + "CostAllocationTagStatus":{ + "type":"string", + "enum":[ + "Active", + "Inactive" + ] + }, + "CostAllocationTagStatusEntry":{ + "type":"structure", + "required":[ + "TagKey", + "Status" + ], + "members":{ + "TagKey":{"shape":"TagKey"}, + "Status":{"shape":"CostAllocationTagStatus"} + } + }, + "CostAllocationTagStatusList":{ + "type":"list", + "member":{"shape":"CostAllocationTagStatusEntry"}, + "max":20, + "min":1 + }, + "CostAllocationTagType":{ + "type":"string", + "enum":[ + "AWSGenerated", + "UserDefined" + ] + }, + "CostAllocationTagsMaxResults":{ + "type":"integer", + "max":1000, + "min":1 + }, "CostCategory":{ "type":"structure", "required":[ @@ -1698,6 +1784,26 @@ }, "exception":true }, + "ListCostAllocationTagsRequest":{ + "type":"structure", + "members":{ + "Status":{"shape":"CostAllocationTagStatus"}, + "TagKeys":{"shape":"CostAllocationTagKeyList"}, + "Type":{"shape":"CostAllocationTagType"}, + "NextToken":{"shape":"NextPageToken"}, + "MaxResults":{ + "shape":"CostAllocationTagsMaxResults", + "box":true + } + } + }, + "ListCostAllocationTagsResponse":{ + "type":"structure", + "members":{ + "CostAllocationTags":{"shape":"CostAllocationTagList"}, + "NextToken":{"shape":"NextPageToken"} + } + }, "ListCostCategoryDefinitionsRequest":{ "type":"structure", "members":{ @@ -2612,6 +2718,33 @@ "SubscriptionArn":{"shape":"GenericString"} } }, + "UpdateCostAllocationTagsStatusError":{ + "type":"structure", + "members":{ + "TagKey":{"shape":"TagKey"}, + "Code":{"shape":"GenericString"}, + "Message":{"shape":"ErrorMessage"} + } + }, + "UpdateCostAllocationTagsStatusErrors":{ + "type":"list", + "member":{"shape":"UpdateCostAllocationTagsStatusError"}, + "max":20, + "min":0 + }, + "UpdateCostAllocationTagsStatusRequest":{ + "type":"structure", + "required":["CostAllocationTagsStatus"], + "members":{ + "CostAllocationTagsStatus":{"shape":"CostAllocationTagStatusList"} + } + }, + "UpdateCostAllocationTagsStatusResponse":{ + "type":"structure", + "members":{ + "Errors":{"shape":"UpdateCostAllocationTagsStatusErrors"} + } + }, "UpdateCostCategoryDefinitionRequest":{ "type":"structure", "required":[ diff --git a/apis/ce/2017-10-25/docs-2.json b/apis/ce/2017-10-25/docs-2.json index 698aa5d3cc1..a1a4fc5b57b 100644 --- a/apis/ce/2017-10-25/docs-2.json +++ b/apis/ce/2017-10-25/docs-2.json @@ -8,32 +8,34 @@ "DeleteAnomalyMonitor": "

Deletes a cost anomaly monitor.

", "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.

", + "DescribeCostCategoryDefinition": "

Returns the name, Amazon Resource 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's active on a specific date. If there's no EffectiveOn specified, you see a Cost Category that's 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 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 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.

", + "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 about 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.

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.

", + "GetReservationCoverage": "

Retrieves the reservation coverage for your account, which you can use 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 reservation purchases. These recommendations might help you to 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 Reserved Instance (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 Reserved Instance (RI). Amazon Web Services also shows the equal number of normalized units. This way, you can purchase any instance size that you want. For this example, your RI recommendation is 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 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 more information about 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.

", + "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 can't group by any dimension values for GetSavingsPlansUtilization.

", "GetSavingsPlansUtilizationDetails": "

Retrieves attribute data along with aggregate utilization and savings data for a given time period. This doesn't support granular or grouped data (daily/monthly) in response. You can't retrieve data by dates in a single response similar to GetSavingsPlanUtilization, but you have the option to make multiple calls to GetSavingsPlanUtilizationDetails by providing individual dates. You can use GetDimensionValues in SAVINGS_PLANS to determine the possible dimension values.

GetSavingsPlanUtilizationDetails internally groups data by SavingsPlansArn.

", "GetTags": "

Queries for available tag keys and tag values for a specified period. You can search the tag values for an arbitrary string.

", "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.

", + "ListCostAllocationTags": "

Get a list of cost allocation tags. All inputs in the API are optional and serve as filters. By default, all cost allocation tags are returned.

", + "ListCostCategoryDefinitions": "

Returns the name, Amazon Resource 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.

", "ListTagsForResource": "

Returns a list of resource tags associated with the resource specified by the Amazon Resource Name (ARN).

", "ProvideAnomalyFeedback": "

Modifies the feedback property of a given cost anomaly.

", - "TagResource": "

An API operation for adding one or more tags (key-value pairs) to a resource.

You can use the TagResource operation with a resource that already has tags. If you specify a new tag key for the resource, this tag is appended to the list of tags associated with the resource. If you specify a tag key that is already associated with the resource, the new tag value you specify replaces the previous value for that tag.

Although the maximum number of array members is 200, user-tag maximum is 50. The remaining are reserved for Amazon Web Services use.

", - "UntagResource": "

Removes one or more tags from a resource. Specify only tag key(s) in your request. Do not specify the value.

", + "TagResource": "

An API operation for adding one or more tags (key-value pairs) to a resource.

You can use the TagResource operation with a resource that already has tags. If you specify a new tag key for the resource, this tag is appended to the list of tags associated with the resource. If you specify a tag key that is already associated with the resource, the new tag value you specify replaces the previous value for that tag.

Although the maximum number of array members is 200, user-tag maximum is 50. The remaining are reserved for Amazon Web Services use.

", + "UntagResource": "

Removes one or more tags from a resource. Specify only tag keys in your request. Don't specify the value.

", "UpdateAnomalyMonitor": "

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

", "UpdateAnomalySubscription": "

Updates an existing cost anomaly monitor subscription.

", + "UpdateCostAllocationTagsStatus": "

Updates status for cost allocation tags in bulk, with maximum batch size of 20. If the tag status that's updated is the same as the existing tag status, the request doesn't fail. Instead, it doesn't have any effect on the tag status (for example, activating the active tag).

", "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": { @@ -128,18 +130,18 @@ "refs": { "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.

", - "DescribeCostCategoryDefinitionRequest$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.

", + "DescribeCostCategoryDefinitionRequest$CostCategoryArn": "

The unique identifier for your Cost Category.

", "ListTagsForResourceRequest$ResourceArn": "

The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see ResourceTag.

", "MonitorArnList$member": null, "ResourceNotFoundException$ResourceName": null, "TagResourceRequest$ResourceArn": "

The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see ResourceTag.

", "TooManyTagsException$ResourceName": null, - "UntagResourceRequest$ResourceArn": "

The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see ResourceTag.

", + "UntagResourceRequest$ResourceArn": "

The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see ResourceTag.

", "UpdateCostCategoryDefinitionRequest$CostCategoryArn": "

The unique identifier for your Cost Category.

", - "UpdateCostCategoryDefinitionResponse$CostCategoryArn": "

The unique identifier for your Cost Category.

" + "UpdateCostCategoryDefinitionResponse$CostCategoryArn": "

The unique identifier for your Cost Category.

" } }, "AttributeType": { @@ -172,7 +174,58 @@ "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:

" + } + }, + "CostAllocationTag": { + "base": "

The cost allocation tag structure. This includes detailed metadata for the CostAllocationTag object.

", + "refs": { + "CostAllocationTagList$member": null + } + }, + "CostAllocationTagKeyList": { + "base": null, + "refs": { + "ListCostAllocationTagsRequest$TagKeys": "

The list of cost allocation tag keys that are returned for this request.

" + } + }, + "CostAllocationTagList": { + "base": null, + "refs": { + "ListCostAllocationTagsResponse$CostAllocationTags": "

A list of cost allocation tags that includes the detailed metadata for each one.

" + } + }, + "CostAllocationTagStatus": { + "base": null, + "refs": { + "CostAllocationTag$Status": "

The status of a cost allocation tag.

", + "CostAllocationTagStatusEntry$Status": "

The status of a cost allocation tag.

", + "ListCostAllocationTagsRequest$Status": "

The status of cost allocation tag keys that are returned for this request.

" + } + }, + "CostAllocationTagStatusEntry": { + "base": "

The cost allocation tag status. The status of a key can either be active or inactive.

", + "refs": { + "CostAllocationTagStatusList$member": null + } + }, + "CostAllocationTagStatusList": { + "base": null, + "refs": { + "UpdateCostAllocationTagsStatusRequest$CostAllocationTagsStatus": "

The list of CostAllocationTagStatusEntry objects that are used to update cost allocation tags status for this request.

" + } + }, + "CostAllocationTagType": { + "base": null, + "refs": { + "CostAllocationTag$Type": "

The type of cost allocation tag. You can use AWSGenerated or UserDefined type tags. AWSGenerated type tags are tags that Amazon Web Services defines and applies to support Amazon Web Services resources for cost allocation purposes. UserDefined type tags are tags that you define, create, and apply to resources.

", + "ListCostAllocationTagsRequest$Type": "

The type of CostAllocationTag object that are returned for this request. The AWSGenerated type tags are tags that Amazon Web Services defines and applies to support Amazon Web Services resources for cost allocation purposes. The UserDefined type tags are tags that you define, create, and apply to resources.

" + } + }, + "CostAllocationTagsMaxResults": { + "base": null, + "refs": { + "ListCostAllocationTagsRequest$MaxResults": "

The maximum number of objects that are returned for this request. By default, the request returns 100 results.

" } }, "CostCategory": { @@ -182,7 +235,7 @@ } }, "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 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.

", + "base": "

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

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

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

" } @@ -190,13 +243,13 @@ "CostCategoryInheritedValueDimensionName": { "base": null, "refs": { - "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.

" + "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 is based on the value of the specified tag key.

" } }, "CostCategoryMaxResults": { "base": null, "refs": { - "ListCostCategoryDefinitionsRequest$MaxResults": "

The number of entries a paginated response contains.

" + "ListCostCategoryDefinitionsRequest$MaxResults": "

The number of entries a paginated response contains.

" } }, "CostCategoryName": { @@ -238,7 +291,7 @@ "CostCategoryReferencesList": { "base": null, "refs": { - "ListCostCategoryDefinitionsResponse$CostCategoryReferences": "

A reference to a Cost Category containing enough information to identify the Cost Category.

" + "ListCostCategoryDefinitionsResponse$CostCategoryReferences": "

A reference to a Cost Category that contains enough information to identify the Cost Category.

" } }, "CostCategoryRule": { @@ -250,7 +303,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 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.

" + "CostCategoryRule$Type": "

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

" } }, "CostCategoryRuleVersion": { @@ -352,7 +405,7 @@ "base": null, "refs": { "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.

" + "GetCostCategoriesResponse$CostCategoryValues": "

The Cost Category values.

If the CostCategoryName key isn't specified in the request, the CostCategoryValues fields aren't returned.

" } }, "Coverage": { @@ -457,13 +510,13 @@ "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 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.

", + "GetReservationUtilizationRequest$TimePeriod": "

Sets the start and end dates for retrieving Reserved Instance (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.

", "GetSavingsPlansUtilizationDetailsRequest$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.

", "GetSavingsPlansUtilizationDetailsResponse$TimePeriod": null, "GetSavingsPlansUtilizationRequest$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.

", "GetTagsRequest$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.

", - "GetUsageForecastRequest$TimePeriod": "

The start and end dates of the period that you want to retrieve usage forecast for. 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 must be equal to or later than the current date to avoid a validation error.

", + "GetUsageForecastRequest$TimePeriod": "

The start and end dates of the period that you want to retrieve usage forecast for. The start date is included in the period, but the end date isn't included in the period. 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 must be equal to or later than the current date to avoid a validation error.

", "ResultByTime$TimePeriod": "

The time period that the result covers.

", "SavingsPlansCoverage$TimePeriod": null, "SavingsPlansUtilizationByTime$TimePeriod": null, @@ -538,9 +591,9 @@ } }, "DiskResourceUtilization": { - "base": "

The field that contains a list of disk (local storage) metrics that are 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 that are 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": { @@ -558,11 +611,11 @@ "EC2ResourceDetails": { "base": "

Details on the Amazon EC2 Resource.

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

Details on the Amazon EC2 resource.

" + "ResourceDetails$EC2ResourceDetails": "

Details for the Amazon EC2 resource.

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

Utilization metrics of the instance.

", + "base": "

Utilization metrics for the instance.

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

The utilization of current Amazon EC2 instance.

" } @@ -604,7 +657,8 @@ "TooManyTagsException$Message": null, "UnknownMonitorException$Message": null, "UnknownSubscriptionException$Message": null, - "UnresolvableUsageUnitException$Message": null + "UnresolvableUsageUnitException$Message": null, + "UpdateCostAllocationTagsStatusError$Message": "

A message explaining why the action failed on this entry.

" } }, "Estimated": { @@ -630,7 +684,7 @@ "GetReservationUtilizationRequest$Filter": "

Filters utilization data by dimensions. You can filter by the following dimensions:

GetReservationUtilization uses the same Expression object as the other operations, but only AND is supported among each dimension, and nesting is supported up to only one level deep. If there are multiple values for a dimension, they are OR'd together.

", "GetRightsizingRecommendationRequest$Filter": null, "GetSavingsPlansCoverageRequest$Filter": "

Filters Savings Plans coverage data by dimensions. You can filter data for Savings Plans usage with the following dimensions:

GetSavingsPlansCoverage uses the same Expression object as the other operations, but only AND is supported among each dimension. If there are multiple values for a dimension, they are OR'd together.

Cost category is also supported.

", - "GetSavingsPlansPurchaseRecommendationRequest$Filter": "

You can filter your recommendations by Account ID with the LINKED_ACCOUNT dimension. To filter your recommendations by Account ID, specify Key as LINKED_ACCOUNT and Value as the comma-separated Acount ID(s) for which you want to see Savings Plans purchase recommendations.

For GetSavingsPlansPurchaseRecommendation, the Filter does not include CostCategories or Tags. It only includes Dimensions. With Dimensions, Key must be LINKED_ACCOUNT and Value can be a single Account ID or multiple comma-separated Account IDs for which you want to see Savings Plans Purchase Recommendations. AND and OR operators are not supported.

", + "GetSavingsPlansPurchaseRecommendationRequest$Filter": "

You can filter your recommendations by Account ID with the LINKED_ACCOUNT dimension. To filter your recommendations by Account ID, specify Key as LINKED_ACCOUNT and Value as the comma-separated Acount ID(s) that you want to see Savings Plans purchase recommendations for.

For GetSavingsPlansPurchaseRecommendation, the Filter doesn't include CostCategories or Tags. It only includes Dimensions. With Dimensions, Key must be LINKED_ACCOUNT and Value can be a single Account ID or multiple comma-separated Account IDs that you want to see Savings Plans Purchase Recommendations for. AND and OR operators are not supported.

", "GetSavingsPlansUtilizationDetailsRequest$Filter": "

Filters Savings Plans utilization coverage data for active Savings Plans dimensions. You can filter data with the following dimensions:

GetSavingsPlansUtilizationDetails uses the same Expression object as the other operations, but only AND is supported among each dimension.

", "GetSavingsPlansUtilizationRequest$Filter": "

Filters Savings Plans utilization coverage data for active Savings Plans dimensions. You can filter data with the following dimensions:

GetSavingsPlansUtilization uses the same Expression object as the other operations, but only AND is supported among each dimension.

", "GetTagsRequest$Filter": null, @@ -653,7 +707,7 @@ "FindingReasonCodes": { "base": null, "refs": { - "RightsizingRecommendation$FindingReasonCodes": "

The list of possible reasons why the recommendation is generated such as under or over utilization of specific metrics (for example, CPU, Memory, Network).

" + "RightsizingRecommendation$FindingReasonCodes": "

The list of possible reasons why the recommendation is generated, such as under- or over-utilization of specific metrics (for example, CPU, Memory, Network).

" } }, "ForecastResult": { @@ -701,7 +755,7 @@ "base": null, "refs": { "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$DimensionValue": "

The dimension for the anomaly (for example, an Amazon Web 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.

", @@ -716,18 +770,18 @@ "CreateAnomalySubscriptionResponse$SubscriptionArn": "

The unique identifier of your newly created cost anomaly subscription.

", "CurrentInstance$ResourceId": "

Resource ID of the current instance.

", "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$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$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.

", + "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.

", + "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

", @@ -746,10 +800,10 @@ "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.

", + "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.

", @@ -762,13 +816,13 @@ "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.

", - "GetReservationPurchaseRecommendationRequest$AccountId": "

The account ID that is associated with the recommendation.

", + "GetReservationPurchaseRecommendationRequest$AccountId": "

The account ID that's 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 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.

", + "NetworkResourceUtilization$NetworkInBytesPerSecond": "

The network inbound throughput utilization measured in Bytes per second (Bps).

", + "NetworkResourceUtilization$NetworkOutBytesPerSecond": "

The network outbound throughput utilization measured in Bytes per second (Bps).

", + "NetworkResourceUtilization$NetworkPacketsInPerSecond": "

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

", + "NetworkResourceUtilization$NetworkPacketsOutPerSecond": "

The network outbound 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.

", @@ -781,7 +835,7 @@ "RedshiftInstanceDetails$Family": "

The instance family 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$AccountId": "

The account that this Reserved Instance (RI) recommendation is for.

", "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.

", @@ -793,10 +847,10 @@ "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$EstimatedMonthlySavingsAmount": "

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

", + "ReservationPurchaseRecommendationDetail$EstimatedMonthlySavingsPercentage": "

How much Amazon Web Services estimates that this specific recommendation might 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$EstimatedReservationCostForLookbackPeriod": "

How much Amazon Web Services estimates that you might spend 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.

", @@ -812,14 +866,14 @@ "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$Service": "

The Amazon Web 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 Amazon Web Services usage that is covered by a Savings Plans.

", + "SavingsPlansCoverageData$SpendCoveredBySavingsPlans": "

The amount of your Amazon Web Services usage that's 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).

", @@ -832,7 +886,7 @@ "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$EstimatedOnDemandCostWithCurrentCommitment": "

The estimated On-Demand costs you 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 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 the configuration that's based on the usage during the lookback period.

", @@ -842,7 +896,7 @@ "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$GenerationTimestamp": "

The timestamp that shows when the recommendations were generated.

", "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.

", @@ -854,7 +908,7 @@ "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 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.

", + "SavingsPlansPurchaseRecommendationSummary$EstimatedOnDemandCostWithCurrentCommitment": "

The estimated On-Demand costs you 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).

", @@ -871,7 +925,8 @@ "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.

" + "UpdateAnomalySubscriptionResponse$SubscriptionArn": "

A cost anomaly subscription ARN.

", + "UpdateCostAllocationTagsStatusError$Code": "

An error code representing why the action failed on this entry.

" } }, "GetAnomaliesRequest": { @@ -1143,6 +1198,16 @@ "refs": { } }, + "ListCostAllocationTagsRequest": { + "base": null, + "refs": { + } + }, + "ListCostAllocationTagsResponse": { + "base": null, + "refs": { + } + }, "ListCostCategoryDefinitionsRequest": { "base": null, "refs": { @@ -1167,10 +1232,10 @@ "base": null, "refs": { "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.

", + "GetSavingsPlansPurchaseRecommendationRequest$LookbackPeriodInDays": "

The lookback period that's used to generate the 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.

" + "SavingsPlansPurchaseRecommendation$LookbackPeriodInDays": "

The lookback period in days that's used to generate the recommendation.

" } }, "MatchOption": { @@ -1190,13 +1255,13 @@ "MaxResults": { "base": null, "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.

", + "GetCostCategoriesRequest$MaxResults": "

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

The maximum number of objects that are returned for this request. If MaxResults isn't specified with the SortBy value, the request returns 1000 results as the default value for this parameter.

For GetCostCategories, MaxResults has an upper quota of 1000.

", + "GetDimensionValuesRequest$MaxResults": "

This field is only used when SortBy is provided in the request. The maximum number of objects that are returned for this request. If MaxResults isn't specified with SortBy, the request returns 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, 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.

" + "GetTagsRequest$MaxResults": "

This field is only used when SortBy is provided in the request. The maximum number of objects that are returned for this request. If MaxResults isn't specified with SortBy, the request returns 1000 results as the default value for this parameter.

For GetTags, MaxResults has an upper quota of 1000.

" } }, "Metric": { @@ -1223,7 +1288,7 @@ "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 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.

", + "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, hour or 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.

" } @@ -1250,7 +1315,7 @@ } }, "ModifyRecommendationDetail": { - "base": "

Details on the modification recommendation.

", + "base": "

Details for the modification recommendation.

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

The details for the modification recommendations.

" } @@ -1281,9 +1346,9 @@ } }, "NetworkResourceUtilization": { - "base": "

The network field that contains a list of network metrics that are 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 that are 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": { @@ -1299,8 +1364,8 @@ "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.

", + "GetCostCategoriesRequest$NextPageToken": "

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

", + "GetCostCategoriesResponse$NextPageToken": "

If the number of objects that are still available for retrieval exceeds the quota, 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.

", @@ -1319,8 +1384,10 @@ "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. 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.

" + "ListCostAllocationTagsRequest$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.

", + "ListCostAllocationTagsResponse$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.

", + "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.

" } }, "NonNegativeInteger": { @@ -1382,7 +1449,7 @@ "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$ReturnSize": "

The number of objects that are returned.

", "GetCostCategoriesResponse$TotalSize": "

The total number of objects.

", "GetDimensionValuesResponse$ReturnSize": "

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

", "GetDimensionValuesResponse$TotalSize": "

The total number of search results.

", @@ -1394,9 +1461,9 @@ "base": null, "refs": { "GetReservationPurchaseRecommendationRequest$PaymentOption": "

The reservation purchase option that you want recommendations for.

", - "GetSavingsPlansPurchaseRecommendationRequest$PaymentOption": "

The payment option used to generate these recommendations.

", + "GetSavingsPlansPurchaseRecommendationRequest$PaymentOption": "

The payment option that's used to generate these recommendations.

", "ReservationPurchaseRecommendation$PaymentOption": "

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

", - "SavingsPlansPurchaseRecommendation$PaymentOption": "

The payment option used to generate the recommendation.

" + "SavingsPlansPurchaseRecommendation$PaymentOption": "

The payment option that's used to generate the recommendation.

" } }, "PlatformDifference": { @@ -1408,14 +1475,14 @@ "PlatformDifferences": { "base": null, "refs": { - "TargetInstance$PlatformDifferences": "

Explains the actions you might need to take in order to successfully migrate your workloads from the current instance type to the recommended instance type.

" + "TargetInstance$PlatformDifferences": "

Explains the actions that you might need to take to successfully migrate your workloads from the current instance type to the recommended instance type.

" } }, "PredictionIntervalLevel": { "base": null, "refs": { "GetCostForecastRequest$PredictionIntervalLevel": "

Cost Explorer always returns the mean forecast as a single point. You can request a prediction interval around the mean by specifying a confidence level. The higher the confidence level, the more confident Cost Explorer is about the actual value falling in the prediction interval. Higher confidence levels result in wider prediction intervals.

", - "GetUsageForecastRequest$PredictionIntervalLevel": "

Cost Explorer always returns the mean forecast as a single point. You can request a prediction interval around the mean by specifying a confidence level. The higher the confidence level, the more confident Cost Explorer is about the actual value falling in the prediction interval. Higher confidence levels result in wider prediction intervals.

" + "GetUsageForecastRequest$PredictionIntervalLevel": "

Amazon Web Services Cost Explorer always returns the mean forecast as a single point. You can request a prediction interval around the mean by specifying a confidence level. The higher the confidence level, the more confident Cost Explorer is about the actual value falling in the prediction interval. Higher confidence levels result in wider prediction intervals.

" } }, "ProvideAnomalyFeedbackRequest": { @@ -1478,7 +1545,7 @@ "ReservationAggregates": { "base": "

The aggregated numbers for your reservation usage.

", "refs": { - "GetReservationUtilizationResponse$Total": "

The total amount of time that you used your RIs.

", + "GetReservationUtilizationResponse$Total": "

The total amount of time that you used your Reserved Instances (RIs).

", "ReservationUtilizationGroup$Utilization": "

How much you used this group of reservations.

", "UtilizationByTime$Total": "

The total number of reservation hours that were used.

" } @@ -1568,7 +1635,7 @@ } }, "ResourceDetails": { - "base": "

Details on the resource.

", + "base": "

Details for the resource.

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

Details about the resource and utilization.

", "TargetInstance$ResourceDetails": "

Details on the target instance type.

" @@ -1580,7 +1647,7 @@ } }, "ResourceTag": { - "base": "

The tag structure that contains a tag key and value.

Tagging is supported only for the following Cost Explorer resource types: AnomalyMonitor , AnomalySubscription , CostCategory .

", + "base": "

The tag structure that contains a tag key and value.

Tagging is supported only for the following Cost Explorer resource types: AnomalyMonitor , AnomalySubscription , CostCategory .

", "refs": { "ResourceTagList$member": null } @@ -1588,30 +1655,30 @@ "ResourceTagKey": { "base": null, "refs": { - "ResourceTag$Key": "

The key that is associated with the tag.

", + "ResourceTag$Key": "

The key that's associated with the tag.

", "ResourceTagKeyList$member": null } }, "ResourceTagKeyList": { "base": null, "refs": { - "UntagResourceRequest$ResourceTagKeys": "

A list of tag keys associated with tags that need to be removed from the resource. If you specify a tag key that does not exist, it is ignored. Although the maximum number of array members is 200, user-tag maximum is 50. The remaining are reserved for Amazon Web Services use.

" + "UntagResourceRequest$ResourceTagKeys": "

A list of tag keys associated with tags that need to be removed from the resource. If you specify a tag key that doesn't exist, it's ignored. Although the maximum number of array members is 200, user-tag maximum is 50. The remaining are reserved for Amazon Web Services use.

" } }, "ResourceTagList": { "base": null, "refs": { - "CreateAnomalyMonitorRequest$ResourceTags": "

An optional list of tags to associate with the specified AnomalyMonitor . You can use resource tags to control access to your monitor using IAM policies.

Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

", - "CreateAnomalySubscriptionRequest$ResourceTags": "

An optional list of tags to associate with the specified AnomalySubscription . You can use resource tags to control access to your subscription using IAM policies.

Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

", - "CreateCostCategoryDefinitionRequest$ResourceTags": "

An optional list of tags to associate with the specified CostCategory . You can use resource tags to control access to your cost category using IAM policies.

Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

", - "ListTagsForResourceResponse$ResourceTags": "

A list of tag key value pairs that are associated with the response.

", - "TagResourceRequest$ResourceTags": "

A list of tag key-value pairs to be added to the resource.

Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

" + "CreateAnomalyMonitorRequest$ResourceTags": "

An optional list of tags to associate with the specified AnomalyMonitor . You can use resource tags to control access to your monitor using IAM policies.

Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

", + "CreateAnomalySubscriptionRequest$ResourceTags": "

An optional list of tags to associate with the specified AnomalySubscription . You can use resource tags to control access to your subscription using IAM policies.

Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

", + "CreateCostCategoryDefinitionRequest$ResourceTags": "

An optional list of tags to associate with the specified CostCategory . You can use resource tags to control access to your cost category using IAM policies.

Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

", + "ListTagsForResourceResponse$ResourceTags": "

A list of tag key value pairs that are associated with the resource.

", + "TagResourceRequest$ResourceTags": "

A list of tag key-value pairs to be added to the resource.

Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:

" } }, "ResourceTagValue": { "base": null, "refs": { - "ResourceTag$Value": "

The value that is associated with the tag.

" + "ResourceTag$Value": "

The value that's associated with the tag.

" } }, "ResourceUtilization": { @@ -1631,7 +1698,7 @@ "base": null, "refs": { "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.

" + "GetCostAndUsageWithResourcesResponse$ResultsByTime": "

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

" } }, "RightsizingRecommendation": { @@ -1641,10 +1708,10 @@ } }, "RightsizingRecommendationConfiguration": { - "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.

", + "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 Reserved Instance (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.

" + "GetRightsizingRecommendationRequest$Configuration": "

You can use Configuration 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.

", + "GetRightsizingRecommendationResponse$Configuration": "

You can use Configuration 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.

" } }, "RightsizingRecommendationList": { @@ -1672,7 +1739,7 @@ } }, "RootCause": { - "base": "

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

", + "base": "

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

", "refs": { "RootCauses$member": null } @@ -1698,7 +1765,7 @@ } }, "SavingsPlansCoverage": { - "base": "

The amount of Savings Plans eligible usage that is covered by Savings Plans. All calculations consider the On-Demand equivalent of your Savings Plans usage.

", + "base": "

The amount of Savings Plans eligible usage that's covered by Savings Plans. All calculations consider the On-Demand equivalent of your Savings Plans usage.

", "refs": { "SavingsPlansCoverages$member": null } @@ -1748,13 +1815,13 @@ "SavingsPlansPurchaseRecommendationDetailList": { "base": null, "refs": { - "SavingsPlansPurchaseRecommendation$SavingsPlansPurchaseRecommendationDetails": "

Details for the Savings Plans we recommend that you purchase to cover existing Savings Plans eligible workloads.

" + "SavingsPlansPurchaseRecommendation$SavingsPlansPurchaseRecommendationDetails": "

Details for the Savings Plans that we recommend that you purchase to cover existing Savings Plans eligible workloads.

" } }, "SavingsPlansPurchaseRecommendationMetadata": { "base": "

Metadata about your Savings Plans Purchase Recommendations.

", "refs": { - "GetSavingsPlansPurchaseRecommendationResponse$Metadata": "

Information regarding this specific recommendation set.

" + "GetSavingsPlansPurchaseRecommendationResponse$Metadata": "

Information that regards this specific recommendation set.

" } }, "SavingsPlansPurchaseRecommendationSummary": { @@ -1766,9 +1833,9 @@ "SavingsPlansSavings": { "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.

", - "SavingsPlansUtilizationDetail$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.

" + "SavingsPlansUtilizationAggregates$Savings": "

The amount that's saved by using existing Savings Plans. Savings returns both net savings from Savings Plans and also the onDemandCostEquivalent of the Savings Plans when considering the utilization rate.

", + "SavingsPlansUtilizationByTime$Savings": "

The amount that's saved by using existing Savings Plans. Savings returns both net savings from Savings Plans and also the onDemandCostEquivalent of the Savings Plans when considering the utilization rate.

", + "SavingsPlansUtilizationDetail$Savings": "

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

" } }, "SavingsPlansUtilization": { @@ -1787,13 +1854,13 @@ } }, "SavingsPlansUtilizationByTime": { - "base": "

The amount of Savings Plans utilization, in hours.

", + "base": "

The amount of Savings Plans utilization (in hours).

", "refs": { "SavingsPlansUtilizationsByTime$member": null } }, "SavingsPlansUtilizationDetail": { - "base": "

A single daily or monthly Savings Plans utilization rate, and details for your account. A management account in an organization have access to member accounts. You can use GetDimensionValues to determine the possible dimension values.

", + "base": "

A single daily or monthly Savings Plans utilization rate and details for your account. A management account in an organization have access to member accounts. You can use GetDimensionValues to determine the possible dimension values.

", "refs": { "SavingsPlansUtilizationDetails$member": null } @@ -1807,13 +1874,13 @@ "SavingsPlansUtilizationsByTime": { "base": null, "refs": { - "GetSavingsPlansUtilizationResponse$SavingsPlansUtilizationsByTime": "

The amount of cost/commitment you used your Savings Plans. This allows you to specify date ranges.

" + "GetSavingsPlansUtilizationResponse$SavingsPlansUtilizationsByTime": "

The amount of cost/commitment that you used your Savings Plans. You can use it to specify date ranges.

" } }, "SearchString": { "base": null, "refs": { - "GetCostCategoriesRequest$SearchString": "

The value that you want to search the filter values for.

If you do not specify a CostCategoryName, SearchString will be used to filter Cost Category names that match the SearchString pattern. If you do specifiy a CostCategoryName, SearchString will be used to filter Cost Category values that match the SearchString pattern.

", + "GetCostCategoriesRequest$SearchString": "

The value that you want to search the filter values for.

If you don't specify a CostCategoryName, SearchString is used to filter Cost Category names that match the SearchString pattern. If you specify a CostCategoryName, SearchString is used to filter Cost Category values that match the SearchString pattern.

", "GetDimensionValuesRequest$SearchString": "

The value that you want to search the filter values for.

", "GetTagsRequest$SearchString": "

The value that you want to search for.

" } @@ -1831,13 +1898,13 @@ } }, "SortDefinition": { - "base": "

The details of how to sort the data.

", + "base": "

The details for how to sort the data.

", "refs": { "GetReservationCoverageRequest$SortBy": "

The value by which you want to sort the data.

The following values are supported for Key:

Supported values for SortOrder are ASCENDING or DESCENDING.

", - "GetReservationUtilizationRequest$SortBy": "

The value by which you want to sort the data.

The following values are supported for Key:

Supported values for SortOrder are ASCENDING or DESCENDING.

", - "GetSavingsPlansCoverageRequest$SortBy": "

The value by which you want to sort the data.

The following values are supported for Key:

Supported values for SortOrder are ASCENDING or DESCENDING.

", - "GetSavingsPlansUtilizationDetailsRequest$SortBy": "

The value by which you want to sort the data.

The following values are supported for Key:

Supported values for SortOrder are ASCENDING or DESCENDING.

", - "GetSavingsPlansUtilizationRequest$SortBy": "

The value by which you want to sort the data.

The following values are supported for Key:

Supported values for SortOrder are ASCENDING or DESCENDING.

", + "GetReservationUtilizationRequest$SortBy": "

The value that you want to sort the data by.

The following values are supported for Key:

The supported values for SortOrder are ASCENDING and DESCENDING.

", + "GetSavingsPlansCoverageRequest$SortBy": "

The value that you want to sort the data by.

The following values are supported for Key:

The supported values for SortOrder are ASCENDING and DESCENDING.

", + "GetSavingsPlansUtilizationDetailsRequest$SortBy": "

The value that you want to sort the data by.

The following values are supported for Key:

The supported values for SortOrder are ASCENDING and DESCENDING.

", + "GetSavingsPlansUtilizationRequest$SortBy": "

The value that you want to sort the data by.

The following values are supported for Key:

The supported values for SortOrder are ASCENDING and DESCENDING.

", "SortDefinitions$member": null } }, @@ -1850,9 +1917,9 @@ "SortDefinitions": { "base": null, "refs": { - "GetCostCategoriesRequest$SortBy": "

The value by which you want to sort the data.

The key represents cost and usage metrics. The following values are supported:

Supported values for SortOrder are ASCENDING or DESCENDING.

When using SortBy, NextPageToken and SearchString are not supported.

", - "GetDimensionValuesRequest$SortBy": "

The value by which you want to sort the data.

The key represents cost and usage metrics. The following values are supported:

Supported values for SortOrder are ASCENDING or DESCENDING.

When you specify a SortBy paramater, the context must be COST_AND_USAGE. Further, when using SortBy, NextPageToken and SearchString are not supported.

", - "GetTagsRequest$SortBy": "

The value by which you want to sort the data.

The key represents cost and usage metrics. The following values are supported:

Supported values for SortOrder are ASCENDING or DESCENDING.

When using SortBy, NextPageToken and SearchString are not supported.

" + "GetCostCategoriesRequest$SortBy": "

The value that you sort the data by.

The key represents the cost and usage metrics. The following values are supported:

The supported key values for the SortOrder value are ASCENDING and DESCENDING.

When you use the SortBy value, the NextPageToken and SearchString key values aren't supported.

", + "GetDimensionValuesRequest$SortBy": "

The value that you want to sort the data by.

The key represents cost and usage metrics. The following values are supported:

The supported values for the SortOrder key are ASCENDING or DESCENDING.

When you specify a SortBy paramater, the context must be COST_AND_USAGE. Further, when using SortBy, NextPageToken and SearchString aren't supported.

", + "GetTagsRequest$SortBy": "

The value that you want to sort the data by.

The key represents cost and usage metrics. The following values are supported:

The supported values for SortOrder are ASCENDING and DESCENDING.

When you use SortBy, NextPageToken and SearchString aren't supported.

" } }, "SortOrder": { @@ -1895,15 +1962,19 @@ "SupportedSavingsPlansType": { "base": null, "refs": { - "GetSavingsPlansPurchaseRecommendationRequest$SavingsPlansType": "

The Savings Plans recommendation type requested.

", + "GetSavingsPlansPurchaseRecommendationRequest$SavingsPlansType": "

The Savings Plans recommendation type that's requested.

", "SavingsPlansPurchaseRecommendation$SavingsPlansType": "

The requested Savings Plans recommendation type.

" } }, "TagKey": { "base": null, "refs": { + "CostAllocationTag$TagKey": "

The key for the cost allocation tag.

", + "CostAllocationTagKeyList$member": null, + "CostAllocationTagStatusEntry$TagKey": "

The key for the cost allocation tag.

", "GetTagsRequest$TagKey": "

The key of the tag that you want to return values for.

", - "TagValues$Key": "

The key for the tag.

" + "TagValues$Key": "

The key for the tag.

", + "UpdateCostAllocationTagsStatusError$TagKey": "

The key for the cost allocation tag.

" } }, "TagList": { @@ -1951,7 +2022,7 @@ "base": null, "refs": { "GetReservationPurchaseRecommendationRequest$TermInYears": "

The reservation term that you want recommendations for.

", - "GetSavingsPlansPurchaseRecommendationRequest$TermInYears": "

The savings plan recommendation term used to generate these recommendations.

", + "GetSavingsPlansPurchaseRecommendationRequest$TermInYears": "

The savings plan recommendation term that's 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. It's used to generate the recommendation.

" } @@ -2072,6 +2143,28 @@ "refs": { } }, + "UpdateCostAllocationTagsStatusError": { + "base": "

Gives a detailed description of the result of an action. It's on each cost allocation tag entry in the request.

", + "refs": { + "UpdateCostAllocationTagsStatusErrors$member": null + } + }, + "UpdateCostAllocationTagsStatusErrors": { + "base": null, + "refs": { + "UpdateCostAllocationTagsStatusResponse$Errors": "

A list of UpdateCostAllocationTagsStatusError objects with error details about each cost allocation tag that can't be updated. If there's no failure, an empty array returns.

" + } + }, + "UpdateCostAllocationTagsStatusRequest": { + "base": null, + "refs": { + } + }, + "UpdateCostAllocationTagsStatusResponse": { + "base": null, + "refs": { + } + }, "UpdateCostCategoryDefinitionRequest": { "base": null, "refs": { @@ -2103,7 +2196,7 @@ "UtilizationsByTime": { "base": null, "refs": { - "GetReservationUtilizationResponse$UtilizationsByTime": "

The amount of time that you used your RIs.

" + "GetReservationUtilizationResponse$UtilizationsByTime": "

The amount of time that you used your Reserved Instances (RIs).

" } }, "Value": { @@ -2138,17 +2231,17 @@ } }, "ZonedDateTime": { - "base": "

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

", + "base": "

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

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

The effective state data of your Cost Category.

", - "CostCategory$EffectiveEnd": "

The effective end 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.

", - "ListCostCategoryDefinitionsRequest$EffectiveOn": "

The date when the Cost Category was effective.

", - "UpdateCostCategoryDefinitionResponse$EffectiveStart": "

The Cost Category's effective start 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 is categorized by the deleted Cost Category.

", + "DescribeCostCategoryDefinitionRequest$EffectiveOn": "

The date when the Cost Category was effective.

", + "ListCostCategoryDefinitionsRequest$EffectiveOn": "

The date when the Cost Category was effective.

", + "UpdateCostCategoryDefinitionResponse$EffectiveStart": "

The Cost Category's effective start date.

" } } } diff --git a/apis/ce/2017-10-25/paginators-1.json b/apis/ce/2017-10-25/paginators-1.json index 431b8e5dc52..1b58ad8f0e2 100644 --- a/apis/ce/2017-10-25/paginators-1.json +++ b/apis/ce/2017-10-25/paginators-1.json @@ -10,6 +10,11 @@ "output_token": "NextToken", "limit_key": "MaxResults" }, + "ListCostAllocationTags": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults" + }, "ListCostCategoryDefinitions": { "input_token": "NextToken", "output_token": "NextToken", diff --git a/gems/aws-partitions/CHANGELOG.md b/gems/aws-partitions/CHANGELOG.md index 531617382c5..e48950bc7e3 100644 --- a/gems/aws-partitions/CHANGELOG.md +++ b/gems/aws-partitions/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.597.0 (2022-06-07) +------------------ + +* Feature - Updated the partitions source data the determines the AWS service regions and endpoints. + 1.596.0 (2022-06-06) ------------------ diff --git a/gems/aws-partitions/VERSION b/gems/aws-partitions/VERSION index 7f1b0a69948..defed83234d 100644 --- a/gems/aws-partitions/VERSION +++ b/gems/aws-partitions/VERSION @@ -1 +1 @@ -1.596.0 +1.597.0 diff --git a/gems/aws-partitions/partitions.json b/gems/aws-partitions/partitions.json index 70f5b1c2872..5c211e04521 100644 --- a/gems/aws-partitions/partitions.json +++ b/gems/aws-partitions/partitions.json @@ -1797,6 +1797,11 @@ "isRegionalized" : false, "partitionEndpoint" : "aws-global" }, + "catalog.marketplace" : { + "endpoints" : { + "us-east-1" : { } + } + }, "ce" : { "endpoints" : { "aws-global" : { diff --git a/gems/aws-sdk-auditmanager/CHANGELOG.md b/gems/aws-sdk-auditmanager/CHANGELOG.md index b6dd21582a8..0bcb6cb7a5b 100644 --- a/gems/aws-sdk-auditmanager/CHANGELOG.md +++ b/gems/aws-sdk-auditmanager/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.25.0 (2022-06-07) +------------------ + +* Feature - This release introduces 2 updates to the Audit Manager API. The roleType and roleArn attributes are now required when you use the CreateAssessment or UpdateAssessment operation. We also added a throttling exception to the RegisterAccount API operation. + 1.24.0 (2022-04-28) ------------------ diff --git a/gems/aws-sdk-auditmanager/VERSION b/gems/aws-sdk-auditmanager/VERSION index 53cc1a6f929..ad2191947f7 100644 --- a/gems/aws-sdk-auditmanager/VERSION +++ b/gems/aws-sdk-auditmanager/VERSION @@ -1 +1 @@ -1.24.0 +1.25.0 diff --git a/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager.rb b/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager.rb index 0141ace4788..1c6219f9b96 100644 --- a/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager.rb +++ b/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager.rb @@ -48,6 +48,6 @@ # @!group service module Aws::AuditManager - GEM_VERSION = '1.24.0' + GEM_VERSION = '1.25.0' end diff --git a/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/client.rb b/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/client.rb index a2f13c4f50a..d01a0d60021 100644 --- a/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/client.rb +++ b/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/client.rb @@ -660,8 +660,8 @@ def batch_import_evidence_to_assessment_control(params = {}, options = {}) # }, # roles: [ # required # { - # role_type: "PROCESS_OWNER", # accepts PROCESS_OWNER, RESOURCE_OWNER - # role_arn: "IamArn", + # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER + # role_arn: "IamArn", # required # }, # ], # framework_id: "UUID", # required @@ -2067,8 +2067,8 @@ def get_organization_admin_account(params = {}, options = {}) req.send_request(options) end - # Returns a list of the in-scope Amazon Web Services services for the - # specified assessment. + # Returns a list of the in-scope Amazon Web Services for the specified + # assessment. # # @return [Types::GetServicesInScopeResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -2804,6 +2804,32 @@ def register_organization_admin_account(params = {}, options = {}) # custom framework is available. Recipients have 120 days to accept or # decline the request. If no action is taken, the share request expires. # + # When you create a share request, Audit Manager stores a snapshot of + # your custom framework in the US East (N. Virginia) Amazon Web Services + # Region. Audit Manager also stores a backup of the same snapshot in the + # US West (Oregon) Amazon Web Services Region. + # + # Audit Manager deletes the snapshot and the backup snapshot when one of + # the following events occurs: + # + # * The sender revokes the share request. + # + # * The recipient declines the share request. + # + # * The recipient encounters an error and doesn't successfully accept + # the share request. + # + # * The share request expires before the recipient responds to the + # request. + # + # When a sender [resends a share request][1], the snapshot is replaced + # with an updated version that corresponds with the latest version of + # the custom framework. + # + # When a recipient accepts a share request, the snapshot is replicated + # into their Amazon Web Services account under the Amazon Web Services + # Region that was specified in the share request. + # # When you invoke the `StartAssessmentFrameworkShare` API, you are about # to share a custom framework with another Amazon Web Services account. # You may not share a custom framework that is derived from a standard @@ -2811,11 +2837,12 @@ def register_organization_admin_account(params = {}, options = {}) # sharing by Amazon Web Services, unless you have obtained permission to # do so from the owner of the standard framework. To learn more about # which standard frameworks are eligible for sharing, see [Framework - # sharing eligibility][1] in the *Audit Manager User Guide*. + # sharing eligibility][2] in the *Audit Manager User Guide*. # # # - # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/share-custom-framework-concepts-and-terminology.html#eligibility + # [1]: https://docs.aws.amazon.com/audit-manager/latest/userguide/framework-sharing.html#framework-sharing-resend + # [2]: https://docs.aws.amazon.com/audit-manager/latest/userguide/share-custom-framework-concepts-and-terminology.html#eligibility # # @option params [required, String] :framework_id # The unique identifier for the custom framework to be shared. @@ -2974,8 +3001,8 @@ def untag_resource(params = {}, options = {}) # }, # roles: [ # { - # role_type: "PROCESS_OWNER", # accepts PROCESS_OWNER, RESOURCE_OWNER - # role_arn: "IamArn", + # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER + # role_arn: "IamArn", # required # }, # ], # }) @@ -3573,8 +3600,8 @@ def update_control(params = {}, options = {}) # }, # default_process_owners: [ # { - # role_type: "PROCESS_OWNER", # accepts PROCESS_OWNER, RESOURCE_OWNER - # role_arn: "IamArn", + # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER + # role_arn: "IamArn", # required # }, # ], # kms_key: "KmsKey", @@ -3651,7 +3678,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-auditmanager' - context[:gem_version] = '1.24.0' + context[:gem_version] = '1.25.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/client_api.rb b/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/client_api.rb index dfe038787ef..9b3439f9e3e 100644 --- a/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/client_api.rb +++ b/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/client_api.rb @@ -281,6 +281,7 @@ module ClientApi TagResourceResponse = Shapes::StructureShape.new(name: 'TagResourceResponse') TagValue = Shapes::StringShape.new(name: 'TagValue') TestingInformation = Shapes::StringShape.new(name: 'TestingInformation') + ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException') Timestamp = Shapes::TimestampShape.new(name: 'Timestamp') TimestampUUID = Shapes::StringShape.new(name: 'TimestampUUID') Token = Shapes::StringShape.new(name: 'Token') @@ -1135,8 +1136,8 @@ module ClientApi Resources.member = Shapes::ShapeRef.new(shape: Resource) - Role.add_member(:role_type, Shapes::ShapeRef.new(shape: RoleType, location_name: "roleType")) - Role.add_member(:role_arn, Shapes::ShapeRef.new(shape: IamArn, location_name: "roleArn")) + Role.add_member(:role_type, Shapes::ShapeRef.new(shape: RoleType, required: true, location_name: "roleType")) + Role.add_member(:role_arn, Shapes::ShapeRef.new(shape: IamArn, required: true, location_name: "roleArn")) Role.struct_class = Types::Role Roles.member = Shapes::ShapeRef.new(shape: Role) @@ -1184,6 +1185,9 @@ module ClientApi TagResourceResponse.struct_class = Types::TagResourceResponse + ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message")) + ThrottlingException.struct_class = Types::ThrottlingException + URL.add_member(:hyperlink_name, Shapes::ShapeRef.new(shape: HyperlinkName, location_name: "hyperlinkName")) URL.add_member(:link, Shapes::ShapeRef.new(shape: UrlLink, location_name: "link")) URL.struct_class = Types::URL @@ -1971,6 +1975,7 @@ module ClientApi o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) o.errors << Shapes::ShapeRef.new(shape: InternalServerException) o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) end) api.add_operation(:register_organization_admin_account, Seahorse::Model::Operation.new.tap do |o| diff --git a/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/errors.rb b/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/errors.rb index aa7b1fc04dd..d401c1fabc6 100644 --- a/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/errors.rb +++ b/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/errors.rb @@ -30,6 +30,7 @@ module Aws::AuditManager # * {AccessDeniedException} # * {InternalServerException} # * {ResourceNotFoundException} + # * {ThrottlingException} # * {ValidationException} # # Additionally, error classes are dynamically generated for service errors based on the error code @@ -93,6 +94,21 @@ def resource_type end end + class ThrottlingException < ServiceError + + # @param [Seahorse::Client::RequestContext] context + # @param [String] message + # @param [Aws::AuditManager::Types::ThrottlingException] data + def initialize(context, message, data = Aws::EmptyStructure.new) + super(context, message, data) + end + + # @return [String] + def message + @message || @data[:message] + end + end + class ValidationException < ServiceError # @param [Seahorse::Client::RequestContext] context diff --git a/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/types.rb b/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/types.rb index cb6a086ff12..3262ad2ae6e 100644 --- a/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/types.rb +++ b/gems/aws-sdk-auditmanager/lib/aws-sdk-auditmanager/types.rb @@ -278,8 +278,7 @@ class AssessmentControlSet < Struct.new( # @!attribute [rw] evidence_by_type_configuration_data_count # The number of evidence that falls under the configuration data # category. This evidence is collected from configuration snapshots of - # other Amazon Web Services services such as Amazon EC2, Amazon S3, or - # IAM. + # other Amazon Web Services such as Amazon EC2, Amazon S3, or IAM. # @return [Integer] # # @!attribute [rw] evidence_by_type_manual_count @@ -1747,8 +1746,8 @@ class CreateAssessmentReportResponse < Struct.new( # }, # roles: [ # required # { - # role_type: "PROCESS_OWNER", # accepts PROCESS_OWNER, RESOURCE_OWNER - # role_arn: "IamArn", + # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER + # role_arn: "IamArn", # required # }, # ], # framework_id: "UUID", # required @@ -4174,8 +4173,8 @@ class ResourceNotFoundException < Struct.new( # data as a hash: # # { - # role_type: "PROCESS_OWNER", # accepts PROCESS_OWNER, RESOURCE_OWNER - # role_arn: "IamArn", + # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER + # role_arn: "IamArn", # required # } # # @!attribute [rw] role_type @@ -4468,6 +4467,19 @@ class TagResourceRequest < Struct.new( # class TagResourceResponse < Aws::EmptyStructure; end + # The request was denied due to request throttling. + # + # @!attribute [rw] message + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/ThrottlingException AWS API Documentation + # + class ThrottlingException < Struct.new( + :message) + SENSITIVE = [] + include Aws::Structure + end + # Short for uniform resource locator. A URL is used as a unique # identifier to locate a resource on the internet. # @@ -4799,8 +4811,8 @@ class UpdateAssessmentFrameworkShareResponse < Struct.new( # }, # roles: [ # { - # role_type: "PROCESS_OWNER", # accepts PROCESS_OWNER, RESOURCE_OWNER - # role_arn: "IamArn", + # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER + # role_arn: "IamArn", # required # }, # ], # } @@ -4988,8 +5000,8 @@ class UpdateControlResponse < Struct.new( # }, # default_process_owners: [ # { - # role_type: "PROCESS_OWNER", # accepts PROCESS_OWNER, RESOURCE_OWNER - # role_arn: "IamArn", + # role_type: "PROCESS_OWNER", # required, accepts PROCESS_OWNER, RESOURCE_OWNER + # role_arn: "IamArn", # required # }, # ], # kms_key: "KmsKey", diff --git a/gems/aws-sdk-costexplorer/CHANGELOG.md b/gems/aws-sdk-costexplorer/CHANGELOG.md index 677ba5429c3..4769935454d 100644 --- a/gems/aws-sdk-costexplorer/CHANGELOG.md +++ b/gems/aws-sdk-costexplorer/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.77.0 (2022-06-07) +------------------ + +* Feature - Added two new APIs to support cost allocation tags operations: ListCostAllocationTags, UpdateCostAllocationTagsStatus. + 1.76.0 (2022-03-22) ------------------ diff --git a/gems/aws-sdk-costexplorer/VERSION b/gems/aws-sdk-costexplorer/VERSION index 32a6ce3c719..79e15fd4937 100644 --- a/gems/aws-sdk-costexplorer/VERSION +++ b/gems/aws-sdk-costexplorer/VERSION @@ -1 +1 @@ -1.76.0 +1.77.0 diff --git a/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer.rb b/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer.rb index 22b0fd80965..156d305207a 100644 --- a/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer.rb +++ b/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer.rb @@ -48,6 +48,6 @@ # @!group service module Aws::CostExplorer - GEM_VERSION = '1.76.0' + GEM_VERSION = '1.77.0' end diff --git a/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/client.rb b/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/client.rb index 8eee4655c2b..5f19dcb3e1d 100644 --- a/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/client.rb +++ b/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/client.rb @@ -370,7 +370,7 @@ def initialize(*args) # @option params [Array] :resource_tags # An optional list of tags to associate with the specified [ # `AnomalyMonitor` ][1]. You can use resource tags to control access to - # your monitor using IAM policies. + # your `monitor` using IAM policies. # # Each tag consists of a key and a value, and each key must be unique # for the resource. The following restrictions apply to resource tags: @@ -383,8 +383,8 @@ def initialize(*args) # # * The maximum length of a value is 256 characters # - # * Valid characters for keys and values are: `A-Z`, `a-z`, spaces, - # `_.:/=+-` + # * Keys and values can only contain alphanumeric characters, spaces, + # and any of the following: `_.:/=+@-` # # * Keys and values are case sensitive # @@ -489,8 +489,8 @@ def create_anomaly_monitor(params = {}, options = {}) # # * The maximum length of a value is 256 characters # - # * Valid characters for keys and values are: `A-Z`, `a-z`, spaces, - # `_.:/=+-` + # * Keys and values can only contain alphanumeric characters, spaces, + # and any of the following: `_.:/=+@-` # # * Keys and values are case sensitive # @@ -585,8 +585,8 @@ def create_anomaly_subscription(params = {}, options = {}) # # * The maximum length of a value is 256 characters # - # * Valid characters for keys and values are: `A-Z`, `a-z`, spaces, - # `_.:/=+-` + # * Keys and values can only contain alphanumeric characters, spaces, + # and any of the following: `_.:/=+@-` # # * Keys and values are case sensitive # @@ -762,12 +762,12 @@ def delete_cost_category_definition(params = {}, options = {}) req.send_request(options) end - # Returns the name, ARN, rules, definition, and effective dates of a - # Cost Category that's defined in the account. + # Returns the name, Amazon Resource 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 + # that's active on a specific date. If there's no `EffectiveOn` + # specified, you see a Cost Category that's effective on the current # date. If Cost Category is still effective, `EffectiveEnd` is omitted # in the response. # @@ -1239,7 +1239,7 @@ def get_cost_and_usage(params = {}, options = {}) # 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 + # Cost Explorer Settings page. For information about how to access the # Settings page, see [Controlling Access for Cost Explorer][2] in the # *Billing and Cost Management User Guide*. # @@ -1299,8 +1299,8 @@ def get_cost_and_usage(params = {}, options = {}) # 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 + # are measured in different units (for example, hour or GB). To get more + # meaningful `UsageQuantity` metrics, filter by `UsageType` or # `UsageTypeGroups`. # # @@ -1418,11 +1418,10 @@ def get_cost_and_usage_with_resources(params = {}, options = {}) # @option params [String] :search_string # The value that you want to search the filter values for. # - # If you do not specify a `CostCategoryName`, `SearchString` will be - # used to filter Cost Category names that match the `SearchString` - # pattern. If you do specifiy a `CostCategoryName`, `SearchString` will - # be used to filter Cost Category values that match the `SearchString` - # pattern. + # If you don't specify a `CostCategoryName`, `SearchString` is used to + # filter Cost Category names that match the `SearchString` pattern. If + # you specify a `CostCategoryName`, `SearchString` is used to filter + # Cost Category values that match the `SearchString` pattern. # # @option params [required, Types::DateInterval] :time_period # The time period of the request. @@ -1484,10 +1483,10 @@ def get_cost_and_usage_with_resources(params = {}, options = {}) # # # @option params [Array] :sort_by - # The value by which you want to sort the data. + # The value that you sort the data by. # - # The key represents cost and usage metrics. The following values are - # supported: + # The key represents the cost and usage metrics. The following values + # are supported: # # * `BlendedCost` # @@ -1503,25 +1502,27 @@ def get_cost_and_usage_with_resources(params = {}, options = {}) # # * `NormalizedUsageAmount` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported key values for the `SortOrder` value are `ASCENDING` and + # `DESCENDING`. # - # When using `SortBy`, `NextPageToken` and `SearchString` are not - # supported. + # When you use the `SortBy` value, the `NextPageToken` and + # `SearchString` key values aren't supported. # # @option params [Integer] :max_results - # This field is only used when `SortBy` is provided in the request. + # This field is only used when the `SortBy` value 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. + # The maximum number of objects that are returned for this request. If + # `MaxResults` isn't specified with the `SortBy` value, the request + # returns 1000 results as the default value for this parameter. # - # For `GetCostCategories`, MaxResults has an upper limit of 1000. + # For `GetCostCategories`, MaxResults has an upper quota of 1000. # # @option params [String] :next_page_token # If the number of objects that are still available for retrieval - # exceeds the limit, Amazon Web Services returns a NextPageToken value + # exceeds the quota, 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 from the previous call in your next request. # # @return [Types::GetCostCategoriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -1797,15 +1798,14 @@ def get_cost_forecast(params = {}, options = {}) # is with. Possible values are the following: # # \- Amazon Web Services(Amazon Web Services): The entity that sells - # Amazon Web Services services. + # Amazon Web Services. # # \- AISPL (Amazon Internet Services Pvt. Ltd.): The local Indian - # entity that is an acting reseller for Amazon Web Services services - # in India. + # entity that's an acting reseller for Amazon Web Services in India. # # \- Amazon Web Services Marketplace: The entity that supports the sale - # of solutions built on Amazon Web Services by third-party software - # providers. + # of solutions that are built on Amazon Web Services by third-party + # software providers. # # * CACHE\_ENGINE - The Amazon ElastiCache operating system. Examples # are Windows or Linux. @@ -1820,12 +1820,12 @@ def get_cost_forecast(params = {}, options = {}) # `m4.xlarge`. # # * INSTANCE\_TYPE\_FAMILY - A family of instance types optimized to fit - # different use cases. Examples are `Compute Optimized` (`C4`, `C5`, - # `C6g`, `C7g` etc.), `Memory Optimization` (`R4`, `R5n`, `R5b`, `R6g` - # etc). + # different use cases. Examples are `Compute Optimized` (for example, + # `C4`, `C5`, `C6g`, and `C7g`), `Memory Optimization` (for example, + # `R4`, `R5n`, `R5b`, and `R6g`). # - # * INVOICING\_ENTITY - The name of the entity issuing the Amazon Web - # Services invoice. + # * INVOICING\_ENTITY - The name of the entity that issues the Amazon + # Web Services invoice. # # * LEGAL\_ENTITY\_NAME - The name of the organization that sells you # Amazon Web Services services, such as Amazon Web Services. @@ -1843,9 +1843,9 @@ def get_cost_forecast(params = {}, options = {}) # * PLATFORM - The Amazon EC2 operating system. Examples are Windows or # Linux. # - # * PURCHASE\_TYPE - The reservation type of the purchase to which this - # usage is related. Examples include On-Demand Instances and Standard - # Reserved Instances. + # * PURCHASE\_TYPE - The reservation type of the purchase that this + # usage is related to. Examples include On-Demand Instances and + # Standard Reserved Instances. # # * RESERVATION\_ID - The unique identifier for an Amazon Web Services # Reservation Instance. @@ -1870,8 +1870,8 @@ def get_cost_forecast(params = {}, options = {}) # # * REGION - The Amazon Web Services Region. # - # * RECORD\_TYPE - The different types of charges such as RI fees, usage - # costs, tax refunds, and credits. + # * RECORD\_TYPE - The different types of charges such as Reserved + # Instance (RI) fees, usage costs, tax refunds, and credits. # # * RESOURCE\_ID - The unique identifier of the resource. ResourceId is # an opt-in feature only available for last 14 days for EC2-Compute @@ -1915,8 +1915,8 @@ def get_cost_forecast(params = {}, options = {}) # * SAVINGS\_PLANS\_TYPE - Type of Savings Plans (EC2 Instance or # Compute) # - # * PAYMENT\_OPTION - Payment option for the given Savings Plans (for - # example, All Upfront) + # * PAYMENT\_OPTION - The payment option for the given Savings Plans + # (for example, All Upfront) # # * REGION - The Amazon Web Services Region. # @@ -1982,7 +1982,7 @@ def get_cost_forecast(params = {}, options = {}) # # # @option params [Array] :sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The key represents cost and usage metrics. The following values are # supported: @@ -2001,16 +2001,17 @@ def get_cost_forecast(params = {}, options = {}) # # * `NormalizedUsageAmount` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for the `SortOrder` key are `ASCENDING` or + # `DESCENDING`. # # When you specify a `SortBy` paramater, the context must be # `COST_AND_USAGE`. Further, when using `SortBy`, `NextPageToken` and - # `SearchString` are not supported. + # `SearchString` aren't supported. # # @option params [Integer] :max_results # 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 + # maximum number of objects that are returned for this request. If + # MaxResults isn't specified with SortBy, the request returns 1000 # results as the default value for this parameter. # # For `GetDimensionValues`, MaxResults has an upper limit of 1000. @@ -2096,7 +2097,7 @@ def get_dimension_values(params = {}, options = {}) req.send_request(options) end - # Retrieves the reservation coverage for your account. This enables you + # Retrieves the reservation coverage for your account, which you can use # 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 @@ -2368,31 +2369,31 @@ def get_reservation_coverage(params = {}, options = {}) req.send_request(options) end - # 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. + # Gets recommendations for reservation purchases. These recommendations + # might help you to 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. + # best number of each type of Reserved Instance (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. + # purchase a size-flexible Reserved Instance (RI). Amazon Web Services + # also shows the equal number of normalized units. This way, you can + # purchase any instance size that you want. For this example, your RI + # recommendation is for `c4.large` because that is the smallest size + # instance in the c4 instance family. # # @option params [String] :account_id - # The account ID that is associated with the recommendation. + # The account ID that's associated with the recommendation. # # @option params [required, String] :service # The specific service that you want recommendations for. @@ -2617,11 +2618,12 @@ def get_reservation_purchase_recommendation(params = {}, options = {}) # Currently, you can group only by `SUBSCRIPTION_ID`. # # @option params [required, Types::DateInterval] :time_period - # 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`. + # Sets the start and end dates for retrieving Reserved Instance (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`. # # @option params [Array] :group_by # Groups only by `SUBSCRIPTION_ID`. Metadata is included. @@ -2671,7 +2673,7 @@ def get_reservation_purchase_recommendation(params = {}, options = {}) # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html # # @option params [Types::SortDefinition] :sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The following values are supported for `Key`\: # @@ -2709,7 +2711,7 @@ def get_reservation_purchase_recommendation(params = {}, options = {}) # # * `UnrealizedSavings` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for `SortOrder` are `ASCENDING` and `DESCENDING`. # # @option params [String] :next_page_token # The token to retrieve the next set of results. Amazon Web Services @@ -2856,10 +2858,10 @@ def get_reservation_utilization(params = {}, options = {}) # 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][1] in the *Billing and Cost Management - # User Guide*. + # instances, along with providing savings detail and metrics. For more + # information about calculation and function, see [Optimizing Your Cost + # with Rightsizing Recommendations][1] in the *Billing and Cost + # Management User Guide*. # # # @@ -2919,12 +2921,12 @@ def get_reservation_utilization(params = {}, options = {}) # # # @option params [Types::RightsizingRecommendationConfiguration] :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. + # You can use Configuration 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. # # @option params [required, String] :service # The specific service that you want recommendations for. The only valid @@ -3158,7 +3160,7 @@ def get_rightsizing_recommendation(params = {}, options = {}) # with a minimum value of `1`. # # @option params [Types::SortDefinition] :sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The following values are supported for `Key`\: # @@ -3176,7 +3178,7 @@ def get_rightsizing_recommendation(params = {}, options = {}) # # * `Service` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for `SortOrder` are `ASCENDING` and `DESCENDING`. # # @return [Types::GetSavingsPlansCoverageResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -3264,14 +3266,14 @@ def get_savings_plans_coverage(params = {}, options = {}) # Summary and Details. # # @option params [required, String] :savings_plans_type - # The Savings Plans recommendation type requested. + # The Savings Plans recommendation type that's requested. # # @option params [required, String] :term_in_years - # The savings plan recommendation term used to generate these + # The savings plan recommendation term that's used to generate these # recommendations. # # @option params [required, String] :payment_option - # The payment option used to generate these recommendations. + # The payment option that's used to generate these recommendations. # # @option params [String] :account_scope # The account scope that you want your recommendations for. Amazon Web @@ -3290,20 +3292,20 @@ def get_savings_plans_coverage(params = {}, options = {}) # response object. # # @option params [required, String] :lookback_period_in_days - # The lookback period used to generate the recommendation. + # The lookback period that's used to generate the recommendation. # # @option params [Types::Expression] :filter # You can filter your recommendations by Account ID with the # `LINKED_ACCOUNT` dimension. To filter your recommendations by Account # ID, specify `Key` as `LINKED_ACCOUNT` and `Value` as the - # comma-separated Acount ID(s) for which you want to see Savings Plans - # purchase recommendations. + # comma-separated Acount ID(s) that you want to see Savings Plans + # purchase recommendations for. # - # For GetSavingsPlansPurchaseRecommendation, the `Filter` does not + # For GetSavingsPlansPurchaseRecommendation, the `Filter` doesn't # include `CostCategories` or `Tags`. It only includes `Dimensions`. # With `Dimensions`, `Key` must be `LINKED_ACCOUNT` and `Value` can be a - # single Account ID or multiple comma-separated Account IDs for which - # you want to see Savings Plans Purchase Recommendations. `AND` and `OR` + # single Account ID or multiple comma-separated Account IDs that you + # want to see Savings Plans Purchase Recommendations for. `AND` and `OR` # operators are not supported. # # @return [Types::GetSavingsPlansPurchaseRecommendationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: @@ -3411,7 +3413,7 @@ def get_savings_plans_purchase_recommendation(params = {}, options = {}) # `GetDimensionValues` in `SAVINGS_PLANS` to determine the possible # dimension values. # - # You cannot group by any dimension values for + # You can't group by any dimension values for # `GetSavingsPlansUtilization`. # # @@ -3454,7 +3456,7 @@ def get_savings_plans_purchase_recommendation(params = {}, options = {}) # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html # # @option params [Types::SortDefinition] :sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The following values are supported for `Key`\: # @@ -3468,7 +3470,7 @@ def get_savings_plans_purchase_recommendation(params = {}, options = {}) # # * `NetSavings` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for `SortOrder` are `ASCENDING` and `DESCENDING`. # # @return [Types::GetSavingsPlansUtilizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -3607,7 +3609,7 @@ def get_savings_plans_utilization(params = {}, options = {}) # with a minimum value of `1`. # # @option params [Types::SortDefinition] :sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The following values are supported for `Key`\: # @@ -3625,7 +3627,7 @@ def get_savings_plans_utilization(params = {}, options = {}) # # * `AmortizedUpfrontCommitment` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for `SortOrder` are `ASCENDING` and `DESCENDING`. # # @return [Types::GetSavingsPlansUtilizationDetailsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -3789,7 +3791,7 @@ def get_savings_plans_utilization_details(params = {}, options = {}) # # # @option params [Array] :sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The key represents cost and usage metrics. The following values are # supported: @@ -3808,18 +3810,18 @@ def get_savings_plans_utilization_details(params = {}, options = {}) # # * `NormalizedUsageAmount` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for `SortOrder` are `ASCENDING` and `DESCENDING`. # - # When using `SortBy`, `NextPageToken` and `SearchString` are not + # When you use `SortBy`, `NextPageToken` and `SearchString` aren't # supported. # # @option params [Integer] :max_results # 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 + # maximum number of objects that are returned for this request. If + # MaxResults isn't specified with SortBy, the request returns 1000 # results as the default value for this parameter. # - # For `GetTags`, MaxResults has an upper limit of 1000. + # For `GetTags`, MaxResults has an upper quota of 1000. # # @option params [String] :next_page_token # The token to retrieve the next set of results. Amazon Web Services @@ -3905,12 +3907,12 @@ def get_tags(params = {}, options = {}) # # @option params [required, Types::DateInterval] :time_period # The start and end dates of the period that you want to retrieve usage - # forecast for. 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 must be equal to or later than the - # current date to avoid a validation error. + # forecast for. The start date is included in the period, but the end + # date isn't included in the period. 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 must be equal to or later + # than the current date to avoid a validation error. # # @option params [required, String] :metric # Which metric Cost Explorer uses to create your forecast. @@ -3979,12 +3981,12 @@ def get_tags(params = {}, options = {}) # * `SAVINGS_PLAN_ARN` # # @option params [Integer] :prediction_interval_level - # Cost Explorer always returns the mean forecast as a single point. You - # can request a prediction interval around the mean by specifying a - # confidence level. The higher the confidence level, the more confident - # Cost Explorer is about the actual value falling in the prediction - # interval. Higher confidence levels result in wider prediction - # intervals. + # Amazon Web Services Cost Explorer always returns the mean forecast as + # a single point. You can request a prediction interval around the mean + # by specifying a confidence level. The higher the confidence level, the + # more confident Cost Explorer is about the actual value falling in the + # prediction interval. Higher confidence levels result in wider + # prediction intervals. # # @return [Types::GetUsageForecastResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: # @@ -4053,14 +4055,77 @@ def get_usage_forecast(params = {}, options = {}) req.send_request(options) end - # 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. + # Get a list of cost allocation tags. All inputs in the API are optional + # and serve as filters. By default, all cost allocation tags are + # returned. + # + # @option params [String] :status + # The status of cost allocation tag keys that are returned for this + # request. + # + # @option params [Array] :tag_keys + # The list of cost allocation tag keys that are returned for this + # request. + # + # @option params [String] :type + # The type of `CostAllocationTag` object that are returned for this + # request. The `AWSGenerated` type tags are tags that Amazon Web + # Services defines and applies to support Amazon Web Services resources + # for cost allocation purposes. The `UserDefined` type tags are tags + # that you define, create, and apply to resources. + # + # @option params [String] :next_token + # 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. + # + # @option params [Integer] :max_results + # The maximum number of objects that are returned for this request. By + # default, the request returns 100 results. + # + # @return [Types::ListCostAllocationTagsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::ListCostAllocationTagsResponse#cost_allocation_tags #cost_allocation_tags} => Array<Types::CostAllocationTag> + # * {Types::ListCostAllocationTagsResponse#next_token #next_token} => String + # + # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}. + # + # @example Request syntax with placeholder values + # + # resp = client.list_cost_allocation_tags({ + # status: "Active", # accepts Active, Inactive + # tag_keys: ["TagKey"], + # type: "AWSGenerated", # accepts AWSGenerated, UserDefined + # next_token: "NextPageToken", + # max_results: 1, + # }) + # + # @example Response structure + # + # resp.cost_allocation_tags #=> Array + # resp.cost_allocation_tags[0].tag_key #=> String + # resp.cost_allocation_tags[0].type #=> String, one of "AWSGenerated", "UserDefined" + # resp.cost_allocation_tags[0].status #=> String, one of "Active", "Inactive" + # resp.next_token #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostAllocationTags AWS API Documentation + # + # @overload list_cost_allocation_tags(params = {}) + # @param [Hash] params ({}) + def list_cost_allocation_tags(params = {}, options = {}) + req = build_request(:list_cost_allocation_tags, params) + req.send_request(options) + end + + # Returns the name, Amazon Resource 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. # # @option params [String] :effective_on # The date when the Cost Category was effective. @@ -4216,8 +4281,8 @@ def provide_anomaly_feedback(params = {}, options = {}) # # * The maximum length of a value is 256 characters # - # * Valid characters for keys and values are: `A-Z`, `a-z`, spaces, - # `_.:/=+-` + # * Keys and values can only contain alphanumeric characters, spaces, + # and any of the following: `_.:/=+@-` # # * Keys and values are case sensitive # @@ -4249,8 +4314,8 @@ def tag_resource(params = {}, options = {}) req.send_request(options) end - # Removes one or more tags from a resource. Specify only tag key(s) in - # your request. Do not specify the value. + # Removes one or more tags from a resource. Specify only tag keys in + # your request. Don't specify the value. # # @option params [required, String] :resource_arn # The Amazon Resource Name (ARN) of the resource. For a list of @@ -4262,7 +4327,7 @@ def tag_resource(params = {}, options = {}) # # @option params [required, Array] :resource_tag_keys # A list of tag keys associated with tags that need to be removed from - # the resource. If you specify a tag key that does not exist, it is + # the resource. If you specify a tag key that doesn't exist, it's # ignored. Although the maximum number of array members is 200, user-tag # maximum is 50. The remaining are reserved for Amazon Web Services use. # @@ -4372,6 +4437,47 @@ def update_anomaly_subscription(params = {}, options = {}) req.send_request(options) end + # Updates status for cost allocation tags in bulk, with maximum batch + # size of 20. If the tag status that's updated is the same as the + # existing tag status, the request doesn't fail. Instead, it doesn't + # have any effect on the tag status (for example, activating the active + # tag). + # + # @option params [required, Array] :cost_allocation_tags_status + # The list of `CostAllocationTagStatusEntry` objects that are used to + # update cost allocation tags status for this request. + # + # @return [Types::UpdateCostAllocationTagsStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::UpdateCostAllocationTagsStatusResponse#errors #errors} => Array<Types::UpdateCostAllocationTagsStatusError> + # + # @example Request syntax with placeholder values + # + # resp = client.update_cost_allocation_tags_status({ + # cost_allocation_tags_status: [ # required + # { + # tag_key: "TagKey", # required + # status: "Active", # required, accepts Active, Inactive + # }, + # ], + # }) + # + # @example Response structure + # + # resp.errors #=> Array + # resp.errors[0].tag_key #=> String + # resp.errors[0].code #=> String + # resp.errors[0].message #=> String + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostAllocationTagsStatus AWS API Documentation + # + # @overload update_cost_allocation_tags_status(params = {}) + # @param [Hash] params ({}) + def update_cost_allocation_tags_status(params = {}, options = {}) + req = build_request(:update_cost_allocation_tags_status, params) + req.send_request(options) + end + # 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 @@ -4491,7 +4597,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-costexplorer' - context[:gem_version] = '1.76.0' + context[:gem_version] = '1.77.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/client_api.rb b/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/client_api.rb index 4aa75796735..1b7cb3a62a5 100644 --- a/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/client_api.rb +++ b/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/client_api.rb @@ -32,6 +32,14 @@ module ClientApi Attributes = Shapes::MapShape.new(name: 'Attributes') BillExpirationException = Shapes::StructureShape.new(name: 'BillExpirationException') Context = Shapes::StringShape.new(name: 'Context') + CostAllocationTag = Shapes::StructureShape.new(name: 'CostAllocationTag') + CostAllocationTagKeyList = Shapes::ListShape.new(name: 'CostAllocationTagKeyList') + CostAllocationTagList = Shapes::ListShape.new(name: 'CostAllocationTagList') + CostAllocationTagStatus = Shapes::StringShape.new(name: 'CostAllocationTagStatus') + CostAllocationTagStatusEntry = Shapes::StructureShape.new(name: 'CostAllocationTagStatusEntry') + CostAllocationTagStatusList = Shapes::ListShape.new(name: 'CostAllocationTagStatusList') + CostAllocationTagType = Shapes::StringShape.new(name: 'CostAllocationTagType') + CostAllocationTagsMaxResults = Shapes::IntegerShape.new(name: 'CostAllocationTagsMaxResults') CostCategory = Shapes::StructureShape.new(name: 'CostCategory') CostCategoryInheritedValueDimension = Shapes::StructureShape.new(name: 'CostCategoryInheritedValueDimension') CostCategoryInheritedValueDimensionName = Shapes::StringShape.new(name: 'CostCategoryInheritedValueDimensionName') @@ -157,6 +165,8 @@ module ClientApi Key = Shapes::StringShape.new(name: 'Key') Keys = Shapes::ListShape.new(name: 'Keys') LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException') + ListCostAllocationTagsRequest = Shapes::StructureShape.new(name: 'ListCostAllocationTagsRequest') + ListCostAllocationTagsResponse = Shapes::StructureShape.new(name: 'ListCostAllocationTagsResponse') ListCostCategoryDefinitionsRequest = Shapes::StructureShape.new(name: 'ListCostCategoryDefinitionsRequest') ListCostCategoryDefinitionsResponse = Shapes::StructureShape.new(name: 'ListCostCategoryDefinitionsResponse') ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest') @@ -298,6 +308,10 @@ module ClientApi UpdateAnomalyMonitorResponse = Shapes::StructureShape.new(name: 'UpdateAnomalyMonitorResponse') UpdateAnomalySubscriptionRequest = Shapes::StructureShape.new(name: 'UpdateAnomalySubscriptionRequest') UpdateAnomalySubscriptionResponse = Shapes::StructureShape.new(name: 'UpdateAnomalySubscriptionResponse') + UpdateCostAllocationTagsStatusError = Shapes::StructureShape.new(name: 'UpdateCostAllocationTagsStatusError') + UpdateCostAllocationTagsStatusErrors = Shapes::ListShape.new(name: 'UpdateCostAllocationTagsStatusErrors') + UpdateCostAllocationTagsStatusRequest = Shapes::StructureShape.new(name: 'UpdateCostAllocationTagsStatusRequest') + UpdateCostAllocationTagsStatusResponse = Shapes::StructureShape.new(name: 'UpdateCostAllocationTagsStatusResponse') UpdateCostCategoryDefinitionRequest = Shapes::StructureShape.new(name: 'UpdateCostCategoryDefinitionRequest') UpdateCostCategoryDefinitionResponse = Shapes::StructureShape.new(name: 'UpdateCostCategoryDefinitionResponse') UtilizationByTime = Shapes::StructureShape.new(name: 'UtilizationByTime') @@ -360,6 +374,21 @@ module ClientApi BillExpirationException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message")) BillExpirationException.struct_class = Types::BillExpirationException + CostAllocationTag.add_member(:tag_key, Shapes::ShapeRef.new(shape: TagKey, required: true, location_name: "TagKey")) + CostAllocationTag.add_member(:type, Shapes::ShapeRef.new(shape: CostAllocationTagType, required: true, location_name: "Type")) + CostAllocationTag.add_member(:status, Shapes::ShapeRef.new(shape: CostAllocationTagStatus, required: true, location_name: "Status")) + CostAllocationTag.struct_class = Types::CostAllocationTag + + CostAllocationTagKeyList.member = Shapes::ShapeRef.new(shape: TagKey) + + CostAllocationTagList.member = Shapes::ShapeRef.new(shape: CostAllocationTag) + + CostAllocationTagStatusEntry.add_member(:tag_key, Shapes::ShapeRef.new(shape: TagKey, required: true, location_name: "TagKey")) + CostAllocationTagStatusEntry.add_member(:status, Shapes::ShapeRef.new(shape: CostAllocationTagStatus, required: true, location_name: "Status")) + CostAllocationTagStatusEntry.struct_class = Types::CostAllocationTagStatusEntry + + CostAllocationTagStatusList.member = Shapes::ShapeRef.new(shape: CostAllocationTagStatusEntry) + CostCategory.add_member(:cost_category_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "CostCategoryArn")) CostCategory.add_member(:effective_start, Shapes::ShapeRef.new(shape: ZonedDateTime, required: true, location_name: "EffectiveStart")) CostCategory.add_member(:effective_end, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "EffectiveEnd")) @@ -887,6 +916,17 @@ module ClientApi LimitExceededException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message")) LimitExceededException.struct_class = Types::LimitExceededException + ListCostAllocationTagsRequest.add_member(:status, Shapes::ShapeRef.new(shape: CostAllocationTagStatus, location_name: "Status")) + ListCostAllocationTagsRequest.add_member(:tag_keys, Shapes::ShapeRef.new(shape: CostAllocationTagKeyList, location_name: "TagKeys")) + ListCostAllocationTagsRequest.add_member(:type, Shapes::ShapeRef.new(shape: CostAllocationTagType, location_name: "Type")) + ListCostAllocationTagsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextToken")) + ListCostAllocationTagsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: CostAllocationTagsMaxResults, location_name: "MaxResults", metadata: {"box"=>true})) + ListCostAllocationTagsRequest.struct_class = Types::ListCostAllocationTagsRequest + + ListCostAllocationTagsResponse.add_member(:cost_allocation_tags, Shapes::ShapeRef.new(shape: CostAllocationTagList, location_name: "CostAllocationTags")) + ListCostAllocationTagsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextToken")) + ListCostAllocationTagsResponse.struct_class = Types::ListCostAllocationTagsResponse + ListCostCategoryDefinitionsRequest.add_member(:effective_on, Shapes::ShapeRef.new(shape: ZonedDateTime, location_name: "EffectiveOn")) ListCostCategoryDefinitionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextToken")) ListCostCategoryDefinitionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: CostCategoryMaxResults, location_name: "MaxResults", metadata: {"box"=>true})) @@ -1285,6 +1325,19 @@ module ClientApi UpdateAnomalySubscriptionResponse.add_member(:subscription_arn, Shapes::ShapeRef.new(shape: GenericString, required: true, location_name: "SubscriptionArn")) UpdateAnomalySubscriptionResponse.struct_class = Types::UpdateAnomalySubscriptionResponse + UpdateCostAllocationTagsStatusError.add_member(:tag_key, Shapes::ShapeRef.new(shape: TagKey, location_name: "TagKey")) + UpdateCostAllocationTagsStatusError.add_member(:code, Shapes::ShapeRef.new(shape: GenericString, location_name: "Code")) + UpdateCostAllocationTagsStatusError.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message")) + UpdateCostAllocationTagsStatusError.struct_class = Types::UpdateCostAllocationTagsStatusError + + UpdateCostAllocationTagsStatusErrors.member = Shapes::ShapeRef.new(shape: UpdateCostAllocationTagsStatusError) + + UpdateCostAllocationTagsStatusRequest.add_member(:cost_allocation_tags_status, Shapes::ShapeRef.new(shape: CostAllocationTagStatusList, required: true, location_name: "CostAllocationTagsStatus")) + UpdateCostAllocationTagsStatusRequest.struct_class = Types::UpdateCostAllocationTagsStatusRequest + + UpdateCostAllocationTagsStatusResponse.add_member(:errors, Shapes::ShapeRef.new(shape: UpdateCostAllocationTagsStatusErrors, location_name: "Errors")) + UpdateCostAllocationTagsStatusResponse.struct_class = Types::UpdateCostAllocationTagsStatusResponse + UpdateCostCategoryDefinitionRequest.add_member(:cost_category_arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "CostCategoryArn")) UpdateCostCategoryDefinitionRequest.add_member(:rule_version, Shapes::ShapeRef.new(shape: CostCategoryRuleVersion, required: true, location_name: "RuleVersion")) UpdateCostCategoryDefinitionRequest.add_member(:rules, Shapes::ShapeRef.new(shape: CostCategoryRulesList, required: true, location_name: "Rules")) @@ -1609,6 +1662,22 @@ module ClientApi o.errors << Shapes::ShapeRef.new(shape: UnresolvableUsageUnitException) end) + api.add_operation(:list_cost_allocation_tags, Seahorse::Model::Operation.new.tap do |o| + o.name = "ListCostAllocationTags" + o.http_method = "POST" + o.http_request_uri = "/" + o.input = Shapes::ShapeRef.new(shape: ListCostAllocationTagsRequest) + o.output = Shapes::ShapeRef.new(shape: ListCostAllocationTagsResponse) + o.errors << Shapes::ShapeRef.new(shape: LimitExceededException) + o.errors << Shapes::ShapeRef.new(shape: InvalidNextTokenException) + o[:pager] = Aws::Pager.new( + limit_key: "max_results", + tokens: { + "next_token" => "next_token" + } + ) + end) + api.add_operation(:list_cost_category_definitions, Seahorse::Model::Operation.new.tap do |o| o.name = "ListCostCategoryDefinitions" o.http_method = "POST" @@ -1685,6 +1754,15 @@ module ClientApi o.errors << Shapes::ShapeRef.new(shape: UnknownSubscriptionException) end) + api.add_operation(:update_cost_allocation_tags_status, Seahorse::Model::Operation.new.tap do |o| + o.name = "UpdateCostAllocationTagsStatus" + o.http_method = "POST" + o.http_request_uri = "/" + o.input = Shapes::ShapeRef.new(shape: UpdateCostAllocationTagsStatusRequest) + o.output = Shapes::ShapeRef.new(shape: UpdateCostAllocationTagsStatusResponse) + o.errors << Shapes::ShapeRef.new(shape: LimitExceededException) + end) + api.add_operation(:update_cost_category_definition, Seahorse::Model::Operation.new.tap do |o| o.name = "UpdateCostCategoryDefinition" o.http_method = "POST" diff --git a/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/types.rb b/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/types.rb index 989caa55129..b8139c12b78 100644 --- a/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/types.rb +++ b/gems/aws-sdk-costexplorer/lib/aws-sdk-costexplorer/types.rb @@ -26,8 +26,8 @@ module Types # @return [String] # # @!attribute [rw] dimension_value - # The dimension for the anomaly (for example, an Amazon Web Services - # service in a service monitor). + # The dimension for the anomaly (for example, an Amazon Web Service in + # a service monitor). # @return [String] # # @!attribute [rw] root_causes @@ -346,6 +346,63 @@ class BillExpirationException < Struct.new( include Aws::Structure end + # The cost allocation tag structure. This includes detailed metadata for + # the `CostAllocationTag` object. + # + # @!attribute [rw] tag_key + # The key for the cost allocation tag. + # @return [String] + # + # @!attribute [rw] type + # The type of cost allocation tag. You can use `AWSGenerated` or + # `UserDefined` type tags. `AWSGenerated` type tags are tags that + # Amazon Web Services defines and applies to support Amazon Web + # Services resources for cost allocation purposes. `UserDefined` type + # tags are tags that you define, create, and apply to resources. + # @return [String] + # + # @!attribute [rw] status + # The status of a cost allocation tag. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostAllocationTag AWS API Documentation + # + class CostAllocationTag < Struct.new( + :tag_key, + :type, + :status) + SENSITIVE = [] + include Aws::Structure + end + + # The cost allocation tag status. The status of a key can either be + # active or inactive. + # + # @note When making an API call, you may pass CostAllocationTagStatusEntry + # data as a hash: + # + # { + # tag_key: "TagKey", # required + # status: "Active", # required, accepts Active, Inactive + # } + # + # @!attribute [rw] tag_key + # The key for the cost allocation tag. + # @return [String] + # + # @!attribute [rw] status + # The status of a cost allocation tag. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostAllocationTagStatusEntry AWS API Documentation + # + class CostAllocationTagStatusEntry < Struct.new( + :tag_key, + :status) + SENSITIVE = [] + include Aws::Structure + end + # The structure of Cost Categories. This includes detailed metadata and # the set of rules for the `CostCategory` object. # @@ -405,14 +462,14 @@ class CostCategory < Struct.new( include Aws::Structure end - # When creating or updating a cost category, you can define the + # When you create or update 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. + # the flexibility to define a rule that dynamically inherits the cost + # category value from the dimension value that's defined by + # `CostCategoryInheritedValueDimension`. For example, suppose that you + # want to dynamically group costs that are based on the value of a + # specific tag key. First, choose an inherited value rule type, and then + # choose the tag dimension and specify the tag key to use. # # @note When making an API call, you may pass CostCategoryInheritedValueDimension # data as a hash: @@ -427,7 +484,7 @@ class CostCategory < Struct.new( # # 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. + # is based on the value of the specified tag key. # @return [String] # # @!attribute [rw] dimension_key @@ -597,12 +654,13 @@ class CostCategoryReference < Struct.new( # @!attribute [rw] 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. + # flexibility to define a rule that dynamically inherits the cost + # category value. This value is from the dimension value that's + # defined by `CostCategoryInheritedValueDimension`. For example, + # suppose that you want to costs to be dynamically grouped based on + # the value of a specific tag key. First, choose an inherited value + # rule type, and then choose the tag dimension and specify the tag key + # to use. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostCategoryRule AWS API Documentation @@ -945,7 +1003,7 @@ class CoverageNormalizedUnits < Struct.new( # @!attribute [rw] resource_tags # An optional list of tags to associate with the specified [ # `AnomalyMonitor` ][1]. You can use resource tags to control access - # to your monitor using IAM policies. + # to your `monitor` using IAM policies. # # Each tag consists of a key and a value, and each key must be unique # for the resource. The following restrictions apply to resource tags: @@ -958,8 +1016,8 @@ class CoverageNormalizedUnits < Struct.new( # # * The maximum length of a value is 256 characters # - # * Valid characters for keys and values are: `A-Z`, `a-z`, spaces, - # `_.:/=+-` + # * Keys and values can only contain alphanumeric characters, spaces, + # and any of the following: `_.:/=+@-` # # * Keys and values are case sensitive # @@ -1043,8 +1101,8 @@ class CreateAnomalyMonitorResponse < Struct.new( # # * The maximum length of a value is 256 characters # - # * Valid characters for keys and values are: `A-Z`, `a-z`, spaces, - # `_.:/=+-` + # * Keys and values can only contain alphanumeric characters, spaces, + # and any of the following: `_.:/=+@-` # # * Keys and values are case sensitive # @@ -1191,8 +1249,8 @@ class CreateAnomalySubscriptionResponse < Struct.new( # # * The maximum length of a value is 256 characters # - # * Valid characters for keys and values are: `A-Z`, `a-z`, spaces, - # `_.:/=+-` + # * Keys and values can only contain alphanumeric characters, spaces, + # and any of the following: `_.:/=+@-` # # * Keys and values are case sensitive # @@ -1429,7 +1487,7 @@ class DeleteCostCategoryDefinitionRequest < Struct.new( # # @!attribute [rw] effective_end # 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 + # it. No costs after this date is categorized by the deleted Cost # Category. # @return [String] # @@ -1713,7 +1771,7 @@ class EC2ResourceDetails < Struct.new( include Aws::Structure end - # Utilization metrics of the instance. + # Utilization metrics for the instance. # # @!attribute [rw] max_cpu_utilization_percentage # The maximum observed or expected CPU utilization of the instance. @@ -2552,8 +2610,8 @@ class GetCostAndUsageResponse < Struct.new( # 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 + # transfer are measured in different units (for example, hour or GB). + # To get more meaningful `UsageQuantity` metrics, filter by # `UsageType` or `UsageTypeGroups`. # # @@ -2601,7 +2659,7 @@ class GetCostAndUsageWithResourcesRequest < Struct.new( # @return [Array] # # @!attribute [rw] results_by_time - # The time period that is covered by the results in the response. + # The time period that's covered by the results in the response. # @return [Array] # # @!attribute [rw] dimension_value_attributes @@ -2674,11 +2732,10 @@ class GetCostAndUsageWithResourcesResponse < Struct.new( # @!attribute [rw] search_string # The value that you want to search the filter values for. # - # If you do not specify a `CostCategoryName`, `SearchString` will be - # used to filter Cost Category names that match the `SearchString` - # pattern. If you do specifiy a `CostCategoryName`, `SearchString` - # will be used to filter Cost Category values that match the - # `SearchString` pattern. + # If you don't specify a `CostCategoryName`, `SearchString` is used + # to filter Cost Category names that match the `SearchString` pattern. + # If you specify a `CostCategoryName`, `SearchString` is used to + # filter Cost Category values that match the `SearchString` pattern. # @return [String] # # @!attribute [rw] time_period @@ -2745,10 +2802,10 @@ class GetCostAndUsageWithResourcesResponse < Struct.new( # @return [Types::Expression] # # @!attribute [rw] sort_by - # The value by which you want to sort the data. + # The value that you sort the data by. # - # The key represents cost and usage metrics. The following values are - # supported: + # The key represents the cost and usage metrics. The following values + # are supported: # # * `BlendedCost` # @@ -2764,27 +2821,29 @@ class GetCostAndUsageWithResourcesResponse < Struct.new( # # * `NormalizedUsageAmount` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported key values for the `SortOrder` value are `ASCENDING` + # and `DESCENDING`. # - # When using `SortBy`, `NextPageToken` and `SearchString` are not - # supported. + # When you use the `SortBy` value, the `NextPageToken` and + # `SearchString` key values aren't supported. # @return [Array] # # @!attribute [rw] max_results - # This field is only used when `SortBy` is provided in the request. + # This field is only used when the `SortBy` value 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. + # The maximum number of objects that are returned for this request. If + # `MaxResults` isn't specified with the `SortBy` value, the request + # returns 1000 results as the default value for this parameter. # - # For `GetCostCategories`, MaxResults has an upper limit of 1000. + # For `GetCostCategories`, MaxResults has an upper quota of 1000. # @return [Integer] # # @!attribute [rw] next_page_token # If the number of objects that are still available for retrieval - # exceeds the limit, Amazon Web Services returns a NextPageToken value + # exceeds the quota, 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 from the previous call in your next request. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetCostCategoriesRequest AWS API Documentation @@ -2803,7 +2862,7 @@ class GetCostCategoriesRequest < Struct.new( # @!attribute [rw] next_page_token # If the number of objects that are still available for retrieval - # exceeds the limit, Amazon Web Services returns a NextPageToken value + # exceeds the quota, 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. # @return [String] @@ -2815,12 +2874,12 @@ class GetCostCategoriesRequest < Struct.new( # @!attribute [rw] cost_category_values # The Cost Category values. # - # `CostCategoryValues` are not returned if `CostCategoryName` is not - # specified in the request. + # If the `CostCategoryName` key isn't specified in the request, the + # `CostCategoryValues` fields aren't returned. # @return [Array] # # @!attribute [rw] return_size - # The number of objects returned. + # The number of objects that are returned. # @return [Integer] # # @!attribute [rw] total_size @@ -3097,15 +3156,15 @@ class GetCostForecastResponse < Struct.new( # is with. Possible values are the following: # # \- Amazon Web Services(Amazon Web Services): The entity that sells - # Amazon Web Services services. + # Amazon Web Services. # # \- AISPL (Amazon Internet Services Pvt. Ltd.): The local Indian - # entity that is an acting reseller for Amazon Web Services services - # in India. + # entity that's an acting reseller for Amazon Web Services in + # India. # # \- Amazon Web Services Marketplace: The entity that supports the - # sale of solutions built on Amazon Web Services by third-party - # software providers. + # sale of solutions that are built on Amazon Web Services by + # third-party software providers. # # * CACHE\_ENGINE - The Amazon ElastiCache operating system. Examples # are Windows or Linux. @@ -3120,12 +3179,12 @@ class GetCostForecastResponse < Struct.new( # `m4.xlarge`. # # * INSTANCE\_TYPE\_FAMILY - A family of instance types optimized to - # fit different use cases. Examples are `Compute Optimized` (`C4`, - # `C5`, `C6g`, `C7g` etc.), `Memory Optimization` (`R4`, `R5n`, - # `R5b`, `R6g` etc). + # fit different use cases. Examples are `Compute Optimized` (for + # example, `C4`, `C5`, `C6g`, and `C7g`), `Memory Optimization` (for + # example, `R4`, `R5n`, `R5b`, and `R6g`). # - # * INVOICING\_ENTITY - The name of the entity issuing the Amazon Web - # Services invoice. + # * INVOICING\_ENTITY - The name of the entity that issues the Amazon + # Web Services invoice. # # * LEGAL\_ENTITY\_NAME - The name of the organization that sells you # Amazon Web Services services, such as Amazon Web Services. @@ -3143,8 +3202,8 @@ class GetCostForecastResponse < Struct.new( # * PLATFORM - The Amazon EC2 operating system. Examples are Windows # or Linux. # - # * PURCHASE\_TYPE - The reservation type of the purchase to which - # this usage is related. Examples include On-Demand Instances and + # * PURCHASE\_TYPE - The reservation type of the purchase that this + # usage is related to. Examples include On-Demand Instances and # Standard Reserved Instances. # # * RESERVATION\_ID - The unique identifier for an Amazon Web Services @@ -3170,8 +3229,8 @@ class GetCostForecastResponse < Struct.new( # # * REGION - The Amazon Web Services Region. # - # * RECORD\_TYPE - The different types of charges such as RI fees, - # usage costs, tax refunds, and credits. + # * RECORD\_TYPE - The different types of charges such as Reserved + # Instance (RI) fees, usage costs, tax refunds, and credits. # # * RESOURCE\_ID - The unique identifier of the resource. ResourceId # is an opt-in feature only available for last 14 days for @@ -3215,8 +3274,8 @@ class GetCostForecastResponse < Struct.new( # * SAVINGS\_PLANS\_TYPE - Type of Savings Plans (EC2 Instance or # Compute) # - # * PAYMENT\_OPTION - Payment option for the given Savings Plans (for - # example, All Upfront) + # * PAYMENT\_OPTION - The payment option for the given Savings Plans + # (for example, All Upfront) # # * REGION - The Amazon Web Services Region. # @@ -3286,7 +3345,7 @@ class GetCostForecastResponse < Struct.new( # @return [Types::Expression] # # @!attribute [rw] sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The key represents cost and usage metrics. The following values are # supported: @@ -3305,18 +3364,19 @@ class GetCostForecastResponse < Struct.new( # # * `NormalizedUsageAmount` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for the `SortOrder` key are `ASCENDING` or + # `DESCENDING`. # # When you specify a `SortBy` paramater, the context must be # `COST_AND_USAGE`. Further, when using `SortBy`, `NextPageToken` and - # `SearchString` are not supported. + # `SearchString` aren't supported. # @return [Array] # # @!attribute [rw] max_results # 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. + # maximum number of objects that are returned for this request. If + # MaxResults isn't specified with SortBy, the request returns 1000 + # results as the default value for this parameter. # # For `GetDimensionValues`, MaxResults has an upper limit of 1000. # @return [Integer] @@ -3757,7 +3817,7 @@ class GetReservationCoverageResponse < Struct.new( # } # # @!attribute [rw] account_id - # The account ID that is associated with the recommendation. + # The account ID that's associated with the recommendation. # @return [String] # # @!attribute [rw] service @@ -3950,11 +4010,12 @@ class GetReservationPurchaseRecommendationResponse < Struct.new( # } # # @!attribute [rw] time_period - # 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`. + # Sets the start and end dates for retrieving Reserved Instance (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`. # @return [Types::DateInterval] # # @!attribute [rw] group_by @@ -4008,7 +4069,7 @@ class GetReservationPurchaseRecommendationResponse < Struct.new( # @return [Types::Expression] # # @!attribute [rw] sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The following values are supported for `Key`\: # @@ -4046,7 +4107,8 @@ class GetReservationPurchaseRecommendationResponse < Struct.new( # # * `UnrealizedSavings` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for `SortOrder` are `ASCENDING` and + # `DESCENDING`. # @return [Types::SortDefinition] # # @!attribute [rw] next_page_token @@ -4077,11 +4139,12 @@ class GetReservationUtilizationRequest < Struct.new( end # @!attribute [rw] utilizations_by_time - # The amount of time that you used your RIs. + # The amount of time that you used your Reserved Instances (RIs). # @return [Array] # # @!attribute [rw] total - # The total amount of time that you used your RIs. + # The total amount of time that you used your Reserved Instances + # (RIs). # @return [Types::ReservationAggregates] # # @!attribute [rw] next_page_token @@ -4199,12 +4262,12 @@ class GetReservationUtilizationResponse < Struct.new( # @return [Types::Expression] # # @!attribute [rw] 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. + # You can use Configuration 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. # @return [Types::RightsizingRecommendationConfiguration] # # @!attribute [rw] service @@ -4251,12 +4314,12 @@ class GetRightsizingRecommendationRequest < Struct.new( # @return [String] # # @!attribute [rw] 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. + # You can use Configuration 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. # @return [Types::RightsizingRecommendationConfiguration] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetRightsizingRecommendationResponse AWS API Documentation @@ -4386,7 +4449,7 @@ class GetRightsizingRecommendationResponse < Struct.new( # @return [Integer] # # @!attribute [rw] sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The following values are supported for `Key`\: # @@ -4404,7 +4467,8 @@ class GetRightsizingRecommendationResponse < Struct.new( # # * `Service` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for `SortOrder` are `ASCENDING` and + # `DESCENDING`. # @return [Types::SortDefinition] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansCoverageRequest AWS API Documentation @@ -4485,16 +4549,16 @@ class GetSavingsPlansCoverageResponse < Struct.new( # } # # @!attribute [rw] savings_plans_type - # The Savings Plans recommendation type requested. + # The Savings Plans recommendation type that's requested. # @return [String] # # @!attribute [rw] term_in_years - # The savings plan recommendation term used to generate these + # The savings plan recommendation term that's used to generate these # recommendations. # @return [String] # # @!attribute [rw] payment_option - # The payment option used to generate these recommendations. + # The payment option that's used to generate these recommendations. # @return [String] # # @!attribute [rw] account_scope @@ -4517,22 +4581,22 @@ class GetSavingsPlansCoverageResponse < Struct.new( # @return [Integer] # # @!attribute [rw] lookback_period_in_days - # The lookback period used to generate the recommendation. + # The lookback period that's used to generate the recommendation. # @return [String] # # @!attribute [rw] filter # You can filter your recommendations by Account ID with the # `LINKED_ACCOUNT` dimension. To filter your recommendations by # Account ID, specify `Key` as `LINKED_ACCOUNT` and `Value` as the - # comma-separated Acount ID(s) for which you want to see Savings Plans - # purchase recommendations. + # comma-separated Acount ID(s) that you want to see Savings Plans + # purchase recommendations for. # - # For GetSavingsPlansPurchaseRecommendation, the `Filter` does not + # For GetSavingsPlansPurchaseRecommendation, the `Filter` doesn't # include `CostCategories` or `Tags`. It only includes `Dimensions`. # With `Dimensions`, `Key` must be `LINKED_ACCOUNT` and `Value` can be - # a single Account ID or multiple comma-separated Account IDs for - # which you want to see Savings Plans Purchase Recommendations. `AND` - # and `OR` operators are not supported. + # a single Account ID or multiple comma-separated Account IDs that you + # want to see Savings Plans Purchase Recommendations for. `AND` and + # `OR` operators are not supported. # @return [Types::Expression] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansPurchaseRecommendationRequest AWS API Documentation @@ -4551,7 +4615,7 @@ class GetSavingsPlansPurchaseRecommendationRequest < Struct.new( end # @!attribute [rw] metadata - # Information regarding this specific recommendation set. + # Information that regards this specific recommendation set. # @return [Types::SavingsPlansPurchaseRecommendationMetadata] # # @!attribute [rw] savings_plans_purchase_recommendation @@ -4668,7 +4732,7 @@ class GetSavingsPlansPurchaseRecommendationResponse < Struct.new( # @return [Integer] # # @!attribute [rw] sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The following values are supported for `Key`\: # @@ -4686,7 +4750,8 @@ class GetSavingsPlansPurchaseRecommendationResponse < Struct.new( # # * `AmortizedUpfrontCommitment` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for `SortOrder` are `ASCENDING` and + # `DESCENDING`. # @return [Types::SortDefinition] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansUtilizationDetailsRequest AWS API Documentation @@ -4818,7 +4883,7 @@ class GetSavingsPlansUtilizationDetailsResponse < Struct.new( # @return [Types::Expression] # # @!attribute [rw] sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The following values are supported for `Key`\: # @@ -4832,7 +4897,8 @@ class GetSavingsPlansUtilizationDetailsResponse < Struct.new( # # * `NetSavings` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for `SortOrder` are `ASCENDING` and + # `DESCENDING`. # @return [Types::SortDefinition] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansUtilizationRequest AWS API Documentation @@ -4847,8 +4913,8 @@ class GetSavingsPlansUtilizationRequest < Struct.new( end # @!attribute [rw] savings_plans_utilizations_by_time - # The amount of cost/commitment you used your Savings Plans. This - # allows you to specify date ranges. + # The amount of cost/commitment that you used your Savings Plans. You + # can use it to specify date ranges. # @return [Array] # # @!attribute [rw] total @@ -4987,7 +5053,7 @@ class GetSavingsPlansUtilizationResponse < Struct.new( # @return [Types::Expression] # # @!attribute [rw] sort_by - # The value by which you want to sort the data. + # The value that you want to sort the data by. # # The key represents cost and usage metrics. The following values are # supported: @@ -5006,19 +5072,20 @@ class GetSavingsPlansUtilizationResponse < Struct.new( # # * `NormalizedUsageAmount` # - # Supported values for `SortOrder` are `ASCENDING` or `DESCENDING`. + # The supported values for `SortOrder` are `ASCENDING` and + # `DESCENDING`. # - # When using `SortBy`, `NextPageToken` and `SearchString` are not + # When you use `SortBy`, `NextPageToken` and `SearchString` aren't # supported. # @return [Array] # # @!attribute [rw] max_results # 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. + # maximum number of objects that are returned for this request. If + # MaxResults isn't specified with SortBy, the request returns 1000 + # results as the default value for this parameter. # - # For `GetTags`, MaxResults has an upper limit of 1000. + # For `GetTags`, MaxResults has an upper quota of 1000. # @return [Integer] # # @!attribute [rw] next_page_token @@ -5116,12 +5183,12 @@ class GetTagsResponse < Struct.new( # # @!attribute [rw] time_period # The start and end dates of the period that you want to retrieve - # usage forecast for. 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 must be equal to or later than the - # current date to avoid a validation error. + # usage forecast for. The start date is included in the period, but + # the end date isn't included in the period. 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 must be equal to or + # later than the current date to avoid a validation error. # @return [Types::DateInterval] # # @!attribute [rw] metric @@ -5195,12 +5262,12 @@ class GetTagsResponse < Struct.new( # @return [Types::Expression] # # @!attribute [rw] prediction_interval_level - # Cost Explorer always returns the mean forecast as a single point. - # You can request a prediction interval around the mean by specifying - # a confidence level. The higher the confidence level, the more - # confident Cost Explorer is about the actual value falling in the - # prediction interval. Higher confidence levels result in wider - # prediction intervals. + # Amazon Web Services Cost Explorer always returns the mean forecast + # as a single point. You can request a prediction interval around the + # mean by specifying a confidence level. The higher the confidence + # level, the more confident Cost Explorer is about the actual value + # falling in the prediction interval. Higher confidence levels result + # in wider prediction intervals. # @return [Integer] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetUsageForecastRequest AWS API Documentation @@ -5366,6 +5433,78 @@ class LimitExceededException < Struct.new( include Aws::Structure end + # @note When making an API call, you may pass ListCostAllocationTagsRequest + # data as a hash: + # + # { + # status: "Active", # accepts Active, Inactive + # tag_keys: ["TagKey"], + # type: "AWSGenerated", # accepts AWSGenerated, UserDefined + # next_token: "NextPageToken", + # max_results: 1, + # } + # + # @!attribute [rw] status + # The status of cost allocation tag keys that are returned for this + # request. + # @return [String] + # + # @!attribute [rw] tag_keys + # The list of cost allocation tag keys that are returned for this + # request. + # @return [Array] + # + # @!attribute [rw] type + # The type of `CostAllocationTag` object that are returned for this + # request. The `AWSGenerated` type tags are tags that Amazon Web + # Services defines and applies to support Amazon Web Services + # resources for cost allocation purposes. The `UserDefined` type tags + # are tags that you define, create, and apply to resources. + # @return [String] + # + # @!attribute [rw] next_token + # 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. + # @return [String] + # + # @!attribute [rw] max_results + # The maximum number of objects that are returned for this request. By + # default, the request returns 100 results. + # @return [Integer] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostAllocationTagsRequest AWS API Documentation + # + class ListCostAllocationTagsRequest < Struct.new( + :status, + :tag_keys, + :type, + :next_token, + :max_results) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] cost_allocation_tags + # A list of cost allocation tags that includes the detailed metadata + # for each one. + # @return [Array] + # + # @!attribute [rw] next_token + # 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. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostAllocationTagsResponse AWS API Documentation + # + class ListCostAllocationTagsResponse < Struct.new( + :cost_allocation_tags, + :next_token) + SENSITIVE = [] + include Aws::Structure + end + # @note When making an API call, you may pass ListCostCategoryDefinitionsRequest # data as a hash: # @@ -5400,7 +5539,7 @@ class ListCostCategoryDefinitionsRequest < Struct.new( end # @!attribute [rw] cost_category_references - # A reference to a Cost Category containing enough information to + # A reference to a Cost Category that contains enough information to # identify the Cost Category. # @return [Array] # @@ -5444,7 +5583,7 @@ class ListTagsForResourceRequest < Struct.new( end # @!attribute [rw] resource_tags - # A list of tag key value pairs that are associated with the response. + # A list of tag key value pairs that are associated with the resource. # @return [Array] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListTagsForResourceResponse AWS API Documentation @@ -5474,7 +5613,7 @@ class MetricValue < Struct.new( include Aws::Structure end - # Details on the modification recommendation. + # Details for the modification recommendation. # # @!attribute [rw] target_instances # Determines whether this instance type is the Amazon Web Services @@ -5494,20 +5633,20 @@ class ModifyRecommendationDetail < Struct.new( # # @!attribute [rw] network_in_bytes_per_second # The network inbound throughput utilization measured in Bytes per - # second. + # second (Bps). # @return [String] # # @!attribute [rw] network_out_bytes_per_second # The network outbound throughput utilization measured in Bytes per - # second. + # second (Bps). # @return [String] # # @!attribute [rw] network_packets_in_per_second - # The network ingress packets that are measured in packets per second. + # The network inbound packets that are measured in packets per second. # @return [String] # # @!attribute [rw] network_packets_out_per_second - # The network outgress packets that are measured in packets per + # The network outbound packets that are measured in packets per # second. # @return [String] # @@ -5850,7 +5989,7 @@ class ReservationPurchaseRecommendation < Struct.new( # Details about your recommended reservation purchase. # # @!attribute [rw] account_id - # The account that this RI recommendation is for. + # The account that this Reserved Instance (RI) recommendation is for. # @return [String] # # @!attribute [rw] instance_details @@ -5921,12 +6060,12 @@ class ReservationPurchaseRecommendation < Struct.new( # # @!attribute [rw] estimated_monthly_savings_amount # How much Amazon Web Services estimates that this specific - # recommendation could save you in a month. + # recommendation might save you in a month. # @return [String] # # @!attribute [rw] estimated_monthly_savings_percentage # How much Amazon Web Services estimates that this specific - # recommendation could save you in a month, as a percentage of your + # recommendation might save you in a month, as a percentage of your # overall costs. # @return [String] # @@ -5936,8 +6075,8 @@ class ReservationPurchaseRecommendation < Struct.new( # @return [String] # # @!attribute [rw] estimated_reservation_cost_for_lookback_period - # How much Amazon Web Services estimates that you would have spent for - # all usage during the specified historical period if you had a + # How much Amazon Web Services estimates that you might spend for all + # usage during the specified historical period if you had a # reservation. # @return [String] # @@ -6053,10 +6192,10 @@ class ReservationUtilizationGroup < Struct.new( include Aws::Structure end - # Details on the resource. + # Details for the resource. # # @!attribute [rw] ec2_resource_details - # Details on the Amazon EC2 resource. + # Details for the Amazon EC2 resource. # @return [Types::EC2ResourceDetails] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ResourceDetails AWS API Documentation @@ -6107,11 +6246,11 @@ class ResourceNotFoundException < Struct.new( # } # # @!attribute [rw] key - # The key that is associated with the tag. + # The key that's associated with the tag. # @return [String] # # @!attribute [rw] value - # The value that is associated with the tag. + # The value that's associated with the tag. # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ResourceTag AWS API Documentation @@ -6189,8 +6328,8 @@ class ResultByTime < Struct.new( # @return [Types::TerminateRecommendationDetail] # # @!attribute [rw] finding_reason_codes - # The list of possible reasons why the recommendation is generated - # such as under or over utilization of specific metrics (for example, + # The list of possible reasons why the recommendation is generated, + # such as under- or over-utilization of specific metrics (for example, # CPU, Memory, Network). # @return [Array] # @@ -6212,7 +6351,8 @@ class RightsizingRecommendation < Struct.new( # 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. + # consideration of existing Savings Plans or Reserved Instance (RI) + # benefits, or neither. # # @note When making an API call, you may pass RightsizingRecommendationConfiguration # data as a hash: @@ -6305,12 +6445,12 @@ class RightsizingRecommendationSummary < Struct.new( include Aws::Structure end - # The combination of Amazon Web Services service, linked account, - # Region, and usage type where a cost anomaly is observed. + # The combination of Amazon Web Service, linked account, Region, and + # usage type where a cost anomaly is observed. # # @!attribute [rw] service - # The Amazon Web Services service name that's associated with the - # cost anomaly. + # The Amazon Web Service name that's associated with the cost + # anomaly. # @return [String] # # @!attribute [rw] region @@ -6365,7 +6505,7 @@ class SavingsPlansAmortizedCommitment < Struct.new( include Aws::Structure end - # The amount of Savings Plans eligible usage that is covered by Savings + # The amount of Savings Plans eligible usage that's covered by Savings # Plans. All calculations consider the On-Demand equivalent of your # Savings Plans usage. # @@ -6396,7 +6536,7 @@ class SavingsPlansCoverage < Struct.new( # Savings Plans, and total Savings Plans costs for an account. # # @!attribute [rw] spend_covered_by_savings_plans - # The amount of your Amazon Web Services usage that is covered by a + # The amount of your Amazon Web Services usage that's covered by a # Savings Plans. # @return [String] # @@ -6475,15 +6615,16 @@ class SavingsPlansDetails < Struct.new( # @return [String] # # @!attribute [rw] payment_option - # The payment option used to generate the recommendation. + # The payment option that's used to generate the recommendation. # @return [String] # # @!attribute [rw] lookback_period_in_days - # The lookback period in days, used to generate the recommendation. + # The lookback period in days that's used to generate the + # recommendation. # @return [String] # # @!attribute [rw] savings_plans_purchase_recommendation_details - # Details for the Savings Plans we recommend that you purchase to + # Details for the Savings Plans that we recommend that you purchase to # cover existing Savings Plans eligible workloads. # @return [Array] # @@ -6542,7 +6683,7 @@ class SavingsPlansPurchaseRecommendation < Struct.new( # @return [String] # # @!attribute [rw] estimated_on_demand_cost_with_current_commitment - # The estimated On-Demand costs you would expect with no additional + # The estimated On-Demand costs you expect with no additional # commitment, based on your usage of the selected time period and the # Savings Plans you own. # @return [String] @@ -6617,7 +6758,7 @@ class SavingsPlansPurchaseRecommendationDetail < Struct.new( # @return [String] # # @!attribute [rw] generation_timestamp - # The timestamp showing when the recommendations were generated. + # The timestamp that shows when the recommendations were generated. # @return [String] # # @!attribute [rw] additional_metadata @@ -6688,7 +6829,7 @@ class SavingsPlansPurchaseRecommendationMetadata < Struct.new( # @return [String] # # @!attribute [rw] estimated_on_demand_cost_with_current_commitment - # The estimated On-Demand costs you would expect with no additional + # The estimated On-Demand costs you expect with no additional # commitment. It's based on your usage of the selected time period # and the Savings Plans you own. # @return [String] @@ -6775,8 +6916,8 @@ class SavingsPlansUtilization < Struct.new( # @return [Types::SavingsPlansUtilization] # # @!attribute [rw] savings - # The amount saved by using existing Savings Plans. Savings returns - # both net savings from Savings Plans, as well as the + # The amount that's saved by using existing Savings Plans. Savings + # returns both net savings from Savings Plans and also the # `onDemandCostEquivalent` of the Savings Plans when considering the # utilization rate. # @return [Types::SavingsPlansSavings] @@ -6796,7 +6937,7 @@ class SavingsPlansUtilizationAggregates < Struct.new( include Aws::Structure end - # The amount of Savings Plans utilization, in hours. + # The amount of Savings Plans utilization (in hours). # # @!attribute [rw] time_period # The time period of the request. @@ -6808,8 +6949,8 @@ class SavingsPlansUtilizationAggregates < Struct.new( # @return [Types::SavingsPlansUtilization] # # @!attribute [rw] savings - # The amount saved by using existing Savings Plans. Savings returns - # both net savings from Savings Plans as well as the + # The amount that's saved by using existing Savings Plans. Savings + # returns both net savings from Savings Plans and also the # `onDemandCostEquivalent` of the Savings Plans when considering the # utilization rate. # @return [Types::SavingsPlansSavings] @@ -6830,7 +6971,7 @@ class SavingsPlansUtilizationByTime < Struct.new( include Aws::Structure end - # A single daily or monthly Savings Plans utilization rate, and details + # A single daily or monthly Savings Plans utilization rate and details # for your account. A management account in an organization have access # to member accounts. You can use `GetDimensionValues` to determine the # possible dimension values. @@ -6850,7 +6991,7 @@ class SavingsPlansUtilizationByTime < Struct.new( # # @!attribute [rw] savings # The amount saved by using existing Savings Plans. Savings returns - # both net savings from savings plans as well as the + # both net savings from savings plans and also the # `onDemandCostEquivalent` of the Savings Plans when considering the # utilization rate. # @return [Types::SavingsPlansSavings] @@ -6911,7 +7052,7 @@ class ServiceSpecification < Struct.new( include Aws::Structure end - # The details of how to sort the data. + # The details for how to sort the data. # # @note When making an API call, you may pass SortDefinition # data as a hash: @@ -7008,8 +7149,8 @@ class Subscriber < Struct.new( # # * The maximum length of a value is 256 characters # - # * Valid characters for keys and values are: `A-Z`, `a-z`, spaces, - # `_.:/=+-` + # * Keys and values can only contain alphanumeric characters, spaces, + # and any of the following: `_.:/=+@-` # # * Keys and values are case sensitive # @@ -7107,7 +7248,7 @@ class TagValues < Struct.new( # @return [Types::ResourceUtilization] # # @!attribute [rw] platform_differences - # Explains the actions you might need to take in order to successfully + # Explains the actions that you might need to take to successfully # migrate your workloads from the current instance type to the # recommended instance type. # @return [Array] @@ -7258,7 +7399,7 @@ class UnresolvableUsageUnitException < Struct.new( # # @!attribute [rw] resource_tag_keys # A list of tag keys associated with tags that need to be removed from - # the resource. If you specify a tag key that does not exist, it is + # the resource. If you specify a tag key that doesn't exist, it's # ignored. Although the maximum number of array members is 200, # user-tag maximum is 50. The remaining are reserved for Amazon Web # Services use. @@ -7382,6 +7523,70 @@ class UpdateAnomalySubscriptionResponse < Struct.new( include Aws::Structure end + # Gives a detailed description of the result of an action. It's on each + # cost allocation tag entry in the request. + # + # @!attribute [rw] tag_key + # The key for the cost allocation tag. + # @return [String] + # + # @!attribute [rw] code + # An error code representing why the action failed on this entry. + # @return [String] + # + # @!attribute [rw] message + # A message explaining why the action failed on this entry. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostAllocationTagsStatusError AWS API Documentation + # + class UpdateCostAllocationTagsStatusError < Struct.new( + :tag_key, + :code, + :message) + SENSITIVE = [] + include Aws::Structure + end + + # @note When making an API call, you may pass UpdateCostAllocationTagsStatusRequest + # data as a hash: + # + # { + # cost_allocation_tags_status: [ # required + # { + # tag_key: "TagKey", # required + # status: "Active", # required, accepts Active, Inactive + # }, + # ], + # } + # + # @!attribute [rw] cost_allocation_tags_status + # The list of `CostAllocationTagStatusEntry` objects that are used to + # update cost allocation tags status for this request. + # @return [Array] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostAllocationTagsStatusRequest AWS API Documentation + # + class UpdateCostAllocationTagsStatusRequest < Struct.new( + :cost_allocation_tags_status) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] errors + # A list of `UpdateCostAllocationTagsStatusError` objects with error + # details about each cost allocation tag that can't be updated. If + # there's no failure, an empty array returns. + # @return [Array] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostAllocationTagsStatusResponse AWS API Documentation + # + class UpdateCostAllocationTagsStatusResponse < Struct.new( + :errors) + SENSITIVE = [] + include Aws::Structure + end + # @note When making an API call, you may pass UpdateCostCategoryDefinitionRequest # data as a hash: #