Kebijakan SOAPMessageValidation

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Kebijakan SOAPMessageValidation melakukan hal berikut:

• Memvalidasi semua pesan XML terhadap skema XSD-nya
• Memvalidasi pesan SOAP terhadap definisi WSDL
• Menentukan format pesan JSON dan XML yang baik

Meskipun nama kebijakan ini di UI adalah SOAPMessageValidation, kebijakan ini memvalidasi lebih banyak daripada pesan SOAP. Bagian ini menyebut kebijakan ini sebagai kebijakan MessageValidation.

Kebijakan ini adalah Kebijakan standar dan dapat di-deploy ke jenis lingkungan apa pun. Untuk mengetahui informasi tentang jenis kebijakan dan ketersediaan dengan setiap jenis lingkungan, lihat Jenis kebijakan.

Tentang kebijakan MessageValidation

Manfaat

Validasi pesan memberikan manfaat berikut:

• Segera memberi tahu developer aplikasi yang menggunakan API Anda jika permintaan mereka tidak sesuai atau tidak lengkap.
• Menunjukkan masalah dalam permintaan, seperti tag XML yang tidak ditutup dengan benar.
• Melindungi layanan backend dengan memblokir pesan XML atau SOAP dengan struktur yang dapat menyebabkan perilaku yang tidak dapat diprediksi.
• Mengurangi waktu yang dihabiskan untuk memecahkan masalah, menelusuri forum, atau berkonsultasi dengan dukungan teknis.
• Mendorong developer untuk memahami definisi WSDL skema XML guna menghilangkan error validasi, sehingga skema XML yang dipahami dengan baik menjadi komponen utama dokumentasi API Anda.

Video

Tonton video berikut untuk mempelajari kebijakan MessageValidation lebih lanjut:

Video	Deskripsi
Memvalidasi permintaan XML	Validasi permintaan XML untuk API menggunakan kebijakan MessageValidation.
Memvalidasi permintaan JSON	Validasi permintaan JSON untuk API menggunakan kebijakan MessageValidation.

Elemen <MessageValidation>

Menentukan kebijakan MessageValidation.

Nilai Default	Lihat tab Kebijakan Default, di bawah
Wajib?	Opsional
Jenis	Objek kompleks
Elemen Induk	t/a
Elemen Turunan	<DisplayName> <Element> <ResourceURL> <SOAPMessage> <Source>

Sintaks

Elemen <MessageValidation> menggunakan sintaksis berikut:

<MessageValidation
  continueOnError="[false|true]"
  enabled="[true|false]"
  name="policy_name"
>
    <!-- All MessageValidation child elements are optional -->
    <DisplayName>policy_display_name</DisplayName>
    <Element namespace="element_namespace">element_to_validate</Element>
    <SOAPMessage version="[ 1.1 | 1.2 | 1.1/1.2 ]"/>
    <Source>message_to_validate</Source>
    <ResourceURL>validation_WSDL_or_XSD</ResourceURL>

</MessageValidation>

Kebijakan Default

Contoh berikut menunjukkan setelan default saat Anda menambahkan kebijakan MessageValidation ke alur di UI Apigee:

<MessageValidation continueOnError="false" enabled="true" name="SOAP-Message-Validation-1">
  <DisplayName>SOAP Message Validation-1</DisplayName>
  <Properties/>
  <Element namespace="http://sample.com">sampleObject</Element>
  <SOAPMessage/>
  <Source>request</Source>
  <ResourceURL>wsdl://SOAP-Message-Validation-1.wsdl</ResourceURL>
</MessageValidation>

Elemen ini memiliki atribut berikut yang sama untuk semua kebijakan:

Atribut	Default	Wajib?	Deskripsi
name	T/A	Wajib	Nama internal kebijakan. Nilai atribut name dapat berisi huruf, angka, spasi, tanda hubung, garis bawah, dan titik. Nilai ini tidak boleh melebihi 255 karakter. Atau, gunakan elemen <DisplayName> untuk memberi label kebijakan di editor proxy UI pengelolaan dengan nama natural-language yang berbeda.
continueOnError	false	Opsional	Setel ke false untuk menampilkan error jika kebijakan gagal. Ini adalah perilaku yang wajar untuk sebagian besar kebijakan. Setel ke true agar eksekusi alur tetap berlanjut bahkan setelah kebijakan gagal. Lihat juga: Aturan error HANYA dipicu dalam status error (tentang continueOnError) Menangani kesalahan dalam alur saat ini
enabled	true	Opsional	Setel ke true untuk menerapkan kebijakan. Setel ke false untuk menonaktifkan kebijakan. Kebijakan tidak akan diterapkan meskipun tetap melekat pada alur.
async	false	Tidak digunakan lagi	Atribut ini sudah tidak digunakan lagi.

Contoh

Contoh berikut menunjukkan beberapa cara menggunakan kebijakan MessageValidation:

1: Validasi XSD

Anda dapat menggunakan kebijakan Validasi Pesan untuk memvalidasi payload permintaan pesan XML terhadap skema XSD.

1. Buat file resource XSD baru. Misalnya, note-schema.xsd:

   <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
     <xs:element name="note">
       <xs:complexType>
         <xs:sequence>
           <xs:element name="to" type="xs:string"/>
           <xs:element name="from" type="xs:string"/>
           <xs:element name="heading" type="xs:string"/>
           <xs:element name="body" type="xs:string"/>
         </xs:sequence>
       </xs:complexType>
     </xs:element>
   </xs:schema>

2. Tambahkan kebijakan Validasi Pesan SOAP ke pra-alur endpoint proxy Anda:
   1. Tentukan lokasi file resource XSD dengan elemen <ResourceURL>. Contoh:

      ...
        <ResourceURL>xsd://note-schema.xsd</ResourceURL>
      ...

   2. Hapus elemen <SOAPMessage> dan <Element> dari definisi kebijakan.

   Definisi kebijakan Anda akan terlihat seperti berikut:

   <MessageValidation continueOnError="false"
       enabled="true" name="validateXMLRequest">
     <DisplayName>My XML Validator</DisplayName>
     <Properties/>
     <Source>request</Source>
     <ResourceURL>xsd://note-schema.xsd</ResourceURL>
   </MessageValidation>

3. Kirim permintaan POST ke proxy API dengan XML sebagai payload pesan, seperti yang ditunjukkan dalam contoh berikut:

   curl -v -X POST -H 'Content-Type: application/xml' http://my-test.apigee.net/v1/xsd-mock
     -d '<note>
     <to>Fred Rogers</to>
     <from>Nick Danger</from>
     <heading>Greetings from my neighborhood</heading>
     <body>Just writing to say hello.</body>
   </note>'

   Perhatikan bahwa header Content-type ditetapkan ke application/xml.

   Anda juga dapat membuat file data untuk payload dan mereferensikannya dengan perintah yang mirip dengan berikut ini:

   curl -v -X POST -H 'Content-type: application/xml' http://my-test.apigee.net/v1/xsd-mock
     --data '@../examples/note-payload.xml'

Anda akan menerima respons HTTP 200. Bergantung pada endpoint target, Anda mungkin menerima detail tambahan tentang permintaan. Misalnya, jika Anda menggunakan http://httpbin.org/post sebagai endpoint target dan menentukan output -v (verbose), responsnya akan mirip dengan berikut:

< HTTP/1.1 200 OK
< Date: Wed, 16 May 2018 21:24:54 GMT
< Content-Type: application/xml
< Content-Length: 431
< Connection: keep-alive
< Server: gunicorn/19.8.1
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Credentials: true
< Via: 1.1 vegur
{
  "args":{},
  "data":"<note><to>fred</to><from>nick</from><heading>hello</heading>
    <body>Just writing to say hello.</body></note>",
  "files":{},
  "form":{},
  "headers": {
    "Accept":"*/*",
    "Connection":"close",
    "Content-Length":"106",
    "Content-Type":"application/xml",
    "Host":"httpbin.org",
    "User-Agent":"curl/7.58.0"
  },
  "json":null,
  "origin":"10.1.1.1, 104.154.179.1",
  "url":"http://httpbin.org/post"
}

Untuk memverifikasi bahwa validasi XSD Anda berfungsi, coba masukkan tag lain ke dalam isi permintaan Anda. Contoh:

curl -v -X POST -H 'Content-Type: application/xml' http://my-test.apigee.net/v1/xsd-mock
  -d '<note>
  <to>Fred Rogers</to>
  <from>Nick Danger</from>
  <heading>Greetings from my neighborhood</heading>
  <body>Just writing to say hello.</body>
  <badTag>Not good</badTag>
</note>'

Anda akan menerima error validasi.

2: Validasi SOAP

Anda dapat menggunakan kebijakan Message Validation untuk memvalidasi payload permintaan pesan SOAP terhadap WSDL.

1. Buat file resource WSDL baru. Misalnya, "example-wsdl.wsdl":

   Melihat WSDL Lengkap

   <?xml version="1.0" encoding="UTF-8"?>
   <wsdl:definitions targetNamespace="https://example.com/gateway"
       xmlns:tns="https://example.com/gateway"
       xmlns:types="https://example.com/gateway/types"
       xmlns:xsd="http://www.w3.org/2001/XMLSchema"
       xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
       xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/">
     <wsdl:types>
       <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
           targetNamespace="https://example.com/gateway/types"
           elementFormDefault="qualified">
         <xsd:element name="MyType">
           <xsd:complexType>
             <xsd:sequence>
               <xsd:element name="ID" nillable="false" minOccurs="1" maxOccurs="1"/>
             </xsd:sequence>
           </xsd:complexType>
         </xsd:element>
       </xsd:schema>
       <schema attributeFormDefault="unqualified" elementFormDefault="qualified"
           targetNamespace="https://example.com/gateway"
           xmlns="http://www.w3.org/2001/XMLSchema">
         <xsd:import namespace="https://example.com/gateway/types"/>
         <element name="getID">
           <complexType>
             <sequence>
               <element ref="types:MyType"/>
             </sequence>
           </complexType>
         </element>
       </schema>
     </wsdl:types>
   
     <wsdl:message name="getRequest">
       <wsdl:part name="getRequest" element="tns:getID"/>
     </wsdl:message>
     <wsdl:message name="getResponse">
       <wsdl:part name="getResponse" element="tns:getID"/>
     </wsdl:message>
   
     <wsdl:portType name="PortType">
       <wsdl:operation name="get">
         <wsdl:input name="methodRequest" message="tns:getRequest"/>
         <wsdl:output name="methodResponse" message="tns:getResponse"/>
       </wsdl:operation>
     </wsdl:portType>
   
     <wsdl:service name="Gateway">
       <wsdl:port name="GatewaySoap" binding="tns:SoapBinding">
         <wsdlsoap:address location="https://example.com/gateway"/>
       </wsdl:port>
     </wsdl:service>
   
     <wsdl:binding name="SoapBinding" type="tns:PortType">
       <wsdlsoap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
   
       <wsdl:operation name="get">
         <wsdlsoap:operation soapAction="get"/>
         <wsdl:input name="methodRequest"/>
         <wsdl:output name="methodResponse"/>
       </wsdl:operation>
   
     </wsdl:binding>
   </wsdl:definitions>

2. Tambahkan kebijakan Validasi Pesan SOAP ke pra-alur endpoint proxy Anda:
   1. Tetapkan atribut version elemen <SOAPMessage> ke versi protokol SOAP yang ingin Anda validasi. Misalnya, "1.1":

      ...
        <SOAPMessage version="1.1"/>
      ...

   2. Tetapkan nilai elemen <Element> ke elemen yang ingin Anda validasi:

      ...
        <Element namespace="https://example.com/gateway">getID</Element>
      ...

      <Element> menentukan turunan pertama di bawah elemen <Body> dalam amplop permintaan SOAP.

      Tetapkan atribut namespace ke namespace untuk turunan tersebut.

   3. Tentukan lokasi file resource WSDL dengan elemen <ResourceURL>. Contoh:

      ...
        <ResourceURL>wsdl://example-wsdl.wsdl</ResourceURL>
      ...

   Definisi kebijakan Anda akan terlihat seperti berikut:

   <MessageValidation continueOnError="false"
       enabled="true" name="validateSOAPRequest">
     <DisplayName>My SOAP Validator</DisplayName>
     <Properties/>
     <Source>request</Source>
     <SOAPMessage version="1.1"/>
     <Element namespace="https://example.com/gateway">getID</Element>
     <ResourceURL>wsdl://example-wsdl.wsdl</ResourceURL>
   </MessageValidation>

3. Kirim permintaan POST ke proxy API Anda dengan amplop SOAP sebagai payload pesan, seperti yang ditunjukkan dalam contoh berikut:

   curl -v -X POST -H 'Content-Type: application/xml' http://my-test.apigee.net/v1/xsd-mock
     -d '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
       xmlns:prox="https://example.com/gateway" xmlns:typ="https://example.com/gateway/types">
     <soapenv:Header/>
     <soapenv:Body>
       <prox:getID>
         <typ:MyType>
           <typ:ID>42</typ:ID>
         </typ:MyType>
       </prox:getID>
     </soapenv:Body>
   </soapenv:Envelope>'

   Perhatikan bahwa header Content-type ditetapkan ke "application/xml".

   Anda juga dapat membuat file data untuk payload dan mereferensikannya dengan perintah yang mirip dengan berikut ini:

   curl -v -X POST -H 'Content-type: application/xml' http://my-test.apigee.net/v1/xsd-mock
     --data '@../examples/soap-payload.xml'

Anda akan menerima respons HTTP 200. Bergantung pada endpoint target, Anda mungkin menerima detail tambahan tentang permintaan. Misalnya, jika Anda menggunakan http://httpbin.org/post sebagai endpoint target, responsnya akan mirip dengan berikut ini:

< HTTP/1.1 200 OK
< Date: Wed, 16 May 2018 21:24:54 GMT
< Content-Type: application/xml
< Content-Length: 431
< Connection: keep-alive
< Server: gunicorn/19.8.1
< Access-Control-Allow-Origin: *
< Access-Control-Allow-Credentials: true
< Via: 1.1 vegur
{
  "args":{},
  "data":"<note><to>fred</to><from>nick</from><heading>hello</heading>
    <body>Just writing to say hello.</body></note>",
  "files":{},
  "form":{},
  "headers": {
    "Accept":"*/*",
    "Connection":"close",
    "Content-Length":"106",
    "Content-Type":"application/xml",
    "Host":"httpbin.org",
    "User-Agent":"curl/7.58.0"
  },
  "json":null,
  "origin":"10.1.1.1, 104.154.179.1",
  "url":"http://httpbin.org/post"
}

3: XML/JSON yang terbentuk dengan baik

Anda dapat menggunakan kebijakan Validasi Pesan untuk mengonfirmasi bahwa payload pesan JSON atau XML dibuat dengan benar (tidak sama dengan validasi). Kebijakan ini memastikan bahwa struktur dan konten memenuhi standar yang diterima, termasuk:

• Ada satu elemen root
• Tidak ada karakter terlarang dalam konten
• Objek dan tag disusun bertingkat dengan benar
• Tag awal dan akhir cocok

Untuk memeriksa payload XML atau JSON yang disusun dengan baik:

1. Tambahkan kebijakan Validasi Pesan SOAP ke pra-alur endpoint proxy Anda.
2. Hapus elemen <ResourceURL>, <SOAPMessage>, dan <Element> dari definisi kebijakan.

   Definisi kebijakan Anda akan terlihat seperti berikut:

   <MessageValidation async="false" continueOnError="false"
       enabled="true" name="validateXMLRequest">
     <DisplayName>My JSON Checker</DisplayName>
     <Properties/>
     <Source>request</Source>
   </MessageValidation>

3. Kirim permintaan POST ke proxy API Anda, seperti yang ditunjukkan pada contoh berikut:

   curl -v -X POST -H 'Content-Type: application/json' http://my-test.apigee.net/v1/xsd-mock
     -d '{
   "note": {
     "to": "Fred Rogers",
     "from": "Nick Danger",
     "header": "Greetings from my neighborhood",
     "body": "Just writing to say hello."
     }
   }'

   Perhatikan bahwa header Content-type ditetapkan ke application/json.

   Untuk memeriksa file XML apakah sudah terbentuk dengan baik, gunakan XML sebagai payload pesan dan tetapkan Content-type ke application/xml.

Anda akan menerima respons HTTP 200. Saat mengirim payload pesan yang tidak berisi XML atau JSON yang disusun dengan baik, Anda akan menerima error steps.messagevalidation.Failed.

Referensi elemen turunan

Bagian ini menjelaskan elemen turunan <MessageValidation>.

<DisplayName>

Gunakan selain atribut name untuk memberi label kebijakan di editor proxy UI pengelolaan dengan nama yang berbeda dan lebih alami.

Elemen <DisplayName> bersifat umum untuk semua kebijakan.

Nilai Default	T/A
Wajib?	Opsional. Jika Anda menghilangkan <DisplayName>, nilai atribut name kebijakan akan digunakan.
Jenis	String
Elemen Induk	<PolicyElement>
Elemen Turunan	Tidak ada

Elemen <DisplayName> menggunakan sintaksis berikut:

Sintaksis

<PolicyElement>
  <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
  ...
</PolicyElement>

Contoh

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

Elemen <DisplayName> tidak memiliki atribut atau elemen turunan.

<Element>

Menentukan elemen dalam pesan yang akan divalidasi. Ini adalah turunan pertama di bawah elemen <Body> dalam amplop permintaan SOAP.

Nilai Default	sampleObject
Wajib?	Opsional
Jenis	String
Elemen Induk	<MessageValidation>
Elemen Turunan	Tidak ada

Elemen <Element> menggunakan sintaksis berikut:

Sintaks

...
  <Element namespace="element_namespace">element_to_validate</Element>
...

Contoh 1

Contoh berikut menentukan satu elemen yang akan divalidasi:

...
<Element namespace="https://example.com/gateway">getID</Element>
...

Contoh 2

Anda dapat menentukan lebih dari satu elemen untuk divalidasi dengan menambahkan beberapa elemen <Element>:

...
<Element namespace="https://example.com/gateway">getID</Element>
<Element namespace="https://example.com/gateway">getDetails</Element>
...

Elemen <Element> memiliki atribut berikut:

Atribut	Default	Wajib?	Deskripsi
namespace	"http://sample.com"	Opsional	Menentukan namespace elemen yang akan divalidasi.

<ResourceURL>

Mengidentifikasi skema XSD atau definisi WSDL yang akan digunakan untuk memvalidasi pesan sumber.

Nilai Default	wsdl://display_name.wsdl
Wajib?	Opsional
Jenis	String
Elemen Induk	<MessageValidation>
Elemen Turunan	Tidak ada

Elemen <ResourceURL> menggunakan sintaksis berikut:

Sintaks

...
  <ResourceURL>[wsdl|xsd]://validation_WSDL_or_XSD</ResourceURL>
...

Contoh

Untuk file XML:

...
<ResourceURL>xsd://note-schema.xsd</ResourceURL>
...

Untuk WSDL:

...
<ResourceURL>wsdl://example-wsdl.wsdl</ResourceURL>
...

Nilai <ResourceURL> harus mengarah ke file resource di proxy API Anda. API ini tidak dapat merujuk ke resource eksternal melalui HTTP atau HTTPS.

Jika Anda tidak menentukan nilai untuk <ResourceURL>, pesan akan diperiksa untuk JSON atau XML yang terbentuk dengan baik jika header Content-type masing-masing adalah application/json atau application/xml.

Elemen <ResourceURL> tidak memiliki elemen turunan atau atribut.

Menggunakan XSD untuk validasi

Jika payload XML yang Anda validasi dengan kebijakan MessageValidation mereferensikan skema lain, Anda harus menambahkan awalan xsd ke file XSD yang disertakan di atribut schemaLocation.

Contoh skema berikut terdiri dari beberapa XSD:

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
    elementFormDefault="qualified" attributeFormDefault="unqualified">
  <xs:include schemaLocation="xsd://note-schema.xsd"/>
  <xs:include schemaLocation="xsd://letter-schema.xsd"/>
  <xs:include schemaLocation="xsd://user-schema.xsd"/>
</xs:schema>

Catatan: Anda hanya dapat menyertakan atau mengimpor XSD jika merupakan file resource di Proxy API Anda. Anda tidak dapat menyertakan file XSD eksternal.

Menggunakan WSDL untuk validasi

WSDL harus menentukan minimal satu skema. Jika tidak mereferensikan minimal satu skema, kebijakan MessageValidation akan gagal.

Kedalaman impor maksimum untuk skema adalah 10. Jika Anda melebihi jumlah impor bertingkat tersebut, kebijakan MessageValidation akan gagal.

<SOAPMessage>

Menentukan versi SOAP yang akan divalidasi oleh kebijakan MessageValidation.

Nilai Default	t/a
Wajib?	Opsional
Jenis	t/a
Elemen Induk	<MessageValidation>
Elemen Turunan	Tidak ada

Elemen <SOAPMessage> menggunakan sintaksis berikut:

Sintaks

...
  <SOAPMessage version="[ 1.1 | 1.2 | 1.1/1.2 ]"/>
...

Contoh

...
<SOAPMessage version="1.1"/>
...

Elemen <SOAPMessage> memiliki atribut berikut:

Atribut	Default	Wajib?	Deskripsi
version	Tidak ada	Opsional	Versi SOAP yang digunakan kebijakan ini untuk memvalidasi pesan SOAP. Nilai yang valid adalah: "1.1" "1.2" "1.1/1.2"

Untuk informasi selengkapnya, lihat Dari SOAP/1.1 ke SOAP Versi 1.2 dalam 9 poin.

<Source>

Mengidentifikasi pesan sumber yang akan divalidasi. Nilai elemen ini adalah nama pesan yang ingin Anda validasi.

Jika Anda tidak menetapkan <Source>, kebijakan ini akan ditetapkan secara default ke message, yang merujuk pada pesan permintaan lengkap (dalam alur permintaan) atau pesan respons (dalam alur respons), termasuk payload apa pun. Anda juga dapat menetapkannya secara eksplisit ke request atau response untuk merujuk ke permintaan atau respons.

Nilai Default	permintaan
Wajib?	Opsional
Jenis	String
Elemen Induk	<MessageValidation>
Elemen Turunan	Tidak ada

Elemen <Source> menggunakan sintaksis berikut:

Sintaks

...
  <Source>message_to_validate</Source>
...

Contoh

...
<Source>request</Source>
...

Selain message, request, dan response, Anda dapat menetapkan nilai <Source> ke nama pesan apa pun dalam alur Anda. Namun, jika Anda melakukannya, Anda harus membuat pesan kustom dengan nama tersebut dalam alur sebelum kebijakan ini dijalankan. Jika tidak, Anda akan mendapatkan error.

Jika nilai <Source> tidak dapat di-resolve dalam alur pesan atau di-resolve ke jenis pesan, salah satu hal berikut akan terjadi:

• Jika nilai null: Apigee akan menampilkan error steps.messagevalidation.SourceMessageNotAvailable.
• Jika jenis non-pesan: Apigee akan menampilkan error steps.messagevalidation.NonMessageVariable.

Elemen <Source> tidak memiliki atribut atau elemen turunan.

Kode error

Bagian ini menjelaskan kode kesalahan dan pesan error yang ditampilkan dan variabel kesalahan yang disetel oleh Apigee saat kebijakan ini memicu error. Informasi ini penting untuk diketahui apakah Anda mengembangkan aturan kesalahan untuk menangani kesalahan. Untuk mempelajari lebih lanjut, lihat Yang perlu Anda ketahui tentang error kebijakan dan Menangani kesalahan.

Error runtime

Error ini dapat terjadi saat kebijakan dieksekusi.

Perlu bantuan untuk mengatasi error? Klik di kolom Perbaiki untuk mengetahui informasi pemecahan masalah selengkapnya.

Gunakan API Monitoring untuk menyelidiki kode masalah dan mendiagnosis masalah dengan lebih cepat. Lihat Menyiapkan pemberitahuan kode kesalahan kebijakan untuk mengetahui contohnya. Lihat Referensi kode kesalahan untuk melihat daftar lengkap semua kode kesalahan yang dapat Anda tangani dengan Pemantauan API.

Kode kesalahan	Status HTTP	Penyebab	Perbaikan
steps.messagevalidation.SourceMessageNotAvailable	500	Error ini terjadi jika variabel yang ditentukan dalam elemen <Source> kebijakan: di luar cakupan (tidak tersedia di alur spesifik tempat kebijakan sedang dijalankan) atau tidak dapat diselesaikan (tidak ditentukan)
steps.messagevalidation.NonMessageVariable	500	Error ini terjadi jika elemen <Source> dalam kebijakan SOAPMessageValidation disetel ke variabel yang bukan jenis pesan. Variabel jenis pesan mewakili keseluruhan permintaan dan respons HTTP. Variabel alur Apigee bawaan request, response, dan message adalah jenis pesan. Untuk mempelajari variabel pesan lebih lanjut, baca Referensi variabel.
steps.messagevalidation.Failed	500	Error ini terjadi jika kebijakan SOAPMessageValidation gagal memvalidasi payload pesan input terhadap skema XSD atau definisi WSDL. Hal ini juga akan terjadi jika ada format JSON atau XML dalam pesan payload dengan format yang salah.

Error saat deployment

Error ini dapat terjadi saat Anda men-deploy proxy yang berisi kebijakan ini.

Perlu bantuan untuk mengatasi error? Klik di samping deskripsi penyebab error untuk membuka halaman pemecahan masalah.

Nama error	Penyebab	Perbaikan
InvalidResourceType	Elemen <ResourceURL> dalam kebijakan SOAPMessageValidation disetel ke jenis resource yang tidak didukung oleh kebijakan tersebut.
ResourceCompileFailed	Skrip resource yang direferensikan dalam elemen <ResourceURL> kebijakan SOAPMessageValidation berisi error yang mencegah kompilasinya.
RootElementNameUnspecified	Elemen <Element> dalam kebijakan SOAPMessageValidation tidak berisi nama elemen root.
InvalidRootElementName	Elemen <Element> dalam kebijakan SOAPMessageValidation berisi nama elemen root yang tidak mematuhi aturan XML untuk penamaan elemen yang valid.

Skema

Setiap jenis kebijakan ditentukan oleh skema XML (.xsd). Sebagai referensi, skema kebijakan tersedia di GitHub.

Topik terkait

• Kebijakan Perlindungan Ancaman XML
• Kebijakan XML ke JSON
• Kebijakan JSON ke XML
• Kebijakan Perlindungan Ancaman JSON