modify-cluster-snapshot
Описание
Изменяет настройки моментального снимка.
В этом примере изменяется параметр срока хранения ручных моментальных снимков кластера.
См. также: Документация API AWS
Синтаксис
modify-cluster-snapshot
--snapshot-identifier <value>
[--manual-snapshot-retention-period <value>]
[--force | --no-force]
[--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]
Параметры
--snapshot-identifier (строка)
--manual-snapshot-retention-period (целое число)
Количество дней, в течение которых сохраняется ручный моментальный снимок. Если значение равно -1, ручный моментальный снимок сохраняется неопределённо долго.
Если ручный моментальный снимок выходит за пределы нового срока хранения, вы можете указать параметр force, чтобы немедленно удалить моментальный снимок.
Значение должно быть либо -1, либо целым числом от 1 до 3653.
--force | --no-force (логическое значение)
--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 (строка)
Включить/отключить цветной вывод.
- on
- off
- auto
--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.
Примеры
Примечание
Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для изменения моментального снимка кластера
Следующий пример устанавливает срок хранения ручных моментальных снимков для указанного моментального снимка кластера на 10 дней.
aws redshift modify-cluster-snapshot \
--snapshot-identifier mycluster-2019-11-06-16-32 \
--manual-snapshot-retention-period 10
Вывод:
{
"Snapshot": {
"SnapshotIdentifier": "mycluster-2019-11-06-16-32",
"ClusterIdentifier": "mycluster",
"SnapshotCreateTime": "2019-12-07T00:34:05.633Z",
"Status": "available",
"Port": 5439,
"AvailabilityZone": "us-west-2f",
"ClusterCreateTime": "2019-12-05T18:44:36.991Z",
"MasterUsername": "adminuser",
"ClusterVersion": "1.0",
"SnapshotType": "manual",
"NodeType": "dc2.large",
"NumberOfNodes": 2,
"DBName": "dev",
"VpcId": "vpc-b1cel7t9",
"Encrypted": false,
"EncryptedWithHSM": false,
"OwnerAccount": "123456789012",
"TotalBackupSizeInMegaBytes": 64384.0,
"ActualIncrementalBackupSizeInMegaBytes": 24.0,
"BackupProgressInMegaBytes": 24.0,
"CurrentBackupRateInMegaBytesPerSecond": 13.0011,
"EstimatedSecondsToCompletion": 0,
"ElapsedTimeInSeconds": 1,
"Tags": [
{
"Key": "mytagkey",
"Value": "mytagvalue"
}
],
"EnhancedVpcRouting": false,
"MaintenanceTrackName": "current",
"ManualSnapshotRetentionPeriod": 10,
"ManualSnapshotRemainingDays": 6,
"SnapshotRetentionStartTime": "2019-12-07T00:34:07.479Z"
}
}
Дополнительную информацию см. в разделе Amazon Redshift Snapshots в Руководстве по управлению кластерами Amazon Redshift.
Вывод
Снимок -> (структура)
Описание снимка.
SnapshotIdentifier -> (строка)
ClusterIdentifier -> (строка)
SnapshotCreateTime -> (метка времени)
Статус -> (строка)
Статус снимка. Значение статуса зависит от используемой операции API:
- CreateClusterSnapshot и CopyClusterSnapshot возвращают статус как «создание».
- DescribeClusterSnapshots возвращает статус как «создание», «доступно», «окончательный снимок» или «сбой».
- DeleteClusterSnapshot возвращает статус как «удалено».
Порт -> (целое число)
AvailabilityZone -> (строка)
ClusterCreateTime -> (метка времени)
MasterUsername -> (строка)
ClusterVersion -> (строка)
EngineFullVersion -> (строка)
SnapshotType -> (строка)
NodeType -> (строка)
NumberOfNodes -> (целое число)
DBName -> (строка)
VpcId -> (строка)
Encrypted -> (булево)
true , данные в снимке шифруются в состоянии покоя.KmsKeyId -> (строка)
EncryptedWithHSM -> (булево)
true указывает, что данные шифруются с использованием ключей HSM.AccountsWithRestoreAccess -> (список)
Список Amazon Web Services учетных записей, авторизованных для восстановления снимка. Возвращает null, если учетные записи не авторизованы. Видимый только владельцу снимка.
(структура)
Описание Amazon Web Services учетной записи, авторизованной для восстановления снимка.
AccountId -> (строка)
AccountAlias -> (строка)
amazon-redshift-support.OwnerAccount -> (строка)
TotalBackupSizeInMegaBytes -> (двойное)
ActualIncrementalBackupSizeInMegaBytes -> (двойное)
BackupProgressInMegaBytes -> (двойное)
CurrentBackupRateInMegaBytesPerSecond -> (двойное)
0 для завершенного резервного копирования.EstimatedSecondsToCompletion -> (целое число с длинной размерностью)
0 для завершенного резервного копирования.ElapsedTimeInSeconds -> (целое число с длинной размерностью)
SourceRegion -> (строка)
Tags -> (список)
Список тегов для снимка кластера.
(структура)
Тег, состоящий из пары имя/значение для ресурса.
Key -> (строка)
Value -> (строка)
RestorableNodeTypes -> (список)
Список типов узлов, в которые можно восстановить этот снимок кластера.
(строка)
EnhancedVpcRouting -> (булево)
Параметр, определяющий, включить ли расширенное маршрутизирование VPC при создании кластера. Для создания кластера с использованием расширенного маршрутизирования VPC, кластер должен находиться в VPC. Подробнее см. Расширенное маршрутизирование VPC в руководстве по управлению кластерами Amazon Redshift.
Если этот параметр true , расширенное маршрутизирование VPC включено.
По умолчанию: false
MaintenanceTrackName -> (строка)
ManualSnapshotRetentionPeriod -> (целое число)
Количество дней, в течение которых сохраняется ручной снимок. Если значение равно -1, ручной снимок хранится неопределенно.
Значение должно быть либо -1, либо целым числом от 1 до 3653.
ManualSnapshotRemainingDays -> (целое число)
SnapshotRetentionStartTime -> (метка времени)
MasterPasswordSecretArn -> (строка)
MasterPasswordSecretKmsKeyId -> (строка)
SnapshotArn -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.