Google Cloud Pub/Sub Extension

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات

نسخه: ۱.۲.۰

پیام‌ها را برای یک موضوع در سرویس 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 پیام‌رسانی با تأخیر کم و پایدار را ارائه می‌دهد که به توسعه‌دهندگان کمک می‌کند تا به سرعت سیستم‌های میزبانی شده در پلتفرم ابری گوگل و سیستم‌های خارجی را ادغام کنند.

اگر تازه کار با 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، از موارد زیر استفاده کنید.

ویژگی‌های افزونه‌های رایج

ویژگی های زیر برای هر افزونه وجود دارد.

ویژگی‌های این بسته الحاقی