Spec-Zone.ru › AWS CLI v2

[ aws . docdb ]

describe-global-clusters

Описание

Возвращает информацию об Amazon DocumentDB глобальных кластерах. Этот API поддерживает постраничную навигацию.

Примечание

Данное действие применяется только к кластерам Amazon DocumentDB.

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

describe-global-clusters является постраничной операцией. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничную навигацию, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной навигацией, аргумент --query должен извлекать данные из результатов следующих выражений запроса: GlobalClusters

Синтаксис

  describe-global-clusters
[--global-cluster-identifier <value>]
[--filters <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]

Параметры

--global-cluster-identifier (строка)

Указанный пользователем идентификатор кластера. Если этот параметр указан, возвращается информация только о конкретном кластере. Этот параметр не чувствителен к регистру.

--filters (список)

Фильтр, определяющий один или несколько глобальных БД-кластеров для описания.

Поддерживаемые фильтры: db-cluster-id принимает идентификаторы кластеров и Amazon Resource Names (ARN) кластеров. Список результатов будет содержать информацию только о кластерах, идентифицированных этими ARN.

(структура)

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

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

Name -> (строка)

Название фильтра. Названия фильтров чувствительны к регистру.

Values -> (список)

Одно или несколько значений фильтра. Значения фильтров чувствительны к регистру.

(строка)

Сокращенный синтаксис:

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

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

Вывод

Marker -> (строка)

GlobalClusters -> (список)

(структура)

Тип данных, представляющий глобальный кластер Amazon DocumentDB.

GlobalClusterIdentifier -> (строка)

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

GlobalClusterResourceId -> (строка)

Уникальный, неизменяемый идентификатор глобального кластера баз данных, относящийся к региону Amazon Web Services. Этот идентификатор можно найти в записях журнала CloudTrail всякий раз, когда осуществляется доступ к KMS-ключу (CMK) для кластера.

GlobalClusterArn -> (строка)

Amazon Resource Name (ARN) для глобального кластера.

Status -> (строка)

Указывает текущее состояние этого глобального кластера.

Engine -> (строка)

Используемый глобальным кластером движок базы данных Amazon DocumentDB.

EngineVersion -> (строка)

Указывает версию движка базы данных.

DatabaseName -> (строка)

Название базы данных по умолчанию в новом глобальном кластере.

StorageEncrypted -> (булево)

Настройка шифрования хранилища для глобального кластера.

DeletionProtection -> (булево)

Настройка защиты от удаления для нового глобального кластера.

GlobalClusterMembers -> (список)

Список идентификаторов кластеров для вторичных кластеров в пределах глобального кластера. В настоящее время ограничен одним элементом.

(структура)

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

DBClusterArn -> (строка)

Amazon Resource Name (ARN) для каждого кластера Amazon DocumentDB.

Readers -> (список)

Amazon Resource Name (ARN) для каждого вторичного кластера с возможностью чтения, связанного с Aurora глобальным кластером.

(строка)

IsWriter -> (булево)

Указывает, является ли кластер Amazon DocumentDB первичным кластером (то есть, имеет возможность чтения и записи) для Amazon DocumentDB глобального кластера, с которым он связан.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API