您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
InvalidTimeout
錯誤訊息
無法透過 Edge UI 或 Edge Management API 部署 API Proxy,並顯示以下錯誤訊息:
Error Saving Revision revision_number CacheLookupTimeoutInSeconds value value should be greater than zero.
錯誤訊息範例
Error Saving Revision 2
CacheLookupTimeoutInSeconds -1 value should be greater than zero.
錯誤螢幕截圖示例
原因
如果 LookupCache 政策的 <CacheLookupTimeoutInSeconds>
元素設為負數,API Proxy 部署就會失敗。
舉例來說,如果 <CacheLookupTimeoutInSeconds>
元素是 -1
,API Proxy 的部署就會失敗。
診斷
找出 LookupCache 政策中
<CacheLookupTimeoutInSeconds>
元素指定的無效值。您可以在錯誤訊息中找到這項資訊。例如,在下列錯誤中,<CacheLookupTimeoutInSeconds>
元素使用的值為-1
:CacheLookupTimeoutInSeconds -1 value should be greater than zero.
檢查發生錯誤的特定 API Proxy 中的所有 LookupCache 政策。可能有一或多項 LookupCache 政策指定
<CacheLookupTimeoutInSeconds>
元素。找出為<CacheLookupTimeoutInSeconds>
元素指定無效值 (如上述步驟 1 中識別) 的 LookUpCache 政策。舉例來說,以下政策設定指定了
-1
的<CacheLookupTimeoutInSeconds>
值,而該值會與錯誤訊息相符:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token"> <DisplayName>LookupCache-Token</DisplayName> <Properties/> <CacheKey> <Prefix/> <KeyFragment ref="request.queryparam.client_id"/> </CacheKey> <CacheLookupTimeoutInSeconds>-1</CacheLookupTimeoutInSeconds> <Scope>Exclusive</Scope> <ExpirySettings> <TimeoutInSec>3600</TimeoutInSec> </ExpirySettings> <AssignTo>usertoken</AssignTo> </LookupCache>
如果
<CacheLookupTimeoutInSeconds>
指定為負整數,則為發生錯誤的原因。
解析度
確保 LookupCache 政策的 <CacheLookupTimeoutInSeconds>
元素值一律指定為非負整數。
如要修正上方顯示的 LookupCache 政策範例,您可以將 <CacheLookupTimeoutInSeconds>
元素修改為 30
。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
<DisplayName>LookupCache-Token</DisplayName>
<Properties/>
<CacheKey>
<Prefix/>
<KeyFragment ref="request.queryparam.client_id"/>
</CacheKey>
<CacheResource>tokencache</CacheResource>
<CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>
<Scope>Exclusive</Scope>
<ExpirySettings>
<TimeoutInSec>3600</TimeoutInSec>
</ExpirySettings>
<AssignTo>usertoken</AssignTo>
</LookupCache>
InvalidCacheResourceReference
錯誤訊息
無法透過 Edge UI 或 Edge Management API 部署 API Proxy,並顯示以下錯誤訊息:
Error Deploying Revision revision_number to environment Invalid cache resource reference [cache_resource] in Step definition [populate_cache_policy_name]. Context Revision:[revision_number];APIProxy:ResponseCache;Organization:[organization];Environment:[environment]
錯誤訊息範例
Error Deploying Revision 2 to test
Invalid cache resource reference tokencache in Step definition LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
錯誤螢幕截圖示例
原因
如果 <CacheResource>
元素設定的名稱不在部署 API Proxy 的環境中,就會發生這個錯誤。
診斷
找出 LookupCache 政策
<CacheResource>
元素中使用的無效快取,以及發生錯誤的環境。您可以在錯誤訊息中找到這兩個項目。舉例來說,在下列錯誤中,無效快取的名稱為tokencache
,環境名稱為test
。Invalid cache resource reference tokencache in Step definition LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
檢查發生錯誤的特定 API Proxy 中的所有 LookupCache 政策。找出在
<CacheResource>
元素中指定無效快取 (已在步驟 #1 中找出) 的特定 LookupCache 政策。舉例來說,下列政策會將
<CacheResource>
的值指定為tokencache
,以便與錯誤訊息相符:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token"> <DisplayName>LookupCache-Token</DisplayName> <Properties/> <CacheKey> <Prefix/> <KeyFragment ref="request.queryparam.client_id"/> </CacheKey> <CacheResource>tokencache</CacheResource> <CacheLookupTimeoutInSeconds/> <Scope>Exclusive</Scope> <ExpirySettings> <TimeoutInSec>3600</TimeoutInSec> </ExpirySettings> <AssignTo>usertoken</AssignTo> </LookupCache>
確認已在特定環境中定義快取 (於步驟 1 定義)。
在 Edge UI 中依序前往「管理」>「環境」>「測試」,然後檢查「環境設定」的「快取」分頁是否有快取存在。如果快取不存在,則可能是錯誤原因。
例如,請注意在下方螢幕截圖中,名為
tokencache
的快取不存在。由於
test
環境中並未定義名為tokencache
的快取,因此您會收到錯誤訊息:Invalid cache resource reference tokencache in Step definition LookupCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
解析度
確保已在您要部署 API Proxy 的環境中建立 <CacheResource>
元素中指定的快取名稱。
如要瞭解如何建立快取,請參閱「建立及編輯環境快取」一文。
CacheNotFound
錯誤訊息
如果透過 Edge UI 或 Edge Management API 部署 API Proxy,就會產生如下的錯誤訊息,而 API Proxy 的部署狀態則會標示為「部分部署」:
Error: Cache : cache_resource, not found in organization : organization__environment.
錯誤訊息範例
Error Cache : configCache, not found in organization : kkalckstein-eval__test
原因
如果尚未在特定的訊息處理器元件上建立錯誤訊息中提及的特定快取,就會發生這個錯誤。
解析度
如果您是 Private Cloud 的使用者,請按照以下說明操作:
列出 API Proxy 部署作業,並判斷哪些訊息處理器含有
steps.cache.CacheNotFound
錯誤。curl -u $USERID:$USERPASSWORD http://
:8080/v1/organizations/ /environments/ /apis/ /revisions/ /deployments 輸出內容範例
{ "aPIProxy" : "TestCache", "environment" : [ { "configuration" : { "basePath" : "/", "configVersion" : "SHA-512:45d3f39783414d3859bf2dec4135d8f5f9960ee6b2d361db2799c82693a8e3f8b95dbbb37c547eb3c0a3819d8ca51727f390502bcaefdf1f113263521a9023b6", "steps" : [ ] }, "name" : "prod", "server" : [ { "pod" : { "name" : "pod1", "region" : "us-central1" }, "status" : "deployed", "type" : [ "message-processor" ], "uUID" : "f2e5e34a-5630-43a9-8fef-48a5b9da76d1" }, { "pod" : { "name" : "pod1", "region" : "us-central1" }, "status" : "deployed", "type" : [ "message-processor" ], "uUID" : "879a6538-a5e0-4503-b142-9cb2b4e0623d" }, { "error" : "Cache : configCache, not found in organization : kkalckstein-eval__test", "errorCode" : "steps.cache.CacheNotFound", "status" : "error", "type" : [ "message-processor" ], "uUID" : "a8f9ce0b-c32d-48a9-b26c-9c75d8bf467d" }, ... "state" : "deployed" } ], "name" : "2", "organization" : "kkalckstein-eval" ...
請注意出現
steps.cache.CacheNotFound
錯誤的訊息處理器的 UUID。找出與 UUID 相關聯的郵件處理器主機名稱/IP 位址。登入特定的訊息處理器,並使用下列指令來重新啟動:
apigee-service edge-message-processor restart
如果您是公用雲端使用者,或私有雲的問題持續發生,請向 Apigee 支援團隊尋求協助。