Spec-Zone.ru › AWS CLI v2

[ aws . neptune ]

копирование-снимка-кластера-баз-данных

Описание

Копирует снимок кластера баз данных.

Для копирования снимка кластера баз данных из общего ручного снимка кластера баз данных, SourceDBClusterSnapshotIdentifier должен быть Amazon Resource Name (ARN) общего снимка кластера баз данных.

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

Синтаксис

  copy-db-cluster-snapshot
--source-db-cluster-snapshot-identifier <value>
--target-db-cluster-snapshot-identifier <value>
[--kms-key-id <value>]
[--pre-signed-url <value>]
[--copy-tags | --no-copy-tags]
[--tags <value>]
[--source-region <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-db-cluster-snapshot-identifier (строка)

Идентификатор снимка кластера баз данных для копирования. Этот параметр не чувствителен к регистру.

Ограничения:

  • Должен указывать действительный системный снимок в состоянии «доступен».
  • Укажите действительный идентификатор снимка базы данных.

Пример: my-cluster-snapshot1

--target-db-cluster-snapshot-identifier (строка)

Идентификатор нового снимка кластера баз данных для создания из исходного снимка кластера баз данных. Этот параметр не чувствителен к регистру.

Ограничения:

  • Должен содержать от 1 до 63 букв, цифр или дефисов.
  • Первый символ должен быть буквой.
  • Не может оканчиваться дефисом или содержать два последовательных дефиса.

Пример: my-cluster-snapshot2

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

Идентификатор Amazon KMS ключа для зашифрованного снимка кластера баз данных. Идентификатор KMS ключа — это Amazon Resource Name (ARN), идентификатор KMS ключа или псевдоним KMS ключа для ключа шифрования KMS.

Если вы копируете зашифрованный снимок кластера баз данных из своей учетной записи Amazon, вы можете указать значение для KmsKeyId, чтобы зашифровать копию с помощью нового ключа шифрования KMS. Если вы не укажете значение для KmsKeyId, то копия снимка кластера баз данных шифруется тем же ключом KMS, что и исходный снимок кластера баз данных.

Если вы копируете зашифрованный снимок кластера баз данных, предоставленный другой учетной записью Amazon, вы должны указать значение для KmsKeyId.

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

Вы не можете зашифровать незашифрованный снимок кластера баз данных при его копировании. Если вы попытаетесь скопировать незашифрованный снимок кластера баз данных и укажете значение для параметра KmsKeyId, будет возвращено сообщение об ошибке.

--pre-signed-url (строка)

В настоящее время не поддерживается.

--copy-tags | --no-copy-tags (булево)

True, чтобы скопировать все теги из исходного снимка кластера баз данных в целевой снимок кластера баз данных, и иначе false. По умолчанию false.

--tags (список)

Теги для назначения новому снимку копии кластера баз данных.

(структура)

Метаданные, назначенные ресурсу Amazon Neptune, состоящие из пары ключ-значение.

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

Ключ — это требуемое имя тега. Значение строки может иметь длину от 1 до 128 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «/», «=», «+», «-» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$”).

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

Значение — это необязательное значение тега. Значение строки может иметь длину от 1 до 256 символов Юникода и не может начинаться с aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «/», «=», «+», «-» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-]*)$”).

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--source-region (строка)

Идентификатор региона, содержащего снимок для копирования.

--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-auto-prompt (булево)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запроса параметров ввода CLI.

Вывод

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

Содержит подробности о снимке кластера баз данных Amazon Neptune.

Этот тип данных используется как элемент ответа в действии DescribeDBClusterSnapshots.

AvailabilityZones -> (список)

Предоставляет список зон доступности EC2, в которых можно восстановить экземпляры в снимке кластера баз данных.

(строка)

DBClusterSnapshotIdentifier -> (строка)

Указывает идентификатор снимка кластера баз данных. Должен совпадать с идентификатором существующего снимка.

После восстановления кластера баз данных с помощью DBClusterSnapshotIdentifier, вы должны указать тот же DBClusterSnapshotIdentifier для любых будущих обновлений кластера баз данных. При указании этого свойства для обновления, кластер баз данных не восстанавливается из снимка повторно, и данные в базе данных не изменяются.

Однако, если вы не укажете DBClusterSnapshotIdentifier, будет создан пустой кластер баз данных, а исходный кластер баз данных будет удалён. Если вы укажете свойство, отличное от предыдущего свойства восстановления из снимка, кластер баз данных будет восстановлен из снимка, указанного в DBClusterSnapshotIdentifier, а исходный кластер баз данных будет удалён.

DBClusterIdentifier -> (строка)

Указывает идентификатор кластера баз данных, из которого был создан данный снимок кластера баз данных.

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

Предоставляет время создания снимка в универсальном координированном времени (UTC).

Engine -> (строка)

Указывает имя движка базы данных.

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

Указывает размер выделенного хранилища в гигабайтах (GiB).

Status -> (строка)

Указывает состояние снимка кластера баз данных.

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

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

VpcId -> (строка)

Предоставляет идентификатор VPC, связанный со снимком кластера баз данных.

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

Указывает время создания кластера баз данных в универсальном координированном времени (UTC).

MasterUsername -> (строка)

Не поддерживается Neptune.

EngineVersion -> (строка)

Предоставляет версию движка базы данных для данного снимка кластера баз данных.

LicenseModel -> (строка)

Предоставляет информацию о лицензионной модели для данного снимка кластера баз данных.

SnapshotType -> (строка)

Предоставляет тип снимка кластера баз данных.

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

Указывает процент завершённого переноса данных.

StorageEncrypted -> (булево)

Указывает, зашифрован ли снимок кластера баз данных.

KmsKeyId -> (строка)

Если StorageEncrypted имеет значение true, то идентификатор ключа Amazon KMS для зашифрованного снимка кластера баз данных.

DBClusterSnapshotArn -> (строка)

Amazon Resource Name (ARN) для снимка кластера баз данных.

SourceDBClusterSnapshotArn -> (строка)

Если снимок кластера баз данных был скопирован из исходного снимка кластера баз данных, Amazon Resource Name (ARN) исходного снимка кластера баз данных, в противном случае – пустое значение.

IAMDatabaseAuthenticationEnabled -> (булево)

True, если включено сопоставление учетных записей Amazon Identity and Access Management (IAM) с учетными записями баз данных, в противном случае false.

StorageType -> (строка)

Тип хранилища, связанный со снимком кластера баз данных.

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

Spec-Zone.ru

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