Halaman ini diterjemahkan oleh Cloud Translation API.

Pemecahan masalah error runtime Operasi Peta Nilai Kunci

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

UnsupportedOperationException

Kode error

java.lang.UnsupportedOperationException

Isi respons error

{
   "fault":{
      "faultstring":"java.lang.UnsupportedOperationException",
      "detail":{
         "errorcode":"Internal Server Error"
      }
   }
}

Penyebab

Error ini terjadi jika atribut mapIdentifier disetel ke string kosong dalam kebijakan Operasi Peta Nilai Kunci.

Diagnosis

Periksa semua kebijakan Operasi Peta Nilai Kunci di Proxy API tertentu tempat kegagalan terjadi. Jika ada kebijakan Operasi Peta Nilai Kunci yang menetapkan atribut mapIdentifier sebagai string kosong, hal tersebut adalah penyebab error.

Misalnya, kebijakan Operasi Peta Nilai Kunci berikut memiliki mapIdentifier kosong:

<KeyValueMapOperations async="false" continueOnError="false" enabled="true" name="StoreKvm" mapIdentifier="">
    <DisplayName>StoreKvm</DisplayName>
    <Properties/>
    <ExclusiveCache>false</ExclusiveCache>
    <ExpiryTimeInSecs>300</ExpiryTimeInSecs>
    <Put override="true">
        <Key>
            <Parameter ref="request.queryparam.key"/>
        </Key>
        <Value ref="request.queryparam.value"/>
    </Put>
    <Scope>apiproxy</Scope>
</KeyValueMapOperations>

Resolusi

Pastikan atribut mapIdentifier ditetapkan ke peta nilai kunci yang valid dalam kebijakan Operasi Peta Nilai Kunci.

Untuk memperbaiki contoh kebijakan yang ditampilkan di atas, Anda dapat menentukan mapIdentifier ke peta nilai kunci UserLocationMap yang ada.

<KeyValueMapOperations async="false" continueOnError="false" enabled="true" name="StoreKvm" mapIdentifier="UserLocationMap">
    <DisplayName>StoreKvm</DisplayName>
    <Properties/>
    <ExclusiveCache>false</ExclusiveCache>
    <ExpiryTimeInSecs>300</ExpiryTimeInSecs>
    <Put override="true">
        <Key>
            <Parameter ref="request.queryparam.key"/>
        </Key>
        <Value ref="request.queryparam.value"/>
    </Put>
    <Scope>apiproxy</Scope>
</KeyValueMapOperations>

SetVariableFailed

Kode error

steps.keyvaluemapoperations.SetVariableFailed

Isi respons error

{
   "fault":{
      "faultstring":"Failed to set variable variable_name in KeyValueMapStepDefinition policy_name",
      "detail":{
         "errorcode":"steps.keyvaluemapoperations.SetVariableFailed"
      }
   }
}

Contoh Pesan Error

{
   "fault":{
      "faultstring":"Failed to set variable myvar in KeyValueMapStepDefinition EncryptedKVM",
      "detail":{
         "errorcode":"steps.keyvaluemapoperations.SetVariableFailed"
      }
   }
}

Penyebab

Error ini terjadi jika Anda mencoba mengambil nilai dari peta nilai kunci terenkripsi dan menetapkan nilai ke variabel yang namanya tidak memiliki awalan private.. Awalan, yang diperlukan untuk tujuan keamanan dasar selama proses debug, menyembunyikan nilai terenkripsi dari sesi Pelacakan dan debug proxy API.

Diagnosis

1. Mengidentifikasi kebijakan Operasi Peta Nilai Kunci tempat error terjadi dan nama variabel yang nilainya tidak dapat ditetapkan. Anda dapat menemukan kedua item ini di elemen faultstring respons error. Misalnya, dalam faultstring berikut, nama kebijakan adalah EncryptedKVM dan variabelnya adalah myvar:

  "faultstring":"Failed to set variable myvar in KeyValueMapStepDefinition EncryptedKVM"

1. Dalam XML kebijakan Operasi Peta Nilai Kunci yang gagal, verifikasi bahwa nama variabel yang ditentukan dalam atribut assignTo dari elemen <Get> cocok dengan nama variabel yang diidentifikasi dalam string fault (langkah #1 di atas). Misalnya, kebijakan Operasi Peta Nilai Kunci berikut menentukan variabel bernama myvar di elemen <Get>, yang cocok dengan yang ada di faultstring:

  <KeyValueMapOperations async="false" continueOnError="false" enabled="true" name="Key-Value-Map-Operations-1" mapIdentifier="testEncrypted">
      <DisplayName>KeyValueMapOperations-1</DisplayName>
      <Properties/>
      <ExclusiveCache>false</ExclusiveCache>
      <ExpiryTimeInSecs>300</ExpiryTimeInSecs>
      <Get assignTo="myvar" index="1">
          <Key>
              <Parameter>foo</Parameter>
          </Key>
      </Get>
      <Scope>environment</Scope>
  </KeyValueMapOperations>

Periksa apakah peta nilai kunci yang ditentukan dalam atribut mapIdentifier adalah KVM terenkripsi. Jika KVM dienkripsi pada cakupan lingkungan, Anda dapat memverifikasi bahwa KVM tersebut dienkripsi di UI Edge. Jika tidak, jika dibuat di cakupan organisasi atau apiproxy, Anda perlu menggunakan Management API untuk memverifikasi apakah kunci enkripsi tersebut dienkripsi. Lihat juga Mengelola dan menggunakan KVM.

Untuk memeriksa apakah KVM cakupan lingkungan dienkripsi di UI Edge:
1. Di UI Edge, klik Admin di menu navigasi sebelah kiri.
2. Klik Environments.
3. Klik Peta Nilai Kunci.
4. Temukan Peta Nilai Kunci yang ingin Anda gunakan.
5. Klik panah di sebelah kiri nama untuk memperluas daftar nilai.
6. Peta Nilai Kunci Terenkripsi menampilkan nilai yang disamarkan dengan tanda bintang di UI (*****) seperti yang ditunjukkan di Tentang KVM Terenkripsi.
Untuk memeriksa apakah KVM yang dicakup di tingkat organisasi, lingkungan, atau apiproxy dienkripsi, gunakan Management API. Jika Anda menggunakan API, contoh respons yang menampilkan setelan terenkripsi dan tanda bintang untuk nilainya akan terlihat seperti ini:
```
{
  "encrypted": true,
  "entry": [
    {
      "name": "foo",
      "value": "*****"
    }
  ],
  "name": "encrypted"
}
```
Jika peta nilai kunci adalah KVM terenkripsi dan nama variabel yang digunakan dalam atribut assignTo elemen <Get> tidak memiliki awalan private. Jika demikian, itulah penyebab error.

Dalam contoh kebijakan Operasi Peta Nilai Kunci yang ditampilkan di atas, peta nilai kunci testEncrypted dienkripsi dan nama variabel myvar tidak memiliki awalan private. Oleh karena itu, Anda menerima kode error:
```
steps.keyvaluemapoperations.SetVariableFailed
```

Resolusi

Pastikan nama variabel memiliki awalan private. di atribut assignTo dari elemen <Get> dalam kebijakan Operasi Peta Nilai Kunci jika peta nilai kunci yang digunakan dienkripsi.

Untuk memperbaiki contoh kebijakan Operasi Peta Nilai Kunci yang ditampilkan di atas, Anda dapat mengubah nilai atribut assignTo menjadi private.myvar:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<KeyValueMapOperations async="false" continueOnError="false" enabled="true" name="Key-Value-Map-Operations-1" mapIdentifier="testEncrypted">
    <DisplayName>KeyValueMapOperations-1</DisplayName>
    <Properties/>
    <ExclusiveCache>false</ExclusiveCache>
    <ExpiryTimeInSecs>300</ExpiryTimeInSecs>
    <Get assignTo="private.myvar" index="1">
        <Key>
            <Parameter>foo</Parameter>
        </Key>
    </Get>
    <Scope>environment</Scope>
</KeyValueMapOperations>