aws device farm · pdf fileaws device farm is a service that enables mobile app developers to...
TRANSCRIPT
AWS Device FarmAPI Reference
API Version 2015-06-23
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.
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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 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-236
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
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
AWS Device Farm API ReferenceSee Also
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-239
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
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
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
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-2313
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
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
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
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
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
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
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
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
• 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-2326
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
AWS Device Farm API ReferenceSee Also
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-2328
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
AWS Device Farm API ReferenceSee Also
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-2330
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
AWS Device Farm API ReferenceSee Also
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-2332
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
AWS Device Farm API ReferenceSee Also
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-2334
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
AWS Device Farm API ReferenceSee Also
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-2336
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
AWS Device Farm API ReferenceSee Also
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-2338
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
AWS Device Farm API ReferenceSee Also
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-2340
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
AWS Device Farm API ReferenceSee Also
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-2342
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
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
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
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
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 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-2347
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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 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-2367
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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 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-2388
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
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
AWS Device Farm API ReferenceSee Also
• 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-2391
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
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
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
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
API Version 2015-06-23100
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
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for Ruby V2
API Version 2015-06-23104
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
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
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 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-23107
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for Ruby V2
API Version 2015-06-23123
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
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for Ruby V2
API Version 2015-06-23127
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
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
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
AWS Device Farm API ReferenceSee Also
API Version 2015-06-23131
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for Ruby V2
API Version 2015-06-23134
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
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
AWS Device Farm API ReferenceSee Also
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-23137
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
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
AWS Device Farm API ReferenceSee Also
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-23140
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
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
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
AWS Device Farm API ReferenceSee Also
• 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-23144
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2
API Version 2015-06-23147
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
• 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-23153
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
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
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for JavaScript• AWS SDK for PHP V3• AWS SDK for Python• AWS SDK for Ruby V2
API Version 2015-06-23161
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
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
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
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
• 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-23170
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
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
AWS Device Farm API ReferenceSee Also
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-23173
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
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
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
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
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
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
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-23180
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
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
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
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
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-23185
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2
API Version 2015-06-23201
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2
API Version 2015-06-23204
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
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
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
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
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
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
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
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
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for Java• AWS SDK for Ruby V2
API Version 2015-06-23218
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2
API Version 2015-06-23234
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2
API Version 2015-06-23240
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
AWS Device Farm API ReferenceSee Also
• AWS SDK for C++• AWS SDK for Go• AWS SDK for Java• AWS SDK for Ruby V2
API Version 2015-06-23260
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
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
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
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