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.
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.
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:
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, 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.
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/models/apis/ce/2017-10-25/api-2.json b/models/apis/ce/2017-10-25/api-2.json index f2897894137..fa628d361da 100644 --- a/models/apis/ce/2017-10-25/api-2.json +++ b/models/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/models/apis/ce/2017-10-25/docs-2.json b/models/apis/ce/2017-10-25/docs-2.json index 698aa5d3cc1..a1a4fc5b57b 100644 --- a/models/apis/ce/2017-10-25/docs-2.json +++ b/models/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.
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.
Retrieves all of the cost anomalies detected on your account during the time period that's specified by the DateInterval object.
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.
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.
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.
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:
AZ
CACHE_ENGINE
DATABASE_ENGINE
DEPLOYMENT_OPTION
INSTANCE_TYPE
LINKED_ACCOUNT
OPERATING_SYSTEM
PLATFORM
REGION
SERVICE
TAG
TENANCY
To determine valid values for a dimension, use the GetDimensionValues operation.
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.
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:
AZ
CACHE_ENGINE
DATABASE_ENGINE
DEPLOYMENT_OPTION
INSTANCE_TYPE
LINKED_ACCOUNT
OPERATING_SYSTEM
PLATFORM
REGION
SERVICE
TAG
TENANCY
To determine valid values for a dimension, use the GetDimensionValues operation.
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.
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.
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:
LINKED_ACCOUNT
REGION
SERVICE
INSTANCE_FAMILY
To determine valid values for a dimension, use the GetDimensionValues operation.
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.
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.
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.
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.
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.
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:
AZ - The Availability Zone. An example is us-east-1a.
BILLING_ENTITY - The Amazon Web Services seller that your account is with. Possible values are the following:
- Amazon Web Services(Amazon Web Services): The entity that sells Amazon Web Services services.
- AISPL (Amazon Internet Services Pvt. Ltd.): The local Indian entity that is an acting reseller for Amazon Web Services 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.
CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or Linux.
DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments. Valid values are SingleAZ and MultiAZ.
DATABASE_ENGINE - The Amazon Relational Database Service database. Examples are Aurora or MySQL.
INSTANCE_TYPE - The type of Amazon EC2 instance. An example is 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).
INVOICING_ENTITY - The name of the entity issuing 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.
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
OPERATING_SYSTEM - The operating system. Examples are Windows or Linux.
OPERATION - The action performed. Examples include RunInstance and CreateBucket.
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.
RESERVATION_ID - The unique identifier for an Amazon Web Services Reservation Instance.
SAVINGS_PLAN_ARN - The unique identifier for your Savings Plans.
SAVINGS_PLANS_TYPE - Type of Savings Plans (EC2 Instance or Compute).
SERVICE - The Amazon Web Services service such as Amazon DynamoDB.
TENANCY - The tenancy of a resource. Examples are shared or dedicated.
USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response for the GetDimensionValues operation includes a unit attribute. Examples include GB and Hrs.
USAGE_TYPE_GROUP - The grouping of common usage types. An example is Amazon EC2: CloudWatch – Alarms. The response for this operation includes a unit attribute.
REGION - The Amazon Web Services Region.
RECORD_TYPE - The different types of charges such as 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 Service.
If you set the context to RESERVATIONS, you can use the following dimensions for searching:
AZ - The Availability Zone. An example is us-east-1a.
CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or Linux.
DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments. Valid values are SingleAZ and MultiAZ.
INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge.
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
PLATFORM - The Amazon EC2 operating system. Examples are Windows or Linux.
REGION - The Amazon Web Services Region.
SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values are regional or a single Availability Zone.
TAG (Coverage only) - The tags that are associated with a Reserved Instance (RI).
TENANCY - The tenancy of a resource. Examples are shared or dedicated.
If you set the context to SAVINGS_PLANS, you can use the following dimensions for searching:
SAVINGS_PLANS_TYPE - Type of Savings Plans (EC2 Instance or Compute)
PAYMENT_OPTION - Payment option for the given Savings Plans (for example, All Upfront)
REGION - The Amazon Web Services Region.
INSTANCE_TYPE_FAMILY - The family of instances (For example, m5)
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
SAVINGS_PLAN_ARN - The unique identifier for your Savings Plans.
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:
AZ - The Availability Zone. An example is us-east-1a.
BILLING_ENTITY - The Amazon Web Services seller that your account is with. Possible values are the following:
- Amazon Web Services(Amazon Web Services): The entity that sells Amazon Web Services.
- AISPL (Amazon Internet Services Pvt. Ltd.): The local Indian entity that's an acting reseller for Amazon Web Services in India.
- Amazon Web Services Marketplace: The entity that supports the 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.
DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments. Valid values are SingleAZ and MultiAZ.
DATABASE_ENGINE - The Amazon Relational Database Service database. Examples are Aurora or MySQL.
INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge.
INSTANCE_TYPE_FAMILY - A family of instance types optimized to 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 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.
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
OPERATING_SYSTEM - The operating system. Examples are Windows or Linux.
OPERATION - The action performed. Examples include RunInstance and CreateBucket.
PLATFORM - The Amazon EC2 operating system. Examples are Windows or Linux.
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.
SAVINGS_PLAN_ARN - The unique identifier for your Savings Plans.
SAVINGS_PLANS_TYPE - Type of Savings Plans (EC2 Instance or Compute).
SERVICE - The Amazon Web Services service such as Amazon DynamoDB.
TENANCY - The tenancy of a resource. Examples are shared or dedicated.
USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response for the GetDimensionValues operation includes a unit attribute. Examples include GB and Hrs.
USAGE_TYPE_GROUP - The grouping of common usage types. An example is Amazon EC2: CloudWatch – Alarms. The response for this operation includes a unit attribute.
REGION - The Amazon Web Services Region.
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 Service.
If you set the context to RESERVATIONS, you can use the following dimensions for searching:
AZ - The Availability Zone. An example is us-east-1a.
CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or Linux.
DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments. Valid values are SingleAZ and MultiAZ.
INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge.
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
PLATFORM - The Amazon EC2 operating system. Examples are Windows or Linux.
REGION - The Amazon Web Services Region.
SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values are regional or a single Availability Zone.
TAG (Coverage only) - The tags that are associated with a Reserved Instance (RI).
TENANCY - The tenancy of a resource. Examples are shared or dedicated.
If you set the context to SAVINGS_PLANS, you can use the following dimensions for searching:
SAVINGS_PLANS_TYPE - Type of Savings Plans (EC2 Instance or Compute)
PAYMENT_OPTION - The payment option for the given Savings Plans (for example, All Upfront)
REGION - The Amazon Web Services Region.
INSTANCE_TYPE_FAMILY - The family of instances (For example, m5)
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
SAVINGS_PLAN_ARN - The unique identifier for your Savings Plans.
The cost allocation tag structure. This includes detailed metadata for the CostAllocationTag object.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
The Cost Category values.
If the CostCategoryName key isn't specified in the request, the CostCategoryValues fields aren't returned.
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.
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.
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.
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.
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.
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.
The start and end dates for retrieving the dimension values. The start date is inclusive, but the end date is exclusive. For example, if start is 2017-01-01 and end is 2017-05-01, then the cost and usage data is retrieved from 2017-01-01 up to and including 2017-04-30 but not including 2017-05-01.
The start 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.
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.
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:
AZ
CACHE_ENGINE
DEPLOYMENT_OPTION
INSTANCE_TYPE
LINKED_ACCOUNT
OPERATING_SYSTEM
PLATFORM
REGION
SERVICE
SCOPE
TENANCY
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.
Filters Savings Plans coverage data by dimensions. You can filter data for Savings Plans usage with the following dimensions:
LINKED_ACCOUNT
REGION
SERVICE
INSTANCE_FAMILY
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.
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.
Filters Savings Plans utilization coverage data for active Savings Plans dimensions. You can filter data with the following dimensions:
LINKED_ACCOUNT
SAVINGS_PLAN_ARN
REGION
PAYMENT_OPTION
INSTANCE_TYPE_FAMILY
GetSavingsPlansUtilizationDetails uses the same Expression object as the other operations, but only AND is supported among each dimension.
Filters Savings Plans utilization coverage data for active Savings Plans dimensions. You can filter data with the following dimensions:
LINKED_ACCOUNT
SAVINGS_PLAN_ARN
SAVINGS_PLANS_TYPE
REGION
PAYMENT_OPTION
INSTANCE_TYPE_FAMILY
GetSavingsPlansUtilization uses the same Expression object as the other operations, but only AND is supported among each dimension.
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\".
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.
The amortized amount of your Savings Plans commitment that was purchased with either a Partial or a NoUpfront.
The amortized amount of your Savings Plans commitment that was purchased with an Upfront or PartialUpfront Savings Plans.
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.
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.
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.
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.
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.
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.
The number of items to be returned in a response. The default is 20, with a minimum value of 1.
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.
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.
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.
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.
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.
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.
The measurement that you want your Savings Plans coverage reported in. The only valid value is SpendCoveredBySavingsPlans.
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).
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 .
The tag structure that contains a tag key and value.
Tagging is supported only for the following Cost Explorer resource types: AnomalyMonitor , AnomalySubscription , CostCategory .
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:
Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
The maximum length of a key is 128 characters
The maximum length of a value is 256 characters
Valid characters for keys and values are: A-Z, a-z, spaces, _.:/=+-
Keys and values are case sensitive
Keys and values are trimmed for any leading or trailing whitespaces
Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use
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:
Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
The maximum length of a key is 128 characters
The maximum length of a value is 256 characters
Valid characters for keys and values are: A-Z, a-z, spaces, _.:/=+-
Keys and values are case sensitive
Keys and values are trimmed for any leading or trailing whitespaces
Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use
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:
Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
The maximum length of a key is 128 characters
The maximum length of a value is 256 characters
Valid characters for keys and values are: A-Z, a-z, spaces, _.:/=+-
Keys and values are case sensitive
Keys and values are trimmed for any leading or trailing whitespaces
Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use
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:
Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
The maximum length of a key is 128 characters
The maximum length of a value is 256 characters
Valid characters for keys and values are: A-Z, a-z, spaces, _.:/=+-
Keys and values are case sensitive
Keys and values are trimmed for any leading or trailing whitespaces
Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use
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:
Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
The maximum length of a key is 128 characters
The maximum length of a value is 256 characters
Keys and values can only contain alphanumeric characters, spaces, and any of the following: _.:/=+@-
Keys and values are case sensitive
Keys and values are trimmed for any leading or trailing whitespaces
Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use
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:
Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
The maximum length of a key is 128 characters
The maximum length of a value is 256 characters
Keys and values can only contain alphanumeric characters, spaces, and any of the following: _.:/=+@-
Keys and values are case sensitive
Keys and values are trimmed for any leading or trailing whitespaces
Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use
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:
Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
The maximum length of a key is 128 characters
The maximum length of a value is 256 characters
Keys and values can only contain alphanumeric characters, spaces, and any of the following: _.:/=+@-
Keys and values are case sensitive
Keys and values are trimmed for any leading or trailing whitespaces
Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use
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:
Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for Amazon Web Services use
The maximum length of a key is 128 characters
The maximum length of a value is 256 characters
Keys and values can only contain alphanumeric characters, spaces, and any of the following: _.:/=+@-
Keys and values are case sensitive
Keys and values are trimmed for any leading or trailing whitespaces
Don’t use aws: as a prefix for your keys. This prefix is reserved for Amazon Web Services use
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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:
OnDemandCost
CoverageHoursPercentage
OnDemandHours
ReservedHours
TotalRunningHours
CoverageNormalizedUnitsPercentage
OnDemandNormalizedUnits
ReservedNormalizedUnits
TotalRunningNormalizedUnits
Time
Supported values for SortOrder are ASCENDING or DESCENDING.
The value by which you want to sort the data.
The following values are supported for Key:
UtilizationPercentage
UtilizationPercentageInUnits
PurchasedHours
PurchasedUnits
TotalActualHours
TotalActualUnits
UnusedHours
UnusedUnits
OnDemandCostOfRIHoursUsed
NetRISavings
TotalPotentialRISavings
AmortizedUpfrontFee
AmortizedRecurringFee
TotalAmortizedFee
RICostForUnusedHours
RealizedSavings
UnrealizedSavings
Supported values for SortOrder are ASCENDING or DESCENDING.
The value by which you want to sort the data.
The following values are supported for Key:
SpendCoveredBySavingsPlan
OnDemandCost
CoveragePercentage
TotalCost
InstanceFamily
Region
Service
Supported values for SortOrder are ASCENDING or DESCENDING.
The value by which you want to sort the data.
The following values are supported for Key:
UtilizationPercentage
TotalCommitment
UsedCommitment
UnusedCommitment
NetSavings
AmortizedRecurringCommitment
AmortizedUpfrontCommitment
Supported values for SortOrder are ASCENDING or DESCENDING.
The value by which you want to sort the data.
The following values are supported for Key:
UtilizationPercentage
TotalCommitment
UsedCommitment
UnusedCommitment
NetSavings
Supported values for SortOrder are ASCENDING or DESCENDING.
The value that you want to sort the data by.
The following values are supported for Key:
UtilizationPercentage
UtilizationPercentageInUnits
PurchasedHours
PurchasedUnits
TotalActualHours
TotalActualUnits
UnusedHours
UnusedUnits
OnDemandCostOfRIHoursUsed
NetRISavings
TotalPotentialRISavings
AmortizedUpfrontFee
AmortizedRecurringFee
TotalAmortizedFee
RICostForUnusedHours
RealizedSavings
UnrealizedSavings
The supported values for SortOrder are ASCENDING and DESCENDING.
The value that you want to sort the data by.
The following values are supported for Key:
SpendCoveredBySavingsPlan
OnDemandCost
CoveragePercentage
TotalCost
InstanceFamily
Region
Service
The supported values for SortOrder are ASCENDING and DESCENDING.
The value that you want to sort the data by.
The following values are supported for Key:
UtilizationPercentage
TotalCommitment
UsedCommitment
UnusedCommitment
NetSavings
AmortizedRecurringCommitment
AmortizedUpfrontCommitment
The supported values for SortOrder are ASCENDING and DESCENDING.
The value that you want to sort the data by.
The following values are supported for Key:
UtilizationPercentage
TotalCommitment
UsedCommitment
UnusedCommitment
NetSavings
The supported values for SortOrder are ASCENDING and DESCENDING.
The value by which you want to sort the data.
The key represents cost and usage metrics. The following values are supported:
BlendedCost
UnblendedCost
AmortizedCost
NetAmortizedCost
NetUnblendedCost
UsageQuantity
NormalizedUsageAmount
Supported values for SortOrder are ASCENDING or DESCENDING.
When using SortBy, NextPageToken and SearchString are not supported.
The value by which you want to sort the data.
The key represents cost and usage metrics. The following values are supported:
BlendedCost
UnblendedCost
AmortizedCost
NetAmortizedCost
NetUnblendedCost
UsageQuantity
NormalizedUsageAmount
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.
The value by which you want to sort the data.
The key represents cost and usage metrics. The following values are supported:
BlendedCost
UnblendedCost
AmortizedCost
NetAmortizedCost
NetUnblendedCost
UsageQuantity
NormalizedUsageAmount
Supported values for SortOrder are ASCENDING or DESCENDING.
When using SortBy, NextPageToken and SearchString are not supported.
The value that you sort the data by.
The key represents the cost and usage metrics. The following values are supported:
BlendedCost
UnblendedCost
AmortizedCost
NetAmortizedCost
NetUnblendedCost
UsageQuantity
NormalizedUsageAmount
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.
The value that you want to sort the data by.
The key represents cost and usage metrics. The following values are supported:
BlendedCost
UnblendedCost
AmortizedCost
NetAmortizedCost
NetUnblendedCost
UsageQuantity
NormalizedUsageAmount
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.
The value that you want to sort the data by.
The key represents cost and usage metrics. The following values are supported:
BlendedCost
UnblendedCost
AmortizedCost
NetAmortizedCost
NetUnblendedCost
UsageQuantity
NormalizedUsageAmount
The supported values for SortOrder are ASCENDING and DESCENDING.
When you use SortBy, NextPageToken and SearchString aren't supported.
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.
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/models/apis/ce/2017-10-25/paginators-1.json b/models/apis/ce/2017-10-25/paginators-1.json index 431b8e5dc52..1b58ad8f0e2 100644 --- a/models/apis/ce/2017-10-25/paginators-1.json +++ b/models/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/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index 70f5b1c2872..5c211e04521 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -1797,6 +1797,11 @@ "isRegionalized" : false, "partitionEndpoint" : "aws-global" }, + "catalog.marketplace" : { + "endpoints" : { + "us-east-1" : { } + } + }, "ce" : { "endpoints" : { "aws-global" : { diff --git a/service/auditmanager/api.go b/service/auditmanager/api.go index 1dae80cffea..7e2f021a684 100644 --- a/service/auditmanager/api.go +++ b/service/auditmanager/api.go @@ -3403,8 +3403,7 @@ func (c *AuditManager) GetServicesInScopeRequest(input *GetServicesInScopeInput) // GetServicesInScope API operation for AWS Audit Manager. // -// 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. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -5316,6 +5315,9 @@ func (c *AuditManager) RegisterAccountRequest(input *RegisterAccountInput) (req // * ResourceNotFoundException // The resource that's specified in the request can't be found. // +// * ThrottlingException +// The request was denied due to request throttling. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/auditmanager-2017-07-25/RegisterAccount func (c *AuditManager) RegisterAccount(input *RegisterAccountInput) (*RegisterAccountOutput, error) { req, out := c.RegisterAccountRequest(input) @@ -5479,6 +5481,31 @@ func (c *AuditManager) StartAssessmentFrameworkShareRequest(input *StartAssessme // 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 (https://docs.aws.amazon.com/audit-manager/latest/userguide/framework-sharing.html#framework-sharing-resend), +// 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 @@ -7007,7 +7034,7 @@ type AssessmentEvidenceFolder struct { // 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. + // Services such as Amazon EC2, Amazon S3, or IAM. EvidenceByTypeConfigurationDataCount *int64 `locationName:"evidenceByTypeConfigurationDataCount" type:"integer"` // The number of evidence that falls under the manual category. This evidence @@ -15388,7 +15415,9 @@ type Role struct { _ struct{} `type:"structure"` // The Amazon Resource Name (ARN) of the IAM role. - RoleArn *string `locationName:"roleArn" min:"20" type:"string"` + // + // RoleArn is a required field + RoleArn *string `locationName:"roleArn" min:"20" type:"string" required:"true"` // The type of customer persona. // @@ -15397,7 +15426,9 @@ type Role struct { // In UpdateSettings, roleType can only be PROCESS_OWNER. // // In BatchCreateDelegationByAssessment, roleType can only be RESOURCE_OWNER. - RoleType *string `locationName:"roleType" type:"string" enum:"RoleType"` + // + // RoleType is a required field + RoleType *string `locationName:"roleType" type:"string" required:"true" enum:"RoleType"` } // String returns the string representation. @@ -15421,9 +15452,15 @@ func (s Role) GoString() string { // Validate inspects the fields of the type to determine if they are valid. func (s *Role) Validate() error { invalidParams := request.ErrInvalidParams{Context: "Role"} + if s.RoleArn == nil { + invalidParams.Add(request.NewErrParamRequired("RoleArn")) + } if s.RoleArn != nil && len(*s.RoleArn) < 20 { invalidParams.Add(request.NewErrParamMinLen("RoleArn", 20)) } + if s.RoleType == nil { + invalidParams.Add(request.NewErrParamRequired("RoleType")) + } if invalidParams.Len() > 0 { return invalidParams @@ -15928,6 +15965,70 @@ func (s TagResourceOutput) GoString() string { return s.String() } +// The request was denied due to request throttling. +type ThrottlingException struct { + _ struct{} `type:"structure"` + RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` + + Message_ *string `locationName:"message" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ThrottlingException) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ThrottlingException) GoString() string { + return s.String() +} + +func newErrorThrottlingException(v protocol.ResponseMetadata) error { + return &ThrottlingException{ + RespMetadata: v, + } +} + +// Code returns the exception type name. +func (s *ThrottlingException) Code() string { + return "ThrottlingException" +} + +// Message returns the exception's message. +func (s *ThrottlingException) Message() string { + if s.Message_ != nil { + return *s.Message_ + } + return "" +} + +// OrigErr always returns nil, satisfies awserr.Error interface. +func (s *ThrottlingException) OrigErr() error { + return nil +} + +func (s *ThrottlingException) Error() string { + return fmt.Sprintf("%s: %s", s.Code(), s.Message()) +} + +// Status code returns the HTTP status code for the request's response error. +func (s *ThrottlingException) StatusCode() int { + return s.RespMetadata.StatusCode +} + +// RequestID returns the service's response RequestID for request. +func (s *ThrottlingException) RequestID() string { + return s.RespMetadata.RequestID +} + // Short for uniform resource locator. A URL is used as a unique identifier // to locate a resource on the internet. type URL struct { diff --git a/service/auditmanager/errors.go b/service/auditmanager/errors.go index ece71ff4fb8..95c1ef26844 100644 --- a/service/auditmanager/errors.go +++ b/service/auditmanager/errors.go @@ -28,6 +28,12 @@ const ( // The resource that's specified in the request can't be found. ErrCodeResourceNotFoundException = "ResourceNotFoundException" + // ErrCodeThrottlingException for service response error code + // "ThrottlingException". + // + // The request was denied due to request throttling. + ErrCodeThrottlingException = "ThrottlingException" + // ErrCodeValidationException for service response error code // "ValidationException". // @@ -39,5 +45,6 @@ var exceptionFromCode = map[string]func(protocol.ResponseMetadata) error{ "AccessDeniedException": newErrorAccessDeniedException, "InternalServerException": newErrorInternalServerException, "ResourceNotFoundException": newErrorResourceNotFoundException, + "ThrottlingException": newErrorThrottlingException, "ValidationException": newErrorValidationException, } diff --git a/service/costexplorer/api.go b/service/costexplorer/api.go index b4e4b1d7fb6..62156fa596c 100644 --- a/service/costexplorer/api.go +++ b/service/costexplorer/api.go @@ -553,13 +553,13 @@ func (c *CostExplorer) DescribeCostCategoryDefinitionRequest(input *DescribeCost // DescribeCostCategoryDefinition API operation for AWS Cost Explorer Service. // -// 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 date. If Cost Category -// is still effective, EffectiveEnd is omitted in the response. +// 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. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1008,8 +1008,8 @@ func (c *CostExplorer) GetCostAndUsageWithResourcesRequest(input *GetCostAndUsag // Compute Cloud – Compute service only. // // This is an opt-in only feature. You can enable this feature from the Cost -// Explorer Settings page. For information on how to access the Settings page, -// see Controlling Access for Cost Explorer (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/ce-access.html) +// Explorer Settings page. For information about how to access the Settings +// page, see Controlling Access for Cost Explorer (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/ce-access.html) // in the Billing and Cost Management User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -1373,7 +1373,7 @@ func (c *CostExplorer) GetReservationCoverageRequest(input *GetReservationCovera // GetReservationCoverage API operation for AWS Cost Explorer Service. // -// Retrieves the reservation coverage for your account. This enables you to +// 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 @@ -1490,26 +1490,26 @@ func (c *CostExplorer) GetReservationPurchaseRecommendationRequest(input *GetRes // GetReservationPurchaseRecommendation API operation for AWS Cost Explorer Service. // -// 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. +// 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 -// 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. +// 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. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -1686,8 +1686,9 @@ func (c *CostExplorer) GetRightsizingRecommendationRequest(input *GetRightsizing // 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 (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/ce-rightsizing.html) +// along with providing savings detail and metrics. For more information about +// calculation and function, see Optimizing Your Cost with Rightsizing Recommendations +// (https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/ce-rightsizing.html) // in the Billing and Cost Management User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -2016,7 +2017,7 @@ func (c *CostExplorer) GetSavingsPlansUtilizationRequest(input *GetSavingsPlansU // 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. +// You can't group by any dimension values for GetSavingsPlansUtilization. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2385,6 +2386,147 @@ func (c *CostExplorer) GetUsageForecastWithContext(ctx aws.Context, input *GetUs return out, req.Send() } +const opListCostAllocationTags = "ListCostAllocationTags" + +// ListCostAllocationTagsRequest generates a "aws/request.Request" representing the +// client's request for the ListCostAllocationTags operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See ListCostAllocationTags for more information on using the ListCostAllocationTags +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the ListCostAllocationTagsRequest method. +// req, resp := client.ListCostAllocationTagsRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostAllocationTags +func (c *CostExplorer) ListCostAllocationTagsRequest(input *ListCostAllocationTagsInput) (req *request.Request, output *ListCostAllocationTagsOutput) { + op := &request.Operation{ + Name: opListCostAllocationTags, + HTTPMethod: "POST", + HTTPPath: "/", + Paginator: &request.Paginator{ + InputTokens: []string{"NextToken"}, + OutputTokens: []string{"NextToken"}, + LimitToken: "MaxResults", + TruncationToken: "", + }, + } + + if input == nil { + input = &ListCostAllocationTagsInput{} + } + + output = &ListCostAllocationTagsOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListCostAllocationTags API operation for AWS Cost Explorer Service. +// +// 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. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for AWS Cost Explorer Service's +// API operation ListCostAllocationTags for usage and error information. +// +// Returned Error Types: +// * LimitExceededException +// You made too many calls in a short period of time. Try again later. +// +// * InvalidNextTokenException +// The pagination token is invalid. Try again without a pagination token. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostAllocationTags +func (c *CostExplorer) ListCostAllocationTags(input *ListCostAllocationTagsInput) (*ListCostAllocationTagsOutput, error) { + req, out := c.ListCostAllocationTagsRequest(input) + return out, req.Send() +} + +// ListCostAllocationTagsWithContext is the same as ListCostAllocationTags with the addition of +// the ability to pass a context and additional request options. +// +// See ListCostAllocationTags for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *CostExplorer) ListCostAllocationTagsWithContext(ctx aws.Context, input *ListCostAllocationTagsInput, opts ...request.Option) (*ListCostAllocationTagsOutput, error) { + req, out := c.ListCostAllocationTagsRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// ListCostAllocationTagsPages iterates over the pages of a ListCostAllocationTags operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListCostAllocationTags method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListCostAllocationTags operation. +// pageNum := 0 +// err := client.ListCostAllocationTagsPages(params, +// func(page *costexplorer.ListCostAllocationTagsOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *CostExplorer) ListCostAllocationTagsPages(input *ListCostAllocationTagsInput, fn func(*ListCostAllocationTagsOutput, bool) bool) error { + return c.ListCostAllocationTagsPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListCostAllocationTagsPagesWithContext same as ListCostAllocationTagsPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *CostExplorer) ListCostAllocationTagsPagesWithContext(ctx aws.Context, input *ListCostAllocationTagsInput, fn func(*ListCostAllocationTagsOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListCostAllocationTagsInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListCostAllocationTagsRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + for p.Next() { + if !fn(p.Page().(*ListCostAllocationTagsOutput), !p.HasNextPage()) { + break + } + } + + return p.Err() +} + const opListCostCategoryDefinitions = "ListCostCategoryDefinitions" // ListCostCategoryDefinitionsRequest generates a "aws/request.Request" representing the @@ -2435,13 +2577,13 @@ func (c *CostExplorer) ListCostCategoryDefinitionsRequest(input *ListCostCategor // ListCostCategoryDefinitions API operation for AWS Cost Explorer Service. // -// 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. +// 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. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2831,8 +2973,8 @@ func (c *CostExplorer) UntagResourceRequest(input *UntagResourceInput) (req *req // UntagResource API operation for AWS Cost Explorer Service. // -// 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. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3038,6 +3180,88 @@ func (c *CostExplorer) UpdateAnomalySubscriptionWithContext(ctx aws.Context, inp return out, req.Send() } +const opUpdateCostAllocationTagsStatus = "UpdateCostAllocationTagsStatus" + +// UpdateCostAllocationTagsStatusRequest generates a "aws/request.Request" representing the +// client's request for the UpdateCostAllocationTagsStatus operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See UpdateCostAllocationTagsStatus for more information on using the UpdateCostAllocationTagsStatus +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the UpdateCostAllocationTagsStatusRequest method. +// req, resp := client.UpdateCostAllocationTagsStatusRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostAllocationTagsStatus +func (c *CostExplorer) UpdateCostAllocationTagsStatusRequest(input *UpdateCostAllocationTagsStatusInput) (req *request.Request, output *UpdateCostAllocationTagsStatusOutput) { + op := &request.Operation{ + Name: opUpdateCostAllocationTagsStatus, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &UpdateCostAllocationTagsStatusInput{} + } + + output = &UpdateCostAllocationTagsStatusOutput{} + req = c.newRequest(op, input, output) + return +} + +// UpdateCostAllocationTagsStatus API operation for AWS Cost Explorer Service. +// +// 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). +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for AWS Cost Explorer Service's +// API operation UpdateCostAllocationTagsStatus for usage and error information. +// +// Returned Error Types: +// * LimitExceededException +// You made too many calls in a short period of time. Try again later. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostAllocationTagsStatus +func (c *CostExplorer) UpdateCostAllocationTagsStatus(input *UpdateCostAllocationTagsStatusInput) (*UpdateCostAllocationTagsStatusOutput, error) { + req, out := c.UpdateCostAllocationTagsStatusRequest(input) + return out, req.Send() +} + +// UpdateCostAllocationTagsStatusWithContext is the same as UpdateCostAllocationTagsStatus with the addition of +// the ability to pass a context and additional request options. +// +// See UpdateCostAllocationTagsStatus for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *CostExplorer) UpdateCostAllocationTagsStatusWithContext(ctx aws.Context, input *UpdateCostAllocationTagsStatusInput, opts ...request.Option) (*UpdateCostAllocationTagsStatusOutput, error) { + req, out := c.UpdateCostAllocationTagsStatusRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opUpdateCostCategoryDefinition = "UpdateCostCategoryDefinition" // UpdateCostCategoryDefinitionRequest generates a "aws/request.Request" representing the @@ -3147,8 +3371,8 @@ type Anomaly struct { // The first day the anomaly is detected. AnomalyStartDate *string `type:"string"` - // 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). DimensionValue *string `type:"string"` // The feedback value. @@ -3702,6 +3926,129 @@ func (s *BillExpirationException) RequestID() string { return s.RespMetadata.RequestID } +// The cost allocation tag structure. This includes detailed metadata for the +// CostAllocationTag object. +type CostAllocationTag struct { + _ struct{} `type:"structure"` + + // The status of a cost allocation tag. + // + // Status is a required field + Status *string `type:"string" required:"true" enum:"CostAllocationTagStatus"` + + // The key for the cost allocation tag. + // + // TagKey is a required field + TagKey *string `type:"string" required:"true"` + + // 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. + // + // Type is a required field + Type *string `type:"string" required:"true" enum:"CostAllocationTagType"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CostAllocationTag) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CostAllocationTag) GoString() string { + return s.String() +} + +// SetStatus sets the Status field's value. +func (s *CostAllocationTag) SetStatus(v string) *CostAllocationTag { + s.Status = &v + return s +} + +// SetTagKey sets the TagKey field's value. +func (s *CostAllocationTag) SetTagKey(v string) *CostAllocationTag { + s.TagKey = &v + return s +} + +// SetType sets the Type field's value. +func (s *CostAllocationTag) SetType(v string) *CostAllocationTag { + s.Type = &v + return s +} + +// The cost allocation tag status. The status of a key can either be active +// or inactive. +type CostAllocationTagStatusEntry struct { + _ struct{} `type:"structure"` + + // The status of a cost allocation tag. + // + // Status is a required field + Status *string `type:"string" required:"true" enum:"CostAllocationTagStatus"` + + // The key for the cost allocation tag. + // + // TagKey is a required field + TagKey *string `type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CostAllocationTagStatusEntry) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s CostAllocationTagStatusEntry) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CostAllocationTagStatusEntry) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CostAllocationTagStatusEntry"} + if s.Status == nil { + invalidParams.Add(request.NewErrParamRequired("Status")) + } + if s.TagKey == nil { + invalidParams.Add(request.NewErrParamRequired("TagKey")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetStatus sets the Status field's value. +func (s *CostAllocationTagStatusEntry) SetStatus(v string) *CostAllocationTagStatusEntry { + s.Status = &v + return s +} + +// SetTagKey sets the TagKey field's value. +func (s *CostAllocationTagStatusEntry) SetTagKey(v string) *CostAllocationTagStatusEntry { + s.TagKey = &v + return s +} + // The structure of Cost Categories. This includes detailed metadata and the // set of rules for the CostCategory object. type CostCategory struct { @@ -3821,13 +4168,13 @@ func (s *CostCategory) SetSplitChargeRules(v []*CostCategorySplitChargeRule) *Co return s } -// When creating or updating a cost category, you can define the CostCategoryRule -// rule type as INHERITED_VALUE. This rule type adds the flexibility of defining +// 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 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. +// 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. type CostCategoryInheritedValueDimension struct { _ struct{} `type:"structure"` @@ -3837,8 +4184,8 @@ type CostCategoryInheritedValueDimension struct { // 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. + // name. If you specify TAG, the cost category value is based on the value of + // the specified tag key. DimensionName *string `type:"string" enum:"CostCategoryInheritedValueDimensionName"` } @@ -4040,12 +4387,12 @@ type CostCategoryRule struct { Rule *Expression `type:"structure"` // You can define the CostCategoryRule rule type as either REGULAR or INHERITED_VALUE. - // The INHERITED_VALUE rule type adds the flexibility of defining a rule that - // dynamically inherits the cost category value from the dimension value defined - // by CostCategoryInheritedValueDimension. For example, if you 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. + // 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. Type *string `type:"string" enum:"CostCategoryRuleType"` // The default value for the cost category. @@ -4648,7 +4995,8 @@ type CreateAnomalyMonitorInput struct { // // * 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 // @@ -4774,7 +5122,8 @@ type CreateAnomalySubscriptionInput struct { // // * 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 // @@ -4902,7 +5251,8 @@ type CreateCostCategoryDefinitionInput struct { // // * 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 // @@ -5531,7 +5881,7 @@ type DeleteCostCategoryDefinitionOutput struct { CostCategoryArn *string `min:"20" type:"string"` // 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. + // costs after this date is categorized by the deleted Cost Category. EffectiveEnd *string `min:"20" type:"string"` } @@ -6078,7 +6428,7 @@ func (s *EC2ResourceDetails) SetVcpu(v string) *EC2ResourceDetails { return s } -// Utilization metrics of the instance. +// Utilization metrics for the instance. type EC2ResourceUtilization struct { _ struct{} `type:"structure"` @@ -7144,7 +7494,7 @@ type GetCostAndUsageWithResourcesInput struct { // 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, + // (for example, hour or GB). To get more meaningful UsageQuantity metrics, // filter by UsageType or UsageTypeGroups. // // Metrics is required for GetCostAndUsageWithResources requests. @@ -7265,7 +7615,7 @@ type GetCostAndUsageWithResourcesOutput struct { // maximum page size. NextPageToken *string `type:"string"` - // The time period that is covered by the results in the response. + // The time period that's covered by the results in the response. ResultsByTime []*ResultByTime `type:"list"` } @@ -7352,32 +7702,32 @@ type GetCostCategoriesInput struct { // AND and OR aren't supported. Dimensions are limited to LINKED_ACCOUNT. Filter *Expression `type:"structure"` - // This field is only used when SortBy is provided in the request. + // 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. MaxResults *int64 `min:"1" type:"integer"` // If the number of objects that are still available for retrieval exceeds the - // limit, Amazon Web Services returns a NextPageToken value in the response. + // 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. + // previous call in your next request. NextPageToken *string `type:"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. SearchString *string `type:"string"` - // 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 // @@ -7393,9 +7743,10 @@ type GetCostCategoriesInput struct { // // * 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. SortBy []*SortDefinition `type:"list"` // The time period of the request. @@ -7511,17 +7862,17 @@ type GetCostCategoriesOutput struct { // 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. CostCategoryValues []*string `type:"list"` // If the number of objects that are still available for retrieval exceeds the - // limit, Amazon Web Services returns a NextPageToken value in the response. + // 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. NextPageToken *string `type:"string"` - // The number of objects returned. + // The number of objects that are returned. // // ReturnSize is a required field ReturnSize *int64 `type:"integer" required:"true"` @@ -7811,11 +8162,11 @@ type GetDimensionValuesInput struct { // // * BILLING_ENTITY - The Amazon Web Services seller that your account is // with. Possible values are the following: - Amazon Web Services(Amazon - // Web Services): The entity that sells Amazon Web Services services. - AISPL - // (Amazon Internet Services Pvt. Ltd.): The local Indian entity that is - // an acting reseller for Amazon Web Services 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. + // Web Services): The entity that sells Amazon Web Services. - AISPL (Amazon + // Internet Services Pvt. Ltd.): The local Indian entity that's an acting + // reseller for Amazon Web Services in India. - Amazon Web Services Marketplace: + // The entity that supports the 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. @@ -7829,11 +8180,11 @@ type GetDimensionValuesInput struct { // * INSTANCE_TYPE - The type of Amazon EC2 instance. An example is 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). + // 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. @@ -7849,8 +8200,8 @@ type GetDimensionValuesInput struct { // * 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 + // * 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 @@ -7874,8 +8225,8 @@ type GetDimensionValuesInput struct { // // * 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 Service. @@ -7915,8 +8266,8 @@ type GetDimensionValuesInput struct { // // * 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. // @@ -7971,9 +8322,9 @@ type GetDimensionValuesInput struct { Filter *Expression `type:"structure"` // 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. + // 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. MaxResults *int64 `min:"1" type:"integer"` @@ -7986,7 +8337,7 @@ type GetDimensionValuesInput struct { // The value that you want to search the filter values for. SearchString *string `type:"string"` - // 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: // @@ -8004,10 +8355,10 @@ type GetDimensionValuesInput struct { // // * 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. + // Further, when using SortBy, NextPageToken and SearchString aren't supported. SortBy []*SortDefinition `type:"list"` // The start date and end date for retrieving the dimension values. The start @@ -8564,7 +8915,7 @@ func (s *GetReservationCoverageOutput) SetTotal(v *Coverage) *GetReservationCove type GetReservationPurchaseRecommendationInput struct { _ struct{} `type:"structure"` - // The account ID that is associated with the recommendation. + // The account ID that's associated with the recommendation. AccountId *string `type:"string"` // The account scope that you want your recommendations for. Amazon Web Services @@ -8836,7 +9187,7 @@ type GetReservationUtilizationInput struct { // maximum page size. NextPageToken *string `type:"string"` - // 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: // @@ -8874,13 +9225,14 @@ type GetReservationUtilizationInput struct { // // * UnrealizedSavings // - // Supported values for SortOrder are ASCENDING or DESCENDING. + // The supported values for SortOrder are ASCENDING and DESCENDING. SortBy *SortDefinition `type:"structure"` - // 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. // // TimePeriod is a required field TimePeriod *DateInterval `type:"structure" required:"true"` @@ -8985,10 +9337,10 @@ type GetReservationUtilizationOutput struct { // maximum page size. NextPageToken *string `type:"string"` - // The total amount of time that you used your RIs. + // The total amount of time that you used your Reserved Instances (RIs). Total *ReservationAggregates `type:"structure"` - // The amount of time that you used your RIs. + // The amount of time that you used your Reserved Instances (RIs). // // UtilizationsByTime is a required field UtilizationsByTime []*UtilizationByTime `type:"list" required:"true"` @@ -9033,11 +9385,11 @@ func (s *GetReservationUtilizationOutput) SetUtilizationsByTime(v []*Utilization type GetRightsizingRecommendationInput struct { _ struct{} `type:"structure"` - // 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. Configuration *RightsizingRecommendationConfiguration `type:"structure"` // Use Expression to filter by cost or by usage. There are two patterns: @@ -9164,11 +9516,11 @@ func (s *GetRightsizingRecommendationInput) SetService(v string) *GetRightsizing type GetRightsizingRecommendationOutput struct { _ struct{} `type:"structure"` - // 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. Configuration *RightsizingRecommendationConfiguration `type:"structure"` // Information regarding this specific recommendation set. @@ -9275,7 +9627,7 @@ type GetSavingsPlansCoverageInput struct { // maximum page size. NextToken *string `type:"string"` - // 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: // @@ -9293,7 +9645,7 @@ type GetSavingsPlansCoverageInput struct { // // * Service // - // Supported values for SortOrder are ASCENDING or DESCENDING. + // The supported values for SortOrder are ASCENDING and DESCENDING. SortBy *SortDefinition `type:"structure"` // The time period that you want the usage and costs for. The Start date must @@ -9456,17 +9808,17 @@ type GetSavingsPlansPurchaseRecommendationInput struct { // 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. + // and Value as the comma-separated Acount ID(s) that you want to see Savings + // Plans purchase recommendations for. // - // For GetSavingsPlansPurchaseRecommendation, the Filter does not include CostCategories + // 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 + // IDs that you want to see Savings Plans Purchase Recommendations for. AND // and OR operators are not supported. Filter *Expression `type:"structure"` - // The lookback period used to generate the recommendation. + // The lookback period that's used to generate the recommendation. // // LookbackPeriodInDays is a required field LookbackPeriodInDays *string `type:"string" required:"true" enum:"LookbackPeriodInDays"` @@ -9480,17 +9832,17 @@ type GetSavingsPlansPurchaseRecommendationInput struct { // object. PageSize *int64 `type:"integer"` - // The payment option used to generate these recommendations. + // The payment option that's used to generate these recommendations. // // PaymentOption is a required field PaymentOption *string `type:"string" required:"true" enum:"PaymentOption"` - // The Savings Plans recommendation type requested. + // The Savings Plans recommendation type that's requested. // // SavingsPlansType is a required field SavingsPlansType *string `type:"string" required:"true" enum:"SupportedSavingsPlansType"` - // The savings plan recommendation term used to generate these recommendations. + // The savings plan recommendation term that's used to generate these recommendations. // // TermInYears is a required field TermInYears *string `type:"string" required:"true" enum:"TermInYears"` @@ -9592,7 +9944,7 @@ func (s *GetSavingsPlansPurchaseRecommendationInput) SetTermInYears(v string) *G type GetSavingsPlansPurchaseRecommendationOutput struct { _ struct{} `type:"structure"` - // Information regarding this specific recommendation set. + // Information that regards this specific recommendation set. Metadata *SavingsPlansPurchaseRecommendationMetadata `type:"structure"` // The token for the next set of retrievable results. Amazon Web Services provides @@ -9673,7 +10025,7 @@ type GetSavingsPlansUtilizationDetailsInput struct { // maximum page size. NextToken *string `type:"string"` - // 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: // @@ -9691,7 +10043,7 @@ type GetSavingsPlansUtilizationDetailsInput struct { // // * AmortizedUpfrontCommitment // - // Supported values for SortOrder are ASCENDING or DESCENDING. + // The supported values for SortOrder are ASCENDING and DESCENDING. SortBy *SortDefinition `type:"structure"` // The time period that you want the usage and costs for. The Start date must @@ -9881,7 +10233,7 @@ type GetSavingsPlansUtilizationInput struct { // granularities. Granularity *string `type:"string" enum:"Granularity"` - // 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: // @@ -9895,7 +10247,7 @@ type GetSavingsPlansUtilizationInput struct { // // * NetSavings // - // Supported values for SortOrder are ASCENDING or DESCENDING. + // The supported values for SortOrder are ASCENDING and DESCENDING. SortBy *SortDefinition `type:"structure"` // The time period that you want the usage and costs for. The Start date must @@ -9979,8 +10331,8 @@ func (s *GetSavingsPlansUtilizationInput) SetTimePeriod(v *DateInterval) *GetSav type GetSavingsPlansUtilizationOutput struct { _ struct{} `type:"structure"` - // 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. SavingsPlansUtilizationsByTime []*SavingsPlansUtilizationByTime `type:"list"` // The total amount of cost/commitment that you used your Savings Plans, regardless @@ -10059,11 +10411,11 @@ type GetTagsInput struct { Filter *Expression `type:"structure"` // 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. + // 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. MaxResults *int64 `min:"1" type:"integer"` // The token to retrieve the next set of results. Amazon Web Services provides @@ -10074,7 +10426,7 @@ type GetTagsInput struct { // The value that you want to search for. SearchString *string `type:"string"` - // 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: // @@ -10092,9 +10444,9 @@ type GetTagsInput struct { // // * 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 supported. + // When you use SortBy, NextPageToken and SearchString aren't supported. SortBy []*SortDefinition `type:"list"` // The key of the tag that you want to return values for. @@ -10343,19 +10695,19 @@ type GetUsageForecastInput struct { // Metric is a required field Metric *string `type:"string" required:"true" enum:"Metric"` - // 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. PredictionIntervalLevel *int64 `min:"51" type:"integer"` // 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. + // 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. // // TimePeriod is a required field TimePeriod *DateInterval `type:"structure" required:"true"` @@ -10807,6 +11159,139 @@ func (s *LimitExceededException) RequestID() string { return s.RespMetadata.RequestID } +type ListCostAllocationTagsInput struct { + _ struct{} `type:"structure"` + + // The maximum number of objects that are returned for this request. By default, + // the request returns 100 results. + MaxResults *int64 `min:"1" type:"integer"` + + // 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. + NextToken *string `type:"string"` + + // The status of cost allocation tag keys that are returned for this request. + Status *string `type:"string" enum:"CostAllocationTagStatus"` + + // The list of cost allocation tag keys that are returned for this request. + TagKeys []*string `min:"1" type:"list"` + + // 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. + Type *string `type:"string" enum:"CostAllocationTagType"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListCostAllocationTagsInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListCostAllocationTagsInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ListCostAllocationTagsInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ListCostAllocationTagsInput"} + if s.MaxResults != nil && *s.MaxResults < 1 { + invalidParams.Add(request.NewErrParamMinValue("MaxResults", 1)) + } + if s.TagKeys != nil && len(s.TagKeys) < 1 { + invalidParams.Add(request.NewErrParamMinLen("TagKeys", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetMaxResults sets the MaxResults field's value. +func (s *ListCostAllocationTagsInput) SetMaxResults(v int64) *ListCostAllocationTagsInput { + s.MaxResults = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListCostAllocationTagsInput) SetNextToken(v string) *ListCostAllocationTagsInput { + s.NextToken = &v + return s +} + +// SetStatus sets the Status field's value. +func (s *ListCostAllocationTagsInput) SetStatus(v string) *ListCostAllocationTagsInput { + s.Status = &v + return s +} + +// SetTagKeys sets the TagKeys field's value. +func (s *ListCostAllocationTagsInput) SetTagKeys(v []*string) *ListCostAllocationTagsInput { + s.TagKeys = v + return s +} + +// SetType sets the Type field's value. +func (s *ListCostAllocationTagsInput) SetType(v string) *ListCostAllocationTagsInput { + s.Type = &v + return s +} + +type ListCostAllocationTagsOutput struct { + _ struct{} `type:"structure"` + + // A list of cost allocation tags that includes the detailed metadata for each + // one. + CostAllocationTags []*CostAllocationTag `type:"list"` + + // 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. + NextToken *string `type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListCostAllocationTagsOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListCostAllocationTagsOutput) GoString() string { + return s.String() +} + +// SetCostAllocationTags sets the CostAllocationTags field's value. +func (s *ListCostAllocationTagsOutput) SetCostAllocationTags(v []*CostAllocationTag) *ListCostAllocationTagsOutput { + s.CostAllocationTags = v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListCostAllocationTagsOutput) SetNextToken(v string) *ListCostAllocationTagsOutput { + s.NextToken = &v + return s +} + type ListCostCategoryDefinitionsInput struct { _ struct{} `type:"structure"` @@ -10877,7 +11362,7 @@ func (s *ListCostCategoryDefinitionsInput) SetNextToken(v string) *ListCostCateg type ListCostCategoryDefinitionsOutput struct { _ struct{} `type:"structure"` - // A reference to a Cost Category containing enough information to identify + // A reference to a Cost Category that contains enough information to identify // the Cost Category. CostCategoryReferences []*CostCategoryReference `type:"list"` @@ -10970,7 +11455,7 @@ func (s *ListTagsForResourceInput) SetResourceArn(v string) *ListTagsForResource type ListTagsForResourceOutput struct { _ struct{} `type:"structure"` - // 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. ResourceTags []*ResourceTag `type:"list"` } @@ -11039,7 +11524,7 @@ func (s *MetricValue) SetUnit(v string) *MetricValue { return s } -// Details on the modification recommendation. +// Details for the modification recommendation. type ModifyRecommendationDetail struct { _ struct{} `type:"structure"` @@ -11077,16 +11562,17 @@ func (s *ModifyRecommendationDetail) SetTargetInstances(v []*TargetInstance) *Mo type NetworkResourceUtilization struct { _ struct{} `type:"structure"` - // The network inbound throughput utilization measured in Bytes per second. + // The network inbound throughput utilization measured in Bytes per second (Bps). NetworkInBytesPerSecond *string `type:"string"` - // The network outbound throughput utilization measured in Bytes per second. + // The network outbound throughput utilization measured in Bytes per second + // (Bps). NetworkOutBytesPerSecond *string `type:"string"` - // The network ingress packets that are measured in packets per second. + // The network inbound packets that are measured in packets per second. NetworkPacketsInPerSecond *string `type:"string"` - // The network outgress packets that are measured in packets per second. + // The network outbound packets that are measured in packets per second. NetworkPacketsOutPerSecond *string `type:"string"` } @@ -11787,7 +12273,7 @@ func (s *ReservationPurchaseRecommendation) SetTermInYears(v string) *Reservatio type ReservationPurchaseRecommendationDetail struct { _ struct{} `type:"structure"` - // The account that this RI recommendation is for. + // The account that this Reserved Instance (RI) recommendation is for. AccountId *string `type:"string"` // The average number of normalized units that you used in an hour during the @@ -11817,15 +12303,15 @@ type ReservationPurchaseRecommendationDetail struct { EstimatedMonthlyOnDemandCost *string `type:"string"` // How much Amazon Web Services estimates that this specific recommendation - // could save you in a month. + // might save you in a month. EstimatedMonthlySavingsAmount *string `type:"string"` // How much Amazon Web Services estimates that this specific recommendation - // could save you in a month, as a percentage of your overall costs. + // might save you in a month, as a percentage of your overall costs. EstimatedMonthlySavingsPercentage *string `type:"string"` - // How much Amazon Web Services estimates that you would have spent for all - // usage during the specified historical period if you had a reservation. + // How much Amazon Web Services estimates that you might spend for all usage + // during the specified historical period if you had a reservation. EstimatedReservationCostForLookbackPeriod *string `type:"string"` // Details about the instances that Amazon Web Services recommends that you @@ -12153,11 +12639,11 @@ func (s *ReservationUtilizationGroup) SetValue(v string) *ReservationUtilization return s } -// Details on the resource. +// Details for the resource. type ResourceDetails struct { _ struct{} `type:"structure"` - // Details on the Amazon EC2 resource. + // Details for the Amazon EC2 resource. EC2ResourceDetails *EC2ResourceDetails `type:"structure"` } @@ -12260,12 +12746,12 @@ func (s *ResourceNotFoundException) RequestID() string { type ResourceTag struct { _ struct{} `type:"structure"` - // The key that is associated with the tag. + // The key that's associated with the tag. // // Key is a required field Key *string `min:"1" type:"string" required:"true"` - // The value that is associated with the tag. + // The value that's associated with the tag. // // Value is a required field Value *string `type:"string" required:"true"` @@ -12421,8 +12907,8 @@ type RightsizingRecommendation struct { // Context regarding the current instance. CurrentInstance *CurrentInstance `type:"structure"` - // The list of possible reasons why the recommendation is generated such as - // under or over utilization of specific metrics (for example, CPU, Memory, + // The list of possible reasons why the recommendation is generated, such as + // under- or over-utilization of specific metrics (for example, CPU, Memory, // Network). FindingReasonCodes []*string `type:"list" enum:"FindingReasonCode"` @@ -12494,8 +12980,8 @@ func (s *RightsizingRecommendation) SetTerminateRecommendationDetail(v *Terminat // 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. +// recommendations with consideration of existing Savings Plans or Reserved +// Instance (RI) benefits, or neither. type RightsizingRecommendationConfiguration struct { _ struct{} `type:"structure"` @@ -12678,8 +13164,8 @@ func (s *RightsizingRecommendationSummary) SetTotalRecommendationCount(v string) return s } -// 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. type RootCause struct { _ struct{} `type:"structure"` @@ -12689,7 +13175,7 @@ type RootCause struct { // The Amazon Web Services Region that's associated with the cost anomaly. Region *string `type:"string"` - // 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. Service *string `type:"string"` // The UsageType value that's associated with the cost anomaly. @@ -12792,7 +13278,7 @@ func (s *SavingsPlansAmortizedCommitment) SetTotalAmortizedCommitment(v string) return s } -// The amount of Savings Plans eligible usage that is covered by Savings Plans. +// 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. type SavingsPlansCoverage struct { @@ -12856,7 +13342,7 @@ type SavingsPlansCoverageData struct { // The cost of your Amazon Web Services usage at the public On-Demand rate. OnDemandCost *string `type:"string"` - // The amount of your Amazon Web Services usage that is covered by a Savings + // The amount of your Amazon Web Services usage that's covered by a Savings // Plans. SpendCoveredBySavingsPlans *string `type:"string"` @@ -12969,14 +13455,14 @@ type SavingsPlansPurchaseRecommendation struct { // are calculated for individual member accounts only. AccountScope *string `type:"string" enum:"AccountScope"` - // The lookback period in days, used to generate the recommendation. + // The lookback period in days that's used to generate the recommendation. LookbackPeriodInDays *string `type:"string" enum:"LookbackPeriodInDays"` - // The payment option used to generate the recommendation. + // The payment option that's used to generate the recommendation. PaymentOption *string `type:"string" enum:"PaymentOption"` - // Details for the Savings Plans we recommend that you purchase to cover existing - // Savings Plans eligible workloads. + // Details for the Savings Plans that we recommend that you purchase to cover + // existing Savings Plans eligible workloads. SavingsPlansPurchaseRecommendationDetails []*SavingsPlansPurchaseRecommendationDetail `type:"list"` // Summary metrics for your Savings Plans Recommendations. @@ -13083,9 +13569,8 @@ type SavingsPlansPurchaseRecommendationDetail struct { // Savings Plans, over the length of the lookback period. EstimatedOnDemandCost *string `type:"string"` - // The estimated On-Demand costs you would expect with no additional commitment, - // based on your usage of the selected time period and the Savings Plans you - // own. + // The estimated On-Demand costs you expect with no additional commitment, based + // on your usage of the selected time period and the Savings Plans you own. EstimatedOnDemandCostWithCurrentCommitment *string `type:"string"` // The estimated return on investment that's based on the recommended Savings @@ -13237,7 +13722,7 @@ type SavingsPlansPurchaseRecommendationMetadata struct { // Additional metadata that might be applicable to the recommendation. AdditionalMetadata *string `type:"string"` - // The timestamp showing when the recommendations were generated. + // The timestamp that shows when the recommendations were generated. GenerationTimestamp *string `type:"string"` // The unique identifier for the recommendation set. @@ -13299,9 +13784,9 @@ type SavingsPlansPurchaseRecommendationSummary struct { // Plans purchase. EstimatedMonthlySavingsAmount *string `type:"string"` - // 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. + // 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. EstimatedOnDemandCostWithCurrentCommitment *string `type:"string"` // The estimated return on investment that's based on the recommended Savings @@ -13529,9 +14014,9 @@ type SavingsPlansUtilizationAggregates struct { // of the upfront and recurring Savings Plans fees. AmortizedCommitment *SavingsPlansAmortizedCommitment `type:"structure"` - // 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. + // 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. Savings *SavingsPlansSavings `type:"structure"` // A ratio of your effectiveness of using existing Savings Plans to apply to @@ -13577,7 +14062,7 @@ func (s *SavingsPlansUtilizationAggregates) SetUtilization(v *SavingsPlansUtiliz return s } -// The amount of Savings Plans utilization, in hours. +// The amount of Savings Plans utilization (in hours). type SavingsPlansUtilizationByTime struct { _ struct{} `type:"structure"` @@ -13585,9 +14070,9 @@ type SavingsPlansUtilizationByTime struct { // of the upfront and recurring Savings Plans fees. AmortizedCommitment *SavingsPlansAmortizedCommitment `type:"structure"` - // 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. + // 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. Savings *SavingsPlansSavings `type:"structure"` // The time period of the request. @@ -13644,7 +14129,7 @@ func (s *SavingsPlansUtilizationByTime) SetUtilization(v *SavingsPlansUtilizatio return s } -// A single daily or monthly Savings Plans utilization rate, and details for +// 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. @@ -13659,7 +14144,7 @@ type SavingsPlansUtilizationDetail struct { Attributes map[string]*string `type:"map"` // The amount saved by using existing Savings Plans. Savings returns both net - // savings from savings plans as well as the onDemandCostEquivalent of the Savings + // savings from savings plans and also the onDemandCostEquivalent of the Savings // Plans when considering the utilization rate. Savings *SavingsPlansSavings `type:"structure"` @@ -13817,7 +14302,7 @@ func (s *ServiceSpecification) SetEC2Specification(v *EC2Specification) *Service return s } -// The details of how to sort the data. +// The details for how to sort the data. type SortDefinition struct { _ struct{} `type:"structure"` @@ -13959,7 +14444,8 @@ type TagResourceInput struct { // // * 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 // @@ -14133,7 +14619,7 @@ type TargetInstance struct { // The expected utilization metrics for target instance type. ExpectedResourceUtilization *ResourceUtilization `type:"structure"` - // Explains the actions you might need to take in order to successfully migrate + // Explains the actions that you might need to take to successfully migrate // your workloads from the current instance type to the recommended instance // type. PlatformDifferences []*string `type:"list" enum:"PlatformDifference"` @@ -14584,7 +15070,7 @@ type UntagResourceInput struct { ResourceArn *string `min:"20" type:"string" required:"true"` // 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 + // 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. // @@ -14885,6 +15371,150 @@ func (s *UpdateAnomalySubscriptionOutput) SetSubscriptionArn(v string) *UpdateAn return s } +// Gives a detailed description of the result of an action. It's on each cost +// allocation tag entry in the request. +type UpdateCostAllocationTagsStatusError struct { + _ struct{} `type:"structure"` + + // An error code representing why the action failed on this entry. + Code *string `type:"string"` + + // A message explaining why the action failed on this entry. + Message *string `type:"string"` + + // The key for the cost allocation tag. + TagKey *string `type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UpdateCostAllocationTagsStatusError) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UpdateCostAllocationTagsStatusError) GoString() string { + return s.String() +} + +// SetCode sets the Code field's value. +func (s *UpdateCostAllocationTagsStatusError) SetCode(v string) *UpdateCostAllocationTagsStatusError { + s.Code = &v + return s +} + +// SetMessage sets the Message field's value. +func (s *UpdateCostAllocationTagsStatusError) SetMessage(v string) *UpdateCostAllocationTagsStatusError { + s.Message = &v + return s +} + +// SetTagKey sets the TagKey field's value. +func (s *UpdateCostAllocationTagsStatusError) SetTagKey(v string) *UpdateCostAllocationTagsStatusError { + s.TagKey = &v + return s +} + +type UpdateCostAllocationTagsStatusInput struct { + _ struct{} `type:"structure"` + + // The list of CostAllocationTagStatusEntry objects that are used to update + // cost allocation tags status for this request. + // + // CostAllocationTagsStatus is a required field + CostAllocationTagsStatus []*CostAllocationTagStatusEntry `min:"1" type:"list" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UpdateCostAllocationTagsStatusInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UpdateCostAllocationTagsStatusInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *UpdateCostAllocationTagsStatusInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "UpdateCostAllocationTagsStatusInput"} + if s.CostAllocationTagsStatus == nil { + invalidParams.Add(request.NewErrParamRequired("CostAllocationTagsStatus")) + } + if s.CostAllocationTagsStatus != nil && len(s.CostAllocationTagsStatus) < 1 { + invalidParams.Add(request.NewErrParamMinLen("CostAllocationTagsStatus", 1)) + } + if s.CostAllocationTagsStatus != nil { + for i, v := range s.CostAllocationTagsStatus { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "CostAllocationTagsStatus", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetCostAllocationTagsStatus sets the CostAllocationTagsStatus field's value. +func (s *UpdateCostAllocationTagsStatusInput) SetCostAllocationTagsStatus(v []*CostAllocationTagStatusEntry) *UpdateCostAllocationTagsStatusInput { + s.CostAllocationTagsStatus = v + return s +} + +type UpdateCostAllocationTagsStatusOutput struct { + _ struct{} `type:"structure"` + + // 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. + Errors []*UpdateCostAllocationTagsStatusError `type:"list"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UpdateCostAllocationTagsStatusOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s UpdateCostAllocationTagsStatusOutput) GoString() string { + return s.String() +} + +// SetErrors sets the Errors field's value. +func (s *UpdateCostAllocationTagsStatusOutput) SetErrors(v []*UpdateCostAllocationTagsStatusError) *UpdateCostAllocationTagsStatusOutput { + s.Errors = v + return s +} + type UpdateCostCategoryDefinitionInput struct { _ struct{} `type:"structure"` @@ -15177,6 +15807,38 @@ func Context_Values() []string { } } +const ( + // CostAllocationTagStatusActive is a CostAllocationTagStatus enum value + CostAllocationTagStatusActive = "Active" + + // CostAllocationTagStatusInactive is a CostAllocationTagStatus enum value + CostAllocationTagStatusInactive = "Inactive" +) + +// CostAllocationTagStatus_Values returns all elements of the CostAllocationTagStatus enum +func CostAllocationTagStatus_Values() []string { + return []string{ + CostAllocationTagStatusActive, + CostAllocationTagStatusInactive, + } +} + +const ( + // CostAllocationTagTypeAwsgenerated is a CostAllocationTagType enum value + CostAllocationTagTypeAwsgenerated = "AWSGenerated" + + // CostAllocationTagTypeUserDefined is a CostAllocationTagType enum value + CostAllocationTagTypeUserDefined = "UserDefined" +) + +// CostAllocationTagType_Values returns all elements of the CostAllocationTagType enum +func CostAllocationTagType_Values() []string { + return []string{ + CostAllocationTagTypeAwsgenerated, + CostAllocationTagTypeUserDefined, + } +} + const ( // CostCategoryInheritedValueDimensionNameLinkedAccountName is a CostCategoryInheritedValueDimensionName enum value CostCategoryInheritedValueDimensionNameLinkedAccountName = "LINKED_ACCOUNT_NAME" diff --git a/service/costexplorer/costexploreriface/interface.go b/service/costexplorer/costexploreriface/interface.go index 3258516bd02..612879dc389 100644 --- a/service/costexplorer/costexploreriface/interface.go +++ b/service/costexplorer/costexploreriface/interface.go @@ -166,6 +166,13 @@ type CostExplorerAPI interface { GetUsageForecastWithContext(aws.Context, *costexplorer.GetUsageForecastInput, ...request.Option) (*costexplorer.GetUsageForecastOutput, error) GetUsageForecastRequest(*costexplorer.GetUsageForecastInput) (*request.Request, *costexplorer.GetUsageForecastOutput) + ListCostAllocationTags(*costexplorer.ListCostAllocationTagsInput) (*costexplorer.ListCostAllocationTagsOutput, error) + ListCostAllocationTagsWithContext(aws.Context, *costexplorer.ListCostAllocationTagsInput, ...request.Option) (*costexplorer.ListCostAllocationTagsOutput, error) + ListCostAllocationTagsRequest(*costexplorer.ListCostAllocationTagsInput) (*request.Request, *costexplorer.ListCostAllocationTagsOutput) + + ListCostAllocationTagsPages(*costexplorer.ListCostAllocationTagsInput, func(*costexplorer.ListCostAllocationTagsOutput, bool) bool) error + ListCostAllocationTagsPagesWithContext(aws.Context, *costexplorer.ListCostAllocationTagsInput, func(*costexplorer.ListCostAllocationTagsOutput, bool) bool, ...request.Option) error + ListCostCategoryDefinitions(*costexplorer.ListCostCategoryDefinitionsInput) (*costexplorer.ListCostCategoryDefinitionsOutput, error) ListCostCategoryDefinitionsWithContext(aws.Context, *costexplorer.ListCostCategoryDefinitionsInput, ...request.Option) (*costexplorer.ListCostCategoryDefinitionsOutput, error) ListCostCategoryDefinitionsRequest(*costexplorer.ListCostCategoryDefinitionsInput) (*request.Request, *costexplorer.ListCostCategoryDefinitionsOutput) @@ -197,6 +204,10 @@ type CostExplorerAPI interface { UpdateAnomalySubscriptionWithContext(aws.Context, *costexplorer.UpdateAnomalySubscriptionInput, ...request.Option) (*costexplorer.UpdateAnomalySubscriptionOutput, error) UpdateAnomalySubscriptionRequest(*costexplorer.UpdateAnomalySubscriptionInput) (*request.Request, *costexplorer.UpdateAnomalySubscriptionOutput) + UpdateCostAllocationTagsStatus(*costexplorer.UpdateCostAllocationTagsStatusInput) (*costexplorer.UpdateCostAllocationTagsStatusOutput, error) + UpdateCostAllocationTagsStatusWithContext(aws.Context, *costexplorer.UpdateCostAllocationTagsStatusInput, ...request.Option) (*costexplorer.UpdateCostAllocationTagsStatusOutput, error) + UpdateCostAllocationTagsStatusRequest(*costexplorer.UpdateCostAllocationTagsStatusInput) (*request.Request, *costexplorer.UpdateCostAllocationTagsStatusOutput) + UpdateCostCategoryDefinition(*costexplorer.UpdateCostCategoryDefinitionInput) (*costexplorer.UpdateCostCategoryDefinitionOutput, error) UpdateCostCategoryDefinitionWithContext(aws.Context, *costexplorer.UpdateCostCategoryDefinitionInput, ...request.Option) (*costexplorer.UpdateCostCategoryDefinitionOutput, error) UpdateCostCategoryDefinitionRequest(*costexplorer.UpdateCostCategoryDefinitionInput) (*request.Request, *costexplorer.UpdateCostCategoryDefinitionOutput)