aws device farm · pdf fileaws device farm is a service that enables mobile app developers to...

276
AWS Device Farm API Reference API Version 2015-06-23

Upload: nguyendang

Post on 07-Feb-2018

228 views

Category:

Documents


5 download

TRANSCRIPT

Page 1: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device FarmAPI Reference

API Version 2015-06-23

Page 2: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

AWS Device Farm: API ReferenceCopyright © 2018 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any mannerthat is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks notowned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored byAmazon.

Page 3: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

Table of ContentsWelcome .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Actions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

CreateDevicePool ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

CreateInstanceProfile .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

CreateNetworkProfile .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

CreateProject ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

CreateRemoteAccessSession .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

CreateUpload .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

CreateVPCEConfiguration .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

DeleteDevicePool ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

API Version 2015-06-23iii

Page 4: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

DeleteInstanceProfile .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

DeleteNetworkProfile .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

DeleteProject ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

DeleteRemoteAccessSession .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

DeleteRun .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

DeleteUpload .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

DeleteVPCEConfiguration .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

GetAccountSettings .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

GetDevice .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

API Version 2015-06-23iv

Page 5: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

GetDeviceInstance .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

GetDevicePool ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

GetDevicePoolCompatibility ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

GetInstanceProfile .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

GetJob .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

GetNetworkProfile .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

GetOfferingStatus .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Example .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

GetProject ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

API Version 2015-06-23v

Page 6: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

GetRemoteAccessSession .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

GetRun .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

GetSuite .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

GetTest ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

GetUpload .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

GetVPCEConfiguration .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

InstallToRemoteAccessSession .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

ListArtifacts ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88

ListDeviceInstances .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89

API Version 2015-06-23vi

Page 7: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

ListDevicePools ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

ListDevices .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

ListInstanceProfiles .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

ListJobs .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

ListNetworkProfiles .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

ListOfferingPromotions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

ListOfferings .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Example .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

ListOfferingTransactions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113

API Version 2015-06-23vii

Page 8: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114Example .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120

ListProjects ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122

ListRemoteAccessSessions .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

ListRuns .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

ListSamples .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133

ListSuites .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

ListTests ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

ListUniqueProblems .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

ListUploads .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

API Version 2015-06-23viii

Page 9: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

ListVPCEConfigurations .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

PurchaseOffering .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Example .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

RenewOffering .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Example .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

ScheduleRun .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

StopRemoteAccessSession .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

StopRun .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

UpdateDeviceInstance .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

API Version 2015-06-23ix

Page 10: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

UpdateDevicePool ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

UpdateInstanceProfile .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176

UpdateNetworkProfile .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

UpdateProject ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

UpdateVPCEConfiguration .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183Request Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183Request Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183Response Syntax .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Response Elements .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185

Data Types .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186AccountSettings .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188

Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Artifact ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Counters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

CPU ..... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

CreateRemoteAccessSessionConfiguration .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195

CustomerArtifactPaths .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

Device .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

API Version 2015-06-23x

Page 11: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

DeviceInstance .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

DeviceMinutes .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

DevicePool ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

DevicePoolCompatibilityResult ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205

ExecutionConfiguration .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

IncompatibilityMessage .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

InstanceProfile .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209

Job .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Location .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

MonetaryAmount .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

NetworkProfile .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216

Offering .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

OfferingPromotion .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

OfferingStatus .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

OfferingTransaction .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

Problem ..... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

ProblemDetail .. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Project ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Radios .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226

API Version 2015-06-23xi

Page 12: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

RecurringCharge .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227

RemoteAccessSession .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231

Resolution .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232

Rule .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233

Run .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

Sample .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242

ScheduleRunConfiguration .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

ScheduleRunTest ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

Suite .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

Test ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

TrialMinutes .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

UniqueProblem ..... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

Upload .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

VPCEConfiguration .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259Contents .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259See Also .... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259

Common Parameters ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261Common Errors ... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

API Version 2015-06-23xii

Page 13: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

WelcomeAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS appson physical phones, tablets, and other devices in the cloud.

This document was last published on April 30, 2018.

API Version 2015-06-231

Page 14: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

ActionsThe following actions are supported:

• CreateDevicePool (p. 4)• CreateInstanceProfile (p. 7)• CreateNetworkProfile (p. 10)• CreateProject (p. 14)• CreateRemoteAccessSession (p. 16)• CreateUpload (p. 21)• CreateVPCEConfiguration (p. 24)• DeleteDevicePool (p. 27)• DeleteInstanceProfile (p. 29)• DeleteNetworkProfile (p. 31)• DeleteProject (p. 33)• DeleteRemoteAccessSession (p. 35)• DeleteRun (p. 37)• DeleteUpload (p. 39)• DeleteVPCEConfiguration (p. 41)• GetAccountSettings (p. 43)• GetDevice (p. 45)• GetDeviceInstance (p. 48)• GetDevicePool (p. 50)• GetDevicePoolCompatibility (p. 52)• GetInstanceProfile (p. 57)• GetJob (p. 59)• GetNetworkProfile (p. 62)• GetOfferingStatus (p. 64)• GetProject (p. 68)• GetRemoteAccessSession (p. 70)• GetRun (p. 73)• GetSuite (p. 76)• GetTest (p. 78)• GetUpload (p. 80)• GetVPCEConfiguration (p. 82)• InstallToRemoteAccessSession (p. 84)• ListArtifacts (p. 86)• ListDeviceInstances (p. 89)• ListDevicePools (p. 92)• ListDevices (p. 95)• ListInstanceProfiles (p. 98)• ListJobs (p. 101)• ListNetworkProfiles (p. 105)• ListOfferingPromotions (p. 108)

API Version 2015-06-232

Page 15: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

• ListOfferings (p. 110)• ListOfferingTransactions (p. 113)• ListProjects (p. 121)• ListRemoteAccessSessions (p. 124)• ListRuns (p. 128)• ListSamples (p. 132)• ListSuites (p. 135)• ListTests (p. 138)• ListUniqueProblems (p. 141)• ListUploads (p. 145)• ListVPCEConfigurations (p. 148)• PurchaseOffering (p. 150)• RenewOffering (p. 154)• ScheduleRun (p. 157)• StopRemoteAccessSession (p. 162)• StopRun (p. 165)• UpdateDeviceInstance (p. 168)• UpdateDevicePool (p. 171)• UpdateInstanceProfile (p. 174)• UpdateNetworkProfile (p. 177)• UpdateProject (p. 181)• UpdateVPCEConfiguration (p. 183)

API Version 2015-06-233

Page 16: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCreateDevicePool

CreateDevicePoolCreates a device pool.

Request Syntax{ "description": "string", "name": "string", "projectArn": "string", "rules": [ { "attribute": "string", "operator": "string", "value": "string" } ]}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

description (p. 4)

The device pool's description.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Noname (p. 4)

The device pool's name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: YesprojectArn (p. 4)

The ARN of the project for the device pool.

Type: String

Length Constraints: Minimum length of 32.

Required: Yesrules (p. 4)

The device pool's rules.

Type: Array of Rule (p. 233) objects

API Version 2015-06-234

Page 17: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

Required: Yes

Response Syntax{ "devicePool": { "arn": "string", "description": "string", "name": "string", "rules": [ { "attribute": "string", "operator": "string", "value": "string" } ], "type": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

devicePool (p. 5)

The newly created device pool.

Type: DevicePool (p. 203) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

API Version 2015-06-235

Page 19: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCreateInstanceProfile

CreateInstanceProfileCreates a profile that can be applied to one or more private fleet device instances.

Request Syntax{ "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

description (p. 7)

The description of your instance profile.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: NoexcludeAppPackagesFromCleanup (p. 7)

An array of strings specifying the list of app packages that should not be cleaned up from the deviceafter a test run is over.

The list of packages is only considered if you set packageCleanup to true.

Type: Array of strings

Required: Noname (p. 7)

The name of your instance profile.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: YespackageCleanup (p. 7)

When set to true, Device Farm will remove app packages after a test run. The default value isfalse for private devices.

Type: Boolean

Required: No

API Version 2015-06-237

Page 20: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

rebootAfterUse (p. 7)

When set to true, Device Farm will reboot the instance after a test run. The default value is true.

Type: Boolean

Required: No

Response Syntax{ "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

instanceProfile (p. 8)

An object containing information about your instance profile.

Type: InstanceProfile (p. 208) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-238

Page 22: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCreateNetworkProfile

CreateNetworkProfileCreates a network profile.

Request Syntax{ "description": "string", "downlinkBandwidthBits": number, "downlinkDelayMs": number, "downlinkJitterMs": number, "downlinkLossPercent": number, "name": "string", "projectArn": "string", "type": "string", "uplinkBandwidthBits": number, "uplinkDelayMs": number, "uplinkJitterMs": number, "uplinkLossPercent": number}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

description (p. 10)

The description of the network profile.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: NodownlinkBandwidthBits (p. 10)

The data throughput rate in bits per second, as an integer from 0 to 104857600.

Type: Long

Required: NodownlinkDelayMs (p. 10)

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

Type: Long

Required: NodownlinkJitterMs (p. 10)

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

Type: Long

Required: No

API Version 2015-06-2310

Page 23: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceRequest Parameters

downlinkLossPercent (p. 10)

Proportion of received packets that fail to arrive from 0 to 100 percent.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 100.

Required: Noname (p. 10)

The name you wish to specify for the new network profile.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: YesprojectArn (p. 10)

The Amazon Resource Name (ARN) of the project for which you want to create a network profile.

Type: String

Length Constraints: Minimum length of 32.

Required: Yestype (p. 10)

The type of network profile you wish to create. Valid values are listed below.

Type: String

Valid Values: CURATED | PRIVATE

Required: NouplinkBandwidthBits (p. 10)

The data throughput rate in bits per second, as an integer from 0 to 104857600.

Type: Long

Required: NouplinkDelayMs (p. 10)

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

Type: Long

Required: NouplinkJitterMs (p. 10)

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

Type: Long

Required: NouplinkLossPercent (p. 10)

Proportion of transmitted packets that fail to arrive from 0 to 100 percent.

API Version 2015-06-2311

Page 24: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 100.

Required: No

Response Syntax{ "networkProfile": { "arn": "string", "description": "string", "downlinkBandwidthBits": number, "downlinkDelayMs": number, "downlinkJitterMs": number, "downlinkLossPercent": number, "name": "string", "type": "string", "uplinkBandwidthBits": number, "uplinkDelayMs": number, "uplinkJitterMs": number, "uplinkLossPercent": number }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

networkProfile (p. 12)

The network profile that is returned by the create network profile request.

Type: NetworkProfile (p. 215) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400

API Version 2015-06-2312

Page 26: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCreateProject

CreateProjectCreates a new project.

Request Syntax

{ "defaultJobTimeoutMinutes": number, "name": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

defaultJobTimeoutMinutes (p. 14)

Sets the execution timeout value (in minutes) for a project. All test runs in this project will use thespecified execution timeout value unless overridden when scheduling a run.

Type: Integer

Required: No

name (p. 14)

The project's name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Yes

Response Syntax

{ "project": { "arn": "string", "created": number, "defaultJobTimeoutMinutes": number, "name": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

API Version 2015-06-2314

Page 27: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

project (p. 14)

The newly created project.

Type: Project (p. 225) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2315

Page 28: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCreateRemoteAccessSession

CreateRemoteAccessSessionSpecifies and starts a remote access session.

Request Syntax{ "clientId": "string", "configuration": { "billingMethod": "string" }, "deviceArn": "string", "instanceArn": "string", "interactionMode": "string", "name": "string", "projectArn": "string", "remoteDebugEnabled": boolean, "remoteRecordAppArn": "string", "remoteRecordEnabled": boolean, "skipAppResign": boolean, "sshPublicKey": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

clientId (p. 16)

Unique identifier for the client. If you want access to multiple devices on the same client, you shouldpass the same clientId value in each call to CreateRemoteAccessSession. This is required onlyif remoteDebugEnabled is set to true.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 64.

Required: Noconfiguration (p. 16)

The configuration information for the remote access session request.

Type: CreateRemoteAccessSessionConfiguration (p. 195) object

Required: NodeviceArn (p. 16)

The Amazon Resource Name (ARN) of the device for which you want to create a remote accesssession.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

API Version 2015-06-2316

Page 29: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceRequest Parameters

instanceArn (p. 16)

The Amazon Resource Name (ARN) of the device instance for which you want to create a remoteaccess session.

Type: String

Length Constraints: Minimum length of 32.

Required: NointeractionMode (p. 16)

The interaction mode of the remote access session. Valid values are:• INTERACTIVE: You can interact with the iOS device by viewing, touching, and rotating the screen.

You cannot run XCUITest framework-based tests in this mode.• NO_VIDEO: You are connected to the device but cannot interact with it or view the screen. This

mode has the fastest test execution speed. You can run XCUITest framework-based tests in thismode.

• VIDEO_ONLY: You can view the screen but cannot touch or rotate it. You can run XCUITestframework-based tests and watch the screen in this mode.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 64.

Valid Values: INTERACTIVE | NO_VIDEO | VIDEO_ONLY

Required: Noname (p. 16)

The name of the remote access session that you wish to create.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: NoprojectArn (p. 16)

The Amazon Resource Name (ARN) of the project for which you want to create a remote accesssession.

Type: String

Length Constraints: Minimum length of 32.

Required: YesremoteDebugEnabled (p. 16)

Set to true if you want to access devices remotely for debugging in your remote access session.

Type: Boolean

Required: NoremoteRecordAppArn (p. 16)

The Amazon Resource Name (ARN) for the app to be recorded in the remote access session.

Type: String

Length Constraints: Minimum length of 32.

API Version 2015-06-2317

Page 30: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

Required: NoremoteRecordEnabled (p. 16)

Set to true to enable remote recording for the remote access session.

Type: Boolean

Required: NoskipAppResign (p. 16)

When set to true, for private devices, Device Farm will not sign your app again. For public devices,Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in theAWS Device Farm FAQs.

Type: Boolean

Required: NosshPublicKey (p. 16)

The public key of the ssh key pair you want to use for connecting to remote devices in your remotedebugging session. This is only required if remoteDebugEnabled is set to true.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 8192.

Required: No

Response Syntax{ "remoteAccessSession": { "arn": "string", "billingMethod": "string", "clientId": "string", "created": number, "device": { "arn": "string", "carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" }, "fleetName": "string", "fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string", "instances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean,

API Version 2015-06-2318

Page 31: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } }, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "deviceUdid": "string", "endpoint": "string", "hostAddress": "string", "instanceArn": "string", "interactionMode": "string", "message": "string", "name": "string", "remoteDebugEnabled": boolean, "remoteRecordAppArn": "string", "remoteRecordEnabled": boolean, "result": "string", "skipAppResign": boolean, "started": number, "status": "string", "stopped": number }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

remoteAccessSession (p. 18)

A container that describes the remote access session when the request to create a remote accesssession is sent.

Type: RemoteAccessSession (p. 228) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

API Version 2015-06-2319

Page 32: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2320

Page 33: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCreateUpload

CreateUploadUploads an app or test scripts.

Request Syntax{ "contentType": "string", "name": "string", "projectArn": "string", "type": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

contentType (p. 21)

The upload's content type (for example, "application/octet-stream").

Type: String

Length Constraints: Minimum length of 0. Maximum length of 64.

Required: Noname (p. 21)

The upload's file name. The name should not contain the '/' character. If uploading an iOS app, thefile name needs to end with the .ipa extension. If uploading an Android app, the file name needs toend with the .apk extension. For all others, the file name must end with the .zip file extension.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: YesprojectArn (p. 21)

The ARN of the project for the upload.

Type: String

Length Constraints: Minimum length of 32.

Required: Yestype (p. 21)

The upload's upload type.

Must be one of the following values:• ANDROID_APP: An Android upload.• IOS_APP: An iOS upload.• WEB_APP: A web appliction upload.

API Version 2015-06-2321

Page 34: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

• EXTERNAL_DATA: An external data upload.• APPIUM_JAVA_JUNIT_TEST_PACKAGE: An Appium Java JUnit test package upload.• APPIUM_JAVA_TESTNG_TEST_PACKAGE: An Appium Java TestNG test package upload.• APPIUM_PYTHON_TEST_PACKAGE: An Appium Python test package upload.• APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE: An Appium Java JUnit test package upload.• APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE: An Appium Java TestNG test package upload.• APPIUM_WEB_PYTHON_TEST_PACKAGE: An Appium Python test package upload.• CALABASH_TEST_PACKAGE: A Calabash test package upload.• INSTRUMENTATION_TEST_PACKAGE: An instrumentation upload.• UIAUTOMATION_TEST_PACKAGE: A uiautomation test package upload.• UIAUTOMATOR_TEST_PACKAGE: A uiautomator test package upload.• XCTEST_TEST_PACKAGE: An XCode test package upload.• XCTEST_UI_TEST_PACKAGE: An XCode UI test package upload.

Note If you call CreateUpload with WEB_APP specified, AWS Device Farm throws anArgumentException error.

Type: String

Valid Values: ANDROID_APP | IOS_APP | WEB_APP | EXTERNAL_DATA |APPIUM_JAVA_JUNIT_TEST_PACKAGE | APPIUM_JAVA_TESTNG_TEST_PACKAGE |APPIUM_PYTHON_TEST_PACKAGE | APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE |APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE | APPIUM_WEB_PYTHON_TEST_PACKAGE| CALABASH_TEST_PACKAGE | INSTRUMENTATION_TEST_PACKAGE |UIAUTOMATION_TEST_PACKAGE | UIAUTOMATOR_TEST_PACKAGE | XCTEST_TEST_PACKAGE |XCTEST_UI_TEST_PACKAGE

Required: Yes

Response Syntax{ "upload": { "arn": "string", "contentType": "string", "created": number, "message": "string", "metadata": "string", "name": "string", "status": "string", "type": "string", "url": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

upload (p. 22)

The newly created upload.

API Version 2015-06-2322

Page 35: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

Type: Upload (p. 256) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2323

Page 36: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCreateVPCEConfiguration

CreateVPCEConfigurationCreates a configuration record in Device Farm for your Amazon Virtual Private Cloud (VPC) endpoint.

Request Syntax{ "serviceDnsName": "string", "vpceConfigurationDescription": "string", "vpceConfigurationName": "string", "vpceServiceName": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

serviceDnsName (p. 24)

The DNS name of the service running in your VPC that you want Device Farm to test.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: YesvpceConfigurationDescription (p. 24)

An optional description, providing more details about your VPC endpoint configuration.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: NovpceConfigurationName (p. 24)

The friendly name you give to your VPC endpoint configuration, to manage your configurationsmore easily.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 1024.

Required: YesvpceServiceName (p. 24)

The name of the VPC endpoint service running inside your AWS account that you want Device Farmto test.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

API Version 2015-06-2324

Page 37: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

Required: Yes

Response Syntax{ "vpceConfiguration": { "arn": "string", "serviceDnsName": "string", "vpceConfigurationDescription": "string", "vpceConfigurationName": "string", "vpceServiceName": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

vpceConfiguration (p. 25)

An object containing information about your VPC endpoint configuration.

Type: VPCEConfiguration (p. 259) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++

API Version 2015-06-2325

Page 39: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDeleteDevicePool

DeleteDevicePoolDeletes a device pool given the pool ARN. Does not allow deletion of curated pools owned by the system.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 27)

Represents the Amazon Resource Name (ARN) of the Device Farm device pool you wish to delete.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response ElementsIf the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-2327

Page 41: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDeleteInstanceProfile

DeleteInstanceProfileDeletes a profile that can be applied to one or more private device instances.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 29)

The Amazon Resource Name (ARN) of the instance profile you are requesting to delete.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response ElementsIf the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-2329

Page 43: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDeleteNetworkProfile

DeleteNetworkProfileDeletes a network profile.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 31)

The Amazon Resource Name (ARN) of the network profile you want to delete.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response ElementsIf the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-2331

Page 45: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDeleteProject

DeleteProjectDeletes an AWS Device Farm project, given the project ARN.

Note Deleting this resource does not stop an in-progress run.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 33)

Represents the Amazon Resource Name (ARN) of the Device Farm project you wish to delete.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response ElementsIf the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-2333

Page 47: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDeleteRemoteAccessSession

DeleteRemoteAccessSessionDeletes a completed remote access session and its results.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 35)

The Amazon Resource Name (ARN) of the sesssion for which you want to delete remote access.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response ElementsIf the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-2335

Page 49: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDeleteRun

DeleteRunDeletes the run, given the run ARN.

Note Deleting this resource does not stop an in-progress run.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 37)

The Amazon Resource Name (ARN) for the run you wish to delete.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response ElementsIf the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-2337

Page 51: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDeleteUpload

DeleteUploadDeletes an upload given the upload ARN.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 39)

Represents the Amazon Resource Name (ARN) of the Device Farm upload you wish to delete.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response ElementsIf the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-2339

Page 53: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDeleteVPCEConfiguration

DeleteVPCEConfigurationDeletes a configuration for your Amazon Virtual Private Cloud (VPC) endpoint.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 41)

The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to delete.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response ElementsIf the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400InvalidOperationException

There was an error with the update request, or you do not have sufficient permissions to update thisVPC endpoint configuration.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-2341

Page 55: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetAccountSettings

GetAccountSettingsReturns the number of unmetered iOS and/or unmetered Android devices that have been purchased bythe account.

Response Syntax

{ "accountSettings": { "awsAccountNumber": "string", "defaultJobTimeoutMinutes": number, "maxJobTimeoutMinutes": number, "maxSlots": { "string" : number }, "skipAppResign": boolean, "trialMinutes": { "remaining": number, "total": number }, "unmeteredDevices": { "string" : number }, "unmeteredRemoteAccessDevices": { "string" : number } }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

accountSettings (p. 43)

The account settings.

Type: AccountSettings (p. 188) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400

LimitExceededException

A limit was exceeded.

HTTP Status Code: 400

API Version 2015-06-2343

Page 56: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2344

Page 57: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetDevice

GetDeviceGets information about a unique device type.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 45)

The device type's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "device": { "arn": "string", "carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" }, "fleetName": "string", "fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string", "instances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ],

API Version 2015-06-2345

Page 58: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

device (p. 45)

An object containing information about the requested device.

Type: Device (p. 197) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400

LimitExceededException

A limit was exceeded.

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

API Version 2015-06-2346

Page 60: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetDeviceInstance

GetDeviceInstanceReturns information about a device instance belonging to a private device fleet.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 48)

The Amazon Resource Name (ARN) of the instance you're requesting information about.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "deviceInstance": { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

deviceInstance (p. 48)

An object containing information about your device instance.

API Version 2015-06-2348

Page 61: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

Type: DeviceInstance (p. 200) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2349

Page 62: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetDevicePool

GetDevicePoolGets information about a device pool.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 50)

The device pool's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "devicePool": { "arn": "string", "description": "string", "name": "string", "rules": [ { "attribute": "string", "operator": "string", "value": "string" } ], "type": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

devicePool (p. 50)

An object containing information about the requested device pool.

API Version 2015-06-2350

Page 63: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

Type: DevicePool (p. 203) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2351

Page 64: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetDevicePoolCompatibility

GetDevicePoolCompatibilityGets information about compatibility with a device pool.

Request Syntax{ "appArn": "string", "configuration": { "auxiliaryApps": [ "string" ], "billingMethod": "string", "customerArtifactPaths": { "androidPaths": [ "string" ], "deviceHostPaths": [ "string" ], "iosPaths": [ "string" ] }, "extraDataPackageArn": "string", "locale": "string", "location": { "latitude": number, "longitude": number }, "networkProfileArn": "string", "radios": { "bluetooth": boolean, "gps": boolean, "nfc": boolean, "wifi": boolean }, "vpceConfigurationArns": [ "string" ] }, "devicePoolArn": "string", "test": { "filter": "string", "parameters": { "string" : "string" }, "testPackageArn": "string", "type": "string" }, "testType": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

appArn (p. 52)

The ARN of the app that is associated with the specified device pool.

Type: String

Length Constraints: Minimum length of 32.

Required: No

API Version 2015-06-2352

Page 65: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceRequest Parameters

configuration (p. 52)

An object containing information about the settings for a run.

Type: ScheduleRunConfiguration (p. 243) object

Required: No

devicePoolArn (p. 52)

The device pool's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

test (p. 52)

Information about the uploaded test to be run against the device pool.

Type: ScheduleRunTest (p. 245) object

Required: No

testType (p. 52)

The test type for the specified device pool.

Allowed values include the following:

• BUILTIN_FUZZ: The built-in fuzz type.

• BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interactingwith it and capturing screenshots at the same time.

• APPIUM_JAVA_JUNIT: The Appium Java JUnit type.

• APPIUM_JAVA_TESTNG: The Appium Java TestNG type.

• APPIUM_PYTHON: The Appium Python type.

• APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.

• APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.

• APPIUM_WEB_PYTHON: The Appium Python type for Web apps.

• CALABASH: The Calabash type.

• INSTRUMENTATION: The Instrumentation type.

• UIAUTOMATION: The uiautomation type.

• UIAUTOMATOR: The uiautomator type.

• XCTEST: The XCode test type.

• XCTEST_UI: The XCode UI test type.

Type: String

Valid Values: BUILTIN_FUZZ | BUILTIN_EXPLORER | WEB_PERFORMANCE_PROFILE| APPIUM_JAVA_JUNIT | APPIUM_JAVA_TESTNG | APPIUM_PYTHON |APPIUM_WEB_JAVA_JUNIT | APPIUM_WEB_JAVA_TESTNG | APPIUM_WEB_PYTHON |CALABASH | INSTRUMENTATION | UIAUTOMATION | UIAUTOMATOR | XCTEST | XCTEST_UI| REMOTE_ACCESS_RECORD | REMOTE_ACCESS_REPLAY

Required: No

API Version 2015-06-2353

Page 66: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

Response Syntax

{ "compatibleDevices": [ { "compatible": boolean, "device": { "arn": "string", "carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" }, "fleetName": "string", "fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string", "instances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } }, "incompatibilityMessages": [ { "message": "string", "type": "string" } ] } ], "incompatibleDevices": [ { "compatible": boolean, "device": { "arn": "string",

API Version 2015-06-2354

Page 67: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" }, "fleetName": "string", "fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string", "instances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } }, "incompatibilityMessages": [ { "message": "string", "type": "string" } ] } ]}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

compatibleDevices (p. 54)

Information about compatible devices.

Type: Array of DevicePoolCompatibilityResult (p. 205) objects

API Version 2015-06-2355

Page 68: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

incompatibleDevices (p. 54)

Information about incompatible devices.

Type: Array of DevicePoolCompatibilityResult (p. 205) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2356

Page 69: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetInstanceProfile

GetInstanceProfileReturns information about the specified instance profile.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 57)

The Amazon Resource Name (ARN) of your instance profile.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

instanceProfile (p. 57)

An object containing information about your instance profile.

Type: InstanceProfile (p. 208) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

API Version 2015-06-2357

Page 70: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2358

Page 71: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetJob

GetJobGets information about a job.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 59)

The job's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "job": { "arn": "string", "counters": { "errored": number, "failed": number, "passed": number, "skipped": number, "stopped": number, "total": number, "warned": number }, "created": number, "device": { "arn": "string", "carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" }, "fleetName": "string", "fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string", "instances": [ {

API Version 2015-06-2359

Page 72: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } }, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "instanceArn": "string", "message": "string", "name": "string", "result": "string", "started": number, "status": "string", "stopped": number, "type": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

job (p. 59)

An object containing information about the requested job.

Type: Job (p. 210) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

API Version 2015-06-2360

Page 73: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2361

Page 74: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetNetworkProfile

GetNetworkProfileReturns information about a network profile.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 62)

The Amazon Resource Name (ARN) of the network profile you want to return information about.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "networkProfile": { "arn": "string", "description": "string", "downlinkBandwidthBits": number, "downlinkDelayMs": number, "downlinkJitterMs": number, "downlinkLossPercent": number, "name": "string", "type": "string", "uplinkBandwidthBits": number, "uplinkDelayMs": number, "uplinkJitterMs": number, "uplinkLossPercent": number }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

networkProfile (p. 62)

The network profile.

API Version 2015-06-2362

Page 75: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

Type: NetworkProfile (p. 215) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2363

Page 76: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetOfferingStatus

GetOfferingStatusGets the current status and future status of all offerings purchased by an AWS account. The responseindicates how many offerings are currently available and the offerings that will be available in the nextperiod. The API returns a NotEligible error if the user is not permitted to invoke the operation. Pleasecontact [email protected] if you believe that you should be able to invoke thisoperation.

Request Syntax{ "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

nextToken (p. 64)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

Required: No

Response Syntax{ "current": { "string" : { "effectiveOn": number, "offering": { "description": "string", "id": "string", "platform": "string", "recurringCharges": [ { "cost": { "amount": number, "currencyCode": "string" }, "frequency": "string" } ], "type": "string" }, "quantity": number, "type": "string" }

API Version 2015-06-2364

Page 77: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

}, "nextPeriod": { "string" : { "effectiveOn": number, "offering": { "description": "string", "id": "string", "platform": "string", "recurringCharges": [ { "cost": { "amount": number, "currencyCode": "string" }, "frequency": "string" } ], "type": "string" }, "quantity": number, "type": "string" } }, "nextToken": "string"}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

current (p. 64)

When specified, gets the offering status for the current period.

Type: String to OfferingStatus (p. 220) object map

Key Length Constraints: Minimum length of 32.

nextPeriod (p. 64)

When specified, gets the offering status for the next period.

Type: String to OfferingStatus (p. 220) object map

Key Length Constraints: Minimum length of 32.

nextToken (p. 64)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

API Version 2015-06-2365

Page 78: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceExample

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotEligibleException

Exception gets thrown when a user is not eligible to perform the specified transaction.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

Example

The following example checks the current and renewal status.

Sample Response

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

API Version 2015-06-2366

Page 80: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetProject

GetProjectGets information about a project.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 68)

The project's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "project": { "arn": "string", "created": number, "defaultJobTimeoutMinutes": number, "name": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

project (p. 68)

The project you wish to get information about.

Type: Project (p. 225) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

API Version 2015-06-2368

Page 81: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2369

Page 82: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetRemoteAccessSession

GetRemoteAccessSessionReturns a link to a currently running remote access session.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 70)

The Amazon Resource Name (ARN) of the remote access session about which you want to get sessioninformation.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "remoteAccessSession": { "arn": "string", "billingMethod": "string", "clientId": "string", "created": number, "device": { "arn": "string", "carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" }, "fleetName": "string", "fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string", "instances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string",

API Version 2015-06-2370

Page 83: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } }, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "deviceUdid": "string", "endpoint": "string", "hostAddress": "string", "instanceArn": "string", "interactionMode": "string", "message": "string", "name": "string", "remoteDebugEnabled": boolean, "remoteRecordAppArn": "string", "remoteRecordEnabled": boolean, "result": "string", "skipAppResign": boolean, "started": number, "status": "string", "stopped": number }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

remoteAccessSession (p. 70)

A container that lists detailed information about the remote access session.

Type: RemoteAccessSession (p. 228) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

API Version 2015-06-2371

Page 84: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2372

Page 85: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetRun

GetRunGets information about a run.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 73)

The run's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "run": { "appUpload": "string", "arn": "string", "billingMethod": "string", "completedJobs": number, "counters": { "errored": number, "failed": number, "passed": number, "skipped": number, "stopped": number, "total": number, "warned": number }, "created": number, "customerArtifactPaths": { "androidPaths": [ "string" ], "deviceHostPaths": [ "string" ], "iosPaths": [ "string" ] }, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "devicePoolArn": "string", "eventCount": number, "jobTimeoutMinutes": number,

API Version 2015-06-2373

Page 86: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"locale": "string", "location": { "latitude": number, "longitude": number }, "message": "string", "name": "string", "networkProfile": { "arn": "string", "description": "string", "downlinkBandwidthBits": number, "downlinkDelayMs": number, "downlinkJitterMs": number, "downlinkLossPercent": number, "name": "string", "type": "string", "uplinkBandwidthBits": number, "uplinkDelayMs": number, "uplinkJitterMs": number, "uplinkLossPercent": number }, "parsingResultUrl": "string", "platform": "string", "radios": { "bluetooth": boolean, "gps": boolean, "nfc": boolean, "wifi": boolean }, "result": "string", "resultCode": "string", "seed": number, "skipAppResign": boolean, "started": number, "status": "string", "stopped": number, "totalJobs": number, "type": "string", "webUrl": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

run (p. 73)

The run you wish to get results from.

Type: Run (p. 235) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

API Version 2015-06-2374

Page 87: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2375

Page 88: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetSuite

GetSuiteGets information about a suite.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 76)

The suite's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "suite": { "arn": "string", "counters": { "errored": number, "failed": number, "passed": number, "skipped": number, "stopped": number, "total": number, "warned": number }, "created": number, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "message": "string", "name": "string", "result": "string", "started": number, "status": "string", "stopped": number, "type": "string" }}

API Version 2015-06-2376

Page 89: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

suite (p. 76)

A collection of one or more tests.

Type: Suite (p. 248) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2377

Page 90: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetTest

GetTestGets information about a test.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 78)

The test's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "test": { "arn": "string", "counters": { "errored": number, "failed": number, "passed": number, "skipped": number, "stopped": number, "total": number, "warned": number }, "created": number, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "message": "string", "name": "string", "result": "string", "started": number, "status": "string", "stopped": number, "type": "string" }}

API Version 2015-06-2378

Page 91: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

test (p. 78)

A test condition that is evaluated.

Type: Test (p. 251) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2379

Page 92: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetUpload

GetUploadGets information about an upload.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 80)

The upload's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "upload": { "arn": "string", "contentType": "string", "created": number, "message": "string", "metadata": "string", "name": "string", "status": "string", "type": "string", "url": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

upload (p. 80)

An app or a set of one or more tests to upload or that have been uploaded.

Type: Upload (p. 256) object

API Version 2015-06-2380

Page 93: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2381

Page 94: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceGetVPCEConfiguration

GetVPCEConfigurationReturns information about the configuration settings for your Amazon Virtual Private Cloud (VPC)endpoint.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 82)

The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to describe.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "vpceConfiguration": { "arn": "string", "serviceDnsName": "string", "vpceConfigurationDescription": "string", "vpceConfigurationName": "string", "vpceServiceName": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

vpceConfiguration (p. 82)

An object containing information about your VPC endpoint configuration.

Type: VPCEConfiguration (p. 259) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

API Version 2015-06-2382

Page 95: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2383

Page 96: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceInstallToRemoteAccessSession

InstallToRemoteAccessSessionInstalls an application to the device in a remote access session. For Android applications, the file must bein .apk format. For iOS applications, the file must be in .ipa format.

Request Syntax{ "appArn": "string", "remoteAccessSessionArn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

appArn (p. 84)

The Amazon Resource Name (ARN) of the app about which you are requesting information.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

remoteAccessSessionArn (p. 84)

The Amazon Resource Name (ARN) of the remote access session about which you are requestinginformation.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "appUpload": { "arn": "string", "contentType": "string", "created": number, "message": "string", "metadata": "string", "name": "string", "status": "string", "type": "string", "url": "string" }}

API Version 2015-06-2384

Page 97: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

appUpload (p. 84)

An app to upload or that has been uploaded.

Type: Upload (p. 256) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2385

Page 98: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListArtifacts

ListArtifactsGets information about artifacts.

Request Syntax{ "arn": "string", "nextToken": "string", "type": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 86)

The Run, Job, Suite, or Test ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: YesnextToken (p. 86)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

Required: Notype (p. 86)

The artifacts' type.

Allowed values include:• FILE: The artifacts are files.• LOG: The artifacts are logs.• SCREENSHOT: The artifacts are screenshots.

Type: String

Valid Values: SCREENSHOT | FILE | LOG

Required: Yes

Response Syntax{

API Version 2015-06-2386

Page 99: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"artifacts": [ { "arn": "string", "extension": "string", "name": "string", "type": "string", "url": "string" } ], "nextToken": "string"}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

artifacts (p. 86)

Information about the artifacts.

Type: Array of Artifact (p. 190) objectsnextToken (p. 86)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

API Version 2015-06-2387

Page 101: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListDeviceInstances

ListDeviceInstancesReturns information about the private device instances associated with one or more AWS accounts.

Request Syntax{ "maxResults": number, "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

maxResults (p. 89)

An integer specifying the maximum number of items you want to return in the API response.

Type: Integer

Required: NonextToken (p. 89)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

Required: No

Response Syntax{ "deviceInstances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ],

API Version 2015-06-2389

Page 102: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"nextToken": "string"}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

deviceInstances (p. 89)

An object containing information about your device instances.

Type: Array of DeviceInstance (p. 200) objectsnextToken (p. 89)

An identifier that can be used in the next call to this operation to return the next set of items in thelist.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++

API Version 2015-06-2390

Page 104: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListDevicePools

ListDevicePoolsGets information about device pools.

Request Syntax{ "arn": "string", "nextToken": "string", "type": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 92)

The project ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: YesnextToken (p. 92)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

Required: Notype (p. 92)

The device pools' type.

Allowed values include:• CURATED: A device pool that is created and managed by AWS Device Farm.• PRIVATE: A device pool that is created and managed by the device pool developer.

Type: String

Valid Values: CURATED | PRIVATE

Required: No

Response Syntax{

API Version 2015-06-2392

Page 105: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"devicePools": [ { "arn": "string", "description": "string", "name": "string", "rules": [ { "attribute": "string", "operator": "string", "value": "string" } ], "type": "string" } ], "nextToken": "string"}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

devicePools (p. 92)

Information about the device pools.

Type: Array of DevicePool (p. 203) objectsnextToken (p. 92)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400

API Version 2015-06-2393

Page 106: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2394

Page 107: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListDevices

ListDevicesGets information about unique device types.

Request Syntax{ "arn": "string", "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 95)

The Amazon Resource Name (ARN) of the project.

Type: String

Length Constraints: Minimum length of 32.

Required: No

nextToken (p. 95)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

Required: No

Response Syntax{ "devices": [ { "arn": "string", "carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" }, "fleetName": "string", "fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string",

API Version 2015-06-2395

Page 108: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"instances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } } ], "nextToken": "string"}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

devices (p. 95)

Information about the devices.

Type: Array of Device (p. 197) objectsnextToken (p. 95)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

API Version 2015-06-2396

Page 109: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2397

Page 110: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListInstanceProfiles

ListInstanceProfilesReturns information about all the instance profiles in an AWS account.

Request Syntax{ "maxResults": number, "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

maxResults (p. 98)

An integer specifying the maximum number of items you want to return in the API response.

Type: Integer

Required: NonextToken (p. 98)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

Required: No

Response Syntax{ "instanceProfiles": [ { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean } ], "nextToken": "string"}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

API Version 2015-06-2398

Page 111: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

The following data is returned in JSON format by the service.

instanceProfiles (p. 98)

An object containing information about your instance profiles.

Type: Array of InstanceProfile (p. 208) objectsnextToken (p. 98)

An identifier that can be used in the next call to this operation to return the next set of items in thelist.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-2399

Page 112: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

API Version 2015-06-23100

Page 113: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListJobs

ListJobsGets information about jobs for a given test run.

Request Syntax{ "arn": "string", "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 101)

The run's Amazon Resource Name (ARN).

Type: String

Length Constraints: Minimum length of 32.

Required: YesnextToken (p. 101)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

Required: No

Response Syntax{ "jobs": [ { "arn": "string", "counters": { "errored": number, "failed": number, "passed": number, "skipped": number, "stopped": number, "total": number, "warned": number }, "created": number, "device": { "arn": "string",

API Version 2015-06-23101

Page 114: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" }, "fleetName": "string", "fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string", "instances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } }, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "instanceArn": "string", "message": "string", "name": "string", "result": "string", "started": number, "status": "string", "stopped": number, "type": "string" } ], "nextToken": "string"}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

API Version 2015-06-23102

Page 115: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

The following data is returned in JSON format by the service.

jobs (p. 101)

Information about the jobs.

Type: Array of Job (p. 210) objectsnextToken (p. 101)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python

API Version 2015-06-23103

Page 116: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

• AWS SDK for Ruby V2

API Version 2015-06-23104

Page 117: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListNetworkProfiles

ListNetworkProfilesReturns the list of available network profiles.

Request Syntax{ "arn": "string", "nextToken": "string", "type": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 105)

The Amazon Resource Name (ARN) of the project for which you want to list network profiles.

Type: String

Length Constraints: Minimum length of 32.

Required: YesnextToken (p. 105)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

Required: Notype (p. 105)

The type of network profile you wish to return information about. Valid values are listed below.

Type: String

Valid Values: CURATED | PRIVATE

Required: No

Response Syntax{ "networkProfiles": [ { "arn": "string", "description": "string", "downlinkBandwidthBits": number,

API Version 2015-06-23105

Page 118: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"downlinkDelayMs": number, "downlinkJitterMs": number, "downlinkLossPercent": number, "name": "string", "type": "string", "uplinkBandwidthBits": number, "uplinkDelayMs": number, "uplinkJitterMs": number, "uplinkLossPercent": number } ], "nextToken": "string"}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

networkProfiles (p. 105)

A list of the available network profiles.

Type: Array of NetworkProfile (p. 215) objectsnextToken (p. 105)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

API Version 2015-06-23106

Page 120: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListOfferingPromotions

ListOfferingPromotionsReturns a list of offering promotions. Each offering promotion record contains the ID and descriptionof the promotion. The API returns a NotEligible error if the caller is not permitted to invoke theoperation. Contact [email protected] if you believe that you should be able toinvoke this operation.

Request Syntax{ "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

nextToken (p. 108)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "offeringPromotions": [ { "description": "string", "id": "string" } ]}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

nextToken (p. 108)

An identifier to be used in the next call to this operation, to return the next set of items in the list.

Type: String

API Version 2015-06-23108

Page 121: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

Length Constraints: Minimum length of 4. Maximum length of 1024.offeringPromotions (p. 108)

Information about the offering promotions.

Type: Array of OfferingPromotion (p. 219) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotEligibleException

Exception gets thrown when a user is not eligible to perform the specified transaction.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-23109

Page 122: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListOfferings

ListOfferingsReturns a list of products or offerings that the user can manage through the API. Each offeringrecord indicates the recurring price per unit and the frequency for that offering. The API returns aNotEligible error if the user is not permitted to invoke the operation. Please contact [email protected] if you believe that you should be able to invoke this operation.

Request Syntax

{ "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

nextToken (p. 110)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "offerings": [ { "description": "string", "id": "string", "platform": "string", "recurringCharges": [ { "cost": { "amount": number, "currencyCode": "string" }, "frequency": "string" } ], "type": "string" } ]}

API Version 2015-06-23110

Page 123: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

nextToken (p. 110)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.

offerings (p. 110)

A value representing the list offering results.

Type: Array of Offering (p. 217) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

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

Example

The following example response shows a list of device offerings for the user's account.

API Version 2015-06-23111

Page 124: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

Sample Response

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

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-23112

Page 125: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListOfferingTransactions

ListOfferingTransactionsReturns 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 APIreturns a NotEligible error if the user is not permitted to invoke the operation. Please contact [email protected] if you believe that you should be able to invoke this operation.

Request Syntax{ "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

nextToken (p. 113)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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" }

API Version 2015-06-23113

Page 126: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

], "type": "string" }, "quantity": number, "type": "string" }, "transactionId": "string" } ]}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

nextToken (p. 113)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.offeringTransactions (p. 113)

The audit log of subscriptions you have purchased and modified through AWS Device Farm.

Type: Array of OfferingTransaction (p. 221) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotEligibleException

Exception gets thrown when a user is not eligible to perform the specified transaction.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-23114

Page 127: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceExample

HTTP Status Code: 400

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": {

API Version 2015-06-23115

Page 128: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceExample

"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,

API Version 2015-06-23116

Page 129: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceExample

"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 },

API Version 2015-06-23117

Page 130: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceExample

"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": {

API Version 2015-06-23118

Page 131: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceExample

"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

API Version 2015-06-23119

Page 132: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

}, "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 AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-23120

Page 133: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListProjects

ListProjectsGets information about projects.

Request Syntax{ "arn": "string", "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 121)

Optional. If no Amazon Resource Name (ARN) is specified, then AWS Device Farm returns a list of allprojects for the AWS account. You can also specify a project ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: NonextToken (p. 121)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "projects": [ { "arn": "string", "created": number, "defaultJobTimeoutMinutes": number, "name": "string" } ]}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

API Version 2015-06-23121

Page 134: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

The following data is returned in JSON format by the service.

nextToken (p. 121)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.projects (p. 121)

Information about the projects.

Type: Array of Project (p. 225) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python

API Version 2015-06-23122

Page 135: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

• AWS SDK for Ruby V2

API Version 2015-06-23123

Page 136: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListRemoteAccessSessions

ListRemoteAccessSessionsReturns a list of all currently running remote access sessions.

Request Syntax{ "arn": "string", "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 124)

The Amazon Resource Name (ARN) of the remote access session about which you are requestinginformation.

Type: String

Length Constraints: Minimum length of 32.

Required: YesnextToken (p. 124)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "remoteAccessSessions": [ { "arn": "string", "billingMethod": "string", "clientId": "string", "created": number, "device": { "arn": "string", "carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" },

API Version 2015-06-23124

Page 137: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"fleetName": "string", "fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string", "instances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } }, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "deviceUdid": "string", "endpoint": "string", "hostAddress": "string", "instanceArn": "string", "interactionMode": "string", "message": "string", "name": "string", "remoteDebugEnabled": boolean, "remoteRecordAppArn": "string", "remoteRecordEnabled": boolean, "result": "string", "skipAppResign": boolean, "started": number, "status": "string", "stopped": number } ]}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

API Version 2015-06-23125

Page 138: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

The following data is returned in JSON format by the service.

nextToken (p. 124)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.remoteAccessSessions (p. 124)

A container representing the metadata from the service about each remote access session you arerequesting.

Type: Array of RemoteAccessSession (p. 228) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python

API Version 2015-06-23126

Page 139: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

• AWS SDK for Ruby V2

API Version 2015-06-23127

Page 140: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListRuns

ListRunsGets information about runs, given an AWS Device Farm project ARN.

Request Syntax{ "arn": "string", "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 128)

The Amazon Resource Name (ARN) of the project for which you want to list runs.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

nextToken (p. 128)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "runs": [ { "appUpload": "string", "arn": "string", "billingMethod": "string", "completedJobs": number, "counters": { "errored": number, "failed": number, "passed": number, "skipped": number, "stopped": number, "total": number,

API Version 2015-06-23128

Page 141: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"warned": number }, "created": number, "customerArtifactPaths": { "androidPaths": [ "string" ], "deviceHostPaths": [ "string" ], "iosPaths": [ "string" ] }, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "devicePoolArn": "string", "eventCount": number, "jobTimeoutMinutes": number, "locale": "string", "location": { "latitude": number, "longitude": number }, "message": "string", "name": "string", "networkProfile": { "arn": "string", "description": "string", "downlinkBandwidthBits": number, "downlinkDelayMs": number, "downlinkJitterMs": number, "downlinkLossPercent": number, "name": "string", "type": "string", "uplinkBandwidthBits": number, "uplinkDelayMs": number, "uplinkJitterMs": number, "uplinkLossPercent": number }, "parsingResultUrl": "string", "platform": "string", "radios": { "bluetooth": boolean, "gps": boolean, "nfc": boolean, "wifi": boolean }, "result": "string", "resultCode": "string", "seed": number, "skipAppResign": boolean, "started": number, "status": "string", "stopped": number, "totalJobs": number, "type": "string", "webUrl": "string" } ]}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

API Version 2015-06-23129

Page 142: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

nextToken (p. 128)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.runs (p. 128)

Information about the runs.

Type: Array of Run (p. 235) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-23130

Page 143: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

API Version 2015-06-23131

Page 144: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListSamples

ListSamplesGets information about samples, given an AWS Device Farm project ARN

Request Syntax{ "arn": "string", "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 132)

The Amazon Resource Name (ARN) of the project for which you want to list samples.

Type: String

Length Constraints: Minimum length of 32.

Required: YesnextToken (p. 132)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "samples": [ { "arn": "string", "type": "string", "url": "string" } ]}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

API Version 2015-06-23132

Page 145: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

The following data is returned in JSON format by the service.

nextToken (p. 132)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.samples (p. 132)

Information about the samples.

Type: Array of Sample (p. 241) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python

API Version 2015-06-23133

Page 146: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

• AWS SDK for Ruby V2

API Version 2015-06-23134

Page 147: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListSuites

ListSuitesGets information about test suites for a given job.

Request Syntax{ "arn": "string", "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 135)

The job's Amazon Resource Name (ARN).

Type: String

Length Constraints: Minimum length of 32.

Required: YesnextToken (p. 135)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "suites": [ { "arn": "string", "counters": { "errored": number, "failed": number, "passed": number, "skipped": number, "stopped": number, "total": number, "warned": number }, "created": number, "deviceMinutes": {

API Version 2015-06-23135

Page 148: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"metered": number, "total": number, "unmetered": number }, "message": "string", "name": "string", "result": "string", "started": number, "status": "string", "stopped": number, "type": "string" } ]}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

nextToken (p. 135)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.suites (p. 135)

Information about the suites.

Type: Array of Suite (p. 248) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-23136

Page 150: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListTests

ListTestsGets information about tests in a given test suite.

Request Syntax{ "arn": "string", "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 138)

The test suite's Amazon Resource Name (ARN).

Type: String

Length Constraints: Minimum length of 32.

Required: YesnextToken (p. 138)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "tests": [ { "arn": "string", "counters": { "errored": number, "failed": number, "passed": number, "skipped": number, "stopped": number, "total": number, "warned": number }, "created": number, "deviceMinutes": {

API Version 2015-06-23138

Page 151: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"metered": number, "total": number, "unmetered": number }, "message": "string", "name": "string", "result": "string", "started": number, "status": "string", "stopped": number, "type": "string" } ]}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

nextToken (p. 138)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.tests (p. 138)

Information about the tests.

Type: Array of Test (p. 251) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-23139

Page 153: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListUniqueProblems

ListUniqueProblemsGets information about unique problems.

Request Syntax{ "arn": "string", "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 141)

The unique problems' ARNs.

Type: String

Length Constraints: Minimum length of 32.

Required: YesnextToken (p. 141)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "uniqueProblems": { "string" : [ { "message": "string", "problems": [ { "device": { "arn": "string", "carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" }, "fleetName": "string",

API Version 2015-06-23141

Page 154: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string", "instances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } }, "job": { "arn": "string", "name": "string" }, "message": "string", "result": "string", "run": { "arn": "string", "name": "string" }, "suite": { "arn": "string", "name": "string" }, "test": { "arn": "string", "name": "string" } } ] } ] }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

API Version 2015-06-23142

Page 155: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

The following data is returned in JSON format by the service.

nextToken (p. 141)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.uniqueProblems (p. 141)

Information about the unique problems.

Allowed values include:• PENDING: A pending condition.• PASSED: A passing condition.• WARNED: A warning condition.• FAILED: A failed condition.• SKIPPED: A skipped condition.• ERRORED: An error condition.• STOPPED: A stopped condition.

Type: String to array of UniqueProblem (p. 255) objects map

Valid Keys: PENDING | PASSED | WARNED | FAILED | SKIPPED | ERRORED | STOPPED

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

API Version 2015-06-23143

Page 157: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListUploads

ListUploadsGets information about uploads, given an AWS Device Farm project ARN.

Request Syntax{ "arn": "string", "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 145)

The Amazon Resource Name (ARN) of the project for which you want to list uploads.

Type: String

Length Constraints: Minimum length of 32.

Required: YesnextToken (p. 145)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "uploads": [ { "arn": "string", "contentType": "string", "created": number, "message": "string", "metadata": "string", "name": "string", "status": "string", "type": "string", "url": "string" } ]}

API Version 2015-06-23145

Page 158: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

nextToken (p. 145)

If the number of items that are returned is significantly large, this is an identifier that is alsoreturned, which can be used in a subsequent call to this operation to return the next set of items inthe list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.uploads (p. 145)

Information about the uploads.

Type: Array of Upload (p. 256) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java

API Version 2015-06-23146

Page 160: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceListVPCEConfigurations

ListVPCEConfigurationsReturns information about all Amazon Virtual Private Cloud (VPC) endpoint configurations in the AWSaccount.

Request Syntax{ "maxResults": number, "nextToken": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

maxResults (p. 148)

An integer specifying the maximum number of items you want to return in the API response.

Type: Integer

Required: NonextToken (p. 148)

An identifier that was returned from the previous call to this operation, which can be used to returnthe 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", "vpceConfigurations": [ { "arn": "string", "serviceDnsName": "string", "vpceConfigurationDescription": "string", "vpceConfigurationName": "string", "vpceServiceName": "string" } ]}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

API Version 2015-06-23148

Page 161: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceErrors

The following data is returned in JSON format by the service.

nextToken (p. 148)

An identifier that was returned from the previous call to this operation, which can be used to returnthe next set of items in the list.

Type: String

Length Constraints: Minimum length of 4. Maximum length of 1024.vpceConfigurations (p. 148)

An array of VPCEConfiguration objects containing information about your VPC endpointconfiguration.

Type: Array of VPCEConfiguration (p. 259) objects

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-23149

Page 162: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferencePurchaseOffering

PurchaseOfferingImmediately purchases offerings for an AWS account. Offerings renew with the latest total purchasedquantity for an offering, unless the renewal was overridden. The API returns a NotEligible error if theuser is not permitted to invoke the operation. Please contact [email protected] ifyou believe that you should be able to invoke this operation.

Request Syntax{ "offeringId": "string", "offeringPromotionId": "string", "quantity": number}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

offeringId (p. 150)

The ID of the offering.

Type: String

Length Constraints: Minimum length of 32.

Required: NoofferingPromotionId (p. 150)

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

Type: String

Length Constraints: Minimum length of 4.

Required: Noquantity (p. 150)

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

Type: Integer

Required: No

Response Syntax{ "offeringTransaction": { "cost": { "amount": number,

API Version 2015-06-23150

Page 163: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"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 ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

offeringTransaction (p. 150)

Represents the offering transaction for the purchase result.

Type: OfferingTransaction (p. 221) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotEligibleException

Exception gets thrown when a user is not eligible to perform the specified transaction.

HTTP Status Code: 400

API Version 2015-06-23151

Page 164: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceExample

NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

Example

The following example purchases one unmetered iOS device.

Sample Request

{ "transactions": [ "purchase": { "offeringId": "offering-id-ios", "quantity": 1 } ]}

Sample Response

{ "offeringTransaction": { "createdOn": 1458587590.308, "offeringStatus": { "effectiveOn": 1458587590.24, "type": "RECURRING", "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" }}

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET

API Version 2015-06-23152

Page 166: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceRenewOffering

RenewOfferingExplicitly sets the quantity of devices to renew for an offering, starting from the effectiveDate of thenext period. The API returns a NotEligible error if the user is not permitted to invoke the operation.Please contact [email protected] if you believe that you should be able to invokethis operation.

Request Syntax{ "offeringId": "string", "quantity": number}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

offeringId (p. 154)

The ID of a request to renew an offering.

Type: String

Length Constraints: Minimum length of 32.

Required: Noquantity (p. 154)

The quantity requested in an offering renewal.

Type: Integer

Required: No

Response Syntax{ "offeringTransaction": { "cost": { "amount": number, "currencyCode": "string" }, "createdOn": number, "offeringPromotionId": "string", "offeringStatus": { "effectiveOn": number, "offering": { "description": "string", "id": "string", "platform": "string", "recurringCharges": [

API Version 2015-06-23154

Page 167: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

{ "cost": { "amount": number, "currencyCode": "string" }, "frequency": "string" } ], "type": "string" }, "quantity": number, "type": "string" }, "transactionId": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

offeringTransaction (p. 154)

Represents the status of the offering transaction for the renewal.

Type: OfferingTransaction (p. 221) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotEligibleException

Exception gets thrown when a user is not eligible to perform the specified transaction.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

API Version 2015-06-23155

Page 168: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceExample

Example

The following example renews the offering for one unmetered iOS device.

Sample Request

{ "transactions": [ "renew": { "offeringId": "offering-id-ios", "quantity": 1, } ]}

Sample Response

{ "offeringTransaction": { "createdOn": 1458596930.431, "offeringStatus": { "effectiveOn": 1459468800.0, "type": "RECURRING", "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" }}

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-23156

Page 169: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceScheduleRun

ScheduleRunSchedules a run.

Request Syntax{ "appArn": "string", "configuration": { "auxiliaryApps": [ "string" ], "billingMethod": "string", "customerArtifactPaths": { "androidPaths": [ "string" ], "deviceHostPaths": [ "string" ], "iosPaths": [ "string" ] }, "extraDataPackageArn": "string", "locale": "string", "location": { "latitude": number, "longitude": number }, "networkProfileArn": "string", "radios": { "bluetooth": boolean, "gps": boolean, "nfc": boolean, "wifi": boolean }, "vpceConfigurationArns": [ "string" ] }, "devicePoolArn": "string", "executionConfiguration": { "accountsCleanup": boolean, "appPackagesCleanup": boolean, "jobTimeoutMinutes": number, "skipAppResign": boolean }, "name": "string", "projectArn": "string", "test": { "filter": "string", "parameters": { "string" : "string" }, "testPackageArn": "string", "type": "string" }}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

appArn (p. 157)

The ARN of the app to schedule a run.

API Version 2015-06-23157

Page 170: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

Type: String

Length Constraints: Minimum length of 32.

Required: Noconfiguration (p. 157)

Information about the settings for the run to be scheduled.

Type: ScheduleRunConfiguration (p. 243) object

Required: NodevicePoolArn (p. 157)

The ARN of the device pool for the run to be scheduled.

Type: String

Length Constraints: Minimum length of 32.

Required: YesexecutionConfiguration (p. 157)

Specifies configuration information about a test run, such as the execution timeout (in minutes).

Type: ExecutionConfiguration (p. 206) object

Required: Noname (p. 157)

The name for the run to be scheduled.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: NoprojectArn (p. 157)

The ARN of the project for the run to be scheduled.

Type: String

Length Constraints: Minimum length of 32.

Required: Yestest (p. 157)

Information about the test for the run to be scheduled.

Type: ScheduleRunTest (p. 245) object

Required: Yes

Response Syntax{ "run": {

API Version 2015-06-23158

Page 171: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

"appUpload": "string", "arn": "string", "billingMethod": "string", "completedJobs": number, "counters": { "errored": number, "failed": number, "passed": number, "skipped": number, "stopped": number, "total": number, "warned": number }, "created": number, "customerArtifactPaths": { "androidPaths": [ "string" ], "deviceHostPaths": [ "string" ], "iosPaths": [ "string" ] }, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "devicePoolArn": "string", "eventCount": number, "jobTimeoutMinutes": number, "locale": "string", "location": { "latitude": number, "longitude": number }, "message": "string", "name": "string", "networkProfile": { "arn": "string", "description": "string", "downlinkBandwidthBits": number, "downlinkDelayMs": number, "downlinkJitterMs": number, "downlinkLossPercent": number, "name": "string", "type": "string", "uplinkBandwidthBits": number, "uplinkDelayMs": number, "uplinkJitterMs": number, "uplinkLossPercent": number }, "parsingResultUrl": "string", "platform": "string", "radios": { "bluetooth": boolean, "gps": boolean, "nfc": boolean, "wifi": boolean }, "result": "string", "resultCode": "string", "seed": number, "skipAppResign": boolean, "started": number, "status": "string", "stopped": number, "totalJobs": number, "type": "string", "webUrl": "string"

API Version 2015-06-23159

Page 172: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

}}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

run (p. 158)

Information about the scheduled run.

Type: Run (p. 235) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400IdempotencyException

An entity with the same name already exists.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java

API Version 2015-06-23160

Page 174: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceStopRemoteAccessSession

StopRemoteAccessSessionEnds a specified remote access session.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 162)

The Amazon Resource Name (ARN) of the remote access session you wish to stop.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "remoteAccessSession": { "arn": "string", "billingMethod": "string", "clientId": "string", "created": number, "device": { "arn": "string", "carrier": "string", "cpu": { "architecture": "string", "clock": number, "frequency": "string" }, "fleetName": "string", "fleetType": "string", "formFactor": "string", "heapSize": number, "image": "string", "instances": [ { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean,

API Version 2015-06-23162

Page 175: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" } ], "manufacturer": "string", "memory": number, "model": "string", "modelId": "string", "name": "string", "os": "string", "platform": "string", "radio": "string", "remoteAccessEnabled": boolean, "remoteDebugEnabled": boolean, "resolution": { "height": number, "width": number } }, "deviceMinutes": { "metered": number, "total": number, "unmetered": number }, "deviceUdid": "string", "endpoint": "string", "hostAddress": "string", "instanceArn": "string", "interactionMode": "string", "message": "string", "name": "string", "remoteDebugEnabled": boolean, "remoteRecordAppArn": "string", "remoteRecordEnabled": boolean, "result": "string", "skipAppResign": boolean, "started": number, "status": "string", "stopped": number }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

remoteAccessSession (p. 162)

A container representing the metadata from the service about the remote access session you arestopping.

Type: RemoteAccessSession (p. 228) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

API Version 2015-06-23163

Page 176: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-23164

Page 177: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceStopRun

StopRunInitiates a stop request for the current test run. AWS Device Farm will immediately stop the run ondevices where tests have not started executing, and you will not be billed for these devices. On deviceswhere tests have started executing, Setup Suite and Teardown Suite tests will run to completion beforestopping execution on those devices. You will be billed for Setup, Teardown, and any tests that were inprogress or already completed.

Request Syntax{ "arn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 165)

Represents the Amazon Resource Name (ARN) of the Device Farm run you wish to stop.

Type: String

Length Constraints: Minimum length of 32.

Required: Yes

Response Syntax{ "run": { "appUpload": "string", "arn": "string", "billingMethod": "string", "completedJobs": number, "counters": { "errored": number, "failed": number, "passed": number, "skipped": number, "stopped": number, "total": number, "warned": number }, "created": number, "customerArtifactPaths": { "androidPaths": [ "string" ], "deviceHostPaths": [ "string" ], "iosPaths": [ "string" ] }, "deviceMinutes": { "metered": number, "total": number,

API Version 2015-06-23165

Page 178: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"unmetered": number }, "devicePoolArn": "string", "eventCount": number, "jobTimeoutMinutes": number, "locale": "string", "location": { "latitude": number, "longitude": number }, "message": "string", "name": "string", "networkProfile": { "arn": "string", "description": "string", "downlinkBandwidthBits": number, "downlinkDelayMs": number, "downlinkJitterMs": number, "downlinkLossPercent": number, "name": "string", "type": "string", "uplinkBandwidthBits": number, "uplinkDelayMs": number, "uplinkJitterMs": number, "uplinkLossPercent": number }, "parsingResultUrl": "string", "platform": "string", "radios": { "bluetooth": boolean, "gps": boolean, "nfc": boolean, "wifi": boolean }, "result": "string", "resultCode": "string", "seed": number, "skipAppResign": boolean, "started": number, "status": "string", "stopped": number, "totalJobs": number, "type": "string", "webUrl": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

run (p. 165)

The run that was stopped.

Type: Run (p. 235) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

API Version 2015-06-23166

Page 179: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-23167

Page 180: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceUpdateDeviceInstance

UpdateDeviceInstanceUpdates information about an existing private device instance.

Request Syntax{ "arn": "string", "labels": [ "string" ], "profileArn": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 168)

The Amazon Resource Name (ARN) of the device instance.

Type: String

Length Constraints: Minimum length of 32.

Required: Yeslabels (p. 168)

An array of strings that you want to associate with the device instance.

Type: Array of strings

Required: NoprofileArn (p. 168)

The Amazon Resource Name (ARN) of the profile that you want to associate with the device instance.

Type: String

Length Constraints: Minimum length of 32.

Required: No

Response Syntax{ "deviceInstance": { "arn": "string", "deviceArn": "string", "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ],

API Version 2015-06-23168

Page 181: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

"name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }, "labels": [ "string" ], "status": "string", "udid": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

deviceInstance (p. 168)

An object containing information about your device instance.

Type: DeviceInstance (p. 200) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go

API Version 2015-06-23169

Page 183: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceUpdateDevicePool

UpdateDevicePoolModifies the name, description, and rules in a device pool given the attributes and the pool ARN. Ruleupdates are all-or-nothing, meaning they can only be updated as a whole (or not at all).

Request Syntax{ "arn": "string", "description": "string", "name": "string", "rules": [ { "attribute": "string", "operator": "string", "value": "string" } ]}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 171)

The Amazon Resourc Name (ARN) of the Device Farm device pool you wish to update.

Type: String

Length Constraints: Minimum length of 32.

Required: Yesdescription (p. 171)

A description of the device pool you wish to update.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Noname (p. 171)

A string representing the name of the device pool you wish to update.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Norules (p. 171)

Represents the rules you wish to modify for the device pool. Updating rules is optional; however, ifyou choose to update rules for your request, the update will replace the existing rules.

API Version 2015-06-23171

Page 184: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

Type: Array of Rule (p. 233) objects

Required: No

Response Syntax{ "devicePool": { "arn": "string", "description": "string", "name": "string", "rules": [ { "attribute": "string", "operator": "string", "value": "string" } ], "type": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

devicePool (p. 172)

The device pool you just updated.

Type: DevicePool (p. 203) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

API Version 2015-06-23172

Page 186: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceUpdateInstanceProfile

UpdateInstanceProfileUpdates information about an existing private device instance profile.

Request Syntax{ "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 174)

The Amazon Resource Name (ARN) of the instance profile.

Type: String

Length Constraints: Minimum length of 32.

Required: Yesdescription (p. 174)

The updated description for your instance profile.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: NoexcludeAppPackagesFromCleanup (p. 174)

An array of strings specifying the list of app packages that should not be cleaned up from the deviceafter a test run is over.

The list of packages is only considered if you set packageCleanup to true.

Type: Array of strings

Required: Noname (p. 174)

The updated name for your instance profile.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

API Version 2015-06-23174

Page 187: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

Required: NopackageCleanup (p. 174)

The updated choice for whether you want to specify package cleanup. The default value is false forprivate devices.

Type: Boolean

Required: NorebootAfterUse (p. 174)

The updated choice for whether you want to reboot the device after use. The default value is true.

Type: Boolean

Required: No

Response Syntax{ "instanceProfile": { "arn": "string", "description": "string", "excludeAppPackagesFromCleanup": [ "string" ], "name": "string", "packageCleanup": boolean, "rebootAfterUse": boolean }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

instanceProfile (p. 175)

An object containing information about your instance profile.

Type: InstanceProfile (p. 208) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400

API Version 2015-06-23175

Page 188: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-23176

Page 189: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceUpdateNetworkProfile

UpdateNetworkProfileUpdates the network profile with specific settings.

Request Syntax{ "arn": "string", "description": "string", "downlinkBandwidthBits": number, "downlinkDelayMs": number, "downlinkJitterMs": number, "downlinkLossPercent": number, "name": "string", "type": "string", "uplinkBandwidthBits": number, "uplinkDelayMs": number, "uplinkJitterMs": number, "uplinkLossPercent": number}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 177)

The Amazon Resource Name (ARN) of the project for which you want to update network profilesettings.

Type: String

Length Constraints: Minimum length of 32.

Required: Yesdescription (p. 177)

The descriptoin of the network profile about which you are returning information.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: NodownlinkBandwidthBits (p. 177)

The data throughput rate in bits per second, as an integer from 0 to 104857600.

Type: Long

Required: NodownlinkDelayMs (p. 177)

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

API Version 2015-06-23177

Page 190: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceRequest Parameters

Type: Long

Required: NodownlinkJitterMs (p. 177)

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

Type: Long

Required: NodownlinkLossPercent (p. 177)

Proportion of received packets that fail to arrive from 0 to 100 percent.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 100.

Required: Noname (p. 177)

The name of the network profile about which you are returning information.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Notype (p. 177)

The type of network profile you wish to return information about. Valid values are listed below.

Type: String

Valid Values: CURATED | PRIVATE

Required: NouplinkBandwidthBits (p. 177)

The data throughput rate in bits per second, as an integer from 0 to 104857600.

Type: Long

Required: NouplinkDelayMs (p. 177)

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

Type: Long

Required: NouplinkJitterMs (p. 177)

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

Type: Long

Required: NouplinkLossPercent (p. 177)

Proportion of transmitted packets that fail to arrive from 0 to 100 percent.

API Version 2015-06-23178

Page 191: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 100.

Required: No

Response Syntax{ "networkProfile": { "arn": "string", "description": "string", "downlinkBandwidthBits": number, "downlinkDelayMs": number, "downlinkJitterMs": number, "downlinkLossPercent": number, "name": "string", "type": "string", "uplinkBandwidthBits": number, "uplinkDelayMs": number, "uplinkJitterMs": number, "uplinkLossPercent": number }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

networkProfile (p. 179)

A list of the available network profiles.

Type: NetworkProfile (p. 215) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400

API Version 2015-06-23179

Page 193: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceUpdateProject

UpdateProjectModifies the specified project name, given the project ARN and a new name.

Request Syntax{ "arn": "string", "defaultJobTimeoutMinutes": number, "name": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 181)

The Amazon Resource Name (ARN) of the project whose name you wish to update.

Type: String

Length Constraints: Minimum length of 32.

Required: YesdefaultJobTimeoutMinutes (p. 181)

The number of minutes a test run in the project will execute before it times out.

Type: Integer

Required: Noname (p. 181)

A string representing the new name of the project that you are updating.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: No

Response Syntax{ "project": { "arn": "string", "created": number, "defaultJobTimeoutMinutes": number, "name": "string" }}

API Version 2015-06-23181

Page 194: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Elements

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

project (p. 181)

The project you wish to update.

Type: Project (p. 225) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400LimitExceededException

A limit was exceeded.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400ServiceAccountException

There was a problem with the service account.

HTTP Status Code: 400

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS Command Line Interface• AWS SDK for .NET• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2

API Version 2015-06-23182

Page 195: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceUpdateVPCEConfiguration

UpdateVPCEConfigurationUpdates information about an existing Amazon Virtual Private Cloud (VPC) endpoint configuration.

Request Syntax{ "arn": "string", "serviceDnsName": "string", "vpceConfigurationDescription": "string", "vpceConfigurationName": "string", "vpceServiceName": "string"}

Request ParametersFor information about the parameters that are common to all actions, see CommonParameters (p. 261).

The request accepts the following data in JSON format.

arn (p. 183)

The Amazon Resource Name (ARN) of the VPC endpoint configuration you want to update.

Type: String

Length Constraints: Minimum length of 32.

Required: YesserviceDnsName (p. 183)

The DNS (domain) name used to connect to your private service in your Amazon VPC. The DNS namemust not already be in use on the Internet.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: NovpceConfigurationDescription (p. 183)

An optional description, providing more details about your VPC endpoint configuration.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: NovpceConfigurationName (p. 183)

The friendly name you give to your VPC endpoint configuration, to manage your configurationsmore easily.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 1024.

API Version 2015-06-23183

Page 196: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResponse Syntax

Required: NovpceServiceName (p. 183)

The name of the VPC endpoint service running inside your AWS account that you want Device Farmto test.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: No

Response Syntax{ "vpceConfiguration": { "arn": "string", "serviceDnsName": "string", "vpceConfigurationDescription": "string", "vpceConfigurationName": "string", "vpceServiceName": "string" }}

Response ElementsIf the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

vpceConfiguration (p. 184)

An object containing information about your VPC endpoint configuration.

Type: VPCEConfiguration (p. 259) object

ErrorsFor information about the errors that are common to all actions, see Common Errors (p. 263).

ArgumentException

An invalid argument was specified.

HTTP Status Code: 400InvalidOperationException

There was an error with the update request, or you do not have sufficient permissions to update thisVPC endpoint configuration.

HTTP Status Code: 400NotFoundException

The specified entity was not found.

HTTP Status Code: 400

API Version 2015-06-23184

Page 198: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

Data TypesThe AWS Device Farm API contains several data types that various actions use. This section describeseach data type in detail.

NoteThe order of each element in a data type structure is not guaranteed. Applications should notassume a particular order.

The following data types are supported:

• AccountSettings (p. 188)• Artifact (p. 190)• Counters (p. 192)• CPU (p. 194)• CreateRemoteAccessSessionConfiguration (p. 195)• CustomerArtifactPaths (p. 196)• Device (p. 197)• DeviceInstance (p. 200)• DeviceMinutes (p. 202)• DevicePool (p. 203)• DevicePoolCompatibilityResult (p. 205)• ExecutionConfiguration (p. 206)• IncompatibilityMessage (p. 207)• InstanceProfile (p. 208)• Job (p. 210)• Location (p. 213)• MonetaryAmount (p. 214)• NetworkProfile (p. 215)• Offering (p. 217)• OfferingPromotion (p. 219)• OfferingStatus (p. 220)• OfferingTransaction (p. 221)• Problem (p. 222)• ProblemDetail (p. 224)• Project (p. 225)• Radios (p. 226)• RecurringCharge (p. 227)• RemoteAccessSession (p. 228)• Resolution (p. 232)• Rule (p. 233)• Run (p. 235)• Sample (p. 241)• ScheduleRunConfiguration (p. 243)• ScheduleRunTest (p. 245)• Suite (p. 248)

API Version 2015-06-23186

Page 199: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

• Test (p. 251)• TrialMinutes (p. 254)• UniqueProblem (p. 255)• Upload (p. 256)• VPCEConfiguration (p. 259)

API Version 2015-06-23187

Page 200: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceAccountSettings

AccountSettingsA container for account-level settings within AWS Device Farm.

ContentsawsAccountNumber

The AWS account number specified in the AccountSettings container.

Type: String

Length Constraints: Minimum length of 2. Maximum length of 16.

Required: NodefaultJobTimeoutMinutes

The default number of minutes (at the account level) a test run will execute before it times out.Default value is 60 minutes.

Type: Integer

Required: NomaxJobTimeoutMinutes

The maximum number of minutes a test run will execute before it times out.

Type: Integer

Required: NomaxSlots

The maximum number of device slots that the AWS account can purchase. Each maximum isexpressed as an offering-id:number pair, where the offering-id represents one of the IDsreturned by the ListOfferings command.

Type: String to integer map

Required: NoskipAppResign

When set to true, for private devices, Device Farm will not sign your app again. For public devices,Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in theAWS Device Farm FAQs.

Type: Boolean

Required: NotrialMinutes

Information about an AWS account's usage of free trial device minutes.

Type: TrialMinutes (p. 254) object

Required: No

API Version 2015-06-23188

Page 201: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

unmeteredDevices

Returns the unmetered devices you have purchased or want to purchase.

Type: String to integer map

Valid Keys: ANDROID | IOS

Required: NounmeteredRemoteAccessDevices

Returns the unmetered remote access devices you have purchased or want to purchase.

Type: String to integer map

Valid Keys: ANDROID | IOS

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23189

Page 202: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceArtifact

ArtifactRepresents the output of a test. Examples of artifacts include logs and screenshots.

Contentsarn

The artifact's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Noextension

The artifact's file extension.

Type: String

Required: Noname

The artifact's name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Notype

The artifact's type.

Allowed values include the following:• UNKNOWN: An unknown type.• SCREENSHOT: The screenshot type.• DEVICE_LOG: The device log type.• MESSAGE_LOG: The message log type.• RESULT_LOG: The result log type.• SERVICE_LOG: The service log type.• WEBKIT_LOG: The web kit log type.• INSTRUMENTATION_OUTPUT: The instrumentation type.• EXERCISER_MONKEY_OUTPUT: For Android, the artifact (log) generated by an Android fuzz test.• CALABASH_JSON_OUTPUT: The Calabash JSON output type.• CALABASH_PRETTY_OUTPUT: The Calabash pretty output type.• CALABASH_STANDARD_OUTPUT: The Calabash standard output type.• CALABASH_JAVA_XML_OUTPUT: The Calabash Java XML output type.• AUTOMATION_OUTPUT: The automation output type.• APPIUM_SERVER_OUTPUT: The Appium server output type.• APPIUM_JAVA_OUTPUT: The Appium Java output type.• APPIUM_JAVA_XML_OUTPUT: The Appium Java XML output type.

API Version 2015-06-23190

Page 203: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

• APPIUM_PYTHON_OUTPUT: The Appium Python output type.• APPIUM_PYTHON_XML_OUTPUT: The Appium Python XML output type.• EXPLORER_EVENT_LOG: The Explorer event log output type.• EXPLORER_SUMMARY_LOG: The Explorer summary log output type.• APPLICATION_CRASH_REPORT: The application crash report output type.• XCTEST_LOG: The XCode test output type.

Type: String

Valid Values: UNKNOWN | SCREENSHOT | DEVICE_LOG | MESSAGE_LOG | VIDEO_LOG| RESULT_LOG | SERVICE_LOG | WEBKIT_LOG | INSTRUMENTATION_OUTPUT |EXERCISER_MONKEY_OUTPUT | CALABASH_JSON_OUTPUT | CALABASH_PRETTY_OUTPUT| CALABASH_STANDARD_OUTPUT | CALABASH_JAVA_XML_OUTPUT | AUTOMATION_OUTPUT| APPIUM_SERVER_OUTPUT | APPIUM_JAVA_OUTPUT | APPIUM_JAVA_XML_OUTPUT |APPIUM_PYTHON_OUTPUT | APPIUM_PYTHON_XML_OUTPUT | EXPLORER_EVENT_LOG |EXPLORER_SUMMARY_LOG | APPLICATION_CRASH_REPORT | XCTEST_LOG | VIDEO |CUSTOMER_ARTIFACT | CUSTOMER_ARTIFACT_LOG

Required: Nourl

The pre-signed Amazon S3 URL that can be used with a corresponding GET request to download theartifact's file.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23191

Page 204: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCounters

CountersRepresents entity counters.

Contentserrored

The number of errored entities.

Type: Integer

Required: No

failed

The number of failed entities.

Type: Integer

Required: No

passed

The number of passed entities.

Type: Integer

Required: No

skipped

The number of skipped entities.

Type: Integer

Required: No

stopped

The number of stopped entities.

Type: Integer

Required: No

total

The total number of entities.

Type: Integer

Required: No

warned

The number of warned entities.

Type: Integer

Required: No

API Version 2015-06-23192

Page 205: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23193

Page 206: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCPU

CPURepresents the amount of CPU that an app is using on a physical device.

Note that this does not represent system-wide CPU usage.

Contentsarchitecture

The CPU's architecture, for example x86 or ARM.

Type: String

Required: Noclock

The clock speed of the device's CPU, expressed in hertz (Hz). For example, a 1.2 GHz CPU isexpressed as 1200000000.

Type: Double

Required: Nofrequency

The CPU's frequency.

Type: String

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23194

Page 207: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCreateRemoteAccessSessionConfiguration

CreateRemoteAccessSessionConfigurationConfiguration settings for a remote access session, including billing method.

ContentsbillingMethod

The billing method for the remote access session.

Type: String

Valid Values: METERED | UNMETERED

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23195

Page 208: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceCustomerArtifactPaths

CustomerArtifactPathsA JSON object specifying the paths where the artifacts generated by the customer's tests, on the deviceor in the test environment, will be pulled from.

Specify deviceHostPaths and optionally specify either iosPaths or androidPaths.

For web app tests, you can specify both iosPaths and androidPaths.

ContentsandroidPaths

Comma-separated list of paths on the Android device where the artifacts generated by thecustomer's tests will be pulled from.

Type: Array of strings

Required: NodeviceHostPaths

Comma-separated list of paths in the test execution environment where the artifacts generated bythe customer's tests will be pulled from.

Type: Array of strings

Required: NoiosPaths

Comma-separated list of paths on the iOS device where the artifacts generated by the customer'stests will be pulled from.

Type: Array of strings

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23196

Page 209: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDevice

DeviceRepresents a device type that an app is tested against.

Contentsarn

The device's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Nocarrier

The device's carrier.

Type: String

Required: Nocpu

Information about the device's CPU.

Type: CPU (p. 194) object

Required: NofleetName

The name of the fleet to which this device belongs.

Type: String

Required: NofleetType

The type of fleet to which this device belongs. Possible values for fleet type are PRIVATE andPUBLIC.

Type: String

Required: NoformFactor

The device's form factor.

Allowed values include:• PHONE: The phone form factor.• TABLET: The tablet form factor.

Type: String

Valid Values: PHONE | TABLET

Required: No

API Version 2015-06-23197

Page 210: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

heapSize

The device's heap size, expressed in bytes.

Type: Long

Required: Noimage

The device's image name.

Type: String

Required: Noinstances

The instances belonging to this device.

Type: Array of DeviceInstance (p. 200) objects

Required: Nomanufacturer

The device's manufacturer name.

Type: String

Required: Nomemory

The device's total memory size, expressed in bytes.

Type: Long

Required: Nomodel

The device's model name.

Type: String

Required: NomodelId

The device's model ID.

Type: String

Required: Noname

The device's display name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Noos

The device's operating system type.

API Version 2015-06-23198

Page 211: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

Type: String

Required: Noplatform

The device's platform.

Allowed values include:• ANDROID: The Android platform.• IOS: The iOS platform.

Type: String

Valid Values: ANDROID | IOS

Required: Noradio

The device's radio.

Type: String

Required: NoremoteAccessEnabled

Specifies whether remote access has been enabled for the specified device.

Type: Boolean

Required: NoremoteDebugEnabled

This flag is set to true if remote debugging is enabled for the device.

Type: Boolean

Required: Noresolution

The resolution of the device.

Type: Resolution (p. 232) object

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23199

Page 212: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDeviceInstance

DeviceInstanceRepresents the device instance.

Contentsarn

The Amazon Resource Name (ARN) of the device instance.

Type: String

Length Constraints: Minimum length of 32.

Required: NodeviceArn

The Amazon Resource Name (ARN) of the device.

Type: String

Length Constraints: Minimum length of 32.

Required: NoinstanceProfile

A object containing information about the instance profile.

Type: InstanceProfile (p. 208) object

Required: Nolabels

An array of strings describing the device instance.

Type: Array of strings

Required: Nostatus

The status of the device instance. Valid values are listed below.

Type: String

Valid Values: IN_USE | PREPARING | AVAILABLE | NOT_AVAILABLE

Required: Noudid

Unique device identifier for the device instance.

Type: String

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

API Version 2015-06-23200

Page 214: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDeviceMinutes

DeviceMinutesRepresents the total (metered or unmetered) minutes used by the resource to run tests. Contains thesum of minutes consumed by all children.

Contentsmetered

When specified, represents only the sum of metered minutes used by the resource to run tests.

Type: Double

Required: Nototal

When specified, represents the total minutes used by the resource to run tests.

Type: Double

Required: Nounmetered

When specified, represents only the sum of unmetered minutes used by the resource to run tests.

Type: Double

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23202

Page 215: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDevicePool

DevicePoolRepresents a collection of device types.

Contentsarn

The device pool's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Nodescription

The device pool's description.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Noname

The device pool's name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Norules

Information about the device pool's rules.

Type: Array of Rule (p. 233) objects

Required: Notype

The device pool's type.

Allowed values include:• CURATED: A device pool that is created and managed by AWS Device Farm.• PRIVATE: A device pool that is created and managed by the device pool developer.

Type: String

Valid Values: CURATED | PRIVATE

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

API Version 2015-06-23203

Page 217: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceDevicePoolCompatibilityResult

DevicePoolCompatibilityResultRepresents a device pool compatibility result.

Contentscompatible

Whether the result was compatible with the device pool.

Type: Boolean

Required: Nodevice

The device (phone or tablet) that you wish to return information about.

Type: Device (p. 197) object

Required: NoincompatibilityMessages

Information about the compatibility.

Type: Array of IncompatibilityMessage (p. 207) objects

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23205

Page 218: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceExecutionConfiguration

ExecutionConfigurationRepresents configuration information about a test run, such as the execution timeout (in minutes).

ContentsaccountsCleanup

True if account cleanup is enabled at the beginning of the test; otherwise, false.

Type: Boolean

Required: NoappPackagesCleanup

True if app package cleanup is enabled at the beginning of the test; otherwise, false.

Type: Boolean

Required: NojobTimeoutMinutes

The number of minutes a test run will execute before it times out.

Type: Integer

Required: NoskipAppResign

When set to true, for private devices, Device Farm will not sign your app again. For public devices,Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in theAWS Device Farm FAQs.

Type: Boolean

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23206

Page 219: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceIncompatibilityMessage

IncompatibilityMessageRepresents information about incompatibility.

Contentsmessage

A message about the incompatibility.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Notype

The type of incompatibility.

Allowed values include:• ARN: The ARN.• FORM_FACTOR: The form factor (for example, phone or tablet).• MANUFACTURER: The manufacturer.• PLATFORM: The platform (for example, Android or iOS).• REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access.• APPIUM_VERSION: The Appium version for the test.

Type: String

Valid Values: ARN | PLATFORM | FORM_FACTOR | MANUFACTURER |REMOTE_ACCESS_ENABLED | REMOTE_DEBUG_ENABLED | APPIUM_VERSION | INSTANCE_ARN| INSTANCE_LABELS | FLEET_TYPE

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23207

Page 220: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceInstanceProfile

InstanceProfileRepresents the instance profile.

Contentsarn

The Amazon Resource Name (ARN) of the instance profile.

Type: String

Length Constraints: Minimum length of 32.

Required: Nodescription

The description of the instance profile.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: NoexcludeAppPackagesFromCleanup

An array of strings specifying the list of app packages that should not be cleaned up from the deviceafter a test run is over.

The list of packages is only considered if you set packageCleanup to true.

Type: Array of strings

Required: Noname

The name of the instance profile.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: NopackageCleanup

When set to true, Device Farm will remove app packages after a test run. The default value isfalse for private devices.

Type: Boolean

Required: NorebootAfterUse

When set to true, Device Farm will reboot the instance after a test run. The default value is true.

Type: Boolean

Required: No

API Version 2015-06-23208

Page 221: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23209

Page 222: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceJob

JobRepresents a device.

Contentsarn

The job's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Nocounters

The job's result counters.

Type: Counters (p. 192) object

Required: Nocreated

When the job was created.

Type: Timestamp

Required: Nodevice

The device (phone or tablet).

Type: Device (p. 197) object

Required: NodeviceMinutes

Represents the total (metered or unmetered) minutes used by the job.

Type: DeviceMinutes (p. 202) object

Required: NoinstanceArn

The Amazon Resource Name (ARN) of the instance.

Type: String

Length Constraints: Minimum length of 32.

Required: Nomessage

A message about the job's result.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

API Version 2015-06-23210

Page 223: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

Required: Noname

The job's name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Noresult

The job's result.

Allowed values include:• PENDING: A pending condition.• PASSED: A passing condition.• WARNED: A warning condition.• FAILED: A failed condition.• SKIPPED: A skipped condition.• ERRORED: An error condition.• STOPPED: A stopped condition.

Type: String

Valid Values: PENDING | PASSED | WARNED | FAILED | SKIPPED | ERRORED | STOPPED

Required: Nostarted

The job's start time.

Type: Timestamp

Required: Nostatus

The job's status.

Allowed values include:• PENDING: A pending status.• PENDING_CONCURRENCY: A pending concurrency status.• PENDING_DEVICE: A pending device status.• PROCESSING: A processing status.• SCHEDULING: A scheduling status.• PREPARING: A preparing status.• RUNNING: A running status.• COMPLETED: A completed status.• STOPPING: A stopping status.

Type: String

Valid Values: PENDING | PENDING_CONCURRENCY | PENDING_DEVICE | PROCESSING |SCHEDULING | PREPARING | RUNNING | COMPLETED | STOPPING

API Version 2015-06-23211

Page 224: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

Required: Nostopped

The job's stop time.

Type: Timestamp

Required: Notype

The job's type.

Allowed values include the following:• BUILTIN_FUZZ: The built-in fuzz type.• BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting

with it and capturing screenshots at the same time.• APPIUM_JAVA_JUNIT: The Appium Java JUnit type.• APPIUM_JAVA_TESTNG: The Appium Java TestNG type.• APPIUM_PYTHON: The Appium Python type.• APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.• APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.• APPIUM_WEB_PYTHON: The Appium Python type for Web apps.• CALABASH: The Calabash type.• INSTRUMENTATION: The Instrumentation type.• UIAUTOMATION: The uiautomation type.• UIAUTOMATOR: The uiautomator type.• XCTEST: The XCode test type.• XCTEST_UI: The XCode UI test type.

Type: String

Valid Values: BUILTIN_FUZZ | BUILTIN_EXPLORER | WEB_PERFORMANCE_PROFILE| APPIUM_JAVA_JUNIT | APPIUM_JAVA_TESTNG | APPIUM_PYTHON |APPIUM_WEB_JAVA_JUNIT | APPIUM_WEB_JAVA_TESTNG | APPIUM_WEB_PYTHON |CALABASH | INSTRUMENTATION | UIAUTOMATION | UIAUTOMATOR | XCTEST | XCTEST_UI| REMOTE_ACCESS_RECORD | REMOTE_ACCESS_REPLAY

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23212

Page 225: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceLocation

LocationRepresents a latitude and longitude pair, expressed in geographic coordinate system degrees (forexample 47.6204, -122.3491).

Elevation is currently not supported.

Contentslatitude

The latitude.

Type: Double

Required: Yeslongitude

The longitude.

Type: Double

Required: Yes

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23213

Page 226: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceMonetaryAmount

MonetaryAmountA number representing the monetary amount for an offering or transaction.

Contentsamount

The numerical amount of an offering or transaction.

Type: Double

Required: NocurrencyCode

The currency code of a monetary amount. For example, USD means "U.S. dollars."

Type: String

Valid Values: USD

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23214

Page 227: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceNetworkProfile

NetworkProfileAn array of settings that describes characteristics of a network profile.

Contentsarn

The Amazon Resource Name (ARN) of the network profile.

Type: String

Length Constraints: Minimum length of 32.

Required: Nodescription

The description of the network profile.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: NodownlinkBandwidthBits

The data throughput rate in bits per second, as an integer from 0 to 104857600.

Type: Long

Required: NodownlinkDelayMs

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

Type: Long

Required: NodownlinkJitterMs

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

Type: Long

Required: NodownlinkLossPercent

Proportion of received packets that fail to arrive from 0 to 100 percent.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 100.

Required: Noname

The name of the network profile.

API Version 2015-06-23215

Page 228: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Notype

The type of network profile. Valid values are listed below.

Type: String

Valid Values: CURATED | PRIVATE

Required: NouplinkBandwidthBits

The data throughput rate in bits per second, as an integer from 0 to 104857600.

Type: Long

Required: NouplinkDelayMs

Delay time for all packets to destination in milliseconds as an integer from 0 to 2000.

Type: Long

Required: NouplinkJitterMs

Time variation in the delay of received packets in milliseconds as an integer from 0 to 2000.

Type: Long

Required: NouplinkLossPercent

Proportion of transmitted packets that fail to arrive from 0 to 100 percent.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 100.

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23216

Page 229: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceOffering

OfferingRepresents the metadata of a device offering.

Contentsdescription

A string describing the offering.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Noid

The ID that corresponds to a device offering.

Type: String

Length Constraints: Minimum length of 32.

Required: Noplatform

The platform of the device (e.g., ANDROID or IOS).

Type: String

Valid Values: ANDROID | IOS

Required: NorecurringCharges

Specifies whether there are recurring charges for the offering.

Type: Array of RecurringCharge (p. 227) objects

Required: Notype

The type of offering (e.g., "RECURRING") for a device.

Type: String

Valid Values: RECURRING

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go

API Version 2015-06-23217

Page 230: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23218

Page 231: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceOfferingPromotion

OfferingPromotionRepresents information about an offering promotion.

Contentsdescription

A string describing the offering promotion.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Noid

The ID of the offering promotion.

Type: String

Length Constraints: Minimum length of 4.

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23219

Page 232: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceOfferingStatus

OfferingStatusThe status of the offering.

ContentseffectiveOn

The date on which the offering is effective.

Type: Timestamp

Required: Nooffering

Represents the metadata of an offering status.

Type: Offering (p. 217) object

Required: Noquantity

The number of available devices in the offering.

Type: Integer

Required: Notype

The type specified for the offering status.

Type: String

Valid Values: PURCHASE | RENEW | SYSTEM

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23220

Page 233: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceOfferingTransaction

OfferingTransactionRepresents the metadata of an offering transaction.

Contentscost

The cost of an offering transaction.

Type: MonetaryAmount (p. 214) object

Required: NocreatedOn

The date on which an offering transaction was created.

Type: Timestamp

Required: NoofferingPromotionId

The ID that corresponds to a device offering promotion.

Type: String

Length Constraints: Minimum length of 4.

Required: NoofferingStatus

The status of an offering transaction.

Type: OfferingStatus (p. 220) object

Required: NotransactionId

The transaction ID of the offering transaction.

Type: String

Length Constraints: Minimum length of 32.

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23221

Page 234: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceProblem

ProblemRepresents a specific warning or failure.

Contentsdevice

Information about the associated device.

Type: Device (p. 197) object

Required: Nojob

Information about the associated job.

Type: ProblemDetail (p. 224) object

Required: Nomessage

A message about the problem's result.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Noresult

The problem's result.

Allowed values include:• PENDING: A pending condition.• PASSED: A passing condition.• WARNED: A warning condition.• FAILED: A failed condition.• SKIPPED: A skipped condition.• ERRORED: An error condition.• STOPPED: A stopped condition.

Type: String

Valid Values: PENDING | PASSED | WARNED | FAILED | SKIPPED | ERRORED | STOPPED

Required: Norun

Information about the associated run.

Type: ProblemDetail (p. 224) object

Required: Nosuite

Information about the associated suite.

API Version 2015-06-23222

Page 235: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

Type: ProblemDetail (p. 224) object

Required: Notest

Information about the associated test.

Type: ProblemDetail (p. 224) object

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23223

Page 236: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceProblemDetail

ProblemDetailInformation about a problem detail.

Contentsarn

The problem detail's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Noname

The problem detail's name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23224

Page 237: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceProject

ProjectRepresents an operating-system neutral workspace for running and managing tests.

Contentsarn

The project's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Nocreated

When the project was created.

Type: Timestamp

Required: NodefaultJobTimeoutMinutes

The default number of minutes (at the project level) a test run will execute before it times out.Default value is 60 minutes.

Type: Integer

Required: Noname

The project's name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23225

Page 238: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceRadios

RadiosRepresents the set of radios and their states on a device. Examples of radios include Wi-Fi, GPS,Bluetooth, and NFC.

Contentsbluetooth

True if Bluetooth is enabled at the beginning of the test; otherwise, false.

Type: Boolean

Required: Nogps

True if GPS is enabled at the beginning of the test; otherwise, false.

Type: Boolean

Required: Nonfc

True if NFC is enabled at the beginning of the test; otherwise, false.

Type: Boolean

Required: Nowifi

True if Wi-Fi is enabled at the beginning of the test; otherwise, false.

Type: Boolean

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23226

Page 239: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceRecurringCharge

RecurringChargeSpecifies whether charges for devices will be recurring.

Contentscost

The cost of the recurring charge.

Type: MonetaryAmount (p. 214) object

Required: Nofrequency

The frequency in which charges will recur.

Type: String

Valid Values: MONTHLY

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23227

Page 240: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceRemoteAccessSession

RemoteAccessSessionRepresents information about the remote access session.

Contentsarn

The Amazon Resource Name (ARN) of the remote access session.

Type: String

Length Constraints: Minimum length of 32.

Required: NobillingMethod

The billing method of the remote access session. Possible values include METERED or UNMETERED.For more information about metered devices, see AWS Device Farm terminology."

Type: String

Valid Values: METERED | UNMETERED

Required: NoclientId

Unique identifier of your client for the remote access session. Only returned if remote debugging isenabled for the remote access session.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 64.

Required: Nocreated

The date and time the remote access session was created.

Type: Timestamp

Required: Nodevice

The device (phone or tablet) used in the remote access session.

Type: Device (p. 197) object

Required: NodeviceMinutes

The number of minutes a device is used in a remote access sesssion (including setup and teardownminutes).

Type: DeviceMinutes (p. 202) object

Required: No

API Version 2015-06-23228

Page 241: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

deviceUdid

Unique device identifier for the remote device. Only returned if remote debugging is enabled for theremote access session.

Type: String

Required: Noendpoint

The endpoint for the remote access sesssion.

Type: String

Required: NohostAddress

IP address of the EC2 host where you need to connect to remotely debug devices. Only returned ifremote debugging is enabled for the remote access session.

Type: String

Length Constraints: Maximum length of 1024.

Required: NoinstanceArn

The Amazon Resource Name (ARN) of the instance.

Type: String

Length Constraints: Minimum length of 32.

Required: NointeractionMode

The interaction mode of the remote access session. Valid values are:• INTERACTIVE: You can interact with the iOS device by viewing, touching, and rotating the screen.

You cannot run XCUITest framework-based tests in this mode.• NO_VIDEO: You are connected to the device but cannot interact with it or view the screen. This

mode has the fastest test execution speed. You can run XCUITest framework-based tests in thismode.

• VIDEO_ONLY: You can view the screen but cannot touch or rotate it. You can run XCUITestframework-based tests and watch the screen in this mode.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 64.

Valid Values: INTERACTIVE | NO_VIDEO | VIDEO_ONLY

Required: Nomessage

A message about the remote access session.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

API Version 2015-06-23229

Page 242: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

Required: Noname

The name of the remote access session.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: NoremoteDebugEnabled

This flag is set to true if remote debugging is enabled for the remote access session.

Type: Boolean

Required: NoremoteRecordAppArn

The Amazon Resource Name (ARN) for the app to be recorded in the remote access session.

Type: String

Length Constraints: Minimum length of 32.

Required: NoremoteRecordEnabled

This flag is set to true if remote recording is enabled for the remote access session.

Type: Boolean

Required: Noresult

The result of the remote access session. Can be any of the following:• PENDING: A pending condition.• PASSED: A passing condition.• WARNED: A warning condition.• FAILED: A failed condition.• SKIPPED: A skipped condition.• ERRORED: An error condition.• STOPPED: A stopped condition.

Type: String

Valid Values: PENDING | PASSED | WARNED | FAILED | SKIPPED | ERRORED | STOPPED

Required: NoskipAppResign

When set to true, for private devices, Device Farm will not sign your app again. For public devices,Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in theAWS Device Farm FAQs.

Type: Boolean

API Version 2015-06-23230

Page 243: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

Required: Nostarted

The date and time the remote access session was started.

Type: Timestamp

Required: Nostatus

The status of the remote access session. Can be any of the following:• PENDING: A pending status.• PENDING_CONCURRENCY: A pending concurrency status.• PENDING_DEVICE: A pending device status.• PROCESSING: A processing status.• SCHEDULING: A scheduling status.• PREPARING: A preparing status.• RUNNING: A running status.• COMPLETED: A completed status.• STOPPING: A stopping status.

Type: String

Valid Values: PENDING | PENDING_CONCURRENCY | PENDING_DEVICE | PROCESSING |SCHEDULING | PREPARING | RUNNING | COMPLETED | STOPPING

Required: Nostopped

The date and time the remote access session was stopped.

Type: Timestamp

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23231

Page 244: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceResolution

ResolutionRepresents the screen resolution of a device in height and width, expressed in pixels.

Contentsheight

The screen resolution's height, expressed in pixels.

Type: Integer

Required: Nowidth

The screen resolution's width, expressed in pixels.

Type: Integer

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23232

Page 245: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceRule

RuleRepresents a condition for a device pool.

Contentsattribute

The rule's stringified attribute. For example, specify the value as "\"abc\"".

Allowed values include:• ARN: The ARN.• FORM_FACTOR: The form factor (for example, phone or tablet).• MANUFACTURER: The manufacturer.• PLATFORM: The platform (for example, Android or iOS).• REMOTE_ACCESS_ENABLED: Whether the device is enabled for remote access.• APPIUM_VERSION: The Appium version for the test.• INSTANCE_ARN: The Amazon Resource Name (ARN) of the device instance.• INSTANCE_LABELS: The label of the device instance.

Type: String

Valid Values: ARN | PLATFORM | FORM_FACTOR | MANUFACTURER |REMOTE_ACCESS_ENABLED | REMOTE_DEBUG_ENABLED | APPIUM_VERSION | INSTANCE_ARN| INSTANCE_LABELS | FLEET_TYPE

Required: Nooperator

The rule's operator.• EQUALS: The equals operator.• GREATER_THAN: The greater-than operator.• IN: The in operator.• LESS_THAN: The less-than operator.• NOT_IN: The not-in operator.• CONTAINS: The contains operator.

Type: String

Valid Values: EQUALS | LESS_THAN | GREATER_THAN | IN | NOT_IN | CONTAINS

Required: Novalue

The rule's value.

Type: String

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

API Version 2015-06-23233

Page 247: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceRun

RunRepresents a test run on a set of devices with a given app package, test parameters, etc.

ContentsappUpload

An app to upload or that has been uploaded.

Type: String

Length Constraints: Minimum length of 32.

Required: Noarn

The run's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: NobillingMethod

Specifies the billing method for a test run: metered or unmetered. If the parameter is not specified,the default value is metered.

Type: String

Valid Values: METERED | UNMETERED

Required: NocompletedJobs

The total number of completed jobs.

Type: Integer

Required: Nocounters

The run's result counters.

Type: Counters (p. 192) object

Required: Nocreated

When the run was created.

Type: Timestamp

Required: NocustomerArtifactPaths

Output CustomerArtifactPaths object for the test run.

API Version 2015-06-23235

Page 248: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

Type: CustomerArtifactPaths (p. 196) object

Required: NodeviceMinutes

Represents the total (metered or unmetered) minutes used by the test run.

Type: DeviceMinutes (p. 202) object

Required: NodevicePoolArn

The ARN of the device pool for the run.

Type: String

Length Constraints: Minimum length of 32.

Required: NoeventCount

For fuzz tests, this is the number of events, between 1 and 10000, that the UI fuzz test shouldperform.

Type: Integer

Required: NojobTimeoutMinutes

The number of minutes the job will execute before it times out.

Type: Integer

Required: Nolocale

Information about the locale that is used for the run.

Type: String

Required: Nolocation

Information about the location that is used for the run.

Type: Location (p. 213) object

Required: Nomessage

A message about the run's result.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Noname

The run's name.

API Version 2015-06-23236

Page 249: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: NonetworkProfile

The network profile being used for a test run.

Type: NetworkProfile (p. 215) object

Required: NoparsingResultUrl

Read-only URL for an object in S3 bucket where you can get the parsing results of the test package.If the test package doesn't parse, the reason why it doesn't parse appears in the file that this URLpoints to.

Type: String

Required: Noplatform

The run's platform.

Allowed values include:• ANDROID: The Android platform.• IOS: The iOS platform.

Type: String

Valid Values: ANDROID | IOS

Required: Noradios

Information about the radio states for the run.

Type: Radios (p. 226) object

Required: Noresult

The run's result.

Allowed values include:• PENDING: A pending condition.• PASSED: A passing condition.• WARNED: A warning condition.• FAILED: A failed condition.• SKIPPED: A skipped condition.• ERRORED: An error condition.• STOPPED: A stopped condition.

Type: String

Valid Values: PENDING | PASSED | WARNED | FAILED | SKIPPED | ERRORED | STOPPED

API Version 2015-06-23237

Page 250: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

Required: NoresultCode

Supporting field for the result field. Set only if result is SKIPPED. PARSING_FAILED if the result isskipped because of test package parsing failure.

Type: String

Valid Values: PARSING_FAILED | VPC_ENDPOINT_SETUP_FAILED

Required: Noseed

For fuzz tests, this is a seed to use for randomizing the UI fuzz test. Using the same seed valuebetween tests ensures identical event sequences.

Type: Integer

Required: NoskipAppResign

When set to true, for private devices, Device Farm will not sign your app again. For public devices,Device Farm always signs your apps again and this parameter has no effect.

For more information about how Device Farm re-signs your app(s), see Do you modify my app? in theAWS Device Farm FAQs.

Type: Boolean

Required: Nostarted

The run's start time.

Type: Timestamp

Required: Nostatus

The run's status.

Allowed values include:• PENDING: A pending status.• PENDING_CONCURRENCY: A pending concurrency status.• PENDING_DEVICE: A pending device status.• PROCESSING: A processing status.• SCHEDULING: A scheduling status.• PREPARING: A preparing status.• RUNNING: A running status.• COMPLETED: A completed status.• STOPPING: A stopping status.

Type: String

Valid Values: PENDING | PENDING_CONCURRENCY | PENDING_DEVICE | PROCESSING |SCHEDULING | PREPARING | RUNNING | COMPLETED | STOPPING

Required: No

API Version 2015-06-23238

Page 251: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

stopped

The run's stop time.

Type: Timestamp

Required: NototalJobs

The total number of jobs for the run.

Type: Integer

Required: Notype

The run's type.

Must be one of the following values:• BUILTIN_FUZZ: The built-in fuzz type.• BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting

with it and capturing screenshots at the same time.• APPIUM_JAVA_JUNIT: The Appium Java JUnit type.• APPIUM_JAVA_TESTNG: The Appium Java TestNG type.• APPIUM_PYTHON: The Appium Python type.• APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.• APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.• APPIUM_WEB_PYTHON: The Appium Python type for Web apps.• CALABASH: The Calabash type.• INSTRUMENTATION: The Instrumentation type.• UIAUTOMATION: The uiautomation type.• UIAUTOMATOR: The uiautomator type.• XCTEST: The XCode test type.• XCTEST_UI: The XCode UI test type.

Type: String

Valid Values: BUILTIN_FUZZ | BUILTIN_EXPLORER | WEB_PERFORMANCE_PROFILE| APPIUM_JAVA_JUNIT | APPIUM_JAVA_TESTNG | APPIUM_PYTHON |APPIUM_WEB_JAVA_JUNIT | APPIUM_WEB_JAVA_TESTNG | APPIUM_WEB_PYTHON |CALABASH | INSTRUMENTATION | UIAUTOMATION | UIAUTOMATOR | XCTEST | XCTEST_UI| REMOTE_ACCESS_RECORD | REMOTE_ACCESS_REPLAY

Required: NowebUrl

The Device Farm console URL for the recording of the run.

Type: String

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

API Version 2015-06-23239

Page 253: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSample

SampleRepresents a sample of performance data.

Contentsarn

The sample's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Notype

The sample's type.

Must be one of the following values:• CPU: A CPU sample type. This is expressed as the app processing CPU time (including child

processes) as reported by process, as a percentage.• MEMORY: A memory usage sample type. This is expressed as the total proportional set size of an

app process, in kilobytes.• NATIVE_AVG_DRAWTIME• NATIVE_FPS• NATIVE_FRAMES• NATIVE_MAX_DRAWTIME• NATIVE_MIN_DRAWTIME• OPENGL_AVG_DRAWTIME• OPENGL_FPS• OPENGL_FRAMES• OPENGL_MAX_DRAWTIME• OPENGL_MIN_DRAWTIME• RX• RX_RATE: The total number of bytes per second (TCP and UDP) that are sent, by app process.• THREADS: A threads sample type. This is expressed as the total number of threads per app

process.• TX• TX_RATE: The total number of bytes per second (TCP and UDP) that are received, by app process.

Type: String

Valid Values: CPU | MEMORY | THREADS | RX_RATE | TX_RATE | RX | TX |NATIVE_FRAMES | NATIVE_FPS | NATIVE_MIN_DRAWTIME | NATIVE_AVG_DRAWTIME |NATIVE_MAX_DRAWTIME | OPENGL_FRAMES | OPENGL_FPS | OPENGL_MIN_DRAWTIME |OPENGL_AVG_DRAWTIME | OPENGL_MAX_DRAWTIME

Required: Nourl

The pre-signed Amazon S3 URL that can be used with a corresponding GET request to download thesample's file.

API Version 2015-06-23241

Page 254: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23242

Page 255: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceScheduleRunConfiguration

ScheduleRunConfigurationRepresents the settings for a run. Includes things like location, radio states, auxiliary apps, and networkprofiles.

ContentsauxiliaryApps

A list of auxiliary apps for the run.

Type: Array of strings

Length Constraints: Minimum length of 32.

Required: NobillingMethod

Specifies the billing method for a test run: metered or unmetered. If the parameter is not specified,the default value is metered.

Type: String

Valid Values: METERED | UNMETERED

Required: NocustomerArtifactPaths

Input CustomerArtifactPaths object for the scheduled run configuration.

Type: CustomerArtifactPaths (p. 196) object

Required: NoextraDataPackageArn

The ARN of the extra data for the run. The extra data is a .zip file that AWS Device Farm will extractto external data for Android or the app's sandbox for iOS.

Type: String

Length Constraints: Minimum length of 32.

Required: Nolocale

Information about the locale that is used for the run.

Type: String

Required: Nolocation

Information about the location that is used for the run.

Type: Location (p. 213) object

Required: No

API Version 2015-06-23243

Page 256: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

networkProfileArn

Reserved for internal use.

Type: String

Length Constraints: Minimum length of 32.

Required: Noradios

Information about the radio states for the run.

Type: Radios (p. 226) object

Required: NovpceConfigurationArns

An array of Amazon Resource Names (ARNs) for your VPC endpoint configurations.

Type: Array of strings

Length Constraints: Minimum length of 32.

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23244

Page 257: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceScheduleRunTest

ScheduleRunTestRepresents additional test settings.

Contentsfilter

The test's filter.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 8192.

Required: Noparameters

The test's parameters, such as the following test framework parameters and fixture settings:

For Calabash tests:• profile: A cucumber profile, for example, "my_profile_name".• tags: You can limit execution to features or scenarios that have (or don't have) certain tags, for

example, "@smoke" or "@smoke,~@wip".

For Appium tests (all types):• appium_version: The Appium version. Currently supported values are "1.4.16", "1.6.3", "latest", and

"default".• “latest” will run the latest Appium version supported by Device Farm (1.6.3).• For “default”, Device Farm will choose a compatible version of Appium for the device. The

current behavior is to run 1.4.16 on Android devices and iOS 9 and earlier, 1.6.3 for iOS 10 andlater.

• This behavior is subject to change.

For Fuzz tests (Android only):• event_count: The number of events, between 1 and 10000, that the UI fuzz test should perform.• throttle: The time, in ms, between 0 and 1000, that the UI fuzz test should wait between events.• seed: A seed to use for randomizing the UI fuzz test. Using the same seed value between tests

ensures identical event sequences.

For Explorer tests:• username: A username to use if the Explorer encounters a login form. If not supplied, no username

will be inserted.• password: A password to use if the Explorer encounters a login form. If not supplied, no password

will be inserted.

For Instrumentation:• filter: A test filter string. Examples:

• Running a single test case: "com.android.abc.Test1"• Running a single test: "com.android.abc.Test1#smoke"• Running multiple tests: "com.android.abc.Test1,com.android.abc.Test2"

For XCTest and XCTestUI:• filter: A test filter string. Examples:

API Version 2015-06-23245

Page 258: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

• Running a single test class: "LoginTests"• Running a multiple test classes: "LoginTests,SmokeTests"• Running a single test: "LoginTests/testValid"• Running multiple tests: "LoginTests/testValid,LoginTests/testInvalid"

For UIAutomator:• filter: A test filter string. Examples:

• Running a single test case: "com.android.abc.Test1"• Running a single test: "com.android.abc.Test1#smoke"• Running multiple tests: "com.android.abc.Test1,com.android.abc.Test2"

Type: String to string map

Required: NotestPackageArn

The ARN of the uploaded test that will be run.

Type: String

Length Constraints: Minimum length of 32.

Required: Notype

The test's type.

Must be one of the following values:• BUILTIN_FUZZ: The built-in fuzz type.• BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interacting

with it and capturing screenshots at the same time.• APPIUM_JAVA_JUNIT: The Appium Java JUnit type.• APPIUM_JAVA_TESTNG: The Appium Java TestNG type.• APPIUM_PYTHON: The Appium Python type.• APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.• APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.• APPIUM_WEB_PYTHON: The Appium Python type for Web apps.• CALABASH: The Calabash type.• INSTRUMENTATION: The Instrumentation type.• UIAUTOMATION: The uiautomation type.• UIAUTOMATOR: The uiautomator type.• XCTEST: The XCode test type.• XCTEST_UI: The XCode UI test type.

Type: String

Valid Values: BUILTIN_FUZZ | BUILTIN_EXPLORER | WEB_PERFORMANCE_PROFILE| APPIUM_JAVA_JUNIT | APPIUM_JAVA_TESTNG | APPIUM_PYTHON |APPIUM_WEB_JAVA_JUNIT | APPIUM_WEB_JAVA_TESTNG | APPIUM_WEB_PYTHON |CALABASH | INSTRUMENTATION | UIAUTOMATION | UIAUTOMATOR | XCTEST | XCTEST_UI| REMOTE_ACCESS_RECORD | REMOTE_ACCESS_REPLAY

Required: Yes

API Version 2015-06-23246

Page 259: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23247

Page 260: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSuite

SuiteRepresents a collection of one or more tests.

Contentsarn

The suite's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Nocounters

The suite's result counters.

Type: Counters (p. 192) object

Required: Nocreated

When the suite was created.

Type: Timestamp

Required: NodeviceMinutes

Represents the total (metered or unmetered) minutes used by the test suite.

Type: DeviceMinutes (p. 202) object

Required: Nomessage

A message about the suite's result.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Noname

The suite's name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Noresult

The suite's result.

API Version 2015-06-23248

Page 261: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

Allowed values include:• PENDING: A pending condition.• PASSED: A passing condition.• WARNED: A warning condition.• FAILED: A failed condition.• SKIPPED: A skipped condition.• ERRORED: An error condition.• STOPPED: A stopped condition.

Type: String

Valid Values: PENDING | PASSED | WARNED | FAILED | SKIPPED | ERRORED | STOPPED

Required: Nostarted

The suite's start time.

Type: Timestamp

Required: Nostatus

The suite's status.

Allowed values include:• PENDING: A pending status.• PENDING_CONCURRENCY: A pending concurrency status.• PENDING_DEVICE: A pending device status.• PROCESSING: A processing status.• SCHEDULING: A scheduling status.• PREPARING: A preparing status.• RUNNING: A running status.• COMPLETED: A completed status.• STOPPING: A stopping status.

Type: String

Valid Values: PENDING | PENDING_CONCURRENCY | PENDING_DEVICE | PROCESSING |SCHEDULING | PREPARING | RUNNING | COMPLETED | STOPPING

Required: Nostopped

The suite's stop time.

Type: Timestamp

Required: Notype

The suite's type.

Must be one of the following values:• BUILTIN_FUZZ: The built-in fuzz type.

API Version 2015-06-23249

Page 262: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

• BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interactingwith it and capturing screenshots at the same time.

• APPIUM_JAVA_JUNIT: The Appium Java JUnit type.• APPIUM_JAVA_TESTNG: The Appium Java TestNG type.• APPIUM_PYTHON: The Appium Python type.• APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.• APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.• APPIUM_WEB_PYTHON: The Appium Python type for Web apps.• CALABASH: The Calabash type.• INSTRUMENTATION: The Instrumentation type.• UIAUTOMATION: The uiautomation type.• UIAUTOMATOR: The uiautomator type.• XCTEST: The XCode test type.• XCTEST_UI: The XCode UI test type.

Type: String

Valid Values: BUILTIN_FUZZ | BUILTIN_EXPLORER | WEB_PERFORMANCE_PROFILE| APPIUM_JAVA_JUNIT | APPIUM_JAVA_TESTNG | APPIUM_PYTHON |APPIUM_WEB_JAVA_JUNIT | APPIUM_WEB_JAVA_TESTNG | APPIUM_WEB_PYTHON |CALABASH | INSTRUMENTATION | UIAUTOMATION | UIAUTOMATOR | XCTEST | XCTEST_UI| REMOTE_ACCESS_RECORD | REMOTE_ACCESS_REPLAY

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23250

Page 263: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceTest

TestRepresents a condition that is evaluated.

Contentsarn

The test's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: Nocounters

The test's result counters.

Type: Counters (p. 192) object

Required: Nocreated

When the test was created.

Type: Timestamp

Required: NodeviceMinutes

Represents the total (metered or unmetered) minutes used by the test.

Type: DeviceMinutes (p. 202) object

Required: Nomessage

A message about the test's result.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Noname

The test's name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: Noresult

The test's result.

API Version 2015-06-23251

Page 264: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

Allowed values include:• PENDING: A pending condition.• PASSED: A passing condition.• WARNED: A warning condition.• FAILED: A failed condition.• SKIPPED: A skipped condition.• ERRORED: An error condition.• STOPPED: A stopped condition.

Type: String

Valid Values: PENDING | PASSED | WARNED | FAILED | SKIPPED | ERRORED | STOPPED

Required: Nostarted

The test's start time.

Type: Timestamp

Required: Nostatus

The test's status.

Allowed values include:• PENDING: A pending status.• PENDING_CONCURRENCY: A pending concurrency status.• PENDING_DEVICE: A pending device status.• PROCESSING: A processing status.• SCHEDULING: A scheduling status.• PREPARING: A preparing status.• RUNNING: A running status.• COMPLETED: A completed status.• STOPPING: A stopping status.

Type: String

Valid Values: PENDING | PENDING_CONCURRENCY | PENDING_DEVICE | PROCESSING |SCHEDULING | PREPARING | RUNNING | COMPLETED | STOPPING

Required: Nostopped

The test's stop time.

Type: Timestamp

Required: Notype

The test's type.

Must be one of the following values:• BUILTIN_FUZZ: The built-in fuzz type.

API Version 2015-06-23252

Page 265: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

• BUILTIN_EXPLORER: For Android, an app explorer that will traverse an Android app, interactingwith it and capturing screenshots at the same time.

• APPIUM_JAVA_JUNIT: The Appium Java JUnit type.• APPIUM_JAVA_TESTNG: The Appium Java TestNG type.• APPIUM_PYTHON: The Appium Python type.• APPIUM_WEB_JAVA_JUNIT: The Appium Java JUnit type for Web apps.• APPIUM_WEB_JAVA_TESTNG: The Appium Java TestNG type for Web apps.• APPIUM_WEB_PYTHON: The Appium Python type for Web apps.• CALABASH: The Calabash type.• INSTRUMENTATION: The Instrumentation type.• UIAUTOMATION: The uiautomation type.• UIAUTOMATOR: The uiautomator type.• XCTEST: The XCode test type.• XCTEST_UI: The XCode UI test type.

Type: String

Valid Values: BUILTIN_FUZZ | BUILTIN_EXPLORER | WEB_PERFORMANCE_PROFILE| APPIUM_JAVA_JUNIT | APPIUM_JAVA_TESTNG | APPIUM_PYTHON |APPIUM_WEB_JAVA_JUNIT | APPIUM_WEB_JAVA_TESTNG | APPIUM_WEB_PYTHON |CALABASH | INSTRUMENTATION | UIAUTOMATION | UIAUTOMATOR | XCTEST | XCTEST_UI| REMOTE_ACCESS_RECORD | REMOTE_ACCESS_REPLAY

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23253

Page 266: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceTrialMinutes

TrialMinutesRepresents information about free trial device minutes for an AWS account.

Contentsremaining

The number of free trial minutes remaining in the account.

Type: Double

Required: Nototal

The total number of free trial minutes that the account started with.

Type: Double

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23254

Page 267: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceUniqueProblem

UniqueProblemA collection of one or more problems, grouped by their result.

Contentsmessage

A message about the unique problems' result.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Noproblems

Information about the problems.

Type: Array of Problem (p. 222) objects

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23255

Page 268: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceUpload

UploadAn app or a set of one or more tests to upload or that have been uploaded.

Contentsarn

The upload's ARN.

Type: String

Length Constraints: Minimum length of 32.

Required: NocontentType

The upload's content type (for example, "application/octet-stream").

Type: String

Length Constraints: Minimum length of 0. Maximum length of 64.

Required: Nocreated

When the upload was created.

Type: Timestamp

Required: Nomessage

A message about the upload's result.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 16384.

Required: Nometadata

The upload's metadata. For example, for Android, this contains information that is parsed from themanifest and is displayed in the AWS Device Farm console after the associated app is uploaded.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 8192.

Required: Noname

The upload's file name.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

Required: No

API Version 2015-06-23256

Page 269: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceContents

status

The upload's status.

Must be one of the following values:• FAILED: A failed status.• INITIALIZED: An initialized status.• PROCESSING: A processing status.• SUCCEEDED: A succeeded status.

Type: String

Valid Values: INITIALIZED | PROCESSING | SUCCEEDED | FAILED

Required: Notype

The upload's type.

Must be one of the following values:• ANDROID_APP: An Android upload.• IOS_APP: An iOS upload.• WEB_APP: A web appliction upload.• EXTERNAL_DATA: An external data upload.• APPIUM_JAVA_JUNIT_TEST_PACKAGE: An Appium Java JUnit test package upload.• APPIUM_JAVA_TESTNG_TEST_PACKAGE: An Appium Java TestNG test package upload.• APPIUM_PYTHON_TEST_PACKAGE: An Appium Python test package upload.• APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE: An Appium Java JUnit test package upload.• APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE: An Appium Java TestNG test package upload.• APPIUM_WEB_PYTHON_TEST_PACKAGE: An Appium Python test package upload.• CALABASH_TEST_PACKAGE: A Calabash test package upload.• INSTRUMENTATION_TEST_PACKAGE: An instrumentation upload.• UIAUTOMATION_TEST_PACKAGE: A uiautomation test package upload.• UIAUTOMATOR_TEST_PACKAGE: A uiautomator test package upload.• XCTEST_TEST_PACKAGE: An XCode test package upload.• XCTEST_UI_TEST_PACKAGE: An XCode UI test package upload.

Type: String

Valid Values: ANDROID_APP | IOS_APP | WEB_APP | EXTERNAL_DATA |APPIUM_JAVA_JUNIT_TEST_PACKAGE | APPIUM_JAVA_TESTNG_TEST_PACKAGE |APPIUM_PYTHON_TEST_PACKAGE | APPIUM_WEB_JAVA_JUNIT_TEST_PACKAGE |APPIUM_WEB_JAVA_TESTNG_TEST_PACKAGE | APPIUM_WEB_PYTHON_TEST_PACKAGE| CALABASH_TEST_PACKAGE | INSTRUMENTATION_TEST_PACKAGE |UIAUTOMATION_TEST_PACKAGE | UIAUTOMATOR_TEST_PACKAGE | XCTEST_TEST_PACKAGE |XCTEST_UI_TEST_PACKAGE

Required: Nourl

The pre-signed Amazon S3 URL that was used to store a file through a corresponding PUT request.

Type: String

API Version 2015-06-23257

Page 270: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceSee Also

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2

API Version 2015-06-23258

Page 271: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API ReferenceVPCEConfiguration

VPCEConfigurationRepresents an Amazon Virtual Private Cloud (VPC) endpoint configuration.

Contentsarn

The Amazon Resource Name (ARN) of the VPC endpoint configuration.

Type: String

Length Constraints: Minimum length of 32.

Required: NoserviceDnsName

The DNS name that maps to the private IP address of the service you want to access.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: NovpceConfigurationDescription

An optional description, providing more details about your VPC endpoint configuration.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: NovpceConfigurationName

The friendly name you give to your VPC endpoint configuration, to manage your configurationsmore easily.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 1024.

Required: NovpceServiceName

The name of the VPC endpoint service running inside your AWS account that you want Device Farmto test.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: No

See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:

API Version 2015-06-23259

Page 273: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

Common ParametersThe following list contains the parameters that all actions use for signing Signature Version 4 requestswith a query string. Any action-specific parameters are listed in the topic for that action. For moreinformation about Signature Version 4, see Signature Version 4 Signing Process in the Amazon WebServices General Reference.

Action

The action to be performed.

Type: string

Required: YesVersion

The API version that the request is written for, expressed in the format YYYY-MM-DD.

Type: string

Required: YesX-Amz-Algorithm

The hash algorithm that you used to create the request signature.

Condition: Specify this parameter when you include authentication information in a query stringinstead of in the HTTP authorization header.

Type: string

Valid Values: AWS4-HMAC-SHA256

Required: ConditionalX-Amz-Credential

The credential scope value, which is a string that includes your access key, the date, the region youare targeting, the service you are requesting, and a termination string ("aws4_request"). The value isexpressed in the following format: access_key/YYYYMMDD/region/service/aws4_request.

For more information, see Task 2: Create a String to Sign for Signature Version 4 in the Amazon WebServices General Reference.

Condition: Specify this parameter when you include authentication information in a query stringinstead of in the HTTP authorization header.

Type: string

Required: ConditionalX-Amz-Date

The date that is used to create the signature. The format must be ISO 8601 basic format(YYYYMMDD'T'HHMMSS'Z'). For example, the following date time is a valid X-Amz-Date value:20120325T120000Z.

Condition: X-Amz-Date is optional for all requests; it can be used to override the date used forsigning requests. If the Date header is specified in the ISO 8601 basic format, X-Amz-Date is

API Version 2015-06-23261

Page 274: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

not required. When X-Amz-Date is used, it always overrides the value of the Date header. Formore information, see Handling Dates in Signature Version 4 in the Amazon Web Services GeneralReference.

Type: string

Required: ConditionalX-Amz-Security-Token

The temporary security token that was obtained through a call to AWS Security Token Service (AWSSTS). For a list of services that support temporary security credentials from AWS Security TokenService, go to AWS Services That Work with IAM in the IAM User Guide.

Condition: If you're using temporary security credentials from the AWS Security Token Service, youmust include the security token.

Type: string

Required: ConditionalX-Amz-Signature

Specifies the hex-encoded signature that was calculated from the string to sign and the derivedsigning key.

Condition: Specify this parameter when you include authentication information in a query stringinstead of in the HTTP authorization header.

Type: string

Required: ConditionalX-Amz-SignedHeaders

Specifies all the HTTP headers that were included as part of the canonical request. For moreinformation about specifying signed headers, see Task 1: Create a Canonical Request For SignatureVersion 4 in the Amazon Web Services General Reference.

Condition: Specify this parameter when you include authentication information in a query stringinstead of in the HTTP authorization header.

Type: string

Required: Conditional

API Version 2015-06-23262

Page 275: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

Common ErrorsThis section lists the errors common to the API actions of all AWS services. For errors specific to an APIaction for this service, see the topic for that API action.

AccessDeniedException

You do not have sufficient access to perform this action.

HTTP Status Code: 400IncompleteSignature

The request signature does not conform to AWS standards.

HTTP Status Code: 400InternalFailure

The request processing has failed because of an unknown error, exception or failure.

HTTP Status Code: 500InvalidAction

The action or operation requested is invalid. Verify that the action is typed correctly.

HTTP Status Code: 400InvalidClientTokenId

The X.509 certificate or AWS access key ID provided does not exist in our records.

HTTP Status Code: 403InvalidParameterCombination

Parameters that must not be used together were used together.

HTTP Status Code: 400InvalidParameterValue

An invalid or out-of-range value was supplied for the input parameter.

HTTP Status Code: 400InvalidQueryParameter

The AWS query string is malformed or does not adhere to AWS standards.

HTTP Status Code: 400MalformedQueryString

The query string contains a syntax error.

HTTP Status Code: 404MissingAction

The request is missing an action or a required parameter.

HTTP Status Code: 400

API Version 2015-06-23263

Page 276: AWS Device Farm · PDF fileAWS Device Farm is a service that enables mobile app developers to test Android, iOS, and Fire OS apps on physical phones, tablets, and other devices in

AWS Device Farm API Reference

MissingAuthenticationToken

The request must contain either a valid (registered) AWS access key ID or X.509 certificate.

HTTP Status Code: 403MissingParameter

A required parameter for the specified action is not supplied.

HTTP Status Code: 400OptInRequired

The AWS access key ID needs a subscription for the service.

HTTP Status Code: 403RequestExpired

The request reached the service more than 15 minutes after the date stamp on the request or morethan 15 minutes after the request expiration date (such as for pre-signed URLs), or the date stampon the request is more than 15 minutes in the future.

HTTP Status Code: 400ServiceUnavailable

The request has failed due to a temporary failure of the server.

HTTP Status Code: 503ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 400ValidationError

The input fails to satisfy the constraints specified by an AWS service.

HTTP Status Code: 400

API Version 2015-06-23264