Skip to main content
12.5
本製品の最新リリースがご利用いただけます。
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

StartBulkVolumeRead

共同作成者
PDF

メソッドを使用すると、指定したボリュームの一括ボリューム読み取りセッションを開始できます StartBulkVolumeRead。

1 つのボリュームで同時に実行できる一括ボリュームプロセスは 2 つだけです。セッションを初期化すると、 SolidFire ストレージボリュームからデータが読み取られ、外部のバックアップソースに保存されます。外部データは、 Element ストレージノードで実行されている Web サーバからアクセスされます。外部データアクセスに関するサーバ操作の情報は、ストレージシステムで実行中のスクリプトによって渡されます。

ボリュームの一括読み取り処理の開始時にボリュームの Snapshot が作成され、読み取りが完了すると削除されます。また、 Snapshot の ID をパラメータとして入力し、ボリュームの Snapshot を読み取ることもできます。以前の Snapshot を読み取った場合、ボリュームの新しい Snapshot は作成されず、読み取りが完了したときに以前の Snapshot も削除されません。

メモ 既存の Snapshot の ID を指定しない場合、新しい Snapshot が作成されます。Snapshot を作成できるのは、クラスタフルが「ステージ 2 」または「ステージ 3 」の場合です。クラスタフルが「ステージ 4 」または「ステージ 5 」の場合、 Snapshot は作成されません。

パラメータ

このメソッドの入力パラメータは次のとおりです。

名前 製品説明 タイプ デフォルト値 必須

の形式で入力し

ボリュームデータの形式。次のいずれかです。

  • uncompressed：ボリュームのすべてのバイトが圧縮なしで返されます。

  • native：不透明なデータが返されます。サイズは小さく、以降のボリュームの一括書き込みでより効率的に格納および書き込みが行われます。

文字列

なし

はい

ボリュームID

読み取るボリュームの ID 。

整数

なし

はい

Snapshot ID

ボリュームの一括読み取りで使用する、以前に作成された Snapshot の ID 。ID を入力しない場合は、現在のアクティブボリュームイメージの Snapshot が作成されます。

整数

なし

いいえ

スクリプト

実行可能スクリプトの名前。スクリプト名を指定しない場合は、 Element ストレージノードにアクセスするためにキーと URL が必要です。スクリプトはプライマリノードに対して実行され、キーと URL がスクリプトに返されます。これにより、ローカル Web サーバにアクセスできるようになります。

文字列

なし

いいえ

scriptParameters

スクリプトに渡す JSON パラメータ。

JSON（オブジェクト）

なし

いいえ

属性

JSONオブジェクト形式の名前と値のペアのリスト。"詳細"です。

JSON（オブジェクト）

なし

いいえ

戻り値

このメソッドの戻り値は次のとおりです。

名前

製品説明

タイプ

asyncHandle

完了を確認する非同期プロセスの ID 。

整数

キー

セッションを一意に識別する判読不明なキー。

文字列

URL

ノードの Web サーバにアクセスするための URL 。

文字列

要求例

このメソッドの要求例を次に示します。

{
   "method": "StartBulkVolumeRead",
   "params": {
      "volumeID" : 5,
      "format"  : "native",
      "snapshotID" : 2
   },
   "id": 1
}

応答例

このメソッドの応答例を次に示します。

{
      "id" : 1,
   "result" : {
      "asyncHandle" : 1,
      "key" : "11eed8f086539205beeaadd981aad130",
      "url" : "https://127.0.0.1:44000/"
   }
}

新規導入バージョン

9.6