您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
InvalidResourceUrlFormat
錯誤訊息
無法透過 Edge UI 或 Edge Management API 部署 API Proxy,並顯示以下錯誤訊息:
Error Deploying Revision revision_number to environment Invalid resource url format. Resource url is invalid_URL.
錯誤訊息示例
Error Deploying Revision 1 to test
Invalid resource url format. Resource url is jsc:add_variables.js.
螢幕截圖範例
原因
如果 <ResourceURL>
或 JavaScript 政策的 <IncludeURL>
元素中指定的資源網址格式無效,API Proxy 部署就會失敗。
指定資源網址的正確格式如下:
<ResourceURL>jsc://<file_name>.js</ResourceURL>
<IncludeURL>jsc://<file_name>.js</IncludeURL>
舉例來說,如果指定 <ResourceURL>
元素如下,API Proxy 的部署就會失敗,因為該 Proxy 未遵循指定的模式:
<ResourceURL>jsc:add_variables.js</ResourceURL>
診斷
指出 JavaScript 政策中使用的無效資源網址格式。您可以在錯誤訊息中找到這項資訊。舉例來說,在下列錯誤中,無效的資源網址格式為
jsc:add_variables.js
。Error Deploying Revision 1 to test Invalid resource url format. Resource url is jsc:add_variables.js.
檢查發生錯誤的特定 API Proxy 中的所有 JavaScript 政策。如有任何 JavaScript 政策在
<ResourceURL>
或<IncludeURL>
元素中指定的資源網址與上述步驟 #1 中識別的無效項目相符,就會導致發生錯誤。舉例來說,下列政策會將資源網址指定為
jsc:add_variables.js
,此網址與錯誤訊息中的內容相符:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-TotalVariable"> <DisplayName>js-TotalVariable</DisplayName> <Properties/> <ResourceURL>jsc:add_variables.js</ResourceURL> </Javascript>
由於指定資源網址為
jsc:add_variables.js
無效,因此 API Proxy 部署作業會失敗並顯示以下錯誤:Invalid resource url format. Resource url is jsc:add_variables.js.
解析度
請確認 JavaScript 政策 <ResourceURL>
或 <IncludeURL>
元素中指定的資源網址格式有效。例如:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-TotalVariable">
<DisplayName>js-TotalVariable</DisplayName>
<Properties/>
<ResourceURL>jsc://add_variables.js</ResourceURL>
</Javascript>
InvalidResourceUrlReference
錯誤訊息
無法透過 Edge UI 或 Edge Management API 部署 API Proxy,並顯示以下錯誤訊息:
Error Deploying Revision revision_number to environment Invalid resource url ref invalid_reference in policy policy_name in org_name
錯誤訊息示例
Error Deploying Revision 8 to test
Invalid resource url ref jsc://dependent_js.js in policy js-TotalVariable in aprabhashankar-eval
螢幕截圖範例
原因
如果 <ResourceURL>
和 <IncludeURL>
元素參照的 JavaScript 檔案不存在,API Proxy 部署就會失敗。
如果要從本機電腦部署 Proxy 套件,JavaScript 來源檔案必須儲存在 /apiproxy/resources/jsc
底下。在這種情況下,來源檔案的範圍就是 API Proxy。
在 Edge UI 中,API Proxy 編輯器的「Navigator」窗格內,「Scripts」部分的 jsc 下方會顯示 JavaScript 來源檔案。您也可以將資源檔案儲存在機構和環境層級存放區中 (例如讓機構或環境中的所有 Proxy 都能使用 JavaScript 程式碼)。
如果在任何可用的範圍 (Proxy、環境或機構) 中找不到政策中指定的資源檔案,就會發生這個錯誤。
診斷
找出發生錯誤的 JavaScript 政策,且含有無效的資源網址參照。您可以在錯誤訊息中找到這項資訊。舉例來說,在下列錯誤中,政策名稱為
js-TotalVariable
,無效的資源網址參照為jsc://dependent_js.js
。Invalid resource url ref jsc://dependent_js.js in policy js-TotalVariable in aprabhashankar-eval
驗證失敗的 JavaScript 政策中指定的資源網址參照,與錯誤訊息中指出的值 (請參閱上方的步驟 #1) 相符。例如,下列政策會將資源網址參照指定為
jsc://dependent_js.js
,此參照與錯誤訊息中的內容相符:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-TotalVariable"> <DisplayName>js-TotalVariable</DisplayName> <Properties/> <ResourceURL>jsc://add_variables.js</ResourceURL> <IncludeURL>jsc://dependent_js.js</IncludeURL> </Javascript>
檢查步驟 #1 中識別的來源檔案是否屬於特定 API Proxy 套件,或者位於機構或環境範圍內。
- 如要確認檔案是否屬於特定 API Proxy 套裝組合,請執行下列任一步驟:
- 在 Edge UI 中,檢查這個檔案是否位於 API Proxy 的「Scripts」(指令碼) 部分。
- 下載 API Proxy 套件,並搜尋檔案是否存在。
- 如果檔案不屬於特定 API Proxy 套件的一部分,請檢查該檔案是否存在於機構或環境層級。您可以使用 Resource Files API 進行調查。
如果檔案不存在於 API Proxy、機構或環境層級,就是發生錯誤的原因。
在上述範例中,請記得無效的 JavaScript 檔案名稱為
dependent_js.js
。請注意,在下方螢幕截圖中,在政策中指定為資源網址的檔案,不會顯示在「指令碼」部分。因此不屬於 API Proxy。如果在機構或環境層級也沒有該檔案,API Proxy 的部署作業就會失敗並發生以下錯誤:Invalid resource url ref jsc://dependent_js.js in policy js-TotalVariable in aprabhashankar-eval
- 如要確認檔案是否屬於特定 API Proxy 套裝組合,請執行下列任一步驟:
解析度
確認 <ResourceURL>
和 <IncludeURL>
元素中指定的 JavaScript 檔案參照了位於 API Proxy、機構或環境層級的有效檔案。
如要修正上述 JavaScript 政策範例,請將 dependent_js.js
檔案加入 API Proxy 套件中。在下方螢幕截圖中,您可以看到 API Proxy 套件的「Scripts」部分,顯示在 <ResourceURL>
和 <IncludeURL>
元素中指定的 JavaScript 檔案。
WrongResourceType
錯誤訊息
無法透過 Edge UI 或 Edge Management API 部署 API Proxy,並顯示以下錯誤訊息:
Error Deploying Revision revision_number to environment Resource JavaScript_file is the wrong type. It is invalid_type: but Javascript steps use type jsc:.
錯誤訊息示例
Error Deploying Revision 2 to test
Resource js_checkType.js is the wrong type. It is node: but Javascript steps use type jsc:.
螢幕截圖範例
原因
如果 JavaScript 政策的 <ResourceURL>
和 <IncludeURL>
元素參照 jsc (JavaScript 檔案) 以外的任何資源類型,系統就會在部署期間發生這個錯誤。
舉例來說,如果 <IncludeURL>
元素宣告如下,API Proxy 的部署作業就會失敗:
<IncludeURL>node://javascript-dependency.js</IncludeURL>
這是因為所參照的 node
資源類型不正確。
診斷
指出 JavaScript 政策中使用的無效資源類型。您可以在錯誤訊息中找到這項資訊。舉例來說,在下列錯誤中,無效的資源類型為
node
。Resource js_checkType.js is the wrong type. It is node: but Javascript steps use type jsc:.
檢查發生錯誤的特定 API Proxy 中的所有 JavaScript 政策。如果
<ResourceURL>
或<IncludeURL>
元素中指定的任何 JavaScript 政策與上述步驟 #1 中識別的無效資源類型相符,就會導致發生錯誤。例如,下列政策會將資源類型指定為
node
,此類型與錯誤訊息中的內容相符:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-TotalVariable"> <DisplayName>js-TotalVariable</DisplayName> <Properties/> <ResourceURL>node://js_checkType.js</ResourceURL> <IncludeURL>jsc://javascript-dependency.js</IncludeURL> </Javascript>
由於指定為
node
的資源類型無效,因此 API Proxy 部署作業會失敗並顯示以下錯誤:Resource js_checkType.js is the wrong type. It is node: but Javascript steps use type jsc:.
解析度
確認 JavaScript 政策中的 <ResourceURL>
和 <IncludeURL>
元素一律參照 jsc
資源類型。
如要修正上方顯示的範例,請修改 <ResourceURL>
元素,設為 jsc
資源類型。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-TotalVariable">
<DisplayName>js-TotalVariable</DisplayName>
<Properties/>
<ResourceURL>jsc://js_checkType.js</ResourceURL>
<IncludeURL>jsc://javascript-dependency.js</IncludeURL>
</Javascript>
NoResourceURLOrSource
錯誤訊息
無法透過 Edge UI 或 Edge Management API 部署 API Proxy,並顯示以下錯誤訊息:
Error Saving Revision revision_number Bundle is invalid. Errors:[Entity : Policy-policy_name, No ResourceURL or Source;].
錯誤訊息示例
Error Saving Revision 10
Bundle is invalid. Errors:[Entity : Policy-js-example, No ResourceURL or Source;].
螢幕截圖範例
原因
在下列情況下,JavaScript 政策可能會無法部署,並導致這項錯誤:
- 如果未宣告
<ResourceURL>
元素,或這個元素未定義資源網址,<ResourceURL>
元素是必要元素。 - 已宣告
<IncludeURL>
元素,但這個元素中未定義資源網址。<IncludeURL>
元素是選用元素,但如果已宣告,則必須在<IncludeURL>
元素中指定資源網址。
舉例來說,如果 <IncludeURL>
元素宣告如下,API Proxy 的部署作業就會失敗:
<IncludeURL></IncludeURL>
診斷
找出發生錯誤的 JavaScript 政策。您可以在錯誤訊息中找到這項資訊。舉例來說,在下列錯誤中,政策名稱會是
Policy-js-example
:Bundle is invalid. Errors:[Entity : Policy-js-example, No ResourceURL or Source;].
在失敗的 JavaScript 政策 XML 檔案中,執行下列檢查:
- 必須宣告
<ResourceURL>
元素,且該元素必須定義資源網址。 - 如果已宣告
<IncludeURL>
元素,您必須在當中指定資源網址。宣告<IncludeURL>
元素是選擇性步驟。
如果上述任何檢查失敗,都是發生錯誤的原因。
示例 1:下列政策未宣告
<ResourceURL>
元素:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-example"> <DisplayName>js-example</DisplayName> <Properties/> </Javascript>
因為並未宣告
<ResourceURL>
元素,因此 API Proxy 的部署作業會失敗,並顯示以下錯誤:Bundle is invalid. Errors:[Entity : Policy-js-example, No ResourceURL or Source;].
示例 2:下列政策含有空白的
<IncludeURL>
元素。- 必須宣告
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-example">
<DisplayName>js-example</DisplayName>
<Properties/>
<ResourceURL>jsc://check_var.js</ResourceURL>
<IncludeURL></IncludeURL>
</Javascript>
由於 <IncludeURL>
元素沒有資源網址,因此 API Proxy 的部署作業會失敗,並顯示以下錯誤:
Bundle is invalid. Errors:[Entity : Policy-js-example, No ResourceURL or Source;].
解析度
請務必在 JavaScript 政策中確認以下幾點:
- 系統會宣告
<ResourceURL>
元素,並在此元素中定義資源網址。<ResourceURL>
元素是必要元素。 如果已宣告
<IncludeURL>
元素,就必須在這個元素中定義 include 資源網址。<IncludeURL>
元素是選用項目,但如果已宣告,則必須在<IncludeURL>
元素中指定資源網址。如要修正上述範例 1,請加入含有有效 JavaScript 檔案的
<ResourceURL>
元素:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-example"> <DisplayName>js-example</DisplayName> <Properties/> <ResourceURL>jsc://check_var.js</ResourceURL> </Javascript>
如要修正上述範例 2,請在
<IncludeURL>
元素中加入有效的 JavaScript 檔案<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="js-example"> <DisplayName>js-example</DisplayName> <Properties/> <ResourceURL>jsc://check_var.js</ResourceURL> <IncludeURL>jsc://js_dependency.js</IncludeURL> </Javascript>