本頁適用於 Apigee 和 Apigee Hybrid。
查看
Apigee Edge 說明文件。
本節提供流程變數的參考資訊。
Apigee 定義了下列流程變數:
apigee
is
request
apiproduct
loadbalancing
response
apiproxy
message
route
client
messageid
servicecallout
current
mint
system
environment
organization
target
error
proxy
variable
fault
publishmessage
graphql
ratelimit
我們將在後續章節中說明每個變數。
apigee
輔助變數,提供政策執行時間的相關資訊。
下表說明 apigee
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
apigee.metrics.policy.policy_name.timeTaken |
整數 | 唯讀 | 政策執行所需的時間 (以奈秒為單位)。 | 政策 |
apiproduct
提供 API 產品資訊的輔助變數。
下表說明 apiproduct
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
apiproduct.operation |
字串 | 唯讀 |
API 產品的作業名稱。這個變數可協助您區分 配額政策的設定,以及 API 產品作業的配額設定。 例如 |
Proxy 要求 |
apiproduct.operation.resource |
字串 | 唯讀 |
與要求相符的作業資源名稱。 |
Proxy 要求 |
apiproduct.operation.methods |
陣列 | 唯讀 |
要比對的作業允許的 HTTP 方法陣列。 |
Proxy 要求 |
apiproduct.operation.attributes.key_name |
陣列 | 唯讀 |
取得與 key_name 相符的自訂屬性值。 |
Proxy 要求 |
如要瞭解詳情,請參考下列資源:
apiproxy
說明 API Proxy。
下表說明 apiproxy
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
apiproxy.name |
字串 | 唯讀 | API Proxy 的名稱。例如 My Proxy 。 |
Proxy 要求 |
apiproxy.revision |
字串 | 唯讀 | API Proxy 的修訂版本編號。例如 6 。 |
Proxy 要求 |
apiproxy.basepath |
字串 | 唯讀 | 部署基礎路徑 (在 API 部署期間指定)。 | Proxy 要求 |
如要進一步瞭解如何使用 API Proxy,請參閱「瞭解 API 和 API Proxy」。
client
向負載平衡器傳送要求的應用程式或系統。
下表說明 client
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
client.cn |
字串 | 唯讀 |
用戶端應用程式提供的 TLS/SSL 憑證中指定的一般名稱。 |
Proxy 要求 |
client.country |
字串 | 唯讀 |
用戶端應用程式提供的 TLS/SSL 憑證中所列的國家/地區。 |
Proxy 要求 |
client.email.address |
字串 | 唯讀 |
用戶端應用程式提供的 TLS/SSL 憑證中的電子郵件地址。 |
Proxy 要求 |
client.host |
字串 | 唯讀 |
與 ProxyEndpoint 收到的要求相關聯的 HTTP 主機 IP。 |
Proxy 要求 |
client.ip |
字串 | 唯讀 |
將訊息傳送至負載平衡器的用戶端或系統 IP 位址。例如,這可能是原始用戶端 IP 或負載平衡器 IP。 |
Proxy 要求 |
client.locality |
字串 | 唯讀 |
用戶端提供的 TLS/SSL 憑證中的地區 (城市)。 |
Proxy 要求 |
client.organization |
字串 | 唯讀 | 用戶端提供的 TLS/SSL 憑證中的機構。(不一定等同於 Apigee 中的機構)。 | Proxy 要求 |
client.organization.unit |
字串 | 唯讀 |
用戶端提供的 TLS/SSL 憑證中的機構單位。 |
Proxy 要求 |
client.port |
整數 | 唯讀 |
與 ProxyEndpoint 來源用戶端要求相關聯的 HTTP 通訊埠。 |
Proxy 要求 |
client.received.end.time |
字串 | 唯讀 |
代理程式在 ProxyEndpoint 上完成接收來自原始用戶端的要求時的時間,以字串形式表示。例如:2013 年 8 月 21 日星期三 19:16:47 UTC。 這個時間值是相應 32 位元時間戳記數量的字串表示法。舉例來說,2013 年 8 月 21 日星期三 19:16:47 (世界標準時間) 對應的時間戳記值為 1377112607413。 |
Proxy 要求 |
client.received.end.timestamp |
長 | 唯讀 |
時間戳記值,指定 ProxyEndpoint 在 Proxy 完成接收來自原始用戶端的要求時的時間。這個值是 64 位元 (長) 整數,包含自世界標準時間 1970 年 1 月 1 日午夜起經過的毫秒數。 |
Proxy 要求 |
client.received.start.time |
字串 | 唯讀 |
以字串形式表示的時間,Proxy 開始在 ProxyEndpoint 上接收來自原始用戶端的要求。例如:2013 年 8 月 21 日星期三 19:16:47 (世界標準時間) 這個時間值是相應 32 位元時間戳記數量的字串表示法。舉例來說,2013 年 8 月 21 日星期三 19:16:47 (世界標準時間) 對應的時間戳記值為 1377112607413。 |
Proxy 要求 |
client.received.start.timestamp |
長 | 唯讀 |
指定 ProxyEndpoint 開始接收原始用戶端要求的時間戳記值。這個值是 64 位元 (長) 整數,包含自世界標準時間 1970 年 1 月 1 日午夜起經過的毫秒數。 |
Proxy 要求 |
client.resolved.ip |
字串 | 唯讀 |
已解析的用戶端 IP 位址。這個值是根據已設定的用戶端 IP 解析設定,或是根據預設演算法 (如果未指定用戶端 IP 解析設定) 所決定。詳情請參閱「用戶端 IP 解析」。 |
Proxy 要求 |
client.scheme |
字串 | 唯讀 |
會根據用戶端應用程式用來傳送要求訊息的傳輸方式,傳回 HTTP 或 HTTPS。 |
Proxy 要求 |
client.sent.end.time |
字串 | 唯讀 |
以字串形式表示的時間,代表 ProxyEndpoint 完成將回應傳送至用戶端的時間。例如:2013 年 8 月 21 日星期三 19:16:47 世界標準時間。 這個值是相應 32 位元 |
PostClientFlow |
client.sent.end.timestamp |
長 | 唯讀 | 指定 ProxyEndpoint 完成將回應傳回給原始用戶端應用程式的時間戳記值。此值為 64 位元 (長) 整數,包含自 1970 年 1 月 1 日午夜起經過的毫秒數。 | PostClientFlow |
client.sent.start.time |
字串 | 唯讀 | ProxyEndpoint 開始將回應傳回給原始用戶端應用程式的時間,以字串形式表示。例如:2013 年 8 月 21 日星期三 19:16:47 世界標準時間。 這個值是相應 32 位元 |
PostClientFlow |
client.sent.start.timestamp |
長 | 唯讀 | Proxy 開始從 ProxyEndpoint 傳送回應給用戶端的時間。這個值以 64 位元 (長) 整數表示,包含自世界標準時間 1970 年 1 月 1 日午夜起經過的毫秒數。 | PostClientFlow |
client.ssl.enabled |
字串 | 唯讀 |
如果 ProxyEndpoint 已設定為 TLS/SSL,則為 |
Proxy 要求 |
client.state |
字串 | 唯讀 |
用戶端提供的 TLS/SSL 憑證中的狀態。 |
Proxy 要求 |
current
包含目前 API 代理程式流程的相關資訊。
下表說明 current
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
current.flow.name |
字串 | 唯讀 | 目前執行的資料流名稱 (例如 PreFlow 、PostFlow 或條件式資料流的名稱)。 |
Proxy 要求 |
current.flow.description |
字串 | 唯讀 | 目前執行流程的說明。這與流程 XML 設定中 <Description> 元素的值相同。 |
Proxy 要求 |
您可以在 Apigee UI 的「Trace」檢視畫面中查看這些屬性。
environment
environment.name
屬性的容器。
下表說明 environment
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
environment.name |
字串 | 唯讀 | 交易執行的環境名稱。 | Proxy 要求 |
error
在錯誤流程中代表錯誤訊息的內容物件。
下表說明 error
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
error |
message |
讀取/寫入 | 錯誤類型為 message ,這是錯誤流程中的內容物件。 |
錯誤 |
error.content |
字串 | 讀取/寫入 | 錯誤內容。 | 錯誤 |
error.message |
字串 | 唯讀 |
與錯誤相關聯的訊息,其值僅在執行錯誤流程前可用。 |
錯誤 |
error.status.code |
整數 | 唯讀 |
與錯誤相關聯的 HTTP 狀態碼。例如 |
錯誤 |
error.transport.message |
TransportMessage | 唯讀 |
任何 |
錯誤 |
error.state |
整數 | 唯讀 |
發生錯誤的流程中的狀態。 |
錯誤 |
error.header.header_name |
字串 | 讀取/寫入 |
取得或設定回應標頭。 |
錯誤 |
fault
提供執行階段錯誤來源、原因和詳細資料的相關資訊。Apigee 會在政策擲回錯誤時設定這些變數,且每項政策的值皆不相同。如要瞭解何時會設定 fault
變數,請參閱「
關於政策錯誤」。
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
fault.name |
字串 | 唯讀 | 錯誤名稱,請參閱各政策參考資料主題中的「執行階段錯誤」表格。這個變數可能適用於套用至 FaultRules 的條件。 | 錯誤 |
fault.reason |
字串 | 唯讀 | 錯誤的原因。舉例來說,當 OASValidation 政策偵測到傳入要求未依據 OpenAPI 規格進行驗證時,就會將這個變數設為字串,說明政策名稱、規格名稱,以及要求未依據規格驗證的詳細原因。其他政策會將這個變數設為錯誤訊息的適當訊息。 | 錯誤 |
fault.category |
字串 | 唯讀 | 類別。舉例來說,如果錯誤發生在政策步驟中,這個變數可能會保留「步驟」值。這個變數可能適用於套用至 FaultRules 的條件。 | 錯誤 |
fault.subcategory |
字串 | 唯讀 | 子類別。舉例來說,如果 OASValidation 政策偵測到要求未根據 OpenAPI 規格進行驗證,就會將這個變數設為「OASValidationFailure」。這個變數可能適用於套用至 FaultRules 的條件。 | 錯誤 |
graphql
可讓您在執行階段存取 GraphQL 查詢的結果。詳情請參閱 GraphQL 政策。
下表說明 graphql
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | |
---|---|---|---|---|
graphql |
複雜類型 | 唯讀/讀寫 | 根 GraphQL 查詢。 | SCOPE |
graphql.fragment |
複雜類型 | 唯讀/讀寫 | 這項查詢的預設片段參照。 | SCOPE |
graphql.fragment.count |
整數 | 唯讀 | 這個 GraqhQL 查詢產生的片段數量。 | SCOPE |
graphql.fragment.INDEX.selectionSet.INDEX |
類型 | 唯讀/讀寫 | 對指定索引的選取集參照。 | SCOPE |
graphql.fragment.INDEX.selectionSet.INDEX.name |
字串 | 唯讀/讀寫 | 指定索引的選取集名稱。 | SCOPE |
graphql.fragment.INDEX.selectionSet.count |
整數 | 唯讀 | 這個片段中的選取集數量。 | SCOPE |
graphql.fragment.INDEX.selectionSet.name |
字串 | 唯讀/讀寫 | 片段中預設選取集的名稱。 | SCOPE |
graphql.operation |
複雜類型 | 唯讀/讀寫 | 查詢的預設作業參照。 您無法在作業層級設定配額。請改為在環境層級設定這些屬性。 |
SCOPE |
graphql.operation.name |
字串 | 唯讀 | 查詢的預設作業名稱。 | SCOPE |
graphql.operation.operationType |
Enumeration | 唯讀 | 可對此 API Proxy 執行的查詢預設作業類型。可能的值為 query 、mutation 或 all 。 |
SCOPE |
graphql.operation.selectionSet |
複合類型 | 查詢的預設作業的預設選取集。 | SCOPE | |
graphql.operation.selectionSet.count |
整數 | 唯讀 | 查詢預設作業中的選取集數量。 | SCOPE |
graphql.operation.selectionSet.name |
字串 | 唯讀 | 查詢的預設作業的預設選取集合名稱。 | SCOPE |
graphql.operation.selectionSet.INDEX |
整數 | 唯讀 | 選取集清單中指定索引的選取集參照。 | SCOPE |
graphql.operation.selectionSet.INDEX.name |
字串 | 唯讀 | 此作業的選取集清單中,位於指定索引的選取項目名稱。 | SCOPE |
graphql.operation.selectionSet.INDEX.[selectionSet] |
複雜類型 | 唯讀/讀寫 | 一或多個額外的選取集物件。 可遞迴存取選取集。例如,在 | SCOPE |
graphql.operation.selectionSet.INDEX.directive |
複雜類型 | 指定選取集的預設指示語參照。 | SCOPE | |
graphql.operation.selectionSet.INDEX.directive.count |
複雜類型 | SCOPE | ||
graphql.operation.selectionSet.INDEX.directive.INDEX |
整數 | 唯讀 | 指定索引的指令參照。 | SCOPE |
graphql.operation.selectionSet.INDEX.directive.INDEX.argument.INDEX |
整數 | 唯讀 | 指定索引的引數參照。 | SCOPE |
graphql.operation.selectionSet.INDEX.directive.INDEX.argument.INDEX.name |
字串 | 指定索引的引數名稱。 | SCOPE | |
graphql.operation.selectionSet.INDEX.directive.INDEX.argument.INDEX.value |
字串 | 指定索引的引數值。 | SCOPE | |
graphql.operation.selectionSet.INDEX.directive.name |
字串 | SCOPE | ||
graphql.operation.variableDefinitions |
複雜類型 | 查詢預設運算的變數定義清單參照。 | SCOPE | |
graphql.operation.variableDefinitions.count |
整數 | 查詢預設作業的變數定義數量。 | SCOPE | |
graphql.operation.variableDefinitions.INDEX |
整數 | 指定索引的變數定義參照。 | SCOPE | |
graphql.operation.variableDefinitions.INDEX.name |
字串 | 指定索引的變數定義名稱。 | SCOPE | |
graphql.operation.variableDefinitions.INDEX.type |
指定索引的變數定義值類型。 | SCOPE |
is
is.error
屬性的容器。
下表說明 is
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
is.error |
布林值 | 唯讀 |
錯誤標記。 |
Proxy 要求 |
loadbalancing
提供 TargetEndpoint 的負載平衡狀態資訊。
下表說明 loadbalancing
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
loadbalancing.failedservers |
字串陣列 | 唯讀 |
在 TargetEndpoint 負載平衡期間,失敗的 TargetServer 清單。 |
目標回應 |
loadbalancing.isfallback |
布林值 | 唯讀 |
|
目標回應 |
loadbalancing.targetserver |
字串 | 唯讀 |
在 TargetEndpoint 上負載平衡期間叫用的 TargetServer。只有在定義負載平衡器元素時設定 |
目標回應 |
message
內容物件,其值與要求流程中的 request
相同,或與回應流程中的 response
相同,或與錯誤流程中的 error
相同。
下表說明 message
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
message |
message |
讀取/寫入 |
內容物件,其值與要求流程中的 |
Proxy 要求 |
message.content |
字串 | 讀取/寫入 |
要求、回應或錯誤訊息的內容。 |
Proxy 要求 |
message.content.as.base64 |
字串 | 唯讀 |
要求、回應或錯誤訊息的 Base64 編碼酬載內容。 |
Proxy 要求 |
message.content.as.url.safe.base64 |
字串 | 唯讀 |
要求、回應或錯誤訊息的網址安全 Base64 編碼酬載內容。 |
Proxy 要求 |
message.formparam.param_name |
字串 | 讀取/寫入 |
指定表單參數的值。 |
Proxy 要求 |
message.formparam.param_name. |
集合 | 唯讀 |
訊息中指定表單參數的所有值。 |
Proxy 要求 |
message.formparam.param_name. |
整數 | 唯讀 |
訊息中指定表單參數的值數量。 |
Proxy 要求 |
message.formparams.count |
整數 | 唯讀 |
訊息中所有表單參數的計數。 |
Proxy 要求 |
message.formparams.names |
集合 | 唯讀 |
訊息中所有表單參數的值。 |
Proxy 要求 |
message.formparams.names.string |
字串 | 唯讀 |
以半形逗號分隔的清單,列出郵件中的所有表單參數名稱。 |
Proxy 要求 |
message.formstring |
字串 | 唯讀 |
訊息中的表單字串值。 |
Proxy 要求 |
message.header.header_name |
字串 | 讀取/寫入 |
取得或設定要求中特定標頭的值。如果標頭包含半形逗號,您在讀取時只會收到文字的部分片段,直到遇到第一個半形逗號為止。 舉例來說,如果 如果您希望整個標頭都是字串,請使用 |
Proxy 要求 |
message.header.header_name.N |
字串 | 讀取/寫入 |
訊息中 第 N 個 特定標頭值的值,取決於流程狀態,可能是要求或回應。Apigee 會以半形逗號分隔標頭文字值。最左邊的值索引從 1 開始。 舉例來說,如果 |
Proxy 要求 |
message.header.header_name. |
集合 | 唯讀 |
訊息中指定的 HTTP 標頭名稱的所有值。 |
Proxy 要求 |
message.header.header_name. |
整數 | 唯讀 |
訊息中指定 HTTP 標頭名稱的值計數。 |
Proxy 要求 |
message.header.header_name. |
字串 | 唯讀 |
郵件中特定標頭的所有值,以單一字串的形式呈現。 舉例來說,如果 |
Proxy 要求 |
message.headers.count |
整數 | 唯讀 |
訊息中所有 HTTP 標頭的計數。 |
Proxy 要求 |
message.headers.names |
集合 | 唯讀 |
郵件中所有 HTTP 標頭的值。 |
Proxy 要求 |
message.headers.names.string |
字串 | 唯讀 |
以半形逗號分隔的清單,列出郵件中的所有標頭名稱。 |
Proxy 要求 |
message.path |
字串 | 讀取/寫入 |
網址中的完整要求訊息路徑,不含任何查詢參數。 |
Proxy 要求 |
message.queryparam.param_name |
字串 | 唯讀 |
傳回指定的訊息查詢參數。 |
Proxy 要求 |
message.queryparam.param_name.N |
字串 | 讀取/寫入 |
訊息中第 N 個查詢參數的值。舉例來說,如果 舉例來說,如要為單一查詢參數名稱 (例如
|
Proxy 要求 |
message.queryparam.param_name. |
集合 | 唯讀 |
訊息中特定查詢參數的所有值,格式為以半形逗號分隔的清單。 舉例來說,如果查詢字串為 |
Proxy 要求 |
message.queryparam.param_name. |
整數 | 唯讀 |
與從用戶端應用程式傳送至 ProxyEndpoint 的要求相關聯的指定查詢參數總數。 |
Proxy 要求 |
message.queryparams.count |
整數 | 唯讀 |
與從用戶端應用程式傳送至 ProxyEndpoint 的要求相關聯的所有查詢參數總數。 |
Proxy 要求 |
message.queryparams.names |
集合 | 唯讀 |
與從用戶端應用程式傳送至 ProxyEndpoint 的要求相關聯的所有查詢參數名稱清單。 |
Proxy 要求 |
message.queryparams.names.string |
字串 | 唯讀 |
以半形逗號分隔的清單,其中包含郵件中所有查詢參數的名稱。 |
Proxy 要求 |
message.querystring |
字串 | 唯讀 |
字串,其中包含與從用戶端應用程式傳送至 ProxyEndpoint 的要求相關聯的所有查詢參數名稱和值。 舉例來說,對於要求 |
Proxy 要求 |
message.status.code |
整數 | 唯讀 |
目標回應訊息的 HTTP 狀態碼。 |
目標回應 |
message.transport.message |
TransportMessage | 唯讀 |
訊息類型為 TransportMessage,這是內容物件。 |
Proxy 要求 |
message.uri |
字串 | 唯讀 |
完整的 URI 路徑 (位於網域網址之後),包括查詢參數。 舉例來說,對於 |
Proxy 要求 |
message.verb |
字串 | 唯讀 |
與要求相關聯的 HTTP 動詞 ( |
Proxy 要求 |
message.version |
字串 | 讀取/寫入 |
與從用戶端應用程式傳送至 ProxyEndpoint 的要求相關聯的 HTTP 版本。 |
Proxy 要求 |
如要進一步瞭解訊息,請參閱訊息範本函式參考資料。
messageid
要求的全域不重複 ID 容器。
下表說明 messageid
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
messageid |
字串 | 唯讀 |
保存要求的全域不重複 ID,其中包含負載平衡器主機名稱。這個 ID 可讓您在負載平衡器收到要求後,追蹤要求傳送至訊息處理程序的情況。 這個 ID 會記錄在 Apigee 錯誤記錄中,以便將 |
Proxy 要求 |
mint
提供營利資訊的輔助變數。
下表說明 mint
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
mint.limitscheck.is_request_blocked |
布林值 | 唯讀 |
此標記可指定 API 要求是否遭到封鎖。如果 如果 MonetizationLimitsCheck 政策已附加至 API 代理程式,則可使用這個流程變數。請參閱「在 API Proxy 中強制實行營利限制」。 |
Proxy 要求 |
mint.limitscheck.is_subscription_found |
布林值 | 唯讀 |
此標記可指定開發人員是否訂閱 API 產品。如果開發人員有訂閱,請設為 如果 MonetizationLimitsCheck 政策已套用至 API 代理程式,即可使用這個流程變數。請參閱「在 API Proxy 中強制實行營利限制」。 |
Proxy 要求 |
mint.limitscheck.prepaid_developer_balance |
數字 | 唯讀 |
開發人員的預付帳戶錢包中,與費率方案幣別相關聯的目前餘額。 |
Proxy 要求 |
mint.limitscheck.prepaid_developer_currency |
字串 | 唯讀 |
|
Proxy 要求 |
mint.limitscheck.purchased_product_name |
字串 | 唯讀 |
相關聯 API 產品的名稱。 如果 MonetizationLimitsCheck 政策已附加至 API 代理程式,則可使用這個流程變數。請參閱「在 API Proxy 中強制實行營利限制」。 |
Proxy 要求 |
mint.limitscheck.status_message |
字串 | 唯讀 |
執行營利限制檢查政策的其他資訊,可用於偵錯。 如果 MonetizationLimitsCheck 政策已套用至 API 代理程式,即可使用這個流程變數。請參閱「在 API Proxy 中強制實行營利限制」。 |
Proxy 要求 |
mint.mintng_consumption_pricing_rates |
字串 | 唯讀 |
按用量計費。 建立費率方案時設定費用。 |
PostClientFlow |
mint.mintng_consumption_pricing_type |
字串 | 唯讀 |
根據用量計費的定價類型。例如: 建立費率方案時,請設定以用量為準的費用。 |
PostClientFlow |
mint.mintng_currency |
字串 | 唯讀 |
計算收益時使用的幣別。 這個流程變數的值為 |
DataCapture 政策 |
mint.mintng_dev_share |
數字 | 唯讀 |
與開發人員分享的收益。 建立費率方案時,請設定要與開發人員分享的收益。 |
PostClientFlow |
mint.mintng_is_apiproduct_monetized |
布林值 | 唯讀 |
此標記可指定 API 產品目前是否已營利 (也就是是否有有效的費率方案)。 這個流程變數是由附加至 API Proxy 的 VerifyAPIKey 或 VerifyAccessToken 政策新增。請參閱「新增驗證策略」一文。 |
Proxy 要求 |
mint.mintng_price |
數字 | 唯讀 |
用於計算開發人員分潤的收益。 資料流變數的值為 |
DataCapture 政策和 PostClientFlow |
mint.mintng_price_multiplier |
數字 | 唯讀 |
乘以此係數 (調節係數) 後,每筆交易的費用就會增加。 資料流變數的值為 |
DataCapture 政策和 PostClientFlow |
mint.mintng_rate |
數字 | 唯讀 |
API 呼叫的收費率。 這個流程變數會顯示每個 API 呼叫的消耗型收費。建立費率方案時,請設定以用量為準的費用。
如果您已在 DataCapture 政策中設定 |
PostClientFlow |
mint.mintng_rate_before_multipliers |
數字 | 唯讀 |
不含 如果 DataCapture 政策擷取 |
PostClientFlow |
mint.mintng_rate_plan_id |
字串 | 唯讀 |
房價方案的 ID。 這個流程變數是由附加至 API Proxy 的 VerifyAPIKey 或 VerifyAccessToken 政策新增。請參閱「新增驗證策略」一文。 |
Proxy 要求 |
mint.mintng_revenue_share_rates |
字串 | 唯讀 |
收益分潤費率。 建立費率方案時,請設定收益分潤率。 |
PostClientFlow |
mint.mintng_revenue_share_type |
字串 | 唯讀 |
收益分潤類型。例如: 建立費率方案時,請設定收益分潤類型。 |
PostClientFlow |
mint.mintng_tx_success |
布林值 | 唯讀 |
指定交易是否已營利。 這個流程變數的值為 |
DataCapture 政策 |
mint.prepaid_updated_developer_usage |
數字 | 唯讀 |
預付開發人員目前的用量。 系統會根據您的費率方案設定和 perUnitPriceMultiplier 營利變數的值來計算用量。 |
PostClientFlow |
mint.rateplan_end_time_ms |
數字 | 唯讀 |
費率方案的到期時間,以 Epoch 紀元時間後的毫秒為單位。 這個流程變數是由附加至 API Proxy 的 VerifyAPIKey 或 VerifyAccessToken 政策新增。請參閱「新增驗證策略」一文。 |
Proxy 要求 |
mint.rateplan_start_time_ms |
數字 | 唯讀 |
以 Epoch 紀元時間為起算點,以毫秒為單位的費率方案啟用時間。 這個流程變數是由附加至 API Proxy 的 VerifyAPIKey 或 VerifyAccessToken 政策新增。請參閱「新增驗證策略」一文。 |
Proxy 要求 |
mint.status |
字串 | 唯讀 |
營利通話的狀態。只有在發生錯誤時才會填入。 |
PostClientFlow |
mint.status_code |
數字 | 唯讀 |
已啟用營利功能的呼叫的 HTTP 狀態碼。只有在發生錯誤時才會填入。 |
PostClientFlow |
mint.subscription_end_time_ms |
數字 | 唯讀 |
API 產品訂閱項目的到期時間,自紀元時間起算,以毫秒為單位。 如果 MonetizationLimitsCheck 政策已附加至 API 代理程式,則可使用這個流程變數。請參閱「在 API Proxy 中強制實行營利限制」。 |
Proxy 要求 |
mint.subscription_start_time_ms |
數字 | 唯讀 |
自 Epoch 開始算起,API 產品訂閱項目的啟用時間 (以毫秒為單位)。 如果 MonetizationLimitsCheck 政策已附加至 API 代理程式,則可使用這個流程變數。請參閱「在 API Proxy 中強制實行營利限制」。 |
Proxy 要求 |
mint.tx_success_result |
布林值 | 唯讀 |
指出交易是否已成功營利。
|
PostClientFlow |
如要瞭解詳情,請參考下列資源:
organization
organization.name
屬性的容器。
下表說明 organization
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
organization.name |
字串 | 唯讀 |
機構名稱。 |
Proxy 要求 |
如要進一步瞭解機構,請參閱「瞭解機構」。
proxy
API Proxy 設定。
下表說明 proxy
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
proxy.basepath |
字串 | 唯讀 |
API 代理程式端點設定中「Base Path」的值。基本路徑是指網址中主機後方最左邊的 URI 片段。條件式流程 URI 會遵循基本路徑。 假設您已設定 API Proxy 端點,並將 basepath 設為
如果您在 API 代理程式設定中定義動態基本路徑 (例如 |
Proxy 要求 |
proxy.client.ip |
字串 | 唯讀 |
Inbound 呼叫的 |
Proxy 要求 |
proxy.name |
字串 | 唯讀 |
ProxyEndpoint 的名稱屬性。 |
Proxy 要求 |
proxy.pathsuffix |
字串 | 唯讀 |
從用戶端傳送並在 ProxyEndpoint 中收到的網址中路徑後置字串的值。 basepath 是位於最左邊的路徑元件,可用於唯一識別環境群組中的 API Proxy。假設您已設定 API Proxy 端點,並使用 |
Proxy 要求 |
proxy.url |
字串 | 唯讀 |
取得與 ProxyEndpoint 收到的 ProxyRequest 相關聯的完整網址,包括任何存在的查詢參數。 |
Proxy 要求 |
如要進一步瞭解如何使用 API Proxy,請參閱「瞭解 API 和 API Proxy」。
publishmessage
在執行 PublishMessage 政策時填入。
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
publishmessage.message.id | 字串 | 唯讀 | 傳回 Pub/Sub 伺服器中的 messageId (已發布訊息的 ID)。 只有在發布要求成功時,Apigee 才會設定這個流程變數。 |
Proxy 要求 |
ratelimit
在執行配額或 SpikeArrest 政策時填入。
下表說明 ratelimit
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
ratelimit.policy_name.allowed.count | 長 | 唯讀 | 傳回允許的配額數量。 | PostClientFlow |
ratelimit.policy_name.used.count | 長 | 唯讀 | 傳回在配額間隔內目前使用的配額。 | PostClientFlow |
ratelimit.policy_name.available.count | 長 | 唯讀 | 傳回配額間隔內的可用配額數量。 | PostClientFlow |
ratelimit.policy_name.exceed.count | 長 | 唯讀 | 超過配額後會傳回 1。 | PostClientFlow |
ratelimit.policy_name.total.exceed.count | 長 | 唯讀 | 超過配額後會傳回 1。 | PostClientFlow |
ratelimit.policy_name.expiry.time | 長 | 唯讀 |
傳回世界標準時間 (以毫秒為單位),用於決定配額到期時間和新配額間隔開始時間。 如果配額政策的類型為 |
PostClientFlow |
ratelimit.policy_name.identifier | 字串 | 唯讀 | 傳回附加至政策的 (用戶端) ID 參照 | PostClientFlow |
ratelimit.policy_name.class | 字串 | 唯讀 | 傳回與用戶端 ID 相關聯的類別 | PostClientFlow |
ratelimit.policy_name.class.allowed.count | 長 | 唯讀 | 傳回類別中定義的配額數量上限 | PostClientFlow |
ratelimit.policy_name.class.used.count | 長 | 唯讀 | 傳回類別中已使用的配額 | PostClientFlow |
ratelimit.policy_name.class.available.count | 長 | 唯讀 | 傳回類別中可用的配額數量 | PostClientFlow |
ratelimit.policy_name.class.exceed.count | 長 | 唯讀 | 傳回目前配額間隔中,超出類別限制要求的數量 | PostClientFlow |
ratelimit.policy_name.class.total.exceed.count | 長 | 唯讀 | 傳回在所有配額間隔中,超過類別上限要求的總數,也就是所有配額間隔的 class.exceed.count 總和。 |
PostClientFlow |
ratelimit.policy_name.failed | 布林值 | 唯讀 |
表示政策是否失敗 (true 或 false)。 |
PostClientFlow |
如要瞭解詳情,請參考下列資源:
request
完整要求,包括任何存在的酬載。
如要進一步瞭解要求資料,請參閱「如何將要求資料傳送至後端伺服器?」。
下表說明 request
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
request |
message |
唯讀 |
完整要求,包括任何存在的酬載。 |
Proxy 要求 |
request.content |
字串 | 讀取/寫入 |
取得或設定要求訊息的酬載。 |
Proxy 要求 |
request.content.as.base64 |
字串 | 唯讀 |
要求訊息的 Base64 編碼酬載內容。 |
Proxy 要求 |
request.content.as.url.safe.base64 |
字串 | 唯讀 |
要求訊息的網址安全 Base64 編碼酬載內容。 |
Proxy 要求 |
request.formparam.param_name |
字串 | 讀取/寫入 |
在用戶端應用程式傳送的要求中,取得或設定指定表單參數的值。 |
Proxy 要求 |
request.formparam.param_name. |
集合 | 唯讀 |
請求中特定表單參數的所有值,格式為以逗號分隔的清單。 舉例來說,如果酬載是 |
Proxy 要求 |
request.formparam.param_name. |
整數 | 唯讀 |
與要求相關聯的指定表單參數所有值的計數。 |
Proxy 要求 |
request.formparam.param_name.N |
字串 | 讀取/寫入 |
訊息中第 n 個特定表單參數的值。舉例來說,如果格式字串為 |
Proxy 要求 |
request.formparams.count |
整數 | 唯讀 |
與從用戶端應用程式傳送的要求相關聯的所有參數數量。 |
Proxy 要求 |
request.formparams.names |
集合 | 唯讀 |
與要求相關聯的所有參數名稱清單。 |
Proxy 要求 |
request.formparams.names.string |
字串 | 唯讀 |
以半形逗號分隔的清單,其中包含與要求相關聯的所有表單參數名稱。 |
Proxy 要求 |
request.formstring |
字串 | 唯讀 |
用戶端應用程式傳送要求中的完整 例如 |
Proxy 要求 |
request.grpc.rpc.name |
字串 | 唯讀 |
僅適用於使用 gRPC 目標伺服器時。RPC 名稱。如要瞭解 gRPC Proxy,請參閱「建立 gRPC API Proxy」。 |
Proxy 要求 |
request.grpc.service.name |
字串 | 唯讀 |
僅適用於使用 gRPC 目標伺服器時。gRPC 狀態服務名稱。如要瞭解 gRPC Proxy,請參閱「建立 gRPC API Proxy」。 |
Proxy 要求 |
request.header.header_name |
字串 | 讀取/寫入 |
取得或設定要求中特定標頭的值。如果標頭包含半形逗號,您在讀取時只會收到文字的部分片段,直到第一個半形逗號為止。 舉例來說,如果 如果您希望整個標頭都是字串,請使用 |
Proxy 要求 |
request.header.header_name.N |
字串 | 讀取/寫入 |
要求中第 N 個特定標頭值的值。Apigee 會以半形逗號分隔標頭文字值。最左邊的值索引從 1 開始。 舉例來說,如果 |
Proxy 要求 |
request.header.header_name. |
集合 | 唯讀 |
要求中特定標頭的所有值。 |
Proxy 要求 |
request.header.header_name. |
整數 | 唯讀 |
要求中特定標頭的所有值計數。 |
Proxy 要求 |
request.header.header_name. |
字串 | 唯讀 |
要求中特定標頭的所有值,以單一字串的形式呈現。 舉例來說,如果 |
Proxy 要求 |
request.headers.count |
整數 | 唯讀 |
要求中所有標頭的計數。 |
Proxy 要求 |
request.headers.names |
集合 | 唯讀 |
要求中所有標頭的名稱。 |
Proxy 要求 |
request.headers.names.string |
字串 | 唯讀 |
以半形逗號分隔的清單,列出要求中的所有標頭名稱。 |
Proxy 要求 |
request.path |
字串 | 唯讀 |
未經代理的後端服務資源路徑 (不含主機),不含查詢參數。 舉例來說,如果後端服務的 URI 是 |
Proxy 要求 |
request.queryparam.param_name |
字串 | 讀取/寫入 |
要求中找到的特定查詢參數值。 |
Proxy 要求 |
request.queryparam.param_name.N |
字串 | 讀取/寫入 |
請求中 Nth 查詢參數的值。 舉例來說,如果 舉例來說,如要為單一查詢參數名稱 (例如
|
Proxy 要求 |
request.queryparam.param_name. |
集合 | 唯讀 |
要求中特定查詢參數的所有值,格式為以逗號分隔的清單。 舉例來說,如果 |
Proxy 要求 |
request.queryparam.param_name. |
整數 | 唯讀 |
要求中特定查詢參數的所有值計數。 |
Proxy 要求 |
request.queryparams.count |
整數 | 唯讀 |
要求中所有查詢參數的數量。 |
Proxy 要求 |
request.queryparams.names |
集合 | 唯讀 |
要求中所有查詢參數的名稱。 |
Proxy 要求 |
request.queryparams.names.string |
字串 | 唯讀 |
以半形逗號分隔的清單,其中包含要求中的所有查詢參數名稱。 |
Proxy 要求 |
request.querystring |
字串 | 唯讀 |
用戶端應用程式傳送要求中的完整查詢參數清單。 舉例來說,如果要求是 |
Proxy 要求 |
request.transportid |
字串 | 唯讀 |
要求 ID,為 TransportMessage 類型,屬於情境。 |
Proxy 要求 |
request.transport.message |
Transport-Message | 唯讀 |
含有內容的 TransportMessage 類型要求。 |
Proxy 要求 |
request.uri |
字串 | 唯讀 |
在 API Proxy 中,ProxyEndpoint 中的 Proxy
指向
在要求中, 在回應中, 差異在於原始要求進入 Proxy,但 Proxy 會向目標服務提出另一項要求。 假設以下呼叫會傳送至範例 Proxy,該 Proxy 的基本路徑為
而 Proxy 呼叫如下:
這個方法會將
|
Proxy 要求 (回應不同) |
request.url |
字串 | 唯讀 |
對目標端點提出要求的完整網址,包括查詢字串參數,但不包含連接埠號碼 (如果有指定)。 舉例來說,如果您呼叫範例 Proxy
|
目標回應 |
request.verb |
字串 | 唯讀 |
用於要求的 HTTP 動詞。例如 |
Proxy 要求 |
request.version |
字串 | 唯讀 |
要求的 HTTP 版本。例如 |
Proxy 要求 |
response
完整回應,包括任何存在的酬載。
下表說明 response
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
response |
message |
讀取/寫入 |
目標傳回的完整回應訊息。 |
目標回應 |
response.content |
字串 | 讀取/寫入 |
目標傳回的回應訊息酬載內容。 |
目標回應 |
response.content.as.base64 |
字串 | 唯讀 |
回應訊息的 Base64 編碼酬載內容。 |
目標回應 |
response.content.as.url.safe.base64 |
字串 | 唯讀 |
回應訊息的網址安全 Base64 編碼酬載內容。 |
目標回應 |
response.header.header_name |
字串 | 讀取/寫入 |
在回應中取得或設定指定 HTTP 標頭的值。 如果標頭文字含有半形逗號,Apigee 會推斷多個值。在這種情況下, 舉例來說,如果 如果您希望整個標頭都是字串,請使用 |
目標回應 |
response.header.header_name. |
集合 | 唯讀 |
回應中指定 HTTP 標頭的所有值。 |
目標回應 |
response.header.header_name. |
整數 | 唯讀 |
回應中指定 HTTP 標頭的所有值計數。 |
目標回應 |
response.header.header_name. |
字串 | 唯讀 |
回應中特定標頭的所有值,以單一字串的形式呈現。 舉例來說,如果 |
目標回應 |
response.header.header_name.N |
字串 | 讀取/寫入 |
回應中 第 N 個 特定標頭值的值。Apigee 會以半形逗號分隔標頭文字值。最左邊的值索引從 1 開始。 舉例來說,如果 |
目標回應 |
response.headers.count |
整數 | 唯讀 |
回應中所有標頭的計數。 |
目標回應 |
response.headers.names |
集合 | 唯讀 |
回應中所有標頭的名稱。 |
目標回應 |
response.headers.names.string |
字串 | 唯讀 |
以半形逗號分隔的清單,列出回應中的所有標頭名稱。 |
目標回應 |
response.status.code |
整數 | 讀取/寫入 |
要求傳回的回應代碼。您可以使用這個變數覆寫儲存在 |
目標回應 |
response.transport.message |
字串 | 唯讀 |
回應的類型為 TransportMessage,這是一種內容物件。 |
目標回應 |
route
指定 <RouteRule>
和 TargetEndpoint 的名稱。
下表說明 route
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
route.name |
字串 | 唯讀 |
在 ProxyEndpoint 中執行的 |
目標要求 |
route.target |
字串 | 唯讀 |
已執行的 TargetEndpoint 名稱。例如 |
指定要求 |
servicecallout
說明 ServiceCallout 政策的 TargetEndpoint。
下表說明 servicecallout
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
servicecallout.policy_name.expectedcn |
字串 | 讀取/寫入 |
ServiceCallout 政策中所提及的 TargetEndpoint 預期通用名稱。只有在 TargetEndpoint 參照 TLS/SSL 端點時,這項屬性才有意義。 |
Proxy 要求 |
servicecallout.policy_name.target.url |
字串 | 讀取/寫入 |
特定 ServiceCallout 政策的 TargetEndpoint 網址。 |
Proxy 要求 |
servicecallout.requesturi |
字串 | 讀取/寫入 |
ServiceCallout 政策的 TargetEndpoint URI。URI 是 TargetEndpoint 網址,不含通訊協定和網域規格。 |
Proxy 要求 |
system
指定系統的 IP 位址,以及 Proxy 的詳細資料。
下表說明 system
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
system.interface.interface_name |
字串 | 唯讀 |
系統的 IP 位址。 |
Proxy 要求 |
system.pod.name |
字串 | 唯讀 |
執行 Proxy 的 Pod 名稱。 |
Proxy 要求 |
system.region.name |
字串 | 唯讀 |
執行 Proxy 的資料中心 區域名稱。 |
Proxy 要求 |
system.time |
字串 | 唯讀 |
讀取這個變數的時間。例如:2013 年 8 月 21 日星期三 19:16:47 GMT。 這個值是 |
Proxy 要求 |
system.time.year |
整數 | 唯讀 |
|
Proxy 要求 |
system.time.month |
整數 | 唯讀 |
|
Proxy 要求 |
system.time.day |
整數 | 唯讀 |
|
Proxy 要求 |
system.time.dayofweek |
整數 | 唯讀 |
|
Proxy 要求 |
system.time.hour |
整數 | 唯讀 |
|
Proxy 要求 |
system.time.minute |
整數 | 唯讀 |
|
Proxy 要求 |
system.time.second |
整數 | 唯讀 |
|
Proxy 要求 |
system.time.millisecond |
整數 | 唯讀 |
|
Proxy 要求 |
system.time.zone |
字串 | 唯讀 |
系統的時區。 |
Proxy 要求 |
system.timestamp |
長 | 唯讀 |
64 位元 (長) 整數,代表讀取這個變數的時間。這個值是自世界標準時間 1970 年 1 月 1 日午夜起經過的毫秒數。例如 |
Proxy 要求 |
system.uuid |
字串 | 唯讀 |
處理 Proxy 的訊息處理器的 UUID。 |
Proxy 要求 |
target
說明要求的目標。
下表說明 target
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
target.basepath |
字串 | 唯讀 |
代理程式 TargetEndpoint 中定義的目標服務資源路徑 (不含網域),不含查詢參數。 舉例來說,假設 API Proxy 呼叫下列目標:
在本例中, 如果目標是:
|
目標要求 |
target.copy.pathsuffix |
布林值 | 讀取/寫入 |
當 |
目標要求 |
target.copy.queryparams |
布林值 | 讀取/寫入 |
當 |
目標要求 |
target.country |
字串 | 唯讀 |
目標伺服器提供的 TLS/SSL 憑證所屬國家/地區 |
目標回應 |
target.cn |
字串 | 唯讀 |
TargetEndpoint 的一般名稱。只有在 TargetEndpoint 參照 TLS/SSL 端點時,這項屬性才有意義。 |
指定要求 |
target.email.address |
字串 | 唯讀 |
目標伺服器提供的 TLS/SSL 憑證電子郵件地址 |
目標回應 |
target.expectedcn |
字串 | 讀取/寫入 |
TargetEndpoint 的預期通用名稱。只有在 TargetEndpoint 參照 TLS/SSL 端點時,這項屬性才有意義。 |
Proxy 要求 |
target.header.host |
字串 | 讀取/寫入 |
Apigee 用於設定目標傳出要求的 |
目標要求 |
target.host |
字串 | 唯讀 |
目標服務的網域名稱,會將回應傳回至 API Proxy。 |
目標回應 |
target.ip |
字串 | 唯讀 |
傳回 API 代理程式回應的目標服務 IP 位址。 |
目標回應 |
target.locality |
字串 | 唯讀 |
目標伺服器提供的 TLS/SSL 憑證所在地 (城市) |
目標回應 |
target.name |
字串 | 唯讀 |
從目標端點傳送訊息的目標。 |
目標要求 |
target.organization |
字串 | 唯讀 |
目標伺服器提供的 TLS/SSL 憑證組織。 |
目標回應 |
target.organization.unit |
字串 | 唯讀 |
目標伺服器提供的 TLS/SSL 憑證組織單位。 |
目標回應 |
target.port |
整數 | 唯讀 |
目標服務傳回 API Proxy 回應的通訊埠號碼。 |
目標回應 |
target.received.end.time |
字串 | 唯讀 |
以字串形式表示的時間,表示 TargetEndpoint 完成接收目標回應的時間。例如 2013 年 8 月 21 日星期三 19:16:47 世界標準時間。 這個時間值是相應 32 位元時間戳記數量的字串表示法。舉例來說,2013 年 8 月 21 日星期三 19:16:47 (世界標準時間) 對應的時間戳記值為 1377112607413。 |
目標回應 |
target.received.end. |
長 | 唯讀 |
時間戳記值,指定 TargetEndpoint 完成接收目標回應的時間。例如, |
目標回應 |
target.received.start.time |
字串 | 唯讀 |
以字串形式表示的時間,表示 TargetEndpoint 開始接收目標回應的時間。例如 2013 年 8 月 21 日星期三 19:16:47 世界標準時間。 這個時間值是相應 32 位元時間戳記數量的字串表示法。舉例來說,2013 年 8 月 21 日星期三 19:16:47 (世界標準時間) 對應的時間戳記值為 1377112607413。 |
目標回應 |
target.received.start. |
長 | 唯讀 |
指定 TargetEndpoint 開始接收目標回應時間的時間戳記值。例如, |
目標回應 |
target.scheme |
字串 | 唯讀 |
範圍開始:目標回應 傳回 http 或 https,視要求訊息而定。 |
目標要求 |
target.sent.end.time |
字串 | 唯讀 |
代理程停止將要求傳送至 TargetEndpoint 中指定的網址的時間,以字串形式表示。例如 2013 年 8 月 21 日星期三 19:16:47 世界標準時間。 這個時間值是相應 32 位元時間戳記數量的字串表示法。舉例來說,2013 年 8 月 21 日星期三 19:16:47 (世界標準時間) 對應的時間戳記值為 1377112607413。 |
指定要求 |
target.sent.end.timestamp |
長 | 唯讀 |
時間戳記值,指定 Proxy 完成向 TargetEndpoint 指定網址傳送要求的時間。例如 1377112607413。這個值是 64 位元 (長) 整數,包含自世界標準時間 1970 年 1 月 1 日午夜起經過的毫秒數。 |
目標要求 |
target.sent.start.time |
字串 | 唯讀 |
代理伺服器開始將要求傳送至 TargetEndpoint 中指定的網址的時間,以字串形式表示。例如 2013 年 8 月 21 日星期三 19:16:47 世界標準時間。 這個時間值是相應 32 位元時間戳記數量的字串表示法。舉例來說,2013 年 8 月 21 日星期三 19:16:47 (世界標準時間) 對應的時間戳記值為 1377112607413。 |
指定要求 |
target.sent.start.timestamp |
長 | 唯讀 |
時間戳記值,指定 Proxy 開始將要求傳送至 TargetEndpoint 中指定的網址的時間。例如, |
目標要求 |
target.ssl.enabled |
布林值 | 唯讀 |
是否在 TLS/SSL 上執行 TargetEndpoint。 |
Proxy 要求 |
target.state |
字串 | 唯讀 |
目標伺服器提供的 TLS/SSL 憑證狀態。 |
目標回應 |
target.url |
字串 | 讀取/寫入 |
在 TargetEndpoint XML 檔案中設定的網址,或動態目標網址 (如果在訊息流程中設定 |
目標要求 |
variable
variable.expectedcn
屬性的容器。
下表說明 variable
變數的屬性:
屬性 | 類型 | 讀取/寫入 | 說明 | 範圍開始 |
---|---|---|---|---|
variable.expectedcn |
字串 | 讀取/寫入 |
如果常用名稱在 TLS/SSL 上執行,就會公開這個變數。 |
Proxy 要求 |
如要進一步瞭解如何使用 TLS,請參閱「傳輸層安全標準 (TLS) 設定選項」。