Spec-Zone.ru › AWS CLI v2

[ aws . efs ]

create-replication-configuration

Описание

Создаёт конфигурацию репликации для нового или существующего файлового сервера EFS. Дополнительную информацию см. в разделе Amazon EFS replication в руководстве пользователя Amazon EFS. Конфигурация репликации определяет следующее:

  • Исходный файловый сервер – файловый сервер EFS, который требуется скопировать.
  • Целевой файловый сервер – целевой файловый сервер, в который копируется исходный файловый сервер. В конфигурации репликации может быть только один целевой файловый сервер.

Примечание

Файловый сервер может быть частью только одной конфигурации репликации.

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

Для этой операции требуются разрешения для действия elasticfilesystem:CreateReplicationConfiguration. Кроме того, требуются другие разрешения в зависимости от способа копирования файловых систем. Дополнительную информацию см. в разделе Требуемые разрешения для репликации в руководстве пользователя Amazon EFS.

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

Синтаксис

  create-replication-configuration
--source-file-system-id <value>
--destinations <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-file-system-id (строка)

Указывает файловый сервер Amazon EFS, который вы хотите скопировать. Этот файловый сервер не может быть исходным или целевым файловым сервером в другой конфигурации репликации.

--destinations (список)

Массив объектов конфигурации назначения. Поддерживается только один объект конфигурации назначения.

(структура)

Описывает новый или существующий целевой файловый сервер для конфигурации репликации.

  • Если вы хотите скопировать на новый файловый сервер, не указывайте ID файлового сервера для целевого файлового сервера. Amazon EFS создаст новый пустой файловый сервер. Для хранения в одной зоне укажите зону доступности для создания файлового сервера. Чтобы использовать ключ управления ключами (KMS), отличный от ключа KMS по умолчанию, укажите его. Дополнительную информацию см. в разделе Настройка репликации на новый файловый сервер Amazon EFS в руководстве пользователя Amazon EFS.

Примечание

После создания файлового сервера вы не сможете изменить ключ KMS или режим производительности.
  • Если вы хотите скопировать на существующий файловый сервер в той же учётной записи, что и исходный файловый сервер, вам необходимо указать ID или Amazon Resource Name (ARN) файлового сервера для копирования. Защита от перезаписи репликации файлового сервера должна быть отключена. Дополнительную информацию см. в разделе Копирование на существующий файловый сервер в руководстве пользователя Amazon EFS.
  • Если вы копируете файловый сервер на файловый сервер в другой учётной записи, отличной от исходной (репликация между учётными записями), вам необходимо указать ARN файлового сервера и роль IAM, которая позволяет Amazon EFS выполнять репликацию в целевой учётной записи. Защита от перезаписи репликации файлового сервера должна быть отключена. Дополнительную информацию см. в разделе Копирование между учётными записями Amazon Web Services в руководстве пользователя Amazon EFS.

Region -> (строка)

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

AvailabilityZoneName -> (строка)

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

KmsKeyId -> (строка)

Укажите ключ управления ключами (KMS), который вы хотите использовать для шифрования целевого файлового сервера. Если вы не укажете ключ KMS, Amazon EFS использует ваш ключ KMS по умолчанию для Amazon EFS, /aws/elasticfilesystem. Этот идентификатор может быть в одном из следующих форматов:

  • Идентификатор ключа – уникальный идентификатор ключа, например 1234abcd-12ab-34cd-56ef-1234567890ab.
  • ARN – ARN для ключа, например arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.
  • Псевдоним ключа – ранее созданное отображаемое имя ключа, например alias/projectKey1.
  • ARN псевдонима ключа – ARN для псевдонима ключа, например arn:aws:kms:us-west-2:444455556666:alias/projectKey1.

FileSystemId -> (строка)

ID или ARN файлового сервера для использования в качестве целевого. Для репликации между учётными записями это должен быть ARN. Защита от перезаписи репликации файлового сервера должна быть отключена. Если ID или ARN не указаны, создаётся новый файловый сервер.

RoleArn -> (строка)

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

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

Region=string,AvailabilityZoneName=string,KmsKeyId=string,FileSystemId=string,RoleArn=string ...

Синтаксис JSON:

[
  {
    "Region": "string",
    "AvailabilityZoneName": "string",
    "KmsKeyId": "string",
    "FileSystemId": "string",
    "RoleArn": "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.

Вывод

SourceFileSystemId -> (строка)

Идентификатор источника Amazon EFS файловой системы, которая реплицируется.

SourceFileSystemRegion -> (строка)

Регион Amazon Web Services, в котором расположена исходная файловая система EFS.

SourceFileSystemArn -> (строка)

Идентификатор ресурса Amazon (ARN) текущей исходной файловой системы в конфигурации репликации.

OriginalSourceFileSystemArn -> (строка)

Идентификатор ресурса Amazon (ARN) исходной файловой системы EFS по умолчанию в конфигурации репликации.

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

Описание времени создания конфигурации репликации.

Destinations -> (список)

Массив объектов назначения. Поддерживается только один объект назначения.

(структура)

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

Status -> (строка)

Описание состояния конфигурации репликации. Дополнительную информацию о статусе репликации см. в руководстве пользователя Amazon EFS.

FileSystemId -> (строка)

Идентификатор целевой файловой системы Amazon EFS.

Region -> (строка)

Регион Amazon Web Services, в котором расположена файловая система назначения.

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

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

OwnerId -> (строка)

Идентификатор учетной записи Amazon Web Services, в которой расположена целевая файловая система.

StatusMessage -> (строка)

Сообщение, предоставляющее подробности о состоянии PAUSED или ERRROR конфигурации репликации назначения. Дополнительную информацию о сообщениях состояния репликации см. в руководстве пользователя Amazon EFS.

RoleArn -> (строка)

Идентификатор ресурса Amazon (ARN) роли IAM в исходной учетной записи, которая разрешает Amazon EFS выполнять репликацию от ее имени. Это необязательно для репликации в одной учетной записи и требуется для кросс-учетной репликации.

SourceFileSystemOwnerId -> (строка)

Идентификатор учетной записи Amazon Web Services, в которой расположена исходная файловая система.

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

Spec-Zone.ru

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