Pemecahan masalah error deployment kebijakan PythonScript

Anda sedang melihat dokumentasi Apigee dan Apigee Hybrid.
Lihat dokumentasi Apigee Edge.

InvalidResourceUrlFormat

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Deploying Revision revision_number to environment
Invalid resource url format. Resource url is invalid_URL.

Contoh pesan error

Error Deploying Revision 2 to prod
Invalid resource url format. Resource url is py:myscript.py.

Contoh screenshot

Terjadi error saat men-deploy revisi 2 ke produksi.

Penyebab

Jika format URL resource yang ditentukan dalam elemen <ResourceURL> atau <IncludeURL> dari kebijakan PythonScript tidak valid, deployment proxy API akan gagal.

Format yang benar ditunjukkan di bawah ini:

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

Misalnya, jika elemen <ResourceURL> ditetapkan seperti ditunjukkan di bawah, deployment proxy API akan gagal karena tidak mengikuti pola yang diperlukan:

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

Diagnosis

  1. Identifikasi format URL resource yang tidak valid dan digunakan dalam kebijakan PythonScript. Anda dapat menemukan informasi ini dari pesan error. Misalnya, dalam error berikut, format URL resource yang tidak valid adalah py:myscript.py:

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

  2. Periksa semua kebijakan PythonScript di Proxy API tertentu tempat kegagalan terjadi. Jika ada kebijakan PythonScript dengan URL resource yang ditentukan dalam elemen <ResourceURL> atau <IncludeURL> cocok dengan entri tidak valid yang diidentifikasi pada langkah #1 di atas, itulah penyebab error.

    Misalnya, kebijakan berikut menentukan URL resource sebagai py:myscript.py, yang cocok dengan yang ada dalam pesan error:

    <?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>

    Karena URL resource ditetapkan sebagai py:myscript.py, yang tidak valid, deployment Proxy API akan gagal dengan error:

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

Resolusi

Pastikan format URL resource yang ditentukan dalam elemen <ResourceURL> kebijakan PythonScript valid. Contoh:

<?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

Pesan error

Deployment proxy API melalui UI atau API Apigee gagal dengan pesan error ini:

Error Deploying Revision revision_number to environment
Invalid resource url ref invalid_reference in policy policy_name in org_name

Contoh pesan error

Error Deploying Revision 2 to prod
Invalid resource url ref py://myscript.py in policy Python_script in myorg

Contoh screenshot

Terjadi error saat men-deploy revisi 2 ke produksi.

Penyebab

Jika elemen <ResourceURL> dan <IncludeURL> merujuk ke file PythonScript yang tidak ada, deployment proxy API akan gagal. Jika Anda men-deploy paket proxy dari mesin lokal, file sumber PythonScript harus disimpan di /apiproxy/resources/py(pada cakupan proxy API).

Di UI Apigee, file sumber PythonScript muncul di bawah py di bagian Skrip pada panel Navigator editor proxy API seperti ditunjukkan di bawah ini:

Bagian Skrip panel navigasi API Proxy Editor.

Anda juga dapat menyimpan file resource di repositori tingkat lingkungan (misalnya, untuk membuat kode PythonScript tersedia bagi semua proxy di env). Jika file resource yang ditentukan dalam kebijakan tidak dapat ditemukan, error ini akan terjadi.

Diagnosis

  1. Identifikasi kebijakan PythonScript tempat error terjadi dan referensi URL resource yang tidak valid. Anda dapat menemukan informasi ini dari pesan error. Misalnya, dalam error berikut, nama kebijakan adalah Python_script dan referensi URL resource yang tidak valid adalah py://myscript.py:

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

  2. Pastikan referensi URL resource yang ditentukan dalam kebijakan PythonScript yang gagal cocok dengan nilai yang teridentifikasi dalam pesan error (langkah #1 di atas). Misalnya, kebijakan berikut menentukan referensi URL resource sebagai py://myscript.py, yang cocok dengan yang ada dalam pesan error:

    <?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. Periksa apakah file yang diidentifikasi di langkah #1 adalah bagian dari paket Proxy API tertentu, atau ada di cakupan lingkungan.

    1. Untuk memeriksa apakah file tersebut adalah bagian dari paket Proxy API tertentu, ikuti salah satu langkah berikut:
      1. Di UI Apigee, periksa apakah file ini ada di bagian Skrip proxy API.
      2. Download paket Proxy API dan telusuri apakah file tersebut ada.
    2. Jika file bukan bagian dari paket Proxy API tertentu, periksa apakah file tersebut ada di tingkat lingkungan. Anda dapat menggunakan Resource Files API untuk investigasi ini.

    Jika file tidak ada di Proxy API atau tingkat lingkungan, berarti itulah penyebab error.

    Pada contoh di atas, nama file PythonScript yang tidak valid adalah myscript.py. Pada screenshot di bawah, perhatikan bahwa file yang ditentukan sebagai URL resource dalam kebijakan tidak muncul di bagian Skrip. Selain itu, file tersebut tidak ada di tingkat lingkungan. Oleh karena itu, deployment Proxy API gagal dengan error:

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

URL resource tidak valid.

Resolusi

Pastikan file PythonScript yang ditentukan dalam elemen <ResourceURL> dan <IncludeURL> merujuk ke file valid yang ada di Proxy API atau level lingkungan.

Untuk memperbaiki contoh kebijakan PythonScript yang ditampilkan di atas, tambahkan file myscript.py ke paket Proxy API. Pada screenshot di bawah, Anda dapat melihat bahwa file PythonScript yang ditentukan dalam elemen <ResourceURL> dan <IncludeURL> terlihat di bagian Skrip paket Proxy API:

Bagian skrip paket Proxy API.