Эта страница переведена с помощью Cloud Translation API.

Ссылка

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

Интерфейс командной строки (CLI) apigee-remote-service-cli помогает вам предоставлять адаптер Apigee для Envoy и управлять им.

Команда получения списка привязок

Перечислите все продукты API, привязанные к удаленной службе.

Использование

apigee-remote-service-cli bindings list [flags]

Параметры

Параметры	Присутствие	Используется с продуктами	Описание
`-c, ‑‑config`	Необходимый	Все	(Строка) Путь к файлу конфигурации Apigee Remote Service. Совет : этот флаг позволяет вам опустить большинство других параметров команды, поскольку CLI может получить их непосредственно из файла конфигурации. См. Использование параметра `‑‑config` .
`-e, ‑‑environment`	Необходимый	Все	(Строка) Среда в вашей организации.
`-h, ‑‑help`	Необязательный	Все	Отображает справку по параметрам команды.
`‑‑insecure`	Необязательный	Все	Разрешить небезопасные подключения к серверу при использовании SSL.
`‑‑legacy`	Необходимый	Только Edge Public Cloud	Вы должны установить этот флаг, если используете Apigee Edge для публичного облака. Устанавливает URL-адреса управления и среды выполнения для Apigee Edge для публичного облака.
`-m, ‑‑management`	Необходимый	Только Edge Private Cloud	(Строка) Базовый URL-адрес управления для установки Apigee Edge для частного облака. По умолчанию: `https://api.enterprise.apigee.com`
`‑‑mfa`	Необходимый	Только Edge Public Cloud	(Строка) Токен многофакторной авторизации для вашего Apigee Edge для публичного облака. Требуется только в том случае, если в вашей учетной записи Apigee Edge настроен MFA.
`‑‑opdk`	Необходимый	Только Edge Private Cloud	Вы должны установить этот флаг, если используете Apigee Edge для частного облака.
`-o, ‑‑organization`	Необходимый	Все	(Строка) Организация Apigee. Вы должны быть администратором организации.
`-p, ‑‑password`	Необходимый (Только базовая аутентификация)	Только Edge Public и Private Cloud	(Строка) Ваш пароль Apigee. При желании вы можете указать пароль в файле `.netrc` . См. также Использование .netrc для учетных данных .
`-r, ‑‑runtime`	Необходимый	Только Edge Private Cloud и гибрид Apigee	(Строка) Указывает URL-адрес среды выполнения для вашего частного облака или гибридного экземпляра Apigee. URL-адрес должен начинаться с `https://` . Например: `https://apitest.apigee-hybrid-docs.net` .
`‑‑tls‑cert ‑‑tls‑key ‑‑tls‑ca`	Необязательный	Только Edge Private Cloud	(Строка) Указывает сертификат TLS на стороне клиента, закрытый ключ и корневой центр сертификации для подключения mTLS.
`-t, ‑‑token`	Необходимый (Только аутентификация по токену OAuth)	Все	(Строка) Токен OAuth или SAML, который вы создаете на основе информации своей учетной записи Apigee. Переопределяет любые другие предоставленные учетные данные.
`-u, ‑‑username`	Необходимый (Только базовая аутентификация)	Только Edge Public и Private Cloud	(Строка) Ваше имя пользователя Apigee (обычно адрес электронной почты). При желании вы можете указать имя пользователя в файле `.netrc` . Если вы это сделаете, вам не потребуется указывать свое имя пользователя в командной строке. См. также Использование .netrc для учетных данных .
`-v, ‑‑verbose`	Необязательный	Все	(Необязательно) Выводит подробный вывод.

Пример

apigee-remote-service-cli bindings list -o myorg -e test -u user@example.com \
-c config.yaml -p abc123

Пример вывода

PI Products
============
Bound
-----
envoy-test:
  Quota: 5 requests every 1 minute
  Target bindings:
    httpbin.org
  Paths:
httpbin:
  Quota: 5 requests every 1 minute
  Target bindings:
    httpbin.org
  Paths:
    /httpbin
    /

Unbound
-------
product-1:
  Quota: 100 requests every 1 hour
product-2:
  Quota: 1000 requests every 1 month
product-3:
product-4:

Команда помощи

Для всех команд apigee-remote-service-cli предоставляется онлайн-справка. Просто введите:

apigee-remote-service-cli help

Для получения справки по любой команде введите:

apigee-remote-service-cli [command] help

Например:

apigee-remote-service-cli provision help

Команда предоставления

Команда apigee-remote-service-cli provision устанавливает два прокси-сервера API в вашей организации Apigee Edge, настраивает сертификат и генерирует учетные данные, которые вам понадобятся для настройки адаптера Apigee для Envoy.

Использование

apigee-remote-service-cli provision [flags]

Параметры

Параметры	Присутствие	Используется с продуктами	Описание
`‑‑analytics-sa`	Необязательный	Гибрид Apigee и только Apigee X	(Строка) Используйте этот флаг, чтобы указать путь к файлу ключей учетной записи службы Google Cloud, где учетная запись службы имеет роль `Apigee Analytics Agent` . SA используется адаптером для прямой загрузки аналитических данных в Apigee. Если вы используете гибрид Apigee, этот вариант позволяет вам установить гибридную среду выполнения в один кластер, а адаптер — в другой кластер. Примечание. Мы рекомендуем обновить установку, чтобы использовать прямую загрузку аналитики. Непрямой метод загрузки аналитики, использовавший Fluentd, устарел.
`-c, ‑‑config`	Необходимый	Все	(Строка) Путь к файлу конфигурации Apigee Remote Service. Совет : этот флаг позволяет вам опустить большинство других параметров команды, поскольку CLI может получить их непосредственно из файла конфигурации. См. Использование параметра `‑‑config` .
`-e, ‑‑environment`	Необходимый	Все	(Строка) Среда в вашей организации.
`-f, ‑‑force-proxy-install`	Необязательный	Все	(Необязательно) Принудительно переустанавливает прокси `remote-service` , если он уже установлен в вашей организации. ПРИМЕЧАНИЕ ПО ОБНОВЛЕНИЮ: Если вы обновляетесь до версии 1.1.0 или более поздней, вы должны включить флаг `--force-proxy-install` чтобы заменить существующий прокси-сервер удаленной службы, развернутый в Apigee.
`-h, ‑‑help`	Необязательный	Все	Отображает справку по параметрам команды.
`‑‑insecure`	Необязательный	Все	Разрешить небезопасные подключения к серверу при использовании SSL.
`‑‑legacy`	Необходимый	Только Edge Public Cloud	Вы должны установить этот флаг, если используете Apigee Edge для публичного облака. Устанавливает URL-адреса управления и среды выполнения для Apigee Edge для публичного облака.
`-m, ‑‑management`	Необходимый	Только Edge Private Cloud	(Строка) Базовый URL-адрес управления для установки Apigee Edge для частного облака. По умолчанию: `https://api.enterprise.apigee.com`
`‑‑mfa`	Необходимый	Только Edge Public Cloud	Токен многофакторной авторизации для вашего Apigee Edge для публичного облака. Требуется только в том случае, если в вашей учетной записи Apigee Edge настроен MFA.
`-n, ‑‑namespace`	Необязательный	Все	(Строка) Выдать конфигурацию как Envoy ConfigMap в указанном пространстве имен. По умолчанию: `apigee`
`‑‑opdk`	Необходимый	Только Edge Private Cloud	Вы должны установить этот флаг, если используете Apigee Edge для частного облака.
`-o, ‑‑organization`	Необходимый	Все	(Строка) Организация Apigee. Для подготовки вы должны быть администратором организации.
`-p, ‑‑password`	Необходимый (Только базовая аутентификация)	Только Edge Public и Private Cloud	(Строка) Ваш пароль Apigee. При желании вы можете указать пароль в `.netrc` -файл. Если вы это сделаете, вам не потребуется вводить пароль в командной строке. См. также Использование .netrc для учетных данных .
`‑‑rotate-int`	Необязательный	Только гибрид Apigee	(Целое число) Если n > 0, сгенерировать новый закрытый ключ и сохранить n открытых ключей (только гибридный вариант)
`-r, ‑‑runtime`	Необходимый	Только Edge Private Cloud и гибрид Apigee	(Строка) Указывает URL-адрес среды выполнения для вашего частного облака или гибридного экземпляра Apigee. URL-адрес должен начинаться с `https://` . Например: `https://apitest.apigee-hybrid-docs.net` .
`‑‑tls‑cert ‑‑tls‑key ‑‑tls‑ca`	Необязательный	Только Edge Private Cloud	(Строка) Указывает сертификат TLS на стороне клиента, закрытый ключ и корневой центр сертификации для подключения mTLS.
`-t, ‑‑token`	Необходимый (Только аутентификация по токену OAuth)	Все	(Строка) Токен OAuth или SAML, который вы создаете на основе информации своей учетной записи Apigee. Переопределяет любые другие предоставленные учетные данные.
`-u, ‑‑username`	Необходимый (Только базовая аутентификация)	Только Edge Public и Private Cloud	(Строка) Ваше имя пользователя Apigee (обычно адрес электронной почты). При желании вы можете указать имя пользователя в файле `.netrc` . См. также Использование .netrc для учетных данных .
`-v, ‑‑verbose`	Необязательный	Все	(Необязательно) Выводит подробный вывод.
`‑‑virtual-hosts`	Необязательный	Только Edge Private Cloud	(Строка) Переопределяет виртуальные хосты по умолчанию, которые являются `default,secure` . Используйте этот параметр, если для вашей организации Edge указаны виртуальные хосты, отличные от этих значений по умолчанию.

Пример

Как показано в следующем примере, важно записать выходные данные команды provision в файл, который будет использоваться в качестве входных данных для других операций Apigee Adaptor for Envoy.

Пример:

apigee-remote-service-cli provision --legacy --mfa $MFA --username $USER --password $PASSWORD \
--organization $ORG --environment $ENV > config.yaml

Команда «Образцы»

Создает и выводит примеры файлов конфигурации.

Создайте образцы файлов конфигурации

Создает примеры файлов конфигурации для собственных развертываний Envoy и Istio.

Использование

apigee-remote-service-cli samples create [flags]

Описание

Для этой команды в качестве входных данных требуется действительный файл config.yaml . Этот входной файл — это файл, созданный в ходе подготовки. По умолчанию файлы примеров выводятся в каталог с именем ./samples . Команда создает для вас этот каталог.

Если вы используете собственный Envoy, команда принимает целевой хост службы и желаемое имя для его кластера. Он также устанавливает пользовательское SSL-соединение от прокси-сервера Envoy к кластеру удаленных служб, если папка, содержащая tls.key и tls.crt , предоставляется через --tls .

Если вы используете Istio, где прокси-сервер Envoy действует как вспомогательный сервер, и если цель не указана, будет создан пример httpbin . В противном случае вы несете ответственность за подготовку файлов конфигурации, связанных с развертыванием целевых служб.

Параметры

Параметры	Присутствие	Используется с продуктами	Описание
`‑‑adapter‑host`	Требуется только для шаблонов Envoy.	Все	(Строка) Имя хоста адаптера (по умолчанию: `localhost` ).
`-c, ‑‑config`	Необходимый	Все	(Строка) Путь к файлу конфигурации Apigee Remote Service. Совет : этот флаг позволяет вам опустить большинство других параметров команды, поскольку CLI может получить их непосредственно из файла конфигурации. См. Использование параметра `‑‑config` .
`-f, ‑‑force`	Необязательный	Все	Принудительно перезаписать существующий каталог.
`-h, ‑‑help`	Необязательный	Все	Отображает справку по параметрам команды.
`‑‑host`	Требуется только для шаблонов Envoy.	Все	(Строка) Целевой хост службы (по умолчанию `httpbin.org` ).
`-n, ‑‑name`	Необходимый	Все	(Строка) Имя целевой службы (по умолчанию `httpbin.org` ).
`‑‑out`	Необязательный	Все	(Строка) Каталог, в котором необходимо создать примеры файлов конфигурации. По умолчанию: `./samples`
`‑‑tag`	Требуется только для шаблонов Istio.	Все	(Строка) Тег версии образа адаптера Envoy. По умолчанию: `v2.0.0`
`-t, ‑‑template`	Необходимый	Все	(Строка) Имя шаблона Envoy или Istio. Чтобы просмотреть доступный список шаблонов, выполните команду `apigee-remote-service samples templates` .
`‑‑tls`	Необязательно, только для шаблонов Envoy.	Все	(Строка) Каталог, содержащий файлы `tls.key` и `tls.crt` , используемые для службы адаптера.

Пример

apigee-remote-service-cli samples create -c ./config.yaml

Список доступных вариантов шаблона

Перечисляет шаблоны, доступные для использования с параметром --templates для команды samples .

Использование

apigee-remote-service-cli samples templates

Параметры

Никто.

Пример

apigee-remote-service-cli samples templates

Supported templates (native is deprecated):
  envoy-1.15
  envoy-1.16
  envoy-1.17
  istio-1.7
  istio-1.8
  istio-1.9

Команды токена

Вы можете использовать токен JWT для выполнения аутентифицированных вызовов прокси-сервера API вместо использования ключа API. Для этой цели команды токена позволяют создавать, проверять и вращать токены JWT.

Создайте токен JWT

Вы можете использовать токен JWT для выполнения аутентифицированных вызовов прокси-сервера API к удаленной цели службы. См. также Использование аутентификации на основе JWT .

Использование

apigee-remote-service-cli token create [flags]

Параметры

Параметры	Присутствие	Используется с продуктами	Описание
`-c, ‑‑config`	Необходимый	Все	(Строка) Путь к файлу конфигурации Apigee Remote Service. Совет : этот флаг позволяет вам опустить большинство других параметров команды, поскольку CLI может получить их непосредственно из файла конфигурации. См. Использование параметра `‑‑config` .
`-e, ‑‑environment`	Необходимый	Все	(Строка) Среда в вашей организации.
`-h, ‑‑help`	Необязательный	Все	Отображает справку по параметрам команды.
`--i, --id`	Необходимый	Все	(Строка) Учетные данные ключа , найденные в приложении разработчика Apigee, как описано в разделе «Как получить ключ API» .
`‑‑insecure`	Необязательный	Все	Разрешить небезопасные подключения к серверу при использовании SSL.
`‑‑legacy`	Необходимый	Только Edge Public Cloud	Вы должны установить этот флаг, если используете Apigee Edge для публичного облака. Устанавливает URL-адреса управления и среды выполнения для Apigee Edge для публичного облака.
`‑‑opdk`	Необходимый	Только Edge Private Cloud	Вы должны установить этот флаг, если используете Apigee Edge для частного облака.
`-o, ‑‑organization`	Необходимый	Все	(Строка) Организация Apigee. Вы должны быть администратором организации.
`-r, ‑‑runtime`	Необходимый	Только Edge Private Cloud и гибрид Apigee	(Строка) Указывает URL-адрес среды выполнения для вашего частного облака или гибридного экземпляра Apigee. URL-адрес должен начинаться с `https://` . Например: `https://apitest.apigee-hybrid-docs.net` .
`--s, ‑‑secret`	Необходимый	Все	(Строка) Секретные учетные данные, найденные в приложении разработчика Apigee, как описано в разделе «Как получить ключ API» .
`‑‑tls‑cert ‑‑tls‑key ‑‑tls‑ca`	Необязательный	Только Edge Private Cloud	(Строка) Указывает сертификат TLS на стороне клиента, закрытый ключ и корневой центр сертификации для подключения mTLS.
`-v, ‑‑verbose`	Необязательный	Все	(Необязательно) Выводит подробный вывод.

Пример

apigee-remote-service-cli token create -o myorg -e test -i YUmlZAcBKNsTAelJqPZFl3sh58ObATX9 \
-s icTARgaKHqvUH1dq -c config.yaml

Выход

В случае успеха вы увидите вывод токена JST, аналогичный следующему:

eyJraWQiOiIxIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJhY2Nlc3NfdG9rZW4iOiJ0a2tlVzVKQTY2a0pZYTB4bFV1cVBsUW1BMU43IiwiYXVkIjoiaXN0aW8iLCJuYmYiOjE1MzAxMzg1OTEsImFwaV9wcm9kdWN0X2xpc3QiOlsiaXN0aW8tcHJvZHVjdCJdLCJhcHBsaWNhdGlvbl9uYW1lIjoiaXN0aW8tYXBwIiwiZGV2ZWxvcGVyX2VtYWlsIjoicFluZ2Zsb3lkQGdvb2dsZS5jb20iLCJpc3MiOiJodHRwczovL2FwaWdlZXNlYXJjaC10ZXN0LmFwaWdlZS5uZXQvaXN0aW8tYXV0aC90b2tlbiIsImV4cCI6MTUzMDEzOTQ5MSwiaWF0IjoxNTMwMTM4NTkxLCJqdGkiOiIxODgzMzViZi0wMmE4LTRjZGUsOGFkOS0yMWJmNDZjNmRjZDkiLCJjbGllbnRfaWQiOiJZVW1sWkFjQktOc1RBZWxKcVBZRmwzc2g1OE9iQVRYOSJ9.AL7pKSTmond-NSPRNNHVbIzTdAnZjOXcjQ-BbOJ_8lsQvF7PuiOUrGIhY5XTcJusisKgbCdtIxBl8Wq1EiQ_fKnUc3JYYOqzpTB5bGoFy0Yqbfu96dneuWyzgZnoQBkqwZkbQTIg7WNTGx1TJX-UTePvBPxAefiAbaEUcigX9tTsXPoRJZOTrm7IOeKpxpB_gQYkxQtV1_NbERxjTPyMbHdMWal9_xRVzSt7mpTGudMN9OR-VtQ1uXA67GOqhZWcOzq57qImOiCMbaoKnKUADevyWjX_VscN5ZZUtzQUQhTrmv8aR69-uVhMIPKp9juMyYKaYn2IsYZEeCWfhfV45Q

Проверка токена JWT

Вы можете проверить токен JWT с помощью этой команды. См. также Проверка токена .

Использование

apigee-remote-service-cli token inspect [flags]

Параметры

Параметры	Присутствие	Используется с продуктами	Описание
`-c, ‑‑config`	Необходимый	Все	(Строка) Путь к файлу конфигурации Apigee Remote Service. Совет : этот флаг позволяет вам опустить большинство других параметров команды, поскольку CLI может получить их непосредственно из файла конфигурации. См. Использование параметра `‑‑config` .
`-e, ‑‑environment`	Необходимый	Все	(Строка) Среда в вашей организации.
`-f, ‑‑file`	Необходимый	Все	(Строка) Файл токена (по умолчанию: используйте `stdin` )
`-h, ‑‑help`	Необязательный	Все	Отображает справку по параметрам команды.
`‑‑insecure`	Необязательный	Все	Разрешить небезопасные подключения к серверу при использовании SSL.
`‑‑legacy`	Необходимый	Только Edge Public Cloud	Вы должны установить этот флаг, если используете Apigee Edge для публичного облака. Устанавливает URL-адреса управления и среды выполнения для Apigee Edge для публичного облака.
`‑‑opdk`	Необходимый	Только Edge Private Cloud	Вы должны установить этот флаг, если используете Apigee Edge для частного облака.
`-o, ‑‑organization`	Необходимый	Все	(Строка) Организация Apigee. Вы должны быть администратором организации.
`-r, ‑‑runtime`	Необходимый	Только Edge Private Cloud и гибрид Apigee	(Строка) Указывает URL-адрес среды выполнения для вашего частного облака или гибридного экземпляра Apigee. URL-адрес должен начинаться с `https://` . Например: `https://apitest.apigee-hybrid-docs.net` .
`‑‑tls‑cert ‑‑tls‑key ‑‑tls‑ca`	Необязательный	Только Edge Private Cloud	(Строка) Указывает сертификат TLS на стороне клиента, закрытый ключ и корневой центр сертификации для подключения mTLS.
`-v, ‑‑verbose`	Необязательный	Все	(Необязательно) Выводит подробный вывод.

Пример

apigee-remote-service-cli token inspect -c config.yaml <<< $TOKEN

Выход

В случае успеха вы увидите вывод, аналогичный следующему:

{
	"aud": [
		"remote-service-client"
	],
	"exp": 1591741549,
	"iat": 1591740649,
	"iss": "https://apigee-docs-test.apigee.net/remote-service/token",
	"jti": "99325d2e-6440-4278-9f7f-b252a1a79e53",
	"nbf": 1591740649,
	"access_token": "VfzpXzBGAQ07po0bPMKY4JgQjus",
	"api_product_list": [
		"httpbin"
	],
	"application_name": "httpbin",
	"client_id": "GYDGHy5TRpV8AejXCOlreP7dPVepA8H",
	"developer_email": "user@example.com",
	"scope": ""
}
verifying...
token ok.

Ротация токена JWT

Через некоторое время после первоначального создания JWT вам может потребоваться изменить пару открытого и закрытого ключей, хранящуюся Apigee в его зашифрованной карте ключ-значение (KVM). Этот процесс создания новой пары ключей называется ротацией ключей. При ротации ключей создается новая пара частного/открытого ключей, которая сохраняется в KVM «istio» в вашей организации/среде Apigee. Кроме того, старый открытый ключ сохраняется вместе с исходным значением идентификатора ключа.

Использование

apigee-remote-service-cli token rotate-cert [flags]

Параметры

Параметры	Присутствие	Используется с продуктами	Описание
`-c, ‑‑config`	Необходимый	Все	(Строка) Путь к файлу конфигурации Apigee Remote Service. Совет : этот флаг позволяет вам опустить большинство других параметров команды, поскольку CLI может получить их непосредственно из файла конфигурации. См. Использование параметра `‑‑config` .
`-e, ‑‑environment`	Необходимый	Все	(Строка) Среда в вашей организации.
`-h, ‑‑help`	Необязательный	Только Edge Public и Private Cloud	Отображает справку по параметрам команды.
`--k, --key`	Необходимый	Только Edge Public и Private Cloud	(Строка) Ключ предоставления.
`‑‑insecure`	Необязательный	Только Edge Public и Private Cloud	Разрешить небезопасные подключения к серверу при использовании SSL.
`‑‑legacy`	Необходимый	Только Edge Public Cloud	Вы должны установить этот флаг, если используете Apigee Edge для публичного облака. Устанавливает URL-адреса управления и среды выполнения для Apigee Edge для публичного облака.
`‑‑opdk`	Необходимый	Только Edge Private Cloud	Вы должны установить этот флаг, если используете Apigee Edge для частного облака.
`-o, ‑‑organization`	Необходимый	Только Edge Public и Private Cloud	(Строка) Организация Apigee. Вы должны быть администратором организации.
`-r, ‑‑runtime`	Необходимый	Только Edge Private Cloud	(Строка) Указывает URL-адрес среды выполнения для вашего частного облака или гибридного экземпляра Apigee. URL-адрес должен начинаться с `https://` . Например: `https://apitest.apigee-hybrid-docs.net` .
`--s, ‑‑secret`	Необходимый	Все	(Строка) Секрет положения.
`‑‑tls‑cert ‑‑tls‑key ‑‑tls‑ca`	Необязательный	Только Edge Private Cloud	(Строка) Указывает сертификат TLS на стороне клиента, закрытый ключ и корневой центр сертификации для подключения mTLS.
`--t, ‑‑truncate`	Необходимый	Все	(Целое число) Количество сертификатов, которые будут храниться в JWKS (по умолчанию 2).
`-v, ‑‑verbose`	Необязательный	Все	(Необязательно) Выводит подробный вывод.

Пример

apigee-remote-service-cli token rotate-cert -c config.yaml -o myorg -e test \
-k 2e238ffa15dc5ab6a1e97868e7581f6c60ddb8575478582c256d8b7e5b2677a8 \
-s 51058077223fa7b683c3bea845c5cca138340d1d5583922b6d465f9f918a4b08

Выход

certificate successfully rotated

Создать внутренний токен

Создайте токен JWT для авторизации вызовов API удаленного обслуживания.

Использование

apigee-remote-service-cli token internal [flags]

Параметры

Параметры	Присутствие	Используется с продуктами	Описание
`-c, ‑‑config`	Необходимый	Только гибрид Apigee	(Строка) Путь к файлу конфигурации Apigee Remote Service. Совет : этот флаг позволяет вам опустить большинство других параметров команды, поскольку CLI может получить их непосредственно из файла конфигурации. См. Использование параметра `‑‑config` .
`-d, ‑‑duration`	Необходимый	Только гибрид Apigee	(Строка) время действия внутреннего JWT с момента создания (по умолчанию: `10m0s` (10 минут)).
`-e, ‑‑environment`	Необходимый	Только гибрид Apigee	(Строка) Среда в вашей организации.
`-h, ‑‑help`	Необязательный	Только гибрид Apigee	Отображает справку по параметрам команды.
`‑‑insecure`	Необязательный	Только гибрид Apigee	Разрешить небезопасные подключения к серверу при использовании SSL.
`-o, ‑‑organization`	Необходимый	Только гибрид Apigee	(Строка) Организация Apigee. Вы должны быть администратором организации.
`-r, ‑‑runtime`	Необходимый	Только гибрид Apigee	(Строка) Указывает URL-адрес среды выполнения для вашего гибридного экземпляра Apigee. URL-адрес должен начинаться с `https://` . Например: `https://apitest.apigee-hybrid-docs.net` .
`-v, ‑‑verbose`	Необязательный	Только гибрид Apigee	(Необязательно) Выводит подробный вывод.

Команда версии

Распечатайте версию CLI.

apigee-remote-service-cli version

Использование .netrc для учетных данных

apigee-remote-service-cli автоматически выбирает username и password (при необходимости для базовой аутентификации) из файла .netrc в вашем домашнем каталоге, если вы находитесь в публичном облаке Edge и у вас есть запись для машины api.enterprise.apigee.com . Если вы находитесь в частном облаке Apigee, значение компьютера совпадает с вашим URL-адресом management (например: http://192.162.55.100 ). Например, в публичном облаке Edge:

machine api.enterprise.apigee.com
login jdoe@google.com
password abc123

Например, в Edge Private Cloud:

machine http://192.162.55.100
login jdoe@google.com
password abc123

Использование параметра команды `‑‑config`

Параметр ‑‑config указывает расположение файла конфигурации, созданного командой provision . Полезным преимуществом этой опции является то, что она позволяет пропустить большинство других параметров команды, которые CLI извлекает из файла конфигурации. Эти варианты включают в себя:

организация
среда
время выполнения
управление
ненадежный
пространство имен
наследие
опдк

Например, вы можете выполнить команду provision следующим образом:

apigee-remote-service-cli provision --config='old-config.yaml' > new-config.yaml

Конфигурационный файл

В этом разделе показан пример файла конфигурации со всеми доступными параметрами.

global:
  temp_dir: /tmp/apigee-istio
  keep_alive_max_connection_age: 10m
  api_address: :5000
  metrics_address: :5001
  tls:
    cert_file: tls.crt
    key_file: tls.key
tenant:
  internal_api: https://istioservices.apigee.net/edgemicro
  remote_service_api: https://org-test.apigee.net/remote-service
  org_name: org
  env_name: env
  key: mykey
  secret: mysecret
  client_timeout: 30s
  tls:
    ca_file: /opt/apigee/tls/ca.crt
    cert_file: /opt/apigee/tls/tls.crt
    key_file: /opt/apigee/tls/tls.key
    allow_unverified_ssl_cert: false
products:
  refresh_rate: 2m
analytics:
  legacy_endpoint: false
  file_limit: 1024
  send_channel_size: 10
  collection_interval: 10s
auth:
  api_key_claim: claim
  api_key_cache_duration: 30m
  api_key_header: x-api-key
  api_header: :authority
  allow_unauthorized: false
  jwt_provider_key: https://org-test.apigee.net/remote-token/token
  append_metadata_headers: true

Ссылка

Команда получения списка привязок

Использование

Параметры

Пример

Пример вывода

Команда помощи

Команда предоставления

Использование

Параметры

Пример

Команда «Образцы»

Создайте образцы файлов конфигурации

Использование

Описание

Параметры

Пример

Список доступных вариантов шаблона

Использование

Параметры

Пример

Команды токена

Создайте токен JWT

Использование

Параметры

Пример

Выход

Проверка токена JWT

Использование

Параметры

Параметры

Пример

Выход

Ротация токена JWT

Использование

Параметры

Пример

Выход

Создать внутренний токен

Использование

Параметры

Параметры

Команда версии

Использование .netrc для учетных данных

Использование параметра команды ‑‑config

Конфигурационный файл

Использование параметра команды `‑‑config`