4.8　リソースグループにリソースを登録する

メモ

REST API を実行するユーザが、対象ストレージシステムのリソースをREST API でロックしている場合、このAPIは実行できません。その場合は、ロックを解除してから実行してください。

実行権限

セキュリティ管理者（参照・編集）

リクエストライン

PUT ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/resource-groups/＜オブジェクトID＞/actions/add-resource/invoke

このAPIはPOSTメソッドでも実行できます。

リクエストメッセージ

オブジェクトID

リソースグループの情報取得で取得したresourceGroupIdの値を指定します。

属性	型	説明
resourceGroupId	int	（必須）リソースグループID 1～1023の10進数で指定します。

クエリパラメータ

なし。

ボディ

LDEV番号を指定した場合のコード例を次に示します。

{
  "parameters": {
    "ldevIds": [
      2,
      3
    ],
    "parityGroupIds": [
      "1-1",
      "1-2"
    ],
    "externalParityGroupIds": [
      "1-5",
      "1-6"
    ],
    "portIds": [
      "CL1-A",
      "CL1-B"
    ],
    "hostGroupIds": [
      "CL1-A,4",
      "CL1-A,5",
      "CL1-A,6"
    ]
  }
}

LDEV番号を範囲指定した場合のコード例を次に示します。

{
  "parameters": {
    "startLdevId": 2,
    "endLdevId": 5,
    "parityGroupIds": [
      "1-1",
      "1-2"
    ],
    "externalParityGroupIds": [
      "1-5",
      "1-6"
    ],
    "portIds": [
      "CL1-A",
      "CL1-B"
    ],
    "hostGroupIds": [
      "CL1-A,4",
      "CL1-A,5",
      "CL1-A,6"
    ]
  }
}

属性	型	説明
parityGroupIds	string[]	（任意）パリティグループ番号
externalParityGroupIds	string[]	（任意）外部パリティグループ番号
portIds	string[]	（任意）ポート番号
hostGroupIds	string[]	（任意）ホストグループまたはiSCSIターゲットのオブジェクトID ホストグループまたはiSCSIターゲットの情報取得で取得したhostGroupIdの値を指定します。
ldevIds	int[]	（任意）LDEV番号 0～65279の値を指定します。この属性を指定した場合はstartLdevId属性とendLdevId属性は指定できません。
startLdevId	int	（任意）開始LDEV番号 LDEVを範囲指定する場合、0～65278の値を指定します。この属性を指定した場合、endLdevId属性も指定します。ldevId属性を指定した場合はこの属性は指定できません。
endLdevId	int	（任意）終了LDEV番号 LDEVを範囲指定する場合、1～65279の値を指定します。この属性を指定した場合、startLdevId属性も指定します。ldevId属性を指定した場合はこの属性は指定できません。

レスポンスメッセージ

ボディ

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

属性	説明
affectedResources	リソースを登録したリソースグループのURL

Actionテンプレート

GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/resource-groups/＜オブジェクトID＞/actions/add-resource

ステータスコード

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

コード例

Actionテンプレートを取得する場合

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/836000123456/resource-groups/4/actions/add-resource

Actionテンプレートを取得してリクエストを実行する場合

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