Oktatóanyag: Korrektúrák használata a nem törhető API-módosítások biztonságos végrehajtásához

A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint

Ha az API készen áll az indulásra, és a fejlesztők használják, előbb-utóbb módosítania kell az API-t, ugyanakkor nem kell megzavarnia az API hívóinak működését. Emellett az is hasznos, ha a fejlesztők értesülnek az elvégzett módosításokról.

Az Azure API Managementben korrektúrák használatával hajthat végre nem törhető API-módosításokat , hogy biztonságosan modellezhesse és tesztelhesse a módosításokat. Ha elkészült, aktuális változatot készíthet, és lecserélheti az aktuális API-t.

A háttérről a Verziók és a Változatok című témakörben olvashat.

Ebben az oktatóanyagban az alábbiakkal fog megismerkedni:

• Új változat hozzáadása
• Nem törhető módosítások végrehajtása a változaton
• Változat aktuálissá tétele és módosításinapló-bejegyzés hozzáadása
• A fejlesztői portál tallózása a módosítások és a módosítási napló megtekintéséhez
• API-változat elérése

Előfeltételek

• Az Azure API Management terminológiájának ismerete.
• Tekintse át a következő rövid útmutatót: Azure API Management-példány létrehozása.
• Végezze el a következő oktatóanyagot is: Az első API importálása és közzététele.

Új változat hozzáadása

1. Jelentkezzen be az Azure Portalra, és lépjen az API Management-példányra.

2. A bal oldali menü API-k területén válassza az API-kat.

3. Válassza a Demo Conference API-t az API-listából (vagy egy másik API-ból, amelyhez korrektúrákat szeretne hozzáadni).

4. Válassza a Korrektúra lapfület .

5. Válassza a + Változat hozzáadása lehetőséget.

   

   Tipp.

   A Változat hozzáadása lehetőséget az API helyi menüjében (...) is kiválaszthatja.

6. Adja meg az új változat leírását, hogy megjegyezhesse, mire használják.

7. Válassza a Létrehozás lehetőséget.

8. Az új változat létrehozása megtörtént.

   Feljegyzés

   Az eredeti API az 1. változatban marad. A felhasználók ezt a változatot hívják egészen addig, amíg Ön nem tesz aktuálissá egy másik változatot.

Nem törhető módosítások végrehajtása a változaton

1. Válassza a Demo Conference API lehetőséget az API-k listájából.

2. Kattintson a képernyő felső részén található Tervezés fülre.

3. Figyelje meg, hogy a (közvetlenül a Tervezés lap fölött található) változatválasztóban a 2. változat jelenik meg aktuális változatként.

   Tipp.

   A változatválasztóval váltson arra a változatra, amelyen dolgozni kíván.

4. Válassza a + Művelet hozzáadása lehetőséget.

5. Állítsa be az új műveletet POST értékre, a művelet megjelenítendő nevét, nevét és URL-címét pedig tesztként.

6. Mentse az új műveletet.

   

7. Most módosította a 2. változatot. A lap tetején található változatválasztóval váltson vissza az 1. változatra.

8. Figyelje meg, hogy az új művelet nem jelenik meg az 1. változatban.

Változat aktuálissá tétele és módosításinapló-bejegyzés hozzáadása

Portál

1. Kattintson a Változatok fülre az oldal felső részén található menüben.

2. Nyissa meg a 2. változat helyi menüjét (...).

3. Válassza az Aktuálissá tétele lehetőséget.

4. Ha megjegyzéseket szeretne közzétenni erről a változásról, jelölje be az API-hoz tartozó közzétételi naplót. Adja meg a módosítás leírását, amelyet a fejlesztők láthatnak, például: Változatok tesztelése. Új "teszt" művelet hozzáadva.

5. Most már a 2. változat az aktuális.

   

Azure CLI

Az Azure CLI használatának megkezdése:

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.

  

• Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.

  • Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.

  • Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

Ezzel az eljárással hozhat létre és frissíthet egy kiadást.

1. Futtassa az az apim apim api list parancsot az API-azonosítók megtekintéséhez:

   az apim api list --resource-group apim-hello-word-resource-group \
       --service-name apim-hello-world --output table
   

   A következő parancsban használni kívánt API-azonosító az Name érték. Az API-változat az ApiRevision oszlopban található.

2. A kiadás létrehozásához egy kibocsátási megjegyzéssel futtassa az az apim api release create parancsot:

   az apim api release create --resource-group apim-hello-word-resource-group \
       --api-id demo-conference-api --api-revision 2 --service-name apim-hello-world \
       --notes 'Testing revisions. Added new "test" operation.'
   

   A kiadott változat lesz az aktuális változat.

3. A kiadások megtekintéséhez használja az az apim api kiadási lista parancsát:

   az apim api release list --resource-group apim-hello-word-resource-group \
       --api-id echo-api --service-name apim-hello-world --output table
   

   A megadott jegyzetek megjelennek a változásnaplóban. Az előző parancs kimenetében láthatók.

4. Kiadás létrehozásakor a --notes paraméter nem kötelező. A jegyzeteket később is hozzáadhatja vagy módosíthatja az az apim api release update paranccsal:

   az apim api release update --resource-group apim-hello-word-resource-group \
       --api-id demo-conference-api --release-id 00000000000000000000000000000000 \
       --service-name apim-hello-world --notes "Revised notes."
   

   Használja az oszlopban lévő Name értéket a kiadásazonosítóhoz.

Bármely kiadást eltávolíthat az az apim api release delete parancs futtatásával:

az apim api release delete --resource-group apim-hello-word-resource-group \
    --api-id demo-conference-api --release-id 00000000000000000000000000000000 
    --service-name apim-hello-world

A fejlesztői portál tallózása a módosítások és a módosítási napló megtekintéséhez

Ha már kipróbálta a fejlesztői portált, áttekintheti az API módosításait, és ott módosíthatja a naplót.

1. Az Azure Portalon keresse meg az API Management-példányt.
2. A bal oldali menü API-k területén válassza az API-kat.
3. A felső menüben válassza a Fejlesztői portál lehetőséget.
4. A fejlesztői portálon válassza az API-kat, majd a Demo Conference API-t.
5. Figyelje meg, hogy az új test művelet már elérhető.
6. Válassza a Changelog (Változásnapló ) lehetőséget az API neve mellett.
7. Figyelje meg, hogy a változásnapló-bejegyzés megjelenik a listában.

API-változat elérése

Az API minden változata egy speciálisan formázott URL-cím használatával érhető el. Adja hozzá ;rev={revisionNumber} az API URL-címének végén, de a lekérdezési sztring előtt az API egy adott változatának eléréséhez. Használhatja például ezt az URL-címet a Demo Conference API 2. változatának eléréséhez:

https://apim-hello-world.azure-api.net/conf;rev=2/speakers

Az API változatainak URL-elérési útjai az Azure Portal Korrektúrák lapján találhatók.

Tipp.

Az API aktuális változatát a sztring nélküli ;rev API-elérési út használatával érheti el, az API-elérési úthoz hozzáfűző ;rev={revisionNumber} teljes URL-cím mellett.

Összegzés

Ez az oktatóanyag bemutatta, hogyan végezheti el az alábbi műveleteket:

• Új változat hozzáadása
• Nem törhető módosítások végrehajtása a változaton
• Változat aktuálissá tétele és módosításinapló-bejegyzés hozzáadása
• A fejlesztői portál tallózása a módosítások és a módosítási napló megtekintéséhez
• API-változat elérése

Következő lépések

Folytassa a következő oktatóanyaggal:

Az API több verziójának közzététele