Spec-Zone.ru › AWS CLI v2

[ 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 (строка)

Amazon Resource Name (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 -> (строка)

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 -> (строка)

Amazon Resource Name (ARN) профиля сети.

name -> (строка)

Имя профиля сети.

description -> (строка)

Описание профиля сети.

type -> (строка)

Тип профиля сети. Допустимые значения приведены здесь.

uplinkBandwidthBits -> (длинное целое)

Скорость пропускной способности канала отправки в битах в секунду, как целое число от 0 до 104857600.

downlinkBandwidthBits -> (длинное целое)

Скорость пропускной способности канала приёма в битах в секунду, как целое число от 0 до 104857600.

uplinkDelayMs -> (длинное целое)

Время задержки всех пакетов до пункта назначения в миллисекундах как целое число от 0 до 2000.

downlinkDelayMs -> (длинное целое)

Время задержки всех пакетов до пункта назначения в миллисекундах как целое число от 0 до 2000.

uplinkJitterMs -> (длинное целое)

Изменчивость времени задержки полученных пакетов в миллисекундах как целое число от 0 до 2000.

downlinkJitterMs -> (длинное целое)

Изменчивость времени задержки полученных пакетов в миллисекундах как целое число от 0 до 2000.

uplinkLossPercent -> (целое число)

Пропорция переданных пакетов, которые не доходят до пункта назначения от 0 до 100 процентов.

downlinkLossPercent -> (целое число)

Пропорция полученных пакетов, которые не доходят до пункта назначения от 0 до 100 процентов.

deviceProxy -> (структура)

Конфигурация прокси-сервера устройств для устройств в запуске.

host -> (строка)

Имя хоста или IPv4-адрес прокси-сервера.

port -> (целое число)

Номер порта, на котором прокси-сервер HTTP/S слушает.

parsingResultUrl -> (строка)

Только для чтения URL-адрес объекта в ведре S3, где вы можете получить результаты разбора пакета теста. Если пакет теста не удалось разобрать, причина, по которой это произошло, отображается в файле, на который указывает этот URL.

resultCode -> (строка)

Поддерживаемое поле для поля результата. Устанавливается только если result равно SKIPPED. PARSING_FAILED, если результат пропущен из-за сбоя при разборе пакета теста.

seed -> (целое число)

Для тестов fuzzing, это зерно для случайного тестирования UI fuzz. Использование одинакового значения зерна между тестами гарантирует идентичные последовательности событий.

appUpload -> (строка)

Приложение для загрузки или уже загруженное.

eventCount -> (целое число)

Для тестов fuzzing, это количество событий, от 1 до 10000, которые тест UI fuzz должен выполнить.

jobTimeoutMinutes -> (целое число)

Количество минут, в течение которого выполняется задача, прежде чем она будет завершена по таймауту.

devicePoolArn -> (строка)

ARN пула устройств для запуска.

locale -> (строка)

Информация о языке, используемом для запуска.

radios -> (структура)

Информация о состояниях радио для запуска.

wifi -> (булево)

True, если Wi-Fi включён в начале теста, иначе false.

bluetooth -> (булево)

True, если Bluetooth включён в начале теста, иначе false.

nfc -> (булево)

True, если NFC включён в начале теста, иначе false.

gps -> (булево)

True, если GPS включён в начале теста, иначе false.

location -> (структура)

Информация о местоположении, используемом для запуска.

latitude -> (двойное)

Широта.

longitude -> (двойное)

Долгота.

customerArtifactPaths -> (структура)

Вывод CustomerArtifactPaths объекта для запуска теста.

iosPaths -> (список)

Список путей через запятую на устройстве iOS, откуда извлекаются артефакты, сгенерированные тестами клиента.

(строка)

androidPaths -> (список)

Список путей через запятую на устройстве Android, откуда извлекаются артефакты, сгенерированные тестами клиента.

(строка)

deviceHostPaths -> (список)

Список путей в среде выполнения теста через запятую, откуда извлекаются артефакты, сгенерированные тестами клиента.

(строка)

webUrl -> (строка)

URL-адрес консоли Device Farm для записи запуска.

skipAppResign -> (булево)

При установке в true для частных устройств Device Farm не переподписывает ваше приложение. Для общедоступных устройств Device Farm всегда переподписывает ваши приложения.

Дополнительную информацию о том, как Device Farm переподписывает ваши приложения, см. в разделе Документация по Device Farm.

testSpecArn -> (строка)

ARN YAML-форматированного спецификации теста для запуска.

deviceSelectionResult -> (структура)

Результаты фильтра устройств, используемого для выбора устройств для выполнения теста.

filters -> (список)

Фильтры в результате выбора устройств.

(структура)

Представляет фильтр устройств, используемый для выбора набора устройств, которые будут включены в запуск теста. Эта структура данных передаётся в качестве параметра deviceSelectionConfiguration в ScheduleRun. Пример синтаксиса запроса в формате JSON см. в ScheduleRun.

Также она передаётся в качестве параметра filters в ListDevices. Пример синтаксиса запроса в формате JSON см. в ListDevices.

attribute -> (строка)

Аспект устройства, такой как платформа или модель, используемый в качестве критерия выбора в фильтре устройств.

Доступные операторы для каждого атрибута приведены в следующем списке.

ARN

Amazon Resource Name (ARN) устройства (например, arn:aws:devicefarm:us-west-2::device:12345Example).

Поддерживаемые операторы: EQUALS, IN, NOT_IN

PLATFORM

Платформа устройства. Допустимые значения: ANDROID или IOS.

Поддерживаемые операторы: EQUALS

OS_VERSION

Версия операционной системы (например, 10.3.2).

Поддерживаемые операторы: EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUALS, IN, LESS_THAN, LESS_THAN_OR_EQUALS, NOT_IN

MODEL

Модель устройства (например, iPad 5th Gen).

Поддерживаемые операторы: CONTAINS, EQUALS, IN, NOT_IN

AVAILABILITY

Текущая доступность устройства. Допустимые значения: AVAILABLE, HIGHLY_AVAILABLE, BUSY или TEMPORARY_NOT_AVAILABLE.

Поддерживаемые операторы: EQUALS

FORM_FACTOR

Форм-фактор устройства. Допустимые значения: PHONE или TABLET.

Поддерживаемые операторы: EQUALS

MANUFACTURER

Производитель устройства (например, Apple).

Поддерживаемые операторы: EQUALS, IN, NOT_IN

REMOTE_ACCESS_ENABLED

Включен ли удалённый доступ к устройству. Допустимые значения: TRUE или FALSE.

Поддерживаемые операторы: EQUALS

REMOTE_DEBUG_ENABLED

Включено ли удалённое отладка устройства. Допустимые значения: TRUE или FALSE.

Поддерживаемые операторы: EQUALS

Поскольку удалённая отладка больше не поддерживается, этот фильтр игнорируется.

INSTANCE_ARN

Amazon Resource Name (ARN) экземпляра устройства.

Поддерживаемые операторы: EQUALS, IN, NOT_IN

INSTANCE_LABELS

Метка экземпляра устройства.

Поддерживаемые операторы: CONTAINS

FLEET_TYPE

Тип флота. Допустимые значения: PUBLIC или PRIVATE.

Поддерживаемые операторы: EQUALS

operator -> (строка)

Определяет, как Device Farm сравнивает атрибут фильтра с значением. См. описания атрибутов.

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 -> (строка)

Идентификатор Amazon VPC.

nextToken -> (строка)

Если количество возвращаемых элементов существенно велико, возвращается идентификатор, который также может быть использован в последующем вызове этой операции для возвращения следующего набора элементов в списке.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API