удалить-кластер
Описание
Удаляет предварительно настроенный кластер без создания окончательного снимка. Успешный ответ от веб-сервиса означает, что запрос был получен корректно. Используйте DescribeClusters для отслеживания статуса удаления. Операция удаления не может быть отменена или восстановлена после отправки.
Для получения дополнительной информации об управлении кластерами перейдите к Amazon Redshift Clusters в Руководстве по управлению кластерами Amazon Redshift .
Если вы хотите остановить кластер и сохранить его для дальнейшего использования, установите SkipFinalClusterSnapshot в false и укажите имя для FinalClusterSnapshotIdentifier . Позже вы можете восстановить этот снимок, чтобы продолжить использование кластера. Если запрос на окончательный снимок кластера, статус кластера будет «final-snapshot», пока создается снимок, затем он будет «удаляемый», как только Amazon Redshift начнет удалять кластер.
Для получения дополнительной информации об управлении кластерами перейдите к Amazon Redshift Clusters в Руководстве по управлению кластерами Amazon Redshift .
См. также: Документация API AWS
Синтаксис
delete-cluster
--cluster-identifier <value>
[--skip-final-cluster-snapshot | --no-skip-final-cluster-snapshot]
[--final-cluster-snapshot-identifier <value>]
[--final-cluster-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 (строка)
Идентификатор кластера, который необходимо удалить.
Ограничения:
- Должны содержать строчные буквы.
- Должны содержать от 1 до 63 буквенно-цифровых символов или дефисов.
- Первый символ должен быть буквой.
- Не должен заканчиваться дефисом или содержать два дефиса подряд.
--skip-final-cluster-snapshot | --no-skip-final-cluster-snapshot (булево значение)
Определяет, создается ли окончательный снимок кластера перед удалением кластера Amazon Redshift. Если true , окончательный снимок кластера не создается. Если false , окончательный снимок кластера создается перед удалением кластера.
Примечание
Параметр FinalClusterSnapshotIdentifier должен быть указан, если SkipFinalClusterSnapshot равенfalse .Значение по умолчанию: false
--final-cluster-snapshot-identifier (строка)
Идентификатор окончательного снимка, который будет создан непосредственно перед удалением кластера. Если этот параметр указан, SkipFinalClusterSnapshot должен быть false .
Ограничения:
- Должен содержать от 1 до 255 буквенно-цифровых символов.
- Первый символ должен быть буквой.
- Не должен заканчиваться дефисом или содержать два дефиса подряд.
--final-cluster-snapshot-retention-period (целое число)
Количество дней, в течение которых сохраняется ручной снимок. Если значение равно -1, ручной снимок сохраняется неопределенно.
Значение должно быть либо -1, либо целым числом от 1 до 3653.
Значение по умолчанию -1.
--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 .
Удалить кластер без создания окончательного снимка
В этом примере удаляется кластер, принудительно удаляя данные, чтобы не создавался окончательный снимок кластера.
Команда:
aws redshift delete-cluster --cluster-identifier mycluster --skip-final-cluster-snapshot
Удалить кластер, разрешив создание окончательного снимка
В этом примере удаляется кластер, но указывается окончательный снимок кластера.
Команда:
aws redshift delete-cluster --cluster-identifier mycluster --final-cluster-snapshot-identifier myfinalsnapshot
Выходные данные
Кластер -> (структура)
Описание кластера.
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)
Второе вычислительное устройство кластера, если включено развертывание Multi-AZ.
AvailabilityZone -> (string)
ClusterNodes -> (list)
Узлы во втором вычислительном устройстве.
(structure)
Идентификатор узла в кластере.
NodeRole -> (string)
PrivateIPAddress -> (string)
PublicIPAddress -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.