CISCO-logo

Ap API CISCO ASA REST

CISCO-ASA-REST-API-App-cynnyrch

Cyfarwyddiadau Defnyddio Cynnyrch

Drosoddview

Gyda rhyddhau API REST Cisco's ASA, mae gennych bellach opsiwn ysgafn, hawdd ei ddefnyddio arall ar gyfer ffurfweddu a rheoli Cisco ASAs unigol. Mae API REST ASA yn rhyngwyneb rhaglennu cymhwysiad (API) sy'n seiliedig ar egwyddorion RESTful. Gellir ei lawrlwytho a'i alluogi'n gyflym ar unrhyw ASA lle mae'r API yn rhedeg. Cisco Systems, Inc.

www.cisco.com

Ceisiadau ac Ymatebion API ASA REST

Ar ôl gosod cleient REST yn eich porwr, gallwch gysylltu ag asiant REST penodol yr ASA a defnyddio dulliau HTTP safonol i gael mynediad at wybodaeth ffurfweddu gyfredol a chyhoeddi paramedrau cyfluniad ychwanegol.

Rhybudd: Pan fydd yr API REST wedi'i alluogi ar ASA, nid yw cysylltiadau gan brotocolau rheoli diogelwch eraill yn cael eu rhwystro. Mae hyn yn golygu y gallai eraill sy'n defnyddio CLI, ASDM, neu Reolwr Diogelwch fod yn newid cyfluniad ASA tra'ch bod chi'n gwneud yr un peth.

Strwythur Cais

Mae API REST ASA yn rhoi mynediad rhaglennol i chi i reoli ASA unigol trwy API Trosglwyddo Talaith Cynrychioliadol (REST). Mae'r API yn caniatáu i gleientiaid allanol berfformio gweithrediadau CRUD (Creu, Darllen, Diweddaru, Dileu) ar adnoddau ASA. Anfonir pob cais API dros HTTPS i'r ASA, a dychwelir ymateb.

lle mae priodweddau gwrthrych:

Eiddo Math Disgrifiad
negeseuon Rhestr o Geiriaduron Rhestr o wallau neu negeseuon rhybudd
cod Llinyn Neges fanwl yn cyfateb i Gwall/Rhybudd/Gwybodaeth
manylion Llinyn Neges fanwl yn cyfateb i Gwall/Rhybudd/Gwybodaeth

Nodyn: Nid yw newidiadau a wneir gan alwadau REST API yn parhau i'r cyfluniad cychwyn ond yn cael eu neilltuo i'r ffurfwedd rhedeg yn unig. I arbed newidiadau i'r cyfluniad cychwyn, gallwch ddefnyddio'r cais API POST a write mem. Am ragor o wybodaeth, cyfeiriwch at y cofnod Write Memory API yn y tabl cynnwys About the ASA REST API.

Gosod a Ffurfweddu Asiant a Chleient API REST ASA

Nodyn: Mae Asiant API REST yn gymhwysiad sy'n seiliedig ar Java. Mae'r Java Runtime Environment (JRE) wedi'i bwndelu ym mhecyn Asiant API REST.

Drosoddview

Mae sawl opsiwn ar gael ar gyfer ffurfweddu a rheoli Cisco ASAs unigol:

  • Rhyngwyneb Llinell Reoli (CLI) - rydych chi'n anfon gorchmynion rheoli yn uniongyrchol i'r ASA trwy gonsol cysylltiedig.
  • Rheolwr Dyfais Diogelwch Addasol (ASDM) – cymhwysiad rheoli “ar y blwch” gyda rhyngwyneb defnyddiwr graffigol y gallwch ei ddefnyddio i ffurfweddu, rheoli a monitro ASA.
  • Rheolwr Diogelwch Cisco - er ei fod wedi'i fwriadu ar gyfer rhwydweithiau canolig i fawr o lawer o ddyfeisiau diogelwch, gellir defnyddio'r cymhwysiad graffigol hwn i ffurfweddu, rheoli a monitro ASAs unigol.

Gyda rhyddhau ASA REST API Cisco, mae gennych bellach opsiwn ysgafn, hawdd ei ddefnyddio arall. Mae hwn yn ryngwyneb rhaglennu cymhwysiad (API), yn seiliedig ar egwyddorion “RESTful”, y gallwch eu lawrlwytho a'u galluogi'n gyflym ar unrhyw ASA y mae'r API yn rhedeg arno.

Ar ôl gosod cleient REST yn eich porwr, gallwch gysylltu ag asiant REST penodol yr ASA a defnyddio dulliau HTTP safonol i gael mynediad at wybodaeth ffurfweddu gyfredol, a chyhoeddi paramedrau cyfluniad ychwanegol.

Rhybudd: Pan fydd yr API REST wedi'i alluogi ar ASA, nid yw cysylltiadau gan brotocolau rheoli diogelwch eraill yn cael eu rhwystro. Mae hyn yn golygu y gallai eraill sy'n defnyddio CLI, ASDM, neu Reolwr Diogelwch fod yn newid cyfluniad ASA tra'ch bod chi'n gwneud yr un peth.

Ceisiadau ac Ymatebion API ASA REST

Mae API REST ASA yn rhoi mynediad rhaglennol i chi i reoli ASAs unigol trwy API Trosglwyddo Cyflwr Cynrychioliadol (REST). Mae'r API yn caniatáu i gleientiaid allanol berfformio gweithrediadau CRUD (Creu, Darllen, Diweddaru, Dileu) ar adnoddau ASA; mae'n seiliedig ar brotocol HTTPS a methodoleg REST. Anfonir pob cais API dros HTTPS i'r ASA, a dychwelir ymateb. Mae'r adran hon yn rhoi drosoddview sut mae ceisiadau’n cael eu strwythuro, a’r ymatebion disgwyliedig,

Strwythur Cais

Y dulliau gwneud cais sydd ar gael yw:

  • GET - Yn adfer data o'r gwrthrych penodedig.
  • RHOI - Yn ychwanegu'r wybodaeth a ddarparwyd at y gwrthrych penodedig; yn dychwelyd gwall 404 Adnodd Heb ei Ddarganfod os nad yw'r gwrthrych yn bodoli.
  • SWYDD - Yn creu'r gwrthrych gyda'r wybodaeth a ddarparwyd.
  • DILEU - Yn dileu'r gwrthrych penodedig.
  • PATCH - Yn cymhwyso addasiadau rhannol i'r gwrthrych penodedig.

Strwythur Ymateb

  • Mae pob cais yn cynhyrchu ymateb HTTPS gan yr ASA gyda'r penawdau safonol, cynnwys ymateb, a chod statws.

Gall y strwythur ymateb fod yn:

  • LLEOLIAD – ID adnoddau newydd ei greu; ar gyfer SWYDD yn unig—yn dal yr ID adnodd newydd (fel cynrychiolaeth URI).
  • MATH CYNNWYS – Math o gyfrwng yn disgrifio corff y neges ymateb; yn disgrifio cynrychioliad a chystrawen y corff neges ymateb.

Mae pob ymateb yn cynnwys statws HTTP neu god gwall. Mae'r codau sydd ar gael yn perthyn i'r categorïau hyn:

  • 20x - Mae cod cyfres dau gant yn nodi gweithrediad llwyddiannus, gan gynnwys:
    • 200 Iawn – Ymateb safonol ar gyfer ceisiadau llwyddiannus.
    • 201 Crëwyd – Cais wedi'i gwblhau; adnodd newydd wedi'i greu.
    • 202 Derbyniwyd – Derbyniwyd y cais, ond ni chwblhawyd y prosesu.
    • 204 Dim Cynnwys - Gweinydd wedi prosesu'r cais yn llwyddiannus; nid oes unrhyw gynnwys yn cael ei ddychwelyd.
  • 4xx - Mae cod cyfres pedwar cant yn nodi gwall ochr y cleient, gan gynnwys:
    • 400 Cais Gwael - Paramedrau ymholiad annilys, gan gynnwys paramedrau heb eu cydnabod, paramedrau coll, neu werthoedd annilys.
    • 404 Heb ei Ddarganfod – y darperir URL ddim yn cyfateb i adnodd sy'n bodoli. Am gynampLe, efallai y bydd DILEU HTTP yn methu oherwydd nad yw'r adnodd ar gael.
    • 405 Dull heb ei ganiatáu – Cyflwynwyd cais HTTP na chaniateir ar yr adnodd; ar gyfer cynample, SWYDD ar adnodd darllen yn unig.
  • 5xx - Mae cod cyfres pum cant yn nodi gwall ar ochr y gweinydd.

Yn achos gwall, yn ogystal â'r cod gwall, gall yr ymateb dychwelyd gynnwys gwrthrych gwall sy'n cynnwys mwy o fanylion am y gwall. Mae sgema gwall / ymateb rhybudd JSON fel a ganlyn:

CISCO-ASA-REST-API-App-fig-1

lle mae priodweddau gwrthrych:

Eiddo Math Disgrifiad
negeseuon Rhestr o Geiriaduron Rhestr o wallau neu negeseuon rhybudd
cod Llinyn Gwall/Rhybudd/Cod gwybodaeth
manylion Llinyn Neges fanwl yn cyfateb i Gwall/Rhybudd/Gwybodaeth

Nodyn: Nid yw'r newidiadau i'r ffurfweddiad ASA a wneir gan alwadau REST API yn parhau i'r cyfluniad cychwyn; hynny yw, dim ond i'r cyfluniad rhedeg y caiff newidiadau eu neilltuo. I arbed newidiadau i'r cyfluniad cychwyn, gallwch bostio cais API writemem; am ragor o wybodaeth, dilynwch y cofnod “Write Memory API” yn y tabl cynnwys About the ASA REST API.

Gosod a Ffurfweddu Asiant a Chleient API REST ASA

  • Cyhoeddir yr Asiant API REST yn unigol gyda delweddau ASA eraill ymlaen cisco.com. Ar gyfer ASAs corfforol, rhaid lawrlwytho'r pecyn API REST i fflach y ddyfais a'i osod gan ddefnyddio'r gorchymyn “rest-api image”. Yna mae'r Asiant API REST yn cael ei alluogi gan ddefnyddio'r gorchymyn “rest-api agent”.
  • Gyda rhith ASA (ASAv), rhaid lawrlwytho delwedd REST API i'r rhaniad “boot:". Yna rhaid i chi gyhoeddi'r gorchymyn “rest-api image”, ac yna'r gorchymyn “rest-api agent”, i gyrchu a galluogi'r Asiant API REST.
  • I gael gwybodaeth am ofynion meddalwedd a chaledwedd REST API a chydnawsedd, gweler matrics Cydnawsedd Cisco ASA.
  • Gallwch lawrlwytho'r pecyn REST API priodol ar gyfer eich ASA neu ASAv o software.cisco.com/download/home. Dewch o hyd i'r model Peiriannau Diogelwch Addasol (ASA) penodol ac yna dewiswch Ategyn API REST Offer Diogelwch Addasol.

Nodyn: Mae Asiant API REST yn gymhwysiad sy'n seiliedig ar Java. Mae'r Java Runtime Environment (JRE) wedi'i bwndelu ym mhecyn Asiant API REST.

Canllawiau Defnydd

Pwysig Rhaid i chi gynnwys y pennawd Defnyddiwr-Asiant: REST API Asiant ym mhob galwad API a sgriptiau presennol. Defnyddiwch -H 'User-Agent: REST API Asiant' ar gyfer y CURL gorchymyn. Mewn modd aml-destun, dim ond yng nghyd-destun y System y mae gorchmynion Asiant API REST ar gael.

Uchafswm Maint Ffurfweddu â Chymorth

Mae API ASA Rest yn gymhwysiad “ar fwrdd” sy'n rhedeg y tu mewn i'r ASA corfforol, ac felly mae ganddo gyfyngiad ar y cof a ddyrennir iddo. Mae maint cyfluniad rhedeg mwyaf â chymorth wedi cynyddu dros y cylch rhyddhau i tua 2 MB ar lwyfannau diweddar fel yr 5555 a 5585. Mae gan API ASA Rest hefyd gyfyngiadau cof ar y llwyfannau ASA rhithwir. Gall cyfanswm y cof ar yr ASAv5 fod yn 1.5 GB, tra ar yr ASAv10 mae'n 2 GB. Y terfynau Rest API yw 450 KB a 500 KB ar gyfer yr ASAv5 ac ASAv10, yn y drefn honno.

Felly, byddwch yn ymwybodol y gall cyfluniadau rhedeg mawr gynhyrchu eithriadau mewn amrywiol sefyllfaoedd cof-ddwys megis nifer fawr o geisiadau cydamserol, neu nifer fawr o geisiadau. Yn y sefyllfaoedd hyn, gall galwadau Rest API GET/PUT/POST ddechrau methu â 500 - negeseuon Gwall Gweinydd Mewnol, a bydd yr Asiant API Rest yn ailgychwyn yn awtomatig bob tro. Yr atebion i'r sefyllfa hon yw naill ai symud i lwyfannau cof uwch ASA/FPR neu ASAV, neu leihau maint y cyfluniad rhedeg.

Dadlwythwch a Gosodwch yr Asiant API REST

Gan ddefnyddio'r CLI, dilynwch y camau hyn i lawrlwytho a gosod asiant API ASA REST ar ASA penodol:

  • Cam 1: Ar yr ASA dymunol, cyhoeddwch y copi disk0: gorchymyn i lawrlwytho'r pecyn API ASA REST cyfredol ohono cisco.com i gof fflach yr ASA.
    • Am gynample: copi tftp://10.7.0.80/asa-restapi-111-lfbff-k8.SPA disk0:
  • Cam 2: Rhowch y ddelwedd rest-api disk0:/ gorchymyn i wirio a gosod y pecyn.
    • Am gynample: delwedd rest-api disk0:/asa-restapi-111-lfbff-k8.SPA

Bydd y gosodwr yn perfformio gwiriadau cydweddoldeb a dilysu, ac yna'n gosod y pecyn. Ni fydd yr ASA yn ailgychwyn.

Galluogi'r Asiant API REST

Dilynwch y camau hyn i alluogi Asiant API ASA REST ar ASA penodol:

  • Cam 1: Sicrhewch fod y ddelwedd feddalwedd gywir wedi'i gosod ar yr ASA.
  • Cam 2: Gan ddefnyddio'r CLI, sicrhewch fod y gweinydd HTTP wedi'i alluogi ar yr ASA, a bod cleientiaid API yn gallu cysylltu â'r rhyngwyneb rheoli.
    • Am gynample: gweinydd http galluogi
    • http 0.0.0.0 0.0.0.0
  • Cam 3: Gan ddefnyddio'r CLI, diffiniwch ddilysiad HTTP ar gyfer y cysylltiadau API. Am gynample: aaa dilysu http consol LLEOL
  • Cam 4: Gan ddefnyddio'r CLI, crëwch lwybr sefydlog ar yr ASA ar gyfer traffig API. Am gynample: llwybr 0.0.0.0 0.0.0.0 1
  • Cam 5: Gan ddefnyddio'r CLI, galluogwch Asiant API ASA REST ar yr ASA. Am gynample: rest-api agent

Dilysu REST API

Mae dwy ffordd i ddilysu: Dilysiad HTTP sylfaenol, sy'n pasio enw defnyddiwr a chyfrinair ym mhob cais, neu ddilysiad ar sail Tocyn gyda chludiant HTTPS diogel, sy'n pasio tocyn a grëwyd yn flaenorol gyda phob cais. Y naill ffordd neu'r llall, bydd dilysiad yn cael ei berfformio ar gyfer pob cais. Gweler yr adran, “Token_Authentication_API” yn y canllaw About the ASA REST API v7.14(x) i gael gwybodaeth ychwanegol am ddilysu ar sail Token.

Nodyn: Argymhellir defnyddio tystysgrifau Awdurdod Tystysgrif (CA) ar ASA, felly gall cleientiaid REST API ddilysu tystysgrifau gweinydd ASA wrth sefydlu cysylltiadau SSL.

Awdurdodi Gorchymyn

Os yw awdurdodiad gorchymyn wedi'i ffurfweddu i ddefnyddio gweinydd AAA allanol (ar gyfer example, gorchymyn awdurdodi aaa ), yna mae'n rhaid i ddefnyddiwr o'r enw enable_1 fodoli ar y gweinydd hwnnw gyda breintiau gorchymyn llawn. Os yw awdurdodiad gorchymyn wedi'i ffurfweddu i ddefnyddio cronfa ddata LLEOL yr ASA (gorchymyn awdurdodi aaa LLEOL), yna rhaid i bob defnyddiwr API REST fod wedi'i gofrestru yn y gronfa ddata LLEOL gyda lefelau braint sy'n briodol i'w rolau:

  • Mae angen lefel braint 3 neu fwy i alw ceisiadau monitro.
  • Mae angen lefel braint 5 neu fwy ar gyfer galw am geisiadau GET.
  • Mae angen lefel braint 15 ar gyfer gweithredu gweithrediadau RHOI/POST/DILEU.

Ffurfweddu Eich Cleient API REST

Dilynwch y camau hyn i osod a ffurfweddu cleient API REST ar eich porwr gwesteiwr lleol:

  • Cam 1: Caffael a gosod cleient REST API ar gyfer eich porwr.
    • Ar gyfer Chrome, gosodwch y cleient REST gan Google. Ar gyfer Firefox, gosodwch yr ategyn RESClient. Nid yw Internet Explorer yn cael ei gefnogi.
  • Cam 2: Cychwynnwch y cais canlynol gan ddefnyddio'ch porwr: https: /api/objects/networkobjects
    • Os byddwch yn derbyn ymateb di-wall, rydych wedi cyrraedd yr asiant REST API sy'n gweithredu ar yr ASA.
    • Os ydych chi'n cael problemau gyda'r cais asiant, gallwch chi alluogi arddangos gwybodaeth dadfygio ar y consol CLI, fel y disgrifir yn Galluogi REST API Debugging ar yr ASA.
  • Cam 3: Yn ddewisol, gallwch chi brofi'ch cysylltiad â'r ASA trwy berfformio gweithrediad POST.

Am gynample: Rhowch fanylion awdurdodi sylfaenol ( ), neu docyn dilysu (gweler Dilysu Tocyn am wybodaeth ychwanegol).

  • Cyfeiriad cais targed: https://<asa management ipaddress>/api/objects/networkobjects
  • Math o gynnwys corff: cais/json

Corff amrwd y llawdriniaeth:

CISCO-ASA-REST-API-App-fig-2

Gallwch nawr ddefnyddio'r ASA REST API i ffurfweddu a monitro'r ASA. Cyfeiriwch y ddogfennaeth API ar gyfer disgrifiadau galwadau a chynamples.

Ynghylch Adfer Ffurfwedd Wrth Gefn yn Llawn

Bydd adfer ffurfweddiad wrth gefn llawn ar yr ASA gan ddefnyddio'r API REST yn ail-lwytho'r ASA. Er mwyn osgoi hyn, defnyddiwch y gorchymyn canlynol i adfer cyfluniad wrth gefn:

  • {
    • “gorchmynion”:[“copi /noconfirm disk0:/fileenw> rhedeg-config”]
  • }
    • Llefileenw> yw backup.cfg neu ba bynnag enw a ddefnyddiwyd gennych wrth wneud copi wrth gefn o'r ffurfweddiad.

Y Consol Dogfennaeth ac Allforio Sgriptiau API

Gallwch hefyd ddefnyddio consol dogfennaeth ar-lein REST API (y cyfeirir ato fel y “Doc UI”), sydd ar gael yn host: port / doc / fel “blwch tywod” ar gyfer dysgu am a rhoi cynnig ar y galwadau API yn uniongyrchol ar yr ASA. Ymhellach, gallwch ddefnyddio'r botwm Allforio Operation yn y Doc UI i arbed y dull a ddangosir cynample fel JavaScript, Python, neu sgript Perl file i'ch gwesteiwr lleol. Yna gallwch chi gymhwyso'r sgript hon i'ch ASA, a'i golygu i'w chymhwyso ar ASAs eraill a dyfeisiau rhwydwaith eraill. Roedd hyn yn golygu'n bennaf fel offeryn addysgol a strapio cychwyn.

JavaScript

  • Defnyddio JavaScript file angen gosod nod.js, sydd i'w weld yn http://nodejs.org/.
  • Gan ddefnyddio nod.js, gallwch chi weithredu JavaScript file, fel arfer wedi'i ysgrifennu ar gyfer porwr, fel sgript llinell orchymyn. Yn syml, dilynwch y cyfarwyddiadau gosod, ac yna rhedeg eich sgript gyda nod script.js.

Python

  • Mae'r sgriptiau Python yn gofyn ichi osod Python, sydd ar gael o https://www.python.org/.
  • Unwaith y byddwch wedi gosod Python, gallwch redeg eich sgript gyda chyfrinair enw defnyddiwr python script.py.

Perl

Mae angen rhywfaint o sefydlu ychwanegol i ddefnyddio'r sgriptiau Perl - mae angen pum cydran arnoch chi: Perl ei hun, a phedair llyfrgell Perl:

Dyma gynampgyda bootstrapping Perl ar Macintosh:

  • $ sudo perl -MCPAN e cragen
  • cpan> gosod Bwndel ::CPAN
  • cpan> gosod REST :: Cleient
  • cpan> gosod MIME:: sylfaen 64
  • cpan> gosod JSON

Ar ôl gosod y dibyniaethau, gallwch chi redeg eich sgript gan ddefnyddio cyfrinair enw defnyddiwr perl script.pl.

Galluogi REST API Debugging ar yr ASA

Os ydych chi'n cael problemau wrth ffurfweddu neu gysylltu â'r API REST ar yr ASA, gallwch ddefnyddio'r gorchymyn CLI canlynol i alluogi arddangos negeseuon dadfygio ar eich consol. Defnyddiwch ffurf dim y gorchymyn i analluogi'r negeseuon dadfygio.
debug rest-api [asiant | cli | cleient | ellyll | proses | token-auth] [gwall | digwyddiad] dim debug rest-api

Disgrifiad Cystrawen

  • asiant: (Dewisol) Galluogi REST API gwybodaeth dadfygio Asiant.
  • cli: (Dewisol) Galluogi negeseuon dadfygio ar gyfer cyfathrebu REST API CLI Daemon-i-Asiant.
  • cleient: (Dewisol) Galluogi gwybodaeth dadfygio ar gyfer llwybr Negeseuon rhwng y Cleient API REST a'r Asiant API REST.
  • ellyll: (Dewisol) Galluogi negeseuon dadfygio ar gyfer cyfathrebiadau Daemon-i-Asiant REST API.
  • proses: (Dewisol) Galluogi REST API Asiant proses cychwyn/stop debugging gwybodaeth.
  • token-auth: (Dewisol) REST API dilysu tocyn gwybodaeth dadfygio.
  • gwall: (Dewisol) Defnyddiwch yr allweddair hwn i gyfyngu negeseuon dadfygio i gamgymeriadau a gofnodwyd gan yr API yn unig.
  • digwyddiad: (Dewisol) Defnyddiwch yr allweddair hwn i gyfyngu negeseuon dadfygio i ddigwyddiadau a gofnodwyd gan yr API yn unig.

Canllawiau Defnydd

Os na fyddwch yn darparu allweddair cydran penodol (hynny yw, os ydych chi'n cyhoeddi'r gorchymyn debug rest-api), mae negeseuon dadfygio yn cael eu harddangos ar gyfer pob math o gydran. Os na fyddwch yn darparu'r allweddair digwyddiad neu wall, bydd y ddau ddigwyddiad a'r neges gwall yn cael eu harddangos ar gyfer y gydran benodedig. Am gynample, bydd digwyddiad debug rest-api daemon yn dangos negeseuon dadfygio digwyddiad yn unig ar gyfer cyfathrebiadau API Daemon-to-Agent.

Gorchmynion Cysylltiedig

Gorchymyn / Disgrifiad

  • HTTP dadfygio; Defnyddiwch y gorchymyn hwn i view gwybodaeth fanwl am draffig HTTP.

Negeseuon Syslog sy'n gysylltiedig â API ASA REST

Disgrifir y negeseuon log system sy'n gysylltiedig ag API ASA REST yn yr adran hon.

342001

  • Neges Gwall: ASA-7-342001: Dechreuodd Asiant API REST yn llwyddiannus.
    • Eglurhad: Rhaid cychwyn yr Asiant API REST yn llwyddiannus cyn y gall Cleient API REST ffurfweddu'r ASA.
    • Camau a Argymhellir: Dim.

342002

  • Neges Gwall: ASA-3-342002: Methodd yr Asiant API REST, rheswm: rheswm
    • Eglurhad: Gallai'r Asiant API REST fethu â chychwyn neu chwalu am wahanol resymau, a nodir y rheswm.
    • rheswm - Yr achos dros fethiant REST API

Camau a Argymhellir: Mae'r camau a gymerir i ddatrys y mater yn amrywio yn dibynnu ar y rheswm a gofnodwyd. Am gynampLe, mae'r Asiant API REST yn damwain pan fydd y broses Java yn rhedeg allan o gof. Os bydd hyn yn digwydd, mae angen i chi ailgychwyn yr Asiant API REST. Os nad yw'r ailgychwyn yn llwyddiannus, cysylltwch â Cisco TAC i nodi'r atgyweiriad gwraidd.

342003

  • Neges Gwall: ASA-3-342003: REST API hysbysiad methiant asiant wedi'i dderbyn. Bydd yr asiant yn cael ei ailgychwyn yn awtomatig.
    • Eglurhad: Mae hysbysiad methiant gan yr Asiant API REST wedi'i dderbyn ac mae'r Asiant yn ceisio ailgychwyn.
    • Camau a Argymhellir: Dim.

342004

  • Neges Gwall: % ASA-3-342004: Wedi methu ag ailgychwyn yr Asiant API REST yn awtomatig ar ôl 5 ymgais aflwyddiannus. Defnyddiwch y gorchmynion 'dim rest-api agent' a 'rest-api agent' i ailgychwyn yr Asiant â llaw.
    • Eglurhad: Mae'r Asiant API REST wedi methu â dechrau ar ôl llawer o ymdrechion.
    • Camau a Argymhellir: Gweler syslog % ASA-3-342002 (os yw wedi mewngofnodi) i ddeall yn well y rheswm y tu ôl i'r methiant. Ceisiwch analluogi'r Asiant API REST trwy fynd i mewn i'r gorchymyn asiant dim rest-api ac ail-alluogi'r Asiant API REST gan ddefnyddio'r gorchymyn asiant rest-api.

Dogfennau Cysylltiedig

Defnyddiwch y ddolen ganlynol i ddod o hyd i ragor o wybodaeth am yr ASA, a'i ffurfwedd a'i reolaeth:

Mae'r ddogfen hon i'w defnyddio ar y cyd â'r dogfennau sydd ar gael o'r adran “Dogfennau Cysylltiedig”.
Mae Cisco a logo Cisco yn nodau masnach neu'n nodau masnach cofrestredig Cisco a/neu ei chymdeithion yn yr Unol Daleithiau a gwledydd eraill. I view rhestr o nodau masnach Cisco, ewch i hwn URL: www.cisco.com/go/trademarks. Mae'r nodau masnach trydydd parti a grybwyllir yn eiddo i'w perchnogion priodol. Nid yw defnyddio'r gair partner yn awgrymu perthynas bartneriaeth rhwng Cisco ac unrhyw gwmni arall. (1721R)
Ni fwriedir i unrhyw gyfeiriadau Protocol Rhyngrwyd (IP) a rhifau ffôn a ddefnyddir yn y ddogfen hon fod yn gyfeiriadau a rhifau ffôn gwirioneddol. Unrhyw gynamples, allbwn arddangos gorchymyn, diagramau topoleg rhwydwaith, a ffigurau eraill a gynhwysir yn y ddogfen yn cael eu dangos at ddibenion enghreifftiol yn unig.
Mae unrhyw ddefnydd o gyfeiriadau IP gwirioneddol neu rifau ffôn mewn cynnwys enghreifftiol yn anfwriadol ac yn gyd-ddigwyddiadol.

Cisco Systems, Inc.

© 2014-2018 Cisco Systems, Inc Cedwir pob hawl.

Dogfennau / Adnoddau

Ap API CISCO ASA REST [pdfCanllaw Defnyddiwr
Ap ASA REST API, ASA, ap REST API, Ap API, Ap

Cyfeiriadau

Gadael sylw

Ni fydd eich cyfeiriad e-bost yn cael ei gyhoeddi. Mae meysydd gofynnol wedi'u marcio *