Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

describe-verified-access-endpoints

Описание

Описывает указанные конечные точки Amazon Web Services Verified Access.

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

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

Синтаксис

  describe-verified-access-endpoints
[--verified-access-endpoint-ids <value>]
[--verified-access-instance-id <value>]
[--verified-access-group-id <value>]
[--filters <value>]
[--dry-run | --no-dry-run]
[--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]

Параметры

--verified-access-endpoint-ids (список)

Идентификатор конечной точки Verified Access.

(строка)

Синтаксис:

"string" "string" ...

--verified-access-instance-id (строка)

Идентификатор экземпляра Verified Access.

--verified-access-group-id (строка)

Идентификатор группы Verified Access.

--filters (список)

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

(структура)

Пара имя-значение фильтра, используемая для получения более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как теги, атрибуты или идентификаторы.

Если вы указываете несколько фильтров, фильтры объединяются с помощью AND, и запрос возвращает только результаты, соответствующие всем указанным фильтрам.

Для получения дополнительной информации см. Список и фильтрация с помощью командной строки и API в Руководстве пользователя Amazon EC2.

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

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

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

Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с помощью OR, и запрос возвращает все результаты, соответствующие любому из указанных значений.

(строка)

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

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

Синтаксис JSON:

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

--dry-run | --no-dry-run (логическое значение)

Проверяет, есть ли у вас необходимые разрешения для действия, не выполняя сам запрос, и предоставляет ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке — DryRunOperation. В противном случае — UnauthorizedOperation.

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передать произвольные двоичные значения с помощью предоставленного JSON-значения, так как строка будет интерпретирована буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Маркер для указания места начала постраничного вывода. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS CLI.

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

Описание конечной точки Verified Access

Следующий describe-verified-access-endpoints пример описывает указанную конечную точку Verified Access.

aws ec2 describe-verified-access-endpoints \
    --verified-access-endpoint-ids vae-066fac616d4d546f2

Вывод:

{
    "VerifiedAccessEndpoints": [
        {
            "VerifiedAccessInstanceId": "vai-0ce000c0b7643abea",
            "VerifiedAccessGroupId": "vagr-0dbe967baf14b7235",
            "VerifiedAccessEndpointId": "vae-066fac616d4d546f2",
            "ApplicationDomain": "example.com",
            "EndpointType": "network-interface",
            "AttachmentType": "vpc",
            "DomainCertificateArn": "arn:aws:acm:us-east-2:123456789012:certificate/eb065ea0-26f9-4e75-a6ce-0a1a7EXAMPLE",
            "EndpointDomain": "my-ava-app.edge-00c3372d53b1540bb.vai-0ce000c0b7643abea.prod.verified-access.us-east-2.amazonaws.com",
            "SecurityGroupIds": [
                "sg-004915970c4c8f13a"
            ],
            "NetworkInterfaceOptions": {
                "NetworkInterfaceId": "eni-0aec70418c8d87a0f",
                "Protocol": "https",
                "Port": 443
            },
            "Status": {
                "Code": "active"
            },
            "Description": "",
            "CreationTime": "2023-08-25T20:54:43",
            "LastUpdatedTime": "2023-08-25T22:17:26",
            "Tags": [
                {
                    "Key": "Name",
                    "Value": "my-va-endpoint"
                }
            ]
        }
    ]
}

Для получения дополнительной информации см. Конечные точки Verified Access в Руководстве пользователя AWS Verified Access.

Выходные данные

VerifiedAccessEndpoints -> (список)

Подробная информация о конечных точках Verified Access.

(структура)

Конечная точка Amazon Web Services Verified Access указывает приложение, к которому Amazon Web Services Verified Access предоставляет доступ. Она должна быть прикреплена к группе Amazon Web Services Verified Access. Конечная точка Amazon Web Services Verified Access также должна иметь прикреплённую политику доступа перед присоединением к группе.

VerifiedAccessInstanceId -> (строка)

Идентификатор экземпляра Amazon Web Services Verified Access.

VerifiedAccessGroupId -> (строка)

Идентификатор группы Amazon Web Services Verified Access.

VerifiedAccessEndpointId -> (строка)

Идентификатор конечной точки Amazon Web Services Verified Access.

ApplicationDomain -> (строка)

Имя домена DNS для доступа к вашему приложению.

EndpointType -> (строка)

Тип конечной точки Amazon Web Services Verified Access. Входящие запросы приложения будут отправлены на IP-адрес, балансировщик нагрузки или сетевой интерфейс в зависимости от указанного типа конечной точки.

AttachmentType -> (строка)

Тип подключения, используемого для обеспечения связи между конечной точкой Amazon Web Services Verified Access и приложением.

DomainCertificateArn -> (строка)

ARN общедоступного сертификата TLS/SSL, импортированного в ACM или созданного с помощью ACM.

EndpointDomain -> (строка)

Имя домена DNS, сгенерированное для конечной точки.

DeviceValidationDomain -> (строка)

Возвращается, если к конечной точке прикреплён поставщик доверия устройств.

SecurityGroupIds -> (список)

Идентификаторы групп безопасности для конечной точки.

(строка)

LoadBalancerOptions -> (структура)

Подробности о балансировщике нагрузки, если конечная точка Amazon Web Services Verified Access создаётся как load-balancer тип.

Protocol -> (строка)

Протокол IP.

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

Номер порта IP.

LoadBalancerArn -> (строка)

ARN балансировщика нагрузки.

SubnetIds -> (список)

Идентификаторы подсетей.

(строка)

PortRanges -> (список)

Диапазоны портов.

(структура)

Описание диапазона портов.

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

Начало диапазона портов.

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

Конец диапазона портов.

NetworkInterfaceOptions -> (структура)

Параметры для конечной точки типа сетевого интерфейса.

NetworkInterfaceId -> (строка)

Идентификатор сетевого интерфейса.

Protocol -> (строка)

Протокол IP.

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

Номер порта IP.

PortRanges -> (список)

Диапазоны портов.

(структура)

Описание диапазона портов.

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

Начало диапазона портов.

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

Конец диапазона портов.

Status -> (структура)

Статус конечной точки.

Code -> (строка)

Код состояния конечной точки Verified Access.

Message -> (строка)

Сообщение о состоянии конечной точки Verified Access.

Description -> (строка)

Описание конечной точки Amazon Web Services Verified Access.

CreationTime -> (строка)

Время создания.

LastUpdatedTime -> (строка)

Время последнего обновления.

DeletionTime -> (строка)

Время удаления.

Tags -> (список)

Теги.

(структура)

Описание тега.

Key -> (строка)

Ключ тега.

Ограничения: Ключи тегов регистрозависимы и принимают максимум 127 символов Юникода. Не может начинаться с aws: .

Value -> (строка)

Значение тега.

Ограничения: Значения тегов регистрозависимы и принимают максимум 256 символов Юникода.

SseSpecification -> (структура)

Параметры, используемые для шифрования на стороне сервера.

CustomerManagedKeyEnabled -> (булево)

Указывает, используются ли управляемые клиентом ключи KMS для шифрования на стороне сервера.

Допустимые значения: True | False

KmsKeyArn -> (строка)

ARN ключа KMS.

RdsOptions -> (структура)

Параметры для конечной точки RDS.

Protocol -> (строка)

Протокол.

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

Порт.

RdsDbInstanceArn -> (строка)

ARN экземпляра RDS.

RdsDbClusterArn -> (строка)

ARN кластера БД.

RdsDbProxyArn -> (строка)

ARN прокси-сервера RDS.

RdsEndpoint -> (строка)

Конечная точка RDS.

SubnetIds -> (список)

Идентификаторы подсетей.

(строка)

CidrOptions -> (структура)

Параметры для конечной точки CIDR.

Cidr -> (строка)

CIDR.

PortRanges -> (список)

Диапазоны портов.

(структура)

Описание диапазона портов.

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

Начало диапазона портов.

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

Конец диапазона портов.

Protocol -> (строка)

Протокол.

SubnetIds -> (список)

Идентификаторы подсетей.

(строка)

NextToken -> (строка)

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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