2.6. Data Grid クラスターの操作

POST 要求を使用して Data Grid クラスター全体をシャットダウンします。

POST /rest/v2/cluster?action=stop

Data Grid は 204 (No Content) と応答し、クラスター全体の秩序あるシャットダウンを実行します。

GET リクエストに ?action=stop&server パラメーターを指定して、Data Grid クラスター内の 1 つまたは複数の特定のサーバーをシャットダウンすることができます。

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

Data Grid は 204 (No Content) と応答します。

クラスターのキャッシュコンテナーに現在保存されているリソース (キャッシュ、テンプレート、カウンター、Protobuf スキーマ、サーバータスクなど) を含むバックアップアーカイブ、application/zip を作成します。

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 です。プロパティーは次のとおりです。