describe-orderable-cluster-options
Описание
Возвращает список доступных вариантов конфигурации кластеров. Перед созданием нового кластера с помощью этой операции можно узнать доступные варианты, такие как доступные зоны доступности EC2 (AZ) в конкретном регионе Amazon Web Services, которые можно указать, и типы узлов, которые можно запросить. Типы узлов отличаются по доступному хранилищу, памяти, ЦП и цене. Учитывая стоимость, возможно, вам нужно получить список вариантов конфигурации кластеров в определённом регионе и указать значения при создании кластера. Более подробную информацию об управлении кластерами см. в разделе Amazon Redshift Clusters в руководстве Amazon Redshift Cluster Management Guide .
См. также: Документацию API AWS
describe-orderable-cluster-options является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответ на постраничную операцию, аргумент --query должен извлекать данные из результатов следующих выражений запроса: OrderableClusterOptions
Синтаксис
describe-orderable-cluster-options
[--cluster-version <value>]
[--node-type <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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-version (строка)
Значение фильтра версии. Укажите этот параметр, чтобы отобразить только доступные предложения, соответствующие указанной версии.
По умолчанию: все версии.
Ограничения: Должно быть одно из значений версии, возвращаемых из DescribeClusterVersions .
--node-type (строка)
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Маркер для указания точки начала постраничной обработки. Это NextToken из ранее урезанного ответа.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface .
--page-size (целое число)
Размер каждой страницы для вызова в службе AWS. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов службы AWS, извлекая меньше элементов в каждом вызове. Это может помочь предотвратить таймаут вызовов службы AWS.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface .
--max-items (целое число)
Общее количество элементов, которые нужно вернуть в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Чтобы возобновить постраничную обработку, укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface .
--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-auto-prompt (булево)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запросы параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, аналогичные UNIX. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Описание всех доступных вариантов конфигурации кластеров
В этом примере возвращаются описания всех доступных вариантов конфигурации кластеров. По умолчанию вывод находится в формате JSON.
Команда:
aws redshift describe-orderable-cluster-options
Результат:
{
"OrderableClusterOptions": [
{
"NodeType": "dw.hs1.8xlarge",
"AvailabilityZones": [
{ "Name": "us-east-1a" },
{ "Name": "us-east-1b" },
{ "Name": "us-east-1c" } ],
"ClusterVersion": "1.0",
"ClusterType": "multi-node"
},
{
"NodeType": "dw.hs1.xlarge",
"AvailabilityZones": [
{ "Name": "us-east-1a" },
{ "Name": "us-east-1b" },
{ "Name": "us-east-1c" } ],
"ClusterVersion": "1.0",
"ClusterType": "multi-node"
},
{
"NodeType": "dw.hs1.xlarge",
"AvailabilityZones": [
{ "Name": "us-east-1a" },
{ "Name": "us-east-1b" },
{ "Name": "us-east-1c" } ],
"ClusterVersion": "1.0",
"ClusterType": "single-node"
} ],
"ResponseMetadata": {
"RequestId": "f6000035-64cb-11e2-9135-ff82df53a51a"
}
}
Вы также можете получить ту же информацию в текстовом формате, используя параметр --output text.
Команда:
aws redshift describe-orderable-cluster-options --output text
Результат:
dw.hs1.8xlarge 1.0 multi-node
us-east-1a
us-east-1b
us-east-1c
dw.hs1.xlarge 1.0 multi-node
us-east-1a
us-east-1b
us-east-1c
dw.hs1.xlarge 1.0 single-node
us-east-1a
us-east-1b
us-east-1c
RESPONSEMETADATA e648696b-64cb-11e2-bec0-17624ad140dd
Вывод
OrderableClusterOptions -> (список)
Структура OrderableClusterOption, содержащая информацию о доступных вариантах конфигурации кластера.
(структура)
Описание доступного варианта конфигурации кластера.
ClusterVersion -> (строка)
ClusterType -> (строка)
multi-node .NodeType -> (строка)
AvailabilityZones -> (список)
Список зон доступности для доступного кластера.
(структура)
Описание зоны доступности.
Name -> (строка)
SupportedPlatforms -> (список)
(структура)
Список поддерживаемых платформ для доступных кластеров.
Name -> (строка)
Marker -> (строка)
Marker и повторив команду. Если поле Marker пустое, все записи ответа для запроса были получены.
© Copyright 2025, Amazon Web Services. Created using Sphinx.