Spec-Zone.ru › AWS CLI v2

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

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

--name (строка)

Имя пула устройств.

--description (строка)

Описание пула устройств.

--rules (список)

Правила пула устройств.

(структура)

Представляет условие для пула устройств.

attribute -> (строка)

Строковое атрибутивное значение правила. Например, укажите значение как "\"abc\"" .

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

APPIUM_VERSION

Версия Appium для теста.

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

ARN

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

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

AVAILABILITY

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

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

FLEET_TYPE

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

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

FORM_FACTOR

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

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

INSTANCE_ARN

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

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

INSTANCE_LABELS

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

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

MANUFACTURER

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

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

MODEL

Модель устройства, например, Apple iPad Air 2 или Google Pixel.

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

OS_VERSION

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

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

PLATFORM

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

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

REMOTE_ACCESS_ENABLED

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

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

REMOTE_DEBUG_ENABLED

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

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

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

operator -> (строка)

Определяет, как Device Farm сравнивает атрибут правила со значением. Поддерживаемые операторы для каждого атрибута см. в описаниях атрибутов.

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

ARN пула устройств.

name -> (строка)

Имя пула устройств.

description -> (строка)

Описание пула устройств.

type -> (строка)

Тип пула устройств.

Допустимые значения включают:

  • CURATED: Пул устройств, созданный и управляемый AWS Device Farm.
  • PRIVATE: Пул устройств, созданный и управляемый разработчиком пула устройств.

rules -> (список)

Информация о правилах пула устройств.

(структура)

Представляет условие для пула устройств.

attribute -> (строка)

Строковое значение атрибута правила. Например, укажите значение как "\"abc\"" .

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

APPIUM_VERSION

Версия Appium для теста.

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

ARN

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

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

AVAILABILITY

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

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

FLEET_TYPE

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

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

FORM_FACTOR

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

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

INSTANCE_ARN

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

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

INSTANCE_LABELS

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

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

MANUFACTURER

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

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

MODEL

Модель устройства, например Apple iPad Air 2 или Google Pixel.

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

OS_VERSION

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

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

PLATFORM

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

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

REMOTE_ACCESS_ENABLED

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

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

REMOTE_DEBUG_ENABLED

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

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

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

operator -> (строка)

Указывает, как Device Farm сравнивает атрибут правила со значением. Операторы, поддерживаемые каждым атрибутом, см. в описаниях атрибутов.

value -> (строка)

Значение правила.

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

Количество устройств, которое Device Farm может добавить в ваш пул устройств. Device Farm добавляет устройства, которые доступны и соответствуют критериям, которые вы задали для параметра rules . В зависимости от того, сколько устройств соответствует этим ограничениям, ваш пул устройств может содержать меньше устройств, чем указано для этого параметра.

Указание максимального количества устройств позволяет контролировать расходы при выполнении тестов.

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

Spec-Zone.ru

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