Rozwiązywanie problemów z błędami podczas działania map klucz-wartość

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info

UnsupportedOperationException

Kod błędu

java.lang.UnsupportedOperationException

Treść odpowiedzi na błąd

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

Przyczyna

Ten błąd występuje, jeśli atrybut mapIdentifier ma w zasadzie operacji mapowania klucz-wartość ustawioną wartość pusty ciąg znaków.

Diagnostyka

1. Sprawdź wszystkie zasady operacji mapowania klucz-wartość w ramach konkretnego interfejsu Proxy API, w którym wystąpił błąd. Jeśli istnieje jakakolwiek zasada operacji mapy klucz-wartość, w której atrybut mapIdentifier ma ustawiony pusty ciąg znaków, jest to przyczyna błędu.

   Na przykład ta zasada operacji mapy klucz-wartość ma pustą wartość mapIdentifier:

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

Rozdzielczość

Upewnij się, że atrybut mapIdentifier jest prawidłową mapą klucz-wartość w zasadach operacji mapowania klucz-wartość.

Aby poprawić przykładową zasadę przedstawioną powyżej, możesz określić mapIdentifier w istniejącej mapie klucz-wartość UserLocationMap.

<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

Kod błędu

steps.keyvaluemapoperations.SetVariableFailed

Treść odpowiedzi na błąd

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

Przykładowy komunikat o błędzie

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

Przyczyna

Ten błąd występuje, gdy próbujesz pobrać wartość z zaszyfrowanej mapy klucz-wartość i przypisać ją do zmiennej, której nazwa nie zawiera przedrostka private.. Prefiks, który jest wymagany ze względu na podstawowe bezpieczeństwo podczas debugowania, ukrywa zaszyfrowane wartości przed śledzeniem serwera proxy interfejsu API i sesjami debugowania.

Diagnostyka

1. Określ regułę operacji mapowania par klucz-wartość, w której wystąpił błąd, oraz nazwę zmiennej, której nie można ustawić wartości. Oba te elementy znajdziesz w elemencie faultstring odpowiedzi na błąd. Na przykład w tym faultstring nazwa zasad to EncryptedKVM, a zmienna to myvar:

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

1. W pliku XML z błędami mapy wartości klucza sprawdź, czy nazwa zmiennej określonej w atrybucie assignTo elementu <Get> jest zgodna z nazwą zmiennej podaną w ciągu błędu (krok 1 powyżej). Na przykład w tej polityce operacji mapowania kluczy i wartości w elemencie <Get> jest określona zmienna o nazwie myvar, która odpowiada zmiennej w elemencie 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>

1. Sprawdź, czy mapa klucz-wartość określona w atrybucie mapIdentifier jest zaszyfrowaną mapą klucz-wartość. Jeśli KVM jest szyfrowany w zakresie środowiska, możesz sprawdzić, czy jest szyfrowany w interfejsie Edge. W przeciwnym razie, jeśli został utworzony w zakresie organizacji lub apiproxy, musisz użyć interfejsu Management API, aby sprawdzić, czy jest zaszyfrowany. Zobacz też Zarządzanie usługami KVM i korzystanie z nich.

   Aby sprawdzić, czy środowisko KVM jest zaszyfrowane w interfejsie Edge:

   1. W interfejsie Edge kliknij Admin (Administrator) w menu nawigacyjnym po lewej stronie.
   2. Kliknij Środowiska.
   3. Kliknij Mapy par klucz-wartość.
   4. Znajdź mapę klucz-wartość, której chcesz użyć.
   5. Kliknij strzałkę po lewej stronie nazwy, aby rozwinąć listę wartości.
   6. W interfejsie mapy par klucz-wartość z zaszyfrowanymi wartościami są wyświetlane z gwiazdkami (*****), jak pokazano w artykule Szczegóły dotyczące zaszyfrowanych map par klucz-wartość.

   Aby sprawdzić, czy KVM zdefiniowany na poziomie organizacji, środowiska lub interfejsu proxy jest zaszyfrowany, użyj interfejsów API do zarządzania. Jeśli korzystasz z interfejsu API, przykładowa odpowiedź, która zawiera zarówno zaszyfrowane ustawienie, jak i gwiazdki dla wartości, wygląda tak:

   {
     "encrypted": true,
     "entry": [
       {
         "name": "foo",
         "value": "*****"
       }
     ],
     "name": "encrypted"
   }
   

2. Jeśli mapa klucz-wartość jest zaszyfrowaną mapą klucz-wartość, a nazwa zmiennej używana w atrybucie assignTo elementu <Get> nie ma prefiksu private. To właśnie jest przyczyną błędu.

   W przykładowej regule operacji mapy klucz-wartość pokazanej powyżej mapy klucz-wartość testEncrypted są zaszyfrowane, a nazwa zmiennej myvar nie ma prefiksu private. Dlatego otrzymujesz kod błędu:

   steps.keyvaluemapoperations.SetVariableFailed
   

Rozdzielczość

Jeśli używana mapa par klucz-wartość jest szyfrowana, nazwa zmiennej musi mieć prefiks private. w atrybucie assignTo elementu <Get> w zasadach operacji mapy par klucz-wartość.

Aby poprawić przykładową zasadę operacji mapowania klucz-wartość, możesz zmienić wartość atrybutu assignTo na 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>