enable-snapshot-copy
Описание
Включает автоматическую копию снимков из одной области в другую для указанного кластера.
См. также: Документацию API AWS
Синтаксис
enable-snapshot-copy
--cluster-identifier <value>
--destination-region <value>
[--retention-period <value>]
[--snapshot-copy-grant-name <value>]
[--manual-snapshot-retention-period <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]
Параметры
--cluster-identifier (строка)
Уникальный идентификатор исходного кластера, с которого нужно копировать снимки.
Ограничения: Должно быть действительное имя существующего кластера, для которого еще не включена межрегиональная копия снимков.
--destination-region (строка)
Целевая область Amazon Web Services, в которую нужно копировать снимки.
Ограничения: Должно быть имя действительной области Amazon Web Services. Дополнительная информация в разделе Регионы и конечные точки в общем справочнике Amazon Web Services.
--retention-period (целое число)
Количество дней хранения автоматических снимков в целевой области после их копирования из исходной области.
По умолчанию: 7.
Ограничения: Должно быть не менее 1 и не более 35.
--snapshot-copy-grant-name (строка)
--manual-snapshot-retention-period (целое число)
Количество дней хранения вновь скопированных снимков в целевой области Amazon Web Services после их копирования из исходной области Amazon Web Services. Если значение равно -1, ручные снимки хранятся неопределенно долго.
Значение должно быть либо -1, либо целым числом от 1 до 3653.
--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.
Для включения копирования снимков для кластера
Следующий enable-snapshot-copy пример включает автоматическую копию снимка для указанного кластера.
aws redshift enable-snapshot-copy \
--cluster-identifier mycluster \
--destination-region us-west-1
Вывод:
{
"Cluster": {
"ClusterIdentifier": "mycluster",
"NodeType": "dc2.large",
"ClusterStatus": "available",
"ClusterAvailabilityStatus": "Available",
"MasterUsername": "adminuser",
"DBName": "dev",
"Endpoint": {
"Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com",
"Port": 5439
},
"ClusterCreateTime": "2019-12-05T18:44:36.991Z",
"AutomatedSnapshotRetentionPeriod": 3,
"ManualSnapshotRetentionPeriod": -1,
"ClusterSecurityGroups": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sh-f4c731cd",
"Status": "active"
}
],
"ClusterParameterGroups": [
{
"ParameterGroupName": "default.redshift-1.0",
"ParameterApplyStatus": "in-sync"
}
],
"ClusterSubnetGroupName": "default",
"VpcId": "vpc-b1ael7t9",
"AvailabilityZone": "us-west-2f",
"PreferredMaintenanceWindow": "sat:16:00-sat:16:30",
"PendingModifiedValues": {
"NodeType": "dc2.large",
"NumberOfNodes": 2,
"ClusterType": "multi-node"
},
"ClusterVersion": "1.0",
"AllowVersionUpgrade": true,
"NumberOfNodes": 4,
"PubliclyAccessible": false,
"Encrypted": false,
"ClusterSnapshotCopyStatus": {
"DestinationRegion": "us-west-1",
"RetentionPeriod": 7,
"ManualSnapshotRetentionPeriod": -1
},
"Tags": [
{
"Key": "mytags",
"Value": "tag1"
}
],
"EnhancedVpcRouting": false,
"IamRoles": [
{
"IamRoleArn": "arn:aws:iam::123456789012:role/myRedshiftRole",
"ApplyStatus": "in-sync"
}
],
"MaintenanceTrackName": "current",
"DeferredMaintenanceWindows": [],
"ExpectedNextSnapshotScheduleTime": "2019-12-10T04:42:43.390Z",
"ExpectedNextSnapshotScheduleTimeStatus": "OnTrack",
"NextMaintenanceWindowStartTime": "2019-12-14T16:00:00Z"
}
}
Дополнительную информацию см. в разделе Копирование снимков в другую область AWS в Руководстве по управлению кластерами Amazon Redshift.
Вывод
Кластер -> (структура)
Описание кластера.
ClusterIdentifier -> (строка)
NodeType -> (строка)
ClusterStatus -> (строка)
Текущее состояние кластера. Возможные значения:
availableavailable, prep-for-resizeavailable, resize-cleanupcancelling-resizecreatingdeletingfinal-snapshothardware-failureincompatible-hsmincompatible-networkincompatible-parametersincompatible-restoremodifyingpausedrebootingrenamingresizingrotating-keysstorage-fullupdating-hsm
ClusterAvailabilityStatus -> (строка)
Статус доступности кластера для запросов. Возможные значения:
- Доступен - Кластер доступен для запросов.
- Недоступен - Кластер недоступен для запросов.
- Техническое обслуживание - Кластер временно доступен для запросов из-за работ по техническому обслуживанию.
- Изменяется - Кластер временно доступен для запросов из-за изменений, которые изменяют кластер.
- Неудачно - Кластер потерпел неудачу и недоступен для запросов.
ModifyStatus -> (строка)
MasterUsername -> (строка)
DBName -> (строка)
dev dev.Endpoint -> (структура)
Точка подключения.
Address -> (строка)
Port -> (целое число)
VpcEndpoints -> (список)
Описание точки подключения.
(структура)
Точка подключения для подключения к кластеру Amazon Redshift через прокси.
VpcEndpointId -> (строка)
VpcId -> (строка)
NetworkInterfaces -> (список)
Один или несколько сетевых интерфейсов точки подключения. Также известны как интерфейсные точки.
(структура)
Описание сетевого интерфейса.
NetworkInterfaceId -> (строка)
SubnetId -> (строка)
PrivateIpAddress -> (строка)
AvailabilityZone -> (строка)
Ipv6Address -> (строка)
ClusterCreateTime -> (метка времени)
AutomatedSnapshotRetentionPeriod -> (целое число)
ManualSnapshotRetentionPeriod -> (целое число)
Стандартное количество дней для сохранения ручных снимков. Если значение равно -1, снимок сохраняется неопределенно долго. Это настройка не изменяет срок хранения существующих снимков.
Значение должно быть либо -1, либо целым числом от 1 до 3653.
ClusterSecurityGroups -> (список)
Список групп безопасности кластера, связанных с кластером. Каждая группа безопасности представлена элементом, содержащим ClusterSecurityGroup.Name и ClusterSecurityGroup.Status подэлементы.
Группы безопасности кластера используются, когда кластер не создается в Amazon Virtual Private Cloud (VPC). Кластеры, созданные в VPC, используют группы безопасности VPC, которые перечислены параметром VpcSecurityGroups.
(структура)
Описание группы безопасности кластера.
ClusterSecurityGroupName -> (строка)
Status -> (строка)
VpcSecurityGroups -> (список)
Список групп безопасности Amazon Virtual Private Cloud (Amazon VPC), связанных с кластером. Этот параметр возвращается только в том случае, если кластер находится в VPC.
(структура)
Описание членов группы безопасности VPC.
VpcSecurityGroupId -> (строка)
Status -> (строка)
ClusterParameterGroups -> (список)
Список групп параметров кластера, связанных с этим кластером. Каждая группа параметров в списке возвращается со своим статусом.
(структура)
Описание статуса группы параметров.
ParameterGroupName -> (строка)
ParameterApplyStatus -> (строка)
ClusterParameterStatusList -> (список)
Список статусов параметров.
Дополнительную информацию о параметрах и группах параметров см. в разделе Группы параметров Amazon Redshift в руководстве по администрированию кластеров Amazon Redshift.
(структура)
Описание статуса группы параметров.
ParameterName -> (строка)
ParameterApplyStatus -> (строка)
Статус параметра, указывающий, синхронизирован ли параметр со значением в базе данных, ожидает ли перезагрузки кластера или при его применении произошла ошибка.
Возможные статусы и их описания:
-
in-sync: Значение параметра синхронизировано с базой данных. -
pending-reboot: Значение параметра будет применено после перезагрузки кластера. -
applying: Значение параметра применяется к базе данных. -
invalid-parameter: Невозможно применить значение параметра, так как оно имеет неверное значение или синтаксис. -
apply-deferred: Параметр содержит статические изменения свойств. Изменения отложены до перезагрузки кластера. -
apply-error: Невозможно подключиться к кластеру. Изменение параметра будет применено после перезагрузки кластера. -
unknown-error: В настоящее время невозможно применить изменение параметра. Изменение будет применено после перезагрузки кластера.
ParameterApplyErrorDescription -> (строка)
ClusterSubnetGroupName -> (строка)
VpcId -> (строка)
AvailabilityZone -> (строка)
PreferredMaintenanceWindow -> (строка)
PendingModifiedValues -> (структура)
Значение, которое, если присутствует, указывает на то, что изменения в кластере находятся в стадии ожидания. Конкретные ожидающие изменения идентифицируются подэлементами.
MasterUserPassword -> (строка)
NodeType -> (строка)
NumberOfNodes -> (целое число)
ClusterType -> (строка)
ClusterVersion -> (строка)
AutomatedSnapshotRetentionPeriod -> (целое число)
ClusterIdentifier -> (строка)
PubliclyAccessible -> (логическое значение)
EnhancedVpcRouting -> (логическое значение)
Параметр, указывающий, следует ли создать кластер с включенным расширенным маршрутизацией VPC. Для создания кластера, использующего расширенную маршрутизацию VPC, кластер должен находиться в VPC. Дополнительную информацию см. в разделе Расширенная маршрутизация VPC в руководстве по управлению кластерами Amazon Redshift.
Если этот параметр true , расширенная маршрутизация VPC включена.
По умолчанию: false
MaintenanceTrackName -> (строка)
EncryptionType -> (строка)
ClusterVersion -> (строка)
AllowVersionUpgrade -> (логическое значение)
true , указывает на то, что обновления основных версий будут применяться автоматически к кластеру во время окна технического обслуживания.NumberOfNodes -> (целое число)
PubliclyAccessible -> (логическое значение)
Логическое значение, которое, если true , указывает, что к кластеру можно получить доступ из общедоступной сети.
По умолчанию: false
Encrypted -> (логическое значение)
true , указывает, что данные в кластере зашифрованы в состоянии покоя.RestoreStatus -> (структура)
Значение, описывающее состояние действия восстановления кластера. Этот параметр возвращает null, если кластер не был создан путём восстановления из снимка.
Status -> (строка)
CurrentRestoreRateInMegaBytesPerSecond -> (двойное)
SnapshotSizeInMegaBytes -> (длинное)
ProgressInMegaBytes -> (длинное)
ElapsedTimeInSeconds -> (длинное)
EstimatedTimeToCompletionInSeconds -> (длинное)
DataTransferProgress -> (структура)
Status -> (строка)
transferringdata .CurrentRateInMegaBytesPerSecond -> (двойное)
TotalDataInMegaBytes -> (длинное)
DataTransferredInMegaBytes -> (длинное)
EstimatedTimeToCompletionInSeconds -> (длинное)
ElapsedTimeInSeconds -> (длинное)
HsmStatus -> (структура)
Значение, сообщающее, завершил ли Amazon Redshift кластер применение любых изменений настроек модуля аппаратной безопасности (HSM), указанных в команде изменения кластера.
Значения: активен, применяется
HsmClientCertificateIdentifier -> (строка)
HsmConfigurationIdentifier -> (строка)
Status -> (строка)
Сообщает, завершил ли Amazon Redshift кластер применение любых изменений настроек HSM, указанных в команде изменения кластера.
Значения: активен, применяется
ClusterSnapshotCopyStatus -> (структура)
Значение, которое возвращает целевой регион и период хранения, настроенные для копирования снимка между регионами.
DestinationRegion -> (строка)
RetentionPeriod -> (длинное)
ManualSnapshotRetentionPeriod -> (целое)
Количество дней, в течение которых автоматические снимки сохраняются в целевом регионе после копирования из исходного региона. Если значение равно -1, ручной снимок хранится неопределённо долго.
Значение должно быть либо -1, либо целым числом от 1 до 3653.
SnapshotCopyGrantName -> (строка)
ClusterPublicKey -> (строка)
ClusterNodes -> (список)
Узлы в кластере.
(структура)
Идентификатор узла в кластере.
NodeRole -> (строка)
PrivateIPAddress -> (строка)
PublicIPAddress -> (строка)
ElasticIpStatus -> (структура)
Состояние адреса эластичного IP (EIP).
ElasticIp -> (строка)
Status -> (строка)
ClusterRevisionNumber -> (строка)
Tags -> (список)
Список тегов для кластера.
(структура)
Тег, состоящий из пары имя/значение для ресурса.
Key -> (строка)
Value -> (строка)
KmsKeyId -> (строка)
EnhancedVpcRouting -> (логическое)
Параметр, указывающий, нужно ли создавать кластер с включённым расширенным маршрутизацией VPC. Для создания кластера, использующего расширенную маршрутизацию VPC, кластер должен находиться в VPC. Дополнительные сведения см. в руководстве по управлению Amazon Redshift кластерами.
Если этот параметр true , расширенная маршрутизация VPC включена.
По умолчанию: false
IamRoles -> (список)
Список ролей Identity and Access Management (IAM), которые можно использовать кластером для доступа к другим службам Amazon Web Services.
(структура)
Роль Identity and Access Management (IAM), которую можно использовать связанному Amazon Redshift кластеру для доступа к другим службам Amazon Web Services.
IamRoleArn -> (строка)
arn:aws:iam::123456789012:role/RedshiftCopyUnload .ApplyStatus -> (строка)
Значение, описывающее состояние ассоциации роли IAM с Amazon Redshift кластером.
Ниже приведены возможные состояния и описания.
-
in-sync: Роль доступна для использования кластером. -
adding: Роль находится в процессе ассоциации с кластером. -
removing: Роль находится в процессе отсоединения от кластера.
PendingActions -> (список)
Операции кластера, ожидающие запуска.
(строка)
MaintenanceTrackName -> (строка)
ElasticResizeNumberOfNodeOptions -> (строка)
DeferredMaintenanceWindows -> (список)
Описание группы объектов DeferredMaintenanceWindow .
(структура)
Описание окна обслуживания с отложенным выполнением.
DeferMaintenanceIdentifier -> (строка)
DeferMaintenanceStartTime -> (метка времени)
DeferMaintenanceEndTime -> (метка времени)
SnapshotScheduleIdentifier -> (строка)
SnapshotScheduleState -> (строка)
ExpectedNextSnapshotScheduleTime -> (метка времени)
ExpectedNextSnapshotScheduleTimeStatus -> (строка)
Статус ожидаемого следующего снимка для кластеров, имеющих действующий график создания снимков и включённые резервные копии. Возможные значения следующие:
- OnTrack - Следующий снимок ожидается в срок.
- Pending - Следующий снимок ожидает создания.
NextMaintenanceWindowStartTime -> (метка времени)
ResizeInfo -> (структура)
Возвращает следующее:
- AllowCancelResize: логическое значение, указывающее, можно ли отменить операцию изменения размера.
- ResizeType: Возвращает ClassicResize
ResizeType -> (строка)
ClassicResize .AllowCancelResize -> (логическое)
AvailabilityZoneRelocationStatus -> (строка)
ClusterNamespaceArn -> (строка)
TotalStorageCapacityInMegaBytes -> (длинное)
AquaConfiguration -> (структура)
Это поле устарело. Amazon Redshift автоматически определяет, использовать ли AQUA (Advanced Query Accelerator).
AquaStatus -> (строка)
AquaConfigurationStatus -> (строка)
DefaultIamRoleArn -> (строка)
ReservedNodeExchangeStatus -> (структура)
Состояние запроса обмена резервными узлами. Статусы включают в себя выполнение и запрос.
ReservedNodeExchangeRequestId -> (строка)
Status -> (строка)
RequestTime -> (метка времени)
SourceReservedNodeId -> (строка)
SourceReservedNodeType -> (строка)
SourceReservedNodeCount -> (целое)
TargetReservedNodeOfferingId -> (строка)
TargetReservedNodeType -> (строка)
TargetReservedNodeCount -> (целое)
CustomDomainName -> (строка)
CustomDomainCertificateArn -> (строка)
CustomDomainCertificateExpiryDate -> (метка времени)
MasterPasswordSecretArn -> (string)
MasterPasswordSecretKmsKeyId -> (string)
IpAddressType -> (string)
ipv4 и dualstack.MultiAZ -> (string)
MultiAZSecondary -> (structure)
Второе вычислительное устройство кластера, если включено развертывание Multi-AZ.
AvailabilityZone -> (string)
ClusterNodes -> (list)
Узлы во втором вычислительном устройстве.
(structure)
Идентификатор узла в кластере.
NodeRole -> (string)
PrivateIPAddress -> (string)
PublicIPAddress -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.