resize-cluster
Описание
Изменяет размер кластера. Вы можете изменить тип кластера или количество или тип узлов. По умолчанию используется метод эластичного изменения размера. При эластичном изменении размера ваш кластер становится доступным для операций чтения и записи быстрее, чем при классическом методе изменения размера.
Операции эластичного изменения размера имеют следующие ограничения:
- Вы можете изменять размер кластеров только следующих типов:
- dc2.large
- dc2.8xlarge
- ra3.large
- ra3.xlplus
- ra3.4xlarge
- ra3.16xlarge
- Тип узлов, которые вы добавляете, должен соответствовать типу узлов кластера.
См. также: Документацию API AWS
Синтаксис
resize-cluster
--cluster-identifier <value>
[--cluster-type <value>]
[--node-type <value>]
[--number-of-nodes <value>]
[--classic | --no-classic]
[--reserved-node-id <value>]
[--target-reserved-node-offering-id <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 (строка)
--cluster-type (строка)
--node-type (строка)
--number-of-nodes (целое число)
--classic | --no-classic (булево)
false , тип изменения размера — эластичный.--reserved-node-id (строка)
--target-reserved-node-offering-id (строка)
--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
- таблица
- 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 в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Для изменения размера кластера
Следующий resize-cluster пример изменяет размер указанного кластера.
aws redshift resize-cluster \
--cluster-identifier mycluster \
--cluster-type multi-node \
--node-type dc2.large \
--number-of-nodes 6 \
--classic
Вывод:
{
"Cluster": {
"ClusterIdentifier": "mycluster",
"NodeType": "dc2.large",
"ClusterStatus": "resizing",
"ClusterAvailabilityStatus": "Modifying",
"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-a1a123ab",
"Status": "active"
}
],
"ClusterParameterGroups": [
{
"ParameterGroupName": "default.redshift-1.0",
"ParameterApplyStatus": "in-sync"
}
],
"ClusterSubnetGroupName": "default",
"VpcId": "vpc-a1abc1a1",
"AvailabilityZone": "us-west-2f",
"PreferredMaintenanceWindow": "sat:16:00-sat:16:30",
"PendingModifiedValues": {
"NodeType": "dc2.large",
"NumberOfNodes": 6,
"ClusterType": "multi-node"
},
"ClusterVersion": "1.0",
"AllowVersionUpgrade": true,
"NumberOfNodes": 4,
"PubliclyAccessible": false,
"Encrypted": false,
"ClusterSnapshotCopyStatus": {
"DestinationRegion": "us-west-1",
"RetentionPeriod": 15,
"ManualSnapshotRetentionPeriod": -1
},
"Tags": [
{
"Key": "mytags",
"Value": "tag1"
}
],
"EnhancedVpcRouting": false,
"IamRoles": [],
"MaintenanceTrackName": "current",
"DeferredMaintenanceWindows": [
{
"DeferMaintenanceIdentifier": "dfm-mUdVCfDcT1B4SGhw6fyF",
"DeferMaintenanceStartTime": "2019-12-10T18:18:39.354Z",
"DeferMaintenanceEndTime": "2020-01-09T18:18:39.354Z"
}
],
"NextMaintenanceWindowStartTime": "2020-01-11T16:00:00Z",
"ResizeInfo": {
"ResizeType": "ClassicResize",
"AllowCancelResize": true
}
}
}
Дополнительную информацию см. в разделе Изменение размера кластера в руководстве по управлению кластерами 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 Parameter Groups в руководстве Amazon Redshift Cluster Management Guide.
(структура)
Описание статуса группы параметров.
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), указанных в команде изменения кластера.
Значения: active, applying
HsmClientCertificateIdentifier -> (строка)
HsmConfigurationIdentifier -> (строка)
Status -> (строка)
Сообщает, завершил ли Amazon Redshift кластер применение изменений настроек HSM, указанных в команде изменения кластера.
Значения: active, applying
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 -> (строка)
MasterPasswordSecretKmsKeyId -> (string)
IpAddressType -> (string)
ipv4 и dualstack .MultiAZ -> (string)
MultiAZSecondary -> (structure)
Второе вычислительное устройство кластера, если включено многозонное развертывание.
AvailabilityZone -> (string)
ClusterNodes -> (list)
Узлы во втором вычислительном устройстве.
(structure)
Идентификатор узла в кластере.
NodeRole -> (string)
PrivateIPAddress -> (string)
PublicIPAddress -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.