[ aws . resource-groups ]
get-group-query
Описание
Получает запрос на ресурс, связанный с указанной группой ресурсов. Дополнительную информацию о запросах на ресурсы см. в разделе Создание группы на основе тегов в группах ресурсов.
Для выполнения этой команды вам необходимо иметь следующие разрешения:
resource-groups:GetGroupQuery
См. также: Документация API AWS
Синтаксис
get-group-query
[--group-name <value>]
[--group <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]
Параметры
--group-name (строка)
Group вместо него.--group (строка)
--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-auto-prompt (булево)
Автоматически запрашивать параметры CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запросы параметров CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. раздел Использование кавычек со строками в руководстве пользователя AWS CLI.
Получение запроса, прикрепленного к группе ресурсов
Следующий пример отображает запрос, прикрепленный к указанной группе ресурсов.
aws resource-groups get-group-query \
--group-name tbq-WebServer
Вывод:
{
"GroupQuery": {
"GroupName": "tbq-WebServer",
"ResourceQuery": {
"Type": "TAG_FILTERS_1_0",
"Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"Name\", \"Values\":[\"WebServers\"]}]}"
}
}
}
Вывод
GroupQuery -> (структура)
Запрос на ресурс, связанный с указанной группой. Дополнительную информацию о запросах на ресурсы см. в разделе Создание группы на основе тегов в группах ресурсов.
GroupName -> (строка)
ResourceQuery -> (структура)
Запрос на ресурс, определяющий, какие ресурсы Amazon Web Services являются членами связанной группы ресурсов.
Type -> (строка)
Тип запроса для выполнения. Может иметь одно из двух значений:
-
*
CLOUDFORMATION_STACK_1_0:* Указывает, что вы хотите, чтобы группа содержала члены стека CloudFormation.Queryсодержит элементStackIdentifierс Amazon Resource Name (ARN) для стека CloudFormation. -
*
TAG_FILTERS_1_0:* Указывает, что вы хотите, чтобы группа включала ресурсы, которые имеют теги, соответствующие запросу.
Query -> (строка)
Запрос, определяющий группу или поиск. Содержимое зависит от значения элемента Type.
-
ResourceTypeFilters– Применяется ко всем объектамResourceQueryтипа либоType. Этот элемент содержит один из следующих двух элементов:- Значение
AWS::AllSupported. Это приводит к тому, что ResourceQuery соответствует ресурсам любого типа ресурса, которые также соответствуют запросу. - Список (массив JSON) идентификаторов типа ресурсов, которые ограничивают запрос только ресурсами указанных типов. Полный список типов ресурсов, которые можно использовать в значении массива для
ResourceTypeFilters, см. в разделе Ресурсы, которые можно использовать с группами ресурсов и редактором тегов в руководстве пользователя по группам ресурсов.
- Значение
Пример: "ResourceTypeFilters": ["AWS::AllSupported"] или "ResourceTypeFilters": ["AWS::EC2::Instance", "AWS::S3::Bucket"]
-
TagFilters– применимо только еслиType=TAG_FILTERS_1_0.Queryсодержит JSON-строку, представляющую набор простых фильтров тегов. JSON-строка использует синтаксис, похожий на операцию ``GetResources``, но использует только поля ``ResourceTypeFilters`` и ``TagFilters``. Если вы укажете более одного ключа тега, будут возвращены только ресурсы, которые соответствуют всем ключам тегов и по крайней мере одному значению каждого указанного ключа тега. Если вы укажете более одного значения для ключа тега, ресурс соответствует фильтру, если он имеет значение ключа тега, которое соответствует любому из указанных значений. Например, рассмотрим следующий пример запроса для ресурсов, имеющих два тега,StageиVersion, с двумя значениями каждый:[{"Stage":["Test","Deploy"]},{"Version":["1","2"]}]. Результаты этого запроса на ресурс могут включать следующие элементы.- Экземпляр Amazon EC2, у которого есть следующие два тега:
{"Stage":"Deploy"}и{"Version":"2"} - Ведро S3, у которого есть следующие два тега:
{"Stage":"Test"}и{"Version":"1"}
- Экземпляр Amazon EC2, у которого есть следующие два тега:
Результаты запроса на ресурс не будут включать следующие элементы в результатах, однако.
- Экземпляр Amazon EC2, имеющий только следующий тег:
{"Stage":"Deploy"}. Экземпляр не имеет всех ключей тега, указанных в фильтре, поэтому он исключается из результатов. - База данных RDS, имеющая следующие два тега:
{"Stage":"Archived"}и{"Version":"4"}. База данных имеет все ключи тегов, но ни один из этих ключей не имеет связанного значения, соответствующего хотя бы одному из указанных значений в фильтре.
Пример: "TagFilters": [ { "Key": "Stage", "Values": [ "Gamma", "Beta" ] }
-
StackIdentifier– применимо только еслиType=CLOUDFORMATION_STACK_1_0. Значение этого параметра — Amazon Resource Name (ARN) стека CloudFormation, ресурсы которого должны быть включены в группу.
© Copyright 2025, Amazon Web Services. Created using Sphinx.