create-simulation-job

Описание

Предупреждение

Уведомление о прекращении поддержки: 10 сентября 2025 года Amazon Web Services прекратит поддержку Amazon Web Services RoboMaker. После 10 сентября 2025 года вы больше не сможете получить доступ к консоли Amazon Web Services RoboMaker или ресурсам Amazon Web Services RoboMaker. Для получения дополнительной информации о переходе на Batch для выполнения контейнерных симуляций посетите https://aws.amazon.com/blogs/hpc/run-simulations-using-multiple-containers-in-a-single-aws-batch-job/ .

Создаёт задание симуляции.

Примечание

После 90 дней задания симуляции истекают и будут удалены. Они больше не будут доступны.

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

Синтаксис

  create-simulation-job
[--client-request-token <value>]
[--output-location <value>]
[--logging-config <value>]
--max-job-duration-in-seconds <value>
--iam-role <value>
[--failure-behavior <value>]
[--robot-applications <value>]
[--simulation-applications <value>]
[--data-sources <value>]
[--tags <value>]
[--vpc-config <value>]
[--compute <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]

Параметры

--client-request-token (строка)

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

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

Расположение файлов вывода, сгенерированных заданием симуляции.

s3Bucket -> (строка)

Ведро S3 для вывода.

s3Prefix -> (строка)

Папка S3 в s3Bucket, где будут размещены выходные файлы.

Сокращённый синтаксис:

s3Bucket=string,s3Prefix=string

Синтаксис JSON:

{
  "s3Bucket": "string",
  "s3Prefix": "string"
}

--logging-config (структура)

Настройка ведения журнала.

recordAllRosTopics -> (булево)

Булево значение, указывающее, нужно ли записывать все темы ROS.

Предупреждение

Этот API больше не поддерживается и при использовании вызовет ошибку.

Сокращённый синтаксис:

recordAllRosTopics=boolean

Синтаксис JSON:

{
  "recordAllRosTopics": true|false
}

--max-job-duration-in-seconds (целое число)

Максимальная продолжительность задания симуляции в секундах (до 14 дней или 1 209 600 секунд. Когда maxJobDurationInSeconds достигнуто, статус задания симуляции перейдёт в Completed.

--iam-role (строка)

Имя роли IAM, которое разрешает экземпляру симуляции вызывать API AWS, указанные в связанных политиках от вашего имени. Именно так передаются учетные данные в ваше задание симуляции.

--failure-behavior (строка)

Поведение при ошибке задания симуляции.

Продолжить

Оставляет экземпляр запущенным до максимального времени ожидания после 4XX код ошибки.

Прервать

Останавливает задание симуляции и завершает экземпляр.

Возможные значения:

Fail
Continue

--robot-applications (список)

Прикладное программное обеспечение робота для использования в задании симуляции.

(структура)

Информация о настройке приложения для робота.

application -> (строка)

Информация о приложении для программного обеспечения робота.

applicationVersion -> (строка)

Версия приложения робота.

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

Настройка запуска приложения робота.

packageName -> (строка)

Имя пакета.

launchFile -> (строка)

Имя файла запуска.

environmentVariables -> (карта)

Переменные среды для запуска приложения.

key -> (строка)

value -> (строка)

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

Настройка перенаправления портов.

portMappings -> (список)

Сопоставления портов для конфигурации.

(структура)

Объект, представляющий сопоставление портов.

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

Номер порта на экземпляре задания симуляции, используемый в качестве удалённой точки подключения.

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

Номер порта на приложении.

enableOnPublicIp -> (булево)

Булево значение, указывающее, следует ли включить это сопоставление портов на общедоступном IP-адресе.

streamUI -> (булево)

Булево значение, указывающее, будет ли настроено сеанса потоковой передачи для приложения. Если True , AWS RoboMaker настроит соединение, чтобы вы могли взаимодействовать с вашим приложением, когда оно выполняется в симуляции. Вы должны настроить и запустить компонент. Он должен иметь графический интерфейс пользователя.

command -> (список)

Если вы задали General как значение для RobotSoftwareSuite, вы можете использовать это поле для указания списка команд для изображения контейнера.

Если вы задали SimulationRuntime как значение для SimulationSoftwareSuite, вы можете использовать это поле для указания списка команд для изображения контейнера.

(строка)

uploadConfigurations -> (список)

Настройки загрузки для приложения робота.

(структура)

Предоставляет информацию о настройке загрузки. Файлы загружаются из задания симуляции в указанное вами расположение.

name -> (строка)

Префикс, указывающий, куда файлы будут загружены в Amazon S3. Он добавляется к расположению вывода симуляции для определения конечного пути.

Например, если расположение вывода вашей симуляции s3://amzn-s3-demo-bucket, а имя вашей настройки загрузки robot-test, ваши файлы будут загружены в s3://amzn-s3-demo-bucket/<simid>/<runid>/robot-test.

path -> (строка)

Указывает путь к загружаемому(ым) файлу(ам). Принимаются стандартные правила сопоставления Unix glob, с добавлением ** в качестве супер звездочки . Например, указание /var/log/**.log вызывает сбор всех файлов .log в дереве каталогов /var/log. Для получения дополнительных примеров см. Библиотеку Glob.

uploadBehavior -> (строка)

Указывает, когда загружать файлы:

UPLOAD_ON_TERMINATE

Соответствующие файлы загружаются после того, как симуляция перейдёт в состояние TERMINATING. Соответствующие файлы не загружаются до тех пор, пока весь ваш код (включая инструменты) не остановится.

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

UPLOAD_ROLLING_AUTO_REMOVE

Соответствующие файлы загружаются по мере создания. Они удаляются после загрузки. Указанный путь проверяется каждые 5 секунд. Окончательная проверка выполняется, когда весь ваш код (включая инструменты) остановится.

useDefaultUploadConfigurations -> (булево)

Булево значение, указывающее, следует ли использовать значения по умолчанию для настроек загрузки. По умолчанию .ros и .gazebo файлы загружаются при завершении приложения, и все темы ROS будут записываться.

Если вы зададите это значение, вы должны указать outputLocation.

Предупреждение

Этот API больше не поддерживается и при использовании вызовет ошибку.

tools -> (список)

Информация о инструментах, настроенных для приложения робота.

(структура)

Информация об инструменте. Инструменты используются в задании симуляции.

streamUI -> (булево)

Булево значение, указывающее, будет ли настроено сеанса потоковой передачи для инструмента. Если True, AWS RoboMaker настроит соединение, чтобы вы могли взаимодействовать с инструментом, когда он выполняется в симуляции. Он должен иметь графический интерфейс пользователя. Значение по умолчанию - False.

name -> (строка)

Имя инструмента.

command -> (строка)

Аргументы командной строки для инструмента. Он должен включать имя исполняемого файла инструмента.

streamOutputToCloudWatch -> (булево)

Булево значение, указывающее, будут ли записываться журналы в CloudWatch для инструмента. Значение по умолчанию - False.

exitBehavior -> (строка)

Поведение при завершении определяет, что произойдёт при завершении работы инструмента. RESTART заставит ваш инструмент перезапуститься. FAIL заставит ваше задание завершиться. Значение по умолчанию - RESTART.

useDefaultTools -> (булево)

Булево значение, указывающее, следует ли использовать значения по умолчанию для инструментов приложения робота. Инструменты по умолчанию - rviz, rqt, терминал и rosbag record. Значение по умолчанию - False.

Предупреждение

Этот API больше не поддерживается и при использовании вызовет ошибку.

Синтаксис JSON:

[
  {
    "application": "string",
    "applicationVersion": "string",
    "launchConfig": {
      "packageName": "string",
      "launchFile": "string",
      "environmentVariables": {"string": "string"
        ...},
      "portForwardingConfig": {
        "portMappings": [
          {
            "jobPort": integer,
            "applicationPort": integer,
            "enableOnPublicIp": true|false
          }
          ...
        ]
      },
      "streamUI": true|false,
      "command": ["string", ...]
    },
    "uploadConfigurations": [
      {
        "name": "string",
        "path": "string",
        "uploadBehavior": "UPLOAD_ON_TERMINATE"|"UPLOAD_ROLLING_AUTO_REMOVE"
      }
      ...
    ],
    "useDefaultUploadConfigurations": true|false,
    "tools": [
      {
        "streamUI": true|false,
        "name": "string",
        "command": "string",
        "streamOutputToCloudWatch": true|false,
        "exitBehavior": "FAIL"|"RESTART"
      }
      ...
    ],
    "useDefaultTools": true|false
  }
  ...
]

--simulation-applications (список)

Применяемое приложение моделирования в задаче моделирования.

(структура)

Информация о конфигурации приложения моделирования.

application -> (строка)

Информация об приложении моделирования.

applicationVersion -> (строка)

Версия приложения моделирования.

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

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

packageName -> (строка)

Имя пакета.

launchFile -> (строка)

Имя файла запуска.

environmentVariables -> (массив)

Переменные среды для запуска приложения.

key -> (строка)

value -> (строка)

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

Конфигурация перенаправления портов.

portMappings -> (список)

Сопоставления портов для конфигурации.

(структура)

Объект, представляющий сопоставление портов.

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

Номер порта на экземпляре задачи моделирования для использования в качестве точки удалённого подключения.

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

Номер порта в приложении.

enableOnPublicIp -> (булево)

Логическое значение, указывающее, нужно ли включить это сопоставление портов на публичном IP-адресе.

streamUI -> (булево)

Логическое значение, указывающее, будет ли настроен сеанс потоковой передачи для приложения. Если True, AWS RoboMaker настроит подключение, чтобы вы могли взаимодействовать со своим приложением во время его работы в моделировании. Вы должны настроить и запустить компонент. Он должен иметь графический пользовательский интерфейс.

command -> (список)

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

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

(строка)

uploadConfigurations -> (список)

Информация о конфигурациях загрузки для приложения моделирования.

(структура)

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

name -> (строка)

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

Например, если местоположение выходных данных моделирования - s3://amzn-s3-demo-bucket, а имя вашей конфигурации загрузки - robot-test, ваши файлы будут загружены в s3://amzn-s3-demo-bucket/<simid>/<runid>/robot-test.

path -> (строка)

Указывает путь к файлам для загрузки. Принимаются стандартные правила сопоставления Unix glob, с добавлением ** в качестве супер-звездочки. Например, указание /var/log/**.log приводит к сбору всех файлов .log в дереве каталогов /var/log. Дополнительные примеры см. в Glob Library .

uploadBehavior -> (строка)

Указывает, когда загружать файлы:

UPLOAD_ON_TERMINATE

Соответствующие файлы загружаются, когда моделирование переходит в состояние TERMINATING. Сопоставленные файлы не загружаются, пока весь ваш код (включая инструменты) не остановится.

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

UPLOAD_ROLLING_AUTO_REMOVE

Сопоставленные файлы загружаются по мере их создания. Они удаляются после загрузки. Указанный путь проверяется каждые 5 секунд. Окончательная проверка выполняется после того, как весь ваш код (включая инструменты) остановится.

worldConfigs -> (список)

Список конфигураций мира.

Предупреждение

Этот API больше не поддерживается и вызовет ошибку при использовании.

(структура)

Конфигурационная информация для мира.

world -> (строка)

Мир, сгенерированный Simulation WorldForge.

useDefaultUploadConfigurations -> (булево)

Логическое значение, указывающее, нужно ли использовать стандартные конфигурации загрузки. По умолчанию, файлы .ros и .gazebo загружаются при завершении работы приложения, а все темы ROS будут записаны.

Если вы зададите это значение, вы должны указать outputLocation.

Предупреждение

Этот API больше не поддерживается и вызовет ошибку при использовании.

tools -> (список)

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

(структура)

Информация об инструменте. Инструменты используются в задаче моделирования.

streamUI -> (булево)

Логическое значение, указывающее, будет ли настроен сеанс потоковой передачи для инструмента. Если True, AWS RoboMaker настроит подключение, чтобы вы могли взаимодействовать с инструментом во время его работы в моделировании. Он должен иметь графический пользовательский интерфейс. По умолчанию - False.

name -> (строка)

Имя инструмента.

command -> (строка)

Аргументы командной строки для инструмента. Он должен содержать имя исполняемого файла инструмента.

streamOutputToCloudWatch -> (булево)

Логическое значение, указывающее, будут ли логи записываться в CloudWatch для инструмента. По умолчанию - False.

exitBehavior -> (строка)

Поведение при выходе определяет, что произойдёт, когда ваш инструмент перестанет работать. RESTART заставит ваш инструмент перезапуститься. FAIL заставит вашу задачу выйти. По умолчанию - RESTART.

useDefaultTools -> (булево)

Логическое значение, указывающее, нужно ли использовать стандартные инструменты приложения моделирования. Стандартные инструменты - rviz, rqt, терминал и rosbag record. По умолчанию - False.

Предупреждение

Этот API больше не поддерживается и вызовет ошибку при использовании.

Синтаксис JSON:

[
  {
    "application": "string",
    "applicationVersion": "string",
    "launchConfig": {
      "packageName": "string",
      "launchFile": "string",
      "environmentVariables": {"string": "string"
        ...},
      "portForwardingConfig": {
        "portMappings": [
          {
            "jobPort": integer,
            "applicationPort": integer,
            "enableOnPublicIp": true|false
          }
          ...
        ]
      },
      "streamUI": true|false,
      "command": ["string", ...]
    },
    "uploadConfigurations": [
      {
        "name": "string",
        "path": "string",
        "uploadBehavior": "UPLOAD_ON_TERMINATE"|"UPLOAD_ROLLING_AUTO_REMOVE"
      }
      ...
    ],
    "worldConfigs": [
      {
        "world": "string"
      }
      ...
    ],
    "useDefaultUploadConfigurations": true|false,
    "tools": [
      {
        "streamUI": true|false,
        "name": "string",
        "command": "string",
        "streamOutputToCloudWatch": true|false,
        "exitBehavior": "FAIL"|"RESTART"
      }
      ...
    ],
    "useDefaultTools": true|false
  }
  ...
]

--data-sources (список)

Укажите источники данных для монтирования файлов только для чтения из S3 в ваше моделирование. Эти файлы доступны по пути /opt/robomaker/datasources/data_source_name.

Примечание

Существует ограничение в 100 файлов и общий размер 25 ГБ для всех объектов DataSourceConfig.

(структура)

Информация об источнике данных.

name -> (строка)

Имя источника данных.

s3Bucket -> (строка)

Ведро S3, в котором расположены файлы данных.

s3Keys -> (список)

Список ключей S3, определяющих файлы источника данных.

(строка)

type -> (строка)

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

Если вы не указываете поле, значение по умолчанию - File.

destination -> (строка)

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

Если вы указали type источника данных как Archive, вы должны предоставить ключ объекта Amazon S3 для своего архива. Ключ объекта должен указывать на файл .zip или .tar.gz.

Если вы указали type источника данных как префикс Prefix, вы предоставляете префикс Amazon S3, указывающий на файлы, которые вы используете для своего источника данных.

Если вы указали type источника данных как файл File, вы предоставляете путь Amazon S3 к файлу, который вы используете в качестве источника данных.

Упрощённый синтаксис:

name=string,s3Bucket=string,s3Keys=string,string,type=string,destination=string ...

Синтаксис JSON:

[
  {
    "name": "string",
    "s3Bucket": "string",
    "s3Keys": ["string", ...],
    "type": "Prefix"|"Archive"|"File",
    "destination": "string"
  }
  ...
]

--tags (массив)

Массив, содержащий ключи и значения тегов, которые прикреплены к задаче моделирования.

key -> (строка)

value -> (строка)

Упрощённый синтаксис:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--vpc-config (структура)

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

subnets -> (список)

Список одного или нескольких идентификаторов подсетей в вашей VPC.

(строка)

securityGroups -> (список)

Список одного или нескольких идентификаторов групп безопасности в вашей VPC.

(строка)

assignPublicIp -> (булево)

Булево значение, указывающее, нужно ли назначить публичный IP-адрес.

Упрощённый синтаксис:

subnets=string,string,securityGroups=string,string,assignPublicIp=boolean

Синтаксис JSON:

{
  "subnets": ["string", ...],
  "securityGroups": ["string", ...],
  "assignPublicIp": true|false
}

--compute (структура)

Информация о вычислительных ресурсах для задачи моделирования.

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

Предел единиц моделирования. Вашему моделированию выделяется процессорное время и память пропорционально предоставленному пределу единиц моделирования. Одна единица моделирования — это 1 vCPU и 2 ГБ памяти. Вы оплачиваете только использованные единицы моделирования до максимального значения, предоставленного вами. По умолчанию 15.

computeType -> (строка)

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

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

Предел единиц вычислительных ресурсов GPU для задачи моделирования. Соответствует количеству GPU, выделенных для SimulationJob.

Упрощённый синтаксис:

simulationUnitLimit=integer,computeType=string,gpuUnitLimit=integer

Синтаксис JSON:

{
  "simulationUnitLimit": integer,
  "computeType": "CPU"|"GPU_AND_CPU",
  "gpuUnitLimit": integer
}

--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 (boolean)

Включить отладку логов.

--endpoint-url (string)

Переопределить URL команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию, AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение по умолчанию проверки SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

json
text
table
yaml
yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/отключить цветной вывод.

on
off
auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде base64-кодированной строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (boolean)

Отключить вывод страницы CLI.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для создания задания моделирования

В этом примере создаётся задание моделирования. Используется приложение робота и приложение моделирования.

Команда:

aws robomaker create-simulation-job --max-job-duration-in-seconds 3600 --iam-role arn:aws:iam::111111111111:role/AWSRoboMakerCloudWatch-154766341-SimulationJobRole-G0OBWTQ8YBG6 --robot-applications application=arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821,launchConfig={packageName=hello_world_robot,launchFile=rotate.launch} --simulation-applications application=arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605,launchConfig={packageName=hello_world_simulation,launchFile=empty_world.launch} --tags Region=North

Вывод:

{
  "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-w7m68wpr05h8",
  "status": "Pending",
  "lastUpdatedAt": 1551213837.0,
  "failureBehavior": "Fail",
  "clientRequestToken": "b283ccce-e468-43ee-8642-be76a9d69f15",
  "maxJobDurationInSeconds": 3600,
  "simulationTimeMillis": 0,
  "iamRole": "arn:aws:iam::111111111111:role/MySimulationRole",
  "robotApplications": [
      {
          "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821",
          "applicationVersion": "$LATEST",
          "launchConfig": {
              "packageName": "hello_world_robot",
              "launchFile": "rotate.launch"
          }
      }
  ],
  "simulationApplications": [
      {
          "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605",
          "applicationVersion": "$LATEST",
          "launchConfig": {
              "packageName": "hello_world_simulation",
              "launchFile": "empty_world.launch"
          }
      }
  ],
  "tags": {
      "Region": "North"
  }
}

Вывод

arn -> (строка)

Идентификатор ресурса Amazon (ARN) задания симуляции.

status -> (строка)

Статус задания симуляции.

lastStartedAt -> (временная метка)

Время, в миллисекундах с начала эпохи, когда задание симуляции было запущено в последний раз.

lastUpdatedAt -> (временная метка)

Время, в миллисекундах с начала эпохи, когда задание симуляции было в последний раз обновлено.

failureBehavior -> (строка)

Поведение при ошибке для задания симуляции.

failureCode -> (строка)

Код ошибки задания симуляции, если оно завершилось ошибкой:

InternalServiceError

Ошибка внутренней службы.

RobotApplicationCrash

Приложение робота аварийно завершило работу.

SimulationApplicationCrash

Приложение симуляции аварийно завершило работу.

BadPermissionsRobotApplication

Пакет приложения робота не может быть загружен.

BadPermissionsSimulationApplication

Пакет приложения симуляции не может быть загружен.

BadPermissionsS3Output

Невозможно опубликовать выходные данные в предоставленный пользователем S3-ведро.

BadPermissionsCloudwatchLogs

Невозможно опубликовать журналы в предоставленный пользователем ресурс CloudWatch Logs.

SubnetIpLimitExceeded

Превышен лимит IP-адресов подсети.

ENILimitExceeded

Превышен лимит ENI.

BadPermissionsUserCredentials

Невозможно использовать предоставленную роль.

InvalidBundleRobotApplication

Пакет робота не может быть распакован (неверный формат, ошибка объединения или другая проблема).

InvalidBundleSimulationApplication

Пакет симуляции не может быть распакован (неверный формат, ошибка объединения или другая проблема).

RobotApplicationVersionMismatchedEtag

Etag для RobotApplication не соответствует значению во время создания версии.

SimulationApplicationVersionMismatchedEtag

Etag для SimulationApplication не соответствует значению во время создания версии.

clientRequestToken -> (строка)

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

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

Расположение файлов выходных данных задания симуляции.

s3Bucket -> (строка)

S3-ведро для выходных данных.

s3Prefix -> (строка)

Папка S3 в s3Bucket, где будут размещены файлы выходных данных.

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

Конфигурация ведения журнала.

recordAllRosTopics -> (булево)

Булево значение, указывающее, нужно ли записывать все ROS-темы.

Предупреждение

Этот API больше не поддерживается и вызовет ошибку при использовании.

maxJobDurationInSeconds -> (длинное целое число)

Максимальная продолжительность задания симуляции в секундах.

simulationTimeMillis -> (длинное целое число)

Продолжительность выполнения задания симуляции в миллисекундах.

iamRole -> (строка)

Роль IAM, которая позволяет заданию симуляции вызывать API AWS, указанные в связанных политиках от вашего имени.

robotApplications -> (список)

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

(структура)

Информация о конфигурации приложения робота.

application -> (строка)

Информация об приложении робота.

applicationVersion -> (строка)

Версия приложения робота.

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

Конфигурация запуска приложения робота.

packageName -> (строка)

Имя пакета.

launchFile -> (строка)

Имя файла запуска.

environmentVariables -> (отображение)

Переменные среды для запуска приложения.

ключ -> (строка)

значение -> (строка)

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

Конфигурация переадресации портов.

portMappings -> (список)

Сопоставления портов для конфигурации.

(структура)

Объект, представляющий сопоставление портов.

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

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

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

Номер порта в приложении.

enableOnPublicIp -> (булево)

Булево значение, указывающее, следует ли включить это сопоставление портов на общедоступном IP-адресе.

streamUI -> (булево)

Булево значение, указывающее, будет ли настроена сессия потоковой передачи для приложения. Если True, AWS RoboMaker настроит соединение, чтобы вы могли взаимодействовать с вашим приложением во время его работы в симуляции. Вы должны настроить и запустить компонент. Он должен иметь графический интерфейс пользователя.

command -> (список)

(строка)

uploadConfigurations -> (список)

Конфигурации загрузки для приложения робота.

(структура)

Предоставляет информацию о конфигурации загрузки. Файлы загружаются из задания симуляции в указанное вами место.

name -> (строка)

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

Например, если расположение выходных данных вашей симуляции s3://amzn-s3-demo-bucket, а имя вашей конфигурации загрузки robot-test, ваши файлы будут загружены в s3://amzn-s3-demo-bucket/<simid>/<runid>/robot-test.

path -> (строка)

Указывает путь к файлу(ам) для загрузки. Принимаются стандартные правила сопоставления Unix glob, с добавлением ** в качестве суперзвездочки. Например, указание /var/log/**.log приведет к сбору всех файлов .log в дереве каталогов /var/log. Для получения дополнительных примеров см. Библиотеку Glob.

uploadBehavior -> (строка)

Указывает, когда загружать файлы:

UPLOAD_ON_TERMINATE

Соответствующие файлы загружаются, когда симуляция переходит в состояние TERMINATING. Соответствующие файлы не загружаются, пока весь ваш код (включая инструменты) не остановится.

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

UPLOAD_ROLLING_AUTO_REMOVE

Соответствующие файлы загружаются по мере их создания. Они удаляются после загрузки. Указанный путь проверяется каждые 5 секунд. Окончательная проверка выполняется, когда весь ваш код (включая инструменты) остановится.

useDefaultUploadConfigurations -> (булево)

Булево значение, указывающее, следует ли использовать значения по умолчанию для конфигураций загрузки. По умолчанию .ros и .gazebo файлы загружаются при завершении работы приложения и все ROS-темы будут записаны.

Если вы установите это значение, вы должны указать outputLocation.

Предупреждение

Этот API больше не поддерживается и вызовет ошибку при использовании.

tools -> (список)

Информация об инструментах, настроенных для приложения робота.

(структура)

Информация об инструменте. Инструменты используются в задании симуляции.

streamUI -> (булево)

Булево значение, указывающее, будет ли настроена сессия потоковой передачи для инструмента. Если True, AWS RoboMaker настроит соединение, чтобы вы могли взаимодействовать с инструментом во время его работы в симуляции. Он должен иметь графический интерфейс пользователя. По умолчанию False.

name -> (строка)

Имя инструмента.

command -> (строка)

Аргументы командной строки для инструмента. Он должен включать имя исполняемого файла инструмента.

streamOutputToCloudWatch -> (булево)

Булево значение, указывающее, будут ли журналы записываться в CloudWatch для инструмента. По умолчанию False.

exitBehavior -> (строка)

Поведение при завершении определяет, что происходит при выходе вашего инструмента. RESTART заставит ваш инструмент перезапуститься. FAIL заставит ваше задание завершиться. По умолчанию RESTART.

useDefaultTools -> (булево)

Предупреждение

Этот API больше не поддерживается и вызовет ошибку при использовании.

simulationApplications -> (список)

Применённое приложение моделирования для задания моделирования.

(структура)

Информация о конфигурации приложения моделирования.

application -> (строка)

Информация об приложении моделирования.

applicationVersion -> (строка)

Версия приложения моделирования.

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

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

packageName -> (строка)

Имя пакета.

launchFile -> (строка)

Имя файла запуска.

environmentVariables -> (карта)

Переменные среды для запуска приложения.

key -> (строка)

value -> (строка)

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

Конфигурация переадресации портов.

portMappings -> (список)

Сопоставления портов для конфигурации.

(структура)

Объект, представляющий сопоставление портов.

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

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

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

Номер порта в приложении.

enableOnPublicIp -> (булево)

Булево значение, указывающее, следует ли включить это сопоставление портов на общедоступном IP-адресе.

streamUI -> (булево)

Булево значение, указывающее, будет ли настроена сессия потоковой передачи для приложения. Если True, AWS RoboMaker настроит подключение, чтобы вы могли взаимодействовать со своим приложением во время его работы в моделировании. Вам необходимо настроить и запустить компонент. Он должен иметь графический интерфейс пользователя.

command -> (список)

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

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

(строка)

uploadConfigurations -> (список)

Информация о конфигурациях загрузки для приложения моделирования.

(структура)

Предоставляет информацию о конфигурации загрузки. Файлы загружаются из задания моделирования в указанное вами расположение.

name -> (строка)

Префикс, указывающий, куда файлы будут загружены в Amazon S3. Он добавляется к расположению вывода задания моделирования, чтобы определить конечный путь.

Например, если расположение вывода вашего задания моделирования — s3://amzn-s3-demo-bucket, а имя вашей конфигурации загрузки — robot-test, ваши файлы будут загружены в s3://amzn-s3-demo-bucket/<simid>/<runid>/robot-test.

path -> (строка)

Указывает путь к файлам для загрузки. Принимаются стандартные правила соответствия Unix glob, с добавлением ** в качестве суперзвездочки. Например, указание /var/log/**.log приводит к сбору всех файлов .log в дереве каталогов /var/log. Для получения дополнительных примеров см. Библиотеку Glob.

uploadBehavior -> (строка)

Указывает, когда загружать файлы:

UPLOAD_ON_TERMINATE

Соответствующие файлы загружаются после того, как моделирование переходит в состояние TERMINATING. Соответствующие файлы не загружаются до тех пор, пока весь ваш код (включая инструменты) не остановится.

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

UPLOAD_ROLLING_AUTO_REMOVE

Соответствующие файлы загружаются по мере их создания. Они удаляются после загрузки. Указанный путь проверяется каждые 5 секунд. Окончательная проверка выполняется после остановки всего вашего кода (включая инструменты).

worldConfigs -> (список)

Список конфигураций мира.

Предупреждение

Этот API больше не поддерживается и вызовет ошибку при использовании.

(структура)

Информация о конфигурации мира.

world -> (строка)

Мир, сгенерированный Simulation WorldForge.

useDefaultUploadConfigurations -> (булево)

Булево значение, указывающее, следует ли использовать значения по умолчанию для конфигураций загрузки. По умолчанию файлы .ros и .gazebo загружаются при завершении работы приложения, а все темы ROS будут записаны.

Если вы установите это значение, вы должны указать outputLocation.

Предупреждение

Этот API больше не поддерживается и вызовет ошибку при использовании.

tools -> (список)

Информация об инструментах, настроенных для приложения моделирования.

(структура)

Информация об инструменте. Инструменты используются в задании моделирования.

streamUI -> (булево)

Булево значение, указывающее, будет ли настроена сессия потоковой передачи для инструмента. Если True, AWS RoboMaker настроит подключение, чтобы вы могли взаимодействовать с инструментом во время его работы в моделировании. Он должен иметь графический интерфейс пользователя. Значение по умолчанию — False.

name -> (строка)

Имя инструмента.

command -> (строка)

Аргументы командной строки для инструмента. Должно включать имя исполняемого файла инструмента.

streamOutputToCloudWatch -> (булево)

Булево значение, указывающее, будут ли логи записываться в CloudWatch для инструмента. Значение по умолчанию — False.

exitBehavior -> (строка)

Поведение при выходе определяет, что происходит при завершении работы вашего инструмента. RESTART заставит ваш инструмент перезапуститься. FAIL заставит задание выйти. Значение по умолчанию — RESTART.

useDefaultTools -> (булево)

Булево значение, указывающее, следует ли использовать инструменты по умолчанию для приложения моделирования. Инструменты по умолчанию — rviz, rqt, терминал и rosbag record. Значение по умолчанию — False.

Предупреждение

Этот API больше не поддерживается и вызовет ошибку при использовании.

dataSources -> (список)

Источники данных для задания моделирования.

(структура)

Информация об источнике данных.

name -> (строка)

Имя источника данных.

s3Bucket -> (строка)

Ведро S3, в котором находятся файлы данных.

s3Keys -> (список)

Список ключей S3, определяющих файлы источника данных.

(структура)

Информация о ключах S3.

s3Key -> (строка)

Ключ S3.

etag -> (строка)

Элемент хеширования (etag) для объекта.

type -> (строка)

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

Если вы не укажете поле, значение по умолчанию — File.

destination -> (строка)

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

Если вы указали type источника данных как Archive, вам необходимо предоставить ключ объекта Amazon S3 для своего архива. Ключ объекта должен указывать на либо .zip, либо .tar.gz файл.

Если вы указали type источника данных как Prefix, вы предоставляете префикс Amazon S3, указывающий на файлы, которые вы используете для своего источника данных.

Если вы указали type источника данных как File, вы предоставляете путь Amazon S3 к файлу, который вы используете в качестве источника данных.

tags -> (карта)

Список всех тегов, добавленных к заданию моделирования.

key -> (строка)

value -> (строка)

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

Информация о конфигурации VPC.

subnets -> (список)

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

(строка)

securityGroups -> (список)

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

(строка)

vpcId -> (строка)

Идентификатор VPC, связанный с вашим заданием моделирования.

assignPublicIp -> (булево)

Булево значение, указывающее, был ли назначен общедоступный IP-адрес.

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

Информация о вычислительных ресурсах для задания моделирования.

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

Предел единиц моделирования. Вашему моделированию выделяется ЦП и память пропорционально предоставленному пределу единиц моделирования. Единица моделирования — 1 виртуальный процессор и 2 ГБ оперативной памяти. Вы оплачиваете только используемые единицы моделирования до максимального предоставленного значения. Значение по умолчанию — 15.

computeType -> (строка)

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

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

Предел единиц GPU для задания моделирования. Он равен количеству видеокарт, выделенных заданию моделирования.

END_OF_DOCUMENT_MARKER