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.
@@ -488,6 +488,52 @@ module Aws::Billing
488
488
 
489
489
  # @!group API Operations
490
490
 
491
+ # Private Pricing contracts let eligible payer accounts manage private
492
+ # pricing agreements with Amazon Web Services. This operation associates
493
+ # a private pricing contract with the caller's Amazon Web Services
494
+ # account. The caller must be a payer (management) account listed on the
495
+ # contract. This operation is idempotent, so retrying a request that
496
+ # already succeeded is safe.
497
+ #
498
+ # @option params [required, String] :contract_arn
499
+ # The Amazon Resource Name (ARN) of the contract to associate with your
500
+ # account.
501
+ #
502
+ # @option params [required, String] :contract_document_id
503
+ # The contract ID from the contract document. It can be found in the top
504
+ # right corner of your contract's pages. This value confirms that you
505
+ # have access to the contract you are associating.
506
+ #
507
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
508
+ #
509
+ #
510
+ # @example Example: Invoke AssociateContract
511
+ #
512
+ # resp = client.associate_contract({
513
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
514
+ # contract_document_id: "CC OTH XXXXXXXX XXXX TR",
515
+ # })
516
+ #
517
+ # resp.to_h outputs the following:
518
+ # {
519
+ # }
520
+ #
521
+ # @example Request syntax with placeholder values
522
+ #
523
+ # resp = client.associate_contract({
524
+ # contract_arn: "ArnString", # required
525
+ # contract_document_id: "ContractDocumentId", # required
526
+ # })
527
+ #
528
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/AssociateContract AWS API Documentation
529
+ #
530
+ # @overload associate_contract(params = {})
531
+ # @param [Hash] params ({})
532
+ def associate_contract(params = {}, options = {})
533
+ req = build_request(:associate_contract, params)
534
+ req.send_request(options)
535
+ end
536
+
491
537
  # Associates one or more source billing views with an existing billing
492
538
  # view. This allows creating aggregate billing views that combine data
493
539
  # from multiple sources.
@@ -539,6 +585,52 @@ module Aws::Billing
539
585
  req.send_request(options)
540
586
  end
541
587
 
588
+ # Cancels a contractual investment attestation. This operation is
589
+ # idempotent, so retrying is safe. You can cancel an attestation only
590
+ # while it is still pending (its `isCancellable` value is `true`).
591
+ #
592
+ # @option params [required, String] :attestation_id
593
+ # The identifier of the investment attestation to cancel.
594
+ #
595
+ # @option params [required, String] :contract_arn
596
+ # The Amazon Resource Name (ARN) of the contract that contains the
597
+ # attested investment.
598
+ #
599
+ # @option params [required, String] :reason
600
+ # The reason for the cancellation. This value can be 1 to 80 characters.
601
+ #
602
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
603
+ #
604
+ #
605
+ # @example Example: Invoke CancelContractualInvestmentAttestation
606
+ #
607
+ # resp = client.cancel_contractual_investment_attestation({
608
+ # attestation_id: "a1b2c3d4-5678-90ab-cdef-111122223333",
609
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
610
+ # reason: "Example cancellation reason",
611
+ # })
612
+ #
613
+ # resp.to_h outputs the following:
614
+ # {
615
+ # }
616
+ #
617
+ # @example Request syntax with placeholder values
618
+ #
619
+ # resp = client.cancel_contractual_investment_attestation({
620
+ # attestation_id: "IdentifierString", # required
621
+ # contract_arn: "ArnString", # required
622
+ # reason: "CancellationReason", # required
623
+ # })
624
+ #
625
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/CancelContractualInvestmentAttestation AWS API Documentation
626
+ #
627
+ # @overload cancel_contractual_investment_attestation(params = {})
628
+ # @param [Hash] params ({})
629
+ def cancel_contractual_investment_attestation(params = {}, options = {})
630
+ req = build_request(:cancel_contractual_investment_attestation, params)
631
+ req.send_request(options)
632
+ end
633
+
542
634
  # Creates a billing view with the specified billing view attributes.
543
635
  #
544
636
  # @option params [required, String] :name
@@ -650,6 +742,241 @@ module Aws::Billing
650
742
  req.send_request(options)
651
743
  end
652
744
 
745
+ # Creates an attestation that claims an investment award for a completed
746
+ # milestone or outcome within a private pricing contract. Supply a
747
+ # `clientToken` to make the request idempotent so a safe retry does not
748
+ # create a duplicate attestation. This operation starts an asynchronous
749
+ # review and returns an `attestationId` while the attestation is
750
+ # pending.
751
+ #
752
+ # @option params [required, String] :contract_arn
753
+ # The Amazon Resource Name (ARN) of the contract that contains the
754
+ # investment being attested.
755
+ #
756
+ # @option params [required, String] :investment_summary_id
757
+ # The identifier of the investment summary being attested. This is the
758
+ # parent to the investmentId.
759
+ #
760
+ # @option params [required, String] :investment_id
761
+ # The identifier of the investment (outcome) being attested.
762
+ #
763
+ # @option params [required, String] :contract_document_id
764
+ # The contract ID from the contract document, located in the top-right
765
+ # corner of the private pricing contract pages. This value confirms that
766
+ # you have access to the contract.
767
+ #
768
+ # @option params [required, Types::ApproverDetails] :approver_details
769
+ # The details of the executive who authorized the attestation, under the
770
+ # terms of the private pricing contract. The executive receives a
771
+ # click-to-accept email to confirm the attestation.
772
+ #
773
+ # @option params [Time,DateTime,Date,Integer,String] :investment_disbursed_at
774
+ # The date on which the investment is disbursed to the investment
775
+ # accounts. The disbursement date is subject to review timelines.
776
+ #
777
+ # @option params [required, Types::AttestationDetails] :attestation_details
778
+ # The details of the attestation, including the value being claimed and
779
+ # how the resulting investment is distributed across investment
780
+ # accounts.
781
+ #
782
+ # @option params [Array<Types::AdditionalRecipient>] :additional_recipients
783
+ # The email addresses to copy as viewers on the executive approval
784
+ # request.
785
+ #
786
+ # @option params [String] :client_token
787
+ # A unique, case-sensitive identifier that you provide to ensure the
788
+ # idempotency of the request. If you retry a request that completed
789
+ # successfully using the same client token and parameters, the retry
790
+ # completes without performing any further actions.
791
+ #
792
+ # **A suitable default value is auto-generated.** You should normally
793
+ # not need to pass this option.**
794
+ #
795
+ # @return [Types::CreateContractualInvestmentAttestationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
796
+ #
797
+ # * {Types::CreateContractualInvestmentAttestationResponse#attestation_id #attestation_id} => String
798
+ #
799
+ #
800
+ # @example Example: Invoke CreateContractualInvestmentAttestation with a direct amount
801
+ #
802
+ # resp = client.create_contractual_investment_attestation({
803
+ # additional_recipients: [
804
+ # {
805
+ # email: "recipient@example.com",
806
+ # },
807
+ # ],
808
+ # approver_details: {
809
+ # name: "First-Name Last-Name",
810
+ # email: "first-name.last-name@example.com",
811
+ # title: "Title",
812
+ # },
813
+ # attestation_details: {
814
+ # attestation_value: {
815
+ # attestation_amount: {
816
+ # currency_amount: "1.00",
817
+ # currency_code: "USD",
818
+ # },
819
+ # },
820
+ # investment_distributions: [
821
+ # {
822
+ # account_id: "123456789012",
823
+ # investment_amount: {
824
+ # currency_amount: "1.00",
825
+ # currency_code: "USD",
826
+ # },
827
+ # },
828
+ # ],
829
+ # },
830
+ # client_token: "c0ffee00-1234-4abc-9def-0123456789ab",
831
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
832
+ # contract_document_id: "CC OTH XXXXXXXX XXXX TR",
833
+ # investment_disbursed_at: Time.parse(1199923200),
834
+ # investment_id: "Investment-Id",
835
+ # investment_summary_id: "Example-Investment-Summary-Id",
836
+ # })
837
+ #
838
+ # resp.to_h outputs the following:
839
+ # {
840
+ # attestation_id: "a1b2c3d4-5678-90ab-cdef-111122223333",
841
+ # }
842
+ #
843
+ # @example Example: Invoke CreateContractualInvestmentAttestation with a flat rate multiplier
844
+ #
845
+ # resp = client.create_contractual_investment_attestation({
846
+ # approver_details: {
847
+ # name: "First-Name Last-Name",
848
+ # email: "first-name.last-name@example.com",
849
+ # title: "Title",
850
+ # },
851
+ # attestation_details: {
852
+ # attestation_value: {
853
+ # attestation_quantities: [
854
+ # {
855
+ # attestation_unit: "Example attestation unit",
856
+ # attestation_volume: "3",
857
+ # },
858
+ # ],
859
+ # },
860
+ # investment_distributions: [
861
+ # {
862
+ # account_id: "123456789012",
863
+ # investment_amount: {
864
+ # currency_amount: "1500.00",
865
+ # currency_code: "USD",
866
+ # },
867
+ # },
868
+ # ],
869
+ # },
870
+ # client_token: "c0ffee00-1234-4abc-9def-0123456789ac",
871
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
872
+ # contract_document_id: "CC OTH XXXXXXXX XXXX TR",
873
+ # investment_disbursed_at: Time.parse(1199923200),
874
+ # investment_id: "Investment-Id",
875
+ # investment_summary_id: "Example-Investment-Summary-Id",
876
+ # })
877
+ #
878
+ # resp.to_h outputs the following:
879
+ # {
880
+ # attestation_id: "b2c3d4e5-6789-01bc-def0-222233334444",
881
+ # }
882
+ #
883
+ # @example Example: Invoke CreateContractualInvestmentAttestation with a percentage multiplier
884
+ #
885
+ # resp = client.create_contractual_investment_attestation({
886
+ # approver_details: {
887
+ # name: "First-Name Last-Name",
888
+ # email: "first-name.last-name@example.com",
889
+ # title: "Title",
890
+ # },
891
+ # attestation_details: {
892
+ # attestation_value: {
893
+ # attestation_quantities: [
894
+ # {
895
+ # attestation_unit: "Example attestation unit",
896
+ # attestation_volume: "1000",
897
+ # },
898
+ # ],
899
+ # },
900
+ # investment_distributions: [
901
+ # {
902
+ # account_id: "123456789012",
903
+ # investment_amount: {
904
+ # currency_amount: "150.00",
905
+ # currency_code: "USD",
906
+ # },
907
+ # },
908
+ # ],
909
+ # },
910
+ # client_token: "c0ffee00-1234-4abc-9def-0123456789ad",
911
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
912
+ # contract_document_id: "CC OTH XXXXXXXX XXXX TR",
913
+ # investment_disbursed_at: Time.parse(1199923200),
914
+ # investment_id: "Investment-Id",
915
+ # investment_summary_id: "Example-Investment-Summary-Id",
916
+ # })
917
+ #
918
+ # resp.to_h outputs the following:
919
+ # {
920
+ # attestation_id: "c3d4e5f6-7890-12cd-ef01-333344445555",
921
+ # }
922
+ #
923
+ # @example Request syntax with placeholder values
924
+ #
925
+ # resp = client.create_contractual_investment_attestation({
926
+ # contract_arn: "ArnString", # required
927
+ # investment_summary_id: "IdentifierString", # required
928
+ # investment_id: "IdentifierString", # required
929
+ # contract_document_id: "ContractDocumentId", # required
930
+ # approver_details: { # required
931
+ # name: "SensitiveString", # required
932
+ # title: "SensitiveString", # required
933
+ # email: "SensitiveEmail", # required
934
+ # },
935
+ # investment_disbursed_at: Time.now,
936
+ # attestation_details: { # required
937
+ # attestation_value: { # required
938
+ # attestation_amount: {
939
+ # currency_code: "CurrencyCode", # required
940
+ # currency_amount: "CurrencyAmount", # required
941
+ # },
942
+ # attestation_quantities: [
943
+ # {
944
+ # attestation_volume: "AttestationQuantityAttestationVolumeString", # required
945
+ # attestation_unit: "AttestationQuantityAttestationUnitString", # required
946
+ # },
947
+ # ],
948
+ # },
949
+ # investment_distributions: [
950
+ # {
951
+ # account_id: "AccountId", # required
952
+ # investment_amount: { # required
953
+ # currency_code: "CurrencyCode", # required
954
+ # currency_amount: "CurrencyAmount", # required
955
+ # },
956
+ # },
957
+ # ],
958
+ # },
959
+ # additional_recipients: [
960
+ # {
961
+ # email: "SensitiveEmail", # required
962
+ # },
963
+ # ],
964
+ # client_token: "AttestationClientToken",
965
+ # })
966
+ #
967
+ # @example Response structure
968
+ #
969
+ # resp.attestation_id #=> String
970
+ #
971
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/CreateContractualInvestmentAttestation AWS API Documentation
972
+ #
973
+ # @overload create_contractual_investment_attestation(params = {})
974
+ # @param [Hash] params ({})
975
+ def create_contractual_investment_attestation(params = {}, options = {})
976
+ req = build_request(:create_contractual_investment_attestation, params)
977
+ req.send_request(options)
978
+ end
979
+
653
980
  # Deletes the specified billing view.
654
981
  #
655
982
  # @option params [required, String] :arn
@@ -697,6 +1024,43 @@ module Aws::Billing
697
1024
  req.send_request(options)
698
1025
  end
699
1026
 
1027
+ # Removes the association between a private pricing contract and your
1028
+ # Amazon Web Services account. The account must have been associated
1029
+ # with the contract previously. This operation is idempotent, so
1030
+ # retrying is safe.
1031
+ #
1032
+ # @option params [required, String] :contract_arn
1033
+ # The Amazon Resource Name (ARN) of the contract to disassociate from
1034
+ # your account.
1035
+ #
1036
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1037
+ #
1038
+ #
1039
+ # @example Example: Invoke DisassociateContract
1040
+ #
1041
+ # resp = client.disassociate_contract({
1042
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
1043
+ # })
1044
+ #
1045
+ # resp.to_h outputs the following:
1046
+ # {
1047
+ # }
1048
+ #
1049
+ # @example Request syntax with placeholder values
1050
+ #
1051
+ # resp = client.disassociate_contract({
1052
+ # contract_arn: "ArnString", # required
1053
+ # })
1054
+ #
1055
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/DisassociateContract AWS API Documentation
1056
+ #
1057
+ # @overload disassociate_contract(params = {})
1058
+ # @param [Hash] params ({})
1059
+ def disassociate_contract(params = {}, options = {})
1060
+ req = build_request(:disassociate_contract, params)
1061
+ req.send_request(options)
1062
+ end
1063
+
700
1064
  # Removes the association between one or more source billing views and
701
1065
  # an existing billing view. This allows modifying the composition of
702
1066
  # aggregate billing views.
@@ -891,6 +1255,79 @@ module Aws::Billing
891
1255
  req.send_request(options)
892
1256
  end
893
1257
 
1258
+ # Returns information about a specific private pricing contract,
1259
+ # including its term (duration), eligible payer accounts, investment
1260
+ # accounts, and legal entities. This operation is read-only.
1261
+ #
1262
+ # @option params [required, String] :contract_arn
1263
+ # The Amazon Resource Name (ARN) of the contract to retrieve information
1264
+ # about.
1265
+ #
1266
+ # @return [Types::GetContractInformationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1267
+ #
1268
+ # * {Types::GetContractInformationResponse#contract #contract} => Types::ContractDetails
1269
+ #
1270
+ #
1271
+ # @example Example: Invoke GetContractInformation
1272
+ #
1273
+ # resp = client.get_contract_information({
1274
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
1275
+ # })
1276
+ #
1277
+ # resp.to_h outputs the following:
1278
+ # {
1279
+ # contract: {
1280
+ # private_pricing_addendum: {
1281
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
1282
+ # contract_term: {
1283
+ # end_date_inclusive: Time.parse(1222222222),
1284
+ # start_date_inclusive: Time.parse(1111111111),
1285
+ # },
1286
+ # eligible_payer_accounts: [
1287
+ # "123456789012",
1288
+ # "210987654321",
1289
+ # ],
1290
+ # investment_accounts: [
1291
+ # "123456789012",
1292
+ # ],
1293
+ # legal_entities: [
1294
+ # {
1295
+ # legal_entity_name: "Example Legal Entity Name",
1296
+ # },
1297
+ # ],
1298
+ # },
1299
+ # },
1300
+ # }
1301
+ #
1302
+ # @example Request syntax with placeholder values
1303
+ #
1304
+ # resp = client.get_contract_information({
1305
+ # contract_arn: "ArnString", # required
1306
+ # })
1307
+ #
1308
+ # @example Response structure
1309
+ #
1310
+ # resp.contract.private_pricing_addendum.contract_arn #=> String
1311
+ # resp.contract.private_pricing_addendum.contract_term.start_date_inclusive #=> Time
1312
+ # resp.contract.private_pricing_addendum.contract_term.end_date_inclusive #=> Time
1313
+ # resp.contract.private_pricing_addendum.eligible_payer_accounts #=> Array
1314
+ # resp.contract.private_pricing_addendum.eligible_payer_accounts[0] #=> String
1315
+ # resp.contract.private_pricing_addendum.investment_accounts #=> Array
1316
+ # resp.contract.private_pricing_addendum.investment_accounts[0] #=> String
1317
+ # resp.contract.private_pricing_addendum.legal_entities #=> Array
1318
+ # resp.contract.private_pricing_addendum.legal_entities[0].legal_entity_name #=> String
1319
+ # resp.contract.private_pricing_addendum.contract_restrictions #=> Array
1320
+ # resp.contract.private_pricing_addendum.contract_restrictions[0] #=> String, one of "ATTESTATION_SELF_SERVICE_BLOCKED"
1321
+ #
1322
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/GetContractInformation AWS API Documentation
1323
+ #
1324
+ # @overload get_contract_information(params = {})
1325
+ # @param [Hash] params ({})
1326
+ def get_contract_information(params = {}, options = {})
1327
+ req = build_request(:get_contract_information, params)
1328
+ req.send_request(options)
1329
+ end
1330
+
894
1331
  # Returns the per-billing-month allocation history for credits applied
895
1332
  # to an Amazon Web Services account's bills. Traverses the consolidated
896
1333
  # billing family to capture cross-account credit applications. Supports
@@ -1608,6 +2045,361 @@ module Aws::Billing
1608
2045
  req.send_request(options)
1609
2046
  end
1610
2047
 
2048
+ # Lists the private pricing contracts that your Amazon Web Services
2049
+ # account is an eligible payer account of. This operation is read-only
2050
+ # and paginated.
2051
+ #
2052
+ # @option params [String] :next_token
2053
+ # The pagination token that indicates the next set of results to
2054
+ # retrieve.
2055
+ #
2056
+ # @option params [Integer] :max_results
2057
+ # The maximum number of contracts to return in a single call. Minimum
2058
+ # value of 1, maximum value of 100.
2059
+ #
2060
+ # @return [Types::ListContractsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2061
+ #
2062
+ # * {Types::ListContractsResponse#items #items} => Array&lt;Types::ContractSummary&gt;
2063
+ # * {Types::ListContractsResponse#next_token #next_token} => String
2064
+ #
2065
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2066
+ #
2067
+ #
2068
+ # @example Example: Invoke ListContracts
2069
+ #
2070
+ # resp = client.list_contracts({
2071
+ # max_results: 100,
2072
+ # })
2073
+ #
2074
+ # resp.to_h outputs the following:
2075
+ # {
2076
+ # items: [
2077
+ # {
2078
+ # association_status: "ASSOCIATED",
2079
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
2080
+ # contract_term: {
2081
+ # end_date_inclusive: Time.parse(1222222222),
2082
+ # start_date_inclusive: Time.parse(1111111111),
2083
+ # },
2084
+ # contract_type: "Cross-Service",
2085
+ # },
2086
+ # ],
2087
+ # }
2088
+ #
2089
+ # @example Request syntax with placeholder values
2090
+ #
2091
+ # resp = client.list_contracts({
2092
+ # next_token: "PageToken",
2093
+ # max_results: 1,
2094
+ # })
2095
+ #
2096
+ # @example Response structure
2097
+ #
2098
+ # resp.items #=> Array
2099
+ # resp.items[0].contract_arn #=> String
2100
+ # resp.items[0].contract_term.start_date_inclusive #=> Time
2101
+ # resp.items[0].contract_term.end_date_inclusive #=> Time
2102
+ # resp.items[0].contract_type #=> String, one of "Cross-Service", "Service-Specific", "Other"
2103
+ # resp.items[0].association_status #=> String, one of "ASSOCIATED", "NOT_ASSOCIATED"
2104
+ # resp.items[0].last_updated_at #=> Time
2105
+ # resp.next_token #=> String
2106
+ #
2107
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContracts AWS API Documentation
2108
+ #
2109
+ # @overload list_contracts(params = {})
2110
+ # @param [Hash] params ({})
2111
+ def list_contracts(params = {}, options = {})
2112
+ req = build_request(:list_contracts, params)
2113
+ req.send_request(options)
2114
+ end
2115
+
2116
+ # Lists the investment attestations submitted under a specific private
2117
+ # pricing contract. Use this operation to track attestation status,
2118
+ # including the terminal statuses `DISBURSED`, `REJECTED`, and
2119
+ # `CANCELLED`. This operation is read-only and paginated.
2120
+ #
2121
+ # @option params [required, String] :contract_arn
2122
+ # The Amazon Resource Name (ARN) of the contract whose attestations you
2123
+ # want to list.
2124
+ #
2125
+ # @option params [String] :investment_summary_id
2126
+ # The identifier of a specific investment summary to filter the
2127
+ # attestations by. If omitted, attestations for all investment summaries
2128
+ # in the contract are returned.
2129
+ #
2130
+ # @option params [String] :next_token
2131
+ # The pagination token that indicates the next set of results to
2132
+ # retrieve.
2133
+ #
2134
+ # @option params [Integer] :max_results
2135
+ # The maximum number of attestations to return in a single call. Minimum
2136
+ # value of 1, maximum value of 100.
2137
+ #
2138
+ # @return [Types::ListContractualInvestmentAttestationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2139
+ #
2140
+ # * {Types::ListContractualInvestmentAttestationsResponse#items #items} => Array&lt;Types::InvestmentAttestation&gt;
2141
+ # * {Types::ListContractualInvestmentAttestationsResponse#next_token #next_token} => String
2142
+ #
2143
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2144
+ #
2145
+ #
2146
+ # @example Example: Invoke ListContractualInvestmentAttestations
2147
+ #
2148
+ # resp = client.list_contractual_investment_attestations({
2149
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
2150
+ # max_results: 25,
2151
+ # })
2152
+ #
2153
+ # resp.to_h outputs the following:
2154
+ # {
2155
+ # items: [
2156
+ # {
2157
+ # attestation_id: "a1b2c3d4-5678-90ab-cdef-111122223333",
2158
+ # attestation_status: "PENDING_CANCELLATION",
2159
+ # attested_at: Time.parse(1333333333),
2160
+ # attested_value: {
2161
+ # currency_amount: "1.00",
2162
+ # currency_code: "USD",
2163
+ # },
2164
+ # investment_id: "Investment-Id",
2165
+ # investment_name: "Example Investment Name",
2166
+ # investment_summary_id: "Example-Investment-Summary-Id",
2167
+ # outcome_description: "Example outcome description",
2168
+ # updated_at: Time.parse(1444444444),
2169
+ # },
2170
+ # {
2171
+ # attestation_id: "b2c3d4e5-6789-01bc-def0-222233334444",
2172
+ # attestation_status: "CANCELLED",
2173
+ # attested_at: Time.parse(1555555555),
2174
+ # attested_value: {
2175
+ # currency_amount: "1.00",
2176
+ # currency_code: "USD",
2177
+ # },
2178
+ # investment_id: "Investment-Id",
2179
+ # investment_name: "Example Investment Name",
2180
+ # investment_summary_id: "Example-Investment-Summary-Id",
2181
+ # outcome_description: "Example outcome description",
2182
+ # updated_at: Time.parse(1666666666),
2183
+ # },
2184
+ # ],
2185
+ # }
2186
+ #
2187
+ # @example Request syntax with placeholder values
2188
+ #
2189
+ # resp = client.list_contractual_investment_attestations({
2190
+ # contract_arn: "ArnString", # required
2191
+ # investment_summary_id: "IdentifierString",
2192
+ # next_token: "PageToken",
2193
+ # max_results: 1,
2194
+ # })
2195
+ #
2196
+ # @example Response structure
2197
+ #
2198
+ # resp.items #=> Array
2199
+ # resp.items[0].attestation_id #=> String
2200
+ # resp.items[0].investment_name #=> String
2201
+ # resp.items[0].outcome_description #=> String
2202
+ # resp.items[0].investment_summary_id #=> String
2203
+ # resp.items[0].investment_id #=> String
2204
+ # resp.items[0].attested_at #=> Time
2205
+ # resp.items[0].updated_at #=> Time
2206
+ # resp.items[0].attestation_status #=> String, one of "PENDING_REVIEW", "PENDING_C_LEVEL_APPROVAL", "PENDING_CANCELLATION", "REJECTED", "CANCELLED", "DISBURSED"
2207
+ # resp.items[0].investment_disbursed_at #=> Time
2208
+ # resp.items[0].attested_value.currency_code #=> String
2209
+ # resp.items[0].attested_value.currency_amount #=> String
2210
+ # resp.items[0].investment_distributions #=> Array
2211
+ # resp.items[0].investment_distributions[0].account_id #=> String
2212
+ # resp.items[0].investment_distributions[0].investment_amount.currency_code #=> String
2213
+ # resp.items[0].investment_distributions[0].investment_amount.currency_amount #=> String
2214
+ # resp.items[0].rejection_reasons #=> Array
2215
+ # resp.items[0].rejection_reasons[0] #=> String
2216
+ # resp.items[0].is_cancellable #=> Boolean
2217
+ # resp.next_token #=> String
2218
+ #
2219
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractualInvestmentAttestations AWS API Documentation
2220
+ #
2221
+ # @overload list_contractual_investment_attestations(params = {})
2222
+ # @param [Hash] params ({})
2223
+ def list_contractual_investment_attestations(params = {}, options = {})
2224
+ req = build_request(:list_contractual_investment_attestations, params)
2225
+ req.send_request(options)
2226
+ end
2227
+
2228
+ # Lists the investment summaries within a specific private pricing
2229
+ # contract. This operation is read-only and paginated.
2230
+ #
2231
+ # @option params [required, String] :contract_arn
2232
+ # The Amazon Resource Name (ARN) of the contract whose investment
2233
+ # summaries you want to list.
2234
+ #
2235
+ # @option params [String] :next_token
2236
+ # The pagination token that indicates the next set of results to
2237
+ # retrieve.
2238
+ #
2239
+ # @option params [Integer] :max_results
2240
+ # The maximum number of investment summaries to return in a single call.
2241
+ # Minimum value of 1, maximum value of 100.
2242
+ #
2243
+ # @return [Types::ListContractualInvestmentSummariesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2244
+ #
2245
+ # * {Types::ListContractualInvestmentSummariesResponse#items #items} => Array&lt;Types::InvestmentSummary&gt;
2246
+ # * {Types::ListContractualInvestmentSummariesResponse#next_token #next_token} => String
2247
+ #
2248
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2249
+ #
2250
+ #
2251
+ # @example Example: Invoke ListContractualInvestmentSummaries
2252
+ #
2253
+ # resp = client.list_contractual_investment_summaries({
2254
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
2255
+ # max_results: 100,
2256
+ # })
2257
+ #
2258
+ # resp.to_h outputs the following:
2259
+ # {
2260
+ # items: [
2261
+ # {
2262
+ # investment_name: "Example Investment Name",
2263
+ # investment_summary_id: "Example-Investment-Summary-Id",
2264
+ # investment_type: "OUTCOME_BASED",
2265
+ # max_allowed_investment_disbursement_value: {
2266
+ # currency_amount: "100000000.00",
2267
+ # currency_code: "USD",
2268
+ # },
2269
+ # },
2270
+ # ],
2271
+ # }
2272
+ #
2273
+ # @example Request syntax with placeholder values
2274
+ #
2275
+ # resp = client.list_contractual_investment_summaries({
2276
+ # contract_arn: "ArnString", # required
2277
+ # next_token: "PageToken",
2278
+ # max_results: 1,
2279
+ # })
2280
+ #
2281
+ # @example Response structure
2282
+ #
2283
+ # resp.items #=> Array
2284
+ # resp.items[0].investment_summary_id #=> String
2285
+ # resp.items[0].investment_name #=> String
2286
+ # resp.items[0].investment_type #=> String, one of "MILESTONE_BASED", "OUTCOME_BASED"
2287
+ # resp.items[0].max_allowed_investment_disbursement_value.currency_code #=> String
2288
+ # resp.items[0].max_allowed_investment_disbursement_value.currency_amount #=> String
2289
+ # resp.next_token #=> String
2290
+ #
2291
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractualInvestmentSummaries AWS API Documentation
2292
+ #
2293
+ # @overload list_contractual_investment_summaries(params = {})
2294
+ # @param [Hash] params ({})
2295
+ def list_contractual_investment_summaries(params = {}, options = {})
2296
+ req = build_request(:list_contractual_investment_summaries, params)
2297
+ req.send_request(options)
2298
+ end
2299
+
2300
+ # Lists the investments within a specific investment summary. This
2301
+ # operation is read-only and paginated.
2302
+ #
2303
+ # @option params [required, String] :contract_arn
2304
+ # The Amazon Resource Name (ARN) of the contract that contains the
2305
+ # investment summary.
2306
+ #
2307
+ # @option params [required, String] :investment_summary_id
2308
+ # The identifier of the investment summary whose investments you want to
2309
+ # list.
2310
+ #
2311
+ # @option params [String] :next_token
2312
+ # The pagination token that indicates the next set of results to
2313
+ # retrieve.
2314
+ #
2315
+ # @option params [Integer] :max_results
2316
+ # The maximum number of investments to return in a single call. Minimum
2317
+ # value of 1, maximum value of 100.
2318
+ #
2319
+ # @return [Types::ListContractualInvestmentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2320
+ #
2321
+ # * {Types::ListContractualInvestmentsResponse#items #items} => Array&lt;Types::Investment&gt;
2322
+ # * {Types::ListContractualInvestmentsResponse#next_token #next_token} => String
2323
+ #
2324
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2325
+ #
2326
+ #
2327
+ # @example Example: Invoke ListContractualInvestments
2328
+ #
2329
+ # resp = client.list_contractual_investments({
2330
+ # contract_arn: "arn:aws:billing::123456789012:contract/1a2b3c4d-5e6f-7a8b-9c0d-111122223333",
2331
+ # investment_summary_id: "Example-Investment-Summary-Id",
2332
+ # max_results: 100,
2333
+ # })
2334
+ #
2335
+ # resp.to_h outputs the following:
2336
+ # {
2337
+ # items: [
2338
+ # {
2339
+ # outcome_based_investment: {
2340
+ # attestation_window: {
2341
+ # end_date_inclusive: Time.parse(1222222222),
2342
+ # start_date_inclusive: Time.parse(1111111111),
2343
+ # },
2344
+ # disbursed_value: {
2345
+ # currency_amount: "0.00",
2346
+ # currency_code: "USD",
2347
+ # },
2348
+ # investment_id: "Investment-Id",
2349
+ # investment_restrictions: [
2350
+ # {
2351
+ # amount: {
2352
+ # currency_amount: "50000.00",
2353
+ # currency_code: "USD",
2354
+ # },
2355
+ # },
2356
+ # ],
2357
+ # outcome_description: "Example outcome description",
2358
+ # },
2359
+ # },
2360
+ # ],
2361
+ # }
2362
+ #
2363
+ # @example Request syntax with placeholder values
2364
+ #
2365
+ # resp = client.list_contractual_investments({
2366
+ # contract_arn: "ArnString", # required
2367
+ # investment_summary_id: "IdentifierString", # required
2368
+ # next_token: "PageToken",
2369
+ # max_results: 1,
2370
+ # })
2371
+ #
2372
+ # @example Response structure
2373
+ #
2374
+ # resp.items #=> Array
2375
+ # resp.items[0].milestone_based_investment.investment_id #=> String
2376
+ # resp.items[0].milestone_based_investment.investment_value.currency_code #=> String
2377
+ # resp.items[0].milestone_based_investment.investment_value.currency_amount #=> String
2378
+ # resp.items[0].milestone_based_investment.investment_disbursed_at #=> Time
2379
+ # resp.items[0].outcome_based_investment.investment_id #=> String
2380
+ # resp.items[0].outcome_based_investment.outcome_description #=> String
2381
+ # resp.items[0].outcome_based_investment.attestation_window.start_date_inclusive #=> Time
2382
+ # resp.items[0].outcome_based_investment.attestation_window.end_date_inclusive #=> Time
2383
+ # resp.items[0].outcome_based_investment.investment_restrictions #=> Array
2384
+ # resp.items[0].outcome_based_investment.investment_restrictions[0].amount.currency_code #=> String
2385
+ # resp.items[0].outcome_based_investment.investment_restrictions[0].amount.currency_amount #=> String
2386
+ # resp.items[0].outcome_based_investment.investment_multipliers #=> Array
2387
+ # resp.items[0].outcome_based_investment.investment_multipliers[0].value #=> String
2388
+ # resp.items[0].outcome_based_investment.investment_multipliers[0].investment_attestation_input_unit #=> String
2389
+ # resp.items[0].outcome_based_investment.investment_multipliers[0].multiplier_type #=> String, one of "PERCENTAGE", "CURRENCY_AMOUNT"
2390
+ # resp.items[0].outcome_based_investment.disbursed_value.currency_code #=> String
2391
+ # resp.items[0].outcome_based_investment.disbursed_value.currency_amount #=> String
2392
+ # resp.next_token #=> String
2393
+ #
2394
+ # @see http://docs.aws.amazon.com/goto/WebAPI/billing-2023-09-07/ListContractualInvestments AWS API Documentation
2395
+ #
2396
+ # @overload list_contractual_investments(params = {})
2397
+ # @param [Hash] params ({})
2398
+ def list_contractual_investments(params = {}, options = {})
2399
+ req = build_request(:list_contractual_investments, params)
2400
+ req.send_request(options)
2401
+ end
2402
+
1611
2403
  # Returns Support-eligible spend broken down at linked account level.
1612
2404
  #
1613
2405
  # @option params [required, String] :billing_month
@@ -2047,7 +2839,7 @@ module Aws::Billing
2047
2839
  tracer: tracer
2048
2840
  )
2049
2841
  context[:gem_name] = 'aws-sdk-billing'
2050
- context[:gem_version] = '1.38.0'
2842
+ context[:gem_version] = '1.40.0'
2051
2843
  Seahorse::Client::Request.new(handlers, context)
2052
2844
  end
2053
2845