Sử dụng mô-đun truy cập API

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

Mô-đun apigee-access cho phép bạn truy cập vào các biến luồng proxy và bộ nhớ đệm từ trong mã xử lý ứng dụng Node.js. Mô-đun này đi kèm với nền tảng Apigee Edge; bạn không cần cài đặt đoạn mã này giống như cách bạn thực hiện với các mô-đun Node.js khác.

Lấy quyền truy cập apigee

Mô-đun apigee-access được tích hợp vào nền tảng Apigee Edge. Khi triển khai mã Node.js cho Edge. Bạn có thể sử dụng mô-đun này. Bạn chỉ cần yêu cầu mã này trong bất kỳ mã Node.js nào mà bạn triển khai. Ví dụ:

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

Truy cập vào các biến luồng

Khi triển khai ứng dụng Node.js cho Edge, bạn có thể truy cập vào bất kỳ ứng dụng nào được hỗ trợ "out-of-the-box" biến luồng, biến luồng do các chính sách tạo ra và bất kỳ biến luồng nào mà bạn tự tạo từ bên trong mã Node.js. Biến luồng được tạo và tồn tại trong ngữ cảnh của proxy API chạy trên Edge. Để biết thông tin chi tiết, hãy xem Truy cập vào các biến luồng trong Node.js.

Truy cập bộ nhớ đệm

Mô-đun apigee-access cho phép bạn truy cập vào bộ nhớ đệm được phân phối của Apigee Edge từ mã Node.js của bạn. Để biết thông tin chi tiết, hãy xem bài viết Truy cập vào bộ nhớ đệm trong Node.js.

Sử dụng dịch vụ hạn mức

Mô-đun apigee-access cho phép bạn truy cập vào dịch vụ hạn mức Apigee Edge từ Mã Node.js. Để biết thông tin chi tiết, hãy xem Truy cập dịch vụ hạn mức trong Node.js.

Truy cập vào Bản đồ giá trị khoá

Mô-đun apigee-access cho phép bạn truy cập vào bản đồ giá trị khoá (KVM) của Apigee Edge từ mã Node.js của bạn. Để biết thông tin chi tiết, hãy xem Truy cập vào bản đồ khoá-giá trị trong Node.js.

Chạy ở chế độ cục bộ so với chế độ đã triển khai

Để hỗ trợ quá trình phát triển và kiểm thử cục bộ, mô-đun apigee-access hoạt động ở chế độ cục bộ mà không phụ thuộc vào Apigee Edge; tuy nhiên, khi mô-đun được sử dụng với proxy API được triển khai cho Edge, "cục bộ" chức năng này sẽ được thay thế bằng chức năng gốc của Edge. Ví dụ: có thể truy cập được đầy đủ các biến luồng ở chế độ đã triển khai, trong khi chỉ một tập hợp con nhỏ có sẵn khi bạn chạy ứng dụng Node.js trên máy. Để xem danh sách các biến chế độ cục bộ này, hãy xem phần Chạy ở chế độ cục bộ.

Xác định chế độ mà mô-đun đang chạy

Để xác định chế độ bạn đang chạy quyền truy cập apigee:

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

Giá trị trả về của getMode() cho bạn biết ứng dụng Node.js có được triển khai hay không với ứng dụng Apigee Edge hoặc đang chạy ở chế độ độc lập. Phương thức trả về một trong hai chuỗi này kết quả:

  • apigee – Ứng dụng Node.js đang chạy trên Apigee Edge và tất cả chức năng được hỗ trợ.
  • standalone – Ứng dụng Node.js đang chạy bên ngoài Apigee Edge và chức năng mặc định được mô tả ở phần đầu của tài liệu sẽ lấy hiệu ứng.

Chạy ở chế độ đã triển khai

Khi được triển khai cho Edge, các biến do chính sách đặt sẽ hiển thị với apigee-access, và các biến được thêm hoặc sửa đổi bằng phương pháp của mô-đun này sẽ hiển thị cho các chính sách tiếp theo trong luồng proxy.

Bạn có thể tìm thấy đường liên kết đến các biến được hỗ trợ trong Tham chiếu biến. Các biến này, và mọi nội dung bạn tạo bằng tên của riêng mình sẽ hiển thị với apigee-access. Ghi chú một số biến chỉ có thể đọc. Chúng được xác định trong Tham chiếu biến.

Chạy ở chế độ cục bộ

Ở "chế độ cục bộ", bạn đang chạy mã Node.js bên ngoài ứng dụng Apigee Edge. Trong chế độ này, hầu hết biến luồng được xác định trước đều không truy cập được trong Node.js của bạn . Bảng này cho biết một số biến luồng có sẵn. Các biến này được hỗ trợ tại đây để hỗ trợ việc phát triển và thử nghiệm cục bộ ứng dụng Node.js cho Apigee Edge.

Biến Chỉ đọc Loại Lưu ý
client.received.start.time Chuỗi Thời gian nhận được yêu cầu
client.received.end.time Chuỗi Thời gian nhận được yêu cầu
client.received.start.timestamp Số nguyên Thời gian nhận được yêu cầu
client.received.end.timestamp Số nguyên Thời gian nhận được yêu cầu

Xin nhắc lại, trên nền tảng Apigee Edge, chúng tôi hỗ trợ một tập hợp các biến được xác định trước lớn hơn nhiều. Tham khảo các biến của Apigee Edge Tài liệu tham khảo để biết danh sách đầy đủ.