AWS Device Farm
Developer Guide (API Version 2015-06-23)

Purchase a Device Slot in AWS Device Farm

You can use the Device Farm console, the AWS CLI, or Device Farm API to purchase a device slot.

Purchase Device Slots (Console)

  1. Sign in to the Device Farm console at https://console.aws.amazon.com/devicefarm.

  2. Scroll down to the UNLIMITED ACCESS section and choose the Learn more about unlimited testing link.

    
                Packages page in the Device Farm console
  3. On the Packages page, you can choose one of the preconfigured packages (SINGLE PLATFORM, CROSS PLATFORM, or CONTINUOUS INTEGRATION or create your own custom package by choosing the number of slots of each type you want to purchase.

    Note

    If you choose one of the preconfigured packages, you must select Automated testing, Remote access, or both.

    The text is dynamically updated with the amount that will be added to your bill. For more information, see Device Farm Pricing.

  4. Choose Buy now and then choose Complete purchase.

    If you see Contact us or Contact us to purchase, your account is not yet approved to purchase the number of device slots you have requested. On the Send us feedback for the Device Farm Console dialog box, enter the number of slots of each type you' want to purchase, and then choose Contact Support.


            Account settings page in the Device Farm console

On the Account settings page, you'll see the You have xxx FREE TRIAL MINUTES remaining message only if you have free trial minutes remaining. The number of minutes remaining is an estimate. It doesn't reflect usage by tests that are currently running.

You'll also see the number of device slots that you have currently. If you have increased or decreased the number of slots, you'll see the number of slots that you will have one month after the date you made the change.

Purchase a Device Slot (AWS CLI)

You can run the purchase-offering command to purchase the offering.

To list your Device Farm account settings, including the maximum number of device slots you can purchaseand the number of remaining free trial minutes, run the get-account-settingscommand. You will see output similar to the following:

{ "accountSettings": { "maxSlots": { "GUID": 1, "GUID": 1, "GUID": 1, "GUID": 1 }, "unmeteredRemoteAccessDevices": { "ANDROID": 0, "IOS": 0 }, "maxJobTimeoutMinutes": 60, "trialMinutes": { "total": 1000.0, "remaining": 954.1 }, "defaultJobTimeoutMinutes": 60, "awsAccountNumber": "AWS-ACCOUNT-NUMBER", "unmeteredDevices": { "ANDROID": 0, "IOS": 0 } } }

To list the device slot offerings available to you, run the list-offerings command. You should see output similar to the following:

{ "offerings": [ { "recurringCharges": [ { "cost": { "amount": 250.0, "currencyCode": "USD" }, "frequency": "MONTHLY" } ], "platform": "IOS", "type": "RECURRING", "id": "GUID", "description": "iOS Unmetered Device Slot" }, { "recurringCharges": [ { "cost": { "amount": 250.0, "currencyCode": "USD" }, "frequency": "MONTHLY" } ], "platform": "ANDROID", "type": "RECURRING", "id": "GUID", "description": "Android Unmetered Device Slot" }, { "recurringCharges": [ { "cost": { "amount": 250.0, "currencyCode": "USD" }, "frequency": "MONTHLY" } ], "platform": "ANDROID", "type": "RECURRING", "id": "GUID", "description": "Android Remote Access Unmetered Device Slot" }, { "recurringCharges": [ { "cost": { "amount": 250.0, "currencyCode": "USD" }, "frequency": "MONTHLY" } ], "platform": "IOS", "type": "RECURRING", "id": "GUID", "description": "iOS Remote Access Unmetered Device Slot" } ] }

To list offering promotions that are available, run the list-offering-promotions command.

Note

This command only returns promotions that you have not yet purchased. As soon as you purchase one or more slots across any offering using a promotion, that promotion no longer appears in the results.

You should see output similar to the following:

{ "offeringPromotions": [ { "id": "2FREEMONTHS", "description": "New device slot customers get 3 months for the price of 1." } ] }

To get the offering status, run the get-offering-status command. You should see output similar to the following:

{ "current": { "GUID": { "offering": { "platform": "IOS", "type": "RECURRING", "id": "GUID", "description": "iOS Unmetered Device Slot" }, "quantity": 1 }, "GUID": { "offering": { "platform": "ANDROID", "type": "RECURRING", "id": "GUID", "description": "Android Unmetered Device Slot" }, "quantity": 1 } }, "nextPeriod": { "GUID": { "effectiveOn": 1459468800.0, "offering": { "platform": "IOS", "type": "RECURRING", "id": "GUID", "description": "iOS Unmetered Device Slot" }, "quantity": 1 }, "GUID": { "effectiveOn": 1459468800.0, "offering": { "platform": "ANDROID", "type": "RECURRING", "id": "GUID", "description": "Android Unmetered Device Slot" }, "quantity": 1 } } }

The renew-offering and list-offering-transactions are also available for this feature. For more information, see the AWS CLI reference for Device Farm and AWS CLI Reference.

Purchase a Device Slot (API)

  1. Call the GetAccountSettings operation to list your account settings.

  2. Call the ListOfferings operation to list the device slot offerings available to you.

  3. Call the ListOfferingPromotions operation to list the offering promotions that are available.

    Note

    This command returns only promotions that you have not yet purchased. As soon as you purchase one or more slots using an offering promotion, that promotion no longer appears in the results.

  4. Call the PurchaseOffering operation to purchase an offering.

  5. Call the GetOfferingStatus operation to get the offering status.

The RenewOffering and ListOfferingTransactions commands are also available for this feature.

For information about using the Device Farm API, see API Reference.