2.6.8 コンシューマーの割り当てに必要な情報の取得
指定したコンシューマーを監視対象リソースの割り当てに必要な情報を取得します。
権限
Admin, Modify
APIのバージョン
v1
リクエスト形式
GET http[s]://host:port/Analytics/version/objects/Groups/{id}/actions/updateTargetResource
リクエストボディー
リクエストボディーには何も設定しません。
レスポンスボディー
レスポンスボディーの構造とオブジェクトの属性を次に示します。Action
{
"name":"...",
"href":"...",
"method":"...",
"type":"...",
"parameters":["...", ...]
}
Action (Type: Action)
|
属性 |
データ型 |
説明 |
|---|---|---|
|
name |
string |
操作名です。 |
|
href |
string |
操作の実行先URLです。 |
|
method |
string |
メソッド名です。 |
|
type |
string |
データのデータ形式です。 |
|
parameters |
anyType[] |
操作実行時に必要な UpdateTargetResourceParam のコレクション。 UpdateTargetResourceParam の詳細は以下の表を参照ください。 |
UpdateTargetResourceParam
{
"volumeIDs":["...", ...],
"vmIDs":["...", ...],
"resourceIDs":["...", ...]
}
UpdateTargetResourceParam (Type: UpdateTargetResourceParam)
|
属性 |
データ型 |
説明 |
|---|---|---|
|
volumeIDs |
long[] |
コンシューマーを割り当てるボリュームを特定するIDを指定します。複数のボリュームに割り当てを行う場合は，IDを連結して指定します。すでに割り当て済みの監視対象のIDも含め，設定する必要があります。 "volumeIDs" : [ 81, 87 ] すべてのボリュームの割り当てを解除する場合は，メンバーの値を空欄にします。 "volumeIDs" : [ ] |
|
vmIDs |
long[] |
コンシューマーを割り当てる仮想マシンを特定するIDを指定します。複数の仮想マシンに割り当てを行う場合は，IDを連結して指定します。すでに割り当て済みの監視対象のIDも含め，設定する必要があります。 " vmIDs " : [ 81, 87 ] すべての仮想マシンの割り当てを解除する場合は，メンバーの値を空欄にします。 " vmIDs " : [ ] |
|
resourceIDs |
long[] |
コンシューマーを割り当てるホストを特定するIDを指定します。複数のホストに割り当てを行う場合は，IDを連結して指定します。すでに割り当て済みの監視対象のIDも含め，設定する必要があります。 " resourceIDs " : [ 81, 87 ] すべての仮想マシンの割り当てを解除する場合は，メンバーの値を空欄にします。 " resourceIDs " : [ ] |
ステータスコード
|
HTTPステータスコード |
Reason phrase |
説明 |
|---|---|---|
|
200 |
OK |
正常終了 |
|
401 |
Unauthorized |
ログイン権限がない |
|
403 |
Forbidden |
参照権限がない |
|
404 |
Not Found |
リソースが存在しない |
|
412 |
Precondition Failed |
サーバーが起動していない |
|
500 |
Internal Server Error |
サーバーサイドエラー |
使用例
[Request Header]
GET /Analytics/v1/objects/Groups/10/actions/updateTargetResource HTTP/1.1
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: curl/7.33.0
Host: localhost:22015
Accept: application/json
Accept-Language: ja
[Response Header]
HTTP/1.1 200 OK
Date: Fri, 27 Nov 2015 09:04:21 GMT
Server: Cosminexus HTTP Server
Cache-Control: no-cache
WWW-Authenticate: HSSO ba4d83751660bee033d1ccdaf4d78e97f6c893a_WVlGcHsLfg5ffg0I_V0810
X-Frame-Options: SAMEORIGIN
Transfer-Encoding: chunked
Content-Type: application/json
[Response Body]
{
"name" : "updateTargetResource",
"href" : "http://localhost:22015/Analytics/v1/objects/Groups/10/actions/updateTargetResource/invoke",
"method" : "POST",
"type" : "application/json",
"parameters" : [ {
"volumeIDs" : [ ],
"vmIDs" : [ 97 ],
"resourceIDs" : [ ]
} ]
}