modify-cluster-db-revision

Описание

Изменяет ревизию базы данных кластера. Ревизия базы данных — это уникальная ревизия базы данных, работающей в кластере.

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

Синтаксис

  modify-cluster-db-revision
--cluster-identifier <value>
--revision-target <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 (строка)

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

Пример: examplecluster

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

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

--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.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

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

Описание кластера.

ClusterIdentifier -> (строка)

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

NodeType -> (строка)

Тип узла для узлов в кластере.

ClusterStatus -> (строка)

Текущее состояние кластера. Возможные значения:

available
available, prep-for-resize
available, resize-cleanup
cancelling-resize
creating
deleting
final-snapshot
hardware-failure
incompatible-hsm
incompatible-network
incompatible-parameters
incompatible-restore
modifying
paused
rebooting
renaming
resizing
rotating-keys
storage-full
updating-hsm

ClusterAvailabilityStatus -> (строка)

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

Доступен - Кластер доступен для запросов.
Недоступен - Кластер недоступен для запросов.
Техническое обслуживание - Кластер временно недоступен для запросов из-за работ по техническому обслуживанию.
Изменяется - Кластер временно недоступен для запросов из-за внесения изменений.
Ошибка - Кластер вышел из строя и недоступен для запросов.

ModifyStatus -> (строка)

Состояние операции модификации, если таковая инициирована для кластера.

MasterUsername -> (строка)

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

DBName -> (строка)

Имя начальной базы данных, созданной при создании кластера. Это же имя возвращается на протяжении всего существования кластера. Если начальная база данных не была указана, по умолчанию была создана база данных с именем dev dev.

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

Точка подключения.

Address -> (строка)

DNS-адрес кластера.

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

Порт, на котором работает движок базы данных.

VpcEndpoints -> (список)

Описание точки подключения.

(структура)

Точка подключения для подключения к кластеру Amazon Redshift через прокси.

VpcEndpointId -> (строка)

Идентификатор точки подключения для подключения к кластеру Amazon Redshift через прокси.

VpcId -> (строка)

Идентификатор VPC, к которому привязана точка подключения.

NetworkInterfaces -> (список)

Один или несколько сетевых интерфейсов точки подключения. Также известен как интерфейсная точка подключения.

(структура)

Описание сетевого интерфейса.

NetworkInterfaceId -> (строка)

Идентификатор сетевого интерфейса.

SubnetId -> (строка)

Идентификатор подсети.

PrivateIpAddress -> (строка)

IPv4-адрес сетевого интерфейса в подсети.

AvailabilityZone -> (строка)

Зона доступности.

Ipv6Address -> (строка)

IPv6-адрес сетевого интерфейса в подсети.

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

Идентификатор группы безопасности VPC.

Status -> (строка)

Статус группы безопасности VPC.

ClusterParameterGroups -> (список)

Список групп параметров кластера, связанных с этим кластером. Каждая группа параметров в списке возвращается со своим статусом.

(структура)

Описание статуса группы параметров.

ParameterGroupName -> (строка)

Имя группы параметров кластера.

ParameterApplyStatus -> (строка)

Статус применения параметров.

ClusterParameterStatusList -> (список)

Список статусов параметров.

Дополнительную информацию о параметрах и группах параметров см. в разделе Amazon Redshift Parameter Groups в руководстве Amazon Redshift Cluster Management Guide.

(структура)

Описание статуса группы параметров.

ParameterName -> (строка)

Имя параметра.

ParameterApplyStatus -> (строка)

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

Возможные статусы и описания:

in-sync : Значение параметра синхронизировано с базой данных.
pending-reboot : Значение параметра будет применено после перезагрузки кластера.
applying : Значение параметра применяется к базе данных.
invalid-parameter : Невозможно применить значение параметра, поскольку оно имеет неверное значение или синтаксис.
apply-deferred : Параметр содержит статические изменения свойств. Изменения отложены до перезагрузки кластера.
apply-error : Невозможно подключиться к кластеру. Изменение параметра будет применено после перезагрузки кластера.
unknown-error : Невозможно применить изменение параметра прямо сейчас. Изменение будет применено после перезагрузки кластера.

ParameterApplyErrorDescription -> (строка)

Ошибка, которая помешала применению параметра к базе данных.

ClusterSubnetGroupName -> (строка)

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

VpcId -> (строка)

Идентификатор VPC, в котором находится кластер, если кластер находится в VPC.

AvailabilityZone -> (строка)

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

PreferredMaintenanceWindow -> (строка)

Еженедельный временной интервал в формате UTC, в течение которого может происходить техническое обслуживание.

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

Значение, которое, если присутствует, указывает на то, что изменения в кластере ожидаются. Конкретные ожидаемые изменения идентифицируются подэлементами.

MasterUserPassword -> (строка)

Ожидаемое или выполняемое изменение пароля административного пользователя кластера.

NodeType -> (строка)

Ожидаемое или выполняемое изменение типа узла кластера.

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

Ожидаемое или выполняемое изменение количества узлов в кластере.

ClusterType -> (строка)

Ожидаемое или выполняемое изменение типа кластера.

ClusterVersion -> (строка)

Ожидаемое или выполняемое изменение версии службы.

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

Ожидаемое или выполняемое изменение периода хранения автоматических снимков.

ClusterIdentifier -> (строка)

Ожидаемое или выполняемое изменение нового идентификатора кластера.

PubliclyAccessible -> (булево)

Ожидаемое или выполняемое изменение возможности подключения к кластеру из общедоступной сети.

EnhancedVpcRouting -> (булево)

Параметр, который указывает, следует ли создать кластер с включенным расширенным маршрутизацией VPC. Для создания кластера, использующего расширенный маршрутизацию VPC, кластер должен находиться в VPC. Подробнее см. раздел Расширенный маршрутизация VPC в руководстве Amazon Redshift Cluster Management Guide.

Если этот параметр true , расширенный маршрутизация VPC включен.

По умолчанию: false

MaintenanceTrackName -> (строка)

Имя дорожки обслуживания, на которую кластер переключится в следующий период обслуживания.

EncryptionType -> (строка)

Тип шифрования для кластера. Возможные значения: KMS и None.

ClusterVersion -> (строка)

Идентификатор версии движка Amazon Redshift, работающего в кластере.

AllowVersionUpgrade -> (булево)

Булево значение, если true , указывает, что автоматическое обновление основной версии будет применено к кластеру во время окна обслуживания.

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

Количество вычислительных узлов в кластере.

PubliclyAccessible -> (булево)

Булево значение, если true , указывает, что к кластеру можно получить доступ из общедоступной сети.

По умолчанию: false

Encrypted -> (булево)

Булево значение, если true , указывает, что данные в кластере зашифрованы в состоянии покоя.

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

Значение, описывающее состояние действия восстановления кластера. Этот параметр возвращает null, если кластер не был создан путём восстановления снимка.

Status -> (строка)

Состояние действия восстановления. Возвращает starting, restoring, completed или failed.

CurrentRestoreRateInMegaBytesPerSecond -> (двойное)

Количество мегабайт в секунду, передаваемых из резервного хранилища. Возвращает среднюю скорость для завершённого резервного копирования. Это поле обновляется только при восстановлении на типы узлов DC2.

SnapshotSizeInMegaBytes -> (целое)

Размер набора данных снимка, используемого для восстановления кластера. Это поле обновляется только при восстановлении на типы узлов DC2.

ProgressInMegaBytes -> (целое)

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

ElapsedTimeInSeconds -> (целое)

Количество времени, в течение которого выполнялось восстановление (в процессе), или время, затраченное на завершённое восстановление. Это поле обновляется только при восстановлении на типы узлов DC2.

EstimatedTimeToCompletionInSeconds -> (целое)

Ожидаемое время до завершения восстановления. Возвращает 0 для завершённого восстановления. Это поле обновляется только при восстановлении на типы узлов DC2.

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

Status -> (строка)

Описывает состояние кластера. Пока передача данных продолжается, состояние равно transferringdata.

CurrentRateInMegaBytesPerSecond -> (двойное)

Описывает скорость передачи данных в МБ/сек.

TotalDataInMegaBytes -> (целое)

Описывает общее количество данных для передачи в мегабайтах.

DataTransferredInMegaBytes -> (целое)

Описывает общее количество данных, переданных в МБ.

EstimatedTimeToCompletionInSeconds -> (целое)

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

ElapsedTimeInSeconds -> (целое)

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

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

Значение, сообщающее, завершил ли кластер Amazon Redshift применение любых изменений настроек модуля аппаратной безопасности (HSM), указанных в команде модификации кластера.

Значения: active, applying

HsmClientCertificateIdentifier -> (строка)

Указывает имя сертификата клиента HSM, используемого кластером Amazon Redshift для получения ключей шифрования данных, хранящихся в HSM.

HsmConfigurationIdentifier -> (строка)

Указывает имя конфигурации HSM, которая содержит информацию, которую кластер Amazon Redshift может использовать для получения и хранения ключей в HSM.

Status -> (строка)

Указывает, завершил ли кластер Amazon Redshift применение любых изменений настроек HSM, указанных в команде модификации кластера.

Значения: active, applying

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

Значение, возвращающее целевой регион и период хранения, настроенные для копирования снимков между регионами.

DestinationRegion -> (строка)

Целевой регион, в который автоматически копируются снимки при включенном копировании снимков между регионами.

RetentionPeriod -> (целое)

Количество дней, в течение которых автоматические снимки сохраняются в целевом регионе после копирования из исходного региона.

ManualSnapshotRetentionPeriod -> (целое)

Количество дней, в течение которых автоматические снимки сохраняются в целевом регионе после копирования из исходного региона. Если значение равно -1, ручной снимок хранится неограниченно.

Значение должно быть либо -1, либо целым числом от 1 до 3653.

SnapshotCopyGrantName -> (строка)

Имя разрешения на копирование снимков.

ClusterPublicKey -> (строка)

Открытый ключ кластера.

ClusterNodes -> (список)

Узлы кластера.

(структура)

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

NodeRole -> (строка)

Узел является лидера или вычислительным узлом.

PrivateIPAddress -> (строка)

Приватный IP-адрес узла в кластере.

PublicIPAddress -> (строка)

Общедоступный IP-адрес узла в кластере.

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

Состояние адреса Elastic IP (EIP).

ElasticIp -> (строка)

Адрес Elastic IP (EIP) для кластера.

Status -> (строка)

Состояние адреса Elastic IP (EIP).

ClusterRevisionNumber -> (строка)

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

Tags -> (список)

Список тегов для кластера.

(структура)

Тег, состоящий из пары имя/значение для ресурса.

Key -> (строка)

Ключ или имя для тега ресурса.

Value -> (строка)

Значение для тега ресурса.

KmsKeyId -> (строка)

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

EnhancedVpcRouting -> (логическое)

Параметр, указывающий, нужно ли создавать кластер с включённым расширенным маршрутизацией VPC. Для создания кластера, использующего расширенную маршрутизацию VPC, кластер должен находиться в VPC. Дополнительная информация приведена в руководстве по управлению кластерами Amazon Redshift.

Если этот параметр true , расширенная маршрутизация VPC включена.

По умолчанию: false

IamRoles -> (список)

Список ролей управления доступом и идентификацией (IAM), которые могут использоваться кластером для доступа к другим службам Amazon Web Services.

(структура)

Роль управления доступом и идентификацией (IAM), которая может использоваться связанным кластером Amazon Redshift для доступа к другим службам Amazon Web Services.

IamRoleArn -> (строка)

Amazon Resource Name (ARN) роли IAM, например, 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 -> (метка времени)

Дата и время в формате UTC, когда может начаться техническое обслуживание системы.

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

Возвращает следующее:

AllowCancelResize: логическое значение, указывающее, можно ли отменить операцию изменения размера.
ResizeType: Возвращает ClassicResize

ResizeType -> (строка)

Возвращает значение ClassicResize.

AllowCancelResize -> (логическое)

Логическое значение, указывающее, можно ли отменить операцию изменения размера.

AvailabilityZoneRelocationStatus -> (строка)

Описание состояния операции перемещения зоны доступности.

ClusterNamespaceArn -> (строка)

Namespace Amazon Resource Name (ARN) кластера.

TotalStorageCapacityInMegaBytes -> (целое)

Общий объём хранилища кластера в мегабайтах.

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

Это поле устарело. Amazon Redshift автоматически определяет, следует ли использовать AQUA (Advanced Query Accelerator).

AquaStatus -> (строка)

Это поле устарело. Amazon Redshift автоматически определяет, следует ли использовать AQUA (Advanced Query Accelerator).

AquaConfigurationStatus -> (строка)

Это поле устарело. Amazon Redshift автоматически определяет, следует ли использовать AQUA (Advanced Query Accelerator).

DefaultIamRoleArn -> (строка)

Amazon Resource Name (ARN) роли IAM, установленной по умолчанию для кластера.

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

Состояние запроса обмена резервированными узлами. Состояния включают в себя в процессе и запрошенный.

ReservedNodeExchangeRequestId -> (строка)

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

Status -> (строка)

Состояние запроса обмена резервированными узлами. Состояния включают в себя в процессе и запрошенный.

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

Дата и время, указывающие, когда был запрошен обмен резервированными узлами.

SourceReservedNodeId -> (строка)

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

SourceReservedNodeType -> (строка)

Тип исходного резервированного узла, например ra3.4xlarge.

SourceReservedNodeCount -> (целое)

Количество исходных резервированных узлов в кластере.

TargetReservedNodeOfferingId -> (строка)

Идентификатор целевого предложения резервированных узлов.

TargetReservedNodeType -> (строка)

Тип узла целевого резервированного узла, например ra3.4xlarge.

TargetReservedNodeCount -> (целое)

Количество целевых резервированных узлов в кластере.

CustomDomainName -> (строка)

Настроенное доменное имя кластера.

CustomDomainCertificateArn -> (строка)

Amazon Resource Name (ARN) сертификата для настроенного доменного имени.

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

Дата истечения срока действия сертификата, связанного с настроенным доменным именем.

MasterPasswordSecretArn -> (string)

Amazon Resource Name (ARN) секрета учетных данных администратора кластера.

MasterPasswordSecretKmsKeyId -> (string)

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

IpAddressType -> (string)

Тип IP-адреса для кластера. Возможные значения - ipv4 и dualstack.

MultiAZ -> (string)

Булево значение, которое, если равно true, указывает, что кластер развернут в двух зонах доступности.

MultiAZSecondary -> (structure)

Вспомогательный вычислительный узел кластера, если включено многозонное развертывание.

AvailabilityZone -> (string)

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

ClusterNodes -> (list)

Узлы во вспомогательном вычислительном узле.

(structure)

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

NodeRole -> (string)

Является ли узел узлом лидера или вычислительным узлом.

PrivateIPAddress -> (string)

Приватный IP-адрес узла в кластере.

PublicIPAddress -> (string)

Общедоступный IP-адрес узла в кластере.