[ aws . devicefarm ]
create-device-pool
Описание
Создаёт пул устройств.
См. также: Документацию AWS API
Синтаксис
create-device-pool
--project-arn <value>
--name <value>
[--description <value>]
--rules <value>
[--max-devices <value>]
[--cli-input-json | --cli-input-yaml]
[--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]
Параметры
--project-arn (строка)
--name (строка)
--description (строка)
--rules (список)
Правила пула устройств.
(структура)
Представляет условие для пула устройств.
attribute -> (строка)
Строковое атрибутивное значение правила. Например, укажите значение как "\"abc\"" .
Поддерживаемые операторы для каждого атрибута приведены в следующем списке.
Версия Appium для теста.
Поддерживаемые операторы: CONTAINS
Amazon Resource Name (ARN) устройства (например, arn:aws:devicefarm:us-west-2::device:12345Example ).
Поддерживаемые операторы: EQUALS , IN , NOT_IN
Текущая доступность устройства. Допустимые значения: AVAILABLE, HIGHLY_AVAILABLE, BUSY или TEMPORARY_NOT_AVAILABLE.
Поддерживаемые операторы: EQUALS
Тип флота. Допустимые значения: PUBLIC или PRIVATE.
Поддерживаемые операторы: EQUALS
Форм-фактор устройства. Допустимые значения: PHONE или TABLET.
Поддерживаемые операторы: EQUALS , IN , NOT_IN
Amazon Resource Name (ARN) экземпляра устройства.
Поддерживаемые операторы: IN , NOT_IN
Метка экземпляра устройства.
Поддерживаемые операторы: CONTAINS
Производитель устройства (например, Apple).
Поддерживаемые операторы: EQUALS , IN , NOT_IN
Модель устройства, например, Apple iPad Air 2 или Google Pixel.
Поддерживаемые операторы: CONTAINS , EQUALS , IN , NOT_IN
Версия операционной системы (например, 10.3.2).
Поддерживаемые операторы: EQUALS , GREATER_THAN , GREATER_THAN_OR_EQUALS , IN , LESS_THAN , LESS_THAN_OR_EQUALS , NOT_IN
Платформа устройства. Допустимые значения: ANDROID или IOS.
Поддерживаемые операторы: EQUALS , IN , NOT_IN
Включен ли удаленный доступ к устройству. Допустимые значения: TRUE или FALSE.
Поддерживаемые операторы: EQUALS
Включено ли удаленное отладка устройства. Допустимые значения: TRUE или FALSE.
Поддерживаемые операторы: EQUALS
Поскольку удалённая отладка больше не поддерживается, этот фильтр игнорируется.
operator -> (строка)
value -> (строка)
Сокращенный синтаксис:
attribute=string,operator=string,value=string ...
Синтаксис JSON:
[
{
"attribute": "ARN"|"PLATFORM"|"FORM_FACTOR"|"MANUFACTURER"|"REMOTE_ACCESS_ENABLED"|"REMOTE_DEBUG_ENABLED"|"APPIUM_VERSION"|"INSTANCE_ARN"|"INSTANCE_LABELS"|"FLEET_TYPE"|"OS_VERSION"|"MODEL"|"AVAILABILITY",
"operator": "EQUALS"|"LESS_THAN"|"LESS_THAN_OR_EQUALS"|"GREATER_THAN"|"GREATER_THAN_OR_EQUALS"|"IN"|"NOT_IN"|"CONTAINS",
"value": "string"
}
...
]
--max-devices (целое число)
Количество устройств, которые Device Farm может добавить в ваш пул устройств. Device Farm добавляет устройства, которые доступны и соответствуют критериям, которые вы задаёте для параметра rules. В зависимости от того, сколько устройств соответствует этим ограничениям, ваш пул устройств может содержать меньше устройств, чем значение этого параметра.
Указывая максимальное количество устройств, вы можете контролировать затраты, которые вы несёте при выполнении тестов.
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--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.
Примеры
Примечание
Для использования следующих примеров вам необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.
Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. раздел Использование кавычек со строками в руководстве пользователя AWS CLI.
Для создания пула устройств
Следующая команда создаёт пул Android-устройств для проекта:
aws devicefarm create-device-pool --name pool1 --rules file://device-pool-rules.json --project-arn "arn:aws:devicefarm:us-west-2:123456789012:project:070fc3ca-7ec1-4741-9c1f-d3e044efc506"
Вы можете получить ARN проекта из вывода create-project или list-projects. Файл device-pool-rules.json — это JSON-документ в текущей папке, который определяет платформу устройства:
[
{
"attribute": "PLATFORM",
"operator": "EQUALS",
"value": "\"ANDROID\""
}
]
Вывод:
{
"devicePool": {
"rules": [
{
"operator": "EQUALS",
"attribute": "PLATFORM",
"value": "\"ANDROID\""
}
],
"type": "PRIVATE",
"name": "pool1",
"arn": "arn:aws:devicefarm:us-west-2:123456789012:devicepool:070fc3ca-7ec1-4741-9c1f-d3e044efc506/2aa8d2a9-5e73-47ca-b929-659cb34b7dcd"
}
}
Вывод
devicePool -> (структура)
Новое созданное пул устройств.
arn -> (строка)
name -> (строка)
description -> (строка)
type -> (строка)
Тип пула устройств.
Допустимые значения включают:
- CURATED: Пул устройств, созданный и управляемый AWS Device Farm.
- PRIVATE: Пул устройств, созданный и управляемый разработчиком пула устройств.
rules -> (список)
Информация о правилах пула устройств.
(структура)
Представляет условие для пула устройств.
attribute -> (строка)
Строковое значение атрибута правила. Например, укажите значение как "\"abc\"" .
Поддерживаемые операторы для каждого атрибута представлены в следующем списке.
Версия Appium для теста.
Поддерживаемые операторы: CONTAINS
Amazon Resource Name (ARN) устройства (например, arn:aws:devicefarm:us-west-2::device:12345Example .
Поддерживаемые операторы: EQUALS , IN , NOT_IN
Текущая доступность устройства. Допустимые значения: AVAILABLE, HIGHLY_AVAILABLE, BUSY или TEMPORARY_NOT_AVAILABLE.
Поддерживаемые операторы: EQUALS
Тип флота. Допустимые значения: PUBLIC или PRIVATE.
Поддерживаемые операторы: EQUALS
Форм-фактор устройства. Допустимые значения: PHONE или TABLET.
Поддерживаемые операторы: EQUALS , IN , NOT_IN
Amazon Resource Name (ARN) экземпляра устройства.
Поддерживаемые операторы: IN , NOT_IN
Метка экземпляра устройства.
Поддерживаемые операторы: CONTAINS
Производитель устройства (например, Apple).
Поддерживаемые операторы: EQUALS , IN , NOT_IN
Модель устройства, например Apple iPad Air 2 или Google Pixel.
Поддерживаемые операторы: CONTAINS , EQUALS , IN , NOT_IN
Версия операционной системы (например, 10.3.2).
Поддерживаемые операторы: EQUALS , GREATER_THAN , GREATER_THAN_OR_EQUALS , IN , LESS_THAN , LESS_THAN_OR_EQUALS , NOT_IN
Платформа устройства. Допустимые значения: ANDROID или IOS.
Поддерживаемые операторы: EQUALS , IN , NOT_IN
Включен ли удаленный доступ к устройству. Допустимые значения: TRUE или FALSE.
Поддерживаемые операторы: EQUALS
Включен ли удаленный отладка на устройстве. Допустимые значения: TRUE или FALSE.
Поддерживаемые операторы: EQUALS
Поскольку удаленная отладка больше не поддерживается, этот фильтр игнорируется.
operator -> (строка)
value -> (строка)
maxDevices -> (целое число)
Количество устройств, которое Device Farm может добавить в ваш пул устройств. Device Farm добавляет устройства, которые доступны и соответствуют критериям, которые вы задали для параметра rules . В зависимости от того, сколько устройств соответствует этим ограничениям, ваш пул устройств может содержать меньше устройств, чем указано для этого параметра.
Указание максимального количества устройств позволяет контролировать расходы при выполнении тестов.
© Copyright 2025, Amazon Web Services. Created using Sphinx.