12.4.3　ジャーナルを作成する

メモ

このAPIは、Virtual Storage PlatformまたはHUS VMの場合は使用できません。

実行権限

ストレージ管理者（リモートバックアップ管理）

リクエストライン

POST ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/journals

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

なし。

ボディ

LDEV番号を指定して、ジャーナルを作成する場合のコード例を次に示します。

{
  "journalId": 33,
  "ldevIds": [101,102]
}

LDEV番号を指定してジャーナルを作成する場合

属性	型	説明
journalId	int	（必須）ジャーナルID 0～255の10進数の値を指定します。
ldevIds	int[]	（必須）LDEV番号を10進数で指定します。 2個まで指定できます。

連続するLDEV番号の範囲を指定して、ジャーナルを作成する場合のコード例を次に示します。

{
  "journalId": 33,
  "startLdevId": 101,
  "endLdevId": 102
}

連続するLDEV番号の範囲を指定してジャーナルを作成する場合

属性	型	説明
journalId	int	（必須）ジャーナルID 0～255の10進数の値を指定します。
startLdevId	int	（必須）先頭のLDEV番号を10進数で指定します。 この属性には、endLdevId属性よりも小さい値を指定する必要があります。
endLdevId	int	（必須）末尾のLDEV番号を10進数で指定します。 この属性には、startLdevId属性よりも大きい値を指定する必要があります。 startLdevId属性およびendLdevId属性で指定する範囲に含まれるLDEVが2個以内となるように指定してください。

レスポンスメッセージ

ボディ

ジョブオブジェクトを返します。affectedResources以外の属性については、ジョブオブジェクトの説明を参照してください。

属性	説明
affectedResources	作成したジャーナルのURL

ステータスコード

この操作のリクエストに対するステータスコードの意味を次に示します。そのほかのステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X POST --data-binary @./InputParameters.json https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/journals