Spec-Zone.ru › AWS CLI v2

[ aws . discovery ]

start-import-task

Описание

Запускает задачу импорта, которая позволяет импортировать данные вашей локальной среды непосредственно в Amazon Web Services Migration Hub без необходимости использования инструментов Amazon Web Services Application Discovery Service (Application Discovery Service), таких как Amazon Web Services Application Discovery Service Agentless Collector или Application Discovery Agent. Это даёт вам возможность выполнить оценку миграции и планирование непосредственно по импортированным данным, включая возможность группировать ваши устройства в приложения и отслеживать их статус миграции.

Для запуска запроса на импорт выполните следующие действия:

  • Загрузите шаблон импорта в формате CSV со специальным форматированием, который можно найти здесь: https://s3.us-west-2.amazonaws.com/templates-7cffcf56-bd96-4b1c-b45b-a5b42f282e46/import_template.csv .
  • Заполните шаблон данными о серверах и приложениях.
  • Загрузите файл импорта в ведро Amazon S3 и запишите URL-адрес объекта. Файл импорта должен быть в формате CSV.
  • Используйте консоль или команду StartImportTask с Amazon Web Services CLI или одним из Amazon Web Services SDK для импорта записей из вашего файла.

Дополнительную информацию, включая пошаговые инструкции, см. в руководстве пользователя Amazon Web Services Application Discovery Service Руководство пользователя Amazon Web Services Application Discovery Service в разделе «Импорт в Migration Hub».

Примечание

Существуют ограничения на количество задач импорта, которые можно создать (и удалить) в учетной записи Amazon Web Services. Дополнительную информацию см. в разделе «Ограничения Amazon Web Services Application Discovery Service» в Руководстве пользователя Amazon Web Services Application Discovery Service.

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

Синтаксис

  start-import-task
[--client-request-token <value>]
--name <value>
--import-url <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 (строка)

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

Отправка более одного запроса StartImportTask с тем же маркером запроса клиента вернёт информацию об исходной задаче импорта с этим маркером.

--name (строка)

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

--import-url (строка)

URL-адрес файла импорта, который вы загрузили в Amazon S3.

Примечание

Если вы используете Amazon Web Services CLI, этот URL имеет следующий формат: s3://BucketName/ImportFileName.CSV

--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
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • включено
  • выключено
  • автоматически

--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.

Вывод

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

Массив информации, связанной с запросом на задачу импорта, включая информацию о статусе, времени, идентификаторах, URL-адресе объекта Amazon S3 для файла импорта и др.

importTaskId -> (строка)

Уникальный идентификатор для определённой задачи импорта. Эти идентификаторы не являются глобально уникальными, но они уникальны в пределах учетной записи Amazon Web Services.

clientRequestToken -> (строка)

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

name -> (строка)

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

importUrl -> (строка)

URL-адрес файла импорта, который вы загрузили в Amazon S3.

status -> (строка)

Статус задачи импорта. Задача импорта может иметь статус IMPORT_COMPLETE и при этом некоторые записи могут не быть импортированы из общего запроса. Дополнительную информацию можно найти в загружаемом архиве, определённом в поле errorsAndFailedEntriesZip, или в консоли управления Migration Hub.

importRequestTime -> (отметка времени)

Время отправки запроса на задачу импорта в формате отметки времени Unix.

importCompletionTime -> (отметка времени)

Время завершения запроса на задачу импорта в формате отметки времени Unix.

importDeletedTime -> (отметка времени)

Время удаления запроса на задачу импорта в формате отметки времени Unix.

fileClassification -> (строка)

Тип файла, определённый задачей импорта.

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

Общее количество записей серверов в файле импорта, которые были успешно импортированы.

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

Общее количество записей серверов в файле импорта, которые не были импортированы.

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

Общее количество записей приложений в файле импорта, которые были успешно импортированы.

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

Общее количество записей приложений в файле импорта, которые не были импортированы.

errorsAndFailedEntriesZip -> (строка)

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

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

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

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

Spec-Zone.ru

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