Spec-Zone.ru › AWS CLI v2

[ aws . route53resolver ]

list-resolver-endpoints

Описание

Перечисляет все конечные точки Resolver, созданные с использованием текущей учетной записи Amazon Web Services.

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

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

Синтаксис

  list-resolver-endpoints
[--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]

Параметры

--filters (список)

Необязательное описание для возврата подмножества конечных точек разрешителя, таких как все входящие конечные точки разрешителя.

Примечание

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

(структура)

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

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

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

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

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

Примечание

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

ListResolverEndpoints

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

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

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

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

Примечание

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

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

  • Name : Название ассоциации правила разрешителя.
  • ResolverRuleId : Идентификатор правила разрешителя, связанного с одной или несколькими VPC.
  • Status : Статус ассоциации правила разрешителя. Если вы указываете Status для Name, укажите один из следующих кодов состояния для Values : CREATING, COMPLETE, DELETING или FAILED.
  • VPCId : Идентификатор VPC, с которым связано правило разрешителя.
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 и хотите, чтобы операция возвращала подмножество объектов, таких как конечные точки разрешителя или правила разрешителя, значение параметра, который вы хотите использовать для фильтрации объектов. Например, чтобы отобразить только входящие конечные точки разрешителя, укажите Direction для Name и укажите INBOUND для 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.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры входных данных CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросы параметров входных данных CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробности см. в руководстве по началу работы в руководстве пользователя AWS CLI.

За исключением случаев, когда указано иное, все примеры используют правила цитирования, похожие на Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. раздел Использование кавычек со строками в руководстве пользователя AWS CLI .

Для отображения Resolver-точек входа в регионе AWS

Следующий list-resolver-endpoints пример отображает точки входа Resolver для входящих и исходящих соединений, которые существуют в текущей учетной записи.

aws route53resolver list-resolver-endpoints

Вывод:

{
    "MaxResults": 10,
    "ResolverEndpoints": [
        {
            "Id": "rslvr-in-497098ad59example",
            "CreatorRequestId": "2020-01-01-18:47",
            "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-endpoint/rslvr-in-497098ad59example",
            "Name": "my-inbound-endpoint",
            "SecurityGroupIds": [
                "sg-05cd7b25d6example"
            ],
            "Direction": "INBOUND",
            "IpAddressCount": 2,
            "HostVPCId": "vpc-304bexam",
            "Status": "OPERATIONAL",
            "StatusMessage": "This Resolver Endpoint is operational.",
            "CreationTime": "2020-01-01T23:25:45.538Z",
            "ModificationTime": "2020-01-01T23:25:45.538Z"
        },
        {
            "Id": "rslvr-out-d5e5920e37example",
            "CreatorRequestId": "2020-01-01-18:48",
            "Arn": "arn:aws:route53resolver:us-west-2:111122223333:resolver-endpoint/rslvr-out-d5e5920e37example",
            "Name": "my-outbound-endpoint",
            "SecurityGroupIds": [
                "sg-05cd7b25d6example"
            ],
            "Direction": "OUTBOUND",
            "IpAddressCount": 2,
            "HostVPCId": "vpc-304bexam",
            "Status": "OPERATIONAL",
            "StatusMessage": "This Resolver Endpoint is operational.",
            "CreationTime": "2020-01-01T23:50:50.979Z",
            "ModificationTime": "2020-01-01T23:50:50.979Z"
        }
    ]
}

Вывод

NextToken -> (строка)

Если совпадений IP-адресов, соответствующих указанным критериям, больше, чем MaxResults, вы можете отправить еще один запрос ListResolverEndpoint, чтобы получить следующую группу результатов. В следующем запросе укажите значение NextToken из предыдущего ответа.

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

Указанное вами значение для MaxResults в запросе.

ResolverEndpoints -> (список)

Точки входа Resolver, созданные с использованием текущей учетной записи Amazon Web Services и соответствующие указанным фильтрам (если таковые имеются).

(структура)

В ответе на запрос CreateResolverEndpoint , DeleteResolverEndpoint , GetResolverEndpoint , UpdateResolverEndpoint или UpdateResolverEndpoint , сложная структура, содержащая параметры для существующей точки входа Resolver (входящей или исходящей).

Id -> (строка)

Идентификатор точки входа Resolver.

CreatorRequestId -> (строка)

Уникальная строка, которая идентифицирует запрос, создавший точку входа Resolver. Это CreatorRequestId позволяет повторно выполнять не удавшиеся запросы без риска выполнения операции дважды.

Arn -> (строка)

ARN (Amazon Resource Name) для точки входа Resolver.

Name -> (строка)

Имя, заданное для точки входа Resolver при отправке запроса CreateResolverEndpoint.

SecurityGroupIds -> (список)

Идентификатор одного или нескольких наборов правил безопасности, которые контролируют доступ к этой VPC. Набор правил безопасности должен содержать одно или несколько правил входящего трафика (для входящих точек входа) или исходящего трафика (для исходящих точек входа). Правила входящего и исходящего трафика должны разрешать доступ по TCP и UDP. Для входящего трафика откройте порт 53. Для исходящего трафика откройте порт, который вы используете для DNS-запросов в вашей сети.

(строка)

Direction -> (строка)

Указывает, разрешает ли точка входа Resolver входящие или исходящие DNS-запросы:

  • INBOUND : разрешает DNS-запросы в вашу VPC из вашей сети
  • OUTBOUND : разрешает DNS-запросы из вашей VPC в вашу сеть

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

Количество IP-адресов, которые может использовать точка входа Resolver для DNS-запросов.

HostVPCId -> (строка)

Идентификатор VPC, в котором вы хотите создать точку входа Resolver.

Status -> (строка)

Код, определяющий текущий статус точки входа Resolver. Допустимые значения включают следующее:

  • CREATING : Resolver создает и настраивает один или несколько сетевых интерфейсов Amazon VPC для этой точки входа.
  • OPERATIONAL : Сетевые интерфейсы Amazon VPC для этой точки входа правильно настроены и позволяют передавать входящие или исходящие DNS-запросы между вашей сетью и Resolver.
  • UPDATING : Resolver связывает или отсоединяет один или несколько сетевых интерфейсов с этой точкой входа.
  • AUTO_RECOVERING : Resolver пытается восстановить один или несколько сетевых интерфейсов, связанных с этой точкой входа. Во время процесса восстановления точка входа функционирует с ограниченными возможностями из-за ограничения на количество DNS-запросов на IP-адрес (на сетевой интерфейс). Для текущего ограничения см. Пределы маршрутизатора Route 53 Resolver.
  • ACTION_NEEDED : Эта точка входа неисправна, и Resolver не может автоматически восстановить ее. Для устранения проблемы рекомендуется проверить каждый IP-адрес, который вы связали с точкой входа. Для каждого недоступного IP-адреса добавьте другой IP-адрес, а затем удалите недоступный IP-адрес. (Точка входа должна всегда содержать не менее двух IP-адресов.) Статус ACTION_NEEDED может иметь различные причины. Вот две распространенные причины:
    • Один или несколько сетевых интерфейсов, связанных с точкой входа, были удалены с использованием Amazon VPC.
    • Сетевой интерфейс не удалось создать по какой-либо причине, которая не зависит от Resolver.
  • DELETING : Resolver удаляет эту точку входа и связанные с ней сетевые интерфейсы.

StatusMessage -> (строка)

Подробное описание состояния точки входа Resolver.

CreationTime -> (строка)

Дата и время создания точки входа в формате Unix и по координированному всемирному времени (UTC).

ModificationTime -> (строка)

Дата и время последнего изменения точки входа в формате Unix и по координированному всемирному времени (UTC).

OutpostArn -> (строка)

ARN (Amazon Resource Name) для Outpost.

PreferredInstanceType -> (строка)

Тип экземпляра Amazon EC2.

ResolverEndpointType -> (строка)

Тип IP-адреса точки входа Resolver.

Protocols -> (список)

Протоколы, используемые для точки входа. DoH-FIPS применимо только для входящих точек входа.

Для входящей точки входа вы можете применить протоколы следующим образом:

  • Do53 и DoH в сочетании.
  • Do53 и DoH-FIPS в сочетании.
  • Только Do53.
  • Только DoH.
  • Только DoH-FIPS.
  • Ничего, что обрабатывается как Do53.

Для исходящей точки входа вы можете применить протоколы следующим образом:

  • Do53 и DoH в сочетании.
  • Только Do53.
  • Только DoH.
  • Ничего, что обрабатывается как Do53.

(строка)

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

Spec-Zone.ru

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