排解 PythonScript 政策部署錯誤

查看 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 2 to prod
Invalid resource url format. Resource url is py:myscript.py.

螢幕截圖範例

原因

如果資源網址格式在網頁的 <ResourceURL> 或 <IncludeURL> 元素內 PythonScript 政策無效，因此 API Proxy 的部署會失敗。

正確的格式如下所示：

<ResourceURL>py://file_name.py</ResourceURL>
<IncludeURL>py://file_name.py</IncludeURL>

舉例來說，如果指定 <ResourceURL> 元素如下所示，則 API Proxy 不符合規定的模式，因此部署失敗：

<ResourceURL>py:myscript.py</ResourceURL>

診斷

  1. 找出 PythonScript 政策中使用的無效資源網址格式。你可以在錯誤訊息中找到這項資訊。舉例來說，在下列錯誤中，無效的資源網址格式為 py:myscript.py：

    Invalid resource url format. Resource url is py:myscript.py.

  2. 檢查發生錯誤時，特定 API Proxy 中的所有 PythonScript 政策。如果 <ResourceURL> 或 <IncludeURL> 元素中指定的資源網址與上方步驟 1 列出的無效項目相符，就會發生這個錯誤。

    舉例來說，下列政策會將資源網址指定為 py:myscript.py，與錯誤訊息中的資訊相符：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Script async="false" continueOnError="false" enabled="true" timeLimit="200" name="py-TotalVariable">
    <DisplayName>py-TotalVariable</DisplayName>
    <Properties/>
    <ResourceURL>py:myscript.py</ResourceURL>
</Script>

    由於資源網址指定的 py:myscript.py 無效，因此 API Proxy 部署作業會失敗，並出現以下錯誤：

    Invalid resource url format. Resource url is py:myscript.py.

解析度

確認 PythonScript 政策 <ResourceURL> 元素中指定的資源網址格式有效。例如：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Script async="false" continueOnError="false" enabled="true" timeLimit="200" name="py-TotalVariable">
    <DisplayName>py-TotalVariable</DisplayName>
    <Properties/>
    <ResourceURL>py://myscript.py</ResourceURL>
</Script>

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 2 to prod
Invalid resource url ref py://myscript.py in policy Python_script in myorg

螢幕截圖範例

原因

如果 <ResourceURL> 和 <IncludeURL> 元素參照 PythonScript 檔案 不存在，則 API Proxy 的部署作業便會失敗。 如果您要從本機電腦部署 Proxy 套件，則 PythonScript 來源檔案必須儲存在 /apiproxy/resources/py(在 API Proxy 範圍) 下。

在 Edge UI 中，PythonScript 來源檔案會顯示在「Scripts」部分的 py 下方 API Proxy 編輯器的「Navigator」窗格，如下所示：

此外，您也可以將資源檔案儲存在機構和環境層級存放區 (例如，讓機構或環境中的所有 Proxy 都能使用 PythonScript 程式碼)。如果找不到政策中指定的任何資源檔案，就會發生這個錯誤。

診斷

  1. 找出發生錯誤的 PythonScript 政策和無效的資源網址參照。你可以在錯誤訊息中找到這項資訊。舉例來說，在下列錯誤中，政策名稱為 Python_script，無效的資源網址參照則為 py://myscript.py：

    Invalid resource url ref py://myscript.py in policy Python_script in myorg

  2. 確認失敗 PythonScript 政策中指定的資源網址參照與錯誤訊息 (上述步驟 #1) 中指定的值相符。舉例來說，下列政策會將資源網址參照指定為 py://myscript.py，與錯誤訊息顯示的內容相符：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Script async="false" continueOnError="false" enabled="true" name="Python_script">
    <DisplayName>Python-1</DisplayName>
    <Properties/>
    <ResourceURL>py://myscript.py</ResourceURL>
</Script>

  3. 檢查步驟 1 檔案中找到的檔案是否屬於特定 API Proxy 套件，或者是否位於機構或環境範圍內。

    1. 如要檢查檔案是否屬於特定 API Proxy 套件，請執行下列任一步驟：
      1. 在 Edge UI 中，檢查這個檔案是否位於 API Proxy 的「Scripts」部分。
      2. 下載 API Proxy 套件，並搜尋檔案是否存在。
    2. 如果檔案不屬於特定 API Proxy 套件，請檢查機構或環境層級是否存在。您可以使用 Resource Files API 進行調查。

    如果檔案不在 API Proxy、機構或環境層級，原因就是錯誤。

    在上述範例中，無效的 PythonScript 檔案名稱為 myscript.py。請注意，在下方螢幕截圖中，政策中指定的資源網址並未顯示在「指令碼」部分。此外，機構或環境層級也沒有該檔案。因此，API Proxy 部署作業失敗並收到以下錯誤：

    Invalid resource url ref py://myscript.py in policy Python_script in myorg

解析度

確認 <ResourceURL> 和 <IncludeURL> 元素中指定的 PythonScript 檔案參照位於 API Proxy、機構或環境層級的有效檔案。

如要修正上述範例 PythonScript 政策，請將 myscript.py 檔案加入 API Proxy 套件中。在下方的螢幕截圖中，您可以看到在 <ResourceURL> 和 <IncludeURL> 元素中指定的 PythonScript 檔案會顯示在 API Proxy 套件的「Scripts」區段：