Pemecahan masalah error runtime ServiceCallout

Anda sedang melihat dokumentasi Apigee dan Apigee hybrid.
Lihat Dokumentasi Apigee Edge.

ini.

RequestVariableNotMessageType

Kode error

steps.servicecallout.RequestVariableNotMessageType

Isi respons error

{
    "fault": {
        "faultstring": "ServiceCallout[POLICY_NAME]: request variable [VARIABLE_NAME] value is not of type Message",
        "detail": {
            "errorcode": "steps.servicecallout.RequestVariableNotMessageType"
        }
    }
}

Penyebab

Error ini terjadi jika variabel yang ditentukan dalam elemen <Request> kebijakan Servicecallout bukan jenis message. Jika variabelnya berupa string atau jenis non-pesan lainnya, Anda akan melihat error ini.

Variabel jenis pesan mewakili seluruh permintaan dan respons HTTP. Variabel flow bawaan request, response, dan message adalah jenis message.

Diagnosis

  1. Mengidentifikasi kebijakan ServiceInfo tempat terjadinya error dan nama variabel yang jenisnya salah. Anda dapat menemukan kedua item ini di elemen faultstring respons error. Misalnya, dalam faultstring berikut, nama kebijakannya adalah ExecuteGeocodingRequest dan variabelnya adalah PostalCode:

    "faultstring": "ServiceCallout[ExecuteGeocodingRequest]: request variable PostalCode value is not of type Message"

  2. Di XML kebijakan Servicecallout yang gagal, pastikan nama variabel yang ditetapkan dalam elemen <Request> cocok dengan nama variabel yang diidentifikasi dalam string fault (langkah #1 di atas). Misalnya, kebijakan berikut menentukan variabel permintaan bernama PostalCode, yang cocok dengan yang ada di faultstring:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="PostalCode"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

  3. Tentukan apakah variabel ini berjenis pesan atau bukan:

    1. Cari kode dalam paket Proxy API, tempat variabel ditentukan terlebih dahulu.
    2. Pada umumnya, Anda akan menemukan bahwa variabel masalah dibuat dan diisi dalam kebijakan lain yang dijalankan sebelum kebijakan ServiceInfo. Misalnya, kebijakan Tetapkan Pesan biasanya digunakan untuk membuat dan mengisi variabel dalam alur proxy API.
    3. Setelah mengetahui kebijakan tempat variabel ditetapkan dan diisi terlebih dahulu, Anda harus menentukan jenis variabel tersebut seperti berikut:
      • Periksa nilai atribut type (jika ada).
      • Jika atribut type tidak ada, variabel tersebut dianggap sebagai string.
    4. Jika jenis variabel bukan pesan (seperti string), maka itulah penyebab error. Anda dapat mempelajari variabel umum dan jenisnya di Referensi variabel flow.

Sebagai contoh, asumsikan variabel PostalCode yang dirujuk dalam kebijakan ServiceInfo dibuat dalam kebijakan MenetapkanMessage berikut. Perhatikan bahwa PostalCode diberi nilai variabel alur request.queryparam.postalcode. Nilai ini berupa string karena tidak ada atribut type dalam penetapan variabel.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage name="GenerateGeocodingRequest">
        <AssignTo createNew="true" type="request">GeocodingRequest</AssignTo>
    <Set>
        <QueryParams>
            <QueryParam name="address">{request.queryparam.postalcode}</QueryParam>
            <QueryParam name="region">{request.queryparam.country}</QueryParam>
            <QueryParam name="sensor">false</QueryParam>
        </QueryParams>
        <Verb>GET</Verb>
    </Set>
    <AssignVariable>
        <Name>PostalCode</Name>
        <Ref>request.queryparam.postalcode</Ref>
    </AssignVariable>
    <AssignVariable>
        <Name>Country</Name>
        <Ref>request.queryparam.country</Ref>
    </AssignVariable>
</AssignMessage>

Sekarang, ingat kembali bahwa variabel PostalCode digunakan dalam elemen <Request> dari kebijakan ServiceKeterangan:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="PostalCode"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

Karena PostalCode bukan merupakan jenis pesan (dalam contoh ini adalah string), Anda akan menerima kode error: steps.servicecallout.RequestVariableNotMessageType.

Resolusi

Pastikan variabel yang ditetapkan di elemen <Request> dalam kebijakan Servicecallout yang gagal adalah variabel alur jenis message yang ada. Atau, Anda dapat membuat variabel jenis pesan baru langsung di kebijakan Servicecallout (seperti yang dijelaskan dalam kebijakan Servicecallout) dan menggunakannya.

Untuk memperbaiki kebijakan, Anda harus mengubah elemen <Request> untuk menentukan variabel yang sudah ada atau variabel baru yang berjenis pesan. Misalnya, variabel GeocodingRequest yang disetel dalam kebijakan Tetapkan Pesan memiliki jenis pesan, dan akan berfungsi dengan baik di kebijakan Servicecallout. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="GeocodingRequest"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

RequestVariableNotRequestMessageType

Kode error

steps.servicecallout.RequestVariableNotRequestMessageType

Isi respons error

{
    "fault": {
        "faultstring": "ServiceCallout[policy_name]: request variable [variable_name] value is not of type Request Message",
        "detail": {
            "errorcode": "steps.servicecallout.RequestVariableNotRequestMessageType"
        }
    }
}

Penyebab

Error ini terjadi jika variabel yang ditentukan dalam elemen <Request> kebijakan Servicecallout bukan jenis message. Jika variabelnya adalah jenis pesan respons, string, atau jenis lainnya, Anda akan melihat error ini.

Variabel jenis message mewakili seluruh respons dan permintaan HTTP. Variabel flow bawaan request, response, dan message adalah jenis message.

Diagnosis

  1. Mengidentifikasi kebijakan ServiceInfo tempat terjadinya error dan nama variabel yang jenisnya salah. Anda dapat menemukan kedua item ini di elemen faultstring respons error. Misalnya, dalam faultstring berikut, nama kebijakannya adalah ExecuteGeocodingRequest dan variabelnya adalah var_response:

    "faultstring": "ServiceCallout[ExecuteGeocodingRequest]: request variable var_response value is not of type Message"

  2. Di XML kebijakan Servicecallout yang gagal, pastikan nama variabel yang ditetapkan dalam elemen <Request> cocok dengan nama variabel yang diidentifikasi dalam string fault (langkah #1 di atas). Misalnya, kebijakan berikut menentukan variabel permintaan bernama var_response, yang cocok dengan yang ada di faultstring:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="var_response"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

  3. Tentukan apakah variabel merupakan jenis pesan permintaan atau bukan:

    1. Cari kode dalam paket Proxy API, tempat variabel ditentukan terlebih dahulu.
    2. Pada umumnya, Anda akan menemukan bahwa variabel masalah dibuat dan diisi dalam kebijakan lain yang dijalankan sebelum kebijakan ServiceInfo. Misalnya, kebijakan Tetapkan Pesan biasanya digunakan untuk membuat dan mengisi variabel dalam alur proxy API.
    3. Setelah mengetahui kebijakan tempat variabel ditetapkan dan diisi terlebih dahulu, Anda harus menentukan jenis variabel tersebut seperti berikut:
      • Periksa nilai atribut type (jika ada).
      • Jika atribut type tidak ada, variabel tersebut dianggap sebagai string.
    4. Jika jenis variabel bukan jenis request message, maka itulah penyebab error. Anda dapat mempelajari variabel umum dan jenisnya di Referensi variabel flow.

Sebagai contoh, asumsikan variabel var_response yang dirujuk dalam kebijakan ServiceInfo dibuat dalam kebijakan Tetapkan Pesan berikut. Perlu diperhatikan bahwa var_response diberi jenis response. Oleh karena itu, jenis variabel var_response adalah pesan respons.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage name="GenerateGeocodingRequest">
        <AssignTo createNew="true" type="request">GeocodingRequest</AssignTo>
    <AssignTo createNew="true" type="response">var_response</AssignTo>
    <Set>
        <QueryParams>
            <QueryParam name="address">{request.queryparam.postalcode}</QueryParam>
            <QueryParam name="region">{request.queryparam.country}</QueryParam>
            <QueryParam name="sensor">false</QueryParam>
        </QueryParams>
        <Verb>GET</Verb>
    </Set>
    <AssignVariable>
        <Name>PostalCode</Name>
        <Ref>request.queryparam.postalcode</Ref>
    </AssignVariable>
    <AssignVariable>
        <Name>Country</Name>
        <Ref>request.queryparam.country</Ref>
    </AssignVariable>
</AssignMessage>

Ingat kembali bahwa variabel var_response digunakan dalam elemen <Request> dari kebijakan Servicecallout.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="var_response"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

Karena var_response bukan merupakan jenis pesan permintaan (jenisnya adalah pesan respons), Anda akan menerima kode error: steps.servicecallout.RequestVariableNotRequestMessageType.

Resolusi

Pastikan variabel yang ditetapkan di elemen <Request> dalam kebijakan ServiceInfo yang gagal adalah variabel jenis message yang ada. Atau, Anda dapat membuat variabel jenis pesan permintaan baru langsung di kebijakan ServiceInfo (seperti yang dijelaskan dalam kebijakan ServiceInfo) lalu menggunakannya.

Untuk memperbaiki kebijakan, Anda harus mengubah elemen <Request> untuk menentukan variabel yang ada atau variabel baru yang berjenis pesan permintaan, dan akan berfungsi di kebijakan Servicecallout. Contoh:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="GeocodingRequest"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

ExecutionFailed

Kode error

steps.servicecallout.ExecutionFailed

Isi respons error

{
    "fault": {
        "faultstring": "Execution of ServiceCallout [policy_name] failed. Reason: Host not reachable",
        "detail": {
            "errorcode": "steps.servicecallout.ExecutionFailed"
        }
    }
}

atau

{
    "fault": {
        "faultstring": "Execution of ServiceCallout [policy_name] failed. Reason: ResponseCode [http_code] is treated as error",
        "detail": {
            "errorcode": "steps.servicecallout.ExecutionFailed"
        }
    }
}

Kemungkinan penyebab

Kemungkinan penyebab error ini adalah:

Penyebab Deskripsi
URL tidak valid atau salah format Format URL target di kebijakan ServiceInfo salah atau memiliki nama host yang tidak valid atau tidak dapat dijangkau.
Error server backend Server backend akan menampilkan respons error 4XX atau 5XX.

Penyebab: URL tidak valid atau salah format

Format URL target di kebijakan ServiceInfo salah atau memiliki nama host yang tidak valid atau tidak dapat dijangkau.

Diagnosis

  1. Mengidentifikasi kebijakan ServiceInfo yang menyebabkan error. Nama kebijakan muncul di elemen faultstring respons error. Misalnya, di faultstring berikut, nama kebijakan ServiceInfo yang gagal adalah ExecuteGeocodingRequest.

    "faultstring": "ServiceCallout[ExecuteGeocodingRequest]"

  2. Dalam kebijakan ServiceInfo yang gagal, periksa elemen <URL>. Jika formatnya salah atau nama host tidak valid atau tidak dapat dijangkau, itulah penyebab error ini. Misalnya, kebijakan Service callout berikut menentukan <URL> yang tidak valid:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="GeocodingRequest"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://</URL>
    </HTTPTargetConnection>
</ServiceCallout>

    Elemen <URL> hanya memiliki protokol http://, tetapi tidak memiliki nama host yang valid; oleh karena itu, kebijakan ServiceInfo gagal dengan error: Execution of ServiceCallout ExecuteGeocodingRequest failed. Reason: Host not reachable.

Resolusi

Pastikan elemen <URL> di kebijakan ServiceInfo yang gagal memiliki URL yang valid dengan nama host yang dapat dijangkau.

Untuk memperbaiki kebijakan ServiceInfo yang ditampilkan di atas, Anda dapat mengubah elemen <URL> untuk menentukan URL yang valid:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ServiceCallout name="ExecuteGeocodingRequest">
    <Request variable="GeocodingRequest"/>
    <Response>GeocodingResponse</Response>
    <HTTPTargetConnection>
        <URL>http://maps.googleapis.com/maps/api/geocode/json</URL>
    </HTTPTargetConnection>
</ServiceCallout>

Penyebab: Error server backend

Server backend akan menampilkan respons error 4XX atau 5XX.

Diagnosis

  1. Mengidentifikasi kebijakan ServiceInfo yang menyebabkan error. Nama kebijakan muncul di elemen faultstring respons error. Misalnya, di faultstring berikut, nama kebijakan ServiceInfo yang gagal adalah ExecuteGeocodingRequest.

    "faultstring": "ServiceCallout[ExecuteGeocodingRequest]

  2. Periksa faultstring dalam isi respons error dan periksa apakah ada kode respons 4XX atau 5XX yang tercantum di Reason. Misalnya, faultstring berikut dengan jelas menunjukkan bahwa kode respons 502 ditampilkan dari server backend:

    "faultstring": "Execution of ServiceCallout ExecuteGeocodingRequest failed. Reason: ResponseCode 502 is treated as error"

Resolusi

Setelah menentukan kode respons error, Anda dapat memecahkan masalah ini seperti halnya melakukan error 4XX atau 5XX.