aws-sdk-billing 1.38.0 → 1.40.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.
@@ -66,6 +66,22 @@ module Aws::Billing
66
66
  include Aws::Structure
67
67
  end
68
68
 
69
+ # A recipient copied as a viewer on the executive approval request, in
70
+ # addition to the approver.
71
+ #
72
+ # @!attribute [rw] email
73
+ # The email address of the recipient. This value is 3–256 characters
74
+ # and must be a valid email address.
75
+ # @return [String]
76
+ #
77
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AdditionalRecipient AWS API Documentation
78
+ #
79
+ class AdditionalRecipient < Struct.new(
80
+ :email)
81
+ SENSITIVE = [:email]
82
+ include Aws::Structure
83
+ end
84
+
69
85
  # A monetary amount with a currency code. Used throughout the Billing
70
86
  # API to represent credit balances, allocations, and adjustments.
71
87
  #
@@ -87,6 +103,58 @@ module Aws::Billing
87
103
  include Aws::Structure
88
104
  end
89
105
 
106
+ # Information about the executive approver who signs off on an
107
+ # investment attestation.
108
+ #
109
+ # @!attribute [rw] name
110
+ # The name of the approver as it appears on the contract. This value
111
+ # can be up to 256 characters.
112
+ # @return [String]
113
+ #
114
+ # @!attribute [rw] title
115
+ # The title of the approver, such as `Chief Financial Officer`. This
116
+ # value can be up to 256 characters.
117
+ # @return [String]
118
+ #
119
+ # @!attribute [rw] email
120
+ # The email address of the approver. This value is 3–256 characters
121
+ # and must be a valid email address.
122
+ # @return [String]
123
+ #
124
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ApproverDetails AWS API Documentation
125
+ #
126
+ class ApproverDetails < Struct.new(
127
+ :name,
128
+ :title,
129
+ :email)
130
+ SENSITIVE = [:name, :title, :email]
131
+ include Aws::Structure
132
+ end
133
+
134
+ # @!attribute [rw] contract_arn
135
+ # The Amazon Resource Name (ARN) of the contract to associate with
136
+ # your account.
137
+ # @return [String]
138
+ #
139
+ # @!attribute [rw] contract_document_id
140
+ # The contract ID from the contract document. It can be found in the
141
+ # top right corner of your contract's pages. This value confirms that
142
+ # you have access to the contract you are associating.
143
+ # @return [String]
144
+ #
145
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AssociateContractRequest AWS API Documentation
146
+ #
147
+ class AssociateContractRequest < Struct.new(
148
+ :contract_arn,
149
+ :contract_document_id)
150
+ SENSITIVE = [:contract_document_id]
151
+ include Aws::Structure
152
+ end
153
+
154
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AssociateContractResponse AWS API Documentation
155
+ #
156
+ class AssociateContractResponse < Aws::EmptyStructure; end
157
+
90
158
  # @!attribute [rw] arn
91
159
  # The Amazon Resource Name (ARN) of the billing view to associate
92
160
  # source views with.
@@ -118,6 +186,90 @@ module Aws::Billing
118
186
  include Aws::Structure
119
187
  end
120
188
 
189
+ # The details of an investment attestation submission, including the
190
+ # value being attested and how the resulting investment is distributed.
191
+ #
192
+ # @!attribute [rw] attestation_value
193
+ # The value being attested, expressed as either a monetary amount or
194
+ # one or more quantities. Exactly one form is set.
195
+ # @return [Types::AttestationValue]
196
+ #
197
+ # @!attribute [rw] investment_distributions
198
+ # The distribution of the resulting investment across the eligible
199
+ # investment accounts on the contract. If you omit this value, the
200
+ # full investment is allocated to the single eligible investment
201
+ # account on the contract. This value is required when multiple
202
+ # investment accounts are eligible. When you provide this value, the
203
+ # sum of all distributions must equal the resulting monetary
204
+ # investment value (the attested amount, or the value computed from
205
+ # the attested quantities using the investment multipliers). The list
206
+ # contains at most 200 distributions.
207
+ # @return [Array<Types::InvestmentDistribution>]
208
+ #
209
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AttestationDetails AWS API Documentation
210
+ #
211
+ class AttestationDetails < Struct.new(
212
+ :attestation_value,
213
+ :investment_distributions)
214
+ SENSITIVE = []
215
+ include Aws::Structure
216
+ end
217
+
218
+ # A quantity-based attestation value, such as a count of workloads
219
+ # migrated.
220
+ #
221
+ # @!attribute [rw] attestation_volume
222
+ # The number of units being attested, expressed as a decimal string to
223
+ # preserve precision. The value is digits with an optional decimal
224
+ # point and is 1–1000 characters.
225
+ # @return [String]
226
+ #
227
+ # @!attribute [rw] attestation_unit
228
+ # The unit of the attestation, such as `workloads migrated`. This
229
+ # value is 1–1000 characters.
230
+ # @return [String]
231
+ #
232
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AttestationQuantity AWS API Documentation
233
+ #
234
+ class AttestationQuantity < Struct.new(
235
+ :attestation_volume,
236
+ :attestation_unit)
237
+ SENSITIVE = []
238
+ include Aws::Structure
239
+ end
240
+
241
+ # The value being attested. This is a union in which exactly one member
242
+ # is set. Set `attestationAmount` to attest a monetary amount directly,
243
+ # or set `attestationQuantities` to attest one or more quantities that
244
+ # are converted to a value using the investment's multipliers.
245
+ #
246
+ # @note AttestationValue is a union - when making an API calls you must set exactly one of the members.
247
+ #
248
+ # @!attribute [rw] attestation_amount
249
+ # The value attested as a monetary amount. This form is valid only
250
+ # when the investment has no multiplier.
251
+ # @return [Types::Amount]
252
+ #
253
+ # @!attribute [rw] attestation_quantities
254
+ # The value attested as one or more quantities, each with its own
255
+ # unit. The list contains at most 50 quantities.
256
+ # @return [Array<Types::AttestationQuantity>]
257
+ #
258
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AttestationValue AWS API Documentation
259
+ #
260
+ class AttestationValue < Struct.new(
261
+ :attestation_amount,
262
+ :attestation_quantities,
263
+ :unknown)
264
+ SENSITIVE = []
265
+ include Aws::Structure
266
+ include Aws::Structure::Union
267
+
268
+ class AttestationAmount < AttestationValue; end
269
+ class AttestationQuantities < AttestationValue; end
270
+ class Unknown < AttestationValue; end
271
+ end
272
+
121
273
  # A filter that narrows the set of preferences returned by
122
274
  # `GetBillingPreferences`.
123
275
  #
@@ -654,6 +806,34 @@ module Aws::Billing
654
806
  include Aws::Structure
655
807
  end
656
808
 
809
+ # @!attribute [rw] attestation_id
810
+ # The identifier of the investment attestation to cancel.
811
+ # @return [String]
812
+ #
813
+ # @!attribute [rw] contract_arn
814
+ # The Amazon Resource Name (ARN) of the contract that contains the
815
+ # attested investment.
816
+ # @return [String]
817
+ #
818
+ # @!attribute [rw] reason
819
+ # The reason for the cancellation. This value can be 1 to 80
820
+ # characters.
821
+ # @return [String]
822
+ #
823
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/CancelContractualInvestmentAttestationRequest AWS API Documentation
824
+ #
825
+ class CancelContractualInvestmentAttestationRequest < Struct.new(
826
+ :attestation_id,
827
+ :contract_arn,
828
+ :reason)
829
+ SENSITIVE = []
830
+ include Aws::Structure
831
+ end
832
+
833
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/CancelContractualInvestmentAttestationResponse AWS API Documentation
834
+ #
835
+ class CancelContractualInvestmentAttestationResponse < Aws::EmptyStructure; end
836
+
657
837
  # An account that is charged all or a portion of the total Support
658
838
  # charge and the percentage of the charge allocated to it.
659
839
  #
@@ -720,6 +900,78 @@ module Aws::Billing
720
900
  include Aws::Structure
721
901
  end
722
902
 
903
+ # The details of a contract returned by `GetContractInformation`. This
904
+ # is a union in which exactly one member is set, corresponding to the
905
+ # contract type. For a private pricing addendum, the
906
+ # `privatePricingAddendum` member is set. Check which member is present
907
+ # to determine the contract type.
908
+ #
909
+ # @note ContractDetails is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of ContractDetails corresponding to the set member.
910
+ #
911
+ # @!attribute [rw] private_pricing_addendum
912
+ # The details of a private pricing addendum contract. This member is
913
+ # set when the contract is a private pricing addendum.
914
+ # @return [Types::PrivatePricingAddendum]
915
+ #
916
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ContractDetails AWS API Documentation
917
+ #
918
+ class ContractDetails < Struct.new(
919
+ :private_pricing_addendum,
920
+ :unknown)
921
+ SENSITIVE = []
922
+ include Aws::Structure
923
+ include Aws::Structure::Union
924
+
925
+ class PrivatePricingAddendum < ContractDetails; end
926
+ class Unknown < ContractDetails; end
927
+ end
928
+
929
+ # A summary of a private pricing contract visible to your account.
930
+ # `ListContracts` returns these summaries.
931
+ #
932
+ # @!attribute [rw] contract_arn
933
+ # The Amazon Resource Name (ARN) of the contract. Pass this value to
934
+ # operations such as `GetContractInformation`,
935
+ # `ListContractualInvestmentSummaries`, and `AssociateContract`.
936
+ # @return [String]
937
+ #
938
+ # @!attribute [rw] contract_term
939
+ # The contract term period of the contract, expressed as an interval
940
+ # with an inclusive start date and an inclusive end date.
941
+ # @return [Types::Interval]
942
+ #
943
+ # @!attribute [rw] contract_type
944
+ # The classification of the contract. Valid values are
945
+ # `Cross-Service`, `Service-Specific`, and `Other`. `Cross-Service`
946
+ # applies across multiple Amazon Web Services services.
947
+ # `Service-Specific` applies to a specific Amazon Web Services
948
+ # service. `Other` applies to other arrangements.
949
+ # @return [String]
950
+ #
951
+ # @!attribute [rw] association_status
952
+ # Indicates whether the contract is currently associated with your
953
+ # account. Valid values are `ASSOCIATED` and `NOT_ASSOCIATED`.
954
+ # `ASSOCIATED` means the contract is associated with your account.
955
+ # `NOT_ASSOCIATED` means the contract is not associated with your
956
+ # account.
957
+ # @return [String]
958
+ #
959
+ # @!attribute [rw] last_updated_at
960
+ # The time when the contract was last associated with your account.
961
+ # @return [Time]
962
+ #
963
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ContractSummary AWS API Documentation
964
+ #
965
+ class ContractSummary < Struct.new(
966
+ :contract_arn,
967
+ :contract_term,
968
+ :contract_type,
969
+ :association_status,
970
+ :last_updated_at)
971
+ SENSITIVE = []
972
+ include Aws::Structure
973
+ end
974
+
723
975
  # The Cost Categories values used for filtering the costs.
724
976
  #
725
977
  # @!attribute [rw] key
@@ -808,6 +1060,86 @@ module Aws::Billing
808
1060
  include Aws::Structure
809
1061
  end
810
1062
 
1063
+ # @!attribute [rw] contract_arn
1064
+ # The Amazon Resource Name (ARN) of the contract that contains the
1065
+ # investment being attested.
1066
+ # @return [String]
1067
+ #
1068
+ # @!attribute [rw] investment_summary_id
1069
+ # The identifier of the investment summary being attested. This is the
1070
+ # parent to the investmentId.
1071
+ # @return [String]
1072
+ #
1073
+ # @!attribute [rw] investment_id
1074
+ # The identifier of the investment (outcome) being attested.
1075
+ # @return [String]
1076
+ #
1077
+ # @!attribute [rw] contract_document_id
1078
+ # The contract ID from the contract document, located in the top-right
1079
+ # corner of the private pricing contract pages. This value confirms
1080
+ # that you have access to the contract.
1081
+ # @return [String]
1082
+ #
1083
+ # @!attribute [rw] approver_details
1084
+ # The details of the executive who authorized the attestation, under
1085
+ # the terms of the private pricing contract. The executive receives a
1086
+ # click-to-accept email to confirm the attestation.
1087
+ # @return [Types::ApproverDetails]
1088
+ #
1089
+ # @!attribute [rw] investment_disbursed_at
1090
+ # The date on which the investment is disbursed to the investment
1091
+ # accounts. The disbursement date is subject to review timelines.
1092
+ # @return [Time]
1093
+ #
1094
+ # @!attribute [rw] attestation_details
1095
+ # The details of the attestation, including the value being claimed
1096
+ # and how the resulting investment is distributed across investment
1097
+ # accounts.
1098
+ # @return [Types::AttestationDetails]
1099
+ #
1100
+ # @!attribute [rw] additional_recipients
1101
+ # The email addresses to copy as viewers on the executive approval
1102
+ # request.
1103
+ # @return [Array<Types::AdditionalRecipient>]
1104
+ #
1105
+ # @!attribute [rw] client_token
1106
+ # A unique, case-sensitive identifier that you provide to ensure the
1107
+ # idempotency of the request. If you retry a request that completed
1108
+ # successfully using the same client token and parameters, the retry
1109
+ # completes without performing any further actions.
1110
+ #
1111
+ # **A suitable default value is auto-generated.** You should normally
1112
+ # not need to pass this option.
1113
+ # @return [String]
1114
+ #
1115
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/CreateContractualInvestmentAttestationRequest AWS API Documentation
1116
+ #
1117
+ class CreateContractualInvestmentAttestationRequest < Struct.new(
1118
+ :contract_arn,
1119
+ :investment_summary_id,
1120
+ :investment_id,
1121
+ :contract_document_id,
1122
+ :approver_details,
1123
+ :investment_disbursed_at,
1124
+ :attestation_details,
1125
+ :additional_recipients,
1126
+ :client_token)
1127
+ SENSITIVE = [:contract_document_id]
1128
+ include Aws::Structure
1129
+ end
1130
+
1131
+ # @!attribute [rw] attestation_id
1132
+ # The identifier of the submitted attestation.
1133
+ # @return [String]
1134
+ #
1135
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/CreateContractualInvestmentAttestationResponse AWS API Documentation
1136
+ #
1137
+ class CreateContractualInvestmentAttestationResponse < Struct.new(
1138
+ :attestation_id)
1139
+ SENSITIVE = []
1140
+ include Aws::Structure
1141
+ end
1142
+
811
1143
  # A single entry in the credit allocation history, representing how a
812
1144
  # credit was applied to a specific service during a billing month.
813
1145
  #
@@ -1030,6 +1362,23 @@ module Aws::Billing
1030
1362
  include Aws::Structure
1031
1363
  end
1032
1364
 
1365
+ # @!attribute [rw] contract_arn
1366
+ # The Amazon Resource Name (ARN) of the contract to disassociate from
1367
+ # your account.
1368
+ # @return [String]
1369
+ #
1370
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/DisassociateContractRequest AWS API Documentation
1371
+ #
1372
+ class DisassociateContractRequest < Struct.new(
1373
+ :contract_arn)
1374
+ SENSITIVE = []
1375
+ include Aws::Structure
1376
+ end
1377
+
1378
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/DisassociateContractResponse AWS API Documentation
1379
+ #
1380
+ class DisassociateContractResponse < Aws::EmptyStructure; end
1381
+
1033
1382
  # @!attribute [rw] arn
1034
1383
  # The Amazon Resource Name (ARN) of the billing view to disassociate
1035
1384
  # source views from.
@@ -1191,6 +1540,32 @@ module Aws::Billing
1191
1540
  include Aws::Structure
1192
1541
  end
1193
1542
 
1543
+ # @!attribute [rw] contract_arn
1544
+ # The Amazon Resource Name (ARN) of the contract to retrieve
1545
+ # information about.
1546
+ # @return [String]
1547
+ #
1548
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/GetContractInformationRequest AWS API Documentation
1549
+ #
1550
+ class GetContractInformationRequest < Struct.new(
1551
+ :contract_arn)
1552
+ SENSITIVE = []
1553
+ include Aws::Structure
1554
+ end
1555
+
1556
+ # @!attribute [rw] contract
1557
+ # The contract details such as term (duration), eligible payer
1558
+ # accounts, investment accounts, and legal entities.
1559
+ # @return [Types::ContractDetails]
1560
+ #
1561
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/GetContractInformationResponse AWS API Documentation
1562
+ #
1563
+ class GetContractInformationResponse < Struct.new(
1564
+ :contract)
1565
+ SENSITIVE = []
1566
+ include Aws::Structure
1567
+ end
1568
+
1194
1569
  # @!attribute [rw] account_id
1195
1570
  # The Amazon Web Services account ID whose allocation history to
1196
1571
  # retrieve. Must be a 12-digit numeric string.
@@ -1580,6 +1955,283 @@ module Aws::Billing
1580
1955
  include Aws::Structure
1581
1956
  end
1582
1957
 
1958
+ # A time period bounded by an inclusive start date and an inclusive end
1959
+ # date.
1960
+ #
1961
+ # @!attribute [rw] start_date_inclusive
1962
+ # The start date of the interval. This date is included in the
1963
+ # interval.
1964
+ # @return [Time]
1965
+ #
1966
+ # @!attribute [rw] end_date_inclusive
1967
+ # The end date of the interval. This date is included in the interval.
1968
+ # @return [Time]
1969
+ #
1970
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/Interval AWS API Documentation
1971
+ #
1972
+ class Interval < Struct.new(
1973
+ :start_date_inclusive,
1974
+ :end_date_inclusive)
1975
+ SENSITIVE = []
1976
+ include Aws::Structure
1977
+ end
1978
+
1979
+ # An investment within an investment summary. This is a union in which
1980
+ # exactly one member is set. The `milestoneBasedInvestment` member
1981
+ # represents a fixed, scheduled investment. The `outcomeBasedInvestment`
1982
+ # member represents an attestable investment awarded upon completion of
1983
+ # a defined outcome. Check which member is present to determine the
1984
+ # investment type.
1985
+ #
1986
+ # @note Investment is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Investment corresponding to the set member.
1987
+ #
1988
+ # @!attribute [rw] milestone_based_investment
1989
+ # An investment with a fixed value that is disbursed on a schedule.
1990
+ # This member is set for a milestone-based investment and corresponds
1991
+ # to the `MILESTONE_BASED` investment type.
1992
+ # @return [Types::MilestoneBasedInvestment]
1993
+ #
1994
+ # @!attribute [rw] outcome_based_investment
1995
+ # An investment that is awarded upon completion of a defined outcome.
1996
+ # This member is set for an outcome-based (attestable) investment and
1997
+ # corresponds to the `OUTCOME_BASED` investment type.
1998
+ # @return [Types::OutcomeBasedInvestment]
1999
+ #
2000
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/Investment AWS API Documentation
2001
+ #
2002
+ class Investment < Struct.new(
2003
+ :milestone_based_investment,
2004
+ :outcome_based_investment,
2005
+ :unknown)
2006
+ SENSITIVE = []
2007
+ include Aws::Structure
2008
+ include Aws::Structure::Union
2009
+
2010
+ class MilestoneBasedInvestment < Investment; end
2011
+ class OutcomeBasedInvestment < Investment; end
2012
+ class Unknown < Investment; end
2013
+ end
2014
+
2015
+ # A summary of a submitted investment attestation, as returned by
2016
+ # `ListContractualInvestmentAttestations`.
2017
+ #
2018
+ # @!attribute [rw] attestation_id
2019
+ # The identifier of the attestation. This value is returned by
2020
+ # `CreateContractualInvestmentAttestation` and is used to cancel the
2021
+ # attestation with `CancelContractualInvestmentAttestation`. This
2022
+ # value is 1–36 characters.
2023
+ # @return [String]
2024
+ #
2025
+ # @!attribute [rw] investment_name
2026
+ # The name of the investment summary that contains the attested
2027
+ # outcome. This value is 1–400 characters.
2028
+ # @return [String]
2029
+ #
2030
+ # @!attribute [rw] outcome_description
2031
+ # The description of the attested outcome. This value is 1–2048
2032
+ # characters.
2033
+ # @return [String]
2034
+ #
2035
+ # @!attribute [rw] investment_summary_id
2036
+ # The identifier of the investment summary that was attested, as
2037
+ # returned by `ListContractualInvestmentSummaries`.
2038
+ # @return [String]
2039
+ #
2040
+ # @!attribute [rw] investment_id
2041
+ # The identifier of the investment that was attested, as returned by
2042
+ # `ListContractualInvestments`.
2043
+ # @return [String]
2044
+ #
2045
+ # @!attribute [rw] attested_at
2046
+ # The date on which the attestation was submitted.
2047
+ # @return [Time]
2048
+ #
2049
+ # @!attribute [rw] updated_at
2050
+ # The date on which the attestation was last updated.
2051
+ # @return [Time]
2052
+ #
2053
+ # @!attribute [rw] attestation_status
2054
+ # The current status of the attestation. Valid values are
2055
+ # `PENDING_REVIEW`, `PENDING_C_LEVEL_APPROVAL`,
2056
+ # `PENDING_CANCELLATION`, `REJECTED`, `CANCELLED`, and `DISBURSED`.
2057
+ # The values `DISBURSED`, `REJECTED`, and `CANCELLED` are terminal.
2058
+ # The other values indicate the attestation is still in progress.
2059
+ # @return [String]
2060
+ #
2061
+ # @!attribute [rw] investment_disbursed_at
2062
+ # The start date on which the investment is disbursed to the
2063
+ # investment accounts. This is not the same as the time of
2064
+ # disbursement, but reflects the date you submitted with the
2065
+ # attestation.
2066
+ # @return [Time]
2067
+ #
2068
+ # @!attribute [rw] attested_value
2069
+ # The monetary value attested.
2070
+ # @return [Types::Amount]
2071
+ #
2072
+ # @!attribute [rw] investment_distributions
2073
+ # The distribution of the attested investment across the eligible
2074
+ # investment accounts. The list contains at most 200 distributions.
2075
+ # @return [Array<Types::InvestmentDistribution>]
2076
+ #
2077
+ # @!attribute [rw] rejection_reasons
2078
+ # The reasons the attestation was rejected. This value is present only
2079
+ # when `attestationStatus` is `REJECTED`. The list contains at most 30
2080
+ # reasons.
2081
+ # @return [Array<String>]
2082
+ #
2083
+ # @!attribute [rw] is_cancellable
2084
+ # Indicates whether the attestation can be canceled with
2085
+ # `CancelContractualInvestmentAttestation`.
2086
+ # @return [Boolean]
2087
+ #
2088
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/InvestmentAttestation AWS API Documentation
2089
+ #
2090
+ class InvestmentAttestation < Struct.new(
2091
+ :attestation_id,
2092
+ :investment_name,
2093
+ :outcome_description,
2094
+ :investment_summary_id,
2095
+ :investment_id,
2096
+ :attested_at,
2097
+ :updated_at,
2098
+ :attestation_status,
2099
+ :investment_disbursed_at,
2100
+ :attested_value,
2101
+ :investment_distributions,
2102
+ :rejection_reasons,
2103
+ :is_cancellable)
2104
+ SENSITIVE = []
2105
+ include Aws::Structure
2106
+ end
2107
+
2108
+ # An allocation of an investment disbursement to a specific recipient
2109
+ # account. The account is the target account that receives the
2110
+ # investment, not your account.
2111
+ #
2112
+ # @!attribute [rw] account_id
2113
+ # The recipient Amazon Web Services account ID that receives this
2114
+ # portion of the investment. This must be one of the eligible
2115
+ # investment accounts on the contract.
2116
+ # @return [String]
2117
+ #
2118
+ # @!attribute [rw] investment_amount
2119
+ # The monetary value allocated to the recipient account.
2120
+ # @return [Types::Amount]
2121
+ #
2122
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/InvestmentDistribution AWS API Documentation
2123
+ #
2124
+ class InvestmentDistribution < Struct.new(
2125
+ :account_id,
2126
+ :investment_amount)
2127
+ SENSITIVE = []
2128
+ include Aws::Structure
2129
+ end
2130
+
2131
+ # A multiplier used to convert attestation input into an investment
2132
+ # value.
2133
+ #
2134
+ # @!attribute [rw] value
2135
+ # The multiplier value, expressed as a decimal string to preserve
2136
+ # precision. The value is digits with an optional decimal point and is
2137
+ # 1–1000 characters. The terms of the contract define this value.
2138
+ # @return [String]
2139
+ #
2140
+ # @!attribute [rw] investment_attestation_input_unit
2141
+ # The unit of the attestation input that the multiplier applies to,
2142
+ # such as `workloads migrated`. This value is 1–1000 characters. The
2143
+ # terms of the contract define this value.
2144
+ # @return [String]
2145
+ #
2146
+ # @!attribute [rw] multiplier_type
2147
+ # The type of the multiplier. A value of `PERCENTAGE` applies a
2148
+ # percentage of a value. A value of `CURRENCY_AMOUNT` applies a
2149
+ # currency amount per unit of attestation input. The terms of the
2150
+ # contract define this value.
2151
+ # @return [String]
2152
+ #
2153
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/InvestmentMultiplier AWS API Documentation
2154
+ #
2155
+ class InvestmentMultiplier < Struct.new(
2156
+ :value,
2157
+ :investment_attestation_input_unit,
2158
+ :multiplier_type)
2159
+ SENSITIVE = []
2160
+ include Aws::Structure
2161
+ end
2162
+
2163
+ # A restriction that caps the value that can be disbursed for an
2164
+ # investment. The cap applies for each attestation window.
2165
+ #
2166
+ # @!attribute [rw] amount
2167
+ # The maximum monetary amount allowed under the restriction.
2168
+ # @return [Types::Amount]
2169
+ #
2170
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/InvestmentRestriction AWS API Documentation
2171
+ #
2172
+ class InvestmentRestriction < Struct.new(
2173
+ :amount)
2174
+ SENSITIVE = []
2175
+ include Aws::Structure
2176
+ end
2177
+
2178
+ # Detailed information about an investment summary within a contract or
2179
+ # a private pricing addendum.
2180
+ #
2181
+ # @!attribute [rw] investment_summary_id
2182
+ # The identifier of the investment summary. Pass this value to
2183
+ # `ListContractualInvestments` to list the investments within the
2184
+ # summary, and to `CreateContractualInvestmentAttestation` to attest
2185
+ # an investment. This value is 1–36 characters.
2186
+ # @return [String]
2187
+ #
2188
+ # @!attribute [rw] investment_name
2189
+ # The name of the investment summary, used to reference the investment
2190
+ # against a term in the physical contract. This value is 1–400
2191
+ # characters.
2192
+ # @return [String]
2193
+ #
2194
+ # @!attribute [rw] investment_type
2195
+ # The type of the investment summary. Valid values are
2196
+ # `MILESTONE_BASED` and `OUTCOME_BASED`. `OUTCOME_BASED` investments
2197
+ # can be attested to, upon completion of outcomes. `MILESTONE_BASED`
2198
+ # are automatically triggered by Amazon Web Services, based on the
2199
+ # time schedule in the contract.
2200
+ # @return [String]
2201
+ #
2202
+ # @!attribute [rw] max_allowed_investment_disbursement_value
2203
+ # The maximum monetary value that can be disbursed against the
2204
+ # investment summary, inclusive of all outcomes combined under the
2205
+ # summary.
2206
+ # @return [Types::Amount]
2207
+ #
2208
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/InvestmentSummary AWS API Documentation
2209
+ #
2210
+ class InvestmentSummary < Struct.new(
2211
+ :investment_summary_id,
2212
+ :investment_name,
2213
+ :investment_type,
2214
+ :max_allowed_investment_disbursement_value)
2215
+ SENSITIVE = []
2216
+ include Aws::Structure
2217
+ end
2218
+
2219
+ # A legal entity on a private pricing contract. It can be found on your
2220
+ # contract's signature page.
2221
+ #
2222
+ # @!attribute [rw] legal_entity_name
2223
+ # The name of the legal entity as it appears on the contract document.
2224
+ # This value can be up to 256 characters.
2225
+ # @return [String]
2226
+ #
2227
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/LegalEntity AWS API Documentation
2228
+ #
2229
+ class LegalEntity < Struct.new(
2230
+ :legal_entity_name)
2231
+ SENSITIVE = [:legal_entity_name]
2232
+ include Aws::Structure
2233
+ end
2234
+
1583
2235
  # Enterprise Support charges for a linked account.
1584
2236
  #
1585
2237
  # @!attribute [rw] account_id
@@ -1928,6 +2580,189 @@ module Aws::Billing
1928
2580
  include Aws::Structure
1929
2581
  end
1930
2582
 
2583
+ # @!attribute [rw] next_token
2584
+ # The pagination token that indicates the next set of results to
2585
+ # retrieve.
2586
+ # @return [String]
2587
+ #
2588
+ # @!attribute [rw] max_results
2589
+ # The maximum number of contracts to return in a single call. Minimum
2590
+ # value of 1, maximum value of 100.
2591
+ # @return [Integer]
2592
+ #
2593
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractsRequest AWS API Documentation
2594
+ #
2595
+ class ListContractsRequest < Struct.new(
2596
+ :next_token,
2597
+ :max_results)
2598
+ SENSITIVE = []
2599
+ include Aws::Structure
2600
+ end
2601
+
2602
+ # @!attribute [rw] items
2603
+ # The list of contracts that your Amazon Web Services account is an
2604
+ # eligible payer account of.
2605
+ # @return [Array<Types::ContractSummary>]
2606
+ #
2607
+ # @!attribute [rw] next_token
2608
+ # The pagination token to use on subsequent calls to retrieve the next
2609
+ # set of results.
2610
+ # @return [String]
2611
+ #
2612
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractsResponse AWS API Documentation
2613
+ #
2614
+ class ListContractsResponse < Struct.new(
2615
+ :items,
2616
+ :next_token)
2617
+ SENSITIVE = []
2618
+ include Aws::Structure
2619
+ end
2620
+
2621
+ # @!attribute [rw] contract_arn
2622
+ # The Amazon Resource Name (ARN) of the contract whose attestations
2623
+ # you want to list.
2624
+ # @return [String]
2625
+ #
2626
+ # @!attribute [rw] investment_summary_id
2627
+ # The identifier of a specific investment summary to filter the
2628
+ # attestations by. If omitted, attestations for all investment
2629
+ # summaries in the contract are returned.
2630
+ # @return [String]
2631
+ #
2632
+ # @!attribute [rw] next_token
2633
+ # The pagination token that indicates the next set of results to
2634
+ # retrieve.
2635
+ # @return [String]
2636
+ #
2637
+ # @!attribute [rw] max_results
2638
+ # The maximum number of attestations to return in a single call.
2639
+ # Minimum value of 1, maximum value of 100.
2640
+ # @return [Integer]
2641
+ #
2642
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractualInvestmentAttestationsRequest AWS API Documentation
2643
+ #
2644
+ class ListContractualInvestmentAttestationsRequest < Struct.new(
2645
+ :contract_arn,
2646
+ :investment_summary_id,
2647
+ :next_token,
2648
+ :max_results)
2649
+ SENSITIVE = []
2650
+ include Aws::Structure
2651
+ end
2652
+
2653
+ # @!attribute [rw] items
2654
+ # The list of investment attestations submitted under the contract.
2655
+ # @return [Array<Types::InvestmentAttestation>]
2656
+ #
2657
+ # @!attribute [rw] next_token
2658
+ # The pagination token to use on subsequent calls to retrieve the next
2659
+ # set of results.
2660
+ # @return [String]
2661
+ #
2662
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractualInvestmentAttestationsResponse AWS API Documentation
2663
+ #
2664
+ class ListContractualInvestmentAttestationsResponse < Struct.new(
2665
+ :items,
2666
+ :next_token)
2667
+ SENSITIVE = []
2668
+ include Aws::Structure
2669
+ end
2670
+
2671
+ # @!attribute [rw] contract_arn
2672
+ # The Amazon Resource Name (ARN) of the contract whose investment
2673
+ # summaries you want to list.
2674
+ # @return [String]
2675
+ #
2676
+ # @!attribute [rw] next_token
2677
+ # The pagination token that indicates the next set of results to
2678
+ # retrieve.
2679
+ # @return [String]
2680
+ #
2681
+ # @!attribute [rw] max_results
2682
+ # The maximum number of investment summaries to return in a single
2683
+ # call. Minimum value of 1, maximum value of 100.
2684
+ # @return [Integer]
2685
+ #
2686
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractualInvestmentSummariesRequest AWS API Documentation
2687
+ #
2688
+ class ListContractualInvestmentSummariesRequest < Struct.new(
2689
+ :contract_arn,
2690
+ :next_token,
2691
+ :max_results)
2692
+ SENSITIVE = []
2693
+ include Aws::Structure
2694
+ end
2695
+
2696
+ # @!attribute [rw] items
2697
+ # The list of investment summaries under the contract. It includes the
2698
+ # investment name, maximum investment amount, and investment type. It
2699
+ # does not provide investment details. Use this to know if the
2700
+ # contract has investment terms and what type.
2701
+ # @return [Array<Types::InvestmentSummary>]
2702
+ #
2703
+ # @!attribute [rw] next_token
2704
+ # The pagination token to use on subsequent calls to retrieve the next
2705
+ # set of results.
2706
+ # @return [String]
2707
+ #
2708
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractualInvestmentSummariesResponse AWS API Documentation
2709
+ #
2710
+ class ListContractualInvestmentSummariesResponse < Struct.new(
2711
+ :items,
2712
+ :next_token)
2713
+ SENSITIVE = []
2714
+ include Aws::Structure
2715
+ end
2716
+
2717
+ # @!attribute [rw] contract_arn
2718
+ # The Amazon Resource Name (ARN) of the contract that contains the
2719
+ # investment summary.
2720
+ # @return [String]
2721
+ #
2722
+ # @!attribute [rw] investment_summary_id
2723
+ # The identifier of the investment summary whose investments you want
2724
+ # to list.
2725
+ # @return [String]
2726
+ #
2727
+ # @!attribute [rw] next_token
2728
+ # The pagination token that indicates the next set of results to
2729
+ # retrieve.
2730
+ # @return [String]
2731
+ #
2732
+ # @!attribute [rw] max_results
2733
+ # The maximum number of investments to return in a single call.
2734
+ # Minimum value of 1, maximum value of 100.
2735
+ # @return [Integer]
2736
+ #
2737
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractualInvestmentsRequest AWS API Documentation
2738
+ #
2739
+ class ListContractualInvestmentsRequest < Struct.new(
2740
+ :contract_arn,
2741
+ :investment_summary_id,
2742
+ :next_token,
2743
+ :max_results)
2744
+ SENSITIVE = []
2745
+ include Aws::Structure
2746
+ end
2747
+
2748
+ # @!attribute [rw] items
2749
+ # The list of investments for the investment summary.
2750
+ # @return [Array<Types::Investment>]
2751
+ #
2752
+ # @!attribute [rw] next_token
2753
+ # The pagination token to use on subsequent calls to retrieve the next
2754
+ # set of results.
2755
+ # @return [String]
2756
+ #
2757
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractualInvestmentsResponse AWS API Documentation
2758
+ #
2759
+ class ListContractualInvestmentsResponse < Struct.new(
2760
+ :items,
2761
+ :next_token)
2762
+ SENSITIVE = []
2763
+ include Aws::Structure
2764
+ end
2765
+
1931
2766
  # The request structure for ListEnterpriseSupportLinkedAccountCharges.
1932
2767
  #
1933
2768
  # @!attribute [rw] billing_month
@@ -2046,6 +2881,83 @@ module Aws::Billing
2046
2881
  include Aws::Structure
2047
2882
  end
2048
2883
 
2884
+ # An investment with a fixed value that is disbursed on a schedule. This
2885
+ # corresponds to the `MILESTONE_BASED` investment type.
2886
+ #
2887
+ # @!attribute [rw] investment_id
2888
+ # The identifier of the investment, as returned by
2889
+ # `ListContractualInvestments`. This value is 1–36 characters.
2890
+ # @return [String]
2891
+ #
2892
+ # @!attribute [rw] investment_value
2893
+ # The total value of the investment, including its currency and
2894
+ # amount.
2895
+ # @return [Types::Amount]
2896
+ #
2897
+ # @!attribute [rw] investment_disbursed_at
2898
+ # The date on which the investment is disbursed to the investment
2899
+ # accounts.
2900
+ # @return [Time]
2901
+ #
2902
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/MilestoneBasedInvestment AWS API Documentation
2903
+ #
2904
+ class MilestoneBasedInvestment < Struct.new(
2905
+ :investment_id,
2906
+ :investment_value,
2907
+ :investment_disbursed_at)
2908
+ SENSITIVE = []
2909
+ include Aws::Structure
2910
+ end
2911
+
2912
+ # An investment that is awarded upon completion of a defined outcome.
2913
+ # This corresponds to the `OUTCOME_BASED` investment type and is claimed
2914
+ # through `CreateContractualInvestmentAttestation`.
2915
+ #
2916
+ # @!attribute [rw] investment_id
2917
+ # The identifier of the investment, as returned by
2918
+ # `ListContractualInvestments`. This value is 1–36 characters.
2919
+ # @return [String]
2920
+ #
2921
+ # @!attribute [rw] outcome_description
2922
+ # The description of what must be completed to attest the outcome.
2923
+ # This value is 1–2048 characters.
2924
+ # @return [String]
2925
+ #
2926
+ # @!attribute [rw] attestation_window
2927
+ # The time window, expressed as an interval with inclusive start and
2928
+ # end dates, during which outcomes can be attested to.
2929
+ # @return [Types::Interval]
2930
+ #
2931
+ # @!attribute [rw] investment_restrictions
2932
+ # The restrictions that cap the value that can be disbursed for the
2933
+ # investment. The list contains at most 10 restrictions.
2934
+ # @return [Array<Types::InvestmentRestriction>]
2935
+ #
2936
+ # @!attribute [rw] investment_multipliers
2937
+ # The multipliers used to compute the investment value from the
2938
+ # attestation input. The list contains at most 200 multipliers.
2939
+ # Multipliers are derived from the terms of the private pricing
2940
+ # contract.
2941
+ # @return [Array<Types::InvestmentMultiplier>]
2942
+ #
2943
+ # @!attribute [rw] disbursed_value
2944
+ # The total value already disbursed against the investment. This value
2945
+ # can be distributed among the investment accounts distribution.
2946
+ # @return [Types::Amount]
2947
+ #
2948
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/OutcomeBasedInvestment AWS API Documentation
2949
+ #
2950
+ class OutcomeBasedInvestment < Struct.new(
2951
+ :investment_id,
2952
+ :outcome_description,
2953
+ :attestation_window,
2954
+ :investment_restrictions,
2955
+ :investment_multipliers,
2956
+ :disbursed_value)
2957
+ SENSITIVE = []
2958
+ include Aws::Structure
2959
+ end
2960
+
2049
2961
  # A pricing plan for Enterprise Support billing.
2050
2962
  #
2051
2963
  # @!attribute [rw] pricing_plan_id
@@ -2154,6 +3066,54 @@ module Aws::Billing
2154
3066
  include Aws::Structure
2155
3067
  end
2156
3068
 
3069
+ # The details of a private pricing addendum contract.
3070
+ #
3071
+ # @!attribute [rw] contract_arn
3072
+ # The Amazon Resource Name (ARN) of the private pricing addendum.
3073
+ # @return [String]
3074
+ #
3075
+ # @!attribute [rw] contract_term
3076
+ # The contract term period of the private pricing addendum, expressed
3077
+ # as an interval with an inclusive start date and an inclusive end
3078
+ # date.
3079
+ # @return [Types::Interval]
3080
+ #
3081
+ # @!attribute [rw] eligible_payer_accounts
3082
+ # The payer accounts that are eligible under the private pricing
3083
+ # addendum. The list contains at most 100 account IDs.
3084
+ # @return [Array<String>]
3085
+ #
3086
+ # @!attribute [rw] investment_accounts
3087
+ # The accounts that are eligible to receive investments under the
3088
+ # private pricing addendum. An `InvestmentDistribution` must target
3089
+ # one of these accounts. The list contains at most 100 account IDs.
3090
+ # @return [Array<String>]
3091
+ #
3092
+ # @!attribute [rw] legal_entities
3093
+ # The legal entities on the private pricing addendum. The list
3094
+ # contains at most 10 legal entities.
3095
+ # @return [Array<Types::LegalEntity>]
3096
+ #
3097
+ # @!attribute [rw] contract_restrictions
3098
+ # The restrictions that limit the self-service actions you can take on
3099
+ # the private pricing addendum. An empty or absent value indicates
3100
+ # that no restrictions apply. The list contains at most 10
3101
+ # restrictions.
3102
+ # @return [Array<String>]
3103
+ #
3104
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/PrivatePricingAddendum AWS API Documentation
3105
+ #
3106
+ class PrivatePricingAddendum < Struct.new(
3107
+ :contract_arn,
3108
+ :contract_term,
3109
+ :eligible_payer_accounts,
3110
+ :investment_accounts,
3111
+ :legal_entities,
3112
+ :contract_restrictions)
3113
+ SENSITIVE = []
3114
+ include Aws::Structure
3115
+ end
3116
+
2157
3117
  # @!attribute [rw] promo_code
2158
3118
  # The promotional credit code to redeem.
2159
3119
  # @return [String]