Spec-Zone.ru › AWS CLI v2

[ aws . memorydb ]

копировать-снимок

Описание

Создает копию существующего снимка.

См. также: Документацию 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 (строка)

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

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

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

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

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

--tags (список)

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

(структура)

Тег, который можно добавить к ресурсу MemoryDB. Теги состоят из пары «ключ/значение». Вы можете использовать теги для категоризации и отслеживания всех ваших ресурсов MemoryDB. При добавлении или удалении тегов в кластерах эти действия будут дублироваться на всех узлах в кластере. Тег с нулевым значением разрешен. Дополнительную информацию см. в разделе Тегирование ваших ресурсов MemoryDB

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

Ключ тега. Не может быть 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
  • текст
  • таблица
  • 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 memorydb copy-snapshot \
    --source-snapshot-name my-cluster-snapshot \
    --target-snapshot-name my-cluster-snapshot-copy

Вывод

{
    "Snapshot": {
        "Name": "my-cluster-snapshot-copy",
        "Status": "creating",
        "Source": "manual",
        "ARN": "arn:aws:memorydb:us-east-1:491658xxxxxx:snapshot/my-cluster-snapshot-copy",
        "ClusterConfiguration": {
            "Name": "my-cluster",
            "Description": " ",
            "NodeType": "db.r6g.large",
            "EngineVersion": "6.2",
            "MaintenanceWindow": "wed:03:00-wed:04:00",
            "Port": 6379,
            "ParameterGroupName": "default.memorydb-redis6",
            "SubnetGroupName": "my-sg",
            "VpcId": "vpc-xx2574fc",
            "SnapshotRetentionLimit": 0,
            "SnapshotWindow": "04:30-05:30",
            "NumShards": 2
        }
    }
}

Дополнительную информацию см. в разделе Копирование снимка в Руководстве пользователя MemoryDB.

Вывод

Снимок -> (структура)

Представляет копию всего кластера на момент создания снимка.

Имя -> (строка)

Имя снимка

Статус -> (строка)

Статус снимка. Допустимые значения: создание | доступно | восстановление | копирование | удаление.

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

Указывает, получен ли снимок из автоматического резервного копирования (автоматический) или был создан вручную (ручной).

KmsKeyId -> (строка)

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

ARN -> (строка)

ARN (Amazon Resource Name) снимка.

НастройкаКластера -> (структура)

Настройка кластера, с которого был создан снимок

Имя -> (строка)

Имя кластера

Описание -> (строка)

Описание конфигурации кластера

ТипУзла -> (строка)

Тип узла, используемого для кластера

Двигатель -> (строка)

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

ВерсияДвигателя -> (строка)

Версия движка Redis OSS, используемого кластером

ОкноТехническогоОбслуживания -> (строка)

Указанное окно технического обслуживания для кластера

TopicArn -> (строка)

Amazon Resource Name (ARN) темы SNS для уведомлений кластера

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

Порт, используемый кластером

ParameterGroupName -> (строка)

Имя группы параметров, используемой кластером

SubnetGroupName -> (строка)

Имя группы подсетей, используемой кластером

VpcId -> (строка)

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

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

Предел удержания снимка, заданный кластером

SnapshotWindow -> (строка)

Окно снимка, заданное кластером

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

Количество фрагментов в кластере

Shards -> (список)

Список фрагментов в кластере

(структура)

Предоставляет сведения о фрагменте в снимке

Имя -> (строка)

Имя фрагмента

Конфигурация -> (структура)

Подробности конфигурации фрагмента

Слоты -> (строка)

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

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

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

Размер -> (строка)

Размер снимка фрагмента

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

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

MultiRegionParameterGroupName -> (строка)

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

MultiRegionClusterName -> (строка)

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

DataTiering -> (строка)

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

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

Spec-Zone.ru

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