日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

Active IQ Unified Manager での REST API へのアクセスおよび認証

寄稿者

Active IQ Unified Manager REST API には、問題 HTTP 要求を実行できる任意の Web ブラウザまたはプログラミングプラットフォームを使用してアクセスできます。Unified Manager は、基本的な HTTP 認証メカニズムをサポートしています。Unified Manager REST API を呼び出す前に、ユーザを認証する必要があります。

REST アクセス

問題 HTTP 要求を使用して Unified Manager REST API にアクセスできる Web ブラウザまたはプログラミングプラットフォームを使用できます。たとえば、 Unified Manager にログインしたあと、任意のブラウザで URL を入力して、管理ステーション名、キー、 IP アドレスなど、すべての管理ステーションの属性を取得できます。

  • * リクエスト *

    取得

https://<IP address/hostname>:<port_number>/api/v2/datacenter/cluster/clusters
  • * 応答 *

    {
      "records": [
        {
          "key": "4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster,uuid=4c6bf721-2e3f-11e9-a3e2-00a0985badbb",
          "name": "fas8040-206-21",
          "uuid": "4c6bf721-2e3f-11e9-a3e2-00a0985badbb",
          "contact": null,
          "location": null,
          "version": {
            "full": "NetApp Release Dayblazer__9.5.0: Thu Jan 17 10:28:33 UTC 2019",
            "generation": 9,
            "major": 5,
            "minor": 0
          },
          "isSanOptimized": false,
          "management_ip": "10.226.207.25",
          "nodes": [
            {
              "key": "4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster_node,uuid=12cf06cc-2e3a-11e9-b9b4-00a0985badbb",
              "uuid": "12cf06cc-2e3a-11e9-b9b4-00a0985badbb",
              "name": "fas8040-206-21-01",
              "_links": {
                "self": {
                  "href": "/api/datacenter/cluster/nodes/4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster_node,uuid=12cf06cc-2e3a-11e9-b9b4-00a0985badbb"
                }
              },
              "location": null,
              "version": {
                "full": "NetApp Release Dayblazer__9.5.0: Thu Jan 17 10:28:33 UTC 2019",
                "generation": 9,
                "major": 5,
                "minor": 0
              },
              "model": "FAS8040",
              "uptime": 13924095,
              "serial_number": "701424000157"
            },
            {
              "key": "4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster_node,uuid=1ed606ed-2e3a-11e9-a270-00a0985bb9b7",
              "uuid": "1ed606ed-2e3a-11e9-a270-00a0985bb9b7",
              "name": "fas8040-206-21-02",
              "_links": {
                "self": {
                  "href": "/api/datacenter/cluster/nodes/4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster_node,uuid=1ed606ed-2e3a-11e9-a270-00a0985bb9b7"
                }
              },
              "location": null,
              "version": {
                "full": "NetApp Release Dayblazer__9.5.0: Thu Jan 17 10:28:33 UTC 2019",
                "generation": 9,
                "major": 5,
                "minor": 0
              },
              "model": "FAS8040",
              "uptime": 14012386,
              "serial_number": "701424000564"
            }
          ],
          "_links": {
            "self": {
              "href": "/api/datacenter/cluster/clusters/4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster,uuid=4c6bf721-2e3f-11e9-a3e2-00a0985badbb"
            }
          }
        },
    • ip address/hostname は API サーバの IP アドレスまたは完全修飾ドメイン名 (FQDN) です。

    • ポート 443

      443 は、デフォルトの HTTPS ポートです。必要に応じて、 HTTPS ポートをカスタマイズできます。

    Web ブラウザから問題 POST 、 PATCH 、および DELETE の各 HTTP 要求を実行するには、ブラウザのプラグインを使用する必要があります。cURL や Perl などのスクリプトプラットフォームを使用して、 REST API にアクセスすることもできます。

認証

Unified Manager では、 API の基本的な HTTP 認証方式がサポートされます。情報の流れ(要求と応答)をセキュリティで保護するために、 REST API には HTTPS 経由でのみアクセスできます。API サーバは、サーバ検証のためにすべてのクライアントに自己署名 SSL 証明書を提供します。この証明書は、カスタム証明書(または CA 証明書)で置き換えることができます。

REST API を呼び出すには、 API サーバへのユーザアクセスを設定する必要があります。ユーザには、ローカルユーザ(ローカルデータベースに格納されているユーザプロファイル)または LDAP ユーザ( LDAP 経由で認証するように API サーバを設定している場合)を指定できます。Unified Manager Administration Console のユーザインターフェイスにログインして、ユーザアクセスを管理できます。