aws-sdk-billing 1.47.0 → 1.48.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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e10658da6b10374e3baf1d5f37634e03b53861dfb126c206b7a007ab46a1dd8a
4
- data.tar.gz: c94d7f6bce0ed7cde7a2391cf62aaedf16891251f69550f9d9b5665423d7db98
3
+ metadata.gz: 408c91449c49f1e9d7e2edf95bdf433b2e8946e62b85d0fa23764f44fa98c150
4
+ data.tar.gz: fb8acd95cc5038a4f945bb5f6e2bdf147a62c72740e805676f300a6584ff4335
5
5
  SHA512:
6
- metadata.gz: 33d56c9d94aa71db556c00922256bf714afbae8da5a65c530c7ae7294a28fcc9d7f3d19d510472ccdad6f6f644d512d5a6976612c6616404af8fe74f597d0ec4
7
- data.tar.gz: 1474dc5a62a6e116d53b1210b7eeff04f2c3ab8f0a0a4b240feb74852080a57808ea8476283ba78985246577a591f1457a44b9807f3c05860372b4304b399534
6
+ metadata.gz: 6224d2051f08f5968c578d8377f70734e1b193c068323c19f3c852edbef8da23d7b2f142e618be1d0423e94612e5ee02ef96cac7730c47dc5d1be73cd59cfaea
7
+ data.tar.gz: 3b602648535bb78c7d5c3dbb8aa0bf270dae593c6f7e1c24ae7b377c9fff5ff5f8f8654a8d76fe49be3c2056a3aef665c7f33ad5dca50ebaa671dfc26e1d5dfb
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.48.0 (2026-11-17)
5
+ ------------------
6
+
7
+ * Feature - Adds the SplitCredit and TransferCredit APIs to split or transfer credits, and adds benefit level sharing for Reserved Instances and Savings Plans to GetBillingPreferences and UpdateBillingPreferences.
8
+
4
9
  1.47.0 (2026-11-16)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.47.0
1
+ 1.48.0
@@ -544,7 +544,23 @@ module Aws::Billing
544
544
  # views with.
545
545
  #
546
546
  # @option params [required, Array<String>] :source_views
547
- # A list of ARNs of the source billing views to associate.
547
+ # A list of ARNs of the source billing views to associate. Source views
548
+ # can be of the following types:
549
+ #
550
+ # * `PRIMARY` - The billing view that contains all cost management data
551
+ # associated with an account.
552
+ #
553
+ # * `CUSTOM` - A billing view that a customer creates from one or more
554
+ # source views.
555
+ #
556
+ # * `BILLING_GROUP` - The billing view for an Billing Conductor billing
557
+ # group.
558
+ #
559
+ # * `BILLING_TRANSFER` - The billing view for the billing data that a
560
+ # bill transfer account is financially responsible for.
561
+ #
562
+ # * `BILLING_TRANSFER_SHOWBACK` - The billing view for billing data
563
+ # configured for showback or chargeback purposes.
548
564
  #
549
565
  # @return [Types::AssociateSourceViewsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
550
566
  #
@@ -642,7 +658,22 @@ module Aws::Billing
642
658
  #
643
659
  # @option params [required, Array<String>] :source_views
644
660
  # A list of billing views used as the data source for the custom billing
645
- # view.
661
+ # view. Source views can be of the following types:
662
+ #
663
+ # * `PRIMARY` - The billing view that contains all cost management data
664
+ # associated with an account.
665
+ #
666
+ # * `CUSTOM` - A billing view that a customer creates from one or more
667
+ # source views.
668
+ #
669
+ # * `BILLING_GROUP` - The billing view for an Billing Conductor billing
670
+ # group.
671
+ #
672
+ # * `BILLING_TRANSFER` - The billing view for the billing data that a
673
+ # bill transfer account is financially responsible for.
674
+ #
675
+ # * `BILLING_TRANSFER_SHOWBACK` - The billing view for billing data
676
+ # configured for showback or chargeback purposes.
646
677
  #
647
678
  # @option params [Types::Expression] :data_filter_expression
648
679
  # See [Expression][1]. Billing view only supports `LINKED_ACCOUNT`,
@@ -1116,7 +1147,9 @@ module Aws::Billing
1116
1147
  # Retrieves billing preferences for the specified feature. Each feature
1117
1148
  # controls a distinct billing capability: which accounts can share
1118
1149
  # Reserved Instances or credits, whether billing alerts are enabled, the
1119
- # historical record of sharing changes, and per-credit options.
1150
+ # historical record of sharing changes, per-credit options, and which
1151
+ # accounts an individual Reserved Instance or Savings Plan is shared
1152
+ # with.
1120
1153
  #
1121
1154
  # @option params [String] :next_token
1122
1155
  # Pagination token from a previous response. Pass the value returned in
@@ -1130,13 +1163,17 @@ module Aws::Billing
1130
1163
  # The feature to retrieve. Specify exactly one value. Valid values:
1131
1164
  # `BILLING_ALERTS`, `RI_SHARING`, `RI_SHARING_HISTORY`,
1132
1165
  # `CREDIT_SHARING`, `CREDIT_SHARING_HISTORY`, `CREDIT_LEVEL_SHARING`,
1133
- # `CREDIT_PREFERENCE_OPTIONS`.
1166
+ # `CREDIT_PREFERENCE_OPTIONS`, `BENEFIT_LEVEL_SHARING`.
1134
1167
  #
1135
1168
  # @option params [Array<Types::BillingFeatureFilter>] :filters
1136
1169
  # Filters to narrow results. Specify exactly one filter when supplied.
1137
1170
  # The supported filter name is `PREFERENCE_KEY`, which accepts 1 to 10
1138
1171
  # values to match preference keys.
1139
1172
  #
1173
+ # For `BENEFIT_LEVEL_SHARING`, this filter is required. Specify exactly
1174
+ # one value that identifies the Reserved Instance (RI) or Savings Plan
1175
+ # (SP), in the form `benefit/{ri|sp}/{benefitId}`.
1176
+ #
1140
1177
  # @return [Types::GetBillingPreferencesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1141
1178
  #
1142
1179
  # * {Types::GetBillingPreferencesResponse#billing_preferences #billing_preferences} => Array&lt;Types::BillingPreferenceSummary&gt;
@@ -1147,7 +1184,7 @@ module Aws::Billing
1147
1184
  # resp = client.get_billing_preferences({
1148
1185
  # next_token: "PageToken",
1149
1186
  # max_results: 1,
1150
- # features: ["RI_SHARING"], # required, accepts RI_SHARING, RI_SHARING_HISTORY, CREDIT_SHARING, CREDIT_SHARING_HISTORY, CREDIT_LEVEL_SHARING, BILLING_ALERTS, CREDIT_PREFERENCE_OPTIONS
1187
+ # features: ["RI_SHARING"], # required, accepts RI_SHARING, RI_SHARING_HISTORY, CREDIT_SHARING, CREDIT_SHARING_HISTORY, CREDIT_LEVEL_SHARING, BILLING_ALERTS, CREDIT_PREFERENCE_OPTIONS, BENEFIT_LEVEL_SHARING
1151
1188
  # filters: [
1152
1189
  # {
1153
1190
  # name: "PREFERENCE_KEY", # accepts PREFERENCE_KEY
@@ -1159,7 +1196,7 @@ module Aws::Billing
1159
1196
  # @example Response structure
1160
1197
  #
1161
1198
  # resp.billing_preferences #=> Array
1162
- # resp.billing_preferences[0].feature #=> String, one of "RI_SHARING", "RI_SHARING_HISTORY", "CREDIT_SHARING", "CREDIT_SHARING_HISTORY", "CREDIT_LEVEL_SHARING", "BILLING_ALERTS", "CREDIT_PREFERENCE_OPTIONS"
1199
+ # resp.billing_preferences[0].feature #=> String, one of "RI_SHARING", "RI_SHARING_HISTORY", "CREDIT_SHARING", "CREDIT_SHARING_HISTORY", "CREDIT_LEVEL_SHARING", "BILLING_ALERTS", "CREDIT_PREFERENCE_OPTIONS", "BENEFIT_LEVEL_SHARING"
1163
1200
  # resp.billing_preferences[0].key #=> String
1164
1201
  # resp.billing_preferences[0].value #=> String, one of "ENABLED", "DISABLED"
1165
1202
  # resp.billing_preferences[0].account_name #=> String
@@ -1343,12 +1380,17 @@ module Aws::Billing
1343
1380
  # allocation entries for all credits.
1344
1381
  #
1345
1382
  # @option params [required, Time,DateTime,Date,Integer,String] :start_date
1346
- # Inclusive start date as Unix epoch seconds. Must be on or before
1347
- # `endDate`. The range from `startDate` to `endDate` cannot exceed 24
1348
- # billing months.
1383
+ # The inclusive start date of the range, in Unix epoch seconds. This
1384
+ # value must be earlier than `endDate`. You get credit allocations for
1385
+ # bills whose billing period starts on or after `startDate` and before
1386
+ # `endDate`. If `startDate` is in the middle of a billing period, that
1387
+ # period isn't included. The range can't exceed 24 calendar months.
1349
1388
  #
1350
1389
  # @option params [required, Time,DateTime,Date,Integer,String] :end_date
1351
- # Inclusive end date as Unix epoch seconds.
1390
+ # The exclusive end date of the range, in Unix epoch seconds. To get one
1391
+ # billing month, set `startDate` to the first day of that month. Then
1392
+ # set `endDate` to the first day of the next month. Use 00:00 UTC for
1393
+ # both.
1352
1394
  #
1353
1395
  # @option params [String] :next_token
1354
1396
  # Pagination token from a previous response. Pass the value returned in
@@ -2597,6 +2639,84 @@ module Aws::Billing
2597
2639
  req.send_request(options)
2598
2640
  end
2599
2641
 
2642
+ # Splits the available balance of a credit into 2 to 99 new credits in
2643
+ # the same account, and cancels the original credit. The new credits
2644
+ # keep the original credit's end date and applicable products.
2645
+ #
2646
+ # The available balance is the remaining balance minus any amount
2647
+ # reserved for a bill that isn't finalized. The portions must add up to
2648
+ # exactly the available balance. Each portion must be at least 100.00 in
2649
+ # the currency of the credit. For example, if the credit is in USD, each
2650
+ # portion must be at least USD $100.00. A reserved amount stays on the
2651
+ # original credit and still applies to that bill.
2652
+ #
2653
+ # A credit and every credit split from it count toward a limit of 100
2654
+ # credits. After a split, you can't split or transfer the original
2655
+ # credit. You can split or transfer its new credits, and you can split a
2656
+ # credit after you transfer it.
2657
+ #
2658
+ # You must own the credit or be the payer of the account that owns it.
2659
+ # You can't undo a split. This operation is idempotent and supports a
2660
+ # dry run.
2661
+ #
2662
+ # @option params [required, String] :credit_id
2663
+ # The ID of the credit to split.
2664
+ #
2665
+ # @option params [required, Array<Types::SplitPortion>] :portions
2666
+ # The new credits to create, one for each portion, in the order listed.
2667
+ #
2668
+ # @option params [String] :client_token
2669
+ # A unique, case-sensitive identifier that you provide to ensure that
2670
+ # the operation completes no more than one time. If you retry a
2671
+ # successful request with the same client token and parameters, the
2672
+ # retry completes without performing any further actions. If you reuse a
2673
+ # client token with different parameters, the request fails with a
2674
+ # `ValidationException`.
2675
+ #
2676
+ # **A suitable default value is auto-generated.** You should normally
2677
+ # not need to pass this option.**
2678
+ #
2679
+ # @option params [Boolean] :dry_run
2680
+ # Specifies whether to validate the request and return the result
2681
+ # without changing any credit.
2682
+ #
2683
+ # @return [Types::SplitCreditResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2684
+ #
2685
+ # * {Types::SplitCreditResponse#parent_credit_id #parent_credit_id} => String
2686
+ # * {Types::SplitCreditResponse#child_credits #child_credits} => Array&lt;Types::ChildCredit&gt;
2687
+ # * {Types::SplitCreditResponse#dry_run #dry_run} => Boolean
2688
+ #
2689
+ # @example Request syntax with placeholder values
2690
+ #
2691
+ # resp = client.split_credit({
2692
+ # credit_id: "CreditId", # required
2693
+ # portions: [ # required
2694
+ # {
2695
+ # amount: "DecimalAmountString", # required
2696
+ # description: "SplitPortionDescriptionString",
2697
+ # },
2698
+ # ],
2699
+ # client_token: "ClientToken",
2700
+ # dry_run: false,
2701
+ # })
2702
+ #
2703
+ # @example Response structure
2704
+ #
2705
+ # resp.parent_credit_id #=> String
2706
+ # resp.child_credits #=> Array
2707
+ # resp.child_credits[0].credit_id #=> String
2708
+ # resp.child_credits[0].amount #=> String
2709
+ # resp.dry_run #=> Boolean
2710
+ #
2711
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/SplitCredit AWS API Documentation
2712
+ #
2713
+ # @overload split_credit(params = {})
2714
+ # @param [Hash] params ({})
2715
+ def split_credit(params = {}, options = {})
2716
+ req = build_request(:split_credit, params)
2717
+ req.send_request(options)
2718
+ end
2719
+
2600
2720
  # An API operation for adding one or more tags (key-value pairs) to a
2601
2721
  # resource.
2602
2722
  #
@@ -2646,6 +2766,77 @@ module Aws::Billing
2646
2766
  req.send_request(options)
2647
2767
  end
2648
2768
 
2769
+ # Moves a credit to another account in the same consolidated billing
2770
+ # family. The credit keeps its ID, balance, end date, and applicable
2771
+ # products. Only the account that owns the credit changes.
2772
+ #
2773
+ # The transfer removes the credit's sharing settings. The new owner or
2774
+ # the payer can set them again. Any amount reserved for a bill that
2775
+ # isn't finalized moves with the credit and still applies to that bill.
2776
+ #
2777
+ # You must be the payer of both accounts. You can't transfer a credit
2778
+ # that has ended, has no available balance, or is the original credit of
2779
+ # a split. A transfer creates no credit, so it doesn't count toward the
2780
+ # split limit, and the payer can transfer the credit back. This
2781
+ # operation is idempotent and supports a dry run.
2782
+ #
2783
+ # @option params [required, String] :credit_id
2784
+ # The ID of the credit to transfer.
2785
+ #
2786
+ # @option params [required, String] :destination_account_id
2787
+ # The Amazon Web Services account ID that becomes the owner of the
2788
+ # credit. The account must be in your consolidated billing family and
2789
+ # must not be the current owner.
2790
+ #
2791
+ # @option params [String] :client_token
2792
+ # A unique, case-sensitive identifier that you provide to ensure that
2793
+ # the operation completes no more than one time. If you retry a
2794
+ # successful request with the same client token and parameters, the
2795
+ # retry completes without performing any further actions. If you reuse a
2796
+ # client token with different parameters, the request fails with a
2797
+ # `ValidationException`.
2798
+ #
2799
+ # **A suitable default value is auto-generated.** You should normally
2800
+ # not need to pass this option.**
2801
+ #
2802
+ # @option params [Boolean] :dry_run
2803
+ # Specifies whether to validate the request and return the result
2804
+ # without changing the credit.
2805
+ #
2806
+ # @return [Types::TransferCreditResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2807
+ #
2808
+ # * {Types::TransferCreditResponse#source_credit_id #source_credit_id} => String
2809
+ # * {Types::TransferCreditResponse#new_credit_id #new_credit_id} => String
2810
+ # * {Types::TransferCreditResponse#destination_account_id #destination_account_id} => String
2811
+ # * {Types::TransferCreditResponse#amount #amount} => String
2812
+ # * {Types::TransferCreditResponse#dry_run #dry_run} => Boolean
2813
+ #
2814
+ # @example Request syntax with placeholder values
2815
+ #
2816
+ # resp = client.transfer_credit({
2817
+ # credit_id: "CreditId", # required
2818
+ # destination_account_id: "AccountId", # required
2819
+ # client_token: "ClientToken",
2820
+ # dry_run: false,
2821
+ # })
2822
+ #
2823
+ # @example Response structure
2824
+ #
2825
+ # resp.source_credit_id #=> String
2826
+ # resp.new_credit_id #=> String
2827
+ # resp.destination_account_id #=> String
2828
+ # resp.amount #=> String
2829
+ # resp.dry_run #=> Boolean
2830
+ #
2831
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/TransferCredit AWS API Documentation
2832
+ #
2833
+ # @overload transfer_credit(params = {})
2834
+ # @param [Hash] params ({})
2835
+ def transfer_credit(params = {}, options = {})
2836
+ req = build_request(:transfer_credit, params)
2837
+ req.send_request(options)
2838
+ end
2839
+
2649
2840
  # Removes one or more tags from a resource. Specify only tag keys in
2650
2841
  # your request. Don't specify the value.
2651
2842
  #
@@ -2692,18 +2883,18 @@ module Aws::Billing
2692
2883
  # keys. The action sets the value for each provided key; keys not
2693
2884
  # present in the request are unchanged.
2694
2885
  #
2695
- # Sharing keys (`RI_SHARING`, `CREDIT_SHARING`, `CREDIT_LEVEL_SHARING`,
2696
- # and sharing keys under `CREDIT_PREFERENCE_OPTIONS`) may only be set by
2697
- # the management account of a consolidated billing family. The
2698
- # `credit/{creditId}/status` key may be set by member accounts for
2699
- # credits they own, or by the management account for any credit in the
2700
- # family.
2886
+ # To set sharing keys (`RI_SHARING`, `CREDIT_SHARING`,
2887
+ # `CREDIT_LEVEL_SHARING`, `BENEFIT_LEVEL_SHARING`, and sharing keys
2888
+ # under `CREDIT_PREFERENCE_OPTIONS`), you must use the management
2889
+ # account of a consolidated billing family. To set the
2890
+ # `credit/{creditId}/status` key, you must own the credit or use the
2891
+ # management account of its family.
2701
2892
  #
2702
2893
  # @option params [required, String] :feature
2703
2894
  # The feature to update. Valid values: `BILLING_ALERTS`, `RI_SHARING`,
2704
- # `CREDIT_SHARING`, `CREDIT_LEVEL_SHARING`, `CREDIT_PREFERENCE_OPTIONS`.
2705
- # The history features (`RI_SHARING_HISTORY` and
2706
- # `CREDIT_SHARING_HISTORY`) are read-only and cannot be updated.
2895
+ # `CREDIT_SHARING`, `CREDIT_LEVEL_SHARING`, `CREDIT_PREFERENCE_OPTIONS`,
2896
+ # `BENEFIT_LEVEL_SHARING`. The history features (`RI_SHARING_HISTORY`
2897
+ # and `CREDIT_SHARING_HISTORY`) are read-only and cannot be updated.
2707
2898
  #
2708
2899
  # @option params [required, Array<Types::BillingPreferenceForKey>] :billing_preferences_per_key
2709
2900
  # Key/value pairs to apply. All keys in a single request must be valid
@@ -2711,12 +2902,51 @@ module Aws::Billing
2711
2902
  # `CREDIT_PREFERENCE_OPTIONS`, all keys must reference the same
2712
2903
  # `creditId`.
2713
2904
  #
2905
+ # For `BENEFIT_LEVEL_SHARING`, all keys must reference the same Reserved
2906
+ # Instance or Savings Plan. To share it with the accounts in one Cost
2907
+ # Category rule, send these three keys with the value `ENABLED`:
2908
+ #
2909
+ # * `benefit/{ri|sp}/{benefitId}/sharing/costCategoryArn/{costCategoryArn}`
2910
+ #
2911
+ # * `benefit/{ri|sp}/{benefitId}/sharing/ruleName/{ruleName}`
2912
+ #
2913
+ # * `benefit/{ri|sp}/{benefitId}/sharing/mode/{prioritized|restricted}`
2914
+ #
2915
+ # With `prioritized`, any benefit that the rule's accounts don't use
2916
+ # goes to the rest of your consolidated billing family, following your
2917
+ # family sharing settings. With `restricted`, only the owner and the
2918
+ # rule's accounts receive it. The Cost Category must belong to your
2919
+ # account. To stop sharing, send the same three keys with the value
2920
+ # `DISABLED`.
2921
+ #
2922
+ # For `RI_SHARING` and `CREDIT_SHARING`, you can share benefits by
2923
+ # account group. Each rule in a Cost Category is one group. Send exactly
2924
+ # one of these group keys with the value `ENABLED`:
2925
+ #
2926
+ # * `open-sharing` - Share across the whole consolidated billing family,
2927
+ # with no groups.
2928
+ #
2929
+ # * `costcategory-prioritized/{costCategoryArn}` - Share within each
2930
+ # group first, then with the rest of the family.
2931
+ #
2932
+ # * `costcategory-restricted/{costCategoryArn}` - An account in a group
2933
+ # shares only with accounts in the same group.
2934
+ #
2935
+ # For `RI_SHARING`, the `costcategory-` keys use a Cost Category that
2936
+ # supports the `billing:rispgroupsharing` resource type. To use a Cost
2937
+ # Category that supports the `billing:benefitgroupsharing` resource
2938
+ # type, use the `benefitgroup-prioritized/` or
2939
+ # `benefitgroup-restricted/` prefix instead. For `CREDIT_SHARING`, the
2940
+ # Cost Category must support the `billing:benefitgroupsharing` resource
2941
+ # type. The Cost Category must belong to your account.
2942
+ # `GetBillingPreferences` returns the group key that is in effect.
2943
+ #
2714
2944
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2715
2945
  #
2716
2946
  # @example Request syntax with placeholder values
2717
2947
  #
2718
2948
  # resp = client.update_billing_preferences({
2719
- # feature: "RI_SHARING", # required, accepts RI_SHARING, RI_SHARING_HISTORY, CREDIT_SHARING, CREDIT_SHARING_HISTORY, CREDIT_LEVEL_SHARING, BILLING_ALERTS, CREDIT_PREFERENCE_OPTIONS
2949
+ # feature: "RI_SHARING", # required, accepts RI_SHARING, RI_SHARING_HISTORY, CREDIT_SHARING, CREDIT_SHARING_HISTORY, CREDIT_LEVEL_SHARING, BILLING_ALERTS, CREDIT_PREFERENCE_OPTIONS, BENEFIT_LEVEL_SHARING
2720
2950
  # billing_preferences_per_key: [ # required
2721
2951
  # {
2722
2952
  # key: "PreferenceKey", # required
@@ -2840,7 +3070,7 @@ module Aws::Billing
2840
3070
  tracer: tracer
2841
3071
  )
2842
3072
  context[:gem_name] = 'aws-sdk-billing'
2843
- context[:gem_version] = '1.47.0'
3073
+ context[:gem_version] = '1.48.0'
2844
3074
  Seahorse::Client::Request.new(handlers, context)
2845
3075
  end
2846
3076
 
@@ -87,6 +87,8 @@ module Aws::Billing
87
87
  CancellationReason = Shapes::StringShape.new(name: 'CancellationReason')
88
88
  ChargeAccount = Shapes::StructureShape.new(name: 'ChargeAccount')
89
89
  ChargeAccountList = Shapes::ListShape.new(name: 'ChargeAccountList')
90
+ ChildCredit = Shapes::StructureShape.new(name: 'ChildCredit')
91
+ ChildCredits = Shapes::ListShape.new(name: 'ChildCredits')
90
92
  ClientToken = Shapes::StringShape.new(name: 'ClientToken')
91
93
  ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
92
94
  ContractAccount = Shapes::StructureShape.new(name: 'ContractAccount')
@@ -113,6 +115,7 @@ module Aws::Billing
113
115
  CreditStatus = Shapes::StringShape.new(name: 'CreditStatus')
114
116
  CurrencyAmount = Shapes::StringShape.new(name: 'CurrencyAmount')
115
117
  CurrencyCode = Shapes::StringShape.new(name: 'CurrencyCode')
118
+ DecimalAmountString = Shapes::StringShape.new(name: 'DecimalAmountString')
116
119
  DeleteBillingViewRequest = Shapes::StructureShape.new(name: 'DeleteBillingViewRequest')
117
120
  DeleteBillingViewResponse = Shapes::StructureShape.new(name: 'DeleteBillingViewResponse')
118
121
  Dimension = Shapes::StringShape.new(name: 'Dimension')
@@ -246,6 +249,11 @@ module Aws::Billing
246
249
  ServiceLevelAccountUsageList = Shapes::ListShape.new(name: 'ServiceLevelAccountUsageList')
247
250
  ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
248
251
  ShareableAccountIds = Shapes::ListShape.new(name: 'ShareableAccountIds')
252
+ SplitCreditRequest = Shapes::StructureShape.new(name: 'SplitCreditRequest')
253
+ SplitCreditResponse = Shapes::StructureShape.new(name: 'SplitCreditResponse')
254
+ SplitPortion = Shapes::StructureShape.new(name: 'SplitPortion')
255
+ SplitPortionDescriptionString = Shapes::StringShape.new(name: 'SplitPortionDescriptionString')
256
+ SplitPortions = Shapes::ListShape.new(name: 'SplitPortions')
249
257
  String = Shapes::StringShape.new(name: 'String')
250
258
  StringSearch = Shapes::StructureShape.new(name: 'StringSearch')
251
259
  StringSearches = Shapes::ListShape.new(name: 'StringSearches')
@@ -257,6 +265,8 @@ module Aws::Billing
257
265
  TimePeriodList = Shapes::ListShape.new(name: 'TimePeriodList')
258
266
  TimeRange = Shapes::StructureShape.new(name: 'TimeRange')
259
267
  Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
268
+ TransferCreditRequest = Shapes::StructureShape.new(name: 'TransferCreditRequest')
269
+ TransferCreditResponse = Shapes::StructureShape.new(name: 'TransferCreditResponse')
260
270
  UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
261
271
  UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
262
272
  UpdateBillingPreferencesRequest = Shapes::StructureShape.new(name: 'UpdateBillingPreferencesRequest')
@@ -468,6 +478,12 @@ module Aws::Billing
468
478
 
469
479
  ChargeAccountList.member = Shapes::ShapeRef.new(shape: ChargeAccount)
470
480
 
481
+ ChildCredit.add_member(:credit_id, Shapes::ShapeRef.new(shape: CreditId, location_name: "creditId"))
482
+ ChildCredit.add_member(:amount, Shapes::ShapeRef.new(shape: DecimalAmountString, required: true, location_name: "amount"))
483
+ ChildCredit.struct_class = Types::ChildCredit
484
+
485
+ ChildCredits.member = Shapes::ShapeRef.new(shape: ChildCredit)
486
+
471
487
  ConflictException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, required: true, location_name: "message"))
472
488
  ConflictException.add_member(:resource_id, Shapes::ShapeRef.new(shape: ResourceId, required: true, location_name: "resourceId"))
473
489
  ConflictException.add_member(:resource_type, Shapes::ShapeRef.new(shape: ResourceType, required: true, location_name: "resourceType"))
@@ -969,6 +985,23 @@ module Aws::Billing
969
985
 
970
986
  ShareableAccountIds.member = Shapes::ShapeRef.new(shape: AccountId)
971
987
 
988
+ SplitCreditRequest.add_member(:credit_id, Shapes::ShapeRef.new(shape: CreditId, required: true, location_name: "creditId"))
989
+ SplitCreditRequest.add_member(:portions, Shapes::ShapeRef.new(shape: SplitPortions, required: true, location_name: "portions"))
990
+ SplitCreditRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
991
+ SplitCreditRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "dryRun"))
992
+ SplitCreditRequest.struct_class = Types::SplitCreditRequest
993
+
994
+ SplitCreditResponse.add_member(:parent_credit_id, Shapes::ShapeRef.new(shape: CreditId, required: true, location_name: "parentCreditId"))
995
+ SplitCreditResponse.add_member(:child_credits, Shapes::ShapeRef.new(shape: ChildCredits, required: true, location_name: "childCredits"))
996
+ SplitCreditResponse.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, required: true, location_name: "dryRun"))
997
+ SplitCreditResponse.struct_class = Types::SplitCreditResponse
998
+
999
+ SplitPortion.add_member(:amount, Shapes::ShapeRef.new(shape: DecimalAmountString, required: true, location_name: "amount"))
1000
+ SplitPortion.add_member(:description, Shapes::ShapeRef.new(shape: SplitPortionDescriptionString, location_name: "description"))
1001
+ SplitPortion.struct_class = Types::SplitPortion
1002
+
1003
+ SplitPortions.member = Shapes::ShapeRef.new(shape: SplitPortion)
1004
+
972
1005
  StringSearch.add_member(:search_option, Shapes::ShapeRef.new(shape: SearchOption, required: true, location_name: "searchOption"))
973
1006
  StringSearch.add_member(:search_value, Shapes::ShapeRef.new(shape: SearchValue, required: true, location_name: "searchValue"))
974
1007
  StringSearch.struct_class = Types::StringSearch
@@ -994,6 +1027,19 @@ module Aws::Billing
994
1027
  TimeRange.add_member(:end_date_inclusive, Shapes::ShapeRef.new(shape: Timestamp, location_name: "endDateInclusive"))
995
1028
  TimeRange.struct_class = Types::TimeRange
996
1029
 
1030
+ TransferCreditRequest.add_member(:credit_id, Shapes::ShapeRef.new(shape: CreditId, required: true, location_name: "creditId"))
1031
+ TransferCreditRequest.add_member(:destination_account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location_name: "destinationAccountId"))
1032
+ TransferCreditRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
1033
+ TransferCreditRequest.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, location_name: "dryRun"))
1034
+ TransferCreditRequest.struct_class = Types::TransferCreditRequest
1035
+
1036
+ TransferCreditResponse.add_member(:source_credit_id, Shapes::ShapeRef.new(shape: CreditId, required: true, location_name: "sourceCreditId"))
1037
+ TransferCreditResponse.add_member(:new_credit_id, Shapes::ShapeRef.new(shape: CreditId, location_name: "newCreditId"))
1038
+ TransferCreditResponse.add_member(:destination_account_id, Shapes::ShapeRef.new(shape: AccountId, required: true, location_name: "destinationAccountId"))
1039
+ TransferCreditResponse.add_member(:amount, Shapes::ShapeRef.new(shape: DecimalAmountString, required: true, location_name: "amount"))
1040
+ TransferCreditResponse.add_member(:dry_run, Shapes::ShapeRef.new(shape: Boolean, required: true, location_name: "dryRun"))
1041
+ TransferCreditResponse.struct_class = Types::TransferCreditResponse
1042
+
997
1043
  UntagResourceRequest.add_member(:resource_arn, Shapes::ShapeRef.new(shape: ResourceArn, required: true, location_name: "resourceArn"))
998
1044
  UntagResourceRequest.add_member(:resource_tag_keys, Shapes::ShapeRef.new(shape: ResourceTagKeyList, required: true, location_name: "resourceTagKeys"))
999
1045
  UntagResourceRequest.struct_class = Types::UntagResourceRequest
@@ -1486,6 +1532,21 @@ module Aws::Billing
1486
1532
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1487
1533
  end)
1488
1534
 
1535
+ api.add_operation(:split_credit, Seahorse::Model::Operation.new.tap do |o|
1536
+ o.name = "SplitCredit"
1537
+ o.http_method = "POST"
1538
+ o.http_request_uri = "/"
1539
+ o.input = Shapes::ShapeRef.new(shape: SplitCreditRequest)
1540
+ o.output = Shapes::ShapeRef.new(shape: SplitCreditResponse)
1541
+ o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
1542
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
1543
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
1544
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
1545
+ o.errors << Shapes::ShapeRef.new(shape: ConflictException)
1546
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
1547
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1548
+ end)
1549
+
1489
1550
  api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|
1490
1551
  o.name = "TagResource"
1491
1552
  o.http_method = "POST"
@@ -1499,6 +1560,21 @@ module Aws::Billing
1499
1560
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1500
1561
  end)
1501
1562
 
1563
+ api.add_operation(:transfer_credit, Seahorse::Model::Operation.new.tap do |o|
1564
+ o.name = "TransferCredit"
1565
+ o.http_method = "POST"
1566
+ o.http_request_uri = "/"
1567
+ o.input = Shapes::ShapeRef.new(shape: TransferCreditRequest)
1568
+ o.output = Shapes::ShapeRef.new(shape: TransferCreditResponse)
1569
+ o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
1570
+ o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
1571
+ o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
1572
+ o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
1573
+ o.errors << Shapes::ShapeRef.new(shape: ConflictException)
1574
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
1575
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
1576
+ end)
1577
+
1502
1578
  api.add_operation(:untag_resource, Seahorse::Model::Operation.new.tap do |o|
1503
1579
  o.name = "UntagResource"
1504
1580
  o.http_method = "POST"
@@ -161,7 +161,23 @@ module Aws::Billing
161
161
  # @return [String]
162
162
  #
163
163
  # @!attribute [rw] source_views
164
- # A list of ARNs of the source billing views to associate.
164
+ # A list of ARNs of the source billing views to associate. Source
165
+ # views can be of the following types:
166
+ #
167
+ # * `PRIMARY` - The billing view that contains all cost management
168
+ # data associated with an account.
169
+ #
170
+ # * `CUSTOM` - A billing view that a customer creates from one or more
171
+ # source views.
172
+ #
173
+ # * `BILLING_GROUP` - The billing view for an Billing Conductor
174
+ # billing group.
175
+ #
176
+ # * `BILLING_TRANSFER` - The billing view for the billing data that a
177
+ # bill transfer account is financially responsible for.
178
+ #
179
+ # * `BILLING_TRANSFER_SHOWBACK` - The billing view for billing data
180
+ # configured for showback or chargeback purposes.
165
181
  # @return [Array<String>]
166
182
  #
167
183
  # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AssociateSourceViewsRequest AWS API Documentation
@@ -389,7 +405,22 @@ module Aws::Billing
389
405
  # @return [String]
390
406
  #
391
407
  # @!attribute [rw] billing_view_type
392
- # The type of billing group.
408
+ # The type of billing view. The following values are valid:
409
+ #
410
+ # * `PRIMARY` - The billing view that contains all cost management
411
+ # data associated with an account.
412
+ #
413
+ # * `CUSTOM` - A billing view that a customer creates from one or more
414
+ # source views.
415
+ #
416
+ # * `BILLING_GROUP` - The billing view for an Billing Conductor
417
+ # billing group.
418
+ #
419
+ # * `BILLING_TRANSFER` - The billing view for the billing data that a
420
+ # bill transfer account is financially responsible for.
421
+ #
422
+ # * `BILLING_TRANSFER_SHOWBACK` - The billing view for billing data
423
+ # configured for showback or chargeback purposes.
393
424
  # @return [String]
394
425
  #
395
426
  # @!attribute [rw] owner_account_id
@@ -515,7 +546,22 @@ module Aws::Billing
515
546
  # @return [String]
516
547
  #
517
548
  # @!attribute [rw] billing_view_type
518
- # The type of billing view.
549
+ # The type of billing view. The following values are valid:
550
+ #
551
+ # * `PRIMARY` - The billing view that contains all cost management
552
+ # data associated with an account.
553
+ #
554
+ # * `CUSTOM` - A billing view that a customer creates from one or more
555
+ # source views.
556
+ #
557
+ # * `BILLING_GROUP` - The billing view for an Billing Conductor
558
+ # billing group.
559
+ #
560
+ # * `BILLING_TRANSFER` - The billing view for the billing data that a
561
+ # bill transfer account is financially responsible for.
562
+ #
563
+ # * `BILLING_TRANSFER_SHOWBACK` - The billing view for billing data
564
+ # configured for showback or chargeback purposes.
519
565
  # @return [String]
520
566
  #
521
567
  # @!attribute [rw] health_status
@@ -855,6 +901,25 @@ module Aws::Billing
855
901
  include Aws::Structure
856
902
  end
857
903
 
904
+ # A new credit that a split created.
905
+ #
906
+ # @!attribute [rw] credit_id
907
+ # The ID of the new credit. A dry run omits this field.
908
+ # @return [String]
909
+ #
910
+ # @!attribute [rw] amount
911
+ # The amount of the new credit.
912
+ # @return [String]
913
+ #
914
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ChildCredit AWS API Documentation
915
+ #
916
+ class ChildCredit < Struct.new(
917
+ :credit_id,
918
+ :amount)
919
+ SENSITIVE = []
920
+ include Aws::Structure
921
+ end
922
+
858
923
  # The requested operation would cause a conflict with the current state
859
924
  # of a service resource associated with the request. Resolve the
860
925
  # conflict before retrying this request.
@@ -1001,7 +1066,22 @@ module Aws::Billing
1001
1066
  #
1002
1067
  # @!attribute [rw] source_views
1003
1068
  # A list of billing views used as the data source for the custom
1004
- # billing view.
1069
+ # billing view. Source views can be of the following types:
1070
+ #
1071
+ # * `PRIMARY` - The billing view that contains all cost management
1072
+ # data associated with an account.
1073
+ #
1074
+ # * `CUSTOM` - A billing view that a customer creates from one or more
1075
+ # source views.
1076
+ #
1077
+ # * `BILLING_GROUP` - The billing view for an Billing Conductor
1078
+ # billing group.
1079
+ #
1080
+ # * `BILLING_TRANSFER` - The billing view for the billing data that a
1081
+ # bill transfer account is financially responsible for.
1082
+ #
1083
+ # * `BILLING_TRANSFER_SHOWBACK` - The billing view for billing data
1084
+ # configured for showback or chargeback purposes.
1005
1085
  # @return [Array<String>]
1006
1086
  #
1007
1087
  # @!attribute [rw] data_filter_expression
@@ -1477,13 +1557,17 @@ module Aws::Billing
1477
1557
  # The feature to retrieve. Specify exactly one value. Valid values:
1478
1558
  # `BILLING_ALERTS`, `RI_SHARING`, `RI_SHARING_HISTORY`,
1479
1559
  # `CREDIT_SHARING`, `CREDIT_SHARING_HISTORY`, `CREDIT_LEVEL_SHARING`,
1480
- # `CREDIT_PREFERENCE_OPTIONS`.
1560
+ # `CREDIT_PREFERENCE_OPTIONS`, `BENEFIT_LEVEL_SHARING`.
1481
1561
  # @return [Array<String>]
1482
1562
  #
1483
1563
  # @!attribute [rw] filters
1484
1564
  # Filters to narrow results. Specify exactly one filter when supplied.
1485
1565
  # The supported filter name is `PREFERENCE_KEY`, which accepts 1 to 10
1486
1566
  # values to match preference keys.
1567
+ #
1568
+ # For `BENEFIT_LEVEL_SHARING`, this filter is required. Specify
1569
+ # exactly one value that identifies the Reserved Instance (RI) or
1570
+ # Savings Plan (SP), in the form `benefit/{ri|sp}/{benefitId}`.
1487
1571
  # @return [Array<Types::BillingFeatureFilter>]
1488
1572
  #
1489
1573
  # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/GetBillingPreferencesRequest AWS API Documentation
@@ -1577,13 +1661,18 @@ module Aws::Billing
1577
1661
  # @return [Integer]
1578
1662
  #
1579
1663
  # @!attribute [rw] start_date
1580
- # Inclusive start date as Unix epoch seconds. Must be on or before
1581
- # `endDate`. The range from `startDate` to `endDate` cannot exceed 24
1582
- # billing months.
1664
+ # The inclusive start date of the range, in Unix epoch seconds. This
1665
+ # value must be earlier than `endDate`. You get credit allocations for
1666
+ # bills whose billing period starts on or after `startDate` and before
1667
+ # `endDate`. If `startDate` is in the middle of a billing period, that
1668
+ # period isn't included. The range can't exceed 24 calendar months.
1583
1669
  # @return [Time]
1584
1670
  #
1585
1671
  # @!attribute [rw] end_date
1586
- # Inclusive end date as Unix epoch seconds.
1672
+ # The exclusive end date of the range, in Unix epoch seconds. To get
1673
+ # one billing month, set `startDate` to the first day of that month.
1674
+ # Then set `endDate` to the first day of the next month. Use 00:00 UTC
1675
+ # for both.
1587
1676
  # @return [Time]
1588
1677
  #
1589
1678
  # @!attribute [rw] next_token
@@ -3225,6 +3314,94 @@ module Aws::Billing
3225
3314
  include Aws::Structure
3226
3315
  end
3227
3316
 
3317
+ # @!attribute [rw] credit_id
3318
+ # The ID of the credit to split.
3319
+ # @return [String]
3320
+ #
3321
+ # @!attribute [rw] portions
3322
+ # The new credits to create, one for each portion, in the order
3323
+ # listed.
3324
+ # @return [Array<Types::SplitPortion>]
3325
+ #
3326
+ # @!attribute [rw] client_token
3327
+ # A unique, case-sensitive identifier that you provide to ensure that
3328
+ # the operation completes no more than one time. If you retry a
3329
+ # successful request with the same client token and parameters, the
3330
+ # retry completes without performing any further actions. If you reuse
3331
+ # a client token with different parameters, the request fails with a
3332
+ # `ValidationException`.
3333
+ #
3334
+ # **A suitable default value is auto-generated.** You should normally
3335
+ # not need to pass this option.
3336
+ # @return [String]
3337
+ #
3338
+ # @!attribute [rw] dry_run
3339
+ # Specifies whether to validate the request and return the result
3340
+ # without changing any credit.
3341
+ # @return [Boolean]
3342
+ #
3343
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/SplitCreditRequest AWS API Documentation
3344
+ #
3345
+ class SplitCreditRequest < Struct.new(
3346
+ :credit_id,
3347
+ :portions,
3348
+ :client_token,
3349
+ :dry_run)
3350
+ SENSITIVE = []
3351
+ include Aws::Structure
3352
+ end
3353
+
3354
+ # @!attribute [rw] parent_credit_id
3355
+ # The ID of the credit that was split.
3356
+ # @return [String]
3357
+ #
3358
+ # @!attribute [rw] child_credits
3359
+ # The new credits, in the order of the requested portions.
3360
+ # @return [Array<Types::ChildCredit>]
3361
+ #
3362
+ # @!attribute [rw] dry_run
3363
+ # Specifies whether the request was a dry run. If `true`, the
3364
+ # operation didn't change any credit.
3365
+ # @return [Boolean]
3366
+ #
3367
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/SplitCreditResponse AWS API Documentation
3368
+ #
3369
+ class SplitCreditResponse < Struct.new(
3370
+ :parent_credit_id,
3371
+ :child_credits,
3372
+ :dry_run)
3373
+ SENSITIVE = []
3374
+ include Aws::Structure
3375
+ end
3376
+
3377
+ # One new credit to create from a split.
3378
+ #
3379
+ # @!attribute [rw] amount
3380
+ # The amount of the new credit, in the currency of the credit that you
3381
+ # split. The amount must be at least 100.00 in that currency. For
3382
+ # example, if the credit is in USD, the amount must be at least USD
3383
+ # $100.00.
3384
+ # @return [String]
3385
+ #
3386
+ # @!attribute [rw] description
3387
+ # The description of the new credit. If you omit it, the new credit
3388
+ # gets the original credit's description followed by its position in
3389
+ # the request, for example `MAP credit - 1/3`. If you split that
3390
+ # credit again, the name extends, for example `MAP credit - 1/3 -
3391
+ # 2/2`. A generated name is at most 93 characters. If it would be
3392
+ # longer, the name keeps only the beginning of the original
3393
+ # description.
3394
+ # @return [String]
3395
+ #
3396
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/SplitPortion AWS API Documentation
3397
+ #
3398
+ class SplitPortion < Struct.new(
3399
+ :amount,
3400
+ :description)
3401
+ SENSITIVE = []
3402
+ include Aws::Structure
3403
+ end
3404
+
3228
3405
  # A structure that defines how to search for string values. You can
3229
3406
  # specify a search option and the value to search for.
3230
3407
  #
@@ -3319,6 +3496,80 @@ module Aws::Billing
3319
3496
  include Aws::Structure
3320
3497
  end
3321
3498
 
3499
+ # @!attribute [rw] credit_id
3500
+ # The ID of the credit to transfer.
3501
+ # @return [String]
3502
+ #
3503
+ # @!attribute [rw] destination_account_id
3504
+ # The Amazon Web Services account ID that becomes the owner of the
3505
+ # credit. The account must be in your consolidated billing family and
3506
+ # must not be the current owner.
3507
+ # @return [String]
3508
+ #
3509
+ # @!attribute [rw] client_token
3510
+ # A unique, case-sensitive identifier that you provide to ensure that
3511
+ # the operation completes no more than one time. If you retry a
3512
+ # successful request with the same client token and parameters, the
3513
+ # retry completes without performing any further actions. If you reuse
3514
+ # a client token with different parameters, the request fails with a
3515
+ # `ValidationException`.
3516
+ #
3517
+ # **A suitable default value is auto-generated.** You should normally
3518
+ # not need to pass this option.
3519
+ # @return [String]
3520
+ #
3521
+ # @!attribute [rw] dry_run
3522
+ # Specifies whether to validate the request and return the result
3523
+ # without changing the credit.
3524
+ # @return [Boolean]
3525
+ #
3526
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/TransferCreditRequest AWS API Documentation
3527
+ #
3528
+ class TransferCreditRequest < Struct.new(
3529
+ :credit_id,
3530
+ :destination_account_id,
3531
+ :client_token,
3532
+ :dry_run)
3533
+ SENSITIVE = []
3534
+ include Aws::Structure
3535
+ end
3536
+
3537
+ # @!attribute [rw] source_credit_id
3538
+ # The ID of the transferred credit. The credit keeps this ID.
3539
+ # @return [String]
3540
+ #
3541
+ # @!attribute [rw] new_credit_id
3542
+ # Always the same as `sourceCreditId`, because a transfer moves the
3543
+ # credit and creates no new one. A dry run omits this field.
3544
+ # @return [String]
3545
+ #
3546
+ # @!attribute [rw] destination_account_id
3547
+ # The Amazon Web Services account ID that owns the credit after the
3548
+ # transfer.
3549
+ # @return [String]
3550
+ #
3551
+ # @!attribute [rw] amount
3552
+ # The available balance of the credit, which is its remaining balance
3553
+ # minus any amount reserved for a bill that isn't finalized.
3554
+ # @return [String]
3555
+ #
3556
+ # @!attribute [rw] dry_run
3557
+ # Specifies whether the request was a dry run. If `true`, the
3558
+ # operation didn't change the credit.
3559
+ # @return [Boolean]
3560
+ #
3561
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/TransferCreditResponse AWS API Documentation
3562
+ #
3563
+ class TransferCreditResponse < Struct.new(
3564
+ :source_credit_id,
3565
+ :new_credit_id,
3566
+ :destination_account_id,
3567
+ :amount,
3568
+ :dry_run)
3569
+ SENSITIVE = []
3570
+ include Aws::Structure
3571
+ end
3572
+
3322
3573
  # @!attribute [rw] resource_arn
3323
3574
  # The Amazon Resource Name (ARN) of the resource.
3324
3575
  # @return [String]
@@ -3343,9 +3594,9 @@ module Aws::Billing
3343
3594
  # @!attribute [rw] feature
3344
3595
  # The feature to update. Valid values: `BILLING_ALERTS`, `RI_SHARING`,
3345
3596
  # `CREDIT_SHARING`, `CREDIT_LEVEL_SHARING`,
3346
- # `CREDIT_PREFERENCE_OPTIONS`. The history features
3347
- # (`RI_SHARING_HISTORY` and `CREDIT_SHARING_HISTORY`) are read-only
3348
- # and cannot be updated.
3597
+ # `CREDIT_PREFERENCE_OPTIONS`, `BENEFIT_LEVEL_SHARING`. The history
3598
+ # features (`RI_SHARING_HISTORY` and `CREDIT_SHARING_HISTORY`) are
3599
+ # read-only and cannot be updated.
3349
3600
  # @return [String]
3350
3601
  #
3351
3602
  # @!attribute [rw] billing_preferences_per_key
@@ -3353,6 +3604,46 @@ module Aws::Billing
3353
3604
  # for the specified `feature` and must not be duplicated. For
3354
3605
  # `CREDIT_PREFERENCE_OPTIONS`, all keys must reference the same
3355
3606
  # `creditId`.
3607
+ #
3608
+ # For `BENEFIT_LEVEL_SHARING`, all keys must reference the same
3609
+ # Reserved Instance or Savings Plan. To share it with the accounts in
3610
+ # one Cost Category rule, send these three keys with the value
3611
+ # `ENABLED`:
3612
+ #
3613
+ # * `benefit/{ri|sp}/{benefitId}/sharing/costCategoryArn/{costCategoryArn}`
3614
+ #
3615
+ # * `benefit/{ri|sp}/{benefitId}/sharing/ruleName/{ruleName}`
3616
+ #
3617
+ # * `benefit/{ri|sp}/{benefitId}/sharing/mode/{prioritized|restricted}`
3618
+ #
3619
+ # With `prioritized`, any benefit that the rule's accounts don't use
3620
+ # goes to the rest of your consolidated billing family, following your
3621
+ # family sharing settings. With `restricted`, only the owner and the
3622
+ # rule's accounts receive it. The Cost Category must belong to your
3623
+ # account. To stop sharing, send the same three keys with the value
3624
+ # `DISABLED`.
3625
+ #
3626
+ # For `RI_SHARING` and `CREDIT_SHARING`, you can share benefits by
3627
+ # account group. Each rule in a Cost Category is one group. Send
3628
+ # exactly one of these group keys with the value `ENABLED`:
3629
+ #
3630
+ # * `open-sharing` - Share across the whole consolidated billing
3631
+ # family, with no groups.
3632
+ #
3633
+ # * `costcategory-prioritized/{costCategoryArn}` - Share within each
3634
+ # group first, then with the rest of the family.
3635
+ #
3636
+ # * `costcategory-restricted/{costCategoryArn}` - An account in a
3637
+ # group shares only with accounts in the same group.
3638
+ #
3639
+ # For `RI_SHARING`, the `costcategory-` keys use a Cost Category that
3640
+ # supports the `billing:rispgroupsharing` resource type. To use a Cost
3641
+ # Category that supports the `billing:benefitgroupsharing` resource
3642
+ # type, use the `benefitgroup-prioritized/` or
3643
+ # `benefitgroup-restricted/` prefix instead. For `CREDIT_SHARING`, the
3644
+ # Cost Category must support the `billing:benefitgroupsharing`
3645
+ # resource type. The Cost Category must belong to your account.
3646
+ # `GetBillingPreferences` returns the group key that is in effect.
3356
3647
  # @return [Array<Types::BillingPreferenceForKey>]
3357
3648
  #
3358
3649
  # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/UpdateBillingPreferencesRequest AWS API Documentation
@@ -55,7 +55,7 @@ module Aws::Billing
55
55
  autoload :EndpointProvider, 'aws-sdk-billing/endpoint_provider'
56
56
  autoload :Endpoints, 'aws-sdk-billing/endpoints'
57
57
 
58
- GEM_VERSION = '1.47.0'
58
+ GEM_VERSION = '1.48.0'
59
59
 
60
60
  end
61
61
 
data/sig/client.rbs CHANGED
@@ -221,7 +221,7 @@ module Aws
221
221
  def get_billing_preferences: (
222
222
  ?next_token: ::String,
223
223
  ?max_results: ::Integer,
224
- features: Array[("RI_SHARING" | "RI_SHARING_HISTORY" | "CREDIT_SHARING" | "CREDIT_SHARING_HISTORY" | "CREDIT_LEVEL_SHARING" | "BILLING_ALERTS" | "CREDIT_PREFERENCE_OPTIONS")],
224
+ features: Array[("RI_SHARING" | "RI_SHARING_HISTORY" | "CREDIT_SHARING" | "CREDIT_SHARING_HISTORY" | "CREDIT_LEVEL_SHARING" | "BILLING_ALERTS" | "CREDIT_PREFERENCE_OPTIONS" | "BENEFIT_LEVEL_SHARING")],
225
225
  ?filters: Array[
226
226
  {
227
227
  name: ("PREFERENCE_KEY")?,
@@ -515,6 +515,26 @@ module Aws
515
515
  ) -> _RedeemCreditsResponseSuccess
516
516
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _RedeemCreditsResponseSuccess
517
517
 
518
+ interface _SplitCreditResponseSuccess
519
+ include ::Seahorse::Client::_ResponseSuccess[Types::SplitCreditResponse]
520
+ def parent_credit_id: () -> ::String
521
+ def child_credits: () -> ::Array[Types::ChildCredit]
522
+ def dry_run: () -> bool
523
+ end
524
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Billing/Client.html#split_credit-instance_method
525
+ def split_credit: (
526
+ credit_id: ::String,
527
+ portions: Array[
528
+ {
529
+ amount: ::String,
530
+ description: ::String?
531
+ }
532
+ ],
533
+ ?client_token: ::String,
534
+ ?dry_run: bool
535
+ ) -> _SplitCreditResponseSuccess
536
+ | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _SplitCreditResponseSuccess
537
+
518
538
  interface _TagResourceResponseSuccess
519
539
  include ::Seahorse::Client::_ResponseSuccess[Types::TagResourceResponse]
520
540
  end
@@ -530,6 +550,23 @@ module Aws
530
550
  ) -> _TagResourceResponseSuccess
531
551
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _TagResourceResponseSuccess
532
552
 
553
+ interface _TransferCreditResponseSuccess
554
+ include ::Seahorse::Client::_ResponseSuccess[Types::TransferCreditResponse]
555
+ def source_credit_id: () -> ::String
556
+ def new_credit_id: () -> ::String
557
+ def destination_account_id: () -> ::String
558
+ def amount: () -> ::String
559
+ def dry_run: () -> bool
560
+ end
561
+ # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Billing/Client.html#transfer_credit-instance_method
562
+ def transfer_credit: (
563
+ credit_id: ::String,
564
+ destination_account_id: ::String,
565
+ ?client_token: ::String,
566
+ ?dry_run: bool
567
+ ) -> _TransferCreditResponseSuccess
568
+ | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _TransferCreditResponseSuccess
569
+
533
570
  interface _UntagResourceResponseSuccess
534
571
  include ::Seahorse::Client::_ResponseSuccess[Types::UntagResourceResponse]
535
572
  end
@@ -545,7 +582,7 @@ module Aws
545
582
  end
546
583
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Billing/Client.html#update_billing_preferences-instance_method
547
584
  def update_billing_preferences: (
548
- feature: ("RI_SHARING" | "RI_SHARING_HISTORY" | "CREDIT_SHARING" | "CREDIT_SHARING_HISTORY" | "CREDIT_LEVEL_SHARING" | "BILLING_ALERTS" | "CREDIT_PREFERENCE_OPTIONS"),
585
+ feature: ("RI_SHARING" | "RI_SHARING_HISTORY" | "CREDIT_SHARING" | "CREDIT_SHARING_HISTORY" | "CREDIT_LEVEL_SHARING" | "BILLING_ALERTS" | "CREDIT_PREFERENCE_OPTIONS" | "BENEFIT_LEVEL_SHARING"),
549
586
  billing_preferences_per_key: Array[
550
587
  {
551
588
  key: ::String,
data/sig/types.rbs CHANGED
@@ -109,7 +109,7 @@ module Aws::Billing
109
109
  end
110
110
 
111
111
  class BillingPreferenceSummary
112
- attr_accessor feature: ("RI_SHARING" | "RI_SHARING_HISTORY" | "CREDIT_SHARING" | "CREDIT_SHARING_HISTORY" | "CREDIT_LEVEL_SHARING" | "BILLING_ALERTS" | "CREDIT_PREFERENCE_OPTIONS")
112
+ attr_accessor feature: ("RI_SHARING" | "RI_SHARING_HISTORY" | "CREDIT_SHARING" | "CREDIT_SHARING_HISTORY" | "CREDIT_LEVEL_SHARING" | "BILLING_ALERTS" | "CREDIT_PREFERENCE_OPTIONS" | "BENEFIT_LEVEL_SHARING")
113
113
  attr_accessor key: ::String
114
114
  attr_accessor value: ("ENABLED" | "DISABLED")
115
115
  attr_accessor account_name: ::String
@@ -234,6 +234,12 @@ module Aws::Billing
234
234
  SENSITIVE: []
235
235
  end
236
236
 
237
+ class ChildCredit
238
+ attr_accessor credit_id: ::String
239
+ attr_accessor amount: ::String
240
+ SENSITIVE: []
241
+ end
242
+
237
243
  class ConflictException
238
244
  attr_accessor message: ::String
239
245
  attr_accessor resource_id: ::String
@@ -395,7 +401,7 @@ module Aws::Billing
395
401
  class GetBillingPreferencesRequest
396
402
  attr_accessor next_token: ::String
397
403
  attr_accessor max_results: ::Integer
398
- attr_accessor features: ::Array[("RI_SHARING" | "RI_SHARING_HISTORY" | "CREDIT_SHARING" | "CREDIT_SHARING_HISTORY" | "CREDIT_LEVEL_SHARING" | "BILLING_ALERTS" | "CREDIT_PREFERENCE_OPTIONS")]
404
+ attr_accessor features: ::Array[("RI_SHARING" | "RI_SHARING_HISTORY" | "CREDIT_SHARING" | "CREDIT_SHARING_HISTORY" | "CREDIT_LEVEL_SHARING" | "BILLING_ALERTS" | "CREDIT_PREFERENCE_OPTIONS" | "BENEFIT_LEVEL_SHARING")]
399
405
  attr_accessor filters: ::Array[Types::BillingFeatureFilter]
400
406
  SENSITIVE: []
401
407
  end
@@ -848,6 +854,27 @@ module Aws::Billing
848
854
  SENSITIVE: []
849
855
  end
850
856
 
857
+ class SplitCreditRequest
858
+ attr_accessor credit_id: ::String
859
+ attr_accessor portions: ::Array[Types::SplitPortion]
860
+ attr_accessor client_token: ::String
861
+ attr_accessor dry_run: bool
862
+ SENSITIVE: []
863
+ end
864
+
865
+ class SplitCreditResponse
866
+ attr_accessor parent_credit_id: ::String
867
+ attr_accessor child_credits: ::Array[Types::ChildCredit]
868
+ attr_accessor dry_run: bool
869
+ SENSITIVE: []
870
+ end
871
+
872
+ class SplitPortion
873
+ attr_accessor amount: ::String
874
+ attr_accessor description: ::String
875
+ SENSITIVE: []
876
+ end
877
+
851
878
  class StringSearch
852
879
  attr_accessor search_option: ("STARTS_WITH")
853
880
  attr_accessor search_value: ::String
@@ -880,6 +907,23 @@ module Aws::Billing
880
907
  SENSITIVE: []
881
908
  end
882
909
 
910
+ class TransferCreditRequest
911
+ attr_accessor credit_id: ::String
912
+ attr_accessor destination_account_id: ::String
913
+ attr_accessor client_token: ::String
914
+ attr_accessor dry_run: bool
915
+ SENSITIVE: []
916
+ end
917
+
918
+ class TransferCreditResponse
919
+ attr_accessor source_credit_id: ::String
920
+ attr_accessor new_credit_id: ::String
921
+ attr_accessor destination_account_id: ::String
922
+ attr_accessor amount: ::String
923
+ attr_accessor dry_run: bool
924
+ SENSITIVE: []
925
+ end
926
+
883
927
  class UntagResourceRequest
884
928
  attr_accessor resource_arn: ::String
885
929
  attr_accessor resource_tag_keys: ::Array[::String]
@@ -890,7 +934,7 @@ module Aws::Billing
890
934
  end
891
935
 
892
936
  class UpdateBillingPreferencesRequest
893
- attr_accessor feature: ("RI_SHARING" | "RI_SHARING_HISTORY" | "CREDIT_SHARING" | "CREDIT_SHARING_HISTORY" | "CREDIT_LEVEL_SHARING" | "BILLING_ALERTS" | "CREDIT_PREFERENCE_OPTIONS")
937
+ attr_accessor feature: ("RI_SHARING" | "RI_SHARING_HISTORY" | "CREDIT_SHARING" | "CREDIT_SHARING_HISTORY" | "CREDIT_LEVEL_SHARING" | "BILLING_ALERTS" | "CREDIT_PREFERENCE_OPTIONS" | "BENEFIT_LEVEL_SHARING")
894
938
  attr_accessor billing_preferences_per_key: ::Array[Types::BillingPreferenceForKey]
895
939
  SENSITIVE: []
896
940
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-billing
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.47.0
4
+ version: 1.48.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services