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 flow.

Apigee Edge xác định các biến flow sau:

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

Mỗi 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 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 bài viết 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 đến 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 chung đượ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 do ứng dụng khách cung cấp.

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

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

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

Địa chỉ IP máy chủ HTTP 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 ứng dụng khách hoặc hệ thống gửi thông báo đến bộ định tuyến Edge. Ví dụ: đây có thể là IP ứng dụng khách ban đầu hoặc IP bộ cân bằng tải.

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

Vị trí (Thành phố) trong chứng chỉ TLS/SSL do ứng dụng khách cung cấp.

Yêu cầu proxy
client.organization Chuỗi Chỉ đọc Tổ chức trong chứng chỉ TLS/SSL do ứng dụng khách cung cấp. (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 do ứng dụng trình bày.

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 ban đầu của ứng dụng đến ProxyEndpoint.

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

Thời gian, được biểu thị ở dạng chuỗi, tại thời điểm proxy hoàn tất việc nhận yêu cầu từ ứng dụng gốc 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 cho số lượng dấu thời gian 32 bit tương ứng. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ UTC)" tương ứng với giá trị dấu thời gian là 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 hoàn tất việc nhận yêu cầu từ ứng dụng gốc tại ProxyEndpoint. Giá trị này là một số nguyên 64 bit (dài) 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ạng chuỗi, tại thời điểm proxy bắt đầu nhận được yêu cầu từ ứng dụng gốc 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 cho số lượng dấu thời gian 32 bit tương ứng. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ UTC)" tương ứng với giá trị dấu thời gian là 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ừ ứng dụng gốc tại ProxyEndpoint. Giá trị này là một số nguyên 64 bit (dài) 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 thông báo 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ạng chuỗi, tại thời điểm proxy hoàn tất việc gửi phản hồi từ ProxyEndpoint đến ứng dụng khách. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ UTC)".

Giá trị này là một chuỗi đại diện cho client.sent.end.timestamp 32 bit tương ứng. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ 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 hoàn tất việc trả về phản hồi cho ứng dụng khách ban đầu. Giá trị này là một số nguyên 64 bit (dài) 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ạng chuỗi, khi ProxyEndpoint bắt đầu trả về phản hồi cho ứng dụng khách ban đầu. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ UTC)".

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

PostClientFlow
client.sent.start.timestamp Dài Chỉ đọc Khi proxy bắt đầu gửi phản hồi đến ứng dụng từ ProxyEndpoint. Giá trị này được biểu thị dưới dạng số nguyên 64 bit (dài) 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

"true" nếu ProxyEndpoint được định cấu hình cho TLS/SSL; nếu không thì "false".

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

Trạng thái trong chứng chỉ TLS/SSL do ứng dụng khách trình bày.

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 flow đang thực thi (chẳng hạn như "PreFlow", "PostFlow" hoặc tên của flow có điều kiện). Yêu cầu proxy
current.flow.description Chuỗi Chỉ đọc Nội dung mô tả về luồng đang thực thi. Giá trị này giống với giá trị của phần tử <Description> trong cấu hình XML của flow. Yêu cầu proxy

Bạn có thể xem các thuộc tính này trong chế độ xem Dấu vết của giao diện người dùng Edge. Tuy nhiên, theo mặc định, các thuộc tính này sẽ không hiển thị 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 mà giao dịch chạy trong đó. Yêu cầu proxy

error

Một đố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à một đối tượng theo ngữ 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 kết với một lỗi, giá trị của thông báo này chỉ có sẵn trước khi Luồng lỗi đượ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ụ: "Bad Request" (Yêu cầu không hợp lệ).

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

Mọi lỗi thuộc loại TransportMessage.

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

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

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

Lấy hoặc đặt tiêu đề phản hồi.

Lỗi

fault

Biến flow được đặt thành mã lỗi thời gian chạy khi một chính sách gửi lỗi. Giá trị mã lỗi dành riêng cho từng chính sách.

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 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

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 TargetServer không thành công trong quá trình cân bằng tải tại TargetEndpoint.

Phản hồi mục tiêu
loadbalancing.isfallback Boolean Chỉ đọc

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

Phản hồ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 bạn đặt phần tử <Path> trong khi xác định phần tử bộ cân bằng tải.

Phản hồi mục tiêu

message

Một đối tượng theo ngữ cảnh, có cùng giá trị với request trong luồng yêu cầu hoặc response trong luồng phản hồi hoặc error trong luồng lỗi.

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

Một đối tượng theo ngữ cảnh, có cùng giá trị với request trong Luồng yêu cầu hoặc response trong Luồng phản hồi hoặc error trong Luồng lỗi.

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 tham 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 tham 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 các tham số biểu mẫu đã chỉ định trong thông báo./p>

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

Số lượng tất cả tham số biểu mẫu trong thông báo.

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

Giá trị của tất cả các tham 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 đặt 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, thì khi đọc, bạn sẽ chỉ nhận được đoạn văn bản cho đến dấu phẩy đầu tiên. Nếu bạn muốn 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 tiêu đề cụ thể thứ N trong thông báo, yêu cầu hoặc phản hồi, tuỳ 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. Xin lưu ý rằng chỉ mục có giá trị được dùng cho N là dựa trên 1, chứ không phải 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 đầy đủ của thông báo yêu cầu trong URL, ngoại trừ 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 thông báo đã 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 thứ N trong thông báo. Ví dụ: nếu request.querystring là "a=hello&a=world", thì giá trị trả về của message.queryparam.a.1 là "hello".

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", hãy đặt như sau:

  • message.queryparam.type.1 thành "siteid:1"
  • message.queryparam.type.2 thành "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 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 của một tham số truy vấn được chỉ định liên kết với yêu cầu được gửi đến ProxyEndpoint từ ứng dụng khách.

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

Tổng số tất cả các tham số truy vấn liên kết với yêu cầu được gửi đến ProxyEndpoint từ ứ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 từ ứng dụng khách.

Để lặp lại các tên tham số truy vấn bằng JavaScript, hãy xem bài đăng sau đây trên Cộng đồng Apigee: Làm cách nào để lặp lại Tập hợ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ị tham số truy vấn liên kết với 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

ReasonPhrase của thông báo phản hồi từ mục tiêu.

Phản hồ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ừ mục tiêu.

Phản hồi mục tiêu
message.transport.message TransportMessage Chỉ đọc

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

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

Đường dẫn URI hoàn chỉnh (theo sau URL miền) bao gồm 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.) 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 liên kết với yêu cầu được gửi đến ProxyEndpoint từ ứng dụng khách.

Yêu cầu proxy

Để biết thêm thông tin về thông báo, hãy xem nội dung Tham khảo hàm mẫu thông báo.

messageid

Vùng chứa cho mã nhận dạng duy nhất trên toàn cầu của 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

Chứa mã nhận dạng duy nhất trên toàn cầu 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 các yêu cầu đó được gửi đến trình xử lý thông báo.

Mã nhận dạng này được ghi lại trong nhật ký lỗi Edge để liên kết messageid với các lỗ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 bài viết Tìm hiểu về tổ chức.

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. Đường dẫn cơ sở là mảnh URI theo sau máy chủ lưu trữ trong URL. URI luồng có điều kiện tuân theo đường dẫn cơ sở.

Trong URL "http://myorg-test.apigee.net/v2/weatherapi/forecastrss?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 để biết điều này là xem định nghĩa proxy API hoặc kiểm tra giá trị của biến proxy.basepath. Hậu tố đường dẫn proxy tuân theo đường dẫn cơ sở ("/forecastrss"), cùng với mọi thông số truy vấn.

Nếu bạn xác định Đường dẫn cơ sở động trong cấu hình proxy API, chẳng hạn như "/v2/*/weatherapi", thì biến này sẽ được đặt thành đường dẫn động ("/v2/*/weatherapi"), mặc dù đường dẫn cơ sở phân giải thành một giá trị tĩnh, chẳng hạn như "/v2/foo/weatherapi".

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à Edge nhận được từ lần bắt tay TCP bên ngoài gần đây nhất. Đây có thể là ứng dụng gọi hoặc bộ 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ở của proxy API được gửi từ ứng dụng và nhận được tại ProxyEndpoint.

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

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

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

Lấy URL đầy đủ 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 chuỗi proxy.

Để biết ví dụ về cách tạo URL request bằng máy chủ lưu trữ ban đầu, hãy xem phần Thông báo yêu cầu truy cập.

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 bài viết Tìm hiểu về API và proxy API.

ratelimit

Được điền khi chính sách Hạn mức hoặc SpikeArrest thực thi.

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

Thuộc tính Loại Đọc/Ghi Mô tả Phạm vi bắt đầu
ratelimit.policy_name.allowed.count Dài Chỉ đọc Trả về số lượng hạn mức được phép. PostClientFlow
ratelimit.policy_name.used.count Dài Chỉ đọc Trả về hạn mức hiện tại được sử dụng trong một khoảng thời gian của hạn mức. PostClientFlow
ratelimit.policy_name.available.count Dài Chỉ đọc Trả về số lượng hạn mức hiện có trong khoảng thời gian hạn mức. PostClientFlow
ratelimit.policy_name.exceed.count Dài Chỉ đọc Trả về 1 sau khi vượt quá hạn mức. PostClientFlow
ratelimit.policy_name.total.exceed.count Dài Chỉ đọc Trả về 1 sau khi vượt quá hạn mức. PostClientFlow
ratelimit.policy_name.expiry.time Dài Chỉ đọc

Trả về thời gian theo giờ UTC (tính bằng mili giây), giúp xác định thời điểm hạn mức hết hạn và thời điểm bắt đầu khoảng thời gian hạn mức mới.

Khi loại của Chính sách hạn mức là rollingwindow, giá trị này sẽ không hợp lệ vì khoảng thời gian hạn mức không bao giờ hết hạn.

PostClientFlow
ratelimit.policy_name.identifier Chuỗi Chỉ đọc Trả về thông tin tham chiếu giá trị nhận dạng (ứng dụng khách) đính kèm với chính sách PostClientFlow
ratelimit.policy_name.class.allowed.count Dài Chỉ đọc Trả về số lượng hạn mức được phép xác định trong lớp PostClientFlow
ratelimit.policy_name.class.used.count Dài Chỉ đọc Trả về hạn mức đã sử dụng trong một lớp PostClientFlow
ratelimit.policy_name.class.available.count Dài Chỉ đọc Trả về số lượng hạn mức hiện có trong lớp PostClientFlow
ratelimit.policy_name.class.exceed.count Dài Chỉ đọc Trả về số lượng yêu cầu vượt quá giới hạn trong lớp trong khoảng thời gian hạn mức hiện tại PostClientFlow
ratelimit.policy_name.class.total.exceed.count Dài Chỉ đọc Trả về tổng số yêu cầu vượt quá giới hạn trong lớp trên tất cả các khoảng thời gian hạn mức, vì vậy, đây là tổng của class.exceed.count cho tất cả các khoảng thời gian hạn mức. PostClientFlow
ratelimit.policy_name.failed Boolean Chỉ đọc

Cho biết chính sách có được áp dụng hay không (true hoặc false).

PostClientFlow

Để biết thêm thông tin, hãy xem phần dưới đây:

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 phần Dữ liệu yêu cầu được truyề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 đặt 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 tham 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ả giá trị của một tham số biểu mẫu cụ thể trong yêu cầu, được định dạng dưới dạng danh sách phân tách bằng dấu phẩy.

Ví dụ: nếu tải trọng là "a=hello&x=greeting&a=world", thì 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

Số lượng tất cả giá trị cho tham số biểu mẫu đã chỉ định 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ể thứ N 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à "hello".

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

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

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

Danh sách tất cả tên tham số của 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 khách.

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 đặt giá trị của một tiêu đề cụ thể tìm thấy trong yêu cầu. Nếu tiêu đề chứa dấu phẩy, thì khi đọc, bạn sẽ chỉ nhận được đoạn văn bản cho đến dấu phẩy đầu tiên.

Nếu bạn muốn 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 tiêu đề cụ thể thứ N trong yêu cầu. Apigee Edge phân tách các giá trị văn bản tiêu đề bằng dấu phẩy. Xin lưu ý rằng chỉ mục có giá trị được dùng cho N là dựa trên 1, chứ không phải 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ả 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

Số lượng 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ả 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ủ lưu trữ) đến dịch vụ phụ trợ, ngoại trừ các tham số truy vấn.

Ví dụ: URI đến dịch vụ phụ trợ là "https://example.com/rest/api/latest", thì 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ó 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 thứ N trong yêu cầu.

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

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", hãy đặt như sau:

  • request.queryparam.type.1 thành "siteid:1"
  • request.queryparam.type.2 thành "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ả giá trị của một tham số truy vấn cụ thể trong yêu cầu, được định dạng dưới dạng danh sách phân tách bằng dấu phẩy.

Ví dụ: nếu request.querystring là "a=hello&b=lovely&a=world", thì 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

Số lượng 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

Số lượng 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 bài viết Bạn lặp lại Collection từ "request.queryparams.names" trong JS như thế nào? trong 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 khách.

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ã của yêu cầu dưới dạng loại TransportMessage, là một đối tượng theo ngữ cảnh.

Yêu cầu proxy
request.transport.message Transport-Message Chỉ đọc

Yêu cầu thuộc loại TransportMessage là một đối tượng theo ngữ cảnh.

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

Trong một proxy API, proxy <BasePath> trong ProxyEndpoint (ngoài URL cơ sở của proxy) sẽ liên kết đến URL dịch vụ mục tiêu 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ở của proxy + phần còn lại của địa chỉ, bao gồm cả cá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ả các tham số truy vấn, sau HTTPTargetConnection.

Sự khác biệt là do yêu cầu ban đầu đã được gửi đến proxy, nhưng sau đó proxy sẽ gửi một yêu cầu khác đến dịch vụ mục tiêu.

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

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

Và các lệnh gọi proxy:

http://mocktarget.apigee.net

Thao tác này sẽ thêm "/user?user=Dude" vào 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 nhau trong phản hồi)
request.url Chuỗi Chỉ đọc

URL đầy đủ của yêu cầu được gửi đến điểm cuối mục tiêu, bao gồm cả các 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 thực hiện lệnh gọi đến một proxy mẫu "http://my_org-test.apigee.net/my-mock-proxy/user?user=Dude" và điểm cuối mục tiêu là "http://example.com:8080", thì giá trị sẽ là:

  • Yêu cầu: không có
  • Phản hồi: "http://example.com/user?user=Dude"
Phản hồ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

Thông báo phản hồi đầy đủ do mục tiêu trả về.

Phản hồ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ề.

Phản hồi mục tiêu
response.formparam.param_name Chuỗi Đọc/Ghi

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

Phản hồi mục tiêu
response.formparam.param_name.
 values.count
Số nguyên Chỉ đọc

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

Phản hồi mục tiêu
response.formparams.count Số nguyên Chỉ đọc

Số lượng tất cả các tham số biểu mẫu trong phản hồi.

Phản hồi mục tiêu
response.formparams.names Bộ sưu tập Chỉ đọc

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

Phản hồi mục tiêu
response.header.header_name Chuỗi Đọc/Ghi

Lấy hoặc đặt giá trị của một tiêu đề HTTP đã chỉ định trong phản hồi.

Nếu văn bản tiêu đề có dấu phẩy, Apigee Edge sẽ suy luận 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.

Phản hồ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.

Phản hồi mục tiêu
response.header.header_name.
 values.count
Số nguyên Chỉ đọc

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

Phản hồi mục tiêu
response.header.header_name.N Chuỗi Đọc/Ghi

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

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

Phản hồi mục tiêu
response.headers.count Số nguyên Chỉ đọc

Số lượng tất cả tiêu đề trong phản hồi.

Phản hồ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.

Phản hồi mục tiêu
response.reason.phrase Chuỗi Đọc/Ghi

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

Phản hồ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, hãy xem message.

Phản hồ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 theo ngữ cảnh.

Phản hồ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ụ: "mặc định". RouteRule tham chiếu đến một TargetEndpoint 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 còn được 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 chính sách ServiceCallout.

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 ServiceCallout. Điều này chỉ có ý nghĩa khi TargetEndpoint tham chiếu đến một đ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 ServiceCallout cụ thể.

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

URI TargetEndpoint cho chính sách ServiceCallout. URI là URL TargetEndpoint không có thông số kỹ thuật về giao thức và miền.

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 vùng chứa nơi proxy đang chạy.

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

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

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

Thời gian đọc biến này. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ UTC)".

Giá trị này là chuỗi đại diện cho giá trị tương ứng của system.timestamp. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ 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 năm của system.time.

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

Phần 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

Phần 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) thể hiện thời gian đọc biến này. Giá trị này 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

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ụ mục tiêu, ngoại trừ các tham số truy vấn được xác định trong TargetEndpoint của proxy.

Ví dụ: giả sử một 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 "đúng", yêu cầu được chuyển tiếp từ ProxyEndpoint đến TargetEndpoint sẽ giữ lại hậu tố đường dẫn (mảnh đường dẫn URI theo URI được xác định trong đường dẫn cơ sở ProxyEndpoint).

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

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

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ủ mục tiêu cung cấp

Phản hồ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 tham chiếu đế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 do máy chủ mục tiêu cung cấp

Phản hồ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 tham chiếu đến 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ụ mục tiêu trả về phản hồi cho proxy API.

Phản hồi mục tiêu
target.ip Chuỗi Chỉ đọc

Địa chỉ IP của dịch vụ mục tiêu trả về phản hồi cho proxy API.

Phản hồi mục tiêu
target.locality Chuỗi Chỉ đọc

Vị trí (thành phố) của chứng chỉ TLS/SSL do máy chủ mục tiêu cung cấp

Phản hồi mục tiêu
target.name Chuỗi Chỉ đọc

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

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

Cách sắp xếp chứng chỉ TLS/SSL do máy chủ mục tiêu cung cấp.

Phản hồ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ủ mục tiêu cung cấp.

Phản hồi mục tiêu
target.port Số nguyên Chỉ đọc

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

Phản hồi mục tiêu
target.received.end.time Chuỗi Chỉ đọc

Thời gian, được biểu thị ở dạng chuỗi, tại thời điểm TargetEndpoint hoàn tất việc nhận phản hồi từ mục tiêu. 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 cho số lượng dấu thời gian 32 bit tương ứng. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ UTC)" tương ứng với giá trị dấu thời gian "1377112607413".

Phản hồ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 hoàn tất việc nhận phản hồi từ 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.

Phản hồi mục tiêu
target.received.start.time Chuỗi Chỉ đọc

Thời gian, được biểu thị ở dạng chuỗi, tại thời điểm TargetEndpoint bắt đầu nhận được phản hồi từ mục tiêu. 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 cho số lượng dấu thời gian 32 bit tương ứng. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ UTC)" tương ứng với giá trị dấu thời gian là "1377112607413".

Phản hồ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 từ 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.

Phản hồ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ạng chuỗi, tại thời điểm proxy ngừng gửi yêu cầu đến URL được chỉ định trong TargetEndpoint. 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 cho số lượng dấu thời gian 32 bit tương ứng. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ UTC)" tương ứng với giá trị dấu thời gian là "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 việc gửi yêu cầu đến URL được chỉ định trong TargetEndpoint. Ví dụ: "1377112607413". Giá trị này là một số nguyên 64 bit (dài) 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 mục tiêu
target.sent.start.time Chuỗi Chỉ đọc

Thời gian, được biểu thị ở dạng chuỗi, 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ụ: "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 cho số lượng dấu thời gian 32 bit tương ứng. Ví dụ: "Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 (giờ UTC)" tương ứng với giá trị dấu thời gian là "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à một số nguyên (dài) 64 bit 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.

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ủ mục tiêu cung cấp.

Phản hồ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 đích động (nếu bạn đặt target.url trong luồng thông báo). Biến này không bao gồm bất kỳ thành phần đường dẫn hoặc tham số truy vấn bổ sung nào. 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 chung nếu tên đó đang chạy trên TLS/SSL.

Yêu cầu proxy

Để biết thêm thông tin về cách sử dụng TLS, hãy xem phần Giới thiệu về TLS/SSL.

virtualhost

Chỉ định thông tin chi tiết về máy chủ lưu trữ ả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ủ ảo phân phát yêu cầu ban đầu của ứng dụng khách.

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ủ lưu trữ ảo, hãy xem phần Định cấu hình máy chủ lưu trữ ảo.