如何使用Java测试IBM Systems Director的REST API

Question

如题所述

Answer 1

1.手动（使用工具）：使用一些外部 REST 客户端，如 Firefox Poster、http4e 等，并手动调用 REST API。我们在本教程中使用了 Poster。您可以使用自己喜欢的 REST 客户端。

2.自动：使用编程语言或脚本自动调用 REST API。本教程将介绍使用 Java 进行自动测试。您可以使用自己喜欢的任何其他语言或脚本。

这两个方法的说明如下：

1.手动（使用 Poster）：

在本节中，我们将讨论使用 Poster 手动测试一些 IBM Systems Director 的基本功能：

1.获得资源列表（GET 操作）

2.发现新资源 （POST 操作）

3.修改已发现的资源（PUT 操作）

4.删除资源（DELETE 操作）

1.获得资源列表（GET 操作）：

如图 1 所示，您使用 GET 操作可以列出资源。GET 检索有关该资源的信息。检索资源的请求如图 1 所示：

图 1. 使用 Poster 的 GET 操作 

在图 1 中，您作为用户可以看到以下信息：

1.URL: 检索有关服务器信息的 URI。

2.Actions: 选定的操作是 GET。 

3.Header 部分：用户需要在这部分中输入以下内容：

ISDAPIVersion: IBM Systems Director 的版本。

Authorization: 这是一个 base64 转换的用户 ID 和密码，用于 IBM Systems Director。 

Accept: 可接受的内容类型

响应如图 2 所示：

图 2. GET 操作的响应

在图 2 中，您可以看到 IBM Systems Director 对 GET 请求的响应。响应包括一个返回代码和响应正文。图 2 中的返加代码是 200 
(OK)，而响应正文是 IBM Systems Director 所返回的所有资源的列表。

发现资源（POST 操作）

发现是 IBM Systems Director 的一个非常基本的操作，用于发现资源。您需要使用 POST 方法进行发现，因此，您需要提供 HTTP 正文 
(JSON) 与 HTTP 头。发现的 HTTP 正文如下：

清单 1. 输入 POST 发现操作的 JSON

{
"IPAddress": ["9.1.2.3"],
"ResourceTypes": ["Server", "OperatingSystem"]
}

您需要提供资源的 IP 地址和资源类型。使用 POST 操作可以发现新源，如图 3 所示。

图 3. POST 操作发现资源

在图 4 的 HTTP 响应中要注意一些重要事项：

使用 Location URI 的 GET 操作的响应如图 5 所示。

图 5. 使用 Location URI 的 GET 操作的响应

返回代码：对于 POST 请求是 201

Location: POST 操作是异步操作，它包括返回的位置。位置是一个 URL，它可以用于检查使用 GET 操作的作业状态，如图 1 
所示。

在 HttpResponse 中，如图 5 所示，您可以看见以下值：

URI: 它是之前 POST 操作的 "Location"。

Percent Complete: 它以百分比显示任务的完成状态。在图 5 中它是 100%，意味着任务已经完成。

DiscoveryStatus: 该字段显示作业的状态，即，它是否成功。在图 5 中，它的值是 
"Ok"，这意味着作业已成功完成。

修改资源（PUT 操作）：

要修改一个现有资源，您需要使用 PUT 操作。对于 PUT 操作，您需要传递 HTTP 正文和 HTTP 头。用于修改资源的 HTTP 正文如下：

清单 2. 清单 2. 输入 PUT 修改资源操作的 JSON

{
"Properties": {"DisplayName" : "NewName"}
}

您可以使用 PUT 操作来修改资源，如图 6 所示。

图 6. PUT 操作来修改资源