diff --git a/.changes/2.1150.0.json b/.changes/2.1150.0.json new file mode 100644 index 0000000000..2214da1dc7 --- /dev/null +++ b/.changes/2.1150.0.json @@ -0,0 +1,12 @@ +[ + { + "type": "feature", + "category": "AuditManager", + "description": "This release introduces 2 updates to the Audit Manager API. The roleType and roleArn attributes are now required when you use the CreateAssessment or UpdateAssessment operation. We also added a throttling exception to the RegisterAccount API operation." + }, + { + "type": "feature", + "category": "CostExplorer", + "description": "Added two new APIs to support cost allocation tags operations: ListCostAllocationTags, UpdateCostAllocationTagsStatus." + } +] \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 061f83f3ba..b1ae1f1368 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,7 +1,11 @@ # Changelog for AWS SDK for JavaScript - + +## 2.1150.0 +* feature: AuditManager: This release introduces 2 updates to the Audit Manager API. The roleType and roleArn attributes are now required when you use the CreateAssessment or UpdateAssessment operation. We also added a throttling exception to the RegisterAccount API operation. +* feature: CostExplorer: Added two new APIs to support cost allocation tags operations: ListCostAllocationTags, UpdateCostAllocationTagsStatus. + ## 2.1149.0 * feature: ChimeSDKMessaging: This release adds support for searching channels by members via the SearchChannels API, removes required restrictions for Name and Mode in UpdateChannel API and enhances CreateChannel API by exposing member and moderator list as well as channel id as optional parameters. * feature: Connect: This release adds a new API, GetCurrentUserData, which returns real-time details about users' current activity. diff --git a/README.md b/README.md index 2fefe9cade..935c24d351 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ For release notes, see the [CHANGELOG](https://github.com/aws/aws-sdk-js/blob/ma To use the SDK in the browser, simply add the following script tag to your HTML pages: - + You can also build a custom browser SDK with your specified set of AWS services. This can allow you to reduce the SDK's size, specify different API versions of diff --git a/apis/auditmanager-2017-07-25.min.json b/apis/auditmanager-2017-07-25.min.json index a20eb2384a..f982d39252 100644 --- a/apis/auditmanager-2017-07-25.min.json +++ b/apis/auditmanager-2017-07-25.min.json @@ -2237,6 +2237,10 @@ }, "S1j": { "type": "structure", + "required": [ + "roleType", + "roleArn" + ], "members": { "roleType": {}, "roleArn": {} diff --git a/apis/auditmanager-2017-07-25.normal.json b/apis/auditmanager-2017-07-25.normal.json index 51f2319cfb..e84788ddc4 100644 --- a/apis/auditmanager-2017-07-25.normal.json +++ b/apis/auditmanager-2017-07-25.normal.json @@ -941,7 +941,7 @@ "shape": "InternalServerException" } ], - "documentation": "
Returns a list of the in-scope Amazon Web Services services for the specified assessment.
" + "documentation": "Returns a list of the in-scope Amazon Web Services for the specified assessment.
" }, "GetSettings": { "name": "GetSettings", @@ -1301,6 +1301,9 @@ }, { "shape": "ResourceNotFoundException" + }, + { + "shape": "ThrottlingException" } ], "documentation": "Enables Audit Manager for the specified Amazon Web Services account.
" @@ -1359,7 +1362,7 @@ "shape": "ResourceNotFoundException" } ], - "documentation": "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.
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.
" + "documentation": "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.
" }, "evidenceByTypeManualCount": { "shape": "Integer", @@ -5082,6 +5085,10 @@ }, "Role": { "type": "structure", + "required": [ + "roleType", + "roleArn" + ], "members": { "roleType": { "shape": "RoleType", diff --git a/apis/ce-2017-10-25.min.json b/apis/ce-2017-10-25.min.json index 77c0ab308e..d3301f1d54 100644 --- a/apis/ce-2017-10-25.min.json +++ b/apis/ce-2017-10-25.min.json @@ -1359,6 +1359,45 @@ } } }, + "ListCostAllocationTags": { + "input": { + "type": "structure", + "members": { + "Status": {}, + "TagKeys": { + "type": "list", + "member": {} + }, + "Type": {}, + "NextToken": {}, + "MaxResults": { + "type": "integer" + } + } + }, + "output": { + "type": "structure", + "members": { + "CostAllocationTags": { + "type": "list", + "member": { + "type": "structure", + "required": [ + "TagKey", + "Type", + "Status" + ], + "members": { + "TagKey": {}, + "Type": {}, + "Status": {} + } + } + }, + "NextToken": {} + } + } + }, "ListCostCategoryDefinitions": { "input": { "type": "structure", @@ -1531,6 +1570,46 @@ } } }, + "UpdateCostAllocationTagsStatus": { + "input": { + "type": "structure", + "required": [ + "CostAllocationTagsStatus" + ], + "members": { + "CostAllocationTagsStatus": { + "type": "list", + "member": { + "type": "structure", + "required": [ + "TagKey", + "Status" + ], + "members": { + "TagKey": {}, + "Status": {} + } + } + } + } + }, + "output": { + "type": "structure", + "members": { + "Errors": { + "type": "list", + "member": { + "type": "structure", + "members": { + "TagKey": {}, + "Code": {}, + "Message": {} + } + } + } + } + } + }, "UpdateCostCategoryDefinition": { "input": { "type": "structure", diff --git a/apis/ce-2017-10-25.normal.json b/apis/ce-2017-10-25.normal.json index 09dbce3834..b363f5a749 100644 --- a/apis/ce-2017-10-25.normal.json +++ b/apis/ce-2017-10-25.normal.json @@ -163,7 +163,7 @@ "shape": "LimitExceededException" } ], - "documentation": "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 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 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.
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 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.
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.
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.
" + "documentation": "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": { "name": "GetSavingsPlansCoverage", @@ -547,7 +547,7 @@ "shape": "DataUnavailableException" } ], - "documentation": "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 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.
" }, + "ListCostAllocationTags": { + "name": "ListCostAllocationTags", + "http": { + "method": "POST", + "requestUri": "/" + }, + "input": { + "shape": "ListCostAllocationTagsRequest" + }, + "output": { + "shape": "ListCostAllocationTagsResponse" + }, + "errors": [ + { + "shape": "LimitExceededException" + }, + { + "shape": "InvalidNextTokenException" + } + ], + "documentation": "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": { "name": "ListCostCategoryDefinitions", "http": { @@ -647,7 +669,7 @@ "shape": "LimitExceededException" } ], - "documentation": "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.
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.
" + "documentation": "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": { "name": "UntagResource", @@ -735,7 +757,7 @@ "shape": "LimitExceededException" } ], - "documentation": "Removes one or more tags from a resource. Specify only tag key(s) in your request. Do not specify the value.
" + "documentation": "Removes one or more tags from a resource. Specify only tag keys in your request. Don't specify the value.
" }, "UpdateAnomalyMonitor": { "name": "UpdateAnomalyMonitor", @@ -784,6 +806,25 @@ ], "documentation": "Updates an existing cost anomaly monitor subscription.
" }, + "UpdateCostAllocationTagsStatus": { + "name": "UpdateCostAllocationTagsStatus", + "http": { + "method": "POST", + "requestUri": "/" + }, + "input": { + "shape": "UpdateCostAllocationTagsStatusRequest" + }, + "output": { + "shape": "UpdateCostAllocationTagsStatusResponse" + }, + "errors": [ + { + "shape": "LimitExceededException" + } + ], + "documentation": "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": { "name": "UpdateCostCategoryDefinition", "http": { @@ -853,7 +894,7 @@ }, "DimensionValue": { "shape": "GenericString", - "documentation": "The dimension for the anomaly (for example, an Amazon Web Services service in a service monitor).
" + "documentation": "The dimension for the anomaly (for example, an Amazon Web Service in a service monitor).
" }, "RootCauses": { "shape": "RootCauses", @@ -1056,6 +1097,90 @@ "SAVINGS_PLANS" ] }, + "CostAllocationTag": { + "type": "structure", + "required": [ + "TagKey", + "Type", + "Status" + ], + "members": { + "TagKey": { + "shape": "TagKey", + "documentation": "The key for the cost allocation tag.
" + }, + "Type": { + "shape": "CostAllocationTagType", + "documentation": "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 status of a cost allocation tag.
" + } + }, + "documentation": "The cost allocation tag structure. This includes detailed metadata for the CostAllocationTag
object.
The key for the cost allocation tag.
" + }, + "Status": { + "shape": "CostAllocationTagStatus", + "documentation": "The status of a cost allocation tag.
" + } + }, + "documentation": "The cost allocation tag status. The status of a key can either be active or inactive.
" + }, + "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": [ @@ -1076,7 +1201,7 @@ }, "EffectiveEnd": { "shape": "ZonedDateTime", - "documentation": "The effective end data of your Cost Category.
" + "documentation": "The effective end data of your Cost Category.
" }, "Name": { "shape": "CostCategoryName" @@ -1107,14 +1232,14 @@ "members": { "DimensionName": { "shape": "CostCategoryInheritedValueDimensionName", - "documentation": "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 key to extract cost category values.
" } }, - "documentation": "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.
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.
Rules are processed in order. If there are multiple rules that match the line item, then the first rule to match is used to determine that Cost Category value.
" @@ -1494,7 +1619,7 @@ }, "ResourceTags": { "shape": "ResourceTagList", - "documentation": " 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 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
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
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
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
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 unique identifier for your newly created Cost Category.
" + "documentation": "The unique identifier for your newly created Cost Category.
" }, "EffectiveStart": { "shape": "ZonedDateTime", - "documentation": "The Cost Category's effective start date.
" + "documentation": "The Cost Category's effective start date.
" } } }, @@ -1607,7 +1732,7 @@ }, "ReservationCoveredHoursInLookbackPeriod": { "shape": "GenericString", - "documentation": "The number of hours during the lookback period that's covered by reservations.
" + "documentation": "The number of hours during the lookback period that's covered by reservations.
" }, "SavingsPlansCoveredHoursInLookbackPeriod": { "shape": "GenericString", @@ -1615,7 +1740,7 @@ }, "OnDemandHoursInLookbackPeriod": { "shape": "GenericString", - "documentation": "The number of hours during the lookback period that's billed at On-Demand rates.
" + "documentation": "The number of hours during the lookback period that's billed at On-Demand rates.
" }, "TotalRunningHoursInLookbackPeriod": { "shape": "GenericString", @@ -1627,7 +1752,7 @@ }, "CurrencyCode": { "shape": "GenericString", - "documentation": "The currency code that Amazon Web Services used to calculate the costs for this instance.
" + "documentation": "The currency code that Amazon Web Services used to calculate the costs for this instance.
" } }, "documentation": "Context about the current instance.
" @@ -1690,7 +1815,7 @@ "members": { "CostCategoryArn": { "shape": "Arn", - "documentation": "The unique identifier for your Cost Category.
" + "documentation": "The unique identifier for your Cost Category.
" } } }, @@ -1699,11 +1824,11 @@ "members": { "CostCategoryArn": { "shape": "Arn", - "documentation": "The unique identifier for your Cost Category.
" + "documentation": "The unique identifier for your Cost Category.
" }, "EffectiveEnd": { "shape": "ZonedDateTime", - "documentation": "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.
" + "documentation": "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.
" } } }, @@ -1715,11 +1840,11 @@ "members": { "CostCategoryArn": { "shape": "Arn", - "documentation": "The unique identifier for your Cost Category.
" + "documentation": "The unique identifier for your Cost Category.
" }, "EffectiveOn": { "shape": "ZonedDateTime", - "documentation": "The date when the Cost Category was effective.
" + "documentation": "The date when the Cost Category was effective.
" } } }, @@ -1811,22 +1936,22 @@ "members": { "DiskReadOpsPerSecond": { "shape": "GenericString", - "documentation": "The maximum number of read operations per second.
" + "documentation": "The maximum number of read operations per second.
" }, "DiskWriteOpsPerSecond": { "shape": "GenericString", - "documentation": "The maximum number of write operations per second.
" + "documentation": "The maximum number of write operations per second.
" }, "DiskReadBytesPerSecond": { "shape": "GenericString", - "documentation": "The maximum read throughput operations per second.
" + "documentation": "The maximum read throughput operations per second.
" }, "DiskWriteBytesPerSecond": { "shape": "GenericString", - "documentation": "The maximum write throughput operations per second.
" + "documentation": "The maximum write throughput operations per second.
" } }, - "documentation": "The field that contains a list of disk (local storage) metrics that are associated with the current instance.
" + "documentation": "The field that contains a list of disk (local storage) metrics that are associated with the current instance.
" }, "EBSResourceUtilization": { "type": "structure", @@ -1925,7 +2050,7 @@ }, "Vcpu": { "shape": "GenericString", - "documentation": "The number of VCPU cores in the Amazon Web Services instance type.
" + "documentation": "The number of VCPU cores in the Amazon Web Services instance type.
" } }, "documentation": "Details on the Amazon EC2 Resource.
" @@ -1935,15 +2060,15 @@ "members": { "MaxCpuUtilizationPercentage": { "shape": "GenericString", - "documentation": "The maximum observed or expected CPU utilization of the instance.
" + "documentation": "The maximum observed or expected CPU utilization of the instance.
" }, "MaxMemoryUtilizationPercentage": { "shape": "GenericString", - "documentation": "The maximum observed or expected memory utilization of the instance.
" + "documentation": "The maximum observed or expected memory utilization of the instance.
" }, "MaxStorageUtilizationPercentage": { "shape": "GenericString", - "documentation": "The maximum observed or expected storage utilization of the instance. This doesn't include EBS storage.
" + "documentation": "The maximum observed or expected storage utilization of the instance. This doesn't include EBS storage.
" }, "EBSResourceUtilization": { "shape": "EBSResourceUtilization", @@ -1951,14 +2076,14 @@ }, "DiskResourceUtilization": { "shape": "DiskResourceUtilization", - "documentation": "The field that contains a list of disk (local storage) metrics that are associated with the current instance.
" + "documentation": "The field that contains a list of disk (local storage) metrics that are associated with the current instance.
" }, "NetworkResourceUtilization": { "shape": "NetworkResourceUtilization", - "documentation": "The network field that contains a list of network metrics that are associated with the current instance.
" + "documentation": "The network field that contains a list of network metrics that are associated with the current instance.
" } }, - "documentation": "Utilization metrics of the instance.
" + "documentation": "Utilization metrics for the instance.
" }, "EC2Specification": { "type": "structure", @@ -2029,6 +2154,9 @@ "Entity": { "type": "string" }, + "ErrorMessage": { + "type": "string" + }, "Estimated": { "type": "boolean" }, @@ -2330,7 +2458,7 @@ }, "Metrics": { "shape": "MetricNames", - "documentation": "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 time period that is covered by the results in the response.
" + "documentation": "The time period that's covered by the results in the response.
" }, "DimensionValueAttributes": { "shape": "DimensionValuesWithAttributesList", @@ -2371,7 +2499,7 @@ "members": { "SearchString": { "shape": "SearchString", - "documentation": "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 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.
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 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.
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.
" + "documentation": "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.
" } } }, @@ -2405,7 +2533,7 @@ "members": { "NextPageToken": { "shape": "NextPageToken", - "documentation": "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.
" + "documentation": "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.
" }, "CostCategoryNames": { "shape": "CostCategoryNamesList", @@ -2413,11 +2541,11 @@ }, "CostCategoryValues": { "shape": "CostCategoryValuesList", - "documentation": "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 number of objects returned.
" + "documentation": "The number of objects that are returned.
" }, "TotalSize": { "shape": "PageSize", @@ -2489,18 +2617,18 @@ }, "Context": { "shape": "Context", - "documentation": "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 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 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.
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 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 account ID that is associated with the recommendation.
" + "documentation": "The account ID that's associated with the recommendation.
" }, "Service": { "shape": "GenericString", @@ -2668,7 +2796,7 @@ "members": { "TimePeriod": { "shape": "DateInterval", - "documentation": "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 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 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 amount of time that you used your RIs.
" + "documentation": "The amount of time that you used your Reserved Instances (RIs).
" }, "Total": { "shape": "ReservationAggregates", - "documentation": "The total amount of time that you used your RIs.
" + "documentation": "The total amount of time that you used your Reserved Instances (RIs).
" }, "NextPageToken": { "shape": "NextPageToken", @@ -2728,7 +2856,7 @@ }, "Configuration": { "shape": "RightsizingRecommendationConfiguration", - "documentation": "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.
" + "documentation": "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.
" }, "Service": { "shape": "GenericString", @@ -2765,7 +2893,7 @@ }, "Configuration": { "shape": "RightsizingRecommendationConfiguration", - "documentation": "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.
" + "documentation": "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.
" } } }, @@ -2806,7 +2934,7 @@ }, "SortBy": { "shape": "SortDefinition", - "documentation": "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 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 Savings Plans recommendation type requested.
" + "documentation": "The Savings Plans recommendation type that's requested.
" }, "TermInYears": { "shape": "TermInYears", - "documentation": "The savings plan recommendation term used to generate these recommendations.
" + "documentation": "The savings plan recommendation term that's used to generate these recommendations.
" }, "PaymentOption": { "shape": "PaymentOption", - "documentation": "The payment option used to generate these recommendations.
" + "documentation": "The payment option that's used to generate these recommendations.
" }, "AccountScope": { "shape": "AccountScope", @@ -2861,11 +2989,11 @@ }, "LookbackPeriodInDays": { "shape": "LookbackPeriodInDays", - "documentation": "The lookback period used to generate the recommendation.
" + "documentation": "The lookback period that's used to generate the recommendation.
" }, "Filter": { "shape": "Expression", - "documentation": "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.
Information regarding this specific recommendation set.
" + "documentation": "Information that regards this specific recommendation set.
" }, "SavingsPlansPurchaseRecommendation": { "shape": "SavingsPlansPurchaseRecommendation", @@ -2915,7 +3043,7 @@ }, "SortBy": { "shape": "SortDefinition", - "documentation": "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 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 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
TotalCommitment
UsedCommitment
UnusedCommitment
NetSavings
The supported values for SortOrder
are ASCENDING
and DESCENDING
.
The amount of cost/commitment you used your Savings Plans. This allows you to specify date ranges.
" + "documentation": "The amount of cost/commitment that you used your Savings Plans. You can use it to specify date ranges.
" }, "Total": { "shape": "SavingsPlansUtilizationAggregates", @@ -3006,11 +3134,11 @@ }, "SortBy": { "shape": "SortDefinitions", - "documentation": "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 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.
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.
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.
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.
" + "documentation": "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.
" } } }, @@ -3201,20 +3329,59 @@ "shape": "Key" } }, + "ListCostAllocationTagsRequest": { + "type": "structure", + "members": { + "Status": { + "shape": "CostAllocationTagStatus", + "documentation": "The status of cost allocation tag keys that are returned for this request.
" + }, + "TagKeys": { + "shape": "CostAllocationTagKeyList", + "documentation": "The list of cost allocation tag keys that are returned for this request.
" + }, + "Type": { + "shape": "CostAllocationTagType", + "documentation": "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 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.
" + }, + "MaxResults": { + "shape": "CostAllocationTagsMaxResults", + "documentation": "The maximum number of objects that are returned for this request. By default, the request returns 100 results.
", + "box": true + } + } + }, + "ListCostAllocationTagsResponse": { + "type": "structure", + "members": { + "CostAllocationTags": { + "shape": "CostAllocationTagList", + "documentation": "A list of cost allocation tags that includes the detailed metadata for each one.
" + }, + "NextToken": { + "shape": "NextPageToken", + "documentation": "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": { "type": "structure", "members": { "EffectiveOn": { "shape": "ZonedDateTime", - "documentation": "The date when the Cost Category was effective.
" + "documentation": "The date when the Cost Category was effective.
" }, "NextToken": { "shape": "NextPageToken", - "documentation": "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.
" + "documentation": "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.
" }, "MaxResults": { "shape": "CostCategoryMaxResults", - "documentation": "The number of entries a paginated response contains.
", + "documentation": "The number of entries a paginated response contains.
", "box": true } } @@ -3224,11 +3391,11 @@ "members": { "CostCategoryReferences": { "shape": "CostCategoryReferencesList", - "documentation": "A reference to a Cost Category containing enough information to identify the Cost Category.
" + "documentation": "A reference to a Cost Category that contains enough information to identify the Cost Category.
" }, "NextToken": { "shape": "NextPageToken", - "documentation": "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.
" + "documentation": "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.
" } } }, @@ -3249,7 +3416,7 @@ "members": { "ResourceTags": { "shape": "ResourceTagList", - "documentation": "A list of tag key value pairs that are associated with the response.
" + "documentation": "A list of tag key value pairs that are associated with the resource.
" } } }, @@ -3344,7 +3511,7 @@ "documentation": "Determines whether this instance type is the Amazon Web Services default recommendation.
" } }, - "documentation": "Details on the modification recommendation.
" + "documentation": "Details for the modification recommendation.
" }, "MonitorArnList": { "type": "list", @@ -3373,22 +3540,22 @@ "members": { "NetworkInBytesPerSecond": { "shape": "GenericString", - "documentation": "The network inbound throughput utilization measured in Bytes per second.
" + "documentation": "The network inbound throughput utilization measured in Bytes per second (Bps).
" }, "NetworkOutBytesPerSecond": { "shape": "GenericString", - "documentation": "The network outbound throughput utilization measured in Bytes per second.
" + "documentation": "The network outbound throughput utilization measured in Bytes per second (Bps).
" }, "NetworkPacketsInPerSecond": { "shape": "GenericString", - "documentation": "The network ingress packets that are measured in packets per second.
" + "documentation": "The network inbound packets that are measured in packets per second.
" }, "NetworkPacketsOutPerSecond": { "shape": "GenericString", - "documentation": "The network outgress packets that are measured in packets per second.
" + "documentation": "The network outbound packets that are measured in packets per second.
" } }, - "documentation": "The network field that contains a list of network metrics that are associated with the current instance.
" + "documentation": "The network field that contains a list of network metrics that are associated with the current instance.
" }, "NextPageToken": { "type": "string", @@ -3724,7 +3891,7 @@ "members": { "AccountId": { "shape": "GenericString", - "documentation": "The account that this RI recommendation is for.
" + "documentation": "The account that this Reserved Instance (RI) recommendation is for.
" }, "InstanceDetails": { "shape": "InstanceDetails", @@ -3776,11 +3943,11 @@ }, "EstimatedMonthlySavingsAmount": { "shape": "GenericString", - "documentation": "How much Amazon Web Services estimates that this specific recommendation could save you in a month.
" + "documentation": "How much Amazon Web Services estimates that this specific recommendation might save you in a month.
" }, "EstimatedMonthlySavingsPercentage": { "shape": "GenericString", - "documentation": "How much Amazon Web Services estimates that this specific recommendation could save you in a month, as a percentage of your overall costs.
" + "documentation": "How much Amazon Web Services estimates that this specific recommendation might save you in a month, as a percentage of your overall costs.
" }, "EstimatedMonthlyOnDemandCost": { "shape": "GenericString", @@ -3788,7 +3955,7 @@ }, "EstimatedReservationCostForLookbackPeriod": { "shape": "GenericString", - "documentation": "How much Amazon Web Services estimates that you would have spent for all usage during the specified historical period if you had a reservation.
" + "documentation": "How much Amazon Web Services estimates that you might spend for all usage during the specified historical period if you had a reservation.
" }, "UpfrontCost": { "shape": "GenericString", @@ -3884,10 +4051,10 @@ "members": { "EC2ResourceDetails": { "shape": "EC2ResourceDetails", - "documentation": "Details on the Amazon EC2 resource.
" + "documentation": "Details for the Amazon EC2 resource.
" } }, - "documentation": "Details on the resource.
" + "documentation": "Details for the resource.
" }, "ResourceTag": { "type": "structure", @@ -3898,14 +4065,14 @@ "members": { "Key": { "shape": "ResourceTagKey", - "documentation": "The key that is associated with the tag.
" + "documentation": "The key that's associated with the tag.
" }, "Value": { "shape": "ResourceTagValue", - "documentation": "The value that is associated with the tag.
" + "documentation": "The value that's associated with the tag.
" } }, - "documentation": "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 list of possible reasons why the recommendation is generated such as under or over utilization of specific metrics (for example, CPU, Memory, Network).
" + "documentation": "The list of possible reasons why the recommendation is generated, such as under- or over-utilization of specific metrics (for example, CPU, Memory, Network).
" } }, "documentation": "Recommendations to rightsize resources.
" @@ -4019,7 +4186,7 @@ "documentation": "The option to consider RI or Savings Plans discount benefits in your savings calculation. The default value is TRUE
.
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.
The Amazon Web Services service name that's associated with the cost anomaly.
" + "documentation": "The Amazon Web Service name that's associated with the cost anomaly.
" }, "Region": { "shape": "GenericString", @@ -4098,7 +4265,7 @@ "documentation": "The UsageType
value that's associated with the cost anomaly.
The combination of Amazon Web Services service, linked account, Region, and usage type where a cost anomaly is observed.
" + "documentation": "The combination of Amazon Web Service, linked account, Region, and usage type where a cost anomaly is observed.
" }, "RootCauses": { "type": "list", @@ -4142,14 +4309,14 @@ "shape": "DateInterval" } }, - "documentation": "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.
" + "documentation": "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.
" }, "SavingsPlansCoverageData": { "type": "structure", "members": { "SpendCoveredBySavingsPlans": { "shape": "GenericString", - "documentation": "The amount of your Amazon Web Services usage that is covered by a Savings Plans.
" + "documentation": "The amount of your Amazon Web Services usage that's covered by a Savings Plans.
" }, "OnDemandCost": { "shape": "GenericString", @@ -4222,15 +4389,15 @@ }, "PaymentOption": { "shape": "PaymentOption", - "documentation": "The payment option used to generate the recommendation.
" + "documentation": "The payment option that's used to generate the recommendation.
" }, "LookbackPeriodInDays": { "shape": "LookbackPeriodInDays", - "documentation": "The lookback period in days, used to generate the recommendation.
" + "documentation": "The lookback period in days that's used to generate the recommendation.
" }, "SavingsPlansPurchaseRecommendationDetails": { "shape": "SavingsPlansPurchaseRecommendationDetailList", - "documentation": "Details for the Savings Plans we recommend that you purchase to cover existing Savings Plans eligible workloads.
" + "documentation": "Details for the Savings Plans that we recommend that you purchase to cover existing Savings Plans eligible workloads.
" }, "SavingsPlansPurchaseRecommendationSummary": { "shape": "SavingsPlansPurchaseRecommendationSummary", @@ -4272,7 +4439,7 @@ }, "EstimatedOnDemandCostWithCurrentCommitment": { "shape": "GenericString", - "documentation": "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.
" + "documentation": "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.
" }, "EstimatedSavingsAmount": { "shape": "GenericString", @@ -4324,7 +4491,7 @@ }, "GenerationTimestamp": { "shape": "GenericString", - "documentation": "The timestamp showing when the recommendations were generated.
" + "documentation": "The timestamp that shows when the recommendations were generated.
" }, "AdditionalMetadata": { "shape": "GenericString", @@ -4378,7 +4545,7 @@ }, "EstimatedOnDemandCostWithCurrentCommitment": { "shape": "GenericString", - "documentation": "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.
" + "documentation": "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.
" } }, "documentation": "Summary metrics for your Savings Plans Purchase Recommendations.
" @@ -4431,7 +4598,7 @@ }, "Savings": { "shape": "SavingsPlansSavings", - "documentation": "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 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 total amortized commitment for a Savings Plans. This includes the sum of the upfront and recurring Savings Plans fees.
" } }, - "documentation": "The amount of Savings Plans utilization, in hours.
" + "documentation": "The amount of Savings Plans utilization (in hours).
" }, "SavingsPlansUtilizationDetail": { "type": "structure", @@ -4482,14 +4649,14 @@ }, "Savings": { "shape": "SavingsPlansSavings", - "documentation": "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 and also the onDemandCostEquivalent
of the Savings Plans when considering the utilization rate.
The total amortized commitment for a Savings Plans. Includes the sum of the upfront and recurring Savings Plans fees.
" } }, - "documentation": "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 order that's used to sort the data.
" } }, - "documentation": "The details of how to sort the data.
" + "documentation": "The details for how to sort the data.
" }, "SortDefinitionKey": { "type": "string", @@ -4632,7 +4799,7 @@ }, "ResourceTags": { "shape": "ResourceTagList", - "documentation": "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
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
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.
" + "documentation": "Explains the actions that you might need to take to successfully migrate your workloads from the current instance type to the recommended instance type.
" } }, "documentation": "Details on recommended instance.
" @@ -4777,11 +4944,11 @@ "members": { "ResourceArn": { "shape": "Arn", - "documentation": "The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see ResourceTag.
" + "documentation": "The Amazon Resource Name (ARN) of the resource. For a list of supported resources, see ResourceTag.
" }, "ResourceTagKeys": { "shape": "ResourceTagKeyList", - "documentation": "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.
" + "documentation": "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.
" } } }, @@ -4867,6 +5034,53 @@ } } }, + "UpdateCostAllocationTagsStatusError": { + "type": "structure", + "members": { + "TagKey": { + "shape": "TagKey", + "documentation": "The key for the cost allocation tag.
" + }, + "Code": { + "shape": "GenericString", + "documentation": "An error code representing why the action failed on this entry.
" + }, + "Message": { + "shape": "ErrorMessage", + "documentation": "A message explaining why the action failed on this entry.
" + } + }, + "documentation": "Gives a detailed description of the result of an action. It's on each cost allocation tag entry in the request.
" + }, + "UpdateCostAllocationTagsStatusErrors": { + "type": "list", + "member": { + "shape": "UpdateCostAllocationTagsStatusError" + }, + "max": 20, + "min": 0 + }, + "UpdateCostAllocationTagsStatusRequest": { + "type": "structure", + "required": [ + "CostAllocationTagsStatus" + ], + "members": { + "CostAllocationTagsStatus": { + "shape": "CostAllocationTagStatusList", + "documentation": "The list of CostAllocationTagStatusEntry
objects that are used to update cost allocation tags status for this request.
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 unique identifier for your Cost Category.
" + "documentation": "The unique identifier for your Cost Category.
" }, "EffectiveStart": { "shape": "ZonedDateTime", - "documentation": "The Cost Category's effective start date.
" + "documentation": "The Cost Category's effective start date.
" } } }, @@ -4958,7 +5172,7 @@ }, "ZonedDateTime": { "type": "string", - "documentation": "The time period that you want the usage and costs for.
", + "documentation": "The period of time that you want the usage and costs for.
", "max": 25, "min": 20, "pattern": "^\\d{4}-\\d\\d-\\d\\dT\\d\\d:\\d\\d:\\d\\d(([+-]\\d\\d:\\d\\d)|Z)$" diff --git a/apis/ce-2017-10-25.paginators.json b/apis/ce-2017-10-25.paginators.json index 431b8e5dc5..1b58ad8f0e 100644 --- a/apis/ce-2017-10-25.paginators.json +++ b/apis/ce-2017-10-25.paginators.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/clients/auditmanager.d.ts b/clients/auditmanager.d.ts index b84f8f9062..a79bee9eff 100644 --- a/clients/auditmanager.d.ts +++ b/clients/auditmanager.d.ts @@ -276,11 +276,11 @@ declare class AuditManager extends Service { */ getOrganizationAdminAccount(callback?: (err: AWSError, data: AuditManager.Types.GetOrganizationAdminAccountResponse) => void): Request>1,l=23===i?Math.pow(2,-24)-Math.pow(2,-77):0,d=a?0:s-1,y=a?1:-1,b=t<0||0===t&&1/t<0?1:0;for(t=Math.abs(t),isNaN(t)||t===1/0?(n=isNaN(t)?1:0,o=m):(o=Math.floor(Math.log(t)/Math.LN2),t*(u=Math.pow(2,-o))<1&&(o--,u*=2),t+=o+c>=1?l/u:l*Math.pow(2,1-c),t*u>=2&&(o++,u/=2),o+c>=m?(n=0,o=m):o+c>=1?(n=(t*u-1)*Math.pow(2,i),o+=c):(n=t*Math.pow(2,c-1)*Math.pow(2,i),o=0));i>=8;e[r+d]=255&n,d+=y,n/=256,i-=8);for(o=o<0;e[r+d]=255&o,d+=y,o/=256,p-=8);e[r+d-y]|=128*b}},{}],430:[function(e,t,r){var a={}.toString;t.exports=Array.isArray||function(e){return"[object Array]"==a.call(e)}},{}],431:[function(e,t,r){!function(e){"use strict";function t(e){return null!==e&&"[object Array]"===Object.prototype.toString.call(e)}function r(e){return null!==e&&"[object Object]"===Object.prototype.toString.call(e)}function a(e,i){if(e===i)return!0;if(Object.prototype.toString.call(e)!==Object.prototype.toString.call(i))return!1;if(!0===t(e)){if(e.length!==i.length)return!1;for(var s=0;s =0?this.expression(e):"Lbracket"===t?(this._match("Lbracket"),this._parseMultiselectList()):"Lbrace"===t?(this._match("Lbrace"),this._parseMultiselectHash()):void 0},_parseProjectionRHS:function(e){var t;if(P[this._lookahead(0)]<10)t={type:"Identity"};else if("Lbracket"===this._lookahead(0))t=this.expression(e);else if("Filter"===this._lookahead(0))t=this.expression(e);else{if("Dot"!==this._lookahead(0)){var r=this._lookaheadToken(0),a=new Error("Sytanx error, unexpected token: "+r.value+"("+r.type+")");throw a.name="ParserError",a}this._match("Dot"),t=this._parseDotRHS(e)}return t},_parseMultiselectList:function(){for(var e=[];"Rbracket"!==this._lookahead(0);){var t=this.expression(0);if(e.push(t),"Comma"===this._lookahead(0)&&(this._match("Comma"),"Rbracket"===this._lookahead(0)))throw new Error("Unexpected token Rbracket")}return this._match("Rbracket"),{type:"MultiSelectList",children:e}},_parseMultiselectHash:function(){for(var e,t,r,a,i=[],s=["UnquotedIdentifier","QuotedIdentifier"];;){if(e=this._lookaheadToken(0),s.indexOf(e.type)<0)throw new Error("Expecting an identifier token, got: "+e.type);if(t=e.value,this._advance(),this._match("Colon"),r=this.expression(0),a={type:"KeyValuePair",name:t,value:r},i.push(a),"Comma"===this._lookahead(0))this._match("Comma");else if("Rbrace"===this._lookahead(0)){this._match("Rbrace");break}}return{type:"MultiSelectHash",children:i}}},c.prototype={search:function(e,t){return this.visit(e,t)},visit:function(e,o){var n,u,p,m,c,l,d,y,b;switch(e.type){case"Field":return null!==o&&r(o)?(l=o[e.name],void 0===l?null:l):null;case"Subexpression":for(p=this.visit(e.children[0],o),b=1;b G((f-r)/g)&&i("overflow"),r+=(p-t)*g,t=p,u=0;u =0?(c=b.substr(0,S),l=b.substr(S+1)):(c=b,l=""),d=decodeURIComponent(c),y=decodeURIComponent(l),a(o,d)?i(o[d])?o[d].push(y):o[d]=[o[d],y]:o[d]=y}return o};var i=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],435:[function(e,t,r){"use strict";function a(e,t){if(e.map)return e.map(t);for(var r=[],a=0;a >1,l=23===i?Math.pow(2,-24)-Math.pow(2,-77):0,d=a?0:s-1,y=a?1:-1,b=t<0||0===t&&1/t<0?1:0;for(t=Math.abs(t),isNaN(t)||t===1/0?(n=isNaN(t)?1:0,o=m):(o=Math.floor(Math.log(t)/Math.LN2),t*(u=Math.pow(2,-o))<1&&(o--,u*=2),t+=o+c>=1?l/u:l*Math.pow(2,1-c),t*u>=2&&(o++,u/=2),o+c>=m?(n=0,o=m):o+c>=1?(n=(t*u-1)*Math.pow(2,i),o+=c):(n=t*Math.pow(2,c-1)*Math.pow(2,i),o=0));i>=8;e[r+d]=255&n,d+=y,n/=256,i-=8);for(o=o<0;e[r+d]=255&o,d+=y,o/=256,p-=8);e[r+d-y]|=128*b}},{}],430:[function(e,t,r){var a={}.toString;t.exports=Array.isArray||function(e){return"[object Array]"==a.call(e)}},{}],431:[function(e,t,r){!function(e){"use strict";function t(e){return null!==e&&"[object Array]"===Object.prototype.toString.call(e)}function r(e){return null!==e&&"[object Object]"===Object.prototype.toString.call(e)}function a(e,i){if(e===i)return!0;if(Object.prototype.toString.call(e)!==Object.prototype.toString.call(i))return!1;if(!0===t(e)){if(e.length!==i.length)return!1;for(var s=0;s =0?this.expression(e):"Lbracket"===t?(this._match("Lbracket"),this._parseMultiselectList()):"Lbrace"===t?(this._match("Lbrace"),this._parseMultiselectHash()):void 0},_parseProjectionRHS:function(e){var t;if(P[this._lookahead(0)]<10)t={type:"Identity"};else if("Lbracket"===this._lookahead(0))t=this.expression(e);else if("Filter"===this._lookahead(0))t=this.expression(e);else{if("Dot"!==this._lookahead(0)){var r=this._lookaheadToken(0),a=new Error("Sytanx error, unexpected token: "+r.value+"("+r.type+")");throw a.name="ParserError",a}this._match("Dot"),t=this._parseDotRHS(e)}return t},_parseMultiselectList:function(){for(var e=[];"Rbracket"!==this._lookahead(0);){var t=this.expression(0);if(e.push(t),"Comma"===this._lookahead(0)&&(this._match("Comma"),"Rbracket"===this._lookahead(0)))throw new Error("Unexpected token Rbracket")}return this._match("Rbracket"),{type:"MultiSelectList",children:e}},_parseMultiselectHash:function(){for(var e,t,r,a,i=[],s=["UnquotedIdentifier","QuotedIdentifier"];;){if(e=this._lookaheadToken(0),s.indexOf(e.type)<0)throw new Error("Expecting an identifier token, got: "+e.type);if(t=e.value,this._advance(),this._match("Colon"),r=this.expression(0),a={type:"KeyValuePair",name:t,value:r},i.push(a),"Comma"===this._lookahead(0))this._match("Comma");else if("Rbrace"===this._lookahead(0)){this._match("Rbrace");break}}return{type:"MultiSelectHash",children:i}}},c.prototype={search:function(e,t){return this.visit(e,t)},visit:function(e,o){var n,u,p,m,c,l,d,y,b;switch(e.type){case"Field":return null!==o&&r(o)?(l=o[e.name],void 0===l?null:l):null;case"Subexpression":for(p=this.visit(e.children[0],o),b=1;b G((f-r)/g)&&i("overflow"),r+=(p-t)*g,t=p,u=0;u =0?(c=b.substr(0,S),l=b.substr(S+1)):(c=b,l=""),d=decodeURIComponent(c),y=decodeURIComponent(l),a(o,d)?i(o[d])?o[d].push(y):o[d]=[o[d],y]:o[d]=y}return o};var i=Array.isArray||function(e){return"[object Array]"===Object.prototype.toString.call(e)}},{}],435:[function(e,t,r){"use strict";function a(e,t){if(e.map)return e.map(t);for(var r=[],a=0;a=55296&&t<=56319&&i65535&&(e-=65536,t+=w(e>>>10&1023|55296),e=56320|1023&e),t+=w(e)}).join("")}function p(e){return e-48<10?e-22:e-65<26?e-65:e-97<26?e-97:T}function m(e,t){return e+22+75*(e<26)-((0!=t)<<5)}function c(e,t,r){var a=0;for(e=r?G(e/R):e>>1,e+=G(e/t);e>L*k>>1;a+=T)e=G(e/L);return G(a+(L+1)*e/(e+A))}function l(e){var t,r,a,s,o,n,m,l,d,y,b=[],S=e.length,g=0,h=v,N=D;for(r=e.lastIndexOf(P),r<0&&(r=0),a=0;a=S&&i("invalid-input"),l=p(e.charCodeAt(s++)),(l>=T||l>G((f-g)/n))&&i("overflow"),g+=l*n,d=m<=N?C:m>=N+k?k:m-N,!(l=t&&bf&&i("overflow"),b==t){for(l=r,d=T;y=d<=o?C:d>=o+k?k:d-o,!(l>5]>>>t%32&255,a=parseInt(o.charAt(r>>>4&15)+o.charAt(15&r),16),i.push(a);return i}function s(e,t){e[t>>5]|=128<0){t=new n.XML.Parser;var c=t.parse(a.toString(),s);u.update(e.data,c)}}var n=e("../core"),u=e("../util"),p=e("./rest");t.exports={buildRequest:i,extractError:s,extractData:o}},{"../core":342,"../util":418,"./rest":379}],382:[function(e,t,r){function a(){}function i(e){return e.isQueryName||"ec2"!==e.api.protocol?e.name:e.name[0].toUpperCase()+e.name.substr(1)}function s(e,t,r,a){p.each(r.members,function(r,s){var o=t[r];if(null!==o&&void 0!==o){var n=i(s);n=e?e+"."+n:n,u(n,o,s,a)}})}function o(e,t,r,a){var i=1;p.each(t,function(t,s){var o=r.flattened?".":".entry.",n=o+i+++".",p=n+(r.key.name||"key"),m=n+(r.value.name||"value");u(e+p,t,r.key,a),u(e+m,s,r.value,a)})}function n(e,t,r,a){var s=r.member||{};if(0===t.length)return void a.call(this,e,null);p.arrayEach(t,function(t,o){var n="."+(o+1);if("ec2"===r.api.protocol)n+="";else if(r.flattened){if(s.name){var p=e.split(".");p.pop(),p.push(i(s)),e=p.join(".")}}else n="."+(s.name?s.name:"member")+n;u(e+n,t,s,a)})}function u(e,t,r,a){null!==t&&void 0!==t&&("structure"===r.type?s(e,t,r,a):"list"===r.type?n(e,t,r,a):"map"===r.type?o(e,t,r,a):a(e,r.toWireFormat(t).toString()))}var p=e("../util");a.prototype.serialize=function(e,t,r){s("",e,t,r)},t.exports=a},{"../util":418}],383:[function(e,t,r){var a=e("../core"),i=null,s={signatureVersion:"v4",signingName:"rds-db",operations:{}},o={region:"string",hostname:"string",port:"number",username:"string"};a.RDS.Signer=a.util.inherit({constructor:function(e){this.options=e||{}},convertUrlToAuthToken:function(e){if(0===e.indexOf("https://"))return e.substring("https://".length)},getAuthToken:function(e,t){"function"==typeof e&&void 0===t&&(t=e,e={});var r=this,o="function"==typeof t;e=a.util.merge(this.options,e);var n=this.validateAuthTokenOptions(e);if(!0!==n){if(o)return t(n,null);throw n}var u={region:e.region,endpoint:new a.Endpoint(e.hostname+":"+e.port),paramValidation:!1,signatureVersion:"v4"};e.credentials&&(u.credentials=e.credentials),i=new a.Service(u),i.api=s;var p=i.makeRequest();if(this.modifyRequestForAuthToken(p,e),!o){var m=p.presign(900);return this.convertUrlToAuthToken(m)}p.presign(900,function(e,a){a&&(a=r.convertUrlToAuthToken(a)),t(e,a)})},modifyRequestForAuthToken:function(e,t){e.on("build",e.buildAsGet),e.httpRequest.body=a.util.queryParamsToString({Action:"connect",DBUser:t.username})},validateAuthTokenOptions:function(e){var t="";e=e||{};for(var r in o)Object.prototype.hasOwnProperty.call(o,r)&&typeof e[r]!==o[r]&&(t+="option '"+r+"' should have been type '"+o[r]+"', was '"+typeof e[r]+"'.\n");return!t.length||a.util.error(new Error,{code:"InvalidParameter",message:t})}})},{"../core":342}],384:[function(e,t,r){t.exports={now:function(){return"undefined"!=typeof performance&&"function"==typeof performance.now?performance.now():Date.now()}}},{}],385:[function(e,t,r){function a(e){return"string"==typeof e&&(e.startsWith("fips-")||e.endsWith("-fips"))}function i(e){return"string"==typeof e&&["aws-global","aws-us-gov-global"].includes(e)}function s(e){return["fips-aws-global","aws-fips","aws-global"].includes(e)?"us-east-1":["fips-aws-us-gov-global","aws-us-gov-global"].includes(e)?"us-gov-west-1":e.replace(/fips-(dkr-|prod-)?|-fips/,"")}t.exports={isFipsRegion:a,isGlobalRegion:i,getRealRegion:s}},{}],386:[function(e,t,r){function a(e){if(!e)return null;var t=e.split("-");return t.length<3?null:t.slice(0,t.length-2).join("-")+"-*"}function i(e){var t=e.config.region,r=a(t),i=e.api.endpointPrefix;return[[t,i],[r,i],[t,"*"],[r,"*"],["*",i],["*","*"]].map(function(e){return e[0]&&e[1]?e.join("/"):null})}function s(e,t){u.each(t,function(t,r){"globalEndpoint"!==t&&(void 0!==e.config[t]&&null!==e.config[t]||(e.config[t]=r))})}function o(e){for(var t=i(e),r=e.config.useFipsEndpoint,a=e.config.useDualstackEndpoint,o=0;o>>8*(a?i:1-i)}function B(e,t,r,a){t<0&&(t=4294967295+t+1);for(var i=0,s=Math.min(e.length-r,4);i>>8*(a?i:3-i)&255}function U(e,t,r,a,i,s){if(r+a>e.length)throw new RangeError("Index out of range");if(r<0)throw new RangeError("Index out of range")}function _(e,t,r,a,i){return i||U(e,t,r,4,3.4028234663852886e38,-3.4028234663852886e38),X.write(e,t,r,a,23,4),r+4}function F(e,t,r,a,i){return i||U(e,t,r,8,1.7976931348623157e308,-1.7976931348623157e308),X.write(e,t,r,a,52,8),r+8}function O(e){if(e=V(e).replace(ee,""),e.length<2)return"";for(;e.length%4!=0;)e+="=";return e}function V(e){return e.trim?e.trim():e.replace(/^\s+|\s+$/g,"")}function z(e){return e<16?"0"+e.toString(16):e.toString(16)}function K(e,t){t=t||1/0;for(var r,a=e.length,i=null,s=[],o=0;o55295&&r<57344){if(!i){if(r>56319){(t-=3)>-1&&s.push(239,191,189);continue}if(o+1===a){(t-=3)>-1&&s.push(239,191,189);continue}i=r;continue}if(r<56320){(t-=3)>-1&&s.push(239,191,189),i=r;continue}r=65536+(i-55296<<10|r-56320)}else i&&(t-=3)>-1&&s.push(239,191,189);if(i=null,r<128){if((t-=1)<0)break;s.push(r)}else if(r<2048){if((t-=2)<0)break;s.push(r>>6|192,63&r|128)}else if(r<65536){if((t-=3)<0)break;s.push(r>>12|224,r>>6&63|128,63&r|128)}else{if(!(r<1114112))throw new Error("Invalid code point");if((t-=4)<0)break;s.push(r>>18|240,r>>12&63|128,r>>6&63|128,63&r|128)}}return s}function j(e){for(var t=[],r=0;r=55296&&t<=56319&&i65535&&(e-=65536,t+=w(e>>>10&1023|55296),e=56320|1023&e),t+=w(e)}).join("")}function p(e){return e-48<10?e-22:e-65<26?e-65:e-97<26?e-97:T}function m(e,t){return e+22+75*(e<26)-((0!=t)<<5)}function c(e,t,r){var a=0;for(e=r?G(e/R):e>>1,e+=G(e/t);e>L*k>>1;a+=T)e=G(e/L);return G(a+(L+1)*e/(e+A))}function l(e){var t,r,a,s,o,n,m,l,d,y,b=[],S=e.length,g=0,h=v,N=D;for(r=e.lastIndexOf(P),r<0&&(r=0),a=0;a=S&&i("invalid-input"),l=p(e.charCodeAt(s++)),(l>=T||l>G((f-g)/n))&&i("overflow"),g+=l*n,d=m<=N?C:m>=N+k?k:m-N,!(l=t&&bf&&i("overflow"),b==t){for(l=r,d=T;y=d<=o?C:d>=o+k?k:d-o,!(l>5]>>>t%32&255,a=parseInt(o.charAt(r>>>4&15)+o.charAt(15&r),16),i.push(a);return i}function s(e,t){e[t>>5]|=128<