2.6. 使用 Data Grid 集群
监控并在 Data Grid 集群上执行管理任务。
2.6.1. 停止 Data Grid 集群 复制链接链接已复制到粘贴板!
使用 POST 请求关闭整个 Data Grid 集群。
POST /rest/v2/cluster?action=stop
POST /rest/v2/cluster?action=stop
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}
POST /rest/v2/cluster?action=stop&server={server1_host}&server={server2_host}
Data Grid 用 204 (非内容) 响应。
2.6.3. 备份 Data Grid 集群 复制链接链接已复制到粘贴板!
创建备份存档、应用程序/zip,其中包含当前存储在集群的缓存容器中的资源(缓存、模板、计数器、Protobuf 模式、服务器任务等)。
POST /rest/v2/cluster/backups/{backupName}
POST /rest/v2/cluster/backups/{backupName}
(可选)包含包含备份操作参数的 JSON 有效负载,如下所示:
| 键 | 必需/可选 | 值 |
|---|---|---|
|
| 可选 | 指定服务器上用于创建和存储备份存档的位置。 |
如果备份操作成功完成,服务会返回 202 (接受)。如果存在具有相同名称的备份,服务会返回 409 (Conflict)。如果 directory 参数无效,则服务会返回 400 (Bad Request)。
2.6.4. 列出备份 复制链接链接已复制到粘贴板!
检索正在进行、完成或失败的所有备份操作的名称。
GET /rest/v2/cluster/backups
GET /rest/v2/cluster/backups
Data Grid 使用所有备份名称的数组响应,如下例所示:
["backup1", "backup2"]
["backup1", "backup2"]
2.6.5. 检查备份可用性 复制链接链接已复制到粘贴板!
验证备份操作已完成。200 响应表示备份存档可用。202 响应表示备份操作正在进行中。
HEAD /rest/v2/cluster/backups/{backupName}
HEAD /rest/v2/cluster/backups/{backupName}
2.6.6. 下载备份归档 复制链接链接已复制到粘贴板!
从服务器下载备份存档。200 响应表示备份存档可用。202 响应表示备份操作正在进行中。
GET /rest/v2/cluster/backups/{backupName}
GET /rest/v2/cluster/backups/{backupName}
2.6.7. 删除备份归档 复制链接链接已复制到粘贴板!
从服务器中删除备份存档。204 响应表示备份存档已被删除。202 响应表示备份操作正在进行,但会在操作完成后删除。
DELETE /rest/v2/cluster/backups/{backupName}
DELETE /rest/v2/cluster/backups/{backupName}
2.6.8. 恢复 Data Grid 集群资源 复制链接链接已复制到粘贴板!
在备份存档中应用资源来恢复数据网格集群。提供的 {restoreName} 用于跟踪恢复进度,它独立于正在恢复的备份文件的名称。
只有在备份存档中的容器名称与集群的容器名称匹配时,才能恢复资源。
POST /rest/v2/cluster/restores/{restoreName}
POST /rest/v2/cluster/restores/{restoreName}
202 响应表示接受恢复请求进行处理。
2.6.8.1. 在 Data Grid Server 上从备份归档中恢复 复制链接链接已复制到粘贴板!
将 application/json 内容类型与您的 POST 请求一起使用,以从服务器上可用的存档进行备份。
| 键 | 必需/可选 | 值 |
|---|---|---|
|
| 必需 | 指定要恢复的备份存档的路径。 |
|
| 可选 | 以 JSON 格式指定要恢复的资源。默认为恢复所有资源。如果您指定了一个或多个资源,则 Data Grid 仅恢复这些资源。如需更多信息 ,请参阅 资源参数表。 |
| 键 | 必需/可选 | 值 |
|---|---|---|
|
| 可选 |
指定所有缓存要备份的缓存名称的数组, |
|
| 可选 |
指定用于备份所有模板的缓存模板数组,或指定 |
|
| 可选 |
为所有计数器定义要备份的计数器名称数组,或定义 X。 |
|
| 可选 |
为所有模式定义要备份的 Protobuf 模式名称的数组,或定义 |
|
| 可选 |
指定要备份的服务器任务数组,或为所有任务指定 |
以下示例从服务器的备份存档中恢复所有计数器:
2.6.8.2. 从本地备份归档中恢复 复制链接链接已复制到粘贴板!
将 multipart/form-data 内容类型与您的 POST 请求一起使用,将本地备份存档上传到服务器。
| 参数 | Content-Type | 必需/可选 | 值 |
|---|---|---|---|
|
|
| 必需 | 指定要恢复的备份存档的字节数。 |
请求示例
2.6.9. 列出恢复 复制链接链接已复制到粘贴板!
检索所有正在进行、完成或失败的恢复请求的名称。
GET /rest/v2/cluster/restores
GET /rest/v2/cluster/restores
Data Grid 使用所有恢复名称的数组响应,如下例所示:
["restore1", "restore2"]
["restore1", "restore2"]
2.6.10. 检查恢复正在进行 复制链接链接已复制到粘贴板!
验证恢复操作已完成。
HEAD /rest/v2/cluster/restores/{restoreName}
HEAD /rest/v2/cluster/restores/{restoreName}
201 (Created) 响应表示恢复操作已完成。202 响应表示备份操作正在进行中。
2.6.11. 删除恢复元数据 复制链接链接已复制到粘贴板!
删除从服务器恢复请求的元数据。此操作会删除与恢复请求关联的所有元数据,但不删除任何恢复的内容。如果删除请求元数据,您可以使用请求名称来执行后续的恢复操作。
DELETE /rest/v2/cluster/restores/{restoreName}
DELETE /rest/v2/cluster/restores/{restoreName}
204 响应表示恢复元数据已被删除。202 响应表示恢复操作正在进行中,并在操作完成后删除。