2026/10/26 - AWS Billing - 9 new api methods
Changes Adds support for managing private pricing contracts and contractual investments including listing and associating contracts, retrieving contractual investments and their summaries, and creating, listing, and canceling contractual investment attestations
Returns information about a specific private pricing contract, including its term (duration), eligible payer accounts, investment accounts, and legal entities. This operation is read-only.
See also: AWS API Documentation
Request Syntax
client.get_contract_information(
contractArn='string'
)
string
[REQUIRED]
The Amazon Resource Name (ARN) of the contract to retrieve information about.
dict
Response Syntax
{
'contract': {
'privatePricingAddendum': {
'contractArn': 'string',
'contractTerm': {
'startDateInclusive': datetime(2015, 1, 1),
'endDateInclusive': datetime(2015, 1, 1)
},
'eligiblePayerAccounts': [
'string',
],
'investmentAccounts': [
'string',
],
'legalEntities': [
{
'legalEntityName': 'string'
},
],
'contractRestrictions': [
'ATTESTATION_SELF_SERVICE_BLOCKED',
]
}
}
}
Response Structure
(dict) --
contract (dict) --
The contract details such as term (duration), eligible payer accounts, investment accounts, and legal entities.
privatePricingAddendum (dict) --
The details of a private pricing addendum contract. This member is set when the contract is a private pricing addendum.
contractArn (string) --
The Amazon Resource Name (ARN) of the private pricing addendum.
contractTerm (dict) --
The contract term period of the private pricing addendum, expressed as an interval with an inclusive start date and an inclusive end date.
startDateInclusive (datetime) --
The start date of the interval. This date is included in the interval.
endDateInclusive (datetime) --
The end date of the interval. This date is included in the interval.
eligiblePayerAccounts (list) --
The payer accounts that are eligible under the private pricing addendum. The list contains at most 100 account IDs.
(string) --
investmentAccounts (list) --
The accounts that are eligible to receive investments under the private pricing addendum. An InvestmentDistribution must target one of these accounts. The list contains at most 100 account IDs.
(string) --
legalEntities (list) --
The legal entities on the private pricing addendum. The list contains at most 10 legal entities.
(dict) --
A legal entity on a private pricing contract. It can be found on your contract's signature page.
legalEntityName (string) --
The name of the legal entity as it appears on the contract document. This value can be up to 256 characters.
contractRestrictions (list) --
The restrictions that limit the self-service actions you can take on the private pricing addendum. An empty or absent value indicates that no restrictions apply. The list contains at most 10 restrictions.
(string) --
A restriction that limits the self-service actions you can take on a contract. A contract with no restrictions supports all self-service actions.
Lists the investments within a specific investment summary. This operation is read-only and paginated.
See also: AWS API Documentation
Request Syntax
client.list_contractual_investments(
contractArn='string',
investmentSummaryId='string',
nextToken='string',
maxResults=123
)
string
[REQUIRED]
The Amazon Resource Name (ARN) of the contract that contains the investment summary.
string
[REQUIRED]
The identifier of the investment summary whose investments you want to list.
string
The pagination token that indicates the next set of results to retrieve.
integer
The maximum number of investments to return in a single call. Minimum value of 1, maximum value of 100.
dict
Response Syntax
{
'items': [
{
'milestoneBasedInvestment': {
'investmentId': 'string',
'investmentValue': {
'currencyCode': 'string',
'currencyAmount': 'string'
},
'investmentDisbursedAt': datetime(2015, 1, 1)
},
'outcomeBasedInvestment': {
'investmentId': 'string',
'outcomeDescription': 'string',
'attestationWindow': {
'startDateInclusive': datetime(2015, 1, 1),
'endDateInclusive': datetime(2015, 1, 1)
},
'investmentRestrictions': [
{
'amount': {
'currencyCode': 'string',
'currencyAmount': 'string'
}
},
],
'investmentMultipliers': [
{
'value': 'string',
'investmentAttestationInputUnit': 'string',
'multiplierType': 'PERCENTAGE'|'CURRENCY_AMOUNT'
},
],
'disbursedValue': {
'currencyCode': 'string',
'currencyAmount': 'string'
}
}
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
items (list) --
The list of investments for the investment summary.
(dict) --
An investment within an investment summary. This is a union in which exactly one member is set. The milestoneBasedInvestment member represents a fixed, scheduled investment. The outcomeBasedInvestment member represents an attestable investment awarded upon completion of a defined outcome. Check which member is present to determine the investment type.
milestoneBasedInvestment (dict) --
An investment with a fixed value that is disbursed on a schedule. This member is set for a milestone-based investment and corresponds to the MILESTONE_BASED investment type.
investmentId (string) --
The identifier of the investment, as returned by ListContractualInvestments. This value is 1–36 characters.
investmentValue (dict) --
The total value of the investment, including its currency and amount.
currencyCode (string) --
The ISO 4217 currency code for the amount (for example, USD).
currencyAmount (string) --
The amount as a decimal string (for example, "743.21"). Negative values represent credits that reduce a bill.
investmentDisbursedAt (datetime) --
The date on which the investment is disbursed to the investment accounts.
outcomeBasedInvestment (dict) --
An investment that is awarded upon completion of a defined outcome. This member is set for an outcome-based (attestable) investment and corresponds to the OUTCOME_BASED investment type.
investmentId (string) --
The identifier of the investment, as returned by ListContractualInvestments. This value is 1–36 characters.
outcomeDescription (string) --
The description of what must be completed to attest the outcome. This value is 1–2048 characters.
attestationWindow (dict) --
The time window, expressed as an interval with inclusive start and end dates, during which outcomes can be attested to.
startDateInclusive (datetime) --
The start date of the interval. This date is included in the interval.
endDateInclusive (datetime) --
The end date of the interval. This date is included in the interval.
investmentRestrictions (list) --
The restrictions that cap the value that can be disbursed for the investment. The list contains at most 10 restrictions.
(dict) --
A restriction that caps the value that can be disbursed for an investment. The cap applies for each attestation window.
amount (dict) --
The maximum monetary amount allowed under the restriction.
currencyCode (string) --
The ISO 4217 currency code for the amount (for example, USD).
currencyAmount (string) --
The amount as a decimal string (for example, "743.21"). Negative values represent credits that reduce a bill.
investmentMultipliers (list) --
The multipliers used to compute the investment value from the attestation input. The list contains at most 200 multipliers. Multipliers are derived from the terms of the private pricing contract.
(dict) --
A multiplier used to convert attestation input into an investment value.
value (string) --
The multiplier value, expressed as a decimal string to preserve precision. The value is digits with an optional decimal point and is 1–1000 characters. The terms of the contract define this value.
investmentAttestationInputUnit (string) --
The unit of the attestation input that the multiplier applies to, such as workloads migrated. This value is 1–1000 characters. The terms of the contract define this value.
multiplierType (string) --
The type of the multiplier. A value of PERCENTAGE applies a percentage of a value. A value of CURRENCY_AMOUNT applies a currency amount per unit of attestation input. The terms of the contract define this value.
disbursedValue (dict) --
The total value already disbursed against the investment. This value can be distributed among the investment accounts distribution.
currencyCode (string) --
The ISO 4217 currency code for the amount (for example, USD).
currencyAmount (string) --
The amount as a decimal string (for example, "743.21"). Negative values represent credits that reduce a bill.
nextToken (string) --
The pagination token to use on subsequent calls to retrieve the next set of results.
Cancels a contractual investment attestation. This operation is idempotent, so retrying is safe. You can cancel an attestation only while it is still pending (its isCancellable value is true).
See also: AWS API Documentation
Request Syntax
client.cancel_contractual_investment_attestation(
attestationId='string',
contractArn='string',
reason='string'
)
string
[REQUIRED]
The identifier of the investment attestation to cancel.
string
[REQUIRED]
The Amazon Resource Name (ARN) of the contract that contains the attested investment.
string
[REQUIRED]
The reason for the cancellation. This value can be 1 to 80 characters.
dict
Response Syntax
{}
Response Structure
(dict) --
Creates an attestation that claims an investment award for a completed milestone or outcome within a private pricing contract. Supply a clientToken to make the request idempotent so a safe retry does not create a duplicate attestation. This operation starts an asynchronous review and returns an attestationId while the attestation is pending.
See also: AWS API Documentation
Request Syntax
client.create_contractual_investment_attestation(
contractArn='string',
investmentSummaryId='string',
investmentId='string',
contractDocumentId='string',
approverDetails={
'name': 'string',
'title': 'string',
'email': 'string'
},
investmentDisbursedAt=datetime(2015, 1, 1),
attestationDetails={
'attestationValue': {
'attestationAmount': {
'currencyCode': 'string',
'currencyAmount': 'string'
},
'attestationQuantities': [
{
'attestationVolume': 'string',
'attestationUnit': 'string'
},
]
},
'investmentDistributions': [
{
'accountId': 'string',
'investmentAmount': {
'currencyCode': 'string',
'currencyAmount': 'string'
}
},
]
},
additionalRecipients=[
{
'email': 'string'
},
],
clientToken='string'
)
string
[REQUIRED]
The Amazon Resource Name (ARN) of the contract that contains the investment being attested.
string
[REQUIRED]
The identifier of the investment summary being attested. This is the parent to the investmentId.
string
[REQUIRED]
The identifier of the investment (outcome) being attested.
string
[REQUIRED]
The contract ID from the contract document, located in the top-right corner of the private pricing contract pages. This value confirms that you have access to the contract.
dict
[REQUIRED]
The details of the executive who authorized the attestation, under the terms of the private pricing contract. The executive receives a click-to-accept email to confirm the attestation.
name (string) -- [REQUIRED]
The name of the approver as it appears on the contract. This value can be up to 256 characters.
title (string) -- [REQUIRED]
The title of the approver, such as Chief Financial Officer. This value can be up to 256 characters.
email (string) -- [REQUIRED]
The email address of the approver. This value is 3–256 characters and must be a valid email address.
datetime
The date on which the investment is disbursed to the investment accounts. The disbursement date is subject to review timelines.
dict
[REQUIRED]
The details of the attestation, including the value being claimed and how the resulting investment is distributed across investment accounts.
attestationValue (dict) -- [REQUIRED]
The value being attested, expressed as either a monetary amount or one or more quantities. Exactly one form is set.
attestationAmount (dict) --
The value attested as a monetary amount. This form is valid only when the investment has no multiplier.
currencyCode (string) -- [REQUIRED]
The ISO 4217 currency code for the amount (for example, USD).
currencyAmount (string) -- [REQUIRED]
The amount as a decimal string (for example, "743.21"). Negative values represent credits that reduce a bill.
attestationQuantities (list) --
The value attested as one or more quantities, each with its own unit. The list contains at most 50 quantities.
(dict) --
A quantity-based attestation value, such as a count of workloads migrated.
attestationVolume (string) -- [REQUIRED]
The number of units being attested, expressed as a decimal string to preserve precision. The value is digits with an optional decimal point and is 1–1000 characters.
attestationUnit (string) -- [REQUIRED]
The unit of the attestation, such as workloads migrated. This value is 1–1000 characters.
investmentDistributions (list) --
The distribution of the resulting investment across the eligible investment accounts on the contract. If you omit this value, the full investment is allocated to the single eligible investment account on the contract. This value is required when multiple investment accounts are eligible. When you provide this value, the sum of all distributions must equal the resulting monetary investment value (the attested amount, or the value computed from the attested quantities using the investment multipliers). The list contains at most 200 distributions.
(dict) --
An allocation of an investment disbursement to a specific recipient account. The account is the target account that receives the investment, not your account.
accountId (string) -- [REQUIRED]
The recipient Amazon Web Services account ID that receives this portion of the investment. This must be one of the eligible investment accounts on the contract.
investmentAmount (dict) -- [REQUIRED]
The monetary value allocated to the recipient account.
currencyCode (string) -- [REQUIRED]
The ISO 4217 currency code for the amount (for example, USD).
currencyAmount (string) -- [REQUIRED]
The amount as a decimal string (for example, "743.21"). Negative values represent credits that reduce a bill.
list
The email addresses to copy as viewers on the executive approval request.
(dict) --
A recipient copied as a viewer on the executive approval request, in addition to the approver.
email (string) -- [REQUIRED]
The email address of the recipient. This value is 3–256 characters and must be a valid email address.
string
A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you retry a request that completed successfully using the same client token and parameters, the retry completes without performing any further actions.
This field is autopopulated if not provided.
dict
Response Syntax
{
'attestationId': 'string'
}
Response Structure
(dict) --
attestationId (string) --
The identifier of the submitted attestation.
Private Pricing contracts let eligible payer accounts manage private pricing agreements with Amazon Web Services. This operation associates a private pricing contract with the caller's Amazon Web Services account. The caller must be a payer (management) account listed on the contract. This operation is idempotent, so retrying a request that already succeeded is safe.
See also: AWS API Documentation
Request Syntax
client.associate_contract(
contractArn='string',
contractDocumentId='string'
)
string
[REQUIRED]
The Amazon Resource Name (ARN) of the contract to associate with your account.
string
[REQUIRED]
The contract ID from the contract document. It can be found in the top right corner of your contract's pages. This value confirms that you have access to the contract you are associating.
dict
Response Syntax
{}
Response Structure
(dict) --
Lists the private pricing contracts that your Amazon Web Services account is an eligible payer account of. This operation is read-only and paginated.
See also: AWS API Documentation
Request Syntax
client.list_contracts(
nextToken='string',
maxResults=123
)
string
The pagination token that indicates the next set of results to retrieve.
integer
The maximum number of contracts to return in a single call. Minimum value of 1, maximum value of 100.
dict
Response Syntax
{
'items': [
{
'contractArn': 'string',
'contractTerm': {
'startDateInclusive': datetime(2015, 1, 1),
'endDateInclusive': datetime(2015, 1, 1)
},
'contractType': 'Cross-Service'|'Service-Specific'|'Other',
'associationStatus': 'ASSOCIATED'|'NOT_ASSOCIATED',
'lastUpdatedAt': datetime(2015, 1, 1)
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
items (list) --
The list of contracts that your Amazon Web Services account is an eligible payer account of.
(dict) --
A summary of a private pricing contract visible to your account. ListContracts returns these summaries.
contractArn (string) --
The Amazon Resource Name (ARN) of the contract. Pass this value to operations such as GetContractInformation, ListContractualInvestmentSummaries, and AssociateContract.
contractTerm (dict) --
The contract term period of the contract, expressed as an interval with an inclusive start date and an inclusive end date.
startDateInclusive (datetime) --
The start date of the interval. This date is included in the interval.
endDateInclusive (datetime) --
The end date of the interval. This date is included in the interval.
contractType (string) --
The classification of the contract. Valid values are Cross-Service, Service-Specific, and Other. Cross-Service applies across multiple Amazon Web Services services. Service-Specific applies to a specific Amazon Web Services service. Other applies to other arrangements.
associationStatus (string) --
Indicates whether the contract is currently associated with your account. Valid values are ASSOCIATED and NOT_ASSOCIATED. ASSOCIATED means the contract is associated with your account. NOT_ASSOCIATED means the contract is not associated with your account.
lastUpdatedAt (datetime) --
The time when the contract was last associated with your account.
nextToken (string) --
The pagination token to use on subsequent calls to retrieve the next set of results.
Lists the investment summaries within a specific private pricing contract. This operation is read-only and paginated.
See also: AWS API Documentation
Request Syntax
client.list_contractual_investment_summaries(
contractArn='string',
nextToken='string',
maxResults=123
)
string
[REQUIRED]
The Amazon Resource Name (ARN) of the contract whose investment summaries you want to list.
string
The pagination token that indicates the next set of results to retrieve.
integer
The maximum number of investment summaries to return in a single call. Minimum value of 1, maximum value of 100.
dict
Response Syntax
{
'items': [
{
'investmentSummaryId': 'string',
'investmentName': 'string',
'investmentType': 'MILESTONE_BASED'|'OUTCOME_BASED',
'maxAllowedInvestmentDisbursementValue': {
'currencyCode': 'string',
'currencyAmount': 'string'
}
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
items (list) --
The list of investment summaries under the contract. It includes the investment name, maximum investment amount, and investment type. It does not provide investment details. Use this to know if the contract has investment terms and what type.
(dict) --
Detailed information about an investment summary within a contract or a private pricing addendum.
investmentSummaryId (string) --
The identifier of the investment summary. Pass this value to ListContractualInvestments to list the investments within the summary, and to CreateContractualInvestmentAttestation to attest an investment. This value is 1–36 characters.
investmentName (string) --
The name of the investment summary, used to reference the investment against a term in the physical contract. This value is 1–400 characters.
investmentType (string) --
The type of the investment summary. Valid values are MILESTONE_BASED and OUTCOME_BASED. OUTCOME_BASED investments can be attested to, upon completion of outcomes. MILESTONE_BASED are automatically triggered by Amazon Web Services, based on the time schedule in the contract.
maxAllowedInvestmentDisbursementValue (dict) --
The maximum monetary value that can be disbursed against the investment summary, inclusive of all outcomes combined under the summary.
currencyCode (string) --
The ISO 4217 currency code for the amount (for example, USD).
currencyAmount (string) --
The amount as a decimal string (for example, "743.21"). Negative values represent credits that reduce a bill.
nextToken (string) --
The pagination token to use on subsequent calls to retrieve the next set of results.
Lists the investment attestations submitted under a specific private pricing contract. Use this operation to track attestation status, including the terminal statuses DISBURSED, REJECTED, and CANCELLED. This operation is read-only and paginated.
See also: AWS API Documentation
Request Syntax
client.list_contractual_investment_attestations(
contractArn='string',
investmentSummaryId='string',
nextToken='string',
maxResults=123
)
string
[REQUIRED]
The Amazon Resource Name (ARN) of the contract whose attestations you want to list.
string
The identifier of a specific investment summary to filter the attestations by. If omitted, attestations for all investment summaries in the contract are returned.
string
The pagination token that indicates the next set of results to retrieve.
integer
The maximum number of attestations to return in a single call. Minimum value of 1, maximum value of 100.
dict
Response Syntax
{
'items': [
{
'attestationId': 'string',
'investmentName': 'string',
'outcomeDescription': 'string',
'investmentSummaryId': 'string',
'investmentId': 'string',
'attestedAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'attestationStatus': 'PENDING_REVIEW'|'PENDING_C_LEVEL_APPROVAL'|'PENDING_CANCELLATION'|'REJECTED'|'CANCELLED'|'DISBURSED',
'investmentDisbursedAt': datetime(2015, 1, 1),
'attestedValue': {
'currencyCode': 'string',
'currencyAmount': 'string'
},
'investmentDistributions': [
{
'accountId': 'string',
'investmentAmount': {
'currencyCode': 'string',
'currencyAmount': 'string'
}
},
],
'rejectionReasons': [
'string',
],
'isCancellable': True|False
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
items (list) --
The list of investment attestations submitted under the contract.
(dict) --
A summary of a submitted investment attestation, as returned by ListContractualInvestmentAttestations.
attestationId (string) --
The identifier of the attestation. This value is returned by CreateContractualInvestmentAttestation and is used to cancel the attestation with CancelContractualInvestmentAttestation. This value is 1–36 characters.
investmentName (string) --
The name of the investment summary that contains the attested outcome. This value is 1–400 characters.
outcomeDescription (string) --
The description of the attested outcome. This value is 1–2048 characters.
investmentSummaryId (string) --
The identifier of the investment summary that was attested, as returned by ListContractualInvestmentSummaries.
investmentId (string) --
The identifier of the investment that was attested, as returned by ListContractualInvestments.
attestedAt (datetime) --
The date on which the attestation was submitted.
updatedAt (datetime) --
The date on which the attestation was last updated.
attestationStatus (string) --
The current status of the attestation. Valid values are PENDING_REVIEW, PENDING_C_LEVEL_APPROVAL, PENDING_CANCELLATION, REJECTED, CANCELLED, and DISBURSED. The values DISBURSED, REJECTED, and CANCELLED are terminal. The other values indicate the attestation is still in progress.
investmentDisbursedAt (datetime) --
The start date on which the investment is disbursed to the investment accounts. This is not the same as the time of disbursement, but reflects the date you submitted with the attestation.
attestedValue (dict) --
The monetary value attested.
currencyCode (string) --
The ISO 4217 currency code for the amount (for example, USD).
currencyAmount (string) --
The amount as a decimal string (for example, "743.21"). Negative values represent credits that reduce a bill.
investmentDistributions (list) --
The distribution of the attested investment across the eligible investment accounts. The list contains at most 200 distributions.
(dict) --
An allocation of an investment disbursement to a specific recipient account. The account is the target account that receives the investment, not your account.
accountId (string) --
The recipient Amazon Web Services account ID that receives this portion of the investment. This must be one of the eligible investment accounts on the contract.
investmentAmount (dict) --
The monetary value allocated to the recipient account.
currencyCode (string) --
The ISO 4217 currency code for the amount (for example, USD).
currencyAmount (string) --
The amount as a decimal string (for example, "743.21"). Negative values represent credits that reduce a bill.
rejectionReasons (list) --
The reasons the attestation was rejected. This value is present only when attestationStatus is REJECTED. The list contains at most 30 reasons.
(string) --
A single reason an attestation was rejected. This value is 1–300 characters.
isCancellable (boolean) --
Indicates whether the attestation can be canceled with CancelContractualInvestmentAttestation.
nextToken (string) --
The pagination token to use on subsequent calls to retrieve the next set of results.
Removes the association between a private pricing contract and your Amazon Web Services account. The account must have been associated with the contract previously. This operation is idempotent, so retrying is safe.
See also: AWS API Documentation
Request Syntax
client.disassociate_contract(
contractArn='string'
)
string
[REQUIRED]
The Amazon Resource Name (ARN) of the contract to disassociate from your account.
dict
Response Syntax
{}
Response Structure
(dict) --