[ aws . elasticache ]
copy-snapshot
Описание
Создаёт копию существующего снимка.
Примечание
Данная операция допустима только для Valkey или Redis OSS.Предупреждение
Пользователи или группы, обладающие разрешениями на использование операцииCopySnapshot, могут создавать собственные Amazon S3 buckets и копировать в них снимки. Для контроля доступа к вашим снимкам используйте политику IAM, чтобы управлять возможностью использования операции CopySnapshot. Для получения дополнительной информации об использовании IAM для управления операциями ElastiCache, см. Экспорт снимков и Аутентификация и контроль доступа.Вы можете получить следующие сообщения об ошибках.
- Сообщение об ошибке: Ведро S3 %s находится вне региона. Решение: Создайте Amazon S3 ведро в том же регионе, что и ваш снимок. Для получения дополнительной информации см. Шаг 1: Создание Amazon S3 ведра в руководстве пользователя ElastiCache.
- Сообщение об ошибке: Ведро S3 %s не существует. Решение: Создайте Amazon S3 ведро в том же регионе, что и ваш снимок. Для получения дополнительной информации см. Шаг 1: Создание Amazon S3 ведра в руководстве пользователя ElastiCache.
- Сообщение об ошибке: Ведро S3 %s не принадлежит аутентифицированному пользователю. Решение: Создайте Amazon S3 ведро в том же регионе, что и ваш снимок. Для получения дополнительной информации см. Шаг 1: Создание Amazon S3 ведра в руководстве пользователя ElastiCache.
- Сообщение об ошибке: У аутентифицированного пользователя недостаточно разрешений для выполнения требуемого действия. Решение: Обратитесь к системному администратору, чтобы получить необходимые разрешения.
-
Сообщение об ошибке: Ведро S3 %s уже содержит объект с ключом %s. Решение: Присвойте
TargetSnapshotNameновое и уникальное значение. При экспорте снимка вы можете альтернативно создать новое Amazon S3 ведро и использовать это же значение дляTargetSnapshotName. - Сообщение об ошибке: ElastiCache не предоставлено разрешение на чтение %s в ведре S3. Решение: Добавьте разрешения на список и чтение в ведре. Для получения дополнительной информации см. Шаг 2: Предоставление ElastiCache доступа к вашему Amazon S3 ведру в руководстве пользователя ElastiCache.
- Сообщение об ошибке: ElastiCache не предоставлено разрешение на запись %s в ведре S3. Решение: Добавьте разрешения на загрузку/удаление в ведре. Для получения дополнительной информации см. Шаг 2: Предоставление ElastiCache доступа к вашему Amazon S3 ведру в руководстве пользователя ElastiCache.
- Сообщение об ошибке: ElastiCache не предоставлено разрешение на чтение_ACP %s в ведре S3. Решение: Добавьте разрешения на просмотр в ведре. Для получения дополнительной информации см. Шаг 2: Предоставление ElastiCache доступа к вашему Amazon S3 ведру в руководстве пользователя ElastiCache.
См. также: Документация API AWS
Синтаксис
copy-snapshot
--source-snapshot-name <value>
--target-snapshot-name <value>
[--target-bucket <value>]
[--kms-key-id <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]
Параметры
--source-snapshot-name (строка)
--target-snapshot-name (строка)
--target-bucket (строка)
Amazon S3 ведро, в которое экспортируется снимок. Этот параметр используется только при экспорте снимка для внешнего доступа.
При использовании этого параметра для экспорта снимка убедитесь, что Amazon ElastiCache имеет необходимые разрешения на это ведро S3. Для получения дополнительной информации см. Шаг 2: Предоставление ElastiCache доступа к вашему Amazon S3 ведру в руководстве пользователя Amazon ElastiCache.
Для получения дополнительной информации см. Экспорт снимка в руководстве пользователя Amazon ElastiCache.
--kms-key-id (строка)
--tags (список)
Список тегов, которые нужно добавить к этому ресурсу. Тег — это пара ключ-значение. Ключ тега должен сопровождаться значением тега, хотя null принимается.
(структура)
Тег, который можно добавить к кластеру или группе репликации ElastiCache. Теги состоят из пары Ключ/Значение. Вы можете использовать теги для категоризации и отслеживания всех ваших ресурсов ElastiCache, за исключением глобальной группы репликации. При добавлении или удалении тегов в группах репликации эти действия будут реплицированы на все узлы в группе репликации. Тег с нулевым значением разрешён.
Ключ -> (строка)
Значение -> (строка)
Сокращённый синтаксис:
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
- 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.
Примеры
Примечание
Для использования следующих примеров вам необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.
Если не указано иное, все примеры используют правила цитирования, похожие на unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Копирование снимка
Следующий пример copy-snapshot создаёт копию существующего снимка.
aws elasticache copy-snapshot \
--source-snapshot-name "my-snapshot" \
--target-snapshot-name "my-snapshot-copy"
Вывод:
{
"Snapshot":{
"Engine": "redis",
"CacheParameterGroupName": "default.redis3.2",
"VpcId": "vpc-3820329f3",
"CacheClusterId": "my-redis4",
"SnapshotRetentionLimit": 7,
"NumCacheNodes": 1,
"SnapshotName": "my-snapshot-copy",
"CacheClusterCreateTime": "2016-12-21T22:24:04.955Z",
"AutoMinorVersionUpgrade": true,
"PreferredAvailabilityZone": "us-east-1c",
"SnapshotStatus": "creating",
"SnapshotSource": "manual",
"SnapshotWindow": "07:00-08:00",
"EngineVersion": "3.2.4",
"NodeSnapshots": [
{
"CacheSize": "3 MB",
"SnapshotCreateTime": "2016-12-28T07:00:52Z",
"CacheNodeId": "0001",
"CacheNodeCreateTime": "2016-12-21T22:24:04.955Z"
}
],
"CacheSubnetGroupName": "default",
"Port": 6379,
"PreferredMaintenanceWindow": "tue:09:30-tue:10:30",
"CacheNodeType": "cache.m3.large"
}
}
Для получения дополнительной информации см. Экспорт резервной копии в руководстве пользователя Elasticache.
Вывод
Снимок -> (структура)
Представляет копию всего кластера Valkey или Redis OSS на момент создания моментальной копии.
SnapshotName -> (строка)
ReplicationGroupId -> (строка)
ReplicationGroupDescription -> (строка)
CacheClusterId -> (строка)
SnapshotStatus -> (строка)
creating | available | restoring | copying | deleting .SnapshotSource -> (строка)
automated ) или была создана вручную (manual ).CacheNodeType -> (строка)
Название типа узла вычислительной и оперативной памяти для исходного кластера.
ElastiCache поддерживает следующие типы узлов. В целом, типы текущего поколения обеспечивают большую оперативную память и вычислительную мощность по более низкой цене по сравнению с их аналогами предыдущего поколения.
-
Универсальные:
- Текущее поколение: Типы узлов M7g :
cache.m7g.large,cache.m7g.xlarge,cache.m7g.2xlarge,cache.m7g.4xlarge,cache.m7g.8xlarge,cache.m7g.12xlarge,cache.m7g.16xlarge
Примечание
Доступность в регионах см. в разделе Поддерживаемые типы узлов
Типы узлов M6g (доступны только для версии Redis OSS движка 5.0.6 и выше, и для версии движка Memcached 1.5.16 и выше):
cache.m6g.large,cache.m6g.xlarge,cache.m6g.2xlarge,cache.m6g.4xlarge,cache.m6g.8xlarge,cache.m6g.12xlarge,cache.m6g.16xlargeТипы узлов M5:cache.m5.large,cache.m5.xlarge,cache.m5.2xlarge,cache.m5.4xlarge,cache.m5.12xlarge,cache.m5.24xlargeТипы узлов M4:cache.m4.large,cache.m4.xlarge,cache.m4.2xlarge,cache.m4.4xlarge,cache.m4.10xlargeТипы узлов T4g (доступны только для версии Redis OSS движка 5.0.6 и выше, и для версии движка Memcached 1.5.16 и выше):cache.t4g.micro,cache.t4g.small,cache.t4g.mediumТипы узлов T3:cache.t3.micro,cache.t3.small,cache.t3.mediumТипы узлов T2:cache.t2.micro,cache.t2.small,cache.t2.medium- Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов T1:
cache.t1.microТипы узлов M1:cache.m1.small,cache.m1.medium,cache.m1.large,cache.m1.xlargeТипы узлов M3:cache.m3.medium,cache.m3.large,cache.m3.xlarge,cache.m3.2xlarge
- Текущее поколение: Типы узлов M7g :
-
Оптимизированные по вычислительным ресурсам:
- Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов C1:
cache.c1.xlarge
- Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов C1:
-
Оптимизированные по памяти:
- Текущее поколение: Типы узлов R7g :
cache.r7g.large,cache.r7g.xlarge,cache.r7g.2xlarge,cache.r7g.4xlarge,cache.r7g.8xlarge,cache.r7g.12xlarge,cache.r7g.16xlarge
Примечание
Доступность в регионах см. в разделе Поддерживаемые типы узлов
Типы узлов R6g (доступны только для версии Redis OSS движка 5.0.6 и выше, и для версии движка Memcached 1.5.16 и выше):
cache.r6g.large,cache.r6g.xlarge,cache.r6g.2xlarge,cache.r6g.4xlarge,cache.r6g.8xlarge,cache.r6g.12xlarge,cache.r6g.16xlargeТипы узлов R5:cache.r5.large,cache.r5.xlarge,cache.r5.2xlarge,cache.r5.4xlarge,cache.r5.12xlarge,cache.r5.24xlargeТипы узлов R4:cache.r4.large,cache.r4.xlarge,cache.r4.2xlarge,cache.r4.4xlarge,cache.r4.8xlarge,cache.r4.16xlarge- Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов M2:
cache.m2.xlarge,cache.m2.2xlarge,cache.m2.4xlargeТипы узлов R3:cache.r3.large,cache.r3.xlarge,cache.r3.2xlarge,cache.r3.4xlarge,cache.r3.8xlarge
- Текущее поколение: Типы узлов R7g :
- Все типы экземпляров текущего поколения создаются по умолчанию в Amazon VPC.
- Файлы append-only (AOF) Valkey или Redis OSS не поддерживаются для экземпляров T1 или T2.
- Valkey или Redis OSS Multi-AZ с автоматическим переключением не поддерживаются на экземплярах T1.
- Переменные конфигурации
appendonlyиappendfsyncне поддерживаются в Valkey или в Redis OSS версии 2.8.22 и выше.
Engine -> (строка)
memcached или redis ).EngineVersion -> (строка)
NumCacheNodes -> (целое число)
Количество узлов кеша в исходном кластере.
Для кластеров, работающих с Valkey или Redis OSS, это значение должно быть 1. Для кластеров, работающих с Memcached, это значение должно быть между 1 и 40.
PreferredAvailabilityZone -> (строка)
PreferredOutpostArn -> (строка)
CacheClusterCreateTime -> (временная метка)
PreferredMaintenanceWindow -> (строка)
Указывает еженедельный диапазон времени, в течение которого выполняется обслуживание кластера. Указывается как диапазон в формате ddd:hh24:mi-ddd:hh24:mi (24-часовой формат UTC). Минимальный интервал времени обслуживания составляет 60 минут.
Допустимые значения для ddd:
sunmontuewedthufrisat
Пример: sun:23:00-mon:01:30
TopicArn -> (строка)
Port -> (целое число)
CacheParameterGroupName -> (строка)
CacheSubnetGroupName -> (строка)
VpcId -> (строка)
AutoMinorVersionUpgrade -> (булево)
SnapshotRetentionLimit -> (целое число)
Для автоматической моментальной копии количество дней, в течение которых ElastiCache сохраняет моментальную копию перед её удалением.
Для ручных моментальных копий это поле отражает SnapshotRetentionLimit исходного кластера на момент создания моментальной копии. В противном случае это поле игнорируется: ручные моментальные копии не истекают и могут быть удалены только с помощью операции DeleteSnapshot.
SnapshotWindow -> (строка)
NumNodeGroups -> (целое число)
AutomaticFailover -> (строка)
NodeSnapshots -> (список)
Список узлов кеша в исходном кластере.
(структура)
Представляет отдельный узел кеша в моментальной копии кластера.
CacheClusterId -> (строка)
NodeGroupId -> (строка)
CacheNodeId -> (строка)
NodeGroupConfiguration -> (структура)
Настройка исходной группы узлов (фрагмента).
NodeGroupId -> (строка)
Slots -> (строка)
Строка, определяющая пространство имён ключей для определенной группы узлов. Пространства имён ключей варьируются от 0 до 16 383. Строка имеет формат startkey-endkey .
Пример: "0-3999"
ReplicaCount -> (целое число)
PrimaryAvailabilityZone -> (строка)
ReplicaAvailabilityZones -> (список)
Список зон доступности, которые будут использоваться для реплик чтения. Количество зон доступности в этом списке должно соответствовать значению ReplicaCount или ReplicasPerNodeGroup, если не указано иное.
(строка)
PrimaryOutpostArn -> (строка)
ReplicaOutpostArns -> (список)
ARN подразделения узлов-реплик.
(строка)
CacheSize -> (строка)
CacheNodeCreateTime -> (временная метка)
SnapshotCreateTime -> (временная метка)
KmsKeyId -> (строка)
ARN -> (строка)
DataTiering -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.