Расширение Google Cloud Pub/Sub

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

Версия: 1.2.0

Публикуйте сообщения в теме в сервисе Google Cloud Pub/Sub.

В этом содержимом содержится справочная информация по настройке и использованию этого расширения.

Предпосылки

Прежде чем использовать это расширение с API-прокси, вы должны:

1. Создайте тему Cloud Pub/Sub, как описано в разделе Краткое руководство: использование консоли .

2. Получив тему, дайте разрешение на публикацию в теме Cloud Pub/Sub. Например, вы можете использовать роль roles/pubsub.publisher для публикации в темах. Дополнительные сведения о ролях Cloud Pub/Sub см. в разделе Управление доступом .

3. Используйте консоль GCP для создания ключа для сервисного аккаунта .

4. Используйте содержимое полученного ключевого JSON-файла при добавлении и настройке расширения с помощью справочника по конфигурации .

О Cloud Pub/Sub

Cloud Pub/Sub обеспечивает асинхронный обмен сообщениями «многие ко многим», который разделяет отправителей и получателей. Cloud Pub/Sub обеспечивает надежный обмен сообщениями с малой задержкой, что помогает разработчикам быстро интегрировать системы, размещенные на Google Cloud Platform и за ее пределами.

Если вы только начинаете работать с Cloud Pub/Sub, ознакомьтесь с краткими руководствами в документации по Cloud Pub/Sub .

Образцы

В следующих примерах показано, как настроить поддержку расширений Cloud Pub/Sub с помощью политики ExtensionCallout .

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Publish-Message">
    <DisplayName>Publish Message</DisplayName>
    <Connector>cloud-pub-sub-extension-example</Connector>
    <Action>publish</Action>
    <Input><![CDATA[
      {
          "message" : "My test message."
      }
    ]]></Input>
    <Output>topic.message.id</Output>
</ConnectorCallout>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Get-Topic-Message-ID">
    <DisplayName>Get Topic Message ID</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{topic.message.id}</Payload>
    </Set>
</AssignMessage>

{"messageId":"165918654986954"}

Действия

публиковать

Публикует сообщение в тему, указанную в конфигурации этого расширения.

<Action>publish</Action>
<Input><![CDATA[{
  "message" : "message-to-publish"
}]]></Input>

<Action>publish</Action>
<Input><![CDATA[
  {
      "message" : "My test message."
  }
]]></Input>

Параметры запроса

Ответ

JSON, содержащий идентификатор сообщения, опубликованного в теме. Например:

{"messageId":"165918654986954"}

Справочник по конфигурации

Используйте следующее при настройке и развертывании этого расширения для использования в прокси-серверах API.

Общие свойства расширения

Следующие свойства присутствуют для каждого расширения.

Свойства этого пакета расширения