LoginSignup
12
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Day 24

Cisco Systems Japan Advent Calendar 2025

@hiro-imamu

Cisco Support APIsを使ってみる（2025年版）

Posted at

はじめに

この記事はシスコの有志による Cisco Systems Japan Advent Calendar 2025 （2枚目） の 24日目として投稿しています。

2017年版: https://qiita.com/advent-calendar/2017/cisco
2018年版: https://qiita.com/advent-calendar/2018/cisco
2019年版: https://qiita.com/advent-calendar/2019/cisco
2020年版: https://qiita.com/advent-calendar/2020/cisco
2020年版(2枚目): https://qiita.com/advent-calendar/2020/cisco2
2021年版: https://qiita.com/advent-calendar/2021/cisco
2021年版(2枚目): https://qiita.com/advent-calendar/2021/cisco2
2022年版: https://qiita.com/advent-calendar/2022/cisco
2023年版: https://qiita.com/advent-calendar/2023/cisco
2024年版: https://qiita.com/advent-calendar/2024/cisco
2025年版: https://qiita.com/advent-calendar/2025/cisco <--ここ

Cisco Support APIsとは？

Cisco Support APIsは以下のようなサポート契約のあるパートナーおよびユーザが利用可能なAPIとなります。

  • Smart Net Total Care (SNTC) customer
  • Partner Support Services (PSS) partner

APIを利用することにより以下のような情報をAPI経由で取得することが可能です。

なお、2025/12/24時点での情報となりますので、利用可能な最新のAPIについてはCisco Support APIsのWebページをご参照ください。

API 概要
Automated Software Distribution 指定されたソフトウェアリリースにアップグレードする際に​役立つソフトウェア情報とダウンロードURLを提供​
Bug ソフトウェア不具合情報に Bug IDでアクセスしたり、キーワード、影響を受けるソフトウェアリリース、または修正済みのソフトウェアリリースで​フィルタリングされたPIDに関連するバグのリストにアクセス
Case ネットワーク管理の一部としてサポートケースを追跡​
EoX ハードウェアとソフトウェアの両方のサポート終了情報を取得​
Product Info 寸法、重量などを含む製品情報をシリアル番号またはPIDで取得​
Service Order RMA情報へのリアルタイムアクセス取得​
Serial Number to Information ネットワーク内のデバイスの製品IDとカバレッジステータスをプログラムで検索​
Software Suggestion 安定性、耐用年数、採用率などの要素に基づいて、推奨するソフトウェアを参照​

今回はCisco Support APIを利用して、EoXの情報を取得してみたいと思います。

使い方（アカウントセットアップ）

Cisco Support APIsは以下のサポート契約のあるパートナーおよびユーザのみが利用可能です。

  • Smart Net Total Care (SNTC) customer
  • Partner Support Services (PSS) partner
  1. API権限付与
    1. 以下のWebを参考に、ご自身のCisco.comアカウントへAPI利用権限の付与を実施
      https://developer.cisco.com/docs/support-apis/user-onboarding-process/#api-user-account-types
  2. Cisco API ConsoleへCisco.comアカウントを利用してログイン
  3. My Apps & Keysタブをクリック
  4. Register an Applicationでアプリケーション名など必要事項を記入

登録が完了すると、API利用に必要なKEYとCLIENT SECRETが発行されます

使い方（bruno）

今回はBrunoというAPI Clientを利用して、APIの動作を確認します。

犬のアイコンがとても可愛いですね。

  1. アカウントセットアップにて発行されたKEYとCLIENT SECRETを利用してAccess Tokenを取得します
    client_idにKEYを、client_secretにCLIENT SECRETをValueとして与えます
    image.png
    正常にRequestが発行できると、200 OKとともにaccess_tokenが払い出されます
  2. access_tokenを利用し、APIを実行
    例）WIC-1ENETというインタフェースモジュールのEoX情報を取得したい場合
    image.png
    1. AuthタブのTokenに先ほど払い出されたaccess_tokenを入力
    2. URIの中でEoX情報を取得したいProduct ID（上の例ではWIC-1T=)を指定
  3. 以下のような出力結果が得られます
{
  "PaginationResponseRecord": {
    "PageIndex": 1,
    "LastIndex": 1,
    "TotalRecords": 1,
    "PageRecords": 1
  },
  "EOXRecord": [
    {
      "EOLProductID": "WIC-1ENET",
      "ProductIDDescription": "Single-Port Ethernet WAN Interface Card",
      "ProductBulletinNumber": "EOL6913",
      "LinkToProductBulletinURL": "http://www.cisco.com/en/US/prod/collateral/modules/ps2797/end_of_life_c51-572422.html",
      "EOXExternalAnnouncementDate": {
        "value": "2009-12-02",
        "dateFormat": "YYYY-MM-DD"
      },
      "EndOfSaleDate": {
        "value": "2010-06-02",
        "dateFormat": "YYYY-MM-DD"
      },
      "EndOfSWMaintenanceReleases": {
        "value": "",
        "dateFormat": "YYYY-MM-DD"
      },
      "EndOfSecurityVulSupportDate": {
        "value": "",
        "dateFormat": "YYYY-MM-DD"
      },
      "EndOfRoutineFailureAnalysisDate": {
        "value": "2011-06-02",
        "dateFormat": "YYYY-MM-DD"
      },
      "EndOfServiceContractRenewal": {
        "value": "2014-08-28",
        "dateFormat": "YYYY-MM-DD"
      },
      "LastDateOfSupport": {
        "value": "2015-06-01",
        "dateFormat": "YYYY-MM-DD"
      },
      "EndOfSvcAttachDate": {
        "value": "2011-06-02",
        "dateFormat": "YYYY-MM-DD"
      },
      "UpdatedTimeStamp": {
        "value": "2012-04-03",
        "dateFormat": "YYYY-MM-DD"
      },
      "EOXMigrationDetails": {
        "PIDActiveFlag": "Y",
        "MigrationInformation": "",
        "MigrationOption": "See Migration Section",
        "MigrationProductId": "",
        "MigrationProductName": "",
        "MigrationStrategy": "Customers are encouraged to migrate to the Cisco Ethernet WAN modules available on Cisco Integrated Services Routers.  Information about these products can be found at: http://www.cisco.com/en/US/prod/collateral/routers/ps10536/data_sheet_c78-553980.html; http://www.cisco.com/en/US/prod/collateral/routers/ps5854/product_data_sheet0900aecd80581fe6_ps5855_Products_Data_Sheet.html; and http://www.cisco.com/en/US/prod/collateral/routers/ps5854/product_data_sheet0900aecd8016be8d.html.",
        "MigrationProductInfoURL": "http://www.cisco.com/en/US/products/ps10536/index.html"
      },
      "EOXInputType": "ShowEOXByPids",
      "EOXInputValue": "WIC-1ENET "
    }
  ]
}

Cisco.comにWeb掲載されている内容と同一内容がAPIを経由して取得できていますね。
End-of-Sale and End-of-Life Announcement for the Cisco 1-Port Ethernet WAN Interface Card

おわりに

Cisco Support APIsを利用することで、EoXの情報をJSON形式で入手することが可能となります。

システムで処理しやすいフォーマットで情報が入手できますので、例えばネットワーク機器の資産管理データベースと連携することによって、効率的に資産のEoX管理を行うことができそうです。

参考資料

免責事項

本サイトおよび対応するコメントにおいて表明される意見は、投稿者本人の個人的意見であり、シスコの意見ではありません。本サイトの内容は、情報の提供のみを目的として掲載されており、シスコや他の関係者による推奨や表明を目的としたものではありません。各利用者は、本Webサイトへの掲載により、投稿、リンクその他の方法でアップロードした全ての情報の内容に対して全責任を負い、本Web サイトの利用に関するあらゆる責任からシスコを免責することに同意したものとします。

12
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
12
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?