aws-sdk-costexplorer 1.156.0 → 1.158.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-costexplorer/client.rb +333 -62
- data/lib/aws-sdk-costexplorer/client_api.rb +13 -0
- data/lib/aws-sdk-costexplorer/types.rb +331 -32
- data/lib/aws-sdk-costexplorer.rb +1 -1
- data/sig/client.rbs +9 -8
- data/sig/errors.rbs +15 -15
- data/sig/params.rbs +24 -4
- data/sig/types.rbs +12 -3
- metadata +3 -3
|
@@ -617,8 +617,8 @@ module Aws::CostExplorer
|
|
|
617
617
|
#
|
|
618
618
|
# * Simple dimension values.
|
|
619
619
|
#
|
|
620
|
-
# * There are
|
|
621
|
-
# `CostCategories`, `Tags`, and `
|
|
620
|
+
# * There are four types of simple dimension values:
|
|
621
|
+
# `CostCategories`, `Tags`, `Dimensions`, and `ProductAttributes`.
|
|
622
622
|
#
|
|
623
623
|
# * Specify the `CostCategories` field to define a filter that
|
|
624
624
|
# acts on Cost Categories.
|
|
@@ -628,6 +628,15 @@ module Aws::CostExplorer
|
|
|
628
628
|
#
|
|
629
629
|
# * Specify the `Dimensions` field to define a filter that acts on
|
|
630
630
|
# the [ `DimensionValues` ][1].
|
|
631
|
+
#
|
|
632
|
+
# * Specify the `ProductAttributes` field to define a filter that
|
|
633
|
+
# acts on the product attributes of supported services, such as
|
|
634
|
+
# Amazon Bedrock. Only `GetCostAndUsage`,
|
|
635
|
+
# `GetCostAndUsageWithResources`, `GetDimensionValues` (in the
|
|
636
|
+
# `COST_AND_USAGE` context), `GetTags`, and `GetCostCategories`
|
|
637
|
+
# support `ProductAttributes`. For the supported services, keys
|
|
638
|
+
# and `SERVICE` filter rules, see [ `ProductAttributeValues`
|
|
639
|
+
# ][2].
|
|
631
640
|
# * For each filter type, you can set the dimension name and values
|
|
632
641
|
# for the filters that you plan to use.
|
|
633
642
|
#
|
|
@@ -697,6 +706,7 @@ module Aws::CostExplorer
|
|
|
697
706
|
#
|
|
698
707
|
#
|
|
699
708
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
|
|
709
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
700
710
|
# @return [Types::Expression]
|
|
701
711
|
#
|
|
702
712
|
# @!attribute [rw] metrics
|
|
@@ -1071,8 +1081,8 @@ module Aws::CostExplorer
|
|
|
1071
1081
|
#
|
|
1072
1082
|
# * Simple dimension values.
|
|
1073
1083
|
#
|
|
1074
|
-
# * There are
|
|
1075
|
-
# `CostCategories`, `Tags`, and `
|
|
1084
|
+
# * There are four types of simple dimension values:
|
|
1085
|
+
# `CostCategories`, `Tags`, `Dimensions`, and `ProductAttributes`.
|
|
1076
1086
|
#
|
|
1077
1087
|
# * Specify the `CostCategories` field to define a filter that
|
|
1078
1088
|
# acts on Cost Categories.
|
|
@@ -1082,6 +1092,15 @@ module Aws::CostExplorer
|
|
|
1082
1092
|
#
|
|
1083
1093
|
# * Specify the `Dimensions` field to define a filter that acts on
|
|
1084
1094
|
# the [ `DimensionValues` ][1].
|
|
1095
|
+
#
|
|
1096
|
+
# * Specify the `ProductAttributes` field to define a filter that
|
|
1097
|
+
# acts on the product attributes of supported services, such as
|
|
1098
|
+
# Amazon Bedrock. Only `GetCostAndUsage`,
|
|
1099
|
+
# `GetCostAndUsageWithResources`, `GetDimensionValues` (in the
|
|
1100
|
+
# `COST_AND_USAGE` context), `GetTags`, and `GetCostCategories`
|
|
1101
|
+
# support `ProductAttributes`. For the supported services, keys
|
|
1102
|
+
# and `SERVICE` filter rules, see [ `ProductAttributeValues`
|
|
1103
|
+
# ][2].
|
|
1085
1104
|
# * For each filter type, you can set the dimension name and values
|
|
1086
1105
|
# for the filters that you plan to use.
|
|
1087
1106
|
#
|
|
@@ -1151,6 +1170,7 @@ module Aws::CostExplorer
|
|
|
1151
1170
|
#
|
|
1152
1171
|
#
|
|
1153
1172
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
|
|
1173
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
1154
1174
|
# @return [Types::Expression]
|
|
1155
1175
|
#
|
|
1156
1176
|
# @!attribute [rw] metrics
|
|
@@ -1784,6 +1804,11 @@ module Aws::CostExplorer
|
|
|
1784
1804
|
# `ANOMALY_TOTAL_IMPACT_PERCENTAGE` can only be used in
|
|
1785
1805
|
# [AnomalySubscriptions][2].
|
|
1786
1806
|
#
|
|
1807
|
+
# Use `PRODUCT_ATTRIBUTE` only as the `Dimension` in
|
|
1808
|
+
# `GetDimensionValues`. To filter or group by product attributes, use
|
|
1809
|
+
# the `ProductAttributes` field of `Expression` or the
|
|
1810
|
+
# `PRODUCT_ATTRIBUTE` group type.
|
|
1811
|
+
#
|
|
1787
1812
|
#
|
|
1788
1813
|
#
|
|
1789
1814
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html
|
|
@@ -2174,8 +2199,8 @@ module Aws::CostExplorer
|
|
|
2174
2199
|
#
|
|
2175
2200
|
# * Simple dimension values.
|
|
2176
2201
|
#
|
|
2177
|
-
# * There are
|
|
2178
|
-
# `
|
|
2202
|
+
# * There are four types of simple dimension values: `CostCategories`,
|
|
2203
|
+
# `Tags`, `Dimensions`, and `ProductAttributes`.
|
|
2179
2204
|
#
|
|
2180
2205
|
# * Specify the `CostCategories` field to define a filter that acts
|
|
2181
2206
|
# on Cost Categories.
|
|
@@ -2185,6 +2210,14 @@ module Aws::CostExplorer
|
|
|
2185
2210
|
#
|
|
2186
2211
|
# * Specify the `Dimensions` field to define a filter that acts on
|
|
2187
2212
|
# the [ `DimensionValues` ][1].
|
|
2213
|
+
#
|
|
2214
|
+
# * Specify the `ProductAttributes` field to define a filter that
|
|
2215
|
+
# acts on the product attributes of supported services, such as
|
|
2216
|
+
# Amazon Bedrock. Only `GetCostAndUsage`,
|
|
2217
|
+
# `GetCostAndUsageWithResources`, `GetDimensionValues` (in the
|
|
2218
|
+
# `COST_AND_USAGE` context), `GetTags`, and `GetCostCategories`
|
|
2219
|
+
# support `ProductAttributes`. For the supported services, keys
|
|
2220
|
+
# and `SERVICE` filter rules, see [ `ProductAttributeValues` ][2].
|
|
2188
2221
|
# * For each filter type, you can set the dimension name and values
|
|
2189
2222
|
# for the filters that you plan to use.
|
|
2190
2223
|
#
|
|
@@ -2252,6 +2285,7 @@ module Aws::CostExplorer
|
|
|
2252
2285
|
#
|
|
2253
2286
|
#
|
|
2254
2287
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
|
|
2288
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
2255
2289
|
#
|
|
2256
2290
|
# @!attribute [rw] or
|
|
2257
2291
|
# Return results that match either `Dimension` object.
|
|
@@ -2277,6 +2311,20 @@ module Aws::CostExplorer
|
|
|
2277
2311
|
# The filter that's based on `CostCategory` values.
|
|
2278
2312
|
# @return [Types::CostCategoryValues]
|
|
2279
2313
|
#
|
|
2314
|
+
# @!attribute [rw] product_attributes
|
|
2315
|
+
# The filter that's based on `ProductAttributeValues`. Use it to
|
|
2316
|
+
# filter the costs of supported services, such as Amazon Bedrock, by
|
|
2317
|
+
# product attributes. The following operations support this filter:
|
|
2318
|
+
# `GetCostAndUsage`, `GetCostAndUsageWithResources`,
|
|
2319
|
+
# `GetDimensionValues` (in the `COST_AND_USAGE` context), `GetTags`,
|
|
2320
|
+
# and `GetCostCategories`. For the supported services and keys, see [
|
|
2321
|
+
# `ProductAttributeValues` ][1].
|
|
2322
|
+
#
|
|
2323
|
+
#
|
|
2324
|
+
#
|
|
2325
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
2326
|
+
# @return [Types::ProductAttributeValues]
|
|
2327
|
+
#
|
|
2280
2328
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/Expression AWS API Documentation
|
|
2281
2329
|
#
|
|
2282
2330
|
class Expression < Struct.new(
|
|
@@ -2285,7 +2333,8 @@ module Aws::CostExplorer
|
|
|
2285
2333
|
:not,
|
|
2286
2334
|
:dimensions,
|
|
2287
2335
|
:tags,
|
|
2288
|
-
:cost_categories
|
|
2336
|
+
:cost_categories,
|
|
2337
|
+
:product_attributes)
|
|
2289
2338
|
SENSITIVE = []
|
|
2290
2339
|
include Aws::Structure
|
|
2291
2340
|
end
|
|
@@ -2676,8 +2725,8 @@ module Aws::CostExplorer
|
|
|
2676
2725
|
#
|
|
2677
2726
|
# * Simple dimension values.
|
|
2678
2727
|
#
|
|
2679
|
-
# * There are
|
|
2680
|
-
# `CostCategories`, `Tags`, and `
|
|
2728
|
+
# * There are four types of simple dimension values:
|
|
2729
|
+
# `CostCategories`, `Tags`, `Dimensions`, and `ProductAttributes`.
|
|
2681
2730
|
#
|
|
2682
2731
|
# * Specify the `CostCategories` field to define a filter that
|
|
2683
2732
|
# acts on Cost Categories.
|
|
@@ -2687,6 +2736,15 @@ module Aws::CostExplorer
|
|
|
2687
2736
|
#
|
|
2688
2737
|
# * Specify the `Dimensions` field to define a filter that acts on
|
|
2689
2738
|
# the [ `DimensionValues` ][1].
|
|
2739
|
+
#
|
|
2740
|
+
# * Specify the `ProductAttributes` field to define a filter that
|
|
2741
|
+
# acts on the product attributes of supported services, such as
|
|
2742
|
+
# Amazon Bedrock. Only `GetCostAndUsage`,
|
|
2743
|
+
# `GetCostAndUsageWithResources`, `GetDimensionValues` (in the
|
|
2744
|
+
# `COST_AND_USAGE` context), `GetTags`, and `GetCostCategories`
|
|
2745
|
+
# support `ProductAttributes`. For the supported services, keys
|
|
2746
|
+
# and `SERVICE` filter rules, see [ `ProductAttributeValues`
|
|
2747
|
+
# ][2].
|
|
2690
2748
|
# * For each filter type, you can set the dimension name and values
|
|
2691
2749
|
# for the filters that you plan to use.
|
|
2692
2750
|
#
|
|
@@ -2756,6 +2814,7 @@ module Aws::CostExplorer
|
|
|
2756
2814
|
#
|
|
2757
2815
|
#
|
|
2758
2816
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
|
|
2817
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
2759
2818
|
# @return [Types::Expression]
|
|
2760
2819
|
#
|
|
2761
2820
|
# @!attribute [rw] group_by
|
|
@@ -2837,13 +2896,25 @@ module Aws::CostExplorer
|
|
|
2837
2896
|
# Valid values for `MatchOptions` for `Dimensions` are `EQUALS` and
|
|
2838
2897
|
# `CASE_SENSITIVE`.
|
|
2839
2898
|
#
|
|
2840
|
-
# Valid values for `MatchOptions` for `CostCategories
|
|
2841
|
-
# `EQUALS`, `ABSENT`, and `CASE_SENSITIVE`.
|
|
2842
|
-
# `EQUALS` and `CASE_SENSITIVE`.
|
|
2899
|
+
# Valid values for `MatchOptions` for `CostCategories`, `Tags`, and
|
|
2900
|
+
# `ProductAttributes` are `EQUALS`, `ABSENT`, and `CASE_SENSITIVE`.
|
|
2901
|
+
# Default values are `EQUALS` and `CASE_SENSITIVE`.
|
|
2902
|
+
#
|
|
2903
|
+
# You can filter by product attributes with or without grouping by
|
|
2904
|
+
# them. If you filter or group by product attributes, the results
|
|
2905
|
+
# include only the costs of supported services, and a `SERVICE` filter
|
|
2906
|
+
# is optional. For more information, see [ProductAttributeValues][2].
|
|
2907
|
+
#
|
|
2908
|
+
# If you include a `SERVICE` filter, it must apply to the whole
|
|
2909
|
+
# request: combine it with other filters by using `And`, and include
|
|
2910
|
+
# it in every branch of an `Or`. A `SERVICE` filter inside `Not`
|
|
2911
|
+
# doesn't meet this requirement, and the request fails with a
|
|
2912
|
+
# `ValidationException`.
|
|
2843
2913
|
#
|
|
2844
2914
|
#
|
|
2845
2915
|
#
|
|
2846
2916
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
|
|
2917
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
2847
2918
|
# @return [Types::Expression]
|
|
2848
2919
|
#
|
|
2849
2920
|
# @!attribute [rw] metrics
|
|
@@ -2874,8 +2945,8 @@ module Aws::CostExplorer
|
|
|
2874
2945
|
#
|
|
2875
2946
|
# @!attribute [rw] group_by
|
|
2876
2947
|
# You can group Amazon Web Services costs using up to two different
|
|
2877
|
-
# groups, either dimensions, tag keys, cost categories,
|
|
2878
|
-
# group by types.
|
|
2948
|
+
# groups, either dimensions, tag keys, cost categories, product
|
|
2949
|
+
# attributes, or any two group by types.
|
|
2879
2950
|
#
|
|
2880
2951
|
# Valid values for the `DIMENSION` type are `AZ`, `INSTANCE_TYPE`,
|
|
2881
2952
|
# `LEGAL_ENTITY_NAME`, `INVOICING_ENTITY`, `LINKED_ACCOUNT`,
|
|
@@ -2884,6 +2955,24 @@ module Aws::CostExplorer
|
|
|
2884
2955
|
#
|
|
2885
2956
|
# When you group by the `TAG` type and include a valid tag key, you
|
|
2886
2957
|
# get all tag values, including empty strings.
|
|
2958
|
+
#
|
|
2959
|
+
# To group by the `PRODUCT_ATTRIBUTE` type, set `Key` to a product
|
|
2960
|
+
# attribute key, such as `model`. For the keys of each supported
|
|
2961
|
+
# service, see [ProductAttributeValues][1]. The results include only
|
|
2962
|
+
# the costs of supported services, and if you have no such costs, the
|
|
2963
|
+
# response contains no groups.
|
|
2964
|
+
#
|
|
2965
|
+
# In the response, each group key has the format `key$value`, for
|
|
2966
|
+
# example, `model$Claude Sonnet 5`. Costs that have no value for the
|
|
2967
|
+
# key are in the group `key$`, for example, `model$`. Remove the
|
|
2968
|
+
# `key$` prefix before you use a value in a `ProductAttributes`
|
|
2969
|
+
# filter. Keys are case-sensitive: if you group by a key that doesn't
|
|
2970
|
+
# exist, such as `Model`, all of your costs of supported services are
|
|
2971
|
+
# in the group `Model$`.
|
|
2972
|
+
#
|
|
2973
|
+
#
|
|
2974
|
+
#
|
|
2975
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
2887
2976
|
# @return [Array<Types::GroupDefinition>]
|
|
2888
2977
|
#
|
|
2889
2978
|
# @!attribute [rw] billing_view_arn
|
|
@@ -2978,13 +3067,17 @@ module Aws::CostExplorer
|
|
|
2978
3067
|
# Valid values for `MatchOptions` for `Dimensions` are `EQUALS` and
|
|
2979
3068
|
# `CASE_SENSITIVE`.
|
|
2980
3069
|
#
|
|
2981
|
-
# Valid values for `MatchOptions` for `CostCategories
|
|
2982
|
-
# `EQUALS`, `ABSENT`, and `CASE_SENSITIVE`.
|
|
2983
|
-
# `EQUALS` and `CASE_SENSITIVE`.
|
|
3070
|
+
# Valid values for `MatchOptions` for `CostCategories`, `Tags`, and
|
|
3071
|
+
# `ProductAttributes` are `EQUALS`, `ABSENT`, and `CASE_SENSITIVE`.
|
|
3072
|
+
# Default values are `EQUALS` and `CASE_SENSITIVE`.
|
|
3073
|
+
#
|
|
3074
|
+
# If you filter or group by product attributes, the `SERVICE` filter
|
|
3075
|
+
# rules are the same as for [GetCostAndUsage][2].
|
|
2984
3076
|
#
|
|
2985
3077
|
#
|
|
2986
3078
|
#
|
|
2987
3079
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
|
|
3080
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetCostAndUsage.html
|
|
2988
3081
|
# @return [Types::Expression]
|
|
2989
3082
|
#
|
|
2990
3083
|
# @!attribute [rw] metrics
|
|
@@ -3015,7 +3108,17 @@ module Aws::CostExplorer
|
|
|
3015
3108
|
#
|
|
3016
3109
|
# @!attribute [rw] group_by
|
|
3017
3110
|
# You can group Amazon Web Services costs using up to two different
|
|
3018
|
-
# groups: `DIMENSION`, `TAG`, `COST_CATEGORY
|
|
3111
|
+
# groups: `DIMENSION`, `TAG`, `COST_CATEGORY`, and
|
|
3112
|
+
# `PRODUCT_ATTRIBUTE`.
|
|
3113
|
+
#
|
|
3114
|
+
# `PRODUCT_ATTRIBUTE` groups work the same way as in
|
|
3115
|
+
# [GetCostAndUsage][1]. A `PRODUCT_ATTRIBUTE` group or a
|
|
3116
|
+
# `ProductAttributes` filter doesn't meet the requirement to group by
|
|
3117
|
+
# or filter by a `ResourceId`.
|
|
3118
|
+
#
|
|
3119
|
+
#
|
|
3120
|
+
#
|
|
3121
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetCostAndUsage.html
|
|
3019
3122
|
# @return [Array<Types::GroupDefinition>]
|
|
3020
3123
|
#
|
|
3021
3124
|
# @!attribute [rw] billing_view_arn
|
|
@@ -3106,8 +3209,8 @@ module Aws::CostExplorer
|
|
|
3106
3209
|
#
|
|
3107
3210
|
# * Simple dimension values.
|
|
3108
3211
|
#
|
|
3109
|
-
# * There are
|
|
3110
|
-
# `CostCategories`, `Tags`, and `
|
|
3212
|
+
# * There are four types of simple dimension values:
|
|
3213
|
+
# `CostCategories`, `Tags`, `Dimensions`, and `ProductAttributes`.
|
|
3111
3214
|
#
|
|
3112
3215
|
# * Specify the `CostCategories` field to define a filter that
|
|
3113
3216
|
# acts on Cost Categories.
|
|
@@ -3117,6 +3220,15 @@ module Aws::CostExplorer
|
|
|
3117
3220
|
#
|
|
3118
3221
|
# * Specify the `Dimensions` field to define a filter that acts on
|
|
3119
3222
|
# the [ `DimensionValues` ][1].
|
|
3223
|
+
#
|
|
3224
|
+
# * Specify the `ProductAttributes` field to define a filter that
|
|
3225
|
+
# acts on the product attributes of supported services, such as
|
|
3226
|
+
# Amazon Bedrock. Only `GetCostAndUsage`,
|
|
3227
|
+
# `GetCostAndUsageWithResources`, `GetDimensionValues` (in the
|
|
3228
|
+
# `COST_AND_USAGE` context), `GetTags`, and `GetCostCategories`
|
|
3229
|
+
# support `ProductAttributes`. For the supported services, keys
|
|
3230
|
+
# and `SERVICE` filter rules, see [ `ProductAttributeValues`
|
|
3231
|
+
# ][2].
|
|
3120
3232
|
# * For each filter type, you can set the dimension name and values
|
|
3121
3233
|
# for the filters that you plan to use.
|
|
3122
3234
|
#
|
|
@@ -3186,6 +3298,7 @@ module Aws::CostExplorer
|
|
|
3186
3298
|
#
|
|
3187
3299
|
#
|
|
3188
3300
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
|
|
3301
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
3189
3302
|
# @return [Types::Expression]
|
|
3190
3303
|
#
|
|
3191
3304
|
# @!attribute [rw] sort_by
|
|
@@ -3335,8 +3448,8 @@ module Aws::CostExplorer
|
|
|
3335
3448
|
#
|
|
3336
3449
|
# * Simple dimension values.
|
|
3337
3450
|
#
|
|
3338
|
-
# * There are
|
|
3339
|
-
# `CostCategories`, `Tags`, and `
|
|
3451
|
+
# * There are four types of simple dimension values:
|
|
3452
|
+
# `CostCategories`, `Tags`, `Dimensions`, and `ProductAttributes`.
|
|
3340
3453
|
#
|
|
3341
3454
|
# * Specify the `CostCategories` field to define a filter that
|
|
3342
3455
|
# acts on Cost Categories.
|
|
@@ -3346,6 +3459,15 @@ module Aws::CostExplorer
|
|
|
3346
3459
|
#
|
|
3347
3460
|
# * Specify the `Dimensions` field to define a filter that acts on
|
|
3348
3461
|
# the [ `DimensionValues` ][1].
|
|
3462
|
+
#
|
|
3463
|
+
# * Specify the `ProductAttributes` field to define a filter that
|
|
3464
|
+
# acts on the product attributes of supported services, such as
|
|
3465
|
+
# Amazon Bedrock. Only `GetCostAndUsage`,
|
|
3466
|
+
# `GetCostAndUsageWithResources`, `GetDimensionValues` (in the
|
|
3467
|
+
# `COST_AND_USAGE` context), `GetTags`, and `GetCostCategories`
|
|
3468
|
+
# support `ProductAttributes`. For the supported services, keys
|
|
3469
|
+
# and `SERVICE` filter rules, see [ `ProductAttributeValues`
|
|
3470
|
+
# ][2].
|
|
3349
3471
|
# * For each filter type, you can set the dimension name and values
|
|
3350
3472
|
# for the filters that you plan to use.
|
|
3351
3473
|
#
|
|
@@ -3415,6 +3537,7 @@ module Aws::CostExplorer
|
|
|
3415
3537
|
#
|
|
3416
3538
|
#
|
|
3417
3539
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
|
|
3540
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
3418
3541
|
# @return [Types::Expression]
|
|
3419
3542
|
#
|
|
3420
3543
|
# @!attribute [rw] group_by
|
|
@@ -3620,11 +3743,38 @@ module Aws::CostExplorer
|
|
|
3620
3743
|
# `LINK_ACCOUNT_NAME` and `SERVICE_CODE` can only be used in
|
|
3621
3744
|
# [CostCategoryRule][1].
|
|
3622
3745
|
#
|
|
3746
|
+
# `PRODUCT_ATTRIBUTE` returns the product attribute keys that are
|
|
3747
|
+
# available for your costs of supported services, or the values of the
|
|
3748
|
+
# key that you specify in `DimensionKey`. `PRODUCT_ATTRIBUTE` is
|
|
3749
|
+
# supported only in the `COST_AND_USAGE` context.
|
|
3750
|
+
#
|
|
3623
3751
|
#
|
|
3624
3752
|
#
|
|
3625
3753
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/AAPI_CostCategoryRule.html
|
|
3626
3754
|
# @return [String]
|
|
3627
3755
|
#
|
|
3756
|
+
# @!attribute [rw] dimension_key
|
|
3757
|
+
# The product attribute key to return values for, such as `model`. If
|
|
3758
|
+
# you omit `DimensionKey` or set it to an empty string, the response
|
|
3759
|
+
# lists the product attribute keys that are available for your costs
|
|
3760
|
+
# of supported services instead. For the supported services, see
|
|
3761
|
+
# [ProductAttributeValues][1].
|
|
3762
|
+
#
|
|
3763
|
+
# If you specify a key, the response lists the values of that key. If
|
|
3764
|
+
# some of your costs have no value for the key, the response includes
|
|
3765
|
+
# an empty-string value. Keys are case-sensitive, and a key that
|
|
3766
|
+
# doesn't exist returns no values other than an empty string.
|
|
3767
|
+
#
|
|
3768
|
+
# You can specify `DimensionKey` only when `Dimension` is
|
|
3769
|
+
# `PRODUCT_ATTRIBUTE`. If you also specify `SortBy`, `DimensionKey` is
|
|
3770
|
+
# required. As a result, you can't list product attribute keys when
|
|
3771
|
+
# you use `SortBy`.
|
|
3772
|
+
#
|
|
3773
|
+
#
|
|
3774
|
+
#
|
|
3775
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
3776
|
+
# @return [String]
|
|
3777
|
+
#
|
|
3628
3778
|
# @!attribute [rw] context
|
|
3629
3779
|
# The context for the call to `GetDimensionValues`. This can be
|
|
3630
3780
|
# `RESERVATIONS` or `COST_AND_USAGE`. The default value is
|
|
@@ -3689,6 +3839,9 @@ module Aws::CostExplorer
|
|
|
3689
3839
|
# * PLATFORM - The Amazon EC2 operating system. Examples are Windows
|
|
3690
3840
|
# or Linux.
|
|
3691
3841
|
#
|
|
3842
|
+
# * PRODUCT\_ATTRIBUTE - The product attributes of supported services,
|
|
3843
|
+
# such as the model provider or the model for Amazon Bedrock.
|
|
3844
|
+
#
|
|
3692
3845
|
# * PURCHASE\_TYPE - The reservation type of the purchase that this
|
|
3693
3846
|
# usage is related to. Examples include On-Demand Instances and
|
|
3694
3847
|
# Standard Reserved Instances.
|
|
@@ -3786,8 +3939,8 @@ module Aws::CostExplorer
|
|
|
3786
3939
|
#
|
|
3787
3940
|
# * Simple dimension values.
|
|
3788
3941
|
#
|
|
3789
|
-
# * There are
|
|
3790
|
-
# `CostCategories`, `Tags`, and `
|
|
3942
|
+
# * There are four types of simple dimension values:
|
|
3943
|
+
# `CostCategories`, `Tags`, `Dimensions`, and `ProductAttributes`.
|
|
3791
3944
|
#
|
|
3792
3945
|
# * Specify the `CostCategories` field to define a filter that
|
|
3793
3946
|
# acts on Cost Categories.
|
|
@@ -3797,6 +3950,15 @@ module Aws::CostExplorer
|
|
|
3797
3950
|
#
|
|
3798
3951
|
# * Specify the `Dimensions` field to define a filter that acts on
|
|
3799
3952
|
# the [ `DimensionValues` ][1].
|
|
3953
|
+
#
|
|
3954
|
+
# * Specify the `ProductAttributes` field to define a filter that
|
|
3955
|
+
# acts on the product attributes of supported services, such as
|
|
3956
|
+
# Amazon Bedrock. Only `GetCostAndUsage`,
|
|
3957
|
+
# `GetCostAndUsageWithResources`, `GetDimensionValues` (in the
|
|
3958
|
+
# `COST_AND_USAGE` context), `GetTags`, and `GetCostCategories`
|
|
3959
|
+
# support `ProductAttributes`. For the supported services, keys
|
|
3960
|
+
# and `SERVICE` filter rules, see [ `ProductAttributeValues`
|
|
3961
|
+
# ][2].
|
|
3800
3962
|
# * For each filter type, you can set the dimension name and values
|
|
3801
3963
|
# for the filters that you plan to use.
|
|
3802
3964
|
#
|
|
@@ -3866,6 +4028,7 @@ module Aws::CostExplorer
|
|
|
3866
4028
|
#
|
|
3867
4029
|
#
|
|
3868
4030
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
|
|
4031
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
3869
4032
|
# @return [Types::Expression]
|
|
3870
4033
|
#
|
|
3871
4034
|
# @!attribute [rw] sort_by
|
|
@@ -3926,6 +4089,7 @@ module Aws::CostExplorer
|
|
|
3926
4089
|
:search_string,
|
|
3927
4090
|
:time_period,
|
|
3928
4091
|
:dimension,
|
|
4092
|
+
:dimension_key,
|
|
3929
4093
|
:context,
|
|
3930
4094
|
:filter,
|
|
3931
4095
|
:sort_by,
|
|
@@ -4266,8 +4430,8 @@ module Aws::CostExplorer
|
|
|
4266
4430
|
#
|
|
4267
4431
|
# * Simple dimension values.
|
|
4268
4432
|
#
|
|
4269
|
-
# * There are
|
|
4270
|
-
# `CostCategories`, `Tags`, and `
|
|
4433
|
+
# * There are four types of simple dimension values:
|
|
4434
|
+
# `CostCategories`, `Tags`, `Dimensions`, and `ProductAttributes`.
|
|
4271
4435
|
#
|
|
4272
4436
|
# * Specify the `CostCategories` field to define a filter that
|
|
4273
4437
|
# acts on Cost Categories.
|
|
@@ -4277,6 +4441,15 @@ module Aws::CostExplorer
|
|
|
4277
4441
|
#
|
|
4278
4442
|
# * Specify the `Dimensions` field to define a filter that acts on
|
|
4279
4443
|
# the [ `DimensionValues` ][1].
|
|
4444
|
+
#
|
|
4445
|
+
# * Specify the `ProductAttributes` field to define a filter that
|
|
4446
|
+
# acts on the product attributes of supported services, such as
|
|
4447
|
+
# Amazon Bedrock. Only `GetCostAndUsage`,
|
|
4448
|
+
# `GetCostAndUsageWithResources`, `GetDimensionValues` (in the
|
|
4449
|
+
# `COST_AND_USAGE` context), `GetTags`, and `GetCostCategories`
|
|
4450
|
+
# support `ProductAttributes`. For the supported services, keys
|
|
4451
|
+
# and `SERVICE` filter rules, see [ `ProductAttributeValues`
|
|
4452
|
+
# ][2].
|
|
4280
4453
|
# * For each filter type, you can set the dimension name and values
|
|
4281
4454
|
# for the filters that you plan to use.
|
|
4282
4455
|
#
|
|
@@ -4346,6 +4519,7 @@ module Aws::CostExplorer
|
|
|
4346
4519
|
#
|
|
4347
4520
|
#
|
|
4348
4521
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
|
|
4522
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
4349
4523
|
# @return [Types::Expression]
|
|
4350
4524
|
#
|
|
4351
4525
|
# @!attribute [rw] account_scope
|
|
@@ -4598,8 +4772,8 @@ module Aws::CostExplorer
|
|
|
4598
4772
|
#
|
|
4599
4773
|
# * Simple dimension values.
|
|
4600
4774
|
#
|
|
4601
|
-
# * There are
|
|
4602
|
-
# `CostCategories`, `Tags`, and `
|
|
4775
|
+
# * There are four types of simple dimension values:
|
|
4776
|
+
# `CostCategories`, `Tags`, `Dimensions`, and `ProductAttributes`.
|
|
4603
4777
|
#
|
|
4604
4778
|
# * Specify the `CostCategories` field to define a filter that
|
|
4605
4779
|
# acts on Cost Categories.
|
|
@@ -4609,6 +4783,15 @@ module Aws::CostExplorer
|
|
|
4609
4783
|
#
|
|
4610
4784
|
# * Specify the `Dimensions` field to define a filter that acts on
|
|
4611
4785
|
# the [ `DimensionValues` ][1].
|
|
4786
|
+
#
|
|
4787
|
+
# * Specify the `ProductAttributes` field to define a filter that
|
|
4788
|
+
# acts on the product attributes of supported services, such as
|
|
4789
|
+
# Amazon Bedrock. Only `GetCostAndUsage`,
|
|
4790
|
+
# `GetCostAndUsageWithResources`, `GetDimensionValues` (in the
|
|
4791
|
+
# `COST_AND_USAGE` context), `GetTags`, and `GetCostCategories`
|
|
4792
|
+
# support `ProductAttributes`. For the supported services, keys
|
|
4793
|
+
# and `SERVICE` filter rules, see [ `ProductAttributeValues`
|
|
4794
|
+
# ][2].
|
|
4612
4795
|
# * For each filter type, you can set the dimension name and values
|
|
4613
4796
|
# for the filters that you plan to use.
|
|
4614
4797
|
#
|
|
@@ -4678,6 +4861,7 @@ module Aws::CostExplorer
|
|
|
4678
4861
|
#
|
|
4679
4862
|
#
|
|
4680
4863
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
|
|
4864
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
4681
4865
|
# @return [Types::Expression]
|
|
4682
4866
|
#
|
|
4683
4867
|
# @!attribute [rw] configuration
|
|
@@ -5217,8 +5401,8 @@ module Aws::CostExplorer
|
|
|
5217
5401
|
#
|
|
5218
5402
|
# * Simple dimension values.
|
|
5219
5403
|
#
|
|
5220
|
-
# * There are
|
|
5221
|
-
# `CostCategories`, `Tags`, and `
|
|
5404
|
+
# * There are four types of simple dimension values:
|
|
5405
|
+
# `CostCategories`, `Tags`, `Dimensions`, and `ProductAttributes`.
|
|
5222
5406
|
#
|
|
5223
5407
|
# * Specify the `CostCategories` field to define a filter that
|
|
5224
5408
|
# acts on Cost Categories.
|
|
@@ -5228,6 +5412,15 @@ module Aws::CostExplorer
|
|
|
5228
5412
|
#
|
|
5229
5413
|
# * Specify the `Dimensions` field to define a filter that acts on
|
|
5230
5414
|
# the [ `DimensionValues` ][1].
|
|
5415
|
+
#
|
|
5416
|
+
# * Specify the `ProductAttributes` field to define a filter that
|
|
5417
|
+
# acts on the product attributes of supported services, such as
|
|
5418
|
+
# Amazon Bedrock. Only `GetCostAndUsage`,
|
|
5419
|
+
# `GetCostAndUsageWithResources`, `GetDimensionValues` (in the
|
|
5420
|
+
# `COST_AND_USAGE` context), `GetTags`, and `GetCostCategories`
|
|
5421
|
+
# support `ProductAttributes`. For the supported services, keys
|
|
5422
|
+
# and `SERVICE` filter rules, see [ `ProductAttributeValues`
|
|
5423
|
+
# ][2].
|
|
5231
5424
|
# * For each filter type, you can set the dimension name and values
|
|
5232
5425
|
# for the filters that you plan to use.
|
|
5233
5426
|
#
|
|
@@ -5297,6 +5490,7 @@ module Aws::CostExplorer
|
|
|
5297
5490
|
#
|
|
5298
5491
|
#
|
|
5299
5492
|
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html
|
|
5493
|
+
# [2]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
5300
5494
|
# @return [Types::Expression]
|
|
5301
5495
|
#
|
|
5302
5496
|
# @!attribute [rw] sort_by
|
|
@@ -5843,8 +6037,8 @@ module Aws::CostExplorer
|
|
|
5843
6037
|
# resource types based on the latest version. If the filter is
|
|
5844
6038
|
# present, the result only includes Cost Categories that supports
|
|
5845
6039
|
# input resource type. If the filter isn't provided, no filtering is
|
|
5846
|
-
# applied. The valid values are `billing:rispgroupsharing
|
|
5847
|
-
# `billing:billingview`.
|
|
6040
|
+
# applied. The valid values are `billing:rispgroupsharing`,
|
|
6041
|
+
# `billing:billingview`, and `billing:creditsharing`.
|
|
5848
6042
|
# @return [Array<String>]
|
|
5849
6043
|
#
|
|
5850
6044
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostCategoryDefinitionsRequest AWS API Documentation
|
|
@@ -6099,6 +6293,111 @@ module Aws::CostExplorer
|
|
|
6099
6293
|
include Aws::Structure
|
|
6100
6294
|
end
|
|
6101
6295
|
|
|
6296
|
+
# The product attribute values that you can use to filter the costs of
|
|
6297
|
+
# supported services. Currently, Amazon Bedrock is the only supported
|
|
6298
|
+
# service.
|
|
6299
|
+
#
|
|
6300
|
+
# The following product attribute keys are available for each supported
|
|
6301
|
+
# service:
|
|
6302
|
+
#
|
|
6303
|
+
# * Amazon Bedrock
|
|
6304
|
+
#
|
|
6305
|
+
# * `provider` - The model provider, such as `Anthropic`, `Cohere`, or
|
|
6306
|
+
# `OpenAI`.
|
|
6307
|
+
#
|
|
6308
|
+
# * `model` - The model, such as `Claude Sonnet 5` or `Claude Haiku
|
|
6309
|
+
# 4.5`.
|
|
6310
|
+
#
|
|
6311
|
+
# * `inferenceType` - The type of inference usage, such as `Input
|
|
6312
|
+
# tokens` or `Output tokens`.
|
|
6313
|
+
#
|
|
6314
|
+
# * `feature` - The feature that was used, such as `On-demand
|
|
6315
|
+
# Inference` or `Reranker`.
|
|
6316
|
+
#
|
|
6317
|
+
# The following operations support product attributes:
|
|
6318
|
+
# `GetCostAndUsage`, `GetCostAndUsageWithResources`,
|
|
6319
|
+
# `GetDimensionValues` (in the `COST_AND_USAGE` context), `GetTags`, and
|
|
6320
|
+
# `GetCostCategories`.
|
|
6321
|
+
#
|
|
6322
|
+
# Product attribute data is available for time periods that start on or
|
|
6323
|
+
# after September 1, 2026. Requests for earlier time periods that use
|
|
6324
|
+
# product attributes fail with a `DataUnavailableException`.
|
|
6325
|
+
#
|
|
6326
|
+
# The `SERVICE` filter rules for product attributes depend on the
|
|
6327
|
+
# operation:
|
|
6328
|
+
#
|
|
6329
|
+
# * `GetCostAndUsage` and `GetCostAndUsageWithResources` - Optional.
|
|
6330
|
+
#
|
|
6331
|
+
# * `GetDimensionValues` - Required when the filter includes
|
|
6332
|
+
# `ProductAttributes`, for any `Dimension`. Otherwise, optional.
|
|
6333
|
+
#
|
|
6334
|
+
# * `GetTags` and `GetCostCategories` - Required when the filter
|
|
6335
|
+
# includes `ProductAttributes`.
|
|
6336
|
+
#
|
|
6337
|
+
# A `SERVICE` filter must contain only supported services, or the
|
|
6338
|
+
# request fails with a `ValidationException`. Service names are matched
|
|
6339
|
+
# exactly. To list them, use `GetDimensionValues` with `Dimension` set
|
|
6340
|
+
# to `SERVICE` and the same `TimePeriod`, for example with
|
|
6341
|
+
# `SearchString` set to `Bedrock`.
|
|
6342
|
+
#
|
|
6343
|
+
# The costs of a supported service can appear under multiple service
|
|
6344
|
+
# names. When the `SERVICE` filter is optional, omit it so that your
|
|
6345
|
+
# results include all of those costs.
|
|
6346
|
+
#
|
|
6347
|
+
# For example, the following `Expression` filters for the costs of one
|
|
6348
|
+
# model: `{ "ProductAttributes": { "Key": "model", "Values": [ "Claude
|
|
6349
|
+
# Sonnet 5" ], "MatchOptions": [ "EQUALS" ] } }`
|
|
6350
|
+
#
|
|
6351
|
+
# @!attribute [rw] key
|
|
6352
|
+
# The name of the product attribute, such as `model`. The keys that
|
|
6353
|
+
# are available depend on the service. For the keys of each supported
|
|
6354
|
+
# service, see [ `ProductAttributeValues` ][1].
|
|
6355
|
+
#
|
|
6356
|
+
# Keys are case-sensitive. A key that doesn't exist doesn't return
|
|
6357
|
+
# an error: `EQUALS` matches no costs, and `ABSENT` matches all costs
|
|
6358
|
+
# of supported services.
|
|
6359
|
+
#
|
|
6360
|
+
#
|
|
6361
|
+
#
|
|
6362
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_ProductAttributeValues.html
|
|
6363
|
+
# @return [String]
|
|
6364
|
+
#
|
|
6365
|
+
# @!attribute [rw] values
|
|
6366
|
+
# The specific values of the product attribute, such as `Claude Sonnet
|
|
6367
|
+
# 5` for the `model` key. Values are matched exactly, including case.
|
|
6368
|
+
# To list the values of a key, use `GetDimensionValues` with
|
|
6369
|
+
# `Dimension` set to `PRODUCT_ATTRIBUTE` and `DimensionKey` set to the
|
|
6370
|
+
# key.
|
|
6371
|
+
#
|
|
6372
|
+
# To match costs that have no value for the key, set `MatchOptions` to
|
|
6373
|
+
# `ABSENT` and omit `Values`. Otherwise, `Values` is required.
|
|
6374
|
+
# @return [Array<String>]
|
|
6375
|
+
#
|
|
6376
|
+
# @!attribute [rw] match_options
|
|
6377
|
+
# The match options that you can use to filter your results. Valid
|
|
6378
|
+
# values:
|
|
6379
|
+
#
|
|
6380
|
+
# * `EQUALS` - Matches the values that you specify.
|
|
6381
|
+
#
|
|
6382
|
+
# * `ABSENT` - Matches costs that have no value for the key. Omit
|
|
6383
|
+
# `Values`.
|
|
6384
|
+
#
|
|
6385
|
+
# * `CASE_SENSITIVE` - Use only with `EQUALS`. Values are always
|
|
6386
|
+
# matched case-sensitively.
|
|
6387
|
+
#
|
|
6388
|
+
# Default values are `EQUALS` and `CASE_SENSITIVE`.
|
|
6389
|
+
# @return [Array<String>]
|
|
6390
|
+
#
|
|
6391
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ProductAttributeValues AWS API Documentation
|
|
6392
|
+
#
|
|
6393
|
+
class ProductAttributeValues < Struct.new(
|
|
6394
|
+
:key,
|
|
6395
|
+
:values,
|
|
6396
|
+
:match_options)
|
|
6397
|
+
SENSITIVE = []
|
|
6398
|
+
include Aws::Structure
|
|
6399
|
+
end
|
|
6400
|
+
|
|
6102
6401
|
# @!attribute [rw] anomaly_id
|
|
6103
6402
|
# A cost anomaly ID.
|
|
6104
6403
|
# @return [String]
|
data/lib/aws-sdk-costexplorer.rb
CHANGED