Re: Automated Software Distribution API v4.0の利用について

y-miyata01 · ‎2021-07-06

Cisco Support APIのAutomated Software Distribution API v4.0を利用しております。
https://developer.cisco.com/docs/support-apis/#!automated-software-distribution/features

上記APIのRequestで使用するPIDやVersionのフォーマットについて、リストや参照できるものなどが
あるかご存じの方いましたら教えていただけないでしょうか。

(詳細)
このAPIではPIDとカレントバージョン情報をRequestでPOSTすることにより
リリースされているソフトウェアの情報を得られます。

実際に様々な機器で試しているのですが、いくつかの機器でPIDやバージョンの
フォーマットが分からず簡単に利用するのが難しい状況です。

例えば、FPR2Kはshow inventoryで取得できるPID「FPR-2130」で取得できましたが、
FPR4kでは「FPR-4115-K9」で取得できません。
色々試した結果「FPR-4115-K9=」で取得できました。

他にも、「C9200-24P」はVersion「17.1.1」で取得できますが、
同じIOS-XEのC9800-40-K9では「Amsterdam-17.3.1」のようにしなければ取得できませんでした。

このようにどのような表記でPID,Versionを入力しなければならないか
調べるのが手間で中々簡単に利用するといったことが難しい状況です。

Tohru Ohzono · ‎2021-07-07

こんにちは。

該当のAPIとしてはデータベース内の情報を検索してレスポンスを生成しているので、
APIとしてのPIDやバージョンのフォーマットは定義されていません。

シリアル番号が分かる場合に限定されますが、シリアル番号からPID等の情報を取得するAPIがあります。
こちらのAPIは既に試されたりしていますか？
https://developer.cisco.com/docs/support-apis/#!product-information

バージョン番号に関しては、製品ごとにフォーマットが異なったりしているので、
個別に調べたりするしかないとは思います。

もうちょっと調査はしてみるので、何か有益な情報があれば、共有します。

y-miyata01 · ‎2021-07-07

返信いただきありがとうございます。

シリアルから情報を取得するAPIを試してみましたが、取得出来た情報は以下となりました。

===========================

{

"base_pid": "FPR4115-ASA-K9"

}

===========================

こちらでAutomated Software DistributionのAPIを実行しましたが、

"code": "NO_DATA_FOUND_FOR_THE_PID"となり、情報取得ができませんでした。

私も引き続き調査しますので、何か進展がありましたら共有させてもらいます。

Tohru Ohzono · ‎2021-07-07

こんにちは。

PIDに関してですが、調査しました。
"="付きかどうかに関しては、製品としては同じ(base_pidは同じ)となりますが、今回ご利用のAPI上は明確に区別されます。

また発注上の違いがあり、発注時のPIDを指定してAPIに渡す必要がありそうです。

ちょっと古い記事になりますが、Ciscoのコミュニティの日本語記事では、以下に"="ありなしの違いの記載があります。
https://community.cisco.com/t5/-/-/ta-p/3112987

また、「cisco 型番イコール」などで検索エンジンで検索しても記事が出てくると思います。

バージョンに関しては、やはり製品ごとに特徴などがあり、個別に調査するしかないと思います。

y-miyata01 · ‎2021-07-08

ご確認いただきありがとうございます。

ソフトウェア情報を取得するAPIは発注時の機器に対する情報を取得している

わけではないので、発注時のPIDを指定するものではないと思っています。

また今回シリアルから得られたbase_pidはFPR4115-ASA-K9で、

ソフトウェア情報取得に必要なPIDはFPR-4115-K9=であったことから、

そもそも異なるデータベースを参照しているものと思われます。

（発注は前者の方で行っているようです)

恐らくバージョンと同じで個別に調査するしかないというところが

わかったというところでも大きな収穫です。

大変ありがとうございました。