[ aws . devicefarm ]
list-runs
Описание
Получает информацию о запусках, заданном ARN проекта AWS Device Farm.
См. также: документацию AWS API
list-runs — это операция с постраничной передачей. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничную передачу, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной передачей, аргумент --query должен извлекать данные из результатов следующих выражений запроса: runs
Синтаксис
list-runs
--arn <value>
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--arn (строка)
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, указанному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения перепишут значения, предоставленные в JSON. Невозможно передавать произвольные двоичные данные с помощью значения, предоставленного в JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Токен для указания места начала постраничной передачи. Это NextToken из ранее обрезанного ответа.
Примеры использования см. в разделе «Постраничная передача» в Руководстве пользователя AWS Command Line Interface.
--max-items (целое число)
Общее количество элементов, которое нужно вернуть в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничной передачи укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе «Постраничная передача» в Руководстве пользователя AWS Command Line Interface.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено без значения или со значением input, выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (логическое значение)
Включить отладку протоколирования.
--endpoint-url (строка)
Переопределить URL по умолчанию команды указанным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (логическое значение)
Отключить автоматическую постраничную передачу. Если автоматическая постраничная передача отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Выражение JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла с данными учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Пакет сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаут. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет иметь таймаут. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (строка)
Стиль форматирования для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (логическое значение)
Отключить вывод кли-пэйджера для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать входные параметры CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запросы входных параметров CLI.
Вывод
runs -> (список)
Информация о запусках.
(структура)
Представляет запуск теста на наборе устройств с заданным пакетом приложения, параметрами теста и т. д.
arn -> (строка)
name -> (строка)
type -> (строка)
Тип запуска.
Должно быть одно из следующих значений:
- BUILTIN_FUZZ
- APPIUM_JAVA_JUNIT
- APPIUM_JAVA_TESTNG
- APPIUM_PYTHON
- APPIUM_NODE
- APPIUM_RUBY
- APPIUM_WEB_JAVA_JUNIT
- APPIUM_WEB_JAVA_TESTNG
- APPIUM_WEB_PYTHON
- APPIUM_WEB_NODE
- APPIUM_WEB_RUBY
- INSTRUMENTATION
- XCTEST
- XCTEST_UI
platform -> (строка)
Платформа запуска.
Допустимые значения:
- ANDROID
- IOS
created -> (метка времени)
status -> (строка)
Статус запуска.
Допустимые значения:
- PENDING
- PENDING_CONCURRENCY
- PENDING_DEVICE
- PROCESSING
- SCHEDULING
- PREPARING
- RUNNING
- COMPLETED
- STOPPING
result -> (строка)
Результат запуска.
Допустимые значения:
- PENDING
- PASSED
- WARNED
- FAILED
- SKIPPED
- ERRORED
- STOPPED
started -> (метка времени)
stopped -> (метка времени)
counters -> (структура)
Счётчики результатов запуска.
total -> (целое число)
passed -> (целое число)
failed -> (целое число)
warned -> (целое число)
errored -> (целое число)
stopped -> (целое число)
skipped -> (целое число)
message -> (строка)
totalJobs -> (целое число)
completedJobs -> (целое число)
billingMethod -> (строка)
Указывает метод выставления счёта для запуска теста: metered или unmetered. Если параметр не указан, значение по умолчанию — metered.
Примечание
Если у вас есть нелимитированные слоты устройств, необходимо установить это значение наunmetered, чтобы использовать их. В противном случае запуск будет учтён в лимитированных минутах устройств.deviceMinutes -> (структура)
Представляет общее (лимитированное или нелимитированное) время, использованное запуском теста.
total -> (двойное)
metered -> (двойное)
unmetered -> (двойное)
networkProfile -> (структура)
Профиль сети, используемый для запуска теста.
arn -> (строка)
name -> (строка)
description -> (строка)
type -> (строка)
uplinkBandwidthBits -> (длинное целое)
downlinkBandwidthBits -> (длинное целое)
uplinkDelayMs -> (длинное целое)
downlinkDelayMs -> (длинное целое)
uplinkJitterMs -> (длинное целое)
downlinkJitterMs -> (длинное целое)
uplinkLossPercent -> (целое число)
downlinkLossPercent -> (целое число)
deviceProxy -> (структура)
Конфигурация прокси-сервера устройств для устройств в запуске.
host -> (строка)
port -> (целое число)
parsingResultUrl -> (строка)
resultCode -> (строка)
result равно SKIPPED. PARSING_FAILED, если результат пропущен из-за сбоя при разборе пакета теста.seed -> (целое число)
appUpload -> (строка)
eventCount -> (целое число)
jobTimeoutMinutes -> (целое число)
devicePoolArn -> (строка)
locale -> (строка)
radios -> (структура)
Информация о состояниях радио для запуска.
wifi -> (булево)
bluetooth -> (булево)
nfc -> (булево)
gps -> (булево)
location -> (структура)
Информация о местоположении, используемом для запуска.
latitude -> (двойное)
longitude -> (двойное)
customerArtifactPaths -> (структура)
Вывод CustomerArtifactPaths объекта для запуска теста.
iosPaths -> (список)
Список путей через запятую на устройстве iOS, откуда извлекаются артефакты, сгенерированные тестами клиента.
(строка)
androidPaths -> (список)
Список путей через запятую на устройстве Android, откуда извлекаются артефакты, сгенерированные тестами клиента.
(строка)
deviceHostPaths -> (список)
Список путей в среде выполнения теста через запятую, откуда извлекаются артефакты, сгенерированные тестами клиента.
(строка)
webUrl -> (строка)
skipAppResign -> (булево)
При установке в true для частных устройств Device Farm не переподписывает ваше приложение. Для общедоступных устройств Device Farm всегда переподписывает ваши приложения.
Дополнительную информацию о том, как Device Farm переподписывает ваши приложения, см. в разделе Документация по Device Farm.
testSpecArn -> (строка)
deviceSelectionResult -> (структура)
Результаты фильтра устройств, используемого для выбора устройств для выполнения теста.
filters -> (список)
Фильтры в результате выбора устройств.
(структура)
Представляет фильтр устройств, используемый для выбора набора устройств, которые будут включены в запуск теста. Эта структура данных передаётся в качестве параметра deviceSelectionConfiguration в ScheduleRun. Пример синтаксиса запроса в формате JSON см. в ScheduleRun.
Также она передаётся в качестве параметра filters в ListDevices. Пример синтаксиса запроса в формате JSON см. в ListDevices.
attribute -> (строка)
Аспект устройства, такой как платформа или модель, используемый в качестве критерия выбора в фильтре устройств.
Доступные операторы для каждого атрибута приведены в следующем списке.
Amazon Resource Name (ARN) устройства (например, arn:aws:devicefarm:us-west-2::device:12345Example).
Поддерживаемые операторы: EQUALS, IN, NOT_IN
Платформа устройства. Допустимые значения: ANDROID или IOS.
Поддерживаемые операторы: EQUALS
Версия операционной системы (например, 10.3.2).
Поддерживаемые операторы: EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUALS, IN, LESS_THAN, LESS_THAN_OR_EQUALS, NOT_IN
Модель устройства (например, iPad 5th Gen).
Поддерживаемые операторы: CONTAINS, EQUALS, IN, NOT_IN
Текущая доступность устройства. Допустимые значения: AVAILABLE, HIGHLY_AVAILABLE, BUSY или TEMPORARY_NOT_AVAILABLE.
Поддерживаемые операторы: EQUALS
Форм-фактор устройства. Допустимые значения: PHONE или TABLET.
Поддерживаемые операторы: EQUALS
Производитель устройства (например, Apple).
Поддерживаемые операторы: EQUALS, IN, NOT_IN
Включен ли удалённый доступ к устройству. Допустимые значения: TRUE или FALSE.
Поддерживаемые операторы: EQUALS
Включено ли удалённое отладка устройства. Допустимые значения: TRUE или FALSE.
Поддерживаемые операторы: EQUALS
Поскольку удалённая отладка больше не поддерживается, этот фильтр игнорируется.
Amazon Resource Name (ARN) экземпляра устройства.
Поддерживаемые операторы: EQUALS, IN, NOT_IN
Метка экземпляра устройства.
Поддерживаемые операторы: CONTAINS
Тип флота. Допустимые значения: PUBLIC или PRIVATE.
Поддерживаемые операторы: EQUALS
operator -> (строка)
values -> (список)
Массив одного или нескольких значений фильтра, используемых в фильтре устройств.
- Операторы IN и NOT_IN могут принимать массив значений, содержащий более одного элемента.
- Другие операторы требуют массива с одним элементом.
- Атрибут PLATFORM может быть установлен в ANDROID или IOS.
- Атрибут AVAILABILITY может быть установлен в AVAILABLE, HIGHLY_AVAILABLE, BUSY или TEMPORARY_NOT_AVAILABLE.
- Атрибут FORM_FACTOR может быть установлен в PHONE или TABLET.
- Атрибут FLEET_TYPE может быть установлен в PUBLIC или PRIVATE.
(строка)
matchedDevicesCount -> (целое число)
maxDevices -> (целое число)
vpcConfig -> (структура)
Конфигурация VPC, включающая группы безопасности и подсети, привязанные к проекту.
securityGroupIds -> (список)
Массив одного или нескольких идентификаторов групп безопасности в вашей Amazon VPC.
(строка)
subnetIds -> (список)
Массив одного или нескольких идентификаторов подсетей в вашей Amazon VPC.
(строка)
vpcId -> (строка)
nextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.