update-task-execution

Описание

Обновляет конфигурацию выполняемого задания DataSync.

Примечание

В настоящее время единственное, что вы можете изменить, это `` BytesPerSecond ``, которое регулирует пропускную способность для выполняемого или находящегося в очереди задания.

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

Синтаксис

  update-task-execution
--task-execution-arn <value>
--options <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]

Параметры

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

Указывает Amazon Resource Name (ARN) выполняемого задания, которое вы обновляете.

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

Указывает, как настроен ваш процесс переноса данных. Эти параметры включают в себя способ обработки файлов, объектов и их метаданных DataSync во время переноса. Вы также можете указать, как проверить целостность данных, установить ограничения по пропускной способности для вашей задачи и т. д.

Каждый параметр имеет значение по умолчанию. Если вам не нужно, вы не должны настраивать ни один параметр перед вызовом StartTaskExecution.

Вы также можете переопределить параметры задачи для каждого выполнения. Например, вы можете захотеть настроить LogLevel для отдельного выполнения.

VerifyMode -> (строка)

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

ONLY_FILES_TRANSFERRED (рекомендуется) — DataSync вычисляет контрольную сумму перенесенных данных (включая метаданные) в источнике. В конце переноса DataSync сравнивает эту контрольную сумму с контрольной суммой, рассчитанной для этих данных в пункте назначения.

Примечание

Это параметр по умолчанию для задач в режиме Улучшенный .

Мы рекомендуем этот параметр при переносе данных в хранилища S3 Glacier Flexible Retrieval или S3 Glacier Deep Archive. Дополнительная информация в разделе Учет особенностей хранилища с Amazon S3-местоположениями .

POINT_IN_TIME_CONSISTENT — В конце переноса DataSync проверяет весь источник и пункт назначения, чтобы убедиться, что оба расположения полностью синхронизированы.

Примечание

Это параметр по умолчанию для задач в режиме Базовый и в настоящее время не поддерживается для задач в режиме Улучшенный.

Если вы используете манифест, DataSync сканирует и проверяет только то, что указано в манифесте. Вы не можете использовать этот параметр при переносе данных в хранилища S3 Glacier Flexible Retrieval или S3 Glacier Deep Archive. Дополнительная информация в разделе Учет особенностей хранилища с Amazon S3-местоположениями .

NONE — DataSync выполняет проверки целостности данных только во время переноса. В отличие от других параметров, дополнительной проверки в конце переноса нет.

OverwriteMode -> (строка)

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

ALWAYS (по умолчанию) — DataSync изменяет данные в пункте назначения, если исходные данные (включая метаданные) изменены. Если DataSync перезаписывает объекты, вы можете понести дополнительные расходы для определенных классов хранилищ Amazon S3 (например, для извлечения или раннего удаления). Дополнительная информация в разделе Учет особенностей хранилища при переносах с Amazon S3.
NEVER — DataSync не перезаписывает данные в пункте назначения, даже если данные источника изменены. Вы можете использовать этот параметр, чтобы защитить от перезаписи изменений, внесенных в файлы или объекты в пункте назначения.

Atime -> (строка)

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

Примечание

Поведение Atime не полностью стандартно на всех платформах, поэтому DataSync может выполнить это только в лучшем случае.

BEST_EFFORT (по умолчанию) — DataSync пытается сохранить исходное значение атрибута Atime для всех исходных файлов (то есть, версию до PREPARING этапов выполнения задачи). Этот параметр рекомендуется.
NONE — Игнорирует Atime.

Примечание

Если Atime установлен на BEST_EFFORT, то Mtime должен быть установлен на PRESERVE.

Если Atime установлен на NONE, то Mtime также должен быть NONE.

Mtime -> (строка)

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

PRESERVE (по умолчанию) — Сохраняет исходное значение Mtime, что рекомендуется.
NONE — Игнорирует Mtime.

Примечание

Если Mtime установлен на PRESERVE, то Atime должен быть установлен на BEST_EFFORT.

Если Mtime установлен на NONE, то Atime также должен быть установлен на NONE.

Uid -> (строка)

Указывает идентификатор пользователя POSIX (UID) владельца файла.

INT_VALUE (по умолчанию) — Сохраняет целочисленное значение UID и идентификатора группы (GID), что рекомендуется.
NONE — Игнорирует UID и GID.

Дополнительная информация в разделе Метаданные, копируемые DataSync.

Gid -> (строка)

Указывает идентификатор группы POSIX (GID) владельца файла.

INT_VALUE (по умолчанию) — Сохраняет целочисленное значение идентификатора пользователя (UID) и GID, что рекомендуется.
NONE — Игнорирует UID и GID.

Дополнительная информация в разделе Понимание, как DataSync обрабатывает метаданные файлов и объектов.

PreserveDeletedFiles -> (строка)

Указывает, должны ли сохраняться файлы в пункте назначения, которых нет в источнике. Этот параметр может повлиять на ваши затраты на хранение Amazon S3. Если ваша задача удаляет объекты, вы можете понести минимальные расходы на хранение для определенных классов хранилища. Подробная информация в разделе Учет особенностей хранения Amazon S3 при работе с DataSync.

PRESERVE (по умолчанию) — Игнорирует такие файлы назначения, что рекомендуется.
REMOVE — Удаляет файлы назначения, которые отсутствуют в источнике.

Примечание

Если вы устанавливаете этот параметр на REMOVE, то вы не можете установить TransferMode на ALL. При переносе всех данных DataSync не сканирует пункт назначения и не знает, что удалить.

PreserveDevices -> (строка)

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

Примечание

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

NONE (по умолчанию) — Игнорирует специальные устройства (рекомендуется).
PRESERVE — Сохраняет метаданные символьных и блочных устройств. Этот параметр в настоящее время не поддерживается для Amazon EFS.

PosixPermissions -> (строка)

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

Дополнительная информация в разделе Понимание, как DataSync обрабатывает метаданные файлов и объектов.

PRESERVE (по умолчанию) — Сохраняет разрешения в стиле POSIX, что рекомендуется.
NONE — Игнорирует разрешения в стиле POSIX.

Примечание

DataSync может сохранить существующие разрешения места расположения источника.

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

Ограничивает пропускную способность, используемую задачей DataSync. Например, если вы хотите, чтобы DataSync использовал максимум 1 МБ, установите это значение на 1048576 (=1024*1024).

Примечание

Не применимо к задачам в режиме Улучшенный.

TaskQueueing -> (строка)

Указывает, будут ли ваши задачи переноса помещены в очередь в определенных сценариях при запуске нескольких задач. По умолчанию это ENABLED.

LogLevel -> (строка)

Указывает тип логов, которые DataSync публикует в группе журналов Amazon CloudWatch Logs. Чтобы указать группу логов, см. CloudWatchLogGroupArn.

BASIC — Публикует логи с только основной информацией (например, об ошибках переноса).
TRANSFER — Публикует логи для всех файлов или объектов, которые ваша задача DataSync переносит и проверяет на целостность данных.
OFF — Логи не публикуются.

TransferMode -> (строка)

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

CHANGED (по умолчанию) — После начального полного переноса DataSync копирует только отличающиеся данные и метаданные между источником и пунктом назначения.
ALL — DataSync копирует все из источника в пункт назначения без сравнения различий между местами расположения.

SecurityDescriptorCopyFlags -> (строка)

Указывает, какие компоненты описателя безопасности SMB копируются из источника в целевые объекты.

Это значение используется только для переносов между местами расположения SMB и Amazon FSx для Windows File Server или между двумя местами расположения FSx для Windows File Server. Дополнительная информация в разделе Понимание, как DataSync обрабатывает метаданные файлов и объектов.

OWNER_DACL (по умолчанию) — Для каждого копируемого объекта DataSync копирует следующие метаданные:
- Владельца объекта.
- Дискреционные списки управления доступом (DACL) NTFS, которые определяют, предоставлять ли доступ к объекту. DataSync не будет копировать списки управления доступом NTFS (SACL) с этим параметром.
OWNER_DACL_SACL — Для каждого копируемого объекта DataSync копирует следующие метаданные:
- Владельца объекта.
- Дискреционные списки управления доступом (DACL) NTFS, которые определяют, предоставлять ли доступ к объекту.
- SACL, которые используются администраторами для регистрации попыток доступа к защищенному объекту. Для копирования SACL требуется предоставление дополнительных разрешений пользователю Windows, которого DataSync использует для доступа к вашему местоположению SMB. Подробная информация о выборе пользователя с нужными разрешениями в разделе необходимые разрешения для SMB , FSx для Windows File Server или FSx для ONTAP (в зависимости от типа местоположения в вашем переносе).
NONE — Ни один из компонентов описателя безопасности SMB не копируется. Целевые объекты принадлежат пользователю, который был предоставлен для доступа к целевому местоположению. DACL и SACL устанавливаются в соответствии с настройками целевого сервера.

ObjectTags -> (строка)

Указывает, хотите ли вы, чтобы DataSync PRESERVE метки объектов (поведение по умолчанию) при переносе между системами хранения объектов. Если вы хотите, чтобы ваша задача DataSync игнорировала метки объектов, укажите значение NONE.

Синтаксис сокращенного представления:

VerifyMode=string,OverwriteMode=string,Atime=string,Mtime=string,Uid=string,Gid=string,PreserveDeletedFiles=string,PreserveDevices=string,PosixPermissions=string,BytesPerSecond=long,TaskQueueing=string,LogLevel=string,TransferMode=string,SecurityDescriptorCopyFlags=string,ObjectTags=string

Синтаксис JSON:

{
  "VerifyMode": "POINT_IN_TIME_CONSISTENT"|"ONLY_FILES_TRANSFERRED"|"NONE",
  "OverwriteMode": "ALWAYS"|"NEVER",
  "Atime": "NONE"|"BEST_EFFORT",
  "Mtime": "NONE"|"PRESERVE",
  "Uid": "NONE"|"INT_VALUE"|"NAME"|"BOTH",
  "Gid": "NONE"|"INT_VALUE"|"NAME"|"BOTH",
  "PreserveDeletedFiles": "PRESERVE"|"REMOVE",
  "PreserveDevices": "NONE"|"PRESERVE",
  "PosixPermissions": "NONE"|"PRESERVE",
  "BytesPerSecond": long,
  "TaskQueueing": "ENABLED"|"DISABLED",
  "LogLevel": "OFF"|"BASIC"|"TRANSFER",
  "TransferMode": "CHANGED"|"ALL",
  "SecurityDescriptorCopyFlags": "NONE"|"OWNER_DACL"|"OWNER_DACL_SACL",
  "ObjectTags": "PRESERVE"|"NONE"
}

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

Вывод

Нет