Spec-Zone.ru › AWS CLI v2

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

Имя копии снимка. ElastiCache не допускает перезаписи снимка, поэтому это имя должно быть уникальным в контексте - ElastiCache или Amazon S3 ведра при экспорте.

--target-bucket (строка)

Amazon S3 ведро, в которое экспортируется снимок. Этот параметр используется только при экспорте снимка для внешнего доступа.

При использовании этого параметра для экспорта снимка убедитесь, что Amazon ElastiCache имеет необходимые разрешения на это ведро S3. Для получения дополнительной информации см. Шаг 2: Предоставление ElastiCache доступа к вашему Amazon S3 ведру в руководстве пользователя Amazon ElastiCache.

Для получения дополнительной информации см. Экспорт снимка в руководстве пользователя Amazon ElastiCache.

--kms-key-id (строка)

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

--tags (список)

Список тегов, которые нужно добавить к этому ресурсу. Тег — это пара ключ-значение. Ключ тега должен сопровождаться значением тега, хотя null принимается.

(структура)

Тег, который можно добавить к кластеру или группе репликации ElastiCache. Теги состоят из пары Ключ/Значение. Вы можете использовать теги для категоризации и отслеживания всех ваших ресурсов ElastiCache, за исключением глобальной группы репликации. При добавлении или удалении тегов в группах репликации эти действия будут реплицированы на все узлы в группе репликации. Тег с нулевым значением разрешён.

Ключ -> (строка)

Ключ тега. Не может быть null.

Значение -> (строка)

Значение тега. Может быть null.

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

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
  • Оптимизированные по вычислительным ресурсам:

    • Предыдущее поколение: (не рекомендуется. Существующие кластеры по-прежнему поддерживаются, но создание новых кластеров для этих типов не поддерживается.) Типы узлов C1: cache.c1.xlarge
  • Оптимизированные по памяти:

    • Текущее поколение: Типы узлов 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
Дополнительная информация о типах узлов
  • Все типы экземпляров текущего поколения создаются по умолчанию в 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 -> (строка)

ARN (Amazon Resource Name) предпочтительного подразделения.

CacheClusterCreateTime -> (временная метка)

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

PreferredMaintenanceWindow -> (строка)

Указывает еженедельный диапазон времени, в течение которого выполняется обслуживание кластера. Указывается как диапазон в формате ddd:hh24:mi-ddd:hh24:mi (24-часовой формат UTC). Минимальный интервал времени обслуживания составляет 60 минут.

Допустимые значения для ddd:

  • sun
  • mon
  • tue
  • wed
  • thu
  • fri
  • sat

Пример: sun:23:00-mon:01:30

TopicArn -> (строка)

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

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

Номер порта, используемый каждым узлом кеша в исходном кластере.

CacheParameterGroupName -> (строка)

Группа параметров кеша, связанная с исходным кластером.

CacheSubnetGroupName -> (строка)

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

VpcId -> (строка)

Идентификатор Amazon Virtual Private Cloud (VPC ID) группы подсетей кеша для исходного кластера.

AutoMinorVersionUpgrade -> (булево)

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

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

Для автоматической моментальной копии количество дней, в течение которых ElastiCache сохраняет моментальную копию перед её удалением.

Для ручных моментальных копий это поле отражает SnapshotRetentionLimit исходного кластера на момент создания моментальной копии. В противном случае это поле игнорируется: ручные моментальные копии не истекают и могут быть удалены только с помощью операции DeleteSnapshot.

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

SnapshotWindow -> (строка)

Ежедневный диапазон времени, в течение которого ElastiCache создаёт ежедневные моментальные копии исходного кластера.

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

Количество групп узлов (фрагментов) в этой моментальной копии. При восстановлении из моментальной копии количество групп узлов (фрагментов) в моментальной копии и в восстанавливаемой группе репликации должно быть одинаковым.

AutomaticFailover -> (строка)

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

NodeSnapshots -> (список)

Список узлов кеша в исходном кластере.

(структура)

Представляет отдельный узел кеша в моментальной копии кластера.

CacheClusterId -> (строка)

Уникальный идентификатор исходного кластера.

NodeGroupId -> (строка)

Уникальный идентификатор исходной группы узлов (фрагмента).

CacheNodeId -> (строка)

Идентификатор узла кеша для узла в исходном кластере.

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

Настройка исходной группы узлов (фрагмента).

NodeGroupId -> (строка)

Четырехзначный идентификатор, предоставленный ElastiCache, или предоставленный пользователем идентификатор группы узлов, к которым относятся эти значения конфигурации.

Slots -> (строка)

Строка, определяющая пространство имён ключей для определенной группы узлов. Пространства имён ключей варьируются от 0 до 16 383. Строка имеет формат startkey-endkey .

Пример: "0-3999"

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

Количество узлов реплики чтения в этой группе узлов (фрагменте).

PrimaryAvailabilityZone -> (строка)

Зона доступности, в которой запущен первичный узел этой группы узлов (фрагмента).

ReplicaAvailabilityZones -> (список)

Список зон доступности, которые будут использоваться для реплик чтения. Количество зон доступности в этом списке должно соответствовать значению ReplicaCount или ReplicasPerNodeGroup, если не указано иное.

(строка)

PrimaryOutpostArn -> (строка)

ARN подразделения первичного узла.

ReplicaOutpostArns -> (список)

ARN подразделения узлов-реплик.

(строка)

CacheSize -> (строка)

Размер кеша на исходном узле кеша.

CacheNodeCreateTime -> (временная метка)

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

SnapshotCreateTime -> (временная метка)

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

KmsKeyId -> (строка)

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

ARN -> (строка)

Идентификатор ресурса снимка (ARN).

DataTiering -> (строка)

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

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

Spec-Zone.ru

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