מוצג המסמך של Apigee Edge.
עוברים אל
מסמכי תיעוד של Apigee X. מידע
גרסה: 1.2.0
לפרסם הודעות בנושא בשירות Google Cloud Pub/Sub.
התוכן הזה כולל חומר עזר להגדרת התוסף הזה ולשימוש בו.
דרישות מוקדמות
לפני שמשתמשים בתוסף הזה משרת proxy ל-API, צריך:
יוצרים נושא ב-Cloud Pub/Sub כפי שמתואר במדריך למתחילים: שימוש במסוף.
אחרי שיוצרים את הנושא, מעניקים הרשאה לפרסם בנושא ב-Cloud Pub/Sub. לדוגמה, אפשר להשתמש בתפקיד
roles/pubsub.publisher
כדי לפרסם בנושאים. מידע נוסף על תפקידים ב-Cloud Pub/Sub זמין במאמר בקרת גישה.משתמשים בתוכן של קובץ ה-JSON של המפתח שנוצר כשמוסיפים ומגדירים את התוסף באמצעות קובץ התצורה.
מידע על Cloud Pub/Sub
Cloud Pub/Sub מספק הודעות אסינכרוניות מסוג 'רבים לרבים', שמפרידות בין השולחים למקבלי ההודעות. שירות Cloud Pub/Sub כולל העברת הודעות ארוכת טווח עם זמן אחזור קצר, שעוזר למפתחים לשלב במהירות מערכות שמתארחות ב-Google Cloud Platform ומחוץ לה.
אם רק התחלתם להשתמש ב-Cloud Pub/Sub, כדאי לעיין במדריכים למתחילים במאמרי העזרה של Cloud Pub/Sub.
דוגמאות
הדוגמאות הבאות ממחישות איך להגדיר תמיכה בפעולות של תוסף Cloud Pub/Sub באמצעות מדיניות תוספי יתרונות מרכזיים.
פרסום הודעה
בדוגמה הזו, הפעולה publish
מפרסמת הודעה פשוטה לנושא שצוין בהגדרות של התוסף. הפעולה 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>
במדיניות הבאה של הקצאת הודעה נעשה שימוש בערך של המשתנה שמאחסן את התשובה של התוסף כדי להקצות את המטען הייעודי (payload) של התגובה.
<?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"}
פעולות
פרסם
פרסום הודעה בנושא שצוין בהגדרות האישיות של התוסף הזה.
תחביר
<Action>publish</Action>
<Input><![CDATA[{
"message" : "message-to-publish"
}]]></Input>
דוגמה
<Action>publish</Action>
<Input><![CDATA[
{
"message" : "My test message."
}
]]></Input>
פרמטרים של בקשה
פרמטר | תיאור | סוג | ברירת מחדל | חובה |
---|---|---|---|---|
הודעה | ההודעה שצריך לפרסם. | מחרוזת | ללא. | כן. |
תשובה
קובץ JSON שמכיל את מזהה ההודעה כפי שפורסם בנושא. לדוגמה:
{"messageId":"165918654986954"}
חומר עזר בנושא הגדרות אישיות
כשאתם מגדירים ופורסים את התוסף הזה לשימוש בשרתי proxy ל-API, יש להשתמש באפשרויות הבאות.
מאפייני תוספים נפוצים
המאפיינים הבאים קיימים בכל תוסף.
נכס | תיאור | ברירת המחדל | נדרש |
---|---|---|---|
name |
השם שבחרת לתצורה הזו של התוסף. | ללא | כן |
packageName |
השם של חבילת התוסף כפי שהוא סופק על ידי Apigee Edge. | ללא | כן |
version |
מספר הגרסה של חבילת התוסף שממנה מגדירים את התוסף. | ללא | כן |
configuration |
ערך הגדרה ספציפי לתוסף שרוצים להוסיף. מאפיינים לחבילת תוספים זו | ללא | כן |
מאפיינים של חבילת התוספים הזו
נכס | תיאור | ברירת מחדל | חובה |
---|---|---|---|
topic |
הנושא שבו רוצים לפרסם. מקבלים את הערך הזה משירות Pub/Sub, למשל ממסוף GCP של השירות. לדוגמה, שם הנושא יכול להופיע בצורה הבאה: projects/GCP-PROJECT-ID/topics/TOPIC-NAME |
ללא. | כן. |
credentials |
כשמזינים את הפרטים האלה במסוף Apigee Edge, זה התוכן של קובץ המפתח של חשבון השירות שלכם. כשהמשלוח נשלח דרך ממשק ה-API לניהול, זה ערך בקידוד base64 שנוצר מקובץ המפתח של חשבון השירות. | ללא. | כן. |