Spec-Zone.ru › AWS CLI v2

[ aws . elasticache ]

start-migration

Описание

Запустить миграцию данных.

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

Синтаксис

  start-migration
--replication-group-id <value>
--customer-node-endpoint-list <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]

Параметры

--replication-group-id (строка)

Идентификатор группы репликации, в которую должны быть мигрированы данные.

--customer-node-endpoint-list (список)

Список конечных точек, из которых должны быть мигрированы данные. Для Valkey или Redis OSS (режим кластера отключен), список должен содержать только один элемент.

(структура)

Конечная точка, из которой должны быть мигрированы данные.

Адрес -> (строка)

Адрес узловой конечной точки

Порт -> (целое число)

Порт узловой конечной точки

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

Address=string,Port=integer ...

Синтаксис JSON:

[
  {
    "Address": "string",
    "Port": integer
  }
  ...
]

--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 (строка)

Включить/отключить цветной вывод.

  • вкл
  • выкл
  • авто

--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 версии 1, а двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, 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.

Для запуска миграции

Следующий start-migration мигрирует ваши данные с самохостингового Redis на Amazon EC2 в Amazon ElastiCache, используя движок Redis.

aws elasticache start-migration \
   --replication-group-id test \
   --customer-node-endpoint-list "Address='test.g2xbih.ng.0001.usw2.cache.amazonaws.com',Port=6379"

Вывод

{
    "ReplicationGroup": {
        "ReplicationGroupId": "test",
        "Description": "test",
        "GlobalReplicationGroupInfo": {},
        "Status": "modifying",
        "PendingModifiedValues": {},
        "MemberClusters": [
            "test-001",
            "test-002",
            "test-003"
        ],
        "NodeGroups": [
            {
                "NodeGroupId": "0001",
                "Status": "available",
                "PrimaryEndpoint": {
                    "Address": "test.g2xbih.ng.0001.usw2.cache.amazonaws.com",
                    "Port": 6379
                },
                "ReaderEndpoint": {
                    "Address": "test-ro.g2xbih.ng.0001.usw2.cache.amazonaws.com",
                    "Port": 6379
                },
                "NodeGroupMembers": [
                    {
                        "CacheClusterId": "test-001",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "test-001.g2xbih.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2a",
                        "CurrentRole": "primary"
                    },
                    {
                        "CacheClusterId": "test-002",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "test-002.g2xbih.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2c",
                        "CurrentRole": "replica"
                    },
                    {
                        "CacheClusterId": "test-003",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "test-003.g2xbih.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2b",
                        "CurrentRole": "replica"
                    }
                ]
            }
        ],
        "SnapshottingClusterId": "test-002",
        "AutomaticFailover": "enabled",
        "MultiAZ": "enabled",
        "SnapshotRetentionLimit": 1,
        "SnapshotWindow": "07:30-08:30",
        "ClusterEnabled": false,
        "CacheNodeType": "cache.r5.large",
        "TransitEncryptionEnabled": false,
        "AtRestEncryptionEnabled": false
    }
}

Для получения дополнительной информации см. раздел «Онлайн-миграция в ElastiCache» в руководстве пользователя ElastiCache.

Вывод

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

Содержит все атрибуты конкретной группы репликации Valkey или Redis OSS.

ReplicationGroupId -> (строка)

Идентификатор группы репликации.

Description -> (строка)

Описание группы репликации, заданное пользователем.

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

Имя глобального хранилища данных и роль этой группы репликации в глобальном хранилище данных.

GlobalReplicationGroupId -> (строка)

Имя глобального хранилища данных

GlobalReplicationGroupMemberRole -> (строка)

Роль группы репликации в глобальном хранилище данных. Может быть основной или вторичной.

Status -> (строка)

Текущее состояние этой группы репликации - creating , available , modifying , deleting , create-failed , snapshotting .

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

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

PrimaryClusterId -> (строка)

Идентификатор основного кластера, который применяется сразу (если --apply-immediately был указан) или в течение следующего окна технического обслуживания.

AutomaticFailoverStatus -> (строка)

Указывает состояние автоматического переключения для этой группы репликации Valkey или Redis OSS.

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

Состояние операции онлайн-перераспределения.

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

Представляет ход операции онлайн-перераспределения.

ProgressPercentage -> (двойное число)

Процент завершенной миграции слота.

AuthTokenStatus -> (строка)

Статус токена авторизации

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

Изменяемая группа пользователей.

UserGroupIdsToAdd -> (список)

Идентификатор группы пользователей для добавления.

(строка)

UserGroupIdsToRemove -> (список)

Идентификатор группы пользователей для удаления.

(строка)

LogDeliveryConfigurations -> (список)

Изменяемые конфигурации доставки логов

(структура)

Изменяемые конфигурации доставки логов

LogType -> (строка)

Относится к медленным логам или логам движка.

DestinationType -> (строка)

Возвращает тип назначения: CloudWatch Logs или Kinesis Data Firehose.

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

Детали конфигурации назначения CloudWatch Logs или Kinesis Data Firehose.

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

Детали конфигурации назначения CloudWatch Logs.

LogGroup -> (строка)

Имя группы логов CloudWatch Logs.

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

Детали конфигурации назначения Kinesis Data Firehose.

DeliveryStream -> (строка)

Имя потока доставки Kinesis Data Firehose.

LogFormat -> (строка)

Возвращает формат лога: JSON или TEXT

TransitEncryptionEnabled -> (булево)

Флаг, который включает шифрование в транзите при значении true.

TransitEncryptionMode -> (строка)

Настройка, позволяющая мигрировать клиентов на использование шифрования в транзите без простоев.

ClusterMode -> (строка)

Включено или Выключено. Чтобы изменить режим кластера с Выключено на Включено, сначала необходимо установить режим кластера на Совместимо. Режим Совместимо позволяет клиентам Valkey или Redis OSS подключаться, используя как включенный, так и выключенный режим кластера. После миграции всех клиентов Valkey или Redis OSS на использование включенного режима кластера, вы можете завершить конфигурацию режима кластера и установить режим кластера на Включено.

MemberClusters -> (список)

Имена всех кластеров кэша, которые являются частью этой группы репликации.

(строка)

NodeGroups -> (список)

Список групп узлов в этой группе репликации. Для групп репликации Valkey или Redis OSS (режим кластера выключен), это список из одного элемента. Для групп репликации Valkey или Redis OSS (режим кластера включен), список содержит запись для каждой группы узлов (раздела).

(структура)

Представляет коллекцию узлов кэша в группе репликации. Один узел в группе узлов является узлом чтения/записи основным. Все остальные узлы являются узлами реплики только для чтения.

NodeGroupId -> (строка)

Идентификатор группы узлов (раздела). Группа репликации Valkey или Redis OSS (режим кластера выключен) содержит только 1 группу узлов; поэтому идентификатор группы узлов — 0001. Группа репликации Valkey или Redis OSS (режим кластера включен) содержит от 1 до 90 групп узлов с номерами от 0001 до 0090. Пользователь может предоставить ID для группы узлов.

Status -> (строка)

Текущее состояние этой группы репликации - creating , available , modifying , deleting .

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

Адрес основного узла в этой группе узлов (разделе).

Address -> (строка)

DNS-имя узла кэша.

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

Номер порта, на котором работает движок кэша.

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

Адрес узлов реплики в этой группе узлов (разделе). Это значение является только для чтения.

Address -> (строка)

DNS-имя узла кэша.

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

Номер порта, на котором работает движок кэша.

Slots -> (строка)

Пространство имен для этой группы узлов (раздела).

NodeGroupMembers -> (список)

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

(структура)

Представляет отдельный узел в группе узлов (разделе).

CacheClusterId -> (строка)

Идентификатор кластера, к которому принадлежит узел.

CacheNodeId -> (строка)

Идентификатор узла в его кластере. Идентификатор узла — числовой идентификатор (0001, 0002 и т. д.).

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

Информация, необходимая клиентским программам для подключения к узлу для операций чтения. Адрес чтения применим только для кластеров Valkey или Redis OSS (режим кластера выключен).

Address -> (строка)

DNS-имя узла кэша.

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

Номер порта, на котором работает движок кэша.

PreferredAvailabilityZone -> (строка)

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

PreferredOutpostArn -> (строка)

ARN экспоста группы узлов.

CurrentRole -> (строка)

Роль, которая в настоящее время назначена узлу — primary или replica . Этот член применим только для групп репликации Valkey или Redis OSS (режим кластера выключен).

SnapshottingClusterId -> (строка)

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

AutomaticFailover -> (строка)

Указывает состояние автоматического переключения для этой группы репликации Valkey или Redis OSS.

MultiAZ -> (строка)

Флаг, указывающий, включен ли Multi-AZ для повышения отказоустойчивости. Дополнительную информацию см. в разделе Минимизация простоев: Multi-AZ

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

Конфигурационный адрес для этой группы репликации. Используйте конфигурационный адрес для подключения к этой группе репликации.

Address -> (строка)

DNS-имя узла кэша.

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

Номер порта, на котором работает движок кэша.

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

Количество дней, в течение которых ElastiCache сохраняет автоматические снимки кластера, прежде чем удалить их. Например, если вы установите SnapshotRetentionLimit в значение 5, снимок, сделанный сегодня, сохраняется в течение 5 дней, прежде чем будет удален.

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

Если значение SnapshotRetentionLimit установлено в ноль (0), резервные копии отключены.

SnapshotWindow -> (строка)

Ежедневный интервал времени (в UTC), в течение которого ElastiCache начинает создание ежедневного снимка вашей группы узлов (раздела).

Пример: 05:00-09:00

Если вы не укажете этот параметр, ElastiCache автоматически выберет соответствующий интервал времени.

Примечание

Этот параметр допустим только если параметр Engine равен redis .

ClusterEnabled -> (булево)

Флаг, указывающий, включена ли группа репликации в кластер; т.е. данные могут быть распределены по нескольким разделам (API/CLI: группы узлов).

Допустимые значения: true | false

CacheNodeType -> (строка)

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

AuthTokenEnabled -> (булево)

Флаг, включающий использование AuthToken (пароля) при выполнении команд Valkey или Redis OSS.

По умолчанию: false

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

Дата последнего изменения токена авторизации

TransitEncryptionEnabled -> (булево)

Флаг, включающий шифрование в транзите при значении true .

Требуется: Доступно только при создании группы репликации в Amazon VPC с использованием версии Redis OSS 3.2.6 , 4.x или более поздней.

По умолчанию: false

AtRestEncryptionEnabled -> (булево)

Флаг, который включает шифрование в состоянии покоя при значении true .

Вы не можете изменить значение AtRestEncryptionEnabled после создания кластера. Чтобы включить шифрование в состоянии покоя для кластера, необходимо установить AtRestEncryptionEnabled в значение true при создании кластера.

Требуется: Доступно только при создании группы репликации в Amazon VPC с использованием версии Redis OSS 3.2.6 , 4.x или более поздней.

По умолчанию: false

MemberClustersOutpostArns -> (список)

ARN экспостов для кластеров-членов группы репликации.

(строка)

KmsKeyId -> (строка)

Идентификатор KMS-ключа, используемого для шифрования диска в кластере.

ARN -> (строка)

ARN (имя ресурса Amazon) группы репликации.

UserGroupIds -> (список)

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

(строка)

LogDeliveryConfigurations -> (список)

Возвращает пункт назначения, формат и тип логов.

(структура)

Возвращает пункт назначения, формат и тип логов.

LogType -> (строка)

Относится к slow-log или engine-log.

DestinationType -> (строка)

Возвращает тип назначения, либо cloudwatch-logs, либо kinesis-firehose.

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

Детали конфигурации пункта назначения CloudWatch Logs или Kinesis Data Firehose.

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

Детали конфигурации пункта назначения CloudWatch Logs.

LogGroup -> (строка)

Имя группы логов CloudWatch Logs.

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

Детали конфигурации пункта назначения Kinesis Data Firehose.

DeliveryStream -> (строка)

Имя потока доставки Kinesis Data Firehose.

LogFormat -> (строка)

Возвращает формат логов, либо JSON, либо TEXT.

Status -> (строка)

Возвращает статус конфигурации доставки логов. Значения могут быть одним из enabling | disabling | modifying | active | error

Message -> (строка)

Возвращает сообщение об ошибке для конфигурации доставки логов.

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

Дата и время создания кластера.

DataTiering -> (строка)

Включает тиering данных. Тиering данных поддерживается только для групп репликации, использующих тип узлов r6gd. Этот параметр должен быть установлен в значение true при использовании узлов r6gd. Для получения дополнительной информации см. Data tiering.

AutoMinorVersionUpgrade -> (булево)

Если вы используете Valkey 7.2 и выше или версию Redis OSS engine 6.0 и выше, установите этот параметр в значение да, если хотите подключиться к следующей кампании автоматического обновления незначительной версии. Этот параметр отключен для предыдущих версий.

NetworkType -> (строка)

Должно быть либо ipv4 | ipv6 | dual_stack. IPv6 поддерживается для рабочих нагрузок, использующих Valkey 7.2 и выше, версию Redis OSS engine с 6.2 по 7.1 или версию Memcached engine 1.6.6 и выше на всех экземплярах, созданных на платформе Nitro.

IpDiscovery -> (строка)

Тип сети, который вы выбираете при изменении кластера, либо ipv4 | ipv6. IPv6 поддерживается для рабочих нагрузок, использующих Valkey 7.2 и выше, версию Redis OSS engine с 6.2 по 7.1 или версию Memcached engine 1.6.6 и выше на всех экземплярах, созданных на платформе Nitro.

TransitEncryptionMode -> (строка)

Настройка, которая позволяет вам мигрировать ваших клиентов для использования шифрования в транзите без простоев.

ClusterMode -> (строка)

Включено или Выключено. Чтобы изменить режим кластера с Выключено на Включено, необходимо сначала установить режим кластера в Совместимый. Режим Совместимый позволяет вашим клиентам Valkey или Redis OSS подключаться, используя как режим кластера, включенный, так и режим кластера, выключенный. После миграции всех клиентов Valkey или Redis OSS для использования включенного режима кластера, вы можете завершить настройку режима кластера и установить режим кластера в Включено.

Engine -> (строка)

Двигатель, используемый в группе репликации. Варианты: redis, memcached или valkey.

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

Spec-Zone.ru

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