CISCO-ਲੋਗੋ

CISCO ASA REST API ਐਪ

CISCO-ASA-REST-API-ਐਪ-ਉਤਪਾਦ

ਹਦਾਇਤਾਂ ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ ਉਤਪਾਦ

ਵੱਧview

Cisco ਦੇ ASA REST API ਦੇ ਜਾਰੀ ਹੋਣ ਦੇ ਨਾਲ, ਤੁਹਾਡੇ ਕੋਲ ਹੁਣ ਵਿਅਕਤੀਗਤ Cisco ASAs ਨੂੰ ਕੌਂਫਿਗਰ ਕਰਨ ਅਤੇ ਪ੍ਰਬੰਧਨ ਲਈ ਇੱਕ ਹੋਰ ਹਲਕੇ-ਭਾਰ, ਵਰਤੋਂ ਵਿੱਚ ਆਸਾਨ ਵਿਕਲਪ ਹੈ। ASA REST API RESTful ਸਿਧਾਂਤਾਂ 'ਤੇ ਅਧਾਰਤ ਇੱਕ ਐਪਲੀਕੇਸ਼ਨ ਪ੍ਰੋਗਰਾਮਿੰਗ ਇੰਟਰਫੇਸ (API) ਹੈ। ਇਸ ਨੂੰ ਕਿਸੇ ਵੀ ASA 'ਤੇ ਤੇਜ਼ੀ ਨਾਲ ਡਾਊਨਲੋਡ ਅਤੇ ਸਮਰੱਥ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ ਜਿੱਥੇ API ਚੱਲ ਰਿਹਾ ਹੈ। Cisco Systems, Inc.

www.cisco.com

ASA REST API ਬੇਨਤੀਆਂ ਅਤੇ ਜਵਾਬ

ਆਪਣੇ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਇੱਕ REST ਕਲਾਇੰਟ ਸਥਾਪਤ ਕਰਨ ਤੋਂ ਬਾਅਦ, ਤੁਸੀਂ ਖਾਸ ASA ਦੇ REST ਏਜੰਟ ਨਾਲ ਸੰਪਰਕ ਕਰ ਸਕਦੇ ਹੋ ਅਤੇ ਮੌਜੂਦਾ ਸੰਰਚਨਾ ਜਾਣਕਾਰੀ ਤੱਕ ਪਹੁੰਚ ਕਰਨ ਅਤੇ ਵਾਧੂ ਸੰਰਚਨਾ ਮਾਪਦੰਡ ਜਾਰੀ ਕਰਨ ਲਈ ਮਿਆਰੀ HTTP ਵਿਧੀਆਂ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ।

ਸਾਵਧਾਨ: ਜਦੋਂ ASA 'ਤੇ REST API ਨੂੰ ਸਮਰੱਥ ਬਣਾਇਆ ਜਾਂਦਾ ਹੈ, ਤਾਂ ਹੋਰ ਸੁਰੱਖਿਆ ਪ੍ਰਬੰਧਨ ਪ੍ਰੋਟੋਕੋਲ ਦੁਆਰਾ ਕਨੈਕਸ਼ਨ ਬਲੌਕ ਨਹੀਂ ਕੀਤੇ ਜਾਂਦੇ ਹਨ। ਇਸਦਾ ਮਤਲਬ ਹੈ ਕਿ CLI, ASDM, ਜਾਂ ਸੁਰੱਖਿਆ ਮੈਨੇਜਰ ਦੀ ਵਰਤੋਂ ਕਰਨ ਵਾਲੇ ਹੋਰ ਲੋਕ ASA ਸੰਰਚਨਾ ਨੂੰ ਬਦਲ ਰਹੇ ਹਨ ਜਦੋਂ ਤੁਸੀਂ ਅਜਿਹਾ ਕਰ ਰਹੇ ਹੋ।

ਢਾਂਚੇ ਦੀ ਬੇਨਤੀ ਕਰੋ

ASA REST API ਤੁਹਾਨੂੰ ਇੱਕ ਪ੍ਰਤੀਨਿਧ ਸਟੇਟ ਟ੍ਰਾਂਸਫਰ (REST) ​​API ਦੁਆਰਾ ਵਿਅਕਤੀਗਤ ASA ਦੇ ਪ੍ਰਬੰਧਨ ਲਈ ਪ੍ਰੋਗਰਾਮੇਟਿਕ ਪਹੁੰਚ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ। API ਬਾਹਰੀ ਗਾਹਕਾਂ ਨੂੰ ASA ਸਰੋਤਾਂ 'ਤੇ CRUD (ਬਣਾਓ, ਪੜ੍ਹੋ, ਅੱਪਡੇਟ ਕਰੋ, ਮਿਟਾਓ) ਓਪਰੇਸ਼ਨ ਕਰਨ ਦੀ ਇਜਾਜ਼ਤ ਦਿੰਦਾ ਹੈ। ਸਾਰੀਆਂ API ਬੇਨਤੀਆਂ HTTPS ਉੱਤੇ ASA ਨੂੰ ਭੇਜੀਆਂ ਜਾਂਦੀਆਂ ਹਨ, ਅਤੇ ਇੱਕ ਜਵਾਬ ਵਾਪਸ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।

ਜਿੱਥੇ ਵਸਤੂ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਹਨ:

ਜਾਇਦਾਦ ਟਾਈਪ ਕਰੋ ਵਰਣਨ
ਸੁਨੇਹੇ ਸ਼ਬਦਕੋਸ਼ਾਂ ਦੀ ਸੂਚੀ ਗਲਤੀ ਜਾਂ ਚੇਤਾਵਨੀ ਸੰਦੇਸ਼ਾਂ ਦੀ ਸੂਚੀ
ਕੋਡ ਸਤਰ ਗਲਤੀ/ਚੇਤਾਵਨੀ/ਜਾਣਕਾਰੀ ਨਾਲ ਸੰਬੰਧਿਤ ਵਿਸਤ੍ਰਿਤ ਸੁਨੇਹਾ
ਵੇਰਵੇ ਸਤਰ ਗਲਤੀ/ਚੇਤਾਵਨੀ/ਜਾਣਕਾਰੀ ਨਾਲ ਸੰਬੰਧਿਤ ਵਿਸਤ੍ਰਿਤ ਸੁਨੇਹਾ

ਨੋਟ: REST API ਕਾਲਾਂ ਦੁਆਰਾ ਕੀਤੀਆਂ ਗਈਆਂ ਤਬਦੀਲੀਆਂ ਸਟਾਰਟਅਪ ਕੌਂਫਿਗਰੇਸ਼ਨ ਵਿੱਚ ਜਾਰੀ ਨਹੀਂ ਰਹਿੰਦੀਆਂ ਪਰ ਸਿਰਫ ਚੱਲ ਰਹੀ ਸੰਰਚਨਾ ਨੂੰ ਨਿਰਧਾਰਤ ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ। ਸ਼ੁਰੂਆਤੀ ਸੰਰਚਨਾ ਵਿੱਚ ਤਬਦੀਲੀਆਂ ਨੂੰ ਸੁਰੱਖਿਅਤ ਕਰਨ ਲਈ, ਤੁਸੀਂ ਇੱਕ ਰਾਈਟ ਮੇਮ API ਬੇਨਤੀ ਪੋਸਟ ਕਰੋ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ। ਵਧੇਰੇ ਜਾਣਕਾਰੀ ਲਈ, ਸਮੱਗਰੀ ਦੀ ASA REST API ਸਾਰਣੀ ਵਿੱਚ ਰਾਈਟ ਮੈਮੋਰੀ API ਐਂਟਰੀ ਵੇਖੋ।

ASA REST API ਏਜੰਟ ਅਤੇ ਕਲਾਇੰਟ ਨੂੰ ਸਥਾਪਿਤ ਅਤੇ ਕੌਂਫਿਗਰ ਕਰੋ

ਨੋਟ: REST API ਏਜੰਟ ਇੱਕ Java-ਅਧਾਰਿਤ ਐਪਲੀਕੇਸ਼ਨ ਹੈ। Java Runtime Environment (JRE) REST API ਏਜੰਟ ਪੈਕੇਜ ਵਿੱਚ ਬੰਡਲ ਕੀਤਾ ਗਿਆ ਹੈ।

ਵੱਧview

ਵਿਅਕਤੀਗਤ Cisco ASAs ਦੀ ਸੰਰਚਨਾ ਅਤੇ ਪ੍ਰਬੰਧਨ ਲਈ ਕਈ ਵਿਕਲਪ ਉਪਲਬਧ ਹਨ:

  • ਕਮਾਂਡ ਲਾਈਨ ਇੰਟਰਫੇਸ (CLI) - ਤੁਸੀਂ ਇੱਕ ਕਨੈਕਟ ਕੀਤੇ ਕੰਸੋਲ ਰਾਹੀਂ ASA ਨੂੰ ਸਿੱਧੇ ਕੰਟਰੋਲ ਕਮਾਂਡ ਭੇਜਦੇ ਹੋ।
  • ਅਡੈਪਟਿਵ ਸਕਿਓਰਿਟੀ ਡਿਵਾਈਸ ਮੈਨੇਜਰ (ASDM) – ਇੱਕ ਗ੍ਰਾਫਿਕਲ ਯੂਜ਼ਰ ਇੰਟਰਫੇਸ ਦੇ ਨਾਲ ਇੱਕ "ਆਨ-ਬਾਕਸ" ਪ੍ਰਬੰਧਨ ਐਪਲੀਕੇਸ਼ਨ ਜਿਸਦੀ ਵਰਤੋਂ ਤੁਸੀਂ ASA ਨੂੰ ਕੌਂਫਿਗਰ ਕਰਨ, ਪ੍ਰਬੰਧਨ ਅਤੇ ਨਿਗਰਾਨੀ ਕਰਨ ਲਈ ਕਰ ਸਕਦੇ ਹੋ।
  • ਸਿਸਕੋ ਸੁਰੱਖਿਆ ਮੈਨੇਜਰ - ਜਦੋਂ ਕਿ ਬਹੁਤ ਸਾਰੇ ਸੁਰੱਖਿਆ ਉਪਕਰਣਾਂ ਦੇ ਮੱਧਮ ਤੋਂ ਵੱਡੇ ਨੈਟਵਰਕਾਂ ਲਈ ਇਰਾਦਾ ਹੈ, ਇਸ ਗ੍ਰਾਫਿਕਲ ਐਪਲੀਕੇਸ਼ਨ ਦੀ ਵਰਤੋਂ ਵਿਅਕਤੀਗਤ ASAs ਨੂੰ ਕੌਂਫਿਗਰ ਕਰਨ, ਪ੍ਰਬੰਧਨ ਅਤੇ ਨਿਗਰਾਨੀ ਕਰਨ ਲਈ ਕੀਤੀ ਜਾ ਸਕਦੀ ਹੈ।

Cisco ਦੇ ASA REST API ਦੇ ਜਾਰੀ ਹੋਣ ਦੇ ਨਾਲ, ਤੁਹਾਡੇ ਕੋਲ ਹੁਣ ਇੱਕ ਹੋਰ ਹਲਕਾ, ਵਰਤੋਂ ਵਿੱਚ ਆਸਾਨ ਵਿਕਲਪ ਹੈ। ਇਹ ਇੱਕ ਐਪਲੀਕੇਸ਼ਨ ਪ੍ਰੋਗ੍ਰਾਮਿੰਗ ਇੰਟਰਫੇਸ (API) ਹੈ, ਜੋ "ਰੈਸਟਫੁੱਲ" ਸਿਧਾਂਤਾਂ 'ਤੇ ਅਧਾਰਤ ਹੈ, ਜਿਸ ਨੂੰ ਤੁਸੀਂ ਕਿਸੇ ਵੀ ASA 'ਤੇ ਤੇਜ਼ੀ ਨਾਲ ਡਾਊਨਲੋਡ ਅਤੇ ਯੋਗ ਕਰ ਸਕਦੇ ਹੋ ਜਿਸ 'ਤੇ API ਚੱਲ ਰਿਹਾ ਹੈ।

ਆਪਣੇ ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ ਇੱਕ REST ਕਲਾਇੰਟ ਸਥਾਪਤ ਕਰਨ ਤੋਂ ਬਾਅਦ, ਤੁਸੀਂ ਖਾਸ ASA ਦੇ REST ਏਜੰਟ ਨਾਲ ਸੰਪਰਕ ਕਰ ਸਕਦੇ ਹੋ ਅਤੇ ਮੌਜੂਦਾ ਸੰਰਚਨਾ ਜਾਣਕਾਰੀ ਤੱਕ ਪਹੁੰਚ ਕਰਨ ਲਈ ਮਿਆਰੀ HTTP ਵਿਧੀਆਂ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ, ਅਤੇ ਵਾਧੂ ਸੰਰਚਨਾ ਮਾਪਦੰਡ ਜਾਰੀ ਕਰ ਸਕਦੇ ਹੋ।

ਸਾਵਧਾਨ: ਜਦੋਂ ASA 'ਤੇ REST API ਨੂੰ ਸਮਰੱਥ ਬਣਾਇਆ ਜਾਂਦਾ ਹੈ, ਤਾਂ ਹੋਰ ਸੁਰੱਖਿਆ ਪ੍ਰਬੰਧਨ ਪ੍ਰੋਟੋਕੋਲ ਦੁਆਰਾ ਕਨੈਕਸ਼ਨ ਬਲੌਕ ਨਹੀਂ ਕੀਤੇ ਜਾਂਦੇ ਹਨ। ਇਸਦਾ ਮਤਲਬ ਹੈ ਕਿ CLI, ASDM, ਜਾਂ ਸੁਰੱਖਿਆ ਮੈਨੇਜਰ ਦੀ ਵਰਤੋਂ ਕਰਨ ਵਾਲੇ ਹੋਰ ਲੋਕ ASA ਸੰਰਚਨਾ ਨੂੰ ਬਦਲ ਰਹੇ ਹਨ ਜਦੋਂ ਤੁਸੀਂ ਅਜਿਹਾ ਕਰ ਰਹੇ ਹੋ।

ASA REST API ਬੇਨਤੀਆਂ ਅਤੇ ਜਵਾਬ

ASA REST API ਤੁਹਾਨੂੰ ਇੱਕ ਪ੍ਰਤੀਨਿਧ ਸਟੇਟ ਟ੍ਰਾਂਸਫਰ (REST) ​​API ਦੁਆਰਾ ਵਿਅਕਤੀਗਤ ASA ਦੇ ਪ੍ਰਬੰਧਨ ਲਈ ਪ੍ਰੋਗਰਾਮੇਟਿਕ ਪਹੁੰਚ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈ। API ਬਾਹਰੀ ਗਾਹਕਾਂ ਨੂੰ ASA ਸਰੋਤਾਂ 'ਤੇ CRUD (ਬਣਾਓ, ਪੜ੍ਹੋ, ਅੱਪਡੇਟ ਕਰੋ, ਮਿਟਾਓ) ਓਪਰੇਸ਼ਨ ਕਰਨ ਦੀ ਇਜਾਜ਼ਤ ਦਿੰਦਾ ਹੈ; ਇਹ HTTPS ਪ੍ਰੋਟੋਕੋਲ ਅਤੇ REST ਵਿਧੀ 'ਤੇ ਅਧਾਰਤ ਹੈ। ਸਾਰੀਆਂ API ਬੇਨਤੀਆਂ HTTPS ਉੱਤੇ ASA ਨੂੰ ਭੇਜੀਆਂ ਜਾਂਦੀਆਂ ਹਨ, ਅਤੇ ਇੱਕ ਜਵਾਬ ਵਾਪਸ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। ਇਹ ਭਾਗ ਇੱਕ ਓਵਰ ਪ੍ਰਦਾਨ ਕਰਦਾ ਹੈview ਬੇਨਤੀਆਂ ਦੀ ਸੰਰਚਨਾ ਕਿਵੇਂ ਕੀਤੀ ਜਾਂਦੀ ਹੈ, ਅਤੇ ਸੰਭਾਵਿਤ ਜਵਾਬ,

ਢਾਂਚੇ ਦੀ ਬੇਨਤੀ ਕਰੋ

ਉਪਲਬਧ ਬੇਨਤੀ ਵਿਧੀਆਂ ਹਨ:

  • GET - ਨਿਰਧਾਰਤ ਵਸਤੂ ਤੋਂ ਡੇਟਾ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ।
  • PUT - ਦਿੱਤੀ ਗਈ ਜਾਣਕਾਰੀ ਨੂੰ ਨਿਰਧਾਰਤ ਵਸਤੂ ਵਿੱਚ ਜੋੜਦਾ ਹੈ; ਜੇ ਵਸਤੂ ਮੌਜੂਦ ਨਹੀਂ ਹੈ ਤਾਂ 404 ਸਰੋਤ ਨਹੀਂ ਲੱਭੀ ਗਲਤੀ ਵਾਪਸ ਕਰਦਾ ਹੈ।
  • ਪੋਸਟ - ਸਪਲਾਈ ਕੀਤੀ ਜਾਣਕਾਰੀ ਨਾਲ ਆਬਜੈਕਟ ਬਣਾਉਂਦਾ ਹੈ।
  • ਮਿਟਾਓ - ਨਿਰਧਾਰਤ ਵਸਤੂ ਨੂੰ ਮਿਟਾਉਂਦਾ ਹੈ.
  • ਪੈਚ - ਨਿਰਧਾਰਤ ਵਸਤੂ 'ਤੇ ਅੰਸ਼ਕ ਸੋਧਾਂ ਨੂੰ ਲਾਗੂ ਕਰਦਾ ਹੈ।

ਜਵਾਬ ਢਾਂਚਾ

  • ਹਰੇਕ ਬੇਨਤੀ ਮਿਆਰੀ ਸਿਰਲੇਖਾਂ, ਜਵਾਬ ਸਮੱਗਰੀ, ਅਤੇ ਸਥਿਤੀ ਕੋਡ ਦੇ ਨਾਲ ASA ਤੋਂ ਇੱਕ HTTPS ਜਵਾਬ ਪੈਦਾ ਕਰਦੀ ਹੈ।

ਜਵਾਬ ਬਣਤਰ ਹੋ ਸਕਦਾ ਹੈ:

  • ਸਥਾਨ - ਨਵਾਂ ਬਣਾਇਆ ਸਰੋਤ ID; ਸਿਰਫ਼ POST ਲਈ—ਨਵਾਂ ਸਰੋਤ ID ਰੱਖਦਾ ਹੈ (ਯੂਆਰਆਈ ਪ੍ਰਤੀਨਿਧਤਾ ਵਜੋਂ)।
  • ਸਮੱਗਰੀ-ਕਿਸਮ - ਮੀਡੀਆ ਦੀ ਕਿਸਮ ਜਵਾਬ ਸੰਦੇਸ਼ ਦੇ ਮੁੱਖ ਭਾਗ ਦਾ ਵਰਣਨ ਕਰਦੀ ਹੈ; ਜਵਾਬ ਸੁਨੇਹਾ ਬਾਡੀ ਦੀ ਪ੍ਰਤੀਨਿਧਤਾ ਅਤੇ ਸੰਟੈਕਸ ਦਾ ਵਰਣਨ ਕਰਦਾ ਹੈ।

ਹਰੇਕ ਜਵਾਬ ਵਿੱਚ ਇੱਕ HTTP ਸਥਿਤੀ ਜਾਂ ਗਲਤੀ ਕੋਡ ਸ਼ਾਮਲ ਹੁੰਦਾ ਹੈ। ਉਪਲਬਧ ਕੋਡ ਇਹਨਾਂ ਸ਼੍ਰੇਣੀਆਂ ਵਿੱਚ ਆਉਂਦੇ ਹਨ:

  • 20x - ਇੱਕ ਦੋ-ਸੌ ਲੜੀਵਾਰ ਕੋਡ ਸਫਲ ਕਾਰਵਾਈ ਨੂੰ ਦਰਸਾਉਂਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਸ਼ਾਮਲ ਹਨ:
    • 200 ਠੀਕ ਹੈ - ਸਫਲ ਬੇਨਤੀਆਂ ਲਈ ਮਿਆਰੀ ਜਵਾਬ।
    • 201 ਬਣਾਇਆ ਗਿਆ - ਬੇਨਤੀ ਪੂਰੀ ਹੋਈ; ਨਵਾਂ ਸਰੋਤ ਬਣਾਇਆ ਗਿਆ।
    • 202 ਸਵੀਕਾਰ ਕੀਤਾ ਗਿਆ - ਬੇਨਤੀ ਸਵੀਕਾਰ ਕੀਤੀ ਗਈ, ਪਰ ਪ੍ਰਕਿਰਿਆ ਪੂਰੀ ਨਹੀਂ ਹੋਈ।
    • 204 ਕੋਈ ਸਮੱਗਰੀ ਨਹੀਂ - ਸਰਵਰ ਨੇ ਬੇਨਤੀ ਨੂੰ ਸਫਲਤਾਪੂਰਵਕ ਪ੍ਰਕਿਰਿਆ ਕੀਤੀ; ਕੋਈ ਸਮੱਗਰੀ ਵਾਪਸ ਨਹੀਂ ਕੀਤੀ ਜਾ ਰਹੀ ਹੈ।
  • 4xx - ਇੱਕ ਚਾਰ-ਸੌ ਸੀਰੀਜ਼ ਕੋਡ ਇੱਕ ਕਲਾਇੰਟ-ਸਾਈਡ ਗਲਤੀ ਨੂੰ ਦਰਸਾਉਂਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਸ਼ਾਮਲ ਹਨ:
    • 400 ਮਾੜੀ ਬੇਨਤੀ - ਅਣਪਛਾਤੇ ਪੈਰਾਮੀਟਰਾਂ, ਗੁੰਮ ਪੈਰਾਮੀਟਰਾਂ, ਜਾਂ ਅਵੈਧ ਮੁੱਲਾਂ ਸਮੇਤ ਅਵੈਧ ਪੁੱਛਗਿੱਛ ਪੈਰਾਮੀਟਰ।
    • 404 ਨਹੀਂ ਮਿਲਿਆ - ਪ੍ਰਦਾਨ ਕੀਤਾ ਗਿਆ URL ਮੌਜੂਦਾ ਸਰੋਤ ਨਾਲ ਮੇਲ ਨਹੀਂ ਖਾਂਦਾ। ਸਾਬਕਾ ਲਈample, ਇੱਕ HTTP ਮਿਟਾਉਣਾ ਅਸਫਲ ਹੋ ਸਕਦਾ ਹੈ ਕਿਉਂਕਿ ਸਰੋਤ ਉਪਲਬਧ ਨਹੀਂ ਹੈ।
    • 405 ਵਿਧੀ ਦੀ ਆਗਿਆ ਨਹੀਂ ਹੈ - ਇੱਕ HTTP ਬੇਨਤੀ ਪੇਸ਼ ਕੀਤੀ ਗਈ ਸੀ ਜਿਸਦੀ ਸਰੋਤ 'ਤੇ ਆਗਿਆ ਨਹੀਂ ਹੈ; ਸਾਬਕਾ ਲਈample, ਸਿਰਫ਼-ਪੜ੍ਹਨ ਵਾਲੇ ਸਰੋਤ 'ਤੇ ਇੱਕ ਪੋਸਟ।
  • 5xx - ਇੱਕ ਪੰਜ-ਸੌ ਸੀਰੀਜ਼ ਕੋਡ ਸਰਵਰ-ਸਾਈਡ ਗਲਤੀ ਨੂੰ ਦਰਸਾਉਂਦਾ ਹੈ।

ਇੱਕ ਗਲਤੀ ਦੇ ਮਾਮਲੇ ਵਿੱਚ, ਗਲਤੀ ਕੋਡ ਤੋਂ ਇਲਾਵਾ, ਵਾਪਸੀ ਦੇ ਜਵਾਬ ਵਿੱਚ ਇੱਕ ਗਲਤੀ ਆਬਜੈਕਟ ਸ਼ਾਮਲ ਹੋ ਸਕਦਾ ਹੈ ਜਿਸ ਵਿੱਚ ਗਲਤੀ ਬਾਰੇ ਹੋਰ ਵੇਰਵੇ ਸ਼ਾਮਲ ਹਨ। JSON ਗਲਤੀ/ਚੇਤਾਵਨੀ ਜਵਾਬ ਸਕੀਮਾ ਇਸ ਤਰ੍ਹਾਂ ਹੈ:

CISCO-ASA-REST-API-ਐਪ-ਅੰਜੀਰ-1

ਜਿੱਥੇ ਵਸਤੂ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਹਨ:

ਜਾਇਦਾਦ ਟਾਈਪ ਕਰੋ ਵਰਣਨ
ਸੁਨੇਹੇ ਸ਼ਬਦਕੋਸ਼ਾਂ ਦੀ ਸੂਚੀ ਗਲਤੀ ਜਾਂ ਚੇਤਾਵਨੀ ਸੰਦੇਸ਼ਾਂ ਦੀ ਸੂਚੀ
ਕੋਡ ਸਤਰ ਗਲਤੀ/ਚੇਤਾਵਨੀ/ਜਾਣਕਾਰੀ ਕੋਡ
ਵੇਰਵੇ ਸਤਰ ਗਲਤੀ/ਚੇਤਾਵਨੀ/ਜਾਣਕਾਰੀ ਨਾਲ ਸੰਬੰਧਿਤ ਵਿਸਤ੍ਰਿਤ ਸੁਨੇਹਾ

ਨੋਟ: REST API ਕਾਲਾਂ ਦੁਆਰਾ ਕੀਤੀਆਂ ASA ਸੰਰਚਨਾ ਵਿੱਚ ਤਬਦੀਲੀਆਂ ਸਟਾਰਟਅਪ ਕੌਂਫਿਗਰੇਸ਼ਨ ਵਿੱਚ ਬਰਕਰਾਰ ਨਹੀਂ ਹਨ; ਅਰਥਾਤ, ਤਬਦੀਲੀਆਂ ਸਿਰਫ ਚੱਲ ਰਹੀ ਸੰਰਚਨਾ ਲਈ ਨਿਰਧਾਰਤ ਕੀਤੀਆਂ ਜਾਂਦੀਆਂ ਹਨ। ਸ਼ੁਰੂਆਤੀ ਸੰਰਚਨਾ ਵਿੱਚ ਤਬਦੀਲੀਆਂ ਨੂੰ ਸੁਰੱਖਿਅਤ ਕਰਨ ਲਈ, ਤੁਸੀਂ ਇੱਕ ਰਾਈਟਮੇਮ API ਬੇਨਤੀ ਪੋਸਟ ਕਰ ਸਕਦੇ ਹੋ; ਵਧੇਰੇ ਜਾਣਕਾਰੀ ਲਈ, ਸਮੱਗਰੀ ਦੀ ASA REST API ਸਾਰਣੀ ਵਿੱਚ "ਰਾਈਟ ਮੈਮੋਰੀ API" ਐਂਟਰੀ ਦੀ ਪਾਲਣਾ ਕਰੋ।

ASA REST API ਏਜੰਟ ਅਤੇ ਕਲਾਇੰਟ ਨੂੰ ਸਥਾਪਿਤ ਅਤੇ ਕੌਂਫਿਗਰ ਕਰੋ

  • REST API ਏਜੰਟ ਨੂੰ ਹੋਰ ASA ਚਿੱਤਰਾਂ ਦੇ ਨਾਲ ਵੱਖਰੇ ਤੌਰ 'ਤੇ ਪ੍ਰਕਾਸ਼ਿਤ ਕੀਤਾ ਜਾਂਦਾ ਹੈ cisco.com. ਭੌਤਿਕ ASAs ਲਈ, REST API ਪੈਕੇਜ ਨੂੰ ਡਿਵਾਈਸ ਦੇ ਫਲੈਸ਼ 'ਤੇ ਡਾਊਨਲੋਡ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ ਅਤੇ "rest-api ਚਿੱਤਰ" ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਸਥਾਪਿਤ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। REST API ਏਜੰਟ ਨੂੰ ਫਿਰ "rest-api ਏਜੰਟ" ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਸਮਰੱਥ ਬਣਾਇਆ ਜਾਂਦਾ ਹੈ।
  • ਇੱਕ ਵਰਚੁਅਲ ASA (ASAv) ਦੇ ਨਾਲ, REST API ਚਿੱਤਰ ਨੂੰ "boot:" ਭਾਗ ਵਿੱਚ ਡਾਊਨਲੋਡ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਤੁਹਾਨੂੰ ਫਿਰ REST API ਏਜੰਟ ਤੱਕ ਪਹੁੰਚ ਕਰਨ ਅਤੇ ਯੋਗ ਕਰਨ ਲਈ "rest-api ਚਿੱਤਰ" ਕਮਾਂਡ ਜਾਰੀ ਕਰਨੀ ਚਾਹੀਦੀ ਹੈ, ਜਿਸ ਤੋਂ ਬਾਅਦ "rest-api ਏਜੰਟ" ਕਮਾਂਡ ਜਾਰੀ ਕਰਨੀ ਚਾਹੀਦੀ ਹੈ।
  • REST API ਸੌਫਟਵੇਅਰ ਅਤੇ ਹਾਰਡਵੇਅਰ ਲੋੜਾਂ ਅਤੇ ਅਨੁਕੂਲਤਾ ਬਾਰੇ ਜਾਣਕਾਰੀ ਲਈ, Cisco ASA ਅਨੁਕੂਲਤਾ ਮੈਟ੍ਰਿਕਸ ਦੇਖੋ।
  • ਤੁਸੀਂ ਆਪਣੇ ASA ਜਾਂ ASAv ਲਈ ਉਚਿਤ REST API ਪੈਕੇਜ ਨੂੰ ਇਸ ਤੋਂ ਡਾਊਨਲੋਡ ਕਰ ਸਕਦੇ ਹੋ software.cisco.com/download/home. ਖਾਸ ਅਡੈਪਟਿਵ ਸਿਕਿਓਰਿਟੀ ਐਪਲਾਇੰਸ (ASA) ਮਾਡਲ ਦਾ ਪਤਾ ਲਗਾਓ ਅਤੇ ਫਿਰ ਅਡੈਪਟਿਵ ਸਕਿਓਰਿਟੀ ਐਪਲਾਇੰਸ REST API ਪਲੱਗਇਨ ਚੁਣੋ।

ਨੋਟ: REST API ਏਜੰਟ ਇੱਕ Java-ਅਧਾਰਿਤ ਐਪਲੀਕੇਸ਼ਨ ਹੈ। Java Runtime Environment (JRE) REST API ਏਜੰਟ ਪੈਕੇਜ ਵਿੱਚ ਬੰਡਲ ਕੀਤਾ ਗਿਆ ਹੈ।

ਵਰਤੋਂ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼

ਮਹੱਤਵਪੂਰਨ ਤੁਹਾਨੂੰ ਸਾਰੀਆਂ API ਕਾਲਾਂ ਅਤੇ ਮੌਜੂਦਾ ਸਕ੍ਰਿਪਟਾਂ ਵਿੱਚ ਹੈਡਰ ਉਪਭੋਗਤਾ-ਏਜੰਟ: REST API ਏਜੰਟ ਸ਼ਾਮਲ ਕਰਨਾ ਚਾਹੀਦਾ ਹੈ। C ਲਈ -H 'User-Agent: REST API ਏਜੰਟ' ਦੀ ਵਰਤੋਂ ਕਰੋURL ਹੁਕਮ. ਮਲਟੀ-ਪ੍ਰਸੰਗ ਮੋਡ ਵਿੱਚ, REST API ਏਜੰਟ ਕਮਾਂਡਾਂ ਸਿਰਫ਼ ਸਿਸਟਮ ਸੰਦਰਭ ਵਿੱਚ ਉਪਲਬਧ ਹਨ।

ਅਧਿਕਤਮ ਸਮਰਥਿਤ ਸੰਰਚਨਾ ਆਕਾਰ

ASA ਰੈਸਟ API ਇੱਕ "ਆਨ-ਬੋਰਡ" ਐਪਲੀਕੇਸ਼ਨ ਹੈ ਜੋ ਭੌਤਿਕ ASA ਦੇ ਅੰਦਰ ਚੱਲ ਰਹੀ ਹੈ, ਅਤੇ ਇਸ ਤਰ੍ਹਾਂ ਇਸ ਨੂੰ ਨਿਰਧਾਰਤ ਕੀਤੀ ਗਈ ਮੈਮੋਰੀ 'ਤੇ ਇੱਕ ਸੀਮਾ ਹੈ। 2 ਅਤੇ 5555 ਵਰਗੇ ਹਾਲੀਆ ਪਲੇਟਫਾਰਮਾਂ 'ਤੇ ਰੀਲੀਜ਼ ਚੱਕਰ ਦੌਰਾਨ ਵੱਧ ਤੋਂ ਵੱਧ ਸਮਰਥਿਤ ਚੱਲ ਰਹੀ ਸੰਰਚਨਾ ਦਾ ਆਕਾਰ ਲਗਭਗ 5585 MB ਤੱਕ ਵਧ ਗਿਆ ਹੈ। ASA ਰੈਸਟ API ਵਿੱਚ ਵਰਚੁਅਲ ASA ਪਲੇਟਫਾਰਮਾਂ 'ਤੇ ਮੈਮੋਰੀ ਪਾਬੰਦੀਆਂ ਵੀ ਹਨ। ASAv5 'ਤੇ ਕੁੱਲ ਮੈਮੋਰੀ 1.5 GB ਹੋ ਸਕਦੀ ਹੈ, ਜਦੋਂ ਕਿ ASAv10 'ਤੇ ਇਹ 2 GB ਹੈ। ASAv450 ਅਤੇ ASAv500 ਲਈ ਬਾਕੀ API ਸੀਮਾਵਾਂ ਕ੍ਰਮਵਾਰ 5 KB ਅਤੇ 10 KB ਹਨ।

ਇਸ ਲਈ, ਧਿਆਨ ਰੱਖੋ ਕਿ ਵੱਡੀਆਂ ਚੱਲ ਰਹੀਆਂ ਸੰਰਚਨਾਵਾਂ ਵੱਖ-ਵੱਖ ਮੈਮੋਰੀ-ਇੰਟੈਂਸਿਵ ਸਥਿਤੀਆਂ ਵਿੱਚ ਅਪਵਾਦ ਪੈਦਾ ਕਰ ਸਕਦੀਆਂ ਹਨ ਜਿਵੇਂ ਕਿ ਵੱਡੀ ਗਿਣਤੀ ਵਿੱਚ ਸਮਕਾਲੀ ਬੇਨਤੀਆਂ, ਜਾਂ ਵੱਡੀ ਬੇਨਤੀ ਵਾਲੀਅਮ। ਇਹਨਾਂ ਸਥਿਤੀਆਂ ਵਿੱਚ, ਰੈਸਟ API GET/PUT/POST ਕਾਲਾਂ 500 - ਅੰਦਰੂਨੀ ਸਰਵਰ ਗਲਤੀ ਸੁਨੇਹਿਆਂ ਨਾਲ ਅਸਫਲ ਹੋਣੀਆਂ ਸ਼ੁਰੂ ਹੋ ਸਕਦੀਆਂ ਹਨ, ਅਤੇ ਬਾਕੀ API ਏਜੰਟ ਹਰ ਵਾਰ ਆਪਣੇ ਆਪ ਮੁੜ ਚਾਲੂ ਹੋ ਜਾਵੇਗਾ। ਇਸ ਸਥਿਤੀ ਦੇ ਹੱਲ ਜਾਂ ਤਾਂ ਉੱਚ-ਮੈਮੋਰੀ ASA/FPR ਜਾਂ ASAV ਪਲੇਟਫਾਰਮਾਂ 'ਤੇ ਚਲੇ ਜਾਣਾ, ਜਾਂ ਚੱਲ ਰਹੀ ਸੰਰਚਨਾ ਦੇ ਆਕਾਰ ਨੂੰ ਘਟਾਉਣਾ ਹੈ।

REST API ਏਜੰਟ ਨੂੰ ਡਾਊਨਲੋਡ ਅਤੇ ਸਥਾਪਿਤ ਕਰੋ

CLI ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ, ਇੱਕ ਖਾਸ ASA 'ਤੇ ASA REST API ਏਜੰਟ ਨੂੰ ਡਾਊਨਲੋਡ ਅਤੇ ਸਥਾਪਿਤ ਕਰਨ ਲਈ ਇਹਨਾਂ ਕਦਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ:

  • ਕਦਮ 1: ਲੋੜੀਂਦੇ ASA 'ਤੇ, ਕਾਪੀ ਜਾਰੀ ਕਰੋ disk0: ਮੌਜੂਦਾ ASA REST API ਪੈਕੇਜ ਨੂੰ ਡਾਊਨਲੋਡ ਕਰਨ ਲਈ ਕਮਾਂਡ cisco.com ASA ਦੀ ਫਲੈਸ਼ ਮੈਮੋਰੀ ਲਈ।
    • ਸਾਬਕਾ ਲਈampLe: ਕਾਪੀ tftp://10.7.0.80/asa-restapi-111-lfbff-k8.SPA disk0:
  • ਕਦਮ 2: ਬਾਕੀ-ਏਪੀਆਈ ਚਿੱਤਰ ਡਿਸਕ0 ਜਾਰੀ ਕਰੋ:/ ਪੈਕੇਜ ਦੀ ਪੁਸ਼ਟੀ ਅਤੇ ਇੰਸਟਾਲ ਕਰਨ ਲਈ ਕਮਾਂਡ.
    • ਸਾਬਕਾ ਲਈampLe: rest-api ਚਿੱਤਰ disk0:/asa-restapi-111-lfbff-k8.SPA

ਇੰਸਟਾਲਰ ਅਨੁਕੂਲਤਾ ਅਤੇ ਪ੍ਰਮਾਣਿਕਤਾ ਜਾਂਚ ਕਰੇਗਾ, ਅਤੇ ਫਿਰ ਪੈਕੇਜ ਨੂੰ ਸਥਾਪਿਤ ਕਰੇਗਾ। ASA ਰੀਬੂਟ ਨਹੀਂ ਹੋਵੇਗਾ।

REST API ਏਜੰਟ ਨੂੰ ਸਮਰੱਥ ਬਣਾਓ

ਕਿਸੇ ਖਾਸ ASA 'ਤੇ ASA REST API ਏਜੰਟ ਨੂੰ ਸਮਰੱਥ ਬਣਾਉਣ ਲਈ ਇਹਨਾਂ ਕਦਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ:

  • ਕਦਮ 1: ਯਕੀਨੀ ਬਣਾਓ ਕਿ ASA 'ਤੇ ਸਹੀ ਸਾਫਟਵੇਅਰ ਚਿੱਤਰ ਸਥਾਪਤ ਹੈ।
  • ਕਦਮ 2: CLI ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ, ਯਕੀਨੀ ਬਣਾਓ ਕਿ HTTP ਸਰਵਰ ASA 'ਤੇ ਸਮਰੱਥ ਹੈ, ਅਤੇ API ਕਲਾਇੰਟ ਪ੍ਰਬੰਧਨ ਇੰਟਰਫੇਸ ਨਾਲ ਜੁੜ ਸਕਦੇ ਹਨ।
    • ਸਾਬਕਾ ਲਈampLe: http ਸਰਵਰ ਯੋਗ
    • http 0.0.0.0 0.0.0.0
  • ਕਦਮ 3: CLI ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ, API ਕਨੈਕਸ਼ਨਾਂ ਲਈ HTTP ਪ੍ਰਮਾਣਿਕਤਾ ਨੂੰ ਪਰਿਭਾਸ਼ਿਤ ਕਰੋ। ਸਾਬਕਾ ਲਈample: aaa ਪ੍ਰਮਾਣਿਕਤਾ http ਕੰਸੋਲ ਸਥਾਨਕ
  • ਕਦਮ 4: CLI ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ, API ਟ੍ਰੈਫਿਕ ਲਈ ASA 'ਤੇ ਇੱਕ ਸਥਿਰ ਰੂਟ ਬਣਾਓ। ਸਾਬਕਾ ਲਈample: ਰਸਤਾ 0.0.0.0 0.0.0.0 1
  • ਕਦਮ 5: CLI ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ, ASA 'ਤੇ ASA REST API ਏਜੰਟ ਨੂੰ ਸਮਰੱਥ ਬਣਾਓ। ਸਾਬਕਾ ਲਈample: ਆਰਾਮ-ਏਪੀਆਈ ਏਜੰਟ

REST API ਪ੍ਰਮਾਣਿਕਤਾ

ਪ੍ਰਮਾਣਿਤ ਕਰਨ ਦੇ ਦੋ ਤਰੀਕੇ ਹਨ: ਬੇਸਿਕ HTTP ਪ੍ਰਮਾਣਿਕਤਾ, ਜੋ ਹਰੇਕ ਬੇਨਤੀ ਵਿੱਚ ਇੱਕ ਉਪਭੋਗਤਾ ਨਾਮ ਅਤੇ ਪਾਸਵਰਡ ਪਾਸ ਕਰਦਾ ਹੈ, ਜਾਂ ਸੁਰੱਖਿਅਤ HTTPS ਟ੍ਰਾਂਸਪੋਰਟ ਦੇ ਨਾਲ ਟੋਕਨ-ਅਧਾਰਿਤ ਪ੍ਰਮਾਣਿਕਤਾ, ਜੋ ਹਰੇਕ ਬੇਨਤੀ ਦੇ ਨਾਲ ਪਹਿਲਾਂ ਬਣਾਇਆ ਗਿਆ ਟੋਕਨ ਪਾਸ ਕਰਦਾ ਹੈ। ਕਿਸੇ ਵੀ ਤਰ੍ਹਾਂ, ਹਰ ਬੇਨਤੀ ਲਈ ਪ੍ਰਮਾਣਿਕਤਾ ਕੀਤੀ ਜਾਵੇਗੀ। ਟੋਕਨ-ਅਧਾਰਿਤ ਪ੍ਰਮਾਣਿਕਤਾ ਬਾਰੇ ਵਾਧੂ ਜਾਣਕਾਰੀ ਲਈ ASA REST API v7.14(x) ਗਾਈਡ ਦੇ ਬਾਰੇ ਵਿੱਚ ਭਾਗ, “Token_Authentication_API” ਦੇਖੋ।

ਨੋਟ: ASA 'ਤੇ ਸਰਟੀਫਿਕੇਟ ਅਥਾਰਟੀ (CA) ਦੁਆਰਾ ਜਾਰੀ ਕੀਤੇ ਸਰਟੀਫਿਕੇਟਾਂ ਦੀ ਵਰਤੋਂ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ, ਇਸਲਈ REST API ਕਲਾਇੰਟ SSL ਕਨੈਕਸ਼ਨ ਸਥਾਪਤ ਕਰਨ ਵੇਲੇ ASA ਸਰਵਰ ਸਰਟੀਫਿਕੇਟਾਂ ਨੂੰ ਪ੍ਰਮਾਣਿਤ ਕਰ ਸਕਦੇ ਹਨ।

ਕਮਾਂਡ ਅਧਿਕਾਰ

ਜੇਕਰ ਕਮਾਂਡ ਅਧਿਕਾਰ ਨੂੰ ਇੱਕ ਬਾਹਰੀ AAA ਸਰਵਰ ਵਰਤਣ ਲਈ ਕੌਂਫਿਗਰ ਕੀਤਾ ਗਿਆ ਹੈ (ਉਦਾਹਰਣ ਲਈample, aa ਅਧਿਕਾਰ ਕਮਾਂਡ ), ਤਾਂ enable_1 ਨਾਮ ਦਾ ਇੱਕ ਉਪਭੋਗਤਾ ਉਸ ਸਰਵਰ 'ਤੇ ਪੂਰੀ ਕਮਾਂਡ ਦੇ ਅਧਿਕਾਰਾਂ ਨਾਲ ਮੌਜੂਦ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ। ਜੇਕਰ ਕਮਾਂਡ ਆਥੋਰਾਈਜ਼ੇਸ਼ਨ ਨੂੰ ASA ਦੇ LOCAL ਡਾਟਾਬੇਸ (aaa ਪ੍ਰਮਾਣੀਕਰਨ ਕਮਾਂਡ LOCAL) ਦੀ ਵਰਤੋਂ ਕਰਨ ਲਈ ਕੌਂਫਿਗਰ ਕੀਤਾ ਗਿਆ ਹੈ, ਤਾਂ ਸਾਰੇ REST API ਉਪਭੋਗਤਾਵਾਂ ਨੂੰ LOCAL ਡਾਟਾਬੇਸ ਵਿੱਚ ਵਿਸ਼ੇਸ਼ ਅਧਿਕਾਰ ਪੱਧਰਾਂ ਨਾਲ ਰਜਿਸਟਰ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ ਜੋ ਉਹਨਾਂ ਦੀਆਂ ਭੂਮਿਕਾਵਾਂ ਲਈ ਉਚਿਤ ਹਨ:

  • ਨਿਗਰਾਨੀ ਲਈ ਬੇਨਤੀਆਂ ਕਰਨ ਲਈ ਵਿਸ਼ੇਸ਼ ਅਧਿਕਾਰ ਪੱਧਰ 3 ਜਾਂ ਇਸ ਤੋਂ ਵੱਧ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ।
  • GET ਬੇਨਤੀਆਂ ਦੀ ਮੰਗ ਕਰਨ ਲਈ ਵਿਸ਼ੇਸ਼ ਅਧਿਕਾਰ ਪੱਧਰ 5 ਜਾਂ ਇਸ ਤੋਂ ਵੱਧ ਦੀ ਲੋੜ ਹੈ।
  • PUT/POST/DELETE ਓਪਰੇਸ਼ਨਾਂ ਨੂੰ ਸ਼ੁਰੂ ਕਰਨ ਲਈ ਵਿਸ਼ੇਸ਼ ਅਧਿਕਾਰ ਪੱਧਰ 15 ਜ਼ਰੂਰੀ ਹੈ।

ਆਪਣੇ REST API ਕਲਾਇੰਟ ਨੂੰ ਕੌਂਫਿਗਰ ਕਰੋ

ਆਪਣੇ ਸਥਾਨਕ-ਹੋਸਟ ਬ੍ਰਾਊਜ਼ਰ 'ਤੇ ਇੱਕ REST API ਕਲਾਇੰਟ ਨੂੰ ਸਥਾਪਿਤ ਅਤੇ ਸੰਰਚਿਤ ਕਰਨ ਲਈ ਇਹਨਾਂ ਕਦਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ:

  • ਕਦਮ 1: ਆਪਣੇ ਬ੍ਰਾਊਜ਼ਰ ਲਈ ਇੱਕ REST API ਕਲਾਇੰਟ ਪ੍ਰਾਪਤ ਕਰੋ ਅਤੇ ਸਥਾਪਿਤ ਕਰੋ।
    • Chrome ਲਈ, Google ਤੋਂ REST ਕਲਾਇੰਟ ਸਥਾਪਤ ਕਰੋ। ਫਾਇਰਫਾਕਸ ਲਈ, RESTClient ਐਡ-ਆਨ ਇੰਸਟਾਲ ਕਰੋ। ਇੰਟਰਨੈੱਟ ਐਕਸਪਲੋਰਰ ਸਮਰਥਿਤ ਨਹੀਂ ਹੈ।
  • ਕਦਮ 2: ਆਪਣੇ ਬ੍ਰਾਊਜ਼ਰ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਹੇਠਾਂ ਦਿੱਤੀ ਬੇਨਤੀ ਸ਼ੁਰੂ ਕਰੋ: https: /api/objects/networkobjects
    • ਜੇਕਰ ਤੁਸੀਂ ਇੱਕ ਗੈਰ-ਗਲਤੀ ਜਵਾਬ ਪ੍ਰਾਪਤ ਕਰਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ ASA 'ਤੇ ਕੰਮ ਕਰ ਰਹੇ REST API ਏਜੰਟ ਤੱਕ ਪਹੁੰਚ ਗਏ ਹੋ।
    • ਜੇਕਰ ਤੁਹਾਨੂੰ ਏਜੰਟ ਦੀ ਬੇਨਤੀ ਨਾਲ ਸਮੱਸਿਆਵਾਂ ਆ ਰਹੀਆਂ ਹਨ, ਤਾਂ ਤੁਸੀਂ CLI ਕੰਸੋਲ 'ਤੇ ਡੀਬਗਿੰਗ ਜਾਣਕਾਰੀ ਦੇ ਪ੍ਰਦਰਸ਼ਨ ਨੂੰ ਸਮਰੱਥ ਕਰ ਸਕਦੇ ਹੋ, ਜਿਵੇਂ ਕਿ ASA 'ਤੇ REST API ਡੀਬਗਿੰਗ ਨੂੰ ਸਮਰੱਥ ਕਰਨ ਵਿੱਚ ਦੱਸਿਆ ਗਿਆ ਹੈ।
  • ਕਦਮ 3: ਵਿਕਲਪਿਕ ਤੌਰ 'ਤੇ, ਤੁਸੀਂ POST ਓਪਰੇਸ਼ਨ ਕਰਕੇ ASA ਨਾਲ ਆਪਣੇ ਕਨੈਕਸ਼ਨ ਦੀ ਜਾਂਚ ਕਰ ਸਕਦੇ ਹੋ।

ਸਾਬਕਾ ਲਈampLe: ਬੁਨਿਆਦੀ ਅਧਿਕਾਰ ਪ੍ਰਮਾਣ ਪੱਤਰ ਪ੍ਰਦਾਨ ਕਰੋ ( ), ਜਾਂ ਇੱਕ ਪ੍ਰਮਾਣਿਕਤਾ ਟੋਕਨ (ਵਾਧੂ ਜਾਣਕਾਰੀ ਲਈ ਟੋਕਨ ਪ੍ਰਮਾਣਿਕਤਾ ਵੇਖੋ)।

  • ਟੀਚਾ ਬੇਨਤੀ ਪਤਾ: https://<asa management ipaddress>/api/objects/networkobjects
  • ਸਰੀਰ ਸਮੱਗਰੀ ਦੀ ਕਿਸਮ: ਐਪਲੀਕੇਸ਼ਨ/json

ਓਪਰੇਸ਼ਨ ਦਾ ਕੱਚਾ ਸਰੀਰ:

CISCO-ASA-REST-API-ਐਪ-ਅੰਜੀਰ-2

ਤੁਸੀਂ ਹੁਣ ASA ਨੂੰ ਕੌਂਫਿਗਰ ਕਰਨ ਅਤੇ ਨਿਗਰਾਨੀ ਕਰਨ ਲਈ ASA REST API ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ। ਕਾਲ ਵੇਰਵੇ ਅਤੇ ਸਾਬਕਾ ਲਈ API ਦਸਤਾਵੇਜ਼ ਵੇਖੋamples.

ਬੈਕ-ਅੱਪ ਸੰਰਚਨਾ ਨੂੰ ਪੂਰੀ ਤਰ੍ਹਾਂ ਰੀਸਟੋਰ ਕਰਨ ਬਾਰੇ

REST API ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ ASA 'ਤੇ ਇੱਕ ਪੂਰੀ ਬੈਕ-ਅੱਪ ਸੰਰਚਨਾ ਨੂੰ ਰੀਸਟੋਰ ਕਰਨ ਨਾਲ ASA ਮੁੜ ਲੋਡ ਹੋ ਜਾਵੇਗਾ। ਇਸ ਤੋਂ ਬਚਣ ਲਈ, ਬੈਕ-ਅੱਪ ਸੰਰਚਨਾ ਨੂੰ ਬਹਾਲ ਕਰਨ ਲਈ ਹੇਠ ਦਿੱਤੀ ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰੋ:

  • {
    • "ਕਮਾਂਡਸ":["ਕਾਪੀ /ਨੋਕਨਫਰਮ ਡਿਸਕ 0:/filename> run-config"]
  • }
    • ਜਿੱਥੇfilename> backup.cfg ਹੈ ਜਾਂ ਜੋ ਵੀ ਨਾਮ ਤੁਸੀਂ ਸੰਰਚਨਾ ਦਾ ਬੈਕਅੱਪ ਲੈਂਦੇ ਸਮੇਂ ਵਰਤਿਆ ਹੈ।

ਦਸਤਾਵੇਜ਼ੀ ਕੰਸੋਲ ਅਤੇ ਨਿਰਯਾਤ API ਸਕ੍ਰਿਪਟਾਂ

ਤੁਸੀਂ ASA 'ਤੇ ਸਿੱਧੇ API ਕਾਲਾਂ ਬਾਰੇ ਸਿੱਖਣ ਅਤੇ ਅਜ਼ਮਾਉਣ ਲਈ host:port/doc/ 'ਸੈਂਡਬਾਕਸ' ਦੇ ਤੌਰ 'ਤੇ ਉਪਲਬਧ REST API ਔਨ-ਲਾਈਨ ਦਸਤਾਵੇਜ਼ੀ ਕੰਸੋਲ (ਜਿਸ ਨੂੰ "Doc UI" ਕਿਹਾ ਜਾਂਦਾ ਹੈ) ਦੀ ਵਰਤੋਂ ਵੀ ਕਰ ਸਕਦੇ ਹੋ। ਇਸ ਤੋਂ ਇਲਾਵਾ, ਤੁਸੀਂ ਪ੍ਰਦਰਸ਼ਿਤ ਵਿਧੀ ਸਾਬਕਾ ਨੂੰ ਸੁਰੱਖਿਅਤ ਕਰਨ ਲਈ Doc UI ਵਿੱਚ ਐਕਸਪੋਰਟ ਓਪਰੇਸ਼ਨ ਬਟਨ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋample ਇੱਕ JavaScript, Python, ਜਾਂ Perl ਸਕ੍ਰਿਪਟ ਦੇ ਰੂਪ ਵਿੱਚ file ਤੁਹਾਡੇ ਸਥਾਨਕ ਮੇਜ਼ਬਾਨ ਨੂੰ. ਤੁਸੀਂ ਫਿਰ ਇਸ ਸਕ੍ਰਿਪਟ ਨੂੰ ਆਪਣੇ ASA 'ਤੇ ਲਾਗੂ ਕਰ ਸਕਦੇ ਹੋ, ਅਤੇ ਇਸ ਨੂੰ ਹੋਰ ASAs ਅਤੇ ਹੋਰ ਨੈੱਟਵਰਕ ਡਿਵਾਈਸਾਂ 'ਤੇ ਐਪਲੀਕੇਸ਼ਨ ਲਈ ਸੰਪਾਦਿਤ ਕਰ ਸਕਦੇ ਹੋ। ਇਸਦਾ ਅਰਥ ਮੁੱਖ ਤੌਰ 'ਤੇ ਵਿਦਿਅਕ ਅਤੇ ਬੂਟਸਟਰੈਪਿੰਗ ਟੂਲ ਵਜੋਂ ਸੀ।

JavaScript

  • ਇੱਕ JavaScript ਦੀ ਵਰਤੋਂ ਕਰਨਾ file node.js ਦੀ ਸਥਾਪਨਾ ਦੀ ਲੋੜ ਹੈ, ਜੋ ਕਿ ਇੱਥੇ ਲੱਭੀ ਜਾ ਸਕਦੀ ਹੈ http://nodejs.org/.
  • node.js ਦੀ ਵਰਤੋਂ ਕਰਕੇ, ਤੁਸੀਂ ਇੱਕ JavaScript ਚਲਾ ਸਕਦੇ ਹੋ file, ਆਮ ਤੌਰ 'ਤੇ ਇੱਕ ਬ੍ਰਾਊਜ਼ਰ ਲਈ ਲਿਖਿਆ ਜਾਂਦਾ ਹੈ, ਜਿਵੇਂ ਕਿ ਕਮਾਂਡ-ਲਾਈਨ ਸਕ੍ਰਿਪਟ। ਬਸ ਇੰਸਟਾਲੇਸ਼ਨ ਨਿਰਦੇਸ਼ਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ, ਅਤੇ ਫਿਰ ਆਪਣੀ ਸਕ੍ਰਿਪਟ ਨੂੰ ਨੋਡ script.js ਨਾਲ ਚਲਾਓ।

ਪਾਈਥਨ

  • ਪਾਈਥਨ ਸਕ੍ਰਿਪਟਾਂ ਲਈ ਤੁਹਾਨੂੰ ਪਾਇਥਨ ਇੰਸਟਾਲ ਕਰਨ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ, ਇਸ ਤੋਂ ਉਪਲਬਧ ਹੈ https://www.python.org/.
  • ਇੱਕ ਵਾਰ ਜਦੋਂ ਤੁਸੀਂ ਪਾਈਥਨ ਸਥਾਪਤ ਕਰ ਲੈਂਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ python script.py ਉਪਭੋਗਤਾ ਨਾਮ ਪਾਸਵਰਡ ਨਾਲ ਆਪਣੀ ਸਕ੍ਰਿਪਟ ਚਲਾ ਸਕਦੇ ਹੋ।

ਪਰਲ

ਪਰਲ ਸਕ੍ਰਿਪਟਾਂ ਦੀ ਵਰਤੋਂ ਕਰਨ ਲਈ ਕੁਝ ਵਾਧੂ ਸੈੱਟ-ਅੱਪ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ-ਤੁਹਾਨੂੰ ਪੰਜ ਭਾਗਾਂ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ: ਪਰਲ ਖੁਦ, ਅਤੇ ਚਾਰ ਪਰਲ ਲਾਇਬ੍ਰੇਰੀਆਂ:

ਇੱਥੇ ਇੱਕ ਸਾਬਕਾ ਹੈampਮੈਕਿਨਟੋਸ਼ 'ਤੇ ਪਰਲ ਨੂੰ ਬੂਟਸਟਰੈਪ ਕਰਨ ਦੀ ਲੀ:

  • $ sudo perl -MCPAN e ਸ਼ੈੱਲ
  • cpan> ਇੰਸਟਾਲ ਬੰਡਲ::CPAN
  • cpan> REST:: ਨੂੰ ਇੰਸਟਾਲ ਕਰੋ ਕਲਾਇੰਟ
  • cpan> MIME ਇੰਸਟਾਲ ਕਰੋ::ਬੇਸ 64
  • cpan> JSON ਇੰਸਟਾਲ ਕਰੋ

ਨਿਰਭਰਤਾਵਾਂ ਨੂੰ ਸਥਾਪਿਤ ਕਰਨ ਤੋਂ ਬਾਅਦ, ਤੁਸੀਂ perl script.pl ਉਪਭੋਗਤਾ ਨਾਮ ਪਾਸਵਰਡ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਆਪਣੀ ਸਕ੍ਰਿਪਟ ਚਲਾ ਸਕਦੇ ਹੋ।

ASA 'ਤੇ REST API ਡੀਬੱਗਿੰਗ ਨੂੰ ਸਮਰੱਥ ਕਰਨਾ

ਜੇਕਰ ਤੁਹਾਨੂੰ ASA 'ਤੇ REST API ਨੂੰ ਕੌਂਫਿਗਰ ਕਰਨ ਜਾਂ ਕਨੈਕਟ ਕਰਨ ਵਿੱਚ ਸਮੱਸਿਆਵਾਂ ਆ ਰਹੀਆਂ ਹਨ, ਤਾਂ ਤੁਸੀਂ ਆਪਣੇ ਕੰਸੋਲ 'ਤੇ ਡੀਬੱਗਿੰਗ ਸੁਨੇਹਿਆਂ ਦੇ ਡਿਸਪਲੇ ਨੂੰ ਸਮਰੱਥ ਕਰਨ ਲਈ ਹੇਠਾਂ ਦਿੱਤੀ CLI ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ। ਡੀਬੱਗ ਸੁਨੇਹਿਆਂ ਨੂੰ ਅਯੋਗ ਕਰਨ ਲਈ ਨੋ ਫਾਰਮ ਦੀ ਵਰਤੋਂ ਕਰੋ।
ਡੀਬੱਗ ਰੈਸਟ-ਏਪੀਆਈ [ਏਜੰਟ | cli | ਗਾਹਕ | ਡੈਮਨ | ਪ੍ਰਕਿਰਿਆ | token-auth] [ਗਲਤੀ | ਘਟਨਾ] ਕੋਈ ਡੀਬੱਗ ਰੈਸਟ-ਏਪੀਆਈ ਨਹੀਂ

ਸੰਟੈਕਸ ਵਰਣਨ

  • ਏਜੰਟ: (ਵਿਕਲਪਿਕ) REST API ਏਜੰਟ ਡੀਬਗਿੰਗ ਜਾਣਕਾਰੀ ਨੂੰ ਸਮਰੱਥ ਬਣਾਓ।
  • cli: (ਵਿਕਲਪਿਕ) REST API CLI ਡੈਮਨ-ਟੂ-ਏਜੰਟ ਸੰਚਾਰਾਂ ਲਈ ਡੀਬਗਿੰਗ ਸੁਨੇਹਿਆਂ ਨੂੰ ਸਮਰੱਥ ਬਣਾਓ।
  • ਗਾਹਕ: (ਵਿਕਲਪਿਕ) REST API ਕਲਾਇੰਟ ਅਤੇ REST API ਏਜੰਟ ਵਿਚਕਾਰ ਸੁਨੇਹਾ ਰੂਟਿੰਗ ਲਈ ਡੀਬਗਿੰਗ ਜਾਣਕਾਰੀ ਨੂੰ ਸਮਰੱਥ ਬਣਾਓ।
  • ਡੈਮਨ: (ਵਿਕਲਪਿਕ) REST API ਡੈਮਨ-ਟੂ-ਏਜੰਟ ਸੰਚਾਰਾਂ ਲਈ ਡੀਬਗਿੰਗ ਸੁਨੇਹਿਆਂ ਨੂੰ ਸਮਰੱਥ ਬਣਾਓ।
  • ਪ੍ਰਕਿਰਿਆ: (ਵਿਕਲਪਿਕ) REST API ਏਜੰਟ ਪ੍ਰਕਿਰਿਆ ਸ਼ੁਰੂ/ਰੋਕ ਡੀਬਗਿੰਗ ਜਾਣਕਾਰੀ ਨੂੰ ਸਮਰੱਥ ਬਣਾਓ।
  • ਟੋਕਨ-ਪ੍ਰਮਾਣਿਕਤਾ: (ਵਿਕਲਪਿਕ) REST API ਟੋਕਨ ਪ੍ਰਮਾਣਿਕਤਾ ਡੀਬਗਿੰਗ ਜਾਣਕਾਰੀ।
  • ਗਲਤੀ: (ਵਿਕਲਪਿਕ) ਡੀਬੱਗ ਸੁਨੇਹਿਆਂ ਨੂੰ ਸਿਰਫ਼ API ਦੁਆਰਾ ਲੌਗ ਕੀਤੀਆਂ ਗਲਤੀਆਂ ਤੱਕ ਸੀਮਤ ਕਰਨ ਲਈ ਇਸ ਕੀਵਰਡ ਦੀ ਵਰਤੋਂ ਕਰੋ।
  • ਘਟਨਾ: (ਵਿਕਲਪਿਕ) ਡੀਬੱਗ ਸੁਨੇਹਿਆਂ ਨੂੰ ਸਿਰਫ਼ API ਦੁਆਰਾ ਲੌਗ ਕੀਤੇ ਇਵੈਂਟਾਂ ਤੱਕ ਸੀਮਤ ਕਰਨ ਲਈ ਇਸ ਕੀਵਰਡ ਦੀ ਵਰਤੋਂ ਕਰੋ।

ਵਰਤੋਂ ਦਿਸ਼ਾ-ਨਿਰਦੇਸ਼

ਜੇਕਰ ਤੁਸੀਂ ਕੋਈ ਖਾਸ ਕੰਪੋਨੈਂਟ ਕੀਵਰਡ ਨਹੀਂ ਦਿੰਦੇ ਹੋ (ਭਾਵ, ਜੇਕਰ ਤੁਸੀਂ ਸਿਰਫ਼ ਡੀਬੱਗ ਰੈਸਟ-ਏਪੀਆਈ ਕਮਾਂਡ ਜਾਰੀ ਕਰਦੇ ਹੋ), ਤਾਂ ਡੀਬੱਗ ਸੁਨੇਹੇ ਸਾਰੇ ਕੰਪੋਨੈਂਟ ਕਿਸਮਾਂ ਲਈ ਪ੍ਰਦਰਸ਼ਿਤ ਹੁੰਦੇ ਹਨ। ਜੇਕਰ ਤੁਸੀਂ ਇਵੈਂਟ ਜਾਂ ਐਰਰ ਕੀਵਰਡ ਨਹੀਂ ਦਿੰਦੇ ਹੋ, ਤਾਂ ਇਵੈਂਟ ਅਤੇ ਐਰਰ ਸੁਨੇਹੇ ਦੋਵੇਂ ਦਿੱਤੇ ਗਏ ਕੰਪੋਨੈਂਟ ਲਈ ਪ੍ਰਦਰਸ਼ਿਤ ਹੁੰਦੇ ਹਨ। ਸਾਬਕਾ ਲਈample, ਡੀਬੱਗ ਰੈਸਟ-ਏਪੀਆਈ ਡੈਮਨ ਇਵੈਂਟ ਸਿਰਫ ਏਪੀਆਈ ਡੈਮਨ-ਟੂ-ਏਜੰਟ ਸੰਚਾਰਾਂ ਲਈ ਈਵੈਂਟ ਡੀਬੱਗ ਸੁਨੇਹੇ ਦਿਖਾਏਗਾ।

ਸੰਬੰਧਿਤ ਕਮਾਂਡਾਂ

ਕਮਾਂਡ/ਵੇਰਵਾ

  • ਡੀਬੱਗ HTTP; ਇਸ ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰੋ view HTTP ਆਵਾਜਾਈ ਬਾਰੇ ਵਿਸਤ੍ਰਿਤ ਜਾਣਕਾਰੀ।

ASA REST API-ਸਬੰਧਤ Syslog ਸੁਨੇਹੇ

ASA REST API-ਸਬੰਧਤ ਸਿਸਟਮ-ਲੌਗ ਸੁਨੇਹਿਆਂ ਦਾ ਵਰਣਨ ਇਸ ਭਾਗ ਵਿੱਚ ਕੀਤਾ ਗਿਆ ਹੈ।

342001

  • ਗਲਤੀ ਸੁਨੇਹਾ: %ASA-7-342001: REST API ਏਜੰਟ ਸਫਲਤਾਪੂਰਵਕ ਸ਼ੁਰੂ ਹੋਇਆ।
    • ਵਿਆਖਿਆ: ਇੱਕ REST API ਕਲਾਇੰਟ ASA ਨੂੰ ਕੌਂਫਿਗਰ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ REST API ਏਜੰਟ ਨੂੰ ਸਫਲਤਾਪੂਰਵਕ ਸ਼ੁਰੂ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ।
    • ਸਿਫਾਰਸ਼ੀ ਕਾਰਵਾਈ: ਕੋਈ ਨਹੀਂ।

342002

  • ਗਲਤੀ ਸੁਨੇਹਾ: %ASA-3-342002: REST API ਏਜੰਟ ਅਸਫਲ, ਕਾਰਨ: ਕਾਰਨ
    • ਵਿਆਖਿਆ: REST API ਏਜੰਟ ਕਈ ਕਾਰਨਾਂ ਕਰਕੇ ਸ਼ੁਰੂ ਜਾਂ ਕ੍ਰੈਸ਼ ਹੋਣ ਵਿੱਚ ਅਸਫਲ ਹੋ ਸਕਦਾ ਹੈ, ਅਤੇ ਕਾਰਨ ਨਿਰਧਾਰਤ ਕੀਤਾ ਗਿਆ ਹੈ।
    • ਕਾਰਨ — REST API ਅਸਫਲਤਾ ਦਾ ਕਾਰਨ

ਸਿਫਾਰਸ਼ੀ ਕਾਰਵਾਈ: ਲੌਗ ਕੀਤੇ ਕਾਰਨ ਦੇ ਆਧਾਰ 'ਤੇ ਮੁੱਦੇ ਨੂੰ ਹੱਲ ਕਰਨ ਲਈ ਕੀਤੀਆਂ ਗਈਆਂ ਕਾਰਵਾਈਆਂ ਵੱਖ-ਵੱਖ ਹੁੰਦੀਆਂ ਹਨ। ਸਾਬਕਾ ਲਈample, REST API ਏਜੰਟ ਕ੍ਰੈਸ਼ ਹੋ ਜਾਂਦਾ ਹੈ ਜਦੋਂ ਜਾਵਾ ਪ੍ਰਕਿਰਿਆ ਮੈਮੋਰੀ ਖਤਮ ਹੋ ਜਾਂਦੀ ਹੈ। ਜੇਕਰ ਅਜਿਹਾ ਹੁੰਦਾ ਹੈ, ਤਾਂ ਤੁਹਾਨੂੰ REST API ਏਜੰਟ ਨੂੰ ਮੁੜ ਚਾਲੂ ਕਰਨ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ। ਜੇਕਰ ਰੀਸਟਾਰਟ ਸਫਲ ਨਹੀਂ ਹੁੰਦਾ ਹੈ, ਤਾਂ ਮੂਲ ਕਾਰਨ ਫਿਕਸ ਦੀ ਪਛਾਣ ਕਰਨ ਲਈ Cisco TAC ਨਾਲ ਸੰਪਰਕ ਕਰੋ।

342003

  • ਗਲਤੀ ਸੁਨੇਹਾ: %ASA-3-342003: REST API ਏਜੰਟ ਅਸਫਲਤਾ ਸੂਚਨਾ ਪ੍ਰਾਪਤ ਹੋਈ। ਏਜੰਟ ਆਟੋਮੈਟਿਕਲੀ ਰੀਸਟਾਰਟ ਹੋ ਜਾਵੇਗਾ।
    • ਵਿਆਖਿਆ: REST API ਏਜੰਟ ਤੋਂ ਇੱਕ ਅਸਫਲਤਾ ਸੂਚਨਾ ਪ੍ਰਾਪਤ ਹੋਈ ਹੈ ਅਤੇ ਏਜੰਟ ਨੂੰ ਮੁੜ ਚਾਲੂ ਕਰਨ ਦੀ ਕੋਸ਼ਿਸ਼ ਕੀਤੀ ਜਾ ਰਹੀ ਹੈ।
    • ਸਿਫਾਰਸ਼ੀ ਕਾਰਵਾਈ: ਕੋਈ ਨਹੀਂ।

342004

  • ਗਲਤੀ ਸੁਨੇਹਾ: %ASA-3-342004: 5 ਅਸਫਲ ਕੋਸ਼ਿਸ਼ਾਂ ਤੋਂ ਬਾਅਦ REST API ਏਜੰਟ ਨੂੰ ਆਪਣੇ ਆਪ ਰੀਸਟਾਰਟ ਕਰਨ ਵਿੱਚ ਅਸਫਲ। ਏਜੰਟ ਨੂੰ ਹੱਥੀਂ ਰੀਸਟਾਰਟ ਕਰਨ ਲਈ 'ਨੋ ਰੈਸਟ-ਏਪੀਆਈ ਏਜੰਟ' ਅਤੇ 'ਰੈਸਟ-ਏਪੀਆਈ ਏਜੰਟ' ਕਮਾਂਡਾਂ ਦੀ ਵਰਤੋਂ ਕਰੋ।
    • ਵਿਆਖਿਆ: REST API ਏਜੰਟ ਕਈ ਕੋਸ਼ਿਸ਼ਾਂ ਤੋਂ ਬਾਅਦ ਸ਼ੁਰੂ ਕਰਨ ਵਿੱਚ ਅਸਫਲ ਰਿਹਾ ਹੈ।
    • ਸਿਫਾਰਸ਼ੀ ਕਾਰਵਾਈ: ਅਸਫਲਤਾ ਦੇ ਕਾਰਨ ਨੂੰ ਬਿਹਤਰ ਢੰਗ ਨਾਲ ਸਮਝਣ ਲਈ syslog %ASA-3-342002 (ਜੇਕਰ ਲਾਗ ਕੀਤਾ ਹੋਇਆ ਹੈ) ਵੇਖੋ। No rest-api ਏਜੰਟ ਕਮਾਂਡ ਦਾਖਲ ਕਰਕੇ REST API ਏਜੰਟ ਨੂੰ ਅਯੋਗ ਕਰਨ ਦੀ ਕੋਸ਼ਿਸ਼ ਕਰੋ ਅਤੇ rest-api ਏਜੰਟ ਕਮਾਂਡ ਦੀ ਵਰਤੋਂ ਕਰਕੇ REST API ਏਜੰਟ ਨੂੰ ਮੁੜ-ਯੋਗ ਕਰੋ।

ਸੰਬੰਧਿਤ ਦਸਤਾਵੇਜ਼

ASA, ਅਤੇ ਇਸਦੀ ਸੰਰਚਨਾ ਅਤੇ ਪ੍ਰਬੰਧਨ ਬਾਰੇ ਹੋਰ ਜਾਣਕਾਰੀ ਲੱਭਣ ਲਈ ਹੇਠਾਂ ਦਿੱਤੇ ਲਿੰਕ ਦੀ ਵਰਤੋਂ ਕਰੋ:

ਇਸ ਦਸਤਾਵੇਜ਼ ਨੂੰ "ਸੰਬੰਧਿਤ ਦਸਤਾਵੇਜ਼" ਸੈਕਸ਼ਨ ਤੋਂ ਉਪਲਬਧ ਦਸਤਾਵੇਜ਼ਾਂ ਦੇ ਨਾਲ ਜੋੜ ਕੇ ਵਰਤਿਆ ਜਾਣਾ ਹੈ।
Cisco ਅਤੇ Cisco ਲੋਗੋ ਅਮਰੀਕਾ ਅਤੇ ਹੋਰ ਦੇਸ਼ਾਂ ਵਿੱਚ Cisco ਅਤੇ/ਜਾਂ ਇਸਦੇ ਸਹਿਯੋਗੀਆਂ ਦੇ ਟ੍ਰੇਡਮਾਰਕ ਜਾਂ ਰਜਿਸਟਰਡ ਟ੍ਰੇਡਮਾਰਕ ਹਨ। ਨੂੰ view ਸਿਸਕੋ ਟ੍ਰੇਡਮਾਰਕ ਦੀ ਸੂਚੀ, ਇਸ 'ਤੇ ਜਾਓ URL: www.cisco.com/go/trademark. ਜ਼ਿਕਰ ਕੀਤੇ ਗਏ ਤੀਜੀ-ਧਿਰ ਦੇ ਟ੍ਰੇਡਮਾਰਕ ਉਹਨਾਂ ਦੇ ਸਬੰਧਤ ਮਾਲਕਾਂ ਦੀ ਸੰਪਤੀ ਹਨ। ਪਾਰਟਨਰ ਸ਼ਬਦ ਦੀ ਵਰਤੋਂ ਸਿਸਕੋ ਅਤੇ ਕਿਸੇ ਹੋਰ ਕੰਪਨੀ ਵਿਚਕਾਰ ਭਾਈਵਾਲੀ ਸਬੰਧਾਂ ਨੂੰ ਦਰਸਾਉਂਦੀ ਨਹੀਂ ਹੈ। (1721R)
ਇਸ ਦਸਤਾਵੇਜ਼ ਵਿੱਚ ਵਰਤੇ ਗਏ ਕੋਈ ਵੀ ਇੰਟਰਨੈਟ ਪ੍ਰੋਟੋਕੋਲ (IP) ਪਤੇ ਅਤੇ ਫ਼ੋਨ ਨੰਬਰ ਅਸਲ ਪਤੇ ਅਤੇ ਫ਼ੋਨ ਨੰਬਰ ਹੋਣ ਦਾ ਇਰਾਦਾ ਨਹੀਂ ਹਨ। ਕੋਈ ਵੀ ਸਾਬਕਾamples, ਕਮਾਂਡ ਡਿਸਪਲੇ ਆਉਟਪੁੱਟ, ਨੈਟਵਰਕ ਟੌਪੋਲੋਜੀ ਡਾਇਗ੍ਰਾਮ, ਅਤੇ ਦਸਤਾਵੇਜ਼ ਵਿੱਚ ਸ਼ਾਮਲ ਹੋਰ ਅੰਕੜੇ ਸਿਰਫ ਵਿਆਖਿਆ ਦੇ ਉਦੇਸ਼ਾਂ ਲਈ ਦਿਖਾਏ ਗਏ ਹਨ।
ਵਿਆਖਿਆਤਮਕ ਸਮੱਗਰੀ ਵਿੱਚ ਅਸਲ IP ਪਤਿਆਂ ਜਾਂ ਫ਼ੋਨ ਨੰਬਰਾਂ ਦੀ ਕੋਈ ਵੀ ਵਰਤੋਂ ਅਣਜਾਣੇ ਅਤੇ ਇਤਫ਼ਾਕ ਹੈ।

Cisco Systems, Inc.

© 2014-2018 Cisco Systems, Inc. ਸਾਰੇ ਅਧਿਕਾਰ ਰਾਖਵੇਂ ਹਨ।

ਦਸਤਾਵੇਜ਼ / ਸਰੋਤ

CISCO ASA REST API ਐਪ [pdf] ਯੂਜ਼ਰ ਗਾਈਡ
ASA REST API ਐਪ, ASA, REST API ਐਪ, API ਐਪ, ਐਪ

ਹਵਾਲੇ

ਇੱਕ ਟਿੱਪਣੀ ਛੱਡੋ

ਤੁਹਾਡਾ ਈਮੇਲ ਪਤਾ ਪ੍ਰਕਾਸ਼ਿਤ ਨਹੀਂ ਕੀਤਾ ਜਾਵੇਗਾ। ਲੋੜੀਂਦੇ ਖੇਤਰਾਂ ਨੂੰ ਚਿੰਨ੍ਹਿਤ ਕੀਤਾ ਗਿਆ ਹੈ *