v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1477335300.0 KB

Immediately purchases offerings for an AWS account. Offerings renew with the latest total purchased quantity for an offering, unless the renewal was overridden. The API returns a <code>NotEligible</code> error if the user is not permitted to invoke the operation. If you must be able to invoke this operation, contact <a href="mailto:aws-devicefarm-support@amazon.com">aws-devicefarm-support@amazon.com</a>.

post/#X-Amz-Target=DeviceFarm_20150623.PurchaseOffering

Headers

X-Amz-Target'DeviceFarm_20150623.PurchaseOffering' required

Request body

offeringIdstring required

The ID of the offering.

quantityinteger required

The number of device slots to purchase in an offering request.

offeringPromotionIdstring

The ID of the offering promotion to be applied to the purchase.

Response

Success

Example response

{
  "offeringTransaction": {
    "cost": {
      "amount": 8.07,
      "currencyCode": "USD"
    },
    "createdOn": "1472648340",
    "offeringStatus": {
      "type": "PURCHASE",
      "effectiveOn": "1472648340",
      "offering": {
        "type": "RECURRING",
        "description": "Android Remote Access Unmetered Device Slot",
        "id": "D68B3C05-1BA6-4360-BC69-12345EXAMPLE",
        "platform": "ANDROID"
      },
      "quantity": 1
    },
    "transactionId": "d30614ed-1b03-404c-9893-12345EXAMPLE"
  }
}