使用网格管理 API
您可以使用网格管理 REST API 执行系统管理任务,而不是使用网格管理器用户界面。例如,您可能希望使用 API 来自动执行操作或更快地创建多个实体,例如用户。
顶级资源
网格管理 API 可提供以下顶级资源:
-
` / 网格` :仅限网格管理器用户访问,且访问权限取决于配置的组权限。
-
` /Org` :仅限属于租户帐户的本地或联合 LDAP 组的用户访问。有关详细信息,请参见 使用租户帐户。
-
` / 私有` :仅限 Grid Manager 用户访问,并且访问权限取决于配置的组权限。专用 API 如有更改,恕不另行通知。StorageGRID 私有端点也会忽略此请求的 API 版本。
问题描述 API 请求
网格管理 API 使用 Swagger 开源 API 平台。Swagger 提供了一个直观的用户界面,使开发人员和非开发人员能够使用 API 在 StorageGRID 中执行实时操作。
Swagger 用户界面提供了每个 API 操作的完整详细信息和文档。
-
您将使用登录到网格管理器 支持的 Web 浏览器。
-
您具有特定的访问权限。
使用 API 文档网页执行的任何 API 操作均为实时操作。请注意,不要错误地创建,更新或删除配置数据或其他数据。 |
-
从网格管理器标题中,选择帮助图标并选择 * API Documentation" 。
-
要使用专用 API 执行操作,请在 StorageGRID 管理 API 页面上选择 * 转至专用 API 文档 * 。
专用 API 如有更改,恕不另行通知。StorageGRID 私有端点也会忽略此请求的 API 版本。
-
选择所需的操作。
展开 API 操作时,您可以看到可用的 HTTP 操作,例如 GET , PUT , UPDATE 和 DELETE 。
-
选择 HTTP 操作可查看请求详细信息,包括端点 URL ,任何必需或可选参数的列表,请求正文示例(如果需要)以及可能的响应。
-
确定此请求是否需要其他参数,例如组或用户 ID 。然后,获取这些值。您可能需要先对其他 API 请求进行问题描述 处理,以获取所需的信息。
-
确定是否需要修改示例请求正文。如果是,您可以选择 * 型号 * 来了解每个字段的要求。
-
选择 * 试用 * 。
-
提供所需的任何参数,或根据需要修改请求正文。
-
选择 * 执行 * 。
-
查看响应代码以确定请求是否成功。