Spec-Zone.ru › AWS CLI v2

[ aws . dms ]

start-replication-task-assessment-run

Описание

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

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

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

Синтаксис

  start-replication-task-assessment-run
--replication-task-arn <value>
--service-access-role-arn <value>
--result-location-bucket <value>
[--result-location-folder <value>]
[--result-encryption-mode <value>]
[--result-kms-key-arn <value>]
--assessment-run-name <value>
[--include-only <value>]
[--exclude <value>]
[--tags <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]

Параметры

--replication-task-arn (строка)

Amazon Resource Name (ARN) задачи миграции, связанной с запуском оценки предопределённой миграции, который вы хотите запустить.

--service-access-role-arn (строка)

ARN службы-роли, необходимой для запуска запуска оценки. Роль должна разрешать действие iam:PassRole.

--result-location-bucket (строка)

Ведро Amazon S3, в котором вы хотите, чтобы DMS хранил результаты этого запуска оценки.

--result-location-folder (строка)

Папка внутри ведра Amazon S3, в котором вы хотите, чтобы DMS хранил результаты этого запуска оценки.

--result-encryption-mode (строка)

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

  • "SSE_S3" – Шифрование на стороне сервера, предоставляемое по умолчанию Amazon S3.
  • "SSE_KMS" – Шифрование ключом управления ключами (KMS). Это шифрование может использовать либо пользовательский ключ шифрования KMS, который вы указываете, либо ключ шифрования KMS по умолчанию, предоставляемый DMS.

--result-kms-key-arn (строка)

ARN пользовательского ключа шифрования KMS, который вы указываете, когда устанавливаете ResultEncryptionMode в "SSE_KMS «.

--assessment-run-name (строка)

Уникальное имя для идентификации запуска оценки.

--include-only (список)

Список имён отдельных оценок, разделённых пробелами, которые вы хотите включить. Эти имена взяты из стандартного списка отдельных оценок, поддерживаемых DMS для связанной задачи миграции. Эта задача указана параметром ReplicationTaskArn.

Примечание

Вы не можете установить значение для IncludeOnly, если вы также установили значение для Exclude в операции API.

Чтобы определить имена стандартных отдельных оценок, поддерживаемых DMS для связанной задачи миграции, выполните операцию DescribeApplicableIndividualAssessments, используя свой собственный параметр запроса ReplicationTaskArn.

(строка)

Синтаксис:

"string" "string" ...

--exclude (список)

Список имён отдельных оценок, разделённых пробелами, которые вы хотите исключить. Эти имена взяты из стандартного списка отдельных оценок, поддерживаемых DMS для связанной задачи миграции. Эта задача указана параметром ReplicationTaskArn.

Примечание

Вы не можете установить значение для Exclude, если вы также установили значение для IncludeOnly в операции API.

Чтобы определить имена стандартных отдельных оценок, поддерживаемых DMS для связанной задачи миграции, выполните операцию DescribeApplicableIndividualAssessments, используя свой собственный параметр запроса ReplicationTaskArn.

(строка)

Синтаксис:

"string" "string" ...

--tags (список)

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

(структура)

Пользовательская пара ключ-значение, описывающая метаданные, добавленные к ресурсу DMS, и используемая такими операциями, как:

  • AddTagsToResource
  • ListTagsForResource
  • RemoveTagsFromResource

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

Ключ — это обязательное имя тега. Строковое значение может содержать от 1 до 128 Unicode символов и не может начинаться с «aws:» или «dms:». Строка может содержать только Unicode буквы, цифры, пробелы, «_», «.», «/», «=», «+», «-» (регулярные выражения Java: «^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$»).

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

Значение — это необязательное значение тега. Строковое значение может содержать от 1 до 256 Unicode символов и не может начинаться с «aws:» или «dms:». Строка может содержать только Unicode буквы, цифры, пробелы, «_», «.», «/», «=», «+», «-» (регулярные выражения Java: «^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$»).

ResourceArn -> (строка)

Строка Amazon Resource Name (ARN), уникально идентифицирующая ресурс, для которого создаётся тег.

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

Key=string,Value=string,ResourceArn=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string",
    "ResourceArn": "string"
  }
  ...
]

--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
  • таблица
  • 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.

Выходные данные

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

Запущенный предварительный анализ миграции.

ReplicationTaskAssessmentRunArn -> (строка)

Amazon Resource Name (ARN) этого запуска оценки.

ReplicationTaskArn -> (строка)

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

Статус -> (строка)

Статус запуска оценки.

Этот статус может иметь одно из следующих значений:

  • "cancelling" – Запуск оценки был отменён операцией CancelReplicationTaskAssessmentRun.
  • "deleting" – Запуск оценки был удалён операцией DeleteReplicationTaskAssessmentRun.
  • "failed" – По крайней мере одна отдельная оценка была завершена со статусом failed.
  • "error-provisioning" – Во время подготовки ресурсов (во время статуса provisioning) произошла внутренняя ошибка.
  • "error-executing" – Во время выполнения отдельных оценок произошла внутренняя ошибка (во время статуса running).
  • "invalid state" – Запуск оценки находится в неизвестном состоянии.
  • "passed" – Все отдельные оценки завершены, и ни одна не имеет статуса failed.
  • "provisioning" – Ресурсы, необходимые для выполнения отдельных оценок, готовятся.
  • "running" – Выполняются отдельные оценки.
  • "starting" – Запуск оценки начался, но ресурсы для отдельных оценок ещё не подготовлены.
  • "warning" – По крайней мере одна отдельная оценка была завершена со статусом warning или все отдельные оценки были пропущены (завершено со статусом skipped).

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

Дата создания запуска оценки с помощью операции StartReplicationTaskAssessmentRun.

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

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

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

Количество отдельных оценок, которые нужно запустить.

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

Количество отдельных оценок, которые были завершены, успешно или нет.

LastFailureMessage -> (строка)

Последнее сообщение, сгенерированное ошибкой отдельной оценки.

ServiceAccessRoleArn -> (строка)

ARN службы роли, используемой для запуска запуска оценки с помощью операции StartReplicationTaskAssessmentRun. Роль должна разрешать действие iam:PassRole.

ResultLocationBucket -> (строка)

Ведро Amazon S3, в котором DMS хранит результаты этого запуска оценки.

ResultLocationFolder -> (строка)

Папка в ведре Amazon S3, в котором DMS хранит результаты этого запуска оценки.

ResultEncryptionMode -> (строка)

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

ResultKmsKeyArn -> (строка)

ARN ключа шифрования KMS, используемого для шифрования результатов запуска оценки.

AssessmentRunName -> (строка)

Уникальное имя запуска оценки.

IsLatestTaskAssessmentRun -> (булево)

Указывает, что следующий PreflightAssessmentRun является последним для ReplicationTask. Статус может быть true или false.

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

Статистика результатов завершённого запуска оценки, отображающая агрегированную статистику IndividualAssessments о том, сколько оценок было пройдено, провалено или столкнулось с проблемами, такими как ошибки или предупреждения.

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

Количество отдельных оценок, которые успешно прошли все проверки в запуске оценки.

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

Количество отдельных оценок, которые не выполнили критерии, определённые в запуске оценки.

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

Количество отдельных оценок, которые столкнулись с критической ошибкой и не смогли завершить свою работу должным образом.

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

Указывает, что недавний завершённый AssessmentRun сгенерировал предупреждение.

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

Количество отдельных оценок, которые были отменены во время запуска оценки.

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

Количество отдельных оценок, которые были пропущены во время запуска оценки.

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

Spec-Zone.ru

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