Spec-Zone.ru › AWS CLI v2

[ aws . route53resolver ]

list-resolver-query-log-config-associations

Описание

Отображает информацию об ассоциациях между VPC Amazon и конфигурациями ведения журнала запросов.

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

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

Синтаксис

  list-resolver-query-log-config-associations
[--filters <value>]
[--sort-by <value>]
[--sort-order <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]

Параметры

--filters (список)

Необязательное указание для возврата подмножества ассоциаций журналов запросов.

Примечание

Если вы отправляете второй или последующий запрос ListResolverQueryLogConfigAssociations и указываете параметр NextToken, вы должны использовать те же значения для Filters, если таковые имеются, что и в предыдущем запросе.

(структура)

Для операций списка Resolver (ListResolverEndpoints , ListResolverRules , ListResolverRuleAssociations , ListResolverQueryLogConfigs , ListResolverQueryLogConfigAssociations ) и ListResolverDnssecConfigs ) необязательное указание для возврата подмножества объектов.

Для фильтрации объектов, таких как узлы Resolver или правила Resolver, вы указываете Name и Values . Например, для отображения только входных узлов Resolver укажите Direction для Name и укажите INBOUND для Values .

Имя -> (строка)

Имя параметра, который вы хотите использовать для фильтрации объектов.

Допустимые значения для Name зависят от действия, в которое включён фильтр: ListResolverEndpoints , ListResolverRules , ListResolverRuleAssociations , ListResolverQueryLogConfigs или ListResolverQueryLogConfigAssociations .

Примечание

В ранних версиях Resolver значения для Name были перечислены в верхнем регистре, с разделителями подчеркивания (_). Например, CreatorRequestId изначально был перечислен как CREATOR_REQUEST_ID. Значения Name в верхнем регистре по-прежнему поддерживаются.

ListResolverEndpoints

Допустимые значения для Name включают в себя следующие:

  • CreatorRequestId : значение, которое вы указали при создании узла Resolver.
  • Direction : хотите ли вы вернуть входные или выходные узлы Resolver. Если вы указываете DIRECTION для Name , укажите INBOUND или OUTBOUND для Values .
  • HostVPCId : идентификатор VPC, через который входные запросы DNS проходят от вашей сети к вашим VPC в регионе или VPC, через который выходные запросы проходят от ваших VPC к вашей сети. В запросе CreateResolverEndpoint SubnetId косвенно идентифицирует VPC. В запросе GetResolverEndpoint идентификатор VPC для узла Resolver возвращается в элементе HostVPCId .
  • IpAddressCount : количество IP-адресов, связанных с узлом Resolver.
  • Name : имя узла Resolver.
  • SecurityGroupIds : идентификаторы групп безопасности VPC, которые вы указали при создании узла Resolver.
  • Status : состояние узла Resolver. Если вы указываете Status для Name , укажите один из следующих кодов состояния для Values : CREATING , OPERATIONAL , UPDATING , AUTO_RECOVERING , ACTION_NEEDED или DELETING . Для получения дополнительной информации см. Status в ResolverEndpoint .
ListResolverRules

Допустимые значения для Name включают в себя следующие:

  • CreatorRequestId : значение, которое вы указали при создании правила Resolver.
  • DomainName : доменное имя, для которого Resolver перенаправляет запросы DNS в вашу сеть. В значении, которое вы указываете для Values , включите точку (.) после доменного имени. Например, если доменное имя example.com, укажите следующее значение. Обратите внимание на «.» после com : example.com.
  • Name : имя правила Resolver.
  • ResolverEndpointId : идентификатор узла Resolver, с которым связано правило Resolver.

Примечание

Вы можете фильтровать по узлу Resolver только для правил, у которых значение FORWARD для RuleType .
  • Status : состояние правила Resolver. Если вы указываете Status для Name , укажите один из следующих кодов состояния для Values : COMPLETE , DELETING , UPDATING или FAILED .
  • Type : тип правила Resolver. Если вы указываете TYPE для Name , укажите FORWARD или SYSTEM для Values .
ListResolverRuleAssociations

Допустимые значения для Name включают в себя следующие:

  • Name : имя ассоциации правила Resolver.
  • ResolverRuleId : идентификатор правила Resolver, связанного с одной или несколькими VPC.
  • Status : состояние ассоциации правила Resolver. Если вы указываете Status для Name , укажите один из следующих кодов состояния для Values : CREATING , COMPLETE , DELETING или FAILED .
  • VPCId : идентификатор VPC, с которым связано правило Resolver.
ListResolverQueryLogConfigs

Допустимые значения для Name включают в себя следующие:

  • Arn : ARN конфигурации ведения журнала запросов.
  • AssociationCount : количество VPC, связанных с конфигурацией ведения журнала запросов.
  • CreationTime : дата и время создания конфигурации ведения журнала запросов в формате Unix и по координированному всемирному времени (UTC).
  • CreatorRequestId : уникальная строка, идентифицирующая запрос, создавший конфигурацию ведения журнала запросов.
  • Destination : служба Amazon Web Services, в которую вы хотите перенаправить журналы запросов. Допустимые значения включают в себя следующие:
    • S3
    • CloudWatchLogs
    • KinesisFirehose
  • DestinationArn : ARN расположения, куда Resolver отправляет журналы запросов. Это значение может быть ARN для ведра S3, группы журналов CloudWatch Logs или потока доставки Kinesis Data Firehose.
  • Id : идентификатор конфигурации ведения журнала запросов
  • Name : имя конфигурации ведения журнала запросов
  • OwnerId : идентификатор учетной записи Amazon Web Services для учетной записи, создавшей конфигурацию ведения журнала запросов.
  • ShareStatus : указание о том, является ли конфигурация ведения журнала запросов совместной с другими учетными записями Amazon Web Services или была разделена с текущей учетной записью другой учетной записью Amazon Web Services. Допустимые значения включают: NOT_SHARED , SHARED_WITH_ME или SHARED_BY_ME .
  • Status : состояние конфигурации ведения журнала запросов. Если вы указываете Status для Name , укажите соответствующий код состояния для Values : CREATING , CREATED , DELETING или FAILED . Для получения дополнительной информации см. Статус .
ListResolverQueryLogConfigAssociations

Допустимые значения для Name включают в себя следующие:

  • CreationTime : дата и время ассоциации VPC с конфигурацией ведения журнала запросов в формате Unix и по координированному всемирному времени (UTC).
  • Error : Если значение Status является FAILED , укажите причину: DESTINATION_NOT_FOUND или ACCESS_DENIED .
  • Id : идентификатор ассоциации ведения журнала запросов.
  • ResolverQueryLogConfigId : идентификатор конфигурации ведения журнала запросов, с которой связана VPC.
  • ResourceId : идентификатор Amazon VPC, связанный с конфигурацией ведения журнала запросов.
  • Status : состояние ассоциации ведения журнала запросов. Если вы указываете Status для Name , укажите соответствующий код состояния для Values : CREATING , CREATED , DELETING или FAILED . Для получения дополнительной информации см. Статус .

Значения -> (список)

Когда вы используете операцию List и хотите, чтобы операция возвращала подмножество объектов, таких как узлы Resolver или правила Resolver, укажите значение параметра, который вы хотите использовать для фильтрации объектов. Например, для отображения только входных узлов Resolver укажите Direction для Name и укажите INBOUND для Values .

(строка)

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

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

Синтаксис JSON:

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

--sort-by (строка)

Элемент, по которому Resolver должен сортировать ассоциации протоколирования запросов.

Примечание

Если вы отправляете второй или последующий запрос ListResolverQueryLogConfigAssociations и указываете параметр NextToken, вы должны использовать то же значение для SortBy, если таковое имеется, что и в предыдущем запросе.

Допустимые значения включают следующие элементы:

  • CreationTime: Идентификатор ассоциации протоколирования запросов.
  • Error: Если значение Status равно FAILED, значение Error указывает причину:
    • DESTINATION_NOT_FOUND: Указанное место назначения (например, ведро Amazon S3) было удалено.
    • ACCESS_DENIED: Разрешения не позволяют отправлять журналы в место назначения.

Если Status — значение отличное от FAILED, то ERROR равно null.

  • Id: Идентификатор ассоциации протоколирования запросов
  • ResolverQueryLogConfigId: Идентификатор конфигурации протоколирования запросов
  • ResourceId: Идентификатор VPC, связанный с конфигурацией протоколирования запросов
  • Status: Текущий статус конфигурации. Допустимые значения включают следующие:
    • CREATING: Resolver создает ассоциацию между Amazon VPC и конфигурацией протоколирования запросов.
    • CREATED: Ассоциация между Amazon VPC и конфигурацией протоколирования запросов была успешно создана. Resolver протоколирует запросы, исходящие из указанной VPC.
    • DELETING: Resolver удаляет эту ассоциацию протоколирования запросов.
    • FAILED: Resolver не смог создать или удалить ассоциацию протоколирования запросов. Вот две распространенные причины:
      • Указанное место назначения (например, ведро Amazon S3) было удалено.
      • Разрешения не позволяют отправлять журналы в место назначения.

--sort-order (строка)

Если вы указали значение для SortBy, порядок, в котором вы хотите отобразить ассоциации протоколирования запросов, ASCENDING или DESCENDING.

Примечание

Если вы отправляете второй или последующий запрос ListResolverQueryLogConfigAssociations и указываете параметр NextToken, вы должны использовать то же значение для SortOrder, если таковое имеется, что и в предыдущем запросе.

Возможные значения:

  • ASCENDING
  • DESCENDING

--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 (строка)

Файл сертификата корневого центра для использования при проверке сертификатов SSL. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, который соответствует двоичному блоку, 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.

Вывод

NextToken -> (строка)

Если существует более MaxResults ассоциаций журналов запросов, можно отправить еще один запрос ListResolverQueryLogConfigAssociations, чтобы получить следующую группу ассоциаций. В следующем запросе укажите значение NextToken из предыдущего ответа.

TotalCount -> (целое число)

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

TotalFilteredCount -> (целое число)

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

ResolverQueryLogConfigAssociations -> (список)

Список, содержащий по одному элементу ResolverQueryLogConfigAssociations для каждой ассоциации журналов запросов, соответствующей указанным значениям для Filter.

(структура)

В ответе на запрос AssociateResolverQueryLogConfig, DisassociateResolverQueryLogConfig, GetResolverQueryLogConfigAssociation или ListResolverQueryLogConfigAssociations — сложный тип, содержащий параметры для указанной ассоциации между Amazon VPC и конфигурацией ведения журналов запросов.

Id -> (строка)

Идентификатор ассоциации журналов запросов.

ResolverQueryLogConfigId -> (строка)

Идентификатор конфигурации ведения журналов запросов, с которой связан VPC.

ResourceId -> (строка)

Идентификатор Amazon VPC, связанный с конфигурацией ведения журналов запросов.

Status -> (строка)

Статус указанной ассоциации журналов запросов. Допустимые значения включают:

  • CREATING : Resolver создаёт ассоциацию между Amazon VPC и конфигурацией ведения журналов запросов.
  • ACTIVE : Ассоциация между Amazon VPC и конфигурацией ведения журналов запросов была успешно создана. Resolver регистрирует запросы, исходящие из указанного VPC.
  • DELETING : Resolver удаляет эту ассоциацию журналов запросов.
  • FAILED : Resolver не смог создать или удалить ассоциацию журналов запросов.

Error -> (строка)

Если значение Status равно FAILED, значение Error указывает причину:

  • DESTINATION_NOT_FOUND : Указанный пункт назначения (например, ведро Amazon S3) был удалён.
  • ACCESS_DENIED : Разрешения не позволяют отправлять журналы в пункт назначения.

Если значение Status отличается от FAILED, то Error равно null.

ErrorMessage -> (строка)

Содержит дополнительную информацию об ошибке. Если значение Error или null, значение ErrorMessage также равно null.

CreationTime -> (строка)

Дата и время, когда VPC была связана с конфигурацией ведения журналов запросов, в формате Unix time и UTC.

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

Spec-Zone.ru

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