ส่วนขยาย Google Cloud Pub/Sub

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X info

เวอร์ชัน: 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

เผยแพร่ข้อความ

ในตัวอย่างนี้ การดำเนินการ publish จะเผยแพร่ข้อความอย่างง่ายไปยังหัวข้อที่ระบุในการกำหนดค่าของส่วนขยาย configuration การดำเนินการ publish จะแสดงผลรหัสของข้อความที่เผยแพร่ในหัวข้อที่เผยแพร่

<?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>

นโยบาย Assign Message ต่อไปนี้ใช้ค่าของตัวแปรที่จัดเก็บการตอบกลับของส่วนขยายเพื่อกำหนดเพย์โหลดการตอบกลับ

<?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>

ในตัวอย่างนี้ ระบบจะแสดงผลข้อมูลการตอบกลับเป็น JSON เช่นข้อมูลต่อไปนี้

{"messageId":"165918654986954"}

การดำเนินการ

เผยแพร่

เผยแพร่ข้อความไปยังหัวข้อที่ระบุในการกำหนดค่าของส่วนขยายนี้ configuration

ไวยากรณ์

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

ตัวอย่าง

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

พารามิเตอร์คำขอ

พารามิเตอร์ คำอธิบาย ประเภท ค่าเริ่มต้น ต้องระบุ
ข้อความ ข้อความที่จะเผยแพร่ สตริง ไม่มี ได้

การตอบกลับ

JSON ที่มีรหัสของข้อความตามที่เผยแพร่ไปยังหัวข้อ เช่น

{"messageId":"165918654986954"}

ข้อมูลอ้างอิงการกำหนดค่า

ใช้ข้อมูลต่อไปนี้เมื่อกำหนดค่าและทำให้ส่วนขยายนี้ใช้งานได้ในพร็อกซี API

พร็อพเพอร์ตี้ส่วนขยายทั่วไป

พร็อพเพอร์ตี้ต่อไปนี้มีอยู่ในส่วนขยายทุกรายการ

พร็อพเพอร์ตี้ คำอธิบาย ค่าเริ่มต้น ต้องระบุ
name ชื่อที่คุณกําหนดให้การกําหนดค่านี้ของส่วนขยาย ไม่มี ได้
packageName ชื่อแพ็กเกจส่วนขยายที่ระบุโดย Apigee Edge ไม่มี ได้
version หมายเลขเวอร์ชันของแพ็กเกจส่วนขยายที่คุณกําหนดค่าส่วนขยาย ไม่มี ได้
configuration ค่าการกําหนดค่าเฉพาะสําหรับส่วนขยายที่คุณกําลังเพิ่ม ดูพร็อพเพอร์ตี้สําหรับแพ็กเกจส่วนขยายนี้ ไม่มี ได้

พร็อพเพอร์ตี้สำหรับแพ็กเกจส่วนขยายนี้

พร็อพเพอร์ตี้ คำอธิบาย ค่าเริ่มต้น ต้องระบุ
topic หัวข้อที่จะเผยแพร่ รับค่านี้จากบริการ Pub/Sub เช่น จากคอนโซล GCP สำหรับบริการ เช่น ชื่อหัวข้ออาจอยู่ในรูปแบบ projects/GCP-PROJECT-ID/topics/TOPIC-NAME ไม่มี ได้
credentials เมื่อป้อนในคอนโซล Apigee Edge ค่านี้จะเป็นเนื้อหาของไฟล์คีย์บัญชีบริการ เมื่อส่งผ่าน Management API ค่านี้จะเป็นค่าที่เข้ารหัสแบบ Base64 ซึ่งสร้างจากไฟล์คีย์บัญชีบริการ ไม่มี ได้