Spec-Zone.ru › AWS CLI v2

[ aws . devicefarm ]

update-device-pool

Описание

Изменяет имя, описание и правила в пуле устройств, учитывая атрибуты и ARN пула. Обновление правил выполняется по принципу «все или ничего», то есть они могут быть обновлены целиком (или не обновлены вообще).

См. также: Документацию API AWS

Синтаксис

  update-device-pool
--arn <value>
[--name <value>]
[--description <value>]
[--rules <value>]
[--max-devices <value>]
[--clear-max-devices | --no-clear-max-devices]
[--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]

Параметры

--arn (строка)

Amazon Resource Name (ARN) пула устройств Device Farm для обновления.

--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. В зависимости от того, сколько устройств соответствует этим ограничениям, ваш пул устройств может содержать меньше устройств, чем указанное значение для этого параметра.

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

Если вы используете этот параметр в запросе, вы не можете использовать параметр clearMaxDevices в том же запросе.

--clear-max-devices | --no-clear-max-devices (логическое значение)

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

Если вы используете этот параметр в запросе, вы не можете использовать параметр maxDevices в том же запросе.

--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 для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запросить параметры входных данных CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запроса параметров входных данных CLI.

Вывод

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.

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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