Billing / Client / list_contracts

list_contracts

Billing.Client.list_contracts(**kwargs)

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

response = client.list_contracts(
    nextToken='string',
    maxResults=123
)
Parameters:

  • nextToken (string) – The pagination token that indicates the next set of results to retrieve.

  • maxResults (integer) – The maximum number of contracts to return in a single call. Minimum value of 1, maximum value of 100.

Return type:

dict

Returns:

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.

Exceptions