排解 PythonScript 政策部署錯誤

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

您正在查看 Apigee 和 Apigee Hybrid 說明文件。
查看 Apigee Edge 說明文件。

InvalidResourceUrlFormat

錯誤訊息

透過 Apigee UI 或 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> 中指定的資源網址格式或 PythonScript 政策的 <IncludeURL> 元素無效，API 代理程式就無法部署。

正確的格式如下所示：

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

舉例來說，如果 <ResourceURL> 元素指定如下所示，則 API 代理程式無法部署，因為它不符合必要模式：

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

診斷

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

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

2. 請檢查發生失敗的特定 API Proxy 中，所有 PythonScript 政策。如果有任何 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

錯誤訊息

透過 Apigee UI 或 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 套件，則 PythonScript 來源檔案必須儲存在 /apiproxy/resources/py(API Proxy 範圍) 下。

在 Apigee UI 中，PythonScript 來源檔案會顯示在 API 代理程式編輯器導覽窗格「指令碼」部分的 py 下方，如下所示：

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

診斷

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. 在 Apigee 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」部分：