با استفاده از ماژول apigee-access

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

ماژول apigee-access به شما امکان می دهد از داخل کد برنامه Node.js به متغیرهای جریان پروکسی API و حافظه پنهان دسترسی داشته باشید. این ماژول با پلت فرم Apigee Edge همراه است. شما نیازی به نصب آن مانند سایر ماژول های Node.js ندارید.

به دست آوردن apigee-access

ماژول apigee-access در پلتفرم Apigee Edge یکپارچه شده است. وقتی کد Node.js را در Edge مستقر می کنید، این ماژول در دسترس شما است. شما به سادگی باید آن را در هر کد Node.js که استقرار می دهید، درخواست کنید. به عنوان مثال:

var access=require('apigee-access');

دسترسی به متغیرهای جریان

هنگامی که یک برنامه Node.js را در Edge مستقر می کنید، می توانید به هر یک از متغیرهای جریان پشتیبانی شده، متغیرهای جریان ایجاد شده توسط سیاست ها و هر متغیر جریانی که خودتان از Node.js خود ایجاد می کنید دسترسی داشته باشید. کد متغیرهای جریان در متن یک پروکسی API در حال اجرا در Edge ایجاد شده و وجود دارند. برای اطلاعات دقیق، دسترسی به متغیرهای جریان در Node.js را ببینید.

دسترسی به حافظه پنهان

ماژول apigee-access به شما امکان می دهد از کد Node.js خود به کش توزیع شده Apigee Edge دسترسی داشته باشید. برای اطلاعات دقیق، به دسترسی به حافظه پنهان در Node.js مراجعه کنید.

با استفاده از سرویس سهمیه

ماژول apigee-access به شما امکان می دهد از کد Node.js خود به سرویس سهمیه Apigee Edge دسترسی داشته باشید. برای اطلاعات دقیق، به دسترسی به سرویس سهمیه در Node.js مراجعه کنید.

دسترسی به نقشه‌های ارزش کلیدی

ماژول apigee-access به شما امکان می دهد از کد Node.js خود به نقشه های ارزش کلیدی Apigee Edge (KVM) دسترسی پیدا کنید. برای اطلاعات دقیق، دسترسی به نقشه‌های ارزش کلیدی در Node.js را ببینید.

در حال اجرا در حالت محلی در مقابل حالت مستقر

برای پشتیبانی از توسعه و آزمایش محلی، ماژول apigee-access در حالت محلی بدون وابستگی به Apigee Edge کار می‌کند. با این حال، هنگامی که ماژول با یک پراکسی API استفاده می شود که در Edge مستقر شده است، عملکرد "محلی" با عملکرد بومی Edge جایگزین می شود. به عنوان مثال، مجموعه کامل متغیرهای جریان در حالت مستقر در دسترس هستند، در حالی که تنها یک زیرمجموعه کوچک در هنگام اجرای برنامه Node.js به صورت محلی در دسترس هستند. برای فهرستی از این متغیرهای حالت محلی، به اجرای در حالت محلی مراجعه کنید.

تعیین حالتی که ماژول در آن اجرا می شود

برای تعیین اینکه در کدام حالت از apigee-access استفاده می کنید:

var access = require('apigee-access')
console.log('The deployment mode is ' + access.getMode());

مقدار برگشتی getMode() به شما می گوید که آیا برنامه Node.js در Apigee Edge مستقر شده است یا نه در حالت مستقل اجرا می شود. متد یکی از این دو نتیجه رشته را برمی گرداند:

  • apigee - برنامه Node.js بر روی Apigee Edge اجرا می شود و تمام عملکردها پشتیبانی می شود.
  • standalone - برنامه Node.js در خارج از محیط Apigee Edge اجرا می شود و عملکرد پیش فرض که در بالای سند توضیح داده شده است اعمال می شود.

در حال اجرا در حالت مستقر

وقتی در Edge مستقر می‌شوند، متغیرهای تنظیم‌شده توسط سیاست‌ها برای apigee-access قابل مشاهده هستند و متغیرهایی که با روش‌های این ماژول اضافه یا اصلاح شده‌اند برای سیاست‌های بعدی در جریان پروکسی قابل مشاهده هستند.

می توانید پیوند متغیرهای پشتیبانی شده را در مرجع متغیرها پیدا کنید. این متغیرها و هر متغیری که با نام خود ایجاد می کنید، برای apigee-access قابل مشاهده است. توجه داشته باشید که برخی از متغیرها فقط خواندنی هستند. آنها در مرجع متغیرها شناسایی می شوند.

در حال اجرا در حالت محلی

در حالت محلی، کد Node.js خود را خارج از زمینه Apigee Edge اجرا می کنید. در این حالت، اکثر متغیرهای جریان از پیش تعریف شده در کد Node.js شما قابل دسترسی نیستند. این جدول زیرمجموعه کوچکی از متغیرهای جریان موجود را نشان می دهد. این متغیرها در اینجا به منظور پشتیبانی از توسعه محلی و آزمایش برنامه‌های Node.js برای Apigee Edge پشتیبانی می‌شوند.

متغیر فقط خواندنی تایپ کنید یادداشت ها
client.received.start.time بله رشته زمانی که درخواست دریافت شد
client.received.end.time بله رشته زمانی که درخواست دریافت شد
client.received.start.timestamp بله عدد صحیح زمانی که درخواست دریافت شد
client.received.end.timestamp بله عدد صحیح زمانی که درخواست دریافت شد

باز هم، در پلتفرم Apigee Edge، مجموعه بسیار بزرگتری از متغیرهای از پیش تعریف شده پشتیبانی می شود. برای لیست کامل به مرجع متغیرهای لبه Apigee مراجعه کنید.