Tiện ích Google Cloud Pub/Sub

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X. thông tin

Phiên bản: 1.2.0

Xuất bản thông báo tới một chủ đề trong dịch vụ Google Cloud Pub/Sub.

Nội dung này cung cấp tài liệu tham khảo để định cấu hình và sử dụng tiện ích này.

Điều kiện tiên quyết

Trước khi sử dụng tiện ích này từ proxy API, bạn phải:

1. Tạo một chủ đề trên Cloud Pub/Sub như mô tả trong phần Bắt đầu nhanh: Sử dụng bảng điều khiển.

2. Sau khi bạn có chủ đề, hãy cấp quyền để xuất bản lên chủ đề đó trên Cloud Pub/Sub. Ví dụ: bạn có thể dùng vai trò roles/pubsub.publisher để xuất bản lên chủ đề. Để biết thêm thông tin về các vai trò trên Cloud Pub/Sub, hãy xem bài viết Kiểm soát quyền truy cập.

3. Sử dụng Bảng điều khiển của GCP để tạo khoá cho tài khoản dịch vụ.

4. Sử dụng nội dung của tệp JSON của khoá thu được khi thêm và định cấu hình tiện ích bằng cách sử dụng tài liệu tham khảo về cấu hình.

Giới thiệu về Cloud Pub/Sub

Cloud Pub/Sub cung cấp cơ chế nhắn tin không đồng bộ nhiều với nhiều, giúp tách biệt người gửi và người nhận. Cloud Pub/Sub cung cấp dịch vụ nhắn tin bền vững, có độ trễ thấp, giúp nhà phát triển nhanh chóng tích hợp các hệ thống được lưu trữ trên Google Cloud Platform và bên ngoài.

Nếu bạn mới bắt đầu sử dụng Cloud Pub/Sub, hãy xem phần bắt đầu nhanh trong tài liệu về Cloud Pub/Sub.

Mẫu

Các ví dụ sau minh hoạ cách định cấu hình tính năng hỗ trợ các thao tác với tiện ích Cloud Pub/Sub bằng chính sách Tiện ích mở rộng.

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

Thao tác

xuất bản

Đăng một thông báo về chủ đề đã chỉ định trong cấu hình của tiện ích này.

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

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

Yêu cầu thông số

Phản hồi

JSON chứa mã nhận dạng của bài viết khi được xuất bản lên chủ đề. Ví dụ:

{"messageId":"165918654986954"}

Tham chiếu cấu hình

Sử dụng mã sau khi bạn định cấu hình và triển khai tiện ích này để sử dụng trong proxy API.

Các thuộc tính tiện ích phổ biến

Các thuộc tính sau có sẵn cho mỗi tiện ích.

Các thuộc tính của gói tiện ích này