[ 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 -> (строка)
Resharding -> (структура)
Состояние операции онлайн-перераспределения.
SlotMigration -> (структура)
Представляет ход операции онлайн-перераспределения.
ProgressPercentage -> (двойное число)
AuthTokenStatus -> (строка)
UserGroups -> (структура)
Изменяемая группа пользователей.
UserGroupIdsToAdd -> (список)
Идентификатор группы пользователей для добавления.
(строка)
UserGroupIdsToRemove -> (список)
Идентификатор группы пользователей для удаления.
(строка)
LogDeliveryConfigurations -> (список)
Изменяемые конфигурации доставки логов
(структура)
Изменяемые конфигурации доставки логов
LogType -> (строка)
DestinationType -> (строка)
DestinationDetails -> (структура)
Детали конфигурации назначения CloudWatch Logs или Kinesis Data Firehose.
CloudWatchLogsDetails -> (структура)
Детали конфигурации назначения CloudWatch Logs.
LogGroup -> (строка)
KinesisFirehoseDetails -> (структура)
Детали конфигурации назначения Kinesis Data Firehose.
DeliveryStream -> (строка)
LogFormat -> (строка)
TransitEncryptionEnabled -> (булево)
TransitEncryptionMode -> (строка)
ClusterMode -> (строка)
MemberClusters -> (список)
Имена всех кластеров кэша, которые являются частью этой группы репликации.
(строка)
NodeGroups -> (список)
Список групп узлов в этой группе репликации. Для групп репликации Valkey или Redis OSS (режим кластера выключен), это список из одного элемента. Для групп репликации Valkey или Redis OSS (режим кластера включен), список содержит запись для каждой группы узлов (раздела).
(структура)
Представляет коллекцию узлов кэша в группе репликации. Один узел в группе узлов является узлом чтения/записи основным. Все остальные узлы являются узлами реплики только для чтения.
NodeGroupId -> (строка)
Status -> (строка)
creating , available , modifying , deleting .PrimaryEndpoint -> (структура)
Адрес основного узла в этой группе узлов (разделе).
Address -> (строка)
Port -> (целое число)
ReaderEndpoint -> (структура)
Адрес узлов реплики в этой группе узлов (разделе). Это значение является только для чтения.
Address -> (строка)
Port -> (целое число)
Slots -> (строка)
NodeGroupMembers -> (список)
Список, содержащий информацию об отдельных узлах в группе узлов (разделе).
(структура)
Представляет отдельный узел в группе узлов (разделе).
CacheClusterId -> (строка)
CacheNodeId -> (строка)
ReadEndpoint -> (структура)
Информация, необходимая клиентским программам для подключения к узлу для операций чтения. Адрес чтения применим только для кластеров Valkey или Redis OSS (режим кластера выключен).
Address -> (строка)
Port -> (целое число)
PreferredAvailabilityZone -> (строка)
PreferredOutpostArn -> (строка)
CurrentRole -> (строка)
primary или replica . Этот член применим только для групп репликации Valkey или Redis OSS (режим кластера выключен).SnapshottingClusterId -> (строка)
AutomaticFailover -> (строка)
MultiAZ -> (строка)
ConfigurationEndpoint -> (структура)
Конфигурационный адрес для этой группы репликации. Используйте конфигурационный адрес для подключения к этой группе репликации.
Address -> (строка)
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 .
3.2.6 , 4.x или более поздней.По умолчанию: false
AtRestEncryptionEnabled -> (булево)
Флаг, который включает шифрование в состоянии покоя при значении true .
Вы не можете изменить значение AtRestEncryptionEnabled после создания кластера. Чтобы включить шифрование в состоянии покоя для кластера, необходимо установить AtRestEncryptionEnabled в значение true при создании кластера.
3.2.6 , 4.x или более поздней.По умолчанию: false
MemberClustersOutpostArns -> (список)
ARN экспостов для кластеров-членов группы репликации.
(строка)
KmsKeyId -> (строка)
ARN -> (строка)
UserGroupIds -> (список)
Идентификатор группы пользователей, связанной с группой репликации.
(строка)
LogDeliveryConfigurations -> (список)
Возвращает пункт назначения, формат и тип логов.
(структура)
Возвращает пункт назначения, формат и тип логов.
LogType -> (строка)
DestinationType -> (строка)
cloudwatch-logs, либо kinesis-firehose.DestinationDetails -> (структура)
Детали конфигурации пункта назначения CloudWatch Logs или Kinesis Data Firehose.
CloudWatchLogsDetails -> (структура)
Детали конфигурации пункта назначения CloudWatch Logs.
LogGroup -> (строка)
KinesisFirehoseDetails -> (структура)
Детали конфигурации пункта назначения Kinesis Data Firehose.
DeliveryStream -> (строка)
LogFormat -> (строка)
Status -> (строка)
enabling | disabling | modifying | active | error
Message -> (строка)
ReplicationGroupCreateTime -> (метка времени)
DataTiering -> (строка)
AutoMinorVersionUpgrade -> (булево)
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 -> (строка)
Engine -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.