обновить-местоположение-хранилище-объектов

Описание

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

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

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

Синтаксис

  update-location-object-storage
--location-arn <value>
[--server-port <value>]
[--server-protocol <value>]
[--subdirectory <value>]
[--server-hostname <value>]
[--access-key <value>]
[--secret-key <value>]
[--agent-arns <value>]
[--server-certificate <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]

Параметры

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

Указывает ARN местоположения системы хранения объектов, которое необходимо обновить.

--server-port (целое число)

Указывает порт, на котором сервер системы хранения объектов принимает входящий сетевой трафик (например, порт 443).

--server-protocol (строка)

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

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

HTTPS
HTTP

--subdirectory (строка)

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

--server-hostname (строка)

Указывает доменное имя или IP-адрес версии 4 (IPv4) сервера системы хранения объектов, к которому подключается агент DataSync.

--access-key (строка)

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

--secret-key (строка)

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

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

Указывает Amazon Resource Names (ARN) агентов DataSync, которые могут подключаться к вашей системе хранения объектов.

(строка)

Синтаксис:

"string" "string" ...

--server-certificate (бинарный)

Указывает цепочку сертификатов для аутентификации DataSync с вашей системой хранения объектов, если система использует частный или самозаверенный центр сертификации (CA). Необходимо указать один .pem файл с полной цепочкой сертификатов (например, file:///home/user/.ssh/object_storage_certificates.pem).

Цепочка сертификатов может включать:

Сертификат системы хранения объектов
Все промежуточные сертификаты (если они есть)
Корневой сертификат подписывающего CA

Вы можете объединить свои сертификаты в .pem файл (который может содержать до 32768 байт до кодирования в base64). Следующий пример cat команды создаёт object_storage_certificates.pem файл, включающий три сертификата:

cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem

Для использования этого параметра настройте ServerProtocol на HTTPS.

Обновление этого параметра не влияет на текущие задачи.

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

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве «Начало работы» в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для обновления местоположения передачи с новым агентом

В следующем update-location-object-storage примере местоположение DataSync системы хранения объектов обновляется с новым агентом.

aws datasync update-location-object-storage \
    --location-arn arn:aws:datasync:us-west-2:123456789012:location/loc-abcdef01234567890 \
    --agent-arns arn:aws:datasync:us-west-2:123456789012:agent/agent-1234567890abcdef0 \
    --secret-key secret-key-for-object-storage

Эта команда не генерирует выходных данных.

Для получения дополнительной информации см. Замена агента в Руководстве пользователя AWS DataSync.

Вывод

Нет