Spec-Zone.ru › AWS CLI v2

[ aws . appmesh ]

описание-виртуальной-службы

Описание

Описывает существующую виртуальную службу.

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

Синтаксис

  describe-virtual-service
--mesh-name <value>
[--mesh-owner <value>]
--virtual-service-name <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]

Параметры

--mesh-name (строка)

Имя сети сервисов, в которой находится виртуальная служба.

--mesh-owner (строка)

Идентификатор учетной записи IAM Amazon Web Services владельца сети сервисов. Если это не ваша учетная запись, это идентификатор учетной записи, которая поделилась сетью с вашей учетной записью. Дополнительную информацию о совместном использовании сетей см. в разделе Работа с совместными сетями.

--virtual-service-name (строка)

Имя виртуальной службы для описания.

--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
  • текст
  • таблица
  • 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 в руководстве пользователя AWS CLI.

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

Для описания виртуальной службы

Следующий describe-virtual-service пример возвращает подробности о заданной виртуальной службе.

aws appmesh describe-virtual-service \
    --mesh-name app1 \
    --virtual-service-name serviceB.svc.cluster.local

Вывод:

{
    "virtualService": {
        "meshName": "app1",
        "metadata": {
            "arn": "arn:aws:appmesh:us-east-1:123456789012:mesh/app1/virtualService/serviceB.svc.cluster.local",
            "createdAt": 1563908363.999,
            "lastUpdatedAt": 1563908363.999,
            "uid": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "version": 1
        },
        "spec": {
            "provider": {
                "virtualRouter": {
                    "virtualRouterName": "vrServiceB"
                }
            }
        },
        "status": {
            "status": "ACTIVE"
        },
        "virtualServiceName": "serviceB.svc.cluster.local"
    }
}

Дополнительную информацию см. в разделе Виртуальные службы в руководстве пользователя AWS App Mesh.

Вывод

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

Полное описание вашей виртуальной службы.

meshName -> (строка)

Имя сети сервисов, в которой находится виртуальная служба.

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

Объект, представляющий метаданные ресурса.

arn -> (строка)

Полный Amazon Resource Name (ARN) для ресурса.

createdAt -> (временная метка)

Временная метка Unix в секундах для времени создания ресурса.

lastUpdatedAt -> (временная метка)

Временная метка Unix в секундах для времени последнего обновления ресурса.

meshOwner -> (строка)

Идентификатор учетной записи IAM Amazon Web Services владельца сети сервисов. Если это не ваша учетная запись, это идентификатор учетной записи, которая поделилась сетью с вашей учетной записью. Дополнительную информацию о совместном использовании сетей см. в разделе Работа с совместными сетями.

resourceOwner -> (строка)

Идентификатор учетной записи IAM Amazon Web Services владельца ресурса. Если это не ваша учетная запись, это идентификатор владельца сети или другой учетной записи, с которой сеть совместно используется. Дополнительную информацию о совместном использовании сетей см. в разделе Работа с совместными сетями.

uid -> (строка)

Уникальный идентификатор ресурса.

version -> (длинное целое)

Версия ресурса. Ресурсы создаются с версией 1, и эта версия увеличивается каждый раз, когда они обновляются.

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

Спецификации виртуальной службы.

provider -> (структура помеченных объединений)

Объект App Mesh, действующий как провайдер для виртуальной службы. Вы можете указать один виртуальный узел или виртуальный маршрутизатор.

Примечание

Это структура помеченных объединений. Может быть задан только один из следующих верхних ключей: virtualNode, virtualRouter.

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

Виртуальный узел, связанный с виртуальной службой.

virtualNodeName -> (строка)

Имя виртуального узла, действующего как поставщик услуг.

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

Виртуальный маршрутизатор, связанный с виртуальной службой.

virtualRouterName -> (строка)

Имя виртуального маршрутизатора, действующего как поставщик услуг.

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

Текущий статус виртуальной службы.

status -> (строка)

Текущий статус виртуальной службы.

virtualServiceName -> (строка)

Имя виртуальной службы.

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

Spec-Zone.ru

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