ListContracts
Lists the private pricing contracts that your Amazon account is an eligible payer account of. This operation is read-only and paginated.
Request Syntax
{
"maxResults": number,
"nextToken": "string"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- maxResults
-
The maximum number of contracts to return in a single call. Minimum value of 1, maximum value of 100.
Type: Integer
Valid Range: Minimum value of 1. Maximum value of 100.
Required: No
- nextToken
-
The pagination token that indicates the next set of results to retrieve.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 4095.
Pattern:
[-a-zA-Z0-9+=/_]+Required: No
Response Syntax
{
"items": [
{
"associationStatus": "string",
"contractArn": "string",
"contractTerm": {
"endDateInclusive": number,
"startDateInclusive": number
},
"contractType": "string",
"lastUpdatedAt": number
}
],
"nextToken": "string"
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- items
-
The list of contracts that your Amazon account is an eligible payer account of.
Type: Array of ContractSummary objects
- nextToken
-
The pagination token to use on subsequent calls to retrieve the next set of results.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 4095.
Pattern:
[-a-zA-Z0-9+=/_]+
Errors
For information about the errors that are common to all actions, see Common Error Types.
- AccessDeniedException
-
You don't have sufficient access to perform this action.
HTTP Status Code: 400
- InternalServerException
-
The request processing failed because of an unknown error, exception, or failure.
HTTP Status Code: 500
- ThrottlingException
-
The request was denied due to request throttling.
HTTP Status Code: 400
- ValidationException
-
The input fails to satisfy the constraints specified by an Amazon Web Services service.
- fieldList
-
The input fails to satisfy the constraints specified by an Amazon service.
- reason
-
The input fails to satisfy the constraints specified by an Amazon service.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: