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

Purchase a Device Slot in AWS Device Farm

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

Purchase Device Slots with the Device Farm 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 to get to the packages page.

    
                Packages page in the Device Farm console

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

    Note

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

    The text dynamically updates with the amount that will be added to your bill for each device slot purchased. For more information, see Device Farm Pricing.

  4. Choose Buy now for the package you wish to purchase.

    If you choose Buy now, you'll see a Complete your purchase dialog. Choose Complete purchase to complete your purchase.

    Instead of Buy now, you may see Contact us or Contact us to purchase. This indicates that your account is not yet approved to purchase the number of device slots you have requested.

    If you choose Contact us or Contact us to purchase, you'll see a Send us feedback for the Device Farm Console dialog. Tell us how many slots of each type you'd like to purchase and choose Contact Support.

Once you have successfully purchased device slots, you'll see the Account settings page.


            Account settings page in the Device Farm console

In 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 that 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 also see the number of slots that you will have one month after the date you made the change.

Purchase a Device Slot with the 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 purchase before you need to contact us and the number of remaining free trial minutes that you have, run the get-account-settings command. You will see output similar to the following:

Copy
{ "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 will see output similar to the following:

Copy
{ "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 returns only promotions that you have not yet purchased. As soon as you purchase one or more slots across any offering using a promotion, that promotion will no longer appear in the results.

You will see output similar to the following:

Copy
{ "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 will see output similar to the following:

Copy
{ "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 } } }

Additional commands for this feature include renew-offering and list-offering-transactions. For more information about specific operations, see the AWS CLI reference for Device Farm.

For information about using Device Farm with the AWS CLI, see AWS CLI Reference.

Purchase a Device Slot with the Device Farm 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 will no longer appear in the results.

  4. Call the PurchaseOffering operation to purchase an offering.

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

Additional commands for this feature include RenewOffering and ListOfferingTransactions.

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