DM 系列 Unified Manager 中的 REST API 访问和认证

REST 访问​

可以使用任何可以发出 HTTP 请求的 Web 浏览器或编程平台来访问 Unified Manager REST API。例如，登录 Unified Manager 之后，可以在任何浏览器中键入 URL 来检索所有管理站的属性，例如管理站的名称、键值和 IP 地址。

请求

GET

https://<IP address/hostname>:<port_number>/api/v2/datacenter/cluster/clusters

响应

{
    "records": [
        {
            "key": "65821433-683b-11ea-982c-00a098ddea9d:type=cluster,uuid=65821433-683b-11ea-982c-00a098ddea9d",
            "name": "DM5000_3",
            "uuid": "65821433-683b-11ea-982c-00a098ddea9d",
            "contact": null,
            "location": null,
            "version": {
                "full": "<ONTAP_release>",
                "generation": 9,
                "major": 7,
                "minor": 0
            },
            "isSanOptimized": false,
            "management_ip": "<mgmt._IP>",
            "nodes": [
                {
                    "key": "65821433-683b-11ea-982c-00a098ddea9d:type=cluster_node,uuid=50f33ca2-683a-11ea-982c-00a098ddea9d",
                    "uuid": "50f33ca2-683a-11ea-982c-00a098ddea9d",
                    "name": "DM5000_3-01",
                    "_links": {
                        "self": {
                            "href": "/api/v2/datacenter/cluster/nodes/65821433-683b-11ea-982c-00a098ddea9d:type=cluster_node,uuid=50f33ca2-683a-11ea-982c-00a098ddea9d"
                        }
                    },
                    "location": null,
                    "version": {
                        "full": "<ONTAP_release>",
                        "generation": 9,
                        "major": 7,
                        "minor": 0
                    },
                    "model": "DM5000H",
                    "uptime": 9170396,
                    "serial_number": "<node_SN>"
                },
                {
                    "key": "65821433-683b-11ea-982c-00a098ddea9d:type=cluster_node,uuid=cc35d3b1-6839-11ea-9786-00a098dde4d3",
                    "uuid": "cc35d3b1-6839-11ea-9786-00a098dde4d3",
                    "name": "DM5000_3-02",
                    "_links": {
                        "self": {
                            "href": "/api/v2/datacenter/cluster/nodes/65821433-683b-11ea-982c-00a098ddea9d:type=cluster_node,uuid=cc35d3b1-6839-11ea-9786-00a098dde4d3"
                        }
                    },
                    "location": null,
                    "version": {
                        "full": "ONTAP_release",
                        "generation": 9,
                        "major": 7,
                        "minor": 0
                    },
                    "model": "DM5000H",
                    "uptime": 8419138,
                    "serial_number": "<node_SN>"
                }
            ],
            "_links": {
                "self": {
                    "href": "/api/v2/datacenter/cluster/clusters/65821433-683b-11ea-982c-00a098ddea9d:type=cluster,uuid=65821433-683b-11ea-982c-00a098ddea9d"
                }
            }
        },
        {
            "key": "f58e263f-8e40-11ea-a0f2-00a098dbe2fe:type=cluster,uuid=f58e263f-8e40-11ea-a0f2-00a098dbe2fe",
            "name": "DM7000F_4",
            "uuid": "f58e263f-8e40-11ea-a0f2-00a098dbe2fe",
            "contact": null,
            "location": null,
            "version": {
                "full": "Data ONTAP release (Lenovo)",
                "generation": 9,
                "major": 7,
                "minor": 0
            },
            "isSanOptimized": false,
            "management_ip": "<mgmt._IP>",
            "nodes": [
                {
                    "key": "f58e263f-8e40-11ea-a0f2-00a098dbe2fe:type=cluster_node,uuid=125d784b-8e39-11ea-ae2e-00a098dbe286",
                    "uuid": "125d784b-8e39-11ea-ae2e-00a098dbe286",
                    "name": "DM7000F_4_2",
                    "_links": {
                        "self": {
                            "href": "/api/v2/datacenter/cluster/nodes/f58e263f-8e40-11ea-a0f2-00a098dbe2fe:type=cluster_node,uuid=125d784b-8e39-11ea-ae2e-00a098dbe286"
                        }
                    },
                    "location": null,
                    "version": {
                        "full": "Data ONTAP Release (Lenovo) ",
                        "generation": 9,
                        "major": 7,
                        "minor": 0
                    },
                    "model": "DM7000F",
                    "uptime": 1656823,
                    "serial_number": "<node_SN>"
                },
                {
                    "key": "f58e263f-8e40-11ea-a0f2-00a098dbe2fe:type=cluster_node,uuid=ec84a586-8e37-11ea-a0f2-00a098dbe2fe",
                    "uuid": "ec84a586-8e37-11ea-a0f2-00a098dbe2fe",
                    "name": "DM7000F_4_1",
                    "_links": {
                        "self": {
                            "href": "/api/v2/datacenter/cluster/nodes/f58e263f-8e40-11ea-a0f2-00a098dbe2fe:type=cluster_node,uuid=ec84a586-8e37-11ea-a0f2-00a098dbe2fe"
                        }
                    },
                    "location": null,
                    "version": {
                        "full": "Data ONTAP Release (Lenovo)",
                        "generation": 9,
                        "major": 7,
                        "minor": 0
                    },
                    "model": "DM7000F",
                    "uptime": 1649181,
                    "serial_number": "<node_SN>"
                }
            ],
            "_links": {
                "self": {
                    "href": "/api/v2/datacenter/cluster/clusters/f58e263f-8e40-11ea-a0f2-00a098dbe2fe:type=cluster,uuid=f58e263f-8e40-11ea-a0f2-00a098dbe2fe"
                }
            }
        }
    ],
    "num_records": 2,
    "total_records": 2,
    "_links": {
        "self": {
            "href": "/api/v2/datacenter/cluster/clusters"
        }
    }
}

• IP address/hostname 是 API 服务器的 IP 地址或标准域名（FQDN）。
• 端口 443

  默认的 HTTPS 端口是 443。如果需要，可以自定义 HTTPS 端口。

要从 Web 浏览器发出 POST、PATCH 和 DELETE HTTP 请求，必须使用浏览器插件。还可以通过使用脚本编程平台（例如 cURL 和 Perl）访问 REST API。

认证​

Unified Manager 支持 API 的基本 HTTP 认证方案。为了确保安全的信息流（请求和响应），只能通过 HTTPS 访问 REST API。API 服务器向所有客户端提供自签名 SSL 证书以进行服务器验证。可以用自定义证书（或 CA 证书）替换该证书。

必须配置用户对 API 服务器的访问权限以调用 REST API。用户可以是本地用户（用户概要文件存储在本地数据库中）或 LDAP 用户（如果已将 API 服务器配置为通过 LDAP 进行认证）。可以通过登录 Unified Manager 管理控制台用户界面来管理用户访问权限。