2.6. 使用 Data Grid 集群

2.6.1. 停止 Data Grid 集群

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

POST /rest/v2/cluster?action=stop

Data Grid 使用 204 （无内容） 响应，然后执行整个集群的有序关闭。

2.6.2. 在集群中停止特定数据网格服务器

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

POST /rest/v2/cluster?action=stop&server={server1_host}&server={server2_host}

Data Grid 使用 204 （无内容） 做出响应。

2.6.3. 备份 Data Grid 集群

创建备份存档 application/zip，其中包含当前存储在集群的缓存容器中的资源（缓存、模板、计数器、Protobuf 模式、服务器任务等）。

POST /rest/v2/cluster/backups/{backupName}

（可选）包括带有您包含备份操作的参数的 JSON 有效负载，如下所示：

表 2.27. JSON 参数
键	必需/可选	值
`目录`	OPTIONAL	指定要创建并存储备份存档的服务器上的位置。

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

2.6.4. 列出备份

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

GET /rest/v2/cluster/backups

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

["backup1", "backup2"]

2.6.5. 检查备份可用性

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

HEAD /rest/v2/cluster/backups/{backupName}

2.6.6. 下载备份归档

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

GET /rest/v2/cluster/backups/{backupName}

2.6.7. 删除备份归档

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

DELETE /rest/v2/cluster/backups/{backupName}

2.6.8. 恢复 Data Grid 集群资源

在备份存档中应用资源以恢复 Data Grid 集群。提供的 {restoreName} 用于跟踪恢复进度，独立于正在恢复的备份文件的名称。

重要

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

POST /rest/v2/cluster/restores/{restoreName}

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

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

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

表 2.28. JSON 参数
键	必需/可选	值
`位置`	必需	指定要恢复的备份存档的路径。
`resources`	OPTIONAL	以 JSON 格式指定要恢复的资源。默认为恢复所有资源。如果您指定了一个或多个资源，则 Data Grid 只恢复这些资源。如需更多信息，请参阅资源参数表。

表 2.29. 资源参数
键	必需/可选	值
`缓存`	OPTIONAL	为所有缓存指定要备份的缓存名称的数组。
`cache-configs`	OPTIONAL	为所有模板指定要备份的缓存模板数组，或指定为 `*`。
`计数器`	OPTIONAL	为所有计数器定义一系列计数器名称来备份或 `*`。
`proto-schemas`	OPTIONAL	定义用于备份的 Protobuf 模式名称的数组，或为所有模式定义 `*`。
`tasks`	OPTIONAL	指定一组服务器任务来备份，或为所有任务指定 `*`。

以下示例从服务器上的备份归档中恢复所有计数器：

{
  "location": "/path/accessible/to/the/server/backup-to-restore.zip",
  "resources": {
    "counters": ["*"]
  }
}

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

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

表 2.30. 格式数据
参数	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--

2.6.9. 列出恢复

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

GET /rest/v2/cluster/restores

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

["restore1", "restore2"]

2.6.10. 检查恢复进度

验证恢复操作是否已完成。

HEAD /rest/v2/cluster/restores/{restoreName}

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

2.6.11. 删除恢复元数据

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

DELETE /rest/v2/cluster/restores/{restoreName}

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