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

StartBulkVolumeRead

共同作成者

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

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

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

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

パラメータ

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

名前 説明 を入力します デフォルト値 必須

の形式で入力し

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

  • uncompressed :ボリュームのすべてのバイトが圧縮されずに返されます。

  • ネイティブ : 非透過的なデータが返されますこれは ' サイズが小さく ' 後続のボリュームの一括書き込みでより効率的に保存および書き込みが行われます

文字列

なし

はい。

ボリューム ID

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

整数

なし

はい。

Snapshot ID

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

整数

なし

いいえ

スクリプト

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

文字列

なし

いいえ

scriptParameters

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

JSON オブジェクト

なし

いいえ

属性( Attributes )

一括ボリュームジョブの 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