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

Data Grid クラスターの管理タスクを監視および実行します。

2.6.1. Data Grid クラスターの停止

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

POST /rest/v2/cluster?action=stop

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

2.6.2. クラスター内の特定の Data Grid サーバーの停止

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

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

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

2.6.3. Data Grid クラスターのバックアップ

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

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

オプションで、次のように、バックアップ操作のパラメーターを含む JSON ペイロードをリクエストに含めます。

表2.27 JSON パラメーター

キー必須またはオプション

directory

オプション

バックアップアーカイブを作成および保存するサーバー上の場所を指定します。

バックアップ操作が正常に完了すると、サービスは 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 サーバー上のバックアップアーカイブからの復元

サーバー上のアーカイブからバックアップする場合は、POST リクエストに application/json コンテンツタイプを使用します。

表2.28 JSON パラメーター

キー必須またはオプション

location

必須

復元するバックアップアーカイブのパスを指定します。

resources

オプション

復元するリソースを JSON 形式で指定します。デフォルトでは、すべてのリソースを復元します。1 つまたは複数のリソースを指定した場合、Data Grid はそれらのリソースのみをリストアします。詳細については、リソースパラメーターの表を参照してください。

表2.29 リソースパラメーター

キー必須またはオプション

caches

オプション

バックアップするキャッシュ名の配列を指定するか、すべてのキャッシュを対象とする * を指定します。

cache-configs

オプション

バックアップするキャッシュテンプレートの配列、またはすべてのテンプレートの * を指定します。

counters

オプション

バックアップするカウンター名の配列、またはすべてのカウンターの * を定義します。

proto-schemas

オプション

バックアップする Protobuf スキーマ名の配列、またはすべてのスキーマの * を定義します。

tasks

オプション

バックアップするサーバータスクの配列、またはすべてのタスクの * を指定します。

次の例では、サーバー上のバックアップアーカイブからすべてのカウンターを復元します。

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

2.6.8.2. ローカルバックアップアーカイブからの復元

ローカルのバックアップアーカイブをサーバーにアップロードするには、POST リクエストに multipart/form-data コンテンツタイプを使用します。

表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 応答は、復元操作が進行中であり、操作が完了すると削除されることを示します。