Tài liệu tham khảo về biến luồng

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

Phần này cung cấp thông tin tham khảo về các biến luồng.

Apigee Edge xác định các biến luồng sau:

apigee              loadbalancing        router
apiproxy            message              servicecallout
application         messageid            system
client              organization         target
current             proxy                variable
environment         request              virtualhost
error               response
is                  route

Từng biến này được mô tả trong các phần tiếp theo.

apigee

Biến trợ giúp cung cấp thông tin về thời gian thực thi của chính sách.

Bảng sau đây mô tả các thuộc tính của biến apigee:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
apigee.metrics.policy.policy_name.timeTaken Số nguyên Chỉ đọc Thời gian (tính bằng nano giây) mà chính sách cần để thực thi. Chính sách

apiproxy

Mô tả proxy API.

Bảng sau đây mô tả các thuộc tính của biến apiproxy:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
apiproxy.name Chuỗi Chỉ đọc Tên của proxy API. Ví dụ: "Proxy của tôi". Yêu cầu proxy
apiproxy.revision Chuỗi Chỉ đọc Số bản sửa đổi của proxy API. Ví dụ: "6". Yêu cầu proxy

Để biết thêm thông tin về cách làm việc với proxy API, hãy xem Tìm hiểu về API và Proxy API.

application

Vùng chứa cho thuộc tính application.basepath.

Bảng sau đây mô tả các thuộc tính của biến application:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
application.basepath Chuỗi Chỉ đọc Đường dẫn cơ sở triển khai (được chỉ định trong quá trình triển khai API). Yêu cầu proxy

client

Ứng dụng hoặc hệ thống đã gửi yêu cầu tới bộ định tuyến Edge.

Bảng sau đây mô tả các thuộc tính của biến client:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
client.cn Chuỗi Chỉ đọc

Tên thường gọi được chỉ định trong chứng chỉ TLS/SSL do ứng dụng khách cung cấp.

 Yêu cầu proxy
client.country Chuỗi Chỉ đọc

Quốc gia trong chứng chỉ TLS/SSL mà ứng dụng cung cấp.

 Yêu cầu proxy
client.email.address Chuỗi Chỉ đọc

Địa chỉ email trong chứng chỉ TLS/SSL mà ứng dụng khách cung cấp.

 Yêu cầu proxy
client.host Chuỗi Chỉ đọc

IP của máy chủ HTTP được liên kết với yêu cầu mà ProxyEndpoint nhận được.

 Yêu cầu proxy
client.ip Chuỗi Chỉ đọc

Địa chỉ IP của máy khách hoặc hệ thống gửi thông báo đến bộ định tuyến Edge. Cho ví dụ: đây có thể là IP ứng dụng ban đầu hoặc IP trình cân bằng tải.

 Yêu cầu proxy
client.locality Chuỗi Chỉ đọc

Địa phương (Thành phố) trong chứng chỉ TLS/SSL do ứng dụng cung cấp.

 Yêu cầu proxy
client.organization Chuỗi Chỉ đọc Tổ chức trong chứng chỉ TLS/SSL mà khách hàng trình bày. (Không nhất thiết phải tương đương với tổ chức trên Apigee Edge.) Yêu cầu proxy
client.organization.unit Chuỗi Chỉ đọc

Đơn vị tổ chức trong chứng chỉ TLS/SSL mà khách hàng cung cấp.

 Yêu cầu proxy
client.port Số nguyên Chỉ đọc

Cổng HTTP liên kết với yêu cầu máy khách ban đầu đến ProxyEndpoint.

 Yêu cầu proxy
client.received.end.time Chuỗi Chỉ đọc

Thời gian được biểu thị dưới dạng chuỗi mà tại thời điểm proxy nhận xong yêu cầu từ ứng dụng khách ban đầu tại ProxyEndpoint. Ví dụ: Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 Giờ UTC

Giá trị thời gian này là chuỗi đại diện của dấu thời gian 32 bit tương ứng số lượng. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC" tương ứng với giá trị dấu thời gian của 1377112607413.

 Yêu cầu proxy
client.received.end.timestamp Dài Chỉ đọc

Giá trị dấu thời gian chỉ định thời điểm proxy nhận xong yêu cầu từ máy khách ban đầu tại ProxyEndpoint. Giá trị này là một số nguyên 64 bit (dài) có chứa số mili giây đã trôi qua kể từ nửa đêm ngày 1 tháng 1 năm 1970 (theo giờ UTC).

 Yêu cầu proxy
client.received.start.time Chuỗi Chỉ đọc

Thời gian được biểu thị dưới dạng chuỗi mà tại thời điểm proxy bắt đầu nhận yêu cầu từ ứng dụng khách ban đầu tại ProxyEndpoint. Ví dụ: Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 Giờ UTC

Giá trị thời gian này là chuỗi đại diện của dấu thời gian 32 bit tương ứng số lượng. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC" tương ứng với giá trị dấu thời gian của 1377112607413.

 Yêu cầu proxy
client.received.start.timestamp Dài Chỉ đọc

Giá trị dấu thời gian chỉ định thời điểm proxy bắt đầu nhận yêu cầu từ máy khách ban đầu tại ProxyEndpoint. Giá trị này là một số nguyên 64 bit (dài) có chứa số mili giây đã trôi qua kể từ nửa đêm ngày 1 tháng 1 năm 1970 (theo giờ UTC).

 Yêu cầu proxy
client.scheme Chuỗi Chỉ đọc

Trả về http hoặc https tuỳ thuộc vào phương thức truyền tải mà ứng dụng khách sử dụng để gửi tin nhắn yêu cầu.

 Yêu cầu proxy
client.sent.end.time Chuỗi Chỉ đọc

Thời gian được biểu thị dưới dạng chuỗi mà tại thời điểm proxy hoàn tất gửi phản hồi từ ProxyEndpoint đến máy khách. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC".

Giá trị này là một chuỗi đại diện của 32 bit tương ứng client.sent.end.timestamp. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC" tương ứng với giá trị dấu thời gian là 1377112607413.

 PostClientFlow
client.sent.end.timestamp Dài Chỉ đọc Giá trị dấu thời gian chỉ định thời điểm ProxyEndpoint trả về phản hồi xong cho ứng dụng khách ban đầu. Giá trị này là một số nguyên 64 bit (dài) có chứa số mili giây đã trôi qua kể từ nửa đêm, ngày 1 tháng 1 năm 1970 (theo giờ UTC). PostClientFlow
client.sent.start.time Chuỗi Chỉ đọc Thời gian, được biểu thị dưới dạng chuỗi, khi ProxyEndpoint bắt đầu trả về phản hồi cho ứng dụng khách ban đầu. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC".

Giá trị này là một chuỗi đại diện của 32 bit tương ứng client.sent.start.timestamp. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC" tương ứng với giá trị dấu thời gian là 1377112607413.

 PostClientFlow
client.sent.start.timestamp Dài Chỉ đọc Thời điểm proxy bắt đầu gửi phản hồi cho ứng dụng khách từ ProxyEndpoint. Chiến dịch này giá trị được biểu thị dưới dạng số nguyên 64 bit (dài) có chứa số mili giây trôi qua kể từ nửa đêm, ngày 1 tháng 1 năm 1970 (theo giờ UTC). PostClientFlow
client.ssl.enabled Chuỗi Chỉ đọc

"đúng" nếu ProxyEndpoint được định cấu hình cho TLS/SSL; ngược lại là "false".

 Yêu cầu proxy
client.state Chuỗi Chỉ đọc

Trạng thái trong chứng chỉ TLS/SSL mà ứng dụng cung cấp.

 Yêu cầu proxy

current

Chứa thông tin về luồng proxy API hiện tại.

Bảng sau đây mô tả các thuộc tính của biến current:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
current.flow.name Chuỗi Chỉ đọc Tên của luồng hiện đang thực thi (chẳng hạn như "PreFlow", "PostFlow" hoặc tên của luồng có điều kiện). Yêu cầu proxy
current.flow.description Chuỗi Chỉ đọc Nội dung mô tả về quy trình đang thực thi. Điều này giống với giá trị của phần tử <Description> trong cấu hình XML của luồng. Yêu cầu proxy

Bạn có thể xem các thuộc tính này trong chế độ xem Theo dõi của giao diện người dùng Edge. Tuy nhiên, các thuộc tính này không hiển thị theo mặc định trong chế độ xem Theo dõi của giao diện người dùng cổ điển.

environment

Vùng chứa cho thuộc tính environment.name.

Bảng sau đây mô tả các thuộc tính của biến environment:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
environment.name Chuỗi Chỉ đọc Tên của môi trường nơi giao dịch diễn ra. Yêu cầu proxy

error

Đối tượng theo ngữ cảnh đại diện cho thông báo lỗi trong luồng lỗi.

Bảng sau đây mô tả các thuộc tính của biến error:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
error message Đọc/Ghi Lỗi thuộc loại message, là đối tượng theo bối cảnh trong luồng lỗi. Lỗi
error.content Chuỗi Đọc/Ghi Nội dung của lỗi. Lỗi
error.message Chuỗi Chỉ đọc

Thông báo liên quan đến lỗi, có giá trị chỉ xuất hiện trước Luồng lỗi sẽ được thực thi.

 Lỗi
error.status.code Số nguyên Chỉ đọc

Mã trạng thái HTTP liên quan đến lỗi. Ví dụ: "400".

 Lỗi
error.reason.phrase Chuỗi Chỉ đọc

Cụm từ lý do liên quan đến lỗi. Ví dụ: "Yêu cầu không hợp lệ".

 Lỗi
error.transport.message TransportMessage Chỉ đọc

Lỗi bất kỳ về loại TransportMessage.

 Lỗi
error.state Số nguyên Chỉ đọc

Trạng thái trong Luồng nơi xảy ra lỗi.

 Lỗi
error.header.header_name Chuỗi Đọc/Ghi

Nhận hoặc đặt tiêu đề phản hồi.

 Lỗi

fault

Biến luồng được đặt thành mã lỗi thời gian chạy khi một chính sách gửi lỗi. Mỗi chính sách sẽ có giá trị mã lỗi riêng.

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
fault.fault_name Chuỗi Chỉ đọc fault_name là tên của lỗi, như mô tả trong bảng Lỗi thời gian chạy có trong mỗi chủ đề tài liệu tham khảo về chính sách. Lỗi

is

Vùng chứa cho thuộc tính is.error.

Bảng sau đây mô tả các thuộc tính của biến is:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
is.error Boolean Chỉ đọc

Gắn cờ lỗi.

 Yêu cầu proxy

loadbalancing

Cung cấp thông tin về trạng thái cân bằng tải của TargetEndpoint.

Bảng sau đây mô tả các thuộc tính của biến loadbalancing:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
loadbalancing.failedservers Mảng chuỗi Chỉ đọc

Danh sách TargetServers không thành công trong quá trình cân bằng tải tại TargetEndpoint.

 Câu trả lời mục tiêu
loadbalancing.isfallback Boolean Chỉ đọc

"đúng" nếu tính năng dự phòng được bật cho TargetServer được gọi trong quá trình cân bằng tải tại TargetEndpoint.

 Câu trả lời mục tiêu
loadbalancing.targetserver Chuỗi Chỉ đọc

TargetServer được gọi trong quá trình cân bằng tải tại TargetEndpoint. Chỉ đặt nếu Phần tử <Path> được đặt trong khi xác định phần tử trình cân bằng tải.

 Câu trả lời mục tiêu

message

Đối tượng theo bối cảnh, có cùng giá trị với request trong luồng yêu cầu hoặc dưới dạng response trong quy trình phản hồi hoặc dưới dạng error trong lỗi luồng.

Bảng sau đây mô tả các thuộc tính của biến message:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
message message Đọc/Ghi

Đối tượng theo bối cảnh, có cùng giá trị với request trong Luồng yêu cầu hoặc dưới dạng response trong Luồng phản hồi hoặc dưới dạng error trong Lỗi luồng.

 Yêu cầu proxy
message.content Chuỗi Đọc/Ghi

Nội dung của yêu cầu, phản hồi hoặc thông báo lỗi.

 Yêu cầu proxy
message.formparam.param_name Chuỗi Đọc/Ghi

Giá trị của thông số biểu mẫu đã chỉ định.

 Yêu cầu proxy
message.formparam.param_name.
 values		 Bộ sưu tập Chỉ đọc

Tất cả giá trị của thông số biểu mẫu được chỉ định trong thông báo.

 Yêu cầu proxy
message.formparam.param_name.
 values.count		 Số nguyên Chỉ đọc

Số lượng giá trị của thông số biểu mẫu được chỉ định trong thông báo./p>

Yêu cầu proxy
message.formparams.count Số nguyên Chỉ đọc

Đếm tất cả thông số biểu mẫu trong thư.

 Yêu cầu proxy
message.formparams.names Bộ sưu tập Chỉ đọc

Giá trị của tất cả thông số biểu mẫu trong thông báo.

 Yêu cầu proxy
message.formstring Chuỗi Chỉ đọc

Giá trị của chuỗi biểu mẫu trong thông báo.

 Yêu cầu proxy
message.header.header_name Chuỗi Đọc/Ghi

Lấy hoặc thiết lập giá trị của tiêu đề HTTP được chỉ định trong thông báo. Nếu tiêu đề chứa dấu phẩy, khi đọc, bạn sẽ chỉ nhận được phân đoạn của văn bản cho đến đoạn dấu phẩy. Nếu bạn muốn xem toàn bộ tiêu đề, hãy sử dụng biểu mẫu request.header.header_name.
 values

 Yêu cầu proxy
message.header.header_name.N Chuỗi Đọc/Ghi

Giá trị của giá trị tiêu đề thứ N cụ thể trong thông báo, yêu cầu hoặc phản hồi, tùy thuộc vào trạng thái của luồng. Apigee Edge phân tách các giá trị văn bản tiêu đề bằng dấu phẩy. Lưu ý rằng chỉ mục có giá trị được dùng cho N là dựa trên 1, không dựa trên 0.

Ví dụ: nếu tiêu đề Cache-control là "public,maxage=16544", thì giá trị trả về của message.header.cache-control.1 là "maxage=16544".

 Yêu cầu proxy
message.header.header_name.
 values		 Bộ sưu tập Chỉ đọc

Tất cả giá trị của tên tiêu đề HTTP được chỉ định trong thông báo.

 Yêu cầu proxy
message.header.header_name.
 values.count		 Số nguyên Chỉ đọc

Số lượng giá trị của tên tiêu đề HTTP được chỉ định trong thông báo.

 Yêu cầu proxy
message.headers.count Số nguyên Chỉ đọc

Số lượng tất cả tiêu đề HTTP trong thư.

 Yêu cầu proxy
message.headers.names Bộ sưu tập Chỉ đọc

Giá trị của tất cả tiêu đề HTTP trong thư

 Yêu cầu proxy
message.path Chuỗi Đọc/Ghi

Đường dẫn thông báo yêu cầu hoàn chỉnh trong URL không bao gồm mọi tham số truy vấn.

Yêu cầu proxy
message.queryparam.param_name Chuỗi Chỉ đọc

Trả về tham số truy vấn tin nhắn được chỉ định.

 Yêu cầu proxy
message.queryparam.param_name.N Chuỗi Đọc/Ghi

Giá trị của tham số truy vấn Nth trong thông báo. Ví dụ: nếu request.querystring là "a=hello&a=world", sau đó là giá trị trả về của message.queryparam.a.1 là "Xin chào".

Ví dụ về cách viết nhiều giá trị cho một tên tham số truy vấn, chẳng hạn như "type=siteid:1&type=language:us-en&type=currency:USD", đặt như sau:

  • message.queryparam.type.1 thành "siteid:1"
  • message.queryparam.type.2 sang "language:vi-vn"
  • message.queryparam.type.3 thành "currency:USD"
 Yêu cầu proxy
message.queryparam.param_name.
 values		 Bộ sưu tập Chỉ đọc

Tất cả giá trị của một tham số truy vấn cụ thể trong thông báo, được định dạng dưới dạng danh sách được phân tách bằng dấu phẩy.

Ví dụ: nếu chuỗi truy vấn là a=hello&a=world, thì giá trị của message.queryparam.a.values là "['hello', 'world']".

 Yêu cầu proxy
message.queryparam.param_name.
 values.count		 Số nguyên Chỉ đọc

Tổng số lượng tham số truy vấn cụ thể được liên kết với yêu cầu được gửi đến ProxyEndpoint qua ứng dụng khách.

 Yêu cầu proxy
message.queryparams.count Số nguyên Chỉ đọc

Tổng số của tất cả tham số truy vấn được liên kết với yêu cầu được gửi đến ProxyEndpoint qua ứng dụng khách.

 Yêu cầu proxy
message.queryparams.names Bộ sưu tập Chỉ đọc

Danh sách tất cả tên tham số truy vấn được liên kết với yêu cầu được gửi đến ProxyEndpoint qua ứng dụng khách.

Để lặp lại tên tham số truy vấn bằng JavaScript, hãy xem bài viết Apigee sau đây Bài đăng trên cộng đồng: Cách lặp lại Bộ sưu tập từ "request.queryparams.names" trong JS? trong Cộng đồng Apigee.

 Yêu cầu proxy
message.querystring Chuỗi Chỉ đọc

Một chuỗi chứa tất cả tên và giá trị của tham số truy vấn có liên quan đến yêu cầu được gửi đến ProxyEndpoint từ ứng dụng khách.

Ví dụ: đối với yêu cầu "http://api.apifactory.com/inventors?name=nick&surname=danger", giá trị của message.querystring là "name=nick&surname=danger".

 Yêu cầu proxy
message.reason.phrase Chuỗi Chỉ đọc

Lý do của tin nhắn phản hồi từ mục tiêu.

 Câu trả lời mục tiêu
message.status.code Số nguyên Chỉ đọc

Mã trạng thái HTTP của thông báo phản hồi từ đích.

 Câu trả lời mục tiêu
message.transport.message TransportMessage Chỉ đọc

Thông báo thuộc loại TransportMessage là đối tượng theo bối cảnh.

 Yêu cầu proxy
message.uri Chuỗi Chỉ đọc

Đường dẫn hoàn chỉnh của URI (theo sau URL miền) bao gồm cả các tham số truy vấn.

Ví dụ: đối với yêu cầu "http://api.apifactory.com/inventors?name=nikola&surname=tesla", biến này trả về "inventors?name=nikola&surname=tesla".

 Yêu cầu proxy
message.verb Chuỗi Chỉ đọc

Động từ HTTP (GET, PUT, POST, DELETE, v.v.) được liên kết với yêu cầu.

 Yêu cầu proxy
message.version Chuỗi Đọc/Ghi

Phiên bản HTTP được liên kết với yêu cầu được gửi đến ProxyEndpoint qua ứng dụng .

 Yêu cầu proxy

Để biết thêm thông tin về tin nhắn, hãy xem Tài liệu tham khảo về hàm mẫu tin nhắn.

messageid

Vùng chứa mã nhận dạng duy nhất trên toàn hệ thống cho yêu cầu.

Bảng sau đây mô tả các thuộc tính của biến messageid:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
messageid Chuỗi Chỉ đọc

Lưu giữ mã nhận dạng duy nhất trên toàn hệ thống cho yêu cầu, bao gồm cả tên máy chủ của bộ định tuyến. Mã này cho phép theo dõi các yêu cầu nhận được tại bộ định tuyến sau khi chúng được gửi đến trình xử lý tin nhắn.

Mã nhận dạng này được ghi vào nhật ký lỗi của Edge để so sánh messageid với .

 Yêu cầu proxy

organization

Vùng chứa cho thuộc tính organization.name.

Bảng sau đây mô tả các thuộc tính của biến organization:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
organization.name Chuỗi Chỉ đọc

Tên tổ chức.

 Yêu cầu proxy

Để biết thêm thông tin về tổ chức, hãy xem Tìm hiểu .

proxy

Cấu hình proxy API.

Bảng sau đây mô tả các thuộc tính của biến proxy:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
proxy.basepath Chuỗi Chỉ đọc

Giá trị của Đường dẫn cơ sở trong cấu hình proxy API của bạn. Đường dẫn cơ sở là URI theo sau máy chủ trong URL. URI luồng có điều kiện tuân theo cơ sở đường dẫn.

Trong URL "http://myorg-test.apigee.net/v2/Weatherapi/surveyRSS?w=12797282":

  • Máy chủ lưu trữ là "myorg-test.apigee.net" (bao gồm tên tổ chức và môi trường)
  • Đường dẫn cơ sở là "/v2/Weatherapi"

Cách duy nhất để bạn biết điều này bằng cách xem định nghĩa proxy API hoặc kiểm tra giá trị của proxy.basepath biến. Hậu tố đường dẫn proxy đi theo đường dẫn cơ sở ("/ForecastRSS"), cùng với bất kỳ tham số truy vấn.

Nếu bạn xác định Đường dẫn cơ sở động trong proxy API của mình cấu hình của chúng tôi, chẳng hạn như "/v2/*/Weatherapi", thì biến này được đặt thành đường dẫn động ("/v2/*/Weatherapi"), mặc dù đường dẫn cơ sở chuyển thành giá trị tĩnh, chẳng hạn như &quot;/v2/foo/weatherapi&quot;.

 Yêu cầu proxy
proxy.client.ip Chuỗi Chỉ đọc

Địa chỉ X-Forwarded-For của cuộc gọi đến, là Địa chỉ IP mà cạnh nhận được từ cơ chế bắt tay TCP bên ngoài gần đây nhất. Đây có thể là cuộc gọi hoặc trình cân bằng tải.

 Yêu cầu proxy
proxy.name Chuỗi Chỉ đọc

Thuộc tính tên được định cấu hình cho ProxyEndpoint.

 Yêu cầu proxy
proxy.pathsuffix Chuỗi Chỉ đọc

Giá trị của hậu tố đường dẫn cơ sở proxy API được gửi từ ứng dụng và nhận tại ProxyEndpoint.

Đường dẫn cơ sở được định nghĩa là thành phần đường dẫn xác định duy nhất proxy API. URL công khai của proxy API bao gồm tên tổ chức của bạn, môi trường nơi triển khai proxy, đường dẫn cơ sở, hậu tố đường dẫn cơ sở và bất kỳ truy vấn nào tham số.

Ví dụ: trong yêu cầu đến http://myorg-test.apigee.net/v2/weatherapi/forecastrss?w=12797282, hậu tố đường dẫn cơ sở là "/ +statsRSS".

 Yêu cầu proxy
proxy.url Chuỗi Chỉ đọc

Lấy URL hoàn chỉnh liên kết với yêu cầu proxy mà ProxyEndpoint nhận được, bao gồm mọi tham số truy vấn hiện có. Máy chủ lưu trữ của URL sẽ luôn là localhost nếu proxy được gọi bằng <LocalTargetConnection> để thực hiện xâu chuỗi proxy.

Xem ví dụ tạo URL request bằng URL gốc máy chủ lưu trữ, hãy xem phần Yêu cầu truy cập vào tin nhắn.

 Yêu cầu proxy

Để biết thêm thông tin về cách làm việc với proxy API, hãy xem Tìm hiểu về API và Proxy API.

request

Yêu cầu hoàn chỉnh, bao gồm mọi tải trọng hiện có.

Để biết thêm thông tin về dữ liệu yêu cầu, hãy xem Dữ liệu yêu cầu được chuyển đến máy chủ phụ trợ như thế nào?

Bảng sau đây mô tả các thuộc tính của biến request:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
request message Chỉ đọc

Yêu cầu hoàn chỉnh, bao gồm mọi tải trọng hiện có.

 Yêu cầu proxy
request.content Chuỗi Đọc/Ghi

Lấy hoặc thiết lập tải trọng của thông báo yêu cầu.

 Yêu cầu proxy
request.formparam.param_name Chuỗi Đọc/Ghi

Lấy hoặc đặt giá trị của thông số biểu mẫu được chỉ định trong yêu cầu được gửi từ ứng dụng khách.

 Yêu cầu proxy
request.formparam.param_name.
 values		 Bộ sưu tập Chỉ đọc

Tất cả các giá trị của một thông số biểu mẫu cụ thể trong yêu cầu, được định dạng dưới dạng danh sách được phân tách bằng dấu phẩy.

Ví dụ: nếu tải trọng là "a=hello&x=welcome&a=world", sau đó là giá trị của request.formparam.a.values là "['hello', 'world']".

 Yêu cầu proxy
request.formparam.param_name.
 values.count		 Số nguyên Chỉ đọc

Đếm tất cả giá trị cho thông số biểu mẫu được chỉ định được liên kết với yêu cầu.

 Yêu cầu proxy
request.formparam.param_name.N Chuỗi Đọc/Ghi

Giá trị của tham số biểu mẫu cụ thể Nth trong thông báo. Ví dụ: nếu chuỗi biểu mẫu là "a=hello&a=world", thì giá trị trả về của request.formparam.a.1 là "Xin chào".

 Yêu cầu proxy
request.formparams.count Số nguyên Chỉ đọc

Số lượng tất cả thông số biểu mẫu được liên kết với yêu cầu được gửi từ ứng dụng .

 Yêu cầu proxy
request.formparams.names Bộ sưu tập Chỉ đọc

Danh sách tất cả tên thông số biểu mẫu được liên kết với yêu cầu.

 Yêu cầu proxy
request.formstring Chuỗi Chỉ đọc

formparam hoàn chỉnh trong yêu cầu được gửi từ ứng dụng.

Ví dụ: "name=test&type=first&group=A".

 Yêu cầu proxy
request.header.header_name Chuỗi Đọc/Ghi

Lấy hoặc thiết lập giá trị của một tiêu đề cụ thể có trong yêu cầu. Nếu tiêu đề chứa dấu phẩy, khi đọc, bạn sẽ chỉ nhận được phân đoạn của văn bản cho đến đoạn dấu phẩy.

Nếu bạn muốn xem toàn bộ tiêu đề, hãy sử dụng biểu mẫu request.header.header_name.values.

 Yêu cầu proxy
request.header.header_name.N Chuỗi Đọc/Ghi

Giá trị của giá trị tiêu đề thứ N cụ thể trong yêu cầu. Ứng dụng Apigee Edge phân tách các giá trị văn bản tiêu đề bằng dấu phẩy. Lưu ý rằng chỉ mục có giá trị được dùng cho N là Dựa trên 1, không dựa trên 0.

Ví dụ: nếu tiêu đề Cache-control là "public, maxage=16544", thì giá trị trả về của request.header.cache-control.1 là "maxage=16544".

 Yêu cầu proxy
request.header.header_name.
 values		 Bộ sưu tập Chỉ đọc

Tất cả các giá trị của một tiêu đề cụ thể trong yêu cầu.

 Yêu cầu proxy
request.header.header_name.
 values.count		 Số nguyên Chỉ đọc

Đếm tất cả giá trị của một tiêu đề cụ thể trong yêu cầu.

 Yêu cầu proxy
request.headers.count Số nguyên Chỉ đọc

Số lượng tất cả tiêu đề trong yêu cầu.

 Yêu cầu proxy
request.headers.names Bộ sưu tập Chỉ đọc

Tên của tất cả các tiêu đề trong yêu cầu.

 Yêu cầu proxy
request.path Chuỗi Chỉ đọc

Đường dẫn tài nguyên không được proxy (không bao gồm máy chủ) đến dịch vụ phụ trợ, loại trừ tham số truy vấn.

Ví dụ: của URI đến dịch vụ phụ trợ là "https://example.com/rest/api/Latest", sau đó là giá trị của request.path là "/rest/api/Latest".

 Yêu cầu proxy
request.queryparam.param_name Chuỗi Đọc/Ghi

Giá trị của một tham số truy vấn cụ thể được tìm thấy trong yêu cầu.

 Yêu cầu proxy
request.queryparam.param_name.N Chuỗi Đọc/Ghi

Giá trị của tham số truy vấn Nth trong yêu cầu.

Ví dụ: nếu request.querystring là "a=hello&a=world", thì giá trị trả về là request.queryparam.a.1 là "xin chào".

Ví dụ về cách viết nhiều giá trị cho một tên tham số truy vấn, chẳng hạn như "type=siteid:1&type=language:us-en&type=currency:USD", đặt như sau:

  • request.queryparam.type.1 thành "siteid:1"
  • request.queryparam.type.2 sang "language:vi-vn"
  • request.queryparam.type.3 thành "currency:USD"
 Yêu cầu proxy
request.queryparam.param_name.
 values		 Bộ sưu tập Chỉ đọc

Tất cả các giá trị của tham số truy vấn cụ thể trong yêu cầu, được định dạng dưới dạng danh sách được phân tách bằng dấu phẩy.

Ví dụ: nếu request.querystring là "a=hello&b=lovely&a=world", sau đó là giá trị của request.queryparam.a.values là "['hello', 'world']".

 Yêu cầu proxy
request.queryparam.param_name.
 values.count		 Số nguyên Chỉ đọc

Tổng số tất cả giá trị của một tham số truy vấn cụ thể trong yêu cầu.

 Yêu cầu proxy
request.queryparams.count Số nguyên Chỉ đọc

Tổng số của tất cả tham số truy vấn trong yêu cầu.

 Yêu cầu proxy
request.queryparams.names Bộ sưu tập Chỉ đọc

Tên của tất cả tham số truy vấn trong yêu cầu.

Để lặp lại các tên tham số truy vấn bằng JavaScript, hãy xem Cách lặp lại Bộ sưu tập từ "request.queryparams.names" trong JS? trong phần Cộng đồng Apigee.

 Yêu cầu proxy
request.querystring Chuỗi Chỉ đọc

Danh sách đầy đủ các tham số truy vấn trong yêu cầu được gửi từ ứng dụng.

Ví dụ: nếu yêu cầu là "http://host.com/123?name=first&surname=second&place=address", thì biến này sẽ trả về "name=first&surname=second&place=address".

 Yêu cầu proxy
request.transportid Chuỗi Chỉ đọc

Mã nhận dạng của yêu cầu dưới dạng loại TransportMessage – một đối tượng theo bối cảnh.

 Yêu cầu proxy
request.transport.message Truyền tải-Tin nhắn Chỉ đọc

Yêu cầu thuộc loại TransportMessage là một đối tượng liên kết.

 Yêu cầu proxy
request.uri Chuỗi Chỉ đọc

Trong proxy API, proxy <BasePath> trong ProxyEndpoint (trong bổ sung vào URL cơ sở của proxy) ánh xạ tới URL dịch vụ đích trong TargetEndpoint. Ví dụ:

<ProxyEndpoint>
...
  <BasePath>/my-mock-proxy</BasePath>

Trỏ tới

<TargetEndpoint>
...
  <HTTPTargetConnection>
    http://mocktarget.apigee.net
  </HTTPTargetConnection>

Trong yêu cầu, request.uri là đường dẫn cơ sở proxy + phần còn lại của địa chỉ, bao gồm cả tham số truy vấn.

Trong phản hồi, request.uri là phần còn lại của địa chỉ, bao gồm cả tham số truy vấn sau HTTPTargetConnection.

Sự khác biệt là vì yêu cầu ban đầu đã chuyển đến proxy, nhưng sau đó máy chủ proxy thực hiện một yêu cầu khác tới dịch vụ mục tiêu.

Giả sử lệnh gọi sau được thực hiện đến proxy mẫu của chúng ta, proxy này có đường dẫn cơ sở trong "/my-mock-proxy":

http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude

Và proxy cuộc gọi:

http://mocktarget.apigee.net

URL nào sẽ nối "/user?user=Dude" cho URL đó.

  • Yêu cầu: request.uri = "/my-mock-proxy/user?user=Dude"
  • Phản hồi: request.uri = "/user?user=Dude"
 Yêu cầu proxy (khác trong phản hồi)
request.url Chuỗi Chỉ đọc

URL hoàn chỉnh của yêu cầu được gửi đến điểm cuối đích, bao gồm tham số chuỗi truy vấn, nhưng không bao gồm số cổng (nếu được chỉ định).

Ví dụ: nếu bạn gọi điện đến một proxy mẫu "http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude" và điểm cuối đích là "http://example.com:8080", thì giá trị là:

  • Yêu cầu: không áp dụng
  • Phản hồi: "http://example.com/user?user=Dude"
 Câu trả lời mục tiêu
request.verb Chuỗi Chỉ đọc

Động từ HTTP dùng cho yêu cầu. Ví dụ: "GET", "PUT" và "DELETE".

 Yêu cầu proxy
request.version Chuỗi Chỉ đọc

Phiên bản HTTP của yêu cầu. Ví dụ: "1,1".

 Yêu cầu proxy

response

Phản hồi hoàn chỉnh, bao gồm mọi tải trọng hiện có.

Bảng sau đây mô tả các thuộc tính của biến response:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
response message Đọc/Ghi

Tin nhắn phản hồi hoàn chỉnh được đích trả về.

 Câu trả lời mục tiêu
response.content Chuỗi Đọc/Ghi

Nội dung tải trọng của thông báo phản hồi do mục tiêu trả về.

 Câu trả lời mục tiêu
response.formparam.param_name Chuỗi Đọc/Ghi

Giá trị của một thông số biểu mẫu trong phản hồi.

 Câu trả lời mục tiêu
response.formparam.param_name.
 values.count		 Số nguyên Chỉ đọc

Đếm tất cả giá trị của thông số biểu mẫu được chỉ định trong phản hồi.

 Câu trả lời mục tiêu
response.formparams.count Số nguyên Chỉ đọc

Số lượng tất cả các prameter trong câu trả lời.

 Câu trả lời mục tiêu
response.formparams.names Bộ sưu tập Chỉ đọc

Tên của tất cả thông số biểu mẫu trong phản hồi.

 Câu trả lời mục tiêu
response.header.header_name Chuỗi Đọc/Ghi

Lấy hoặc thiết lập giá trị của tiêu đề HTTP được chỉ định trong phản hồi.

Nếu văn bản tiêu đề chứa dấu phẩy, thì Apigee Edge sẽ suy ra nhiều giá trị. Trong trường hợp này, response.header.header_name chỉ trả về giá trị đầu tiên.

Để đọc toàn bộ tiêu đề, hãy sử dụng biểu mẫu response.header.header_name.values.

 Câu trả lời mục tiêu
response.header.header_name.
 values		 Bộ sưu tập Chỉ đọc

Tất cả giá trị của một tiêu đề HTTP được chỉ định trong phản hồi.

 Câu trả lời mục tiêu
response.header.header_name.
 values.count		 Số nguyên Chỉ đọc

Đếm tất cả giá trị của tiêu đề HTTP được chỉ định trong phản hồi.

 Câu trả lời mục tiêu
response.header.header_name.N Chuỗi Đọc/Ghi

Giá trị của giá trị tiêu đề cụ thể Nth trong phản hồi. Ứng dụng Apigee Edge phân tách các giá trị văn bản tiêu đề bằng dấu phẩy. Lưu ý rằng chỉ mục có giá trị được dùng cho N là Dựa trên 1, không dựa trên 0.

Ví dụ: nếu tiêu đề Cache-control là "public, maxage=16544", sau đó response.header.cache-control.1 sẽ trả về "maxage=16544".

 Câu trả lời mục tiêu
response.headers.count Số nguyên Chỉ đọc

Đếm tất cả tiêu đề trong phản hồi.

 Câu trả lời mục tiêu
response.headers.names Bộ sưu tập Chỉ đọc

Tên của tất cả tiêu đề trong phản hồi.

 Câu trả lời mục tiêu
response.reason.phrase Chuỗi Đọc/Ghi

Cụm từ cho biết lý do phản hồi cho một yêu cầu cụ thể.

 Câu trả lời mục tiêu
response.status.code Số nguyên Đọc/Ghi

Mã phản hồi được trả về cho một yêu cầu. Bạn có thể sử dụng biến này để ghi đè mã trạng thái phản hồi được lưu trữ trong message.status.code. Để biết thêm thông tin, xem message.

 Câu trả lời mục tiêu
response.transport.message Chuỗi Chỉ đọc

Phản hồi thuộc loại TransportMessage là một đối tượng liên kết.

 Câu trả lời mục tiêu

route

Chỉ định tên của <RouteRule> và TargetEndpoint.

Bảng sau đây mô tả các thuộc tính của biến route:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
route.name Chuỗi Chỉ đọc

Tên của <RouteRule> đã được thực thi trong ProxyEndpoint. Ví dụ: "default". RouteRule tham chiếu đến TargetEndpoint của proxy API để thực thi.

 Yêu cầu mục tiêu
route.target Chuỗi Chỉ đọc

Tên của TargetEndpoint đã được thực thi. Ví dụ: "mặc định".

 Yêu cầu mục tiêu

router

Vùng chứa cho thuộc tính router.uuid (không dùng nữa).

Bảng sau đây mô tả các thuộc tính của biến router:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
router.uuid Chuỗi Chỉ đọc

Không dùng nữa và trả về giá trị rỗng. (Trước đây là UUID của bộ định tuyến xử lý proxy.)

 Yêu cầu proxy

servicecallout

Mô tả TargetEndpoint cho một chính sách về Chú thích dịch vụ.

Bảng sau đây mô tả các thuộc tính của biến servicecallout:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
servicecallout.policy_name.expectedcn Chuỗi Đọc/Ghi

Tên chung dự kiến của TargetEndpoint được đề cập trong Chính sách Chính sách về dịch vụ chú thích. Điều này chỉ có ý nghĩa khi TargetEndpoint tham chiếu đến điểm cuối TLS/SSL.

 Yêu cầu proxy
servicecallout.policy_name.target.url Chuỗi Đọc/Ghi

URL TargetEndpoint cho một chính sách về Chú thích dịch vụ cụ thể.

 Yêu cầu proxy
servicecallout.requesturi Chuỗi Đọc/Ghi

URI TargetEndpoint cho chính sách ServiceAnnotation (Chính sách về dịch vụ chú thích). URI là URL TargetEndpoint không có thông số kỹ thuật của miền và giao thức.

 Yêu cầu proxy

system

Chỉ định địa chỉ IP của hệ thống cũng như thông tin chi tiết về proxy.

Bảng sau đây mô tả các thuộc tính của biến system:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
system.interface.interface_name Chuỗi Chỉ đọc

Địa chỉ IP của hệ thống.

 Yêu cầu proxy
system.pod.name Chuỗi Chỉ đọc

Tên của nhóm nơi proxy đang chạy.

 Yêu cầu proxy
system.region.name Chuỗi Chỉ đọc

Tên của trung tâm dữ liệu khu vực nơi proxy đang chạy.

 Yêu cầu proxy
system.time Chuỗi Chỉ đọc

Thời điểm biến này được đọc. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC".

Giá trị này là chuỗi đại diện cho giá trị tương ứng của system.timestamp. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC" tương ứng với giá trị dấu thời gian là "1377112607413".

 Yêu cầu proxy
system.time.year Số nguyên Chỉ đọc

Phần trong năm của system.time.

 Yêu cầu proxy
system.time.month Số nguyên Chỉ đọc

Phần trong tháng của system.time.

 Yêu cầu proxy
system.time.day Số nguyên Chỉ đọc

Phần ngày trong tháng của system.time.

 Yêu cầu proxy
system.time.dayofweek Số nguyên Chỉ đọc

Ngày trong tuần của system.time.

 Yêu cầu proxy
system.time.hour Số nguyên Chỉ đọc

Phần giờ của system.time.

 Yêu cầu proxy
system.time.minute Số nguyên Chỉ đọc

Phần phút của system.time.

 Yêu cầu proxy
system.time.second Số nguyên Chỉ đọc

Phần thứ hai của system.time.

 Yêu cầu proxy
system.time.millisecond Số nguyên Chỉ đọc

Phần mili giây của system.time.

 Yêu cầu proxy
system.time.zone Chuỗi Chỉ đọc

Múi giờ của hệ thống.

 Yêu cầu proxy
system.timestamp Dài Chỉ đọc

Số nguyên 64 bit (dài) biểu thị thời gian biến này được đọc. Giá trị là số mili giây đã trôi qua kể từ nửa đêm ngày 1 tháng 1 năm 1970 (theo giờ UTC). Ví dụ: "1534783015000".

 Yêu cầu proxy
system.uuid Chuỗi Chỉ đọc

Mã nhận dạng duy nhất (UUID) của trình xử lý thông báo xử lý proxy.

 Yêu cầu proxy

target

Mô tả mục tiêu của yêu cầu.

Bảng sau đây mô tả các thuộc tính của biến target:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
target.basepath Chuỗi Chỉ đọc

Đường dẫn tài nguyên (không bao gồm miền) đến dịch vụ đích, không bao gồm truy vấn tham số được xác định trong TargetEndpoint của proxy.

Ví dụ: giả sử proxy API gọi mục tiêu sau:

<TargetEndpoint name="default">
...
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
  </HTTPTargetConnection>

Trong ví dụ này, target.basepath là "/user".

Nếu mục tiêu là:

<TargetEndpoint name="default">
...
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net</URL>
  </HTTPTargetConnection>

target.basepath sẽ rỗng.

 Yêu cầu mục tiêu
target.copy.pathsuffix Boolean Đọc/Ghi

Khi giá trị "true", yêu cầu được chuyển tiếp từ ProxyEndpoint đến TargetEndpoint sẽ giữ lại đường dẫn hậu tố (mảnh đường dẫn URI theo sau URI được xác định trong cơ sở ProxyEndpoint đường dẫn).

 Yêu cầu mục tiêu
target.copy.queryparams Boolean Đọc/Ghi

Khi giá trị là "true", yêu cầu được chuyển tiếp từ ProxyEndpoint đến TargetEndpoint sẽ giữ lại truy vấn tham số.

 Yêu cầu mục tiêu
target.country Chuỗi Chỉ đọc

Quốc gia của chứng chỉ TLS/SSL do máy chủ đích cung cấp

 Câu trả lời mục tiêu
target.cn Chuỗi Chỉ đọc

Tên chung của TargetEndpoint. Điều này chỉ có ý nghĩa khi TargetEndpoint đề cập đến một điểm cuối TLS/SSL.

 Yêu cầu mục tiêu
target.email.address Chuỗi Chỉ đọc

Địa chỉ email của chứng chỉ TLS/SSL mà máy chủ đích cung cấp

 Câu trả lời mục tiêu
target.expectedcn Chuỗi Đọc/Ghi

Tên chung dự kiến của TargetEndpoint. Điều này chỉ có ý nghĩa khi TargetEndpoint là một điểm cuối TLS/SSL.

 Yêu cầu proxy
target.host Chuỗi Chỉ đọc

Tên miền của dịch vụ đích trả về phản hồi cho proxy API.

 Câu trả lời mục tiêu
target.ip Chuỗi Chỉ đọc

Địa chỉ IP của dịch vụ đích trả về phản hồi cho proxy API.

 Câu trả lời mục tiêu
target.locality Chuỗi Chỉ đọc

Thành phố (thành phố) của chứng chỉ TLS/SSL do máy chủ đích cung cấp

 Câu trả lời mục tiêu
target.name Chuỗi Chỉ đọc

Mục tiêu mà thông báo đang tiếp cận từ điểm cuối đích.

 Yêu cầu mục tiêu
target.organization Chuỗi Chỉ đọc

Tổ chức chứng chỉ TLS/SSL do máy chủ đích cung cấp.

 Câu trả lời mục tiêu
target.organization.unit Chuỗi Chỉ đọc

Đơn vị tổ chức của chứng chỉ TLS/SSL do máy chủ đích cung cấp.

 Câu trả lời mục tiêu
target.port Số nguyên Chỉ đọc

Số cổng của dịch vụ đích trả về phản hồi cho proxy API.

 Câu trả lời mục tiêu
target.received.end.time Chuỗi Chỉ đọc

Thời gian được biểu thị dưới dạng chuỗi mà tại đó TargetEndpoint hoàn tất việc nhận được phản hồi của mục tiêu. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC".

Giá trị thời gian này là chuỗi đại diện của dấu thời gian 32 bit tương ứng số lượng. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC" tương ứng với giá trị dấu thời gian trong số "1377112607413".

 Câu trả lời mục tiêu
target.received.end.
  timestamp		 Dài Chỉ đọc

Giá trị dấu thời gian chỉ định thời điểm TargetEndpoint nhận được phản hồi khỏi mục tiêu. Ví dụ: "1534783015000". Giá trị này là một số nguyên 64 bit (dài) chỉ định số mili giây đã trôi qua kể từ nửa đêm, ngày 1 tháng 1 năm 1970 (theo giờ UTC).

 Câu trả lời mục tiêu
target.received.start.time Chuỗi Chỉ đọc

Thời gian được biểu thị dưới dạng chuỗi mà tại đó TargetEndpoint bắt đầu nhận được phản hồi của mục tiêu. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC".

Giá trị thời gian này là chuỗi đại diện của dấu thời gian 32 bit tương ứng số lượng. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC" tương ứng với giá trị dấu thời gian trong số "1377112607413".

 Câu trả lời mục tiêu
target.received.start.
  timestamp		 Dài Chỉ đọc

Giá trị dấu thời gian chỉ định thời điểm TargetEndpoint bắt đầu nhận được phản hồi khỏi mục tiêu. Ví dụ: "1534783015000". Giá trị này là một số nguyên 64 bit (dài) chỉ định số mili giây đã trôi qua kể từ nửa đêm, ngày 1 tháng 1 năm 1970 (theo giờ UTC).

 Câu trả lời mục tiêu
target.scheme Chuỗi Chỉ đọc

Phạm vi bắt đầu: Phản hồi mục tiêu
Loại: Chuỗi
Quyền: Đọc/Ghi

Trả về http hoặc https tuỳ thuộc vào thông báo yêu cầu.

 Yêu cầu mục tiêu
target.sent.end.time Chuỗi Chỉ đọc

Thời gian được biểu thị dưới dạng chuỗi mà tại thời điểm proxy ngừng gửi yêu cầu đến URL được chỉ định trong TargetEndpoint. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC".

Giá trị thời gian này là chuỗi đại diện của dấu thời gian 32 bit tương ứng số lượng. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC" tương ứng với giá trị dấu thời gian trong số "1377112607413".

 Yêu cầu mục tiêu
target.sent.end.timestamp Dài Chỉ đọc

Giá trị dấu thời gian chỉ định thời điểm proxy hoàn tất gửi yêu cầu tới URL được chỉ định trong TargetEndpoint. Ví dụ: "1377112607413". Giá trị này là 64 bit số nguyên (dài) chứa số mili giây đã trôi qua kể từ nửa đêm, ngày 1 tháng 1, 1970 (giờ UTC)

 Yêu cầu mục tiêu
target.sent.start.time Chuỗi Chỉ đọc

Thời gian được biểu thị dưới dạng chuỗi mà tại thời điểm proxy bắt đầu gửi yêu cầu đến URL được chỉ định trong TargetEndpoint. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC".

Giá trị thời gian này là chuỗi đại diện của dấu thời gian 32 bit tương ứng số lượng. Ví dụ: "Wed, 21 Aug 2013 19:16:47 UTC" tương ứng với giá trị dấu thời gian trong số "1377112607413".

 Yêu cầu mục tiêu
target.sent.start.timestamp Dài Chỉ đọc

Giá trị dấu thời gian chỉ định thời điểm proxy bắt đầu gửi yêu cầu đến URL được chỉ định trong TargetEndpoint. Ví dụ: "1534783015000". Giá trị này là 64 bit số nguyên (dài) chỉ định số mili giây đã trôi qua kể từ nửa đêm, vào Ngày 1 tháng 1 năm 1970 (theo giờ UTC)

 Yêu cầu mục tiêu
target.ssl.enabled Boolean Chỉ đọc

Liệu TargetEndpoint có đang chạy trên TLS/SSL hay không.

 Yêu cầu proxy
target.state Chuỗi Chỉ đọc

Trạng thái của chứng chỉ TLS/SSL do máy chủ đích hiển thị.

 Câu trả lời mục tiêu
target.url Chuỗi Đọc/Ghi

URL được định cấu hình trong tệp XML TargetEndpoint hoặc URL mục tiêu động (nếu target.url được đặt trong luồng thông báo). Biến này không bao gồm bất kỳ các phần tử đường dẫn hoặc tham số truy vấn bổ sung. Trả về giá trị rỗng nếu được gọi ngoài phạm vi hoặc nếu không được đặt.

 Yêu cầu mục tiêu

variable

Vùng chứa cho thuộc tính variable.expectedcn.

Bảng sau đây mô tả các thuộc tính của biến variable:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
variable.expectedcn Chuỗi Đọc/Ghi

Biến được hiển thị cho tên thường gọi nếu đang chạy trên TLS/SSL.

 Yêu cầu proxy

Để biết thêm thông tin về cách làm việc với TLS, hãy xem Giới thiệu về TLS/SSL.

virtualhost

Chỉ định thông tin chi tiết về máy chủ ảo.

Bảng sau đây mô tả các thuộc tính của biến virtualhost:

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
virtualhost.aliases.values Mảng chuỗi Chỉ đọc

Bí danh máy chủ lưu trữ của máy chủ ảo được truy cập trong một yêu cầu cụ thể.

 Yêu cầu proxy
virtualhost.name Chuỗi Chỉ đọc

Tên của máy chủ lưu trữ ảo phân phát yêu cầu máy khách ban đầu.

 Yêu cầu proxy
virtualhost.ssl.enabled Boolean Chỉ đọc

Trả về "true" nếu TLS/SSL được bật trong cấu hình máy chủ ảo.

 Yêu cầu proxy

Để biết thêm thông tin về cách làm việc với máy chủ ảo, hãy xem Định cấu hình máy chủ ảo.