create-task

Описание

Настраивает задачу, которая определяет, где и как DataSync переносит ваши данные.

Задача включает в себя местоположение источника, местоположение назначения и параметры переноса (например, лимиты пропускной способности, расписание и многое другое).

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

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

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

Синтаксис

  create-task
--source-location-arn <value>
--destination-location-arn <value>
[--cloud-watch-log-group-arn <value>]
[--name <value>]
[--options <value>]
[--excludes <value>]
[--schedule <value>]
[--tags <value>]
[--includes <value>]
[--manifest-config <value>]
[--task-report-config <value>]
[--task-mode <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]

Параметры

--source-location-arn (строка)

Указывает ARN расположения источника вашего переноса.

--destination-location-arn (строка)

Указывает ARN расположения назначения вашего переноса.

--cloud-watch-log-group-arn (строка)

Указывает Amazon Resource Name (ARN) группы журналов Amazon CloudWatch для мониторинга вашей задачи.

Для задач в режиме «Улучшенный» вам ничего указывать не нужно. DataSync автоматически отправляет журналы в группу журналов CloudWatch с именем /aws/datasync.

--name (строка)

Указывает имя вашей задачи.

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

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

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 копирует следующие метаданные:
- Владельца объекта.
- Дискреционные списки управления доступом NTFS (DACL), определяющие, следует ли предоставлять доступ к объекту. DataSync не будет копировать системные списки управления доступом NTFS (SACL) с этим параметром.
OWNER_DACL_SACL - Для каждого копируемого объекта DataSync копирует следующие метаданные:
- Владельца объекта.
- Дискреционные списки управления доступом NTFS (DACL), определяющие, следует ли предоставлять доступ к объекту.
- 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"
}

--excludes (список)

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

(структура)

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

FilterType -> (строка)

Тип правила фильтра для применения. DataSync поддерживает только тип правила SIMPLE_PATTERN.

Value -> (строка)

Одна строка фильтра, состоящая из шаблонов включения или исключения. Шаблоны разделяются символом «|» (то есть, вертикальной чертой), например: /folder1|/folder2

Сокращенная синтаксическая запись:

FilterType=string,Value=string ...

Синтаксис JSON:

[
  {
    "FilterType": "SIMPLE_PATTERN",
    "Value": "string"
  }
  ...
]

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

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

ScheduleExpression -> (строка)

Устанавливает расписание задачи с помощью выражения cron или скорости.

Используйте выражения cron для расписания задач, которые выполняются в определенное время и день. Например, следующее выражение cron создает расписание задач, которое выполняется в 8:00 в первый среду каждого месяца:

cron(0 8 * * 3#1)

Используйте выражения скорости для расписания задач, которые выполняются с регулярным интервалом. Например, следующее выражение скорости создает расписание задач, которое выполняется каждые 12 часов:

rate(12 hours)

Дополнительную информацию о синтаксисе выражений cron и скорости см. в руководстве пользователя Amazon EventBridge ` Руководство пользователя Amazon EventBridge https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html`__.

Status -> (строка)

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

DataSync может автоматически отключить расписание, если ваша задача неоднократно завершается неудачно с той же ошибкой. Дополнительную информацию см. в разделе TaskScheduleDetails.

Сокращенная синтаксическая запись:

ScheduleExpression=string,Status=string

Синтаксис JSON:

{
  "ScheduleExpression": "string",
  "Status": "ENABLED"|"DISABLED"
}

--tags (список)

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

Теги — это пары ключ-значение, которые помогут вам управлять, фильтровать и искать свои ресурсы DataSync.

(структура)

Пара ключ-значение, представляющая один тег, примененный к ресурсу Amazon Web Services.

Key -> (строка)

Ключ тега ресурса Amazon Web Services.

Value -> (строка)

Значение тега ресурса Amazon Web Services.

Сокращенная синтаксическая запись:

Key=string,Value=string ...

Синтаксис JSON:

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

--includes (список)

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

(структура)

FilterType -> (строка)

Тип правила фильтра для применения. DataSync поддерживает только тип правила SIMPLE_PATTERN.

Value -> (строка)

Сокращенная синтаксическая запись:

FilterType=string,Value=string ...

Синтаксис JSON:

[
  {
    "FilterType": "SIMPLE_PATTERN",
    "Value": "string"
  }
  ...
]

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

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

При использовании этого параметра ваша учетная запись вызывающего (роль, которую вы используете с DataSync) должна иметь разрешение iam:PassRole. Политика AWSDataSyncFullAccess включает это разрешение.

Action -> (строка)

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

Format -> (строка)

Указывает формат файла вашего манифеста. Дополнительную информацию см. в разделе Создание манифеста.

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

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

Примечание

Вы должны указать этот параметр, если вы настраиваете новый манифест начиная с 7 февраля 2024 года.

Если вы этого не сделаете, вы получите код состояния 400 и ошибку ValidationException, указывающую, что вам не хватает роли IAM для доступа DataSync к ведру S3, где размещен ваш манифест. Дополнительную информацию см. в разделе Предоставление DataSync доступа к вашему манифесту.

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

Указывает ведро S3, где размещен ваш манифест.

ManifestObjectPath -> (строка)

Указывает ключевое имя объекта Amazon S3 вашего манифеста. Это может включать префикс (например, prefix/my-manifest.csv).

BucketAccessRoleArn -> (строка)

Указывает роль Identity and Access Management (IAM), которая позволяет DataSync получать доступ к вашему манифесту. Дополнительную информацию см. в разделе Предоставление DataSync доступа к вашему манифесту.

S3BucketArn -> (строка)

Указывает Amazon Resource Name (ARN) ведра S3, где размещен ваш манифест.

ManifestObjectVersionId -> (строка)

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

Сокращенная синтаксическая запись:

Action=string,Format=string,Source={S3={ManifestObjectPath=string,BucketAccessRoleArn=string,S3BucketArn=string,ManifestObjectVersionId=string}}

Синтаксис JSON:

{
  "Action": "TRANSFER",
  "Format": "CSV",
  "Source": {
    "S3": {
      "ManifestObjectPath": "string",
      "BucketAccessRoleArn": "string",
      "S3BucketArn": "string",
      "ManifestObjectVersionId": "string"
    }
  }
}

--task-report-config (структура)

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

При использовании этого параметра ваша учетная запись вызывающего (роль, с которой вы используете DataSync) должна иметь разрешение iam:PassRole. Политика AWSDataSyncFullAccess включает это разрешение.

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

Указывает Amazon S3-ведро, в которое DataSync загружает отчет о задаче. Для получения дополнительной информации см. Отчеты о задачах.

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

Указывает Amazon S3-ведро, в которое DataSync загружает отчет о задаче.

Subdirectory -> (строка)

Указывает префикс ведра для вашего отчета.

S3BucketArn -> (строка)

Указывает ARN S3-ведра, в которое DataSync загружает отчет.

BucketAccessRoleArn -> (строка)

Указывает Amazon Resource Name (ARN) политики IAM, которая позволяет DataSync загружать отчет о задаче в ваше S3-ведро. Для получения дополнительной информации см. Разрешение DataSync на загрузку отчета о задаче в Amazon S3-ведро.

OutputType -> (строка)

Указывает тип отчета о задаче, который вы хотите:

SUMMARY_ONLY: Предоставляет необходимые подробности о вашей задаче, включая количество переданных файлов, объектов и каталогов, а также время передачи.
STANDARD: Предоставляет полные подробности о вашей задаче, включая полный список файлов, объектов и каталогов, которые были переданы, пропущены, проверены и т. д.

ReportLevel -> (строка)

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

ERRORS_ONLY: Отчет показывает, что DataSync не удалось передать, пропустить, проверить и удалить.
SUCCESSES_AND_ERRORS: Отчет показывает, что DataSync смог и не смог передать, пропустить, проверить и удалить.

ObjectVersionIds -> (строка)

Указывает, включает ли ваш отчет о задаче новую версию каждого объекта, переданного в S3-ведро. Это применимо только в случае, если вы включили версионирование в вашем ведре. Имейте в виду, что установка этого значения на INCLUDE может увеличить время выполнения вашей задачи.

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

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

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

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

ReportLevel -> (строка)

Указывает, включает ли ваш отчет о задаче только ошибки или успехи и ошибки.

Например, ваш отчет может в основном включать только то, что не удалось в вашей передаче (ERRORS_ONLY). В то же время вы хотите проверить, что ваш фильтр задач работает правильно. В этом случае вы можете получить список файлов, которые DataSync успешно пропустил, и если что-то было передано, чего вы не хотели передавать (SUCCESSES_AND_ERRORS).

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

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

ReportLevel -> (строка)

Указывает, включает ли ваш отчет о задаче только ошибки или успехи и ошибки.

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

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

ReportLevel -> (строка)

Указывает, включает ли ваш отчет о задаче только ошибки или успехи и ошибки.

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

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

ReportLevel -> (строка)

Указывает, включает ли ваш отчет о задаче только ошибки или успехи и ошибки.

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

Destination={S3={Subdirectory=string,S3BucketArn=string,BucketAccessRoleArn=string}},OutputType=string,ReportLevel=string,ObjectVersionIds=string,Overrides={Transferred={ReportLevel=string},Verified={ReportLevel=string},Deleted={ReportLevel=string},Skipped={ReportLevel=string}}

Синтаксис JSON:

{
  "Destination": {
    "S3": {
      "Subdirectory": "string",
      "S3BucketArn": "string",
      "BucketAccessRoleArn": "string"
    }
  },
  "OutputType": "SUMMARY_ONLY"|"STANDARD",
  "ReportLevel": "ERRORS_ONLY"|"SUCCESSES_AND_ERRORS",
  "ObjectVersionIds": "INCLUDE"|"NONE",
  "Overrides": {
    "Transferred": {
      "ReportLevel": "ERRORS_ONLY"|"SUCCESSES_AND_ERRORS"
    },
    "Verified": {
      "ReportLevel": "ERRORS_ONLY"|"SUCCESSES_AND_ERRORS"
    },
    "Deleted": {
      "ReportLevel": "ERRORS_ONLY"|"SUCCESSES_AND_ERRORS"
    },
    "Skipped": {
      "ReportLevel": "ERRORS_ONLY"|"SUCCESSES_AND_ERRORS"
    }
  }
}

--task-mode (строка)

Указывает один из следующих режимов задач для передачи данных:

ENHANCED - Передача практически неограниченного количества объектов с более высокой производительностью, чем в режиме Basic. Задачи в режиме Enhanced оптимизируют процесс передачи данных, перечисляя, подготавливая, передавая и проверяя данные параллельно. Режим Enhanced в настоящее время доступен для передач между расположениями Amazon S3.

Примечание

Для создания задачи в режиме Enhanced роль IAM, которую вы используете для вызова операции CreateTask, должна иметь разрешение iam:CreateServiceLinkedRole.

BASIC (по умолчанию) - Передача файлов или объектов между хранилищами Amazon Web Services и всеми другими поддерживаемыми расположениями DataSync. Задачи в режиме Basic ограничены квотами на количество файлов, объектов и каталогов в наборе данных. Задачи в режиме Basic последовательно готовят, передают и проверяют данные, что делает их медленнее, чем режим Enhanced для большинства рабочих нагрузок.

Для получения дополнительной информации см. Различия в режимах задач.

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

BASIC
ENHANCED

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

Вывод

TaskArn -> (строка)

Amazon Resource Name (ARN) задачи.