Spec-Zone.ru › AWS CLI v2

[ aws . datasync ]

создать-местоположение-s3

Описание

Создает местоположение передачи для ведра Amazon S3. DataSync может использовать это местоположение в качестве источника или назначения для передачи данных.

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

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

  • Учет особенностей хранения при использовании местоположений Amazon S3
  • Оценка затрат на запросы S3 при использовании DataSync

Дополнительную информацию см. в разделе Настройка передач с Amazon S3.

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

Синтаксис

  create-location-s3
[--subdirectory <value>]
--s3-bucket-arn <value>
[--s3-storage-class <value>]
--s3-config <value>
[--agent-arns <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]

Параметры

--subdirectory (строка)

Указывает префикс в ведре S3, из которого DataSync читает или в который записывает (в зависимости от того, является ли ведро местоположением источника или назначения).

Примечание

DataSync не может передавать объекты с префиксом, начинающимся с косой черты (/ ) или содержащим // , /./ или /../ шаблоны. Например:

  • /photos
  • photos//2006/January
  • photos/./2006/February
  • photos/../2006/March

--s3-bucket-arn (строка)

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

Если ваше ведро S3 находится на ресурсе Outposts, вы должны указать точку доступа Amazon S3. Дополнительную информацию см. в разделе Управление доступом к данным с помощью точек доступа Amazon S3 в Руководстве пользователя Amazon S3.

--s3-storage-class (строка)

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

Для ведер в регионах Amazon Web Services по умолчанию используется класс хранения STANDARD . Для ведер на Outposts по умолчанию используется класс хранения OUTPOSTS .

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

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

  • STANDARD
  • STANDARD_IA
  • ONEZONE_IA
  • INTELLIGENT_TIERING
  • GLACIER
  • DEEP_ARCHIVE
  • OUTPOSTS
  • GLACIER_INSTANT_RETRIEVAL

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

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

Дополнительную информацию см. в разделе Предоставление DataSync доступа к ведрам S3.

BucketAccessRoleArn -> (строка)

Указывает ARN роли IAM, которую DataSync использует для доступа к вашему ведру S3.

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

BucketAccessRoleArn=string

Синтаксис JSON:

{
  "BucketAccessRoleArn": "string"
}

--agent-arns (список)

(Только Amazon S3 на Outposts) Указывает Amazon Resource Name (ARN) агента DataSync на вашем Outpost.

Дополнительную информацию см. в разделе Развертывание агента DataSync на Outposts.

(строка)

Синтаксис:

"string" "string" ...

--tags (список)

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

(структура)

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

Key -> (строка)

Ключ метки ресурса Amazon Web Services.

Value -> (строка)

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

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "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
  • текст
  • таблица
  • 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.

Вывод

LocationArn -> (строка)

ARN местоположения S3, которое вы создали.

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

Spec-Zone.ru

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