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

Mỗi biến này được mô tả trong các phần tiếp theo.

apigee

Một 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:

Tài sản Loại Đọc/ghi Nội dung 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. Áp dụng 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:

Tài sản Loại Đọc/ghi Nội dung mô tả Phạm vi bắt đầu
apiproxy.name Chuỗi Chỉ đọc Tên của proxy API. Ví dụ: "My Proxy". 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 phần 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:

Tài sản Loại Đọc/ghi Nội dung 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:

Tài sản Loại Đọc/ghi Nội dung mô tả Phạm vi bắt đầu
client.cn Chuỗi Chỉ đọc

Tên thông thường được chỉ định trong chứng chỉ TLS/SSL mà ứng dụng 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 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 ứng dụng 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 gốc hoặc IP của 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 mà khách hàng xuất trình.

Yêu cầu proxy
client.organization Chuỗi Chỉ đọc Tổ chức trong chứng chỉ TLS/SSL mà ứng dụng giới thiệu. (Không nhất thiết phải tương đương với tổ chức sử dụng 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à ứng dụng cung cấp.

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

Cổng HTTP được liên kết với yêu cầu ứng dụng 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 ban đầu tại ProxyEndpoint. Ví dụ: Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 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 nhận được yêu cầu từ ứng dụng ban đầu 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 (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 khi proxy bắt đầu nhận yêu cầu từ ứng dụng ban đầu tại ProxyEndpoint. Ví dụ: Thứ Tư, ngày 21 tháng 8 năm 2013 19:16:47 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 ban đầu 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 (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 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ưới dạng chuỗi mà khi đó proxy hoàn tất gửi phản hồi từ ProxyEndpoint đến ứng dụng. Ví dụ: "Wed, 21 August 2013 19:16:47 UTC".

Giá trị này là một chuỗi đại diện của 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 trả về phản hồi cho ứng dụng 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, vào ngày 1 tháng 1 năm 1970 (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ụ: "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 của 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 Thời điểm 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 (giờ UTC). PostClientFlow
client.ssl.enabled Chuỗi Chỉ đọc

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

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ề quy trình proxy API hiện tại.

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

Tài sản Loại Đọc/ghi Nội dung 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ả luồng hiện đ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 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, theo mặc định, các thuộc tính này không hiển thị trong khung hiển thị Theo dõi của giao diện người dùng kiểu cũ.

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:

Tài sản Loại Đọc/ghi Nội dung 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 đã thực hiện. Yêu cầu proxy

error

Một đối tượng theo ngữ cảnh đại diện cho một 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:

Tài sản Loại Đọc/ghi Nội dung 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 quan đến một lỗi có giá trị chỉ có sẵn trước khi thực thi Luồng lỗi.

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ừ nguyên nhân 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

Mọi lỗi thuộc 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 thiết lập 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 chính sách báo lỗi. Mỗi chính sách sẽ có các giá trị mã lỗi riêng.

Tài sản Loại Đọc/ghi Nội dung 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:

Tài sản Loại Đọc/ghi Nội dung 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:

Tài sản Loại Đọc/ghi Nội dung mô tả Phạm vi bắt đầu
loadbalancing.failedservers Mảng chuỗi Chỉ đọc

Danh sách các TargetServer bị lỗi 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ỉ thiết lập nếu phần tử <Path> được đặt trong khi xác định phần tử cân bằng tải.

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

message

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

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

Tài sản Loại Đọc/ghi Nội dung 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 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ô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ả thông số hình dạng 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ì sau khi đọc, bạn sẽ chỉ nhận được đoạn văn bản tính đến dấu phẩy đầu tiên. 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 đề cụ 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. Lưu ý rằng chỉ mục có giá trị được sử 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 sẽ 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, 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 thư đượ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", thì giá trị trả về của message.queryparam.a.1 là "hello".

Ví dụ về việc 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 các giá trị sau:

  • message.queryparam.type.1 thành "siteid:1"
  • message.queryparam.type.2 thành "language:en-us"
  • 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 sẽ là "['hello', 'world']".

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

Tổng số tham số truy vấn được chỉ định được 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ả 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.

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

Danh sách tất cả cá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.

Để lặp lại 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 để bạn lặp lại Bộ sưu tập từ "request.queryparams.names" trong JS? trong Cộng đồng API.

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 được 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

Cụm từ 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ừ mục tiêu.

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 ngữ cảnh.

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

Đường dẫn đầy đủ của URI (theo sau URL miền) bao gồm 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.) liên quan đến 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.

Yêu cầu proxy

Để biết thêm thông tin về thông báo, hãy xem phần Tài liệu tham khảo về 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 hệ thống của yêu cầu.

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

Tài sản Loại Đọc/ghi Nội dung 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 của yêu cầu, bao gồm cả tên máy chủ lưu trữ bộ định tuyến. Mã nhận dạng 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 gửi đến bộ xử lý thông báo.

Mã nhận dạng này được ghi vào nhật ký lỗi của Edge để tương quan 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:

Tài sản Loại Đọc/ghi Nội dung 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 phần 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:

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

Trong URL "http://myorg-test.apigee.net/v2/thờiapi/fallbackrss?w=12797282":

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

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

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

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 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ở của 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 nhận dạng 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à mọi tham số truy vấn.

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

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 có sẵn. 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 phần 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 phần 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:

Tài sản Loại Đọc/ghi Nội dung 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

Nhận hoặc đặt trọng tải 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 đã chỉ định trong yêu cầu được gửi từ ứng dụng.

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 được phân tách bằng dấu phẩy.

Ví dụ: nếu tải trọng là "a=hello&x=chào&a=world", thì giá trị của request.formparam.a.values sẽ 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 đã 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 thông số biểu mẫu cụ 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ả 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 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ể có trong yêu cầu. Nếu tiêu đề chứa dấu phẩy, thì sau khi đọc, bạn sẽ chỉ nhận được đoạn văn bản tính đến dấu phẩy đầu tiên.

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 đề 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. 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ả 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ả 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 hỗ trợ (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ụ: của URI cho 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 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ề của request.queryparam.a.1 sẽ là "hello".

Ví dụ về việc 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 các giá trị sau:

  • request.queryparam.type.1 thành "siteid:1"
  • request.queryparam.type.2 thành "language:en-us"
  • 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 được 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 sẽ 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

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 tên tham số truy vấn bằng JavaScript, hãy xem phần Làm cách nào để bạn lặp lại Bộ sưu tập từ "request.queryparams.names" trong JS? trong Cộng đồng API.

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ã nhận dạng 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 Thư truyền tải Chỉ đọc

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

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

Trong một proxy API, <BasePath> proxy trong ProxyEndpoint (ngoài URL cơ sở của proxy) sẽ ánh xạ tới URL dịch vụ mục tiêu trong TargetEndpoint. Ví dụ:

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

Trỏ đến

<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ả 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 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 đây được thực hiện cho proxy mẫu của chúng ta, 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

URL này gắn thêm "/user?user=Dude" vào URL đó.

  • Yêu cầu: request.uri = "/my-mock-proxy/user?user=Dude"
  • Trả lờ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 hoàn chỉnh 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 cuộc 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ị là:

  • Yêu cầu: Không áp dụng
  • Trả lờ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:

Tài sản Loại Đọc/ghi Nội dung mô tả Phạm vi bắt đầu
response message Đọc/ghi

Mục tiêu trả về tin nhắn phản hồi hoàn chỉnh.

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 được 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 tham 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 tham 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

Tổng số tất cả các dạng tham số trong phản hồ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ả tham 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

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

Nếu văn bản tiêu đề có 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 đã chỉ định để 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 đã chỉ định để 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ể 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. 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".

Câu trả lờ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.

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ừ 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, hãy 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ề.

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:

Tài sản Loại Đọc/ghi Nội dung 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". NavigationRule tham chiếu đến một 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 còn dùng nữa.

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

Tài sản Loại Đọc/ghi Nội dung 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 Chú thích dịch vụ.

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

Tài sản Loại Đọc/ghi Nội dung 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 như đã đề cập trong chính sách về Chính sách chú thích dịch vụ. Đ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 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 về Chính sách chú thích dịch vụ. 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:

Tài sản Loại Đọc/ghi Nội dung 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 mà 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 điểm biến này được đọc. 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

Ngày trong phần 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 biến này được đọc. 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 (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:

Tài sản Loại Đọc/ghi Nội dung 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 giá trị là "true", yêu cầu được chuyển tiếp từ ProxyEndpoint đến TargetEndpoint sẽ giữ lại hậu tố của đường dẫn (phân đoạn đườ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 giá trị này là "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ủ đích cung cấp

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

Tên phổ biế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 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ủ đí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 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.

Câu trả lờ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.

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 xuất hiện

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.

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ụ mục tiêu 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 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".

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 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 (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 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".

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 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 (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 khi 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 gửi xong 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 (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ụ: "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à 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 (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 mà 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 bạn đặt target.url trong quy trình thông báo). Biến này không bao gồm bất kỳ phần tử đường dẫn hay tham số truy vấn bổ sung nào. Trả về giá trị rỗng nếu được gọi nằm 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:

Tài sản Loại Đọc/ghi Nội dung mô tả Phạm vi bắt đầu
variable.expectedcn Chuỗi Đọc/ghi

Biến được hiển thị cho tên thật nếu biến đó đ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 phần 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:

Tài sản Loại Đọc/ghi Nội dung 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ữ bị 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 ứng dụng 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 phần Định cấu hình máy chủ ảo.