استفاده از واحد apigee-access

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

واحد apigee-access به شما امکان می‌دهد از داخل کد برنامه Node.js به متغیرهای جاری‌سازی و حافظه‌های نهان میانای برنامه‌سازی کاربردی وکالتی دسترسی داشته باشید. این واحد با پلاتفرم 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 خود به نقشه‌های مقدار کلید (KVM) در Apigee Edge دسترسی داشته باشید. برای اطلاعات دقیق، به دسترسی به نقشه‌های مقدار کلید در 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 Edge متغیرها مرجع مراجعه کنید.