2.6. 使用 Data Grid 集群


监控并在 Data Grid 集群上执行管理任务。

2.6.1. 停止 Data Grid 集群

使用 POST 请求关闭整个 Data Grid 集群。

POST /rest/v2/cluster?action=stop
Copy to Clipboard Toggle word wrap

Data Grid 使用 204 (不内容) 响应,然后执行整个集群的有序关闭。

2.6.2. 在集群中停止特定 Data Grid 服务器

使用 GET 请求和 ?action=stop&server 参数关闭 Data Grid 集群中的一个或多个特定服务器。

POST /rest/v2/cluster?action=stop&server={server1_host}&server={server2_host}
Copy to Clipboard Toggle word wrap

Data Grid 用 204 (非内容) 响应。

2.6.3. 备份 Data Grid 集群

创建备份存档、应用程序/zip,其中包含当前存储在集群的缓存容器中的资源(缓存、模板、计数器、Protobuf 模式、服务器任务等)。

POST /rest/v2/cluster/backups/{backupName}
Copy to Clipboard Toggle word wrap

(可选)包含包含备份操作参数的 JSON 有效负载,如下所示:

Expand
表 2.22. JSON 参数
必需/可选

目录

可选

指定服务器上用于创建和存储备份存档的位置。

如果备份操作成功完成,服务会返回 202 (接受)。如果存在具有相同名称的备份,服务会返回 409 (Conflict)。如果 directory 参数无效,则服务会返回 400 (Bad Request)

2.6.4. 列出备份

检索正在进行、完成或失败的所有备份操作的名称。

GET /rest/v2/cluster/backups
Copy to Clipboard Toggle word wrap

Data Grid 使用所有备份名称的数组响应,如下例所示:

["backup1", "backup2"]
Copy to Clipboard Toggle word wrap

2.6.5. 检查备份可用性

验证备份操作已完成。200 响应表示备份存档可用。202 响应表示备份操作正在进行中。

HEAD /rest/v2/cluster/backups/{backupName}
Copy to Clipboard Toggle word wrap

2.6.6. 下载备份归档

从服务器下载备份存档。200 响应表示备份存档可用。202 响应表示备份操作正在进行中。

GET /rest/v2/cluster/backups/{backupName}
Copy to Clipboard Toggle word wrap

2.6.7. 删除备份归档

从服务器中删除备份存档。204 响应表示备份存档已被删除。202 响应表示备份操作正在进行,但会在操作完成后删除。

DELETE /rest/v2/cluster/backups/{backupName}
Copy to Clipboard Toggle word wrap

2.6.8. 恢复 Data Grid 集群资源

在备份存档中应用资源来恢复数据网格集群。提供的 {restoreName} 用于跟踪恢复进度,它独立于正在恢复的备份文件的名称。

重要

只有在备份存档中的容器名称与集群的容器名称匹配时,才能恢复资源。

POST /rest/v2/cluster/restores/{restoreName}
Copy to Clipboard Toggle word wrap

202 响应表示接受恢复请求进行处理。

2.6.8.1. 在 Data Grid Server 上从备份归档中恢复

application/json 内容类型与您的 POST 请求一起使用,以从服务器上可用的存档进行备份。

Expand
表 2.23. JSON 参数
必需/可选

位置

必需

指定要恢复的备份存档的路径。

资源

可选

以 JSON 格式指定要恢复的资源。默认为恢复所有资源。如果您指定了一个或多个资源,则 Data Grid 仅恢复这些资源。如需更多信息 ,请参阅 资源参数表。

Expand
表 2.24. 资源参数
必需/可选

缓存

可选

指定所有缓存要备份的缓存名称的数组,或指定 为所有缓存。

cache-configs

可选

指定用于备份所有模板的缓存模板数组,或指定 * 用于所有模板。

计数器

可选

为所有计数器定义要备份的计数器名称数组,或定义 X。

proto-schemas

可选

为所有模式定义要备份的 Protobuf 模式名称的数组,或定义 *

tasks

可选

指定要备份的服务器任务数组,或为所有任务指定 *

以下示例从服务器的备份存档中恢复所有计数器:

{
  "location": "/some/path/accessible/to/the/server/backup-to-restore.zip",
  "resources": {
    "counters": ["*"]
  }
}
Copy to Clipboard Toggle word wrap

2.6.8.2. 从本地备份归档中恢复

multipart/form-data 内容类型与您的 POST 请求一起使用,将本地备份存档上传到服务器。

Expand
表 2.25. 表单数据
参数Content-Type必需/可选

backup

application/zip

必需

指定要恢复的备份存档的字节数。

请求示例

Content-Type: multipart/form-data; boundary=5ec9bc07-f069-4662-a535-46069afeda32
Content-Length: 7798

--5ec9bc07-f069-4662-a535-46069afeda32
Content-Disposition: form-data; name="backup"; filename="testManagerRestoreParameters.zip"
Content-Type: application/zip
Content-Length: 7353

<zip-bytes>
--5ec9bc07-f069-4662-a535-46069afeda32--
Copy to Clipboard Toggle word wrap

2.6.9. 列出恢复

检索所有正在进行、完成或失败的恢复请求的名称。

GET /rest/v2/cluster/restores
Copy to Clipboard Toggle word wrap

Data Grid 使用所有恢复名称的数组响应,如下例所示:

["restore1", "restore2"]
Copy to Clipboard Toggle word wrap

2.6.10. 检查恢复正在进行

验证恢复操作已完成。

HEAD /rest/v2/cluster/restores/{restoreName}
Copy to Clipboard Toggle word wrap

201 (Created) 响应表示恢复操作已完成。202 响应表示备份操作正在进行中。

2.6.11. 删除恢复元数据

删除从服务器恢复请求的元数据。此操作会删除与恢复请求关联的所有元数据,但不删除任何恢复的内容。如果删除请求元数据,您可以使用请求名称来执行后续的恢复操作。

DELETE /rest/v2/cluster/restores/{restoreName}
Copy to Clipboard Toggle word wrap

204 响应表示恢复元数据已被删除。202 响应表示恢复操作正在进行中,并在操作完成后删除。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat