2.6. 使用 Data Grid 集群

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

POST /rest/v2/cluster?action=stop

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

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

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

Data Grid 使用 204 （无内容） 进行响应。

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

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

（可选）将您的 JSON 有效负载包含您的请求，其中包含备份操作的参数，如下所示：

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

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

GET /rest/v2/cluster/backups

Data Grid 使用所有备份名称阵列响应，如下例所示：

["backup1", "backup2"]

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

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

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

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

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

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

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

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

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

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

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--

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

GET /rest/v2/cluster/restores

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

["restore1", "restore2"]

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

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

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

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

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

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

检索 Data Grid 集群中所有服务器的分发详细信息。

GET /rest/v2/cluster?action=distribution

返回集群中每个 Data Grid 服务器统计的 JSON 数组，其格式如下：

[
  {
    "node_name": "NodeA",
    "node_addresses": [
      "127.0.0.1:39313"
    ],
    "memory_available": 466180016,
    "memory_used": 56010832
  },
  {
    "node_name": "NodeB",
    "node_addresses": [
      "127.0.0.1:47477"
    ],
    "memory_available": 467548568,
    "memory_used": 54642280
  }
]

阵列中的每个元素代表一个 Data Grid 节点。如果禁用了统计集合，则有关内存用量值的信息为 -1。这些属性是：