ListOfferingTransactions
Returns a list of all historical purchases, renewals, and system renewal transactions for an AWS
account. The list is paginated and ordered by a descending timestamp (most recent transactions are first).
The API returns a NotEligible error if the user is not permitted to invoke the operation. If
you must be able to invoke this operation, contact aws-devicefarm-support@amazon.com
Request Syntax
{
"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.
- nextToken
-
An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.
Type: String
Length Constraints: Minimum length of 4. Maximum length of 1024.
Required: No
Response Syntax
{
"nextToken": "string",
"offeringTransactions": [
{
"cost": {
"amount": number,
"currencyCode": "string"
},
"createdOn": number,
"offeringPromotionId": "string",
"offeringStatus": {
"effectiveOn": number,
"offering": {
"description": "string",
"id": "string",
"platform": "string",
"recurringCharges": [
{
"cost": {
"amount": number,
"currencyCode": "string"
},
"frequency": "string"
}
],
"type": "string"
},
"quantity": number,
"type": "string"
},
"transactionId": "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.
- nextToken
-
An identifier that was returned from the previous call to this operation, which can be used to return the next set of items in the list.
Type: String
Length Constraints: Minimum length of 4. Maximum length of 1024.
- offeringTransactions
-
The audit log of subscriptions you have purchased and modified through AWS Device Farm.
Type: Array of OfferingTransaction objects
Errors
For information about the errors that are common to all actions, see Common Errors.
- ArgumentException
-
An invalid argument was specified.
HTTP Status Code: 400
- LimitExceededException
-
A limit was exceeded.
HTTP Status Code: 400
- NotEligibleException
-
Exception gets thrown when a user is not eligible to perform the specified transaction.
HTTP Status Code: 400
- NotFoundException
-
The specified entity was not found.
HTTP Status Code: 400
- ServiceAccountException
-
There was a problem with the service account.
HTTP Status Code: 400
Examples
Example
The following example response contains all the transactions that the customer has made.
Sample Response
{
"offeringTransactions": [
{
"createdOn": 1458596241.001,
"offeringStatus": {
"effectiveOn": 1458596240.974,
"type": "PURCHASE",
"offering": {
"platform": "IOS",
"type": "RECURRING",
"id": "offering-id-ios",
"description": "iOS Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 80.65,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458587590.308,
"offeringStatus": {
"effectiveOn": 1458587590.24,
"type": "PURCHASE",
"offering": {
"platform": "IOS",
"type": "RECURRING",
"id": "offering-id-ios",
"description": "iOS Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 80.65,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458541943.395,
"offeringStatus": {
"effectiveOn": 1458541943.34,
"type": "PURCHASE",
"offering": {
"platform": "ANDROID",
"type": "RECURRING",
"id": "offering-id-android",
"description": "Android Unmetered Device Slot"
},
"quantity": 10
},
"cost": {
"amount": 806.45,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458584276.849,
"offeringStatus": {
"effectiveOn": 1458584276.811,
"type": "PURCHASE",
"offering": {
"platform": "ANDROID",
"type": "RECURRING",
"id": "offering-id-android",
"description": "Android Unmetered Device Slot"
},
"quantity": 2
},
"cost": {
"amount": 161.29,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458592981.171,
"offeringStatus": {
"effectiveOn": 1458592981.137,
"type": "PURCHASE",
"offering": {
"platform": "IOS",
"type": "RECURRING",
"id": "offering-id-ios",
"description": "iOS Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 80.65,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458591927.511,
"offeringStatus": {
"effectiveOn": 1458591927.468,
"type": "PURCHASE",
"offering": {
"platform": "IOS",
"type": "RECURRING",
"id": "offering-id-ios",
"description": "iOS Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 80.65,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458581880.117,
"offeringStatus": {
"effectiveOn": 1459468800.0,
"type": "RENEW",
"offering": {
"platform": "IOS",
"type": "RECURRING",
"id": "offering-id-ios",
"description": "iOS Unmetered Device Slot"
},
"quantity": 0
},
"cost": {
"amount": 0.0,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458587390.031,
"offeringStatus": {
"effectiveOn": 1458587390.008,
"type": "PURCHASE",
"offering": {
"platform": "ANDROID",
"type": "RECURRING",
"id": "offering-id-android",
"description": "Android Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 80.65,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458591927.99,
"offeringStatus": {
"effectiveOn": 1459468800.0,
"type": "RENEW",
"offering": {
"platform": "ANDROID",
"type": "RECURRING",
"id": "offering-id-android",
"description": "Android Unmetered Device Slot"
},
"quantity": 3
},
"cost": {
"amount": 750.0,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458581580.426,
"offeringStatus": {
"effectiveOn": 1458581580.377,
"type": "PURCHASE",
"offering": {
"platform": "ANDROID",
"type": "RECURRING",
"id": "offering-id-android",
"description": "Android Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 80.65,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458582235.794,
"offeringStatus": {
"effectiveOn": 1459468800.0,
"type": "RENEW",
"offering": {
"platform": "ANDROID",
"type": "RECURRING",
"id": "offering-id-android",
"description": "Android Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 250.0,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458581580.429,
"offeringStatus": {
"effectiveOn": 1458581580.372,
"type": "PURCHASE",
"offering": {
"platform": "IOS",
"type": "RECURRING",
"id": "offering-id-ios",
"description": "iOS Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 80.65,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458593014.881,
"offeringStatus": {
"effectiveOn": 1458593014.856,
"type": "PURCHASE",
"offering": {
"platform": "IOS",
"type": "RECURRING",
"id": "offering-id-ios",
"description": "iOS Unmetered Device Slot"
},
"quantity": 2
},
"cost": {
"amount": 161.29,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458581880.415,
"offeringStatus": {
"effectiveOn": 1459468800.0,
"type": "RENEW",
"offering": {
"platform": "ANDROID",
"type": "RECURRING",
"id": "offering-id-android",
"description": "Android Unmetered Device Slot"
},
"quantity": 0
},
"cost": {
"amount": 0.0,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458591927.662,
"offeringStatus": {
"effectiveOn": 1458591927.491,
"type": "PURCHASE",
"offering": {
"platform": "ANDROID",
"type": "RECURRING",
"id": "offering-id-android",
"description": "Android Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 80.65,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458582235.834,
"offeringStatus": {
"effectiveOn": 1459468800.0,
"type": "RENEW",
"offering": {
"platform": "IOS",
"type": "RECURRING",
"id": "offering-id-ios",
"description": "iOS Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 250.0,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458583642.184,
"offeringStatus": {
"effectiveOn": 1459468800.0,
"type": "RENEW",
"offering": {
"platform": "IOS",
"type": "RECURRING",
"id": "offering-id-ios",
"description": "iOS Unmetered Device Slot"
},
"quantity": 0
},
"cost": {
"amount": 0.0,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
},
{
"createdOn": 1458581880.007,
"offeringStatus": {
"effectiveOn": 1458581879.937,
"type": "PURCHASE",
"offering": {
"platform": "ANDROID",
"type": "RECURRING",
"id": "offering-id-android",
"description": "Android Unmetered Device Slot"
},
"quantity": 1
},
"cost": {
"amount": 80.65,
"currencyCode": "USD"
},
"transactionId": "transaction-id"
}
]
}See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
