Spec-Zone.ru › AWS CLI v2

[ aws . appmesh ]

создать-сетку

Описание

Создаёт сетевую службу.

Сетевая служба — это логическая граница для сетевого трафика между службами, которые представлены ресурсами в пределах сети. После создания сетевой службы вы можете создать виртуальные службы, виртуальные узлы, виртуальные маршрутизаторы и маршруты для распределения трафика между приложениями в вашей сети.

Для получения дополнительной информации о сетевых службах см. Сетевые службы.

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

Синтаксис

  create-mesh
[--client-token <value>]
--mesh-name <value>
[--spec <value>]
[--tags <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]

Параметры

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

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете для обеспечения идемпотентности запроса. Разрешено до 36 букв, цифр, дефисов и подчеркиваний.

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

Имя для сетевой службы.

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

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

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

Правила фильтрации исходящего трафика для сетевой службы.

type -> (строка)

Тип фильтра исходящего трафика. По умолчанию тип — DROP_ALL, который разрешает исходящий трафик только от виртуальных узлов к другим определённым ресурсам в сетевой службе (и любой трафик к *.amazonaws.com для вызовов API Amazon Web Services). Вы можете установить тип фильтра исходящего трафика на ALLOW_ALL для разрешения исходящего трафика к любому узлу внутри или вне сетевой службы.

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

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

ipPreference -> (строка)

Версия IP для управления трафиком внутри сети.

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

egressFilter={type=string},serviceDiscovery={ipPreference=string}

Синтаксис JSON:

{
  "egressFilter": {
    "type": "ALLOW_ALL"|"DROP_ALL"
  },
  "serviceDiscovery": {
    "ipPreference": "IPv6_PREFERRED"|"IPv4_PREFERRED"|"IPv4_ONLY"|"IPv6_ONLY"
  }
}

--tags (список)

Необязательные метаданные, которые вы можете применить к сетевой службе для помощи в категоризации и организации. Каждый тег состоит из ключа и необязательного значения, оба из которых вы определяете. Длина ключей тегов может составлять максимум 128 символов, а длина значений тегов — максимум 256 символов.

(структура)

Необязательные метаданные, которые вы применяете к ресурсу для помощи в категоризации и организации. Каждый тег состоит из ключа и необязательного значения, оба из которых вы определяете. Длина ключей тегов может составлять максимум 128 символов, а длина значений тегов — максимум 256 символов.

key -> (строка)

Одна часть пары "ключ-значение", которая образует тег. key — это общее обозначение, которое действует как категория для более конкретных значений тегов.

value -> (строка)

Необязательная часть пары "ключ-значение", которая образует тег. value служит описателем в категории тегов (ключ).

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

key=string,value=string ...

Синтаксис JSON:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--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 версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет рассматриваться как двоичный и будет использоваться непосредственно содержимое файла независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

Отключение отображения вывода с помощью постраничного просмотра CLI.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

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

Пример 1: Создание новой сетевой службы

Следующий create-mesh пример создаёт сетевую службу.

aws appmesh create-mesh \
    --mesh-name app1

Вывод:

{
    "mesh":{
        "meshName":"app1",
        "metadata":{
            "arn":"arn:aws:appmesh:us-east-1:123456789012:mesh/app1",
            "createdAt":1563809909.282,
            "lastUpdatedAt":1563809909.282,
            "uid":"a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "version":1
        },
        "spec":{},
        "status":{
            "status":"ACTIVE"
        }
    }
}

Пример 2: Создание новой сетевой службы с несколькими тегами

Следующий create-mesh пример создаёт сетевую службу с несколькими тегами.

aws appmesh create-mesh \
    --mesh-name app2 \
    --tags key=key1,value=value1 key=key2,value=value2 key=key3,value=value3

Вывод:

{
    "mesh":{
        "meshName":"app2",
        "metadata":{
            "arn":"arn:aws:appmesh:us-east-1:123456789012:mesh/app2",
            "createdAt":1563822121.877,
            "lastUpdatedAt":1563822121.877,
            "uid":"a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
            "version":1
        },
        "spec":{},
        "status":{
            "status":"ACTIVE"
        }
    }
}

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

Вывод

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

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

meshName -> (строка)

Имя сетевой службы.

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

Соответствующие метаданные для сетевой службы.

arn -> (строка)

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

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

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

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

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

meshOwner -> (строка)

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

resourceOwner -> (строка)

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

uid -> (строка)

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

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

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

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

Соответствующая спецификация для сетевой службы.

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

Правила фильтрации исходящего трафика для сетевой службы.

type -> (строка)

Тип фильтра исходящего трафика. По умолчанию тип — DROP_ALL, который разрешает исходящий трафик только от виртуальных узлов к другим определённым ресурсам в сетевой службе (и любой трафик к *.amazonaws.com для вызовов API Amazon Web Services). Вы можете установить тип фильтра исходящего трафика на ALLOW_ALL для разрешения исходящего трафика к любому узлу внутри или вне сетевой службы.

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

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

ipPreference -> (строка)

Версия IP для управления трафиком внутри сети.

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

Состояние сетевой службы.

status -> (строка)

Текущее состояние сети.

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

Spec-Zone.ru

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