2.6.11 リソースの割り当て方を指定したコンシューマーの割り当て
指定したコンシューマーを,指定した割り当て方に応じて監視対象に割り当てます。
権限
Admin, Modify
APIのバージョン
v1
リクエスト形式
POST http[s]://host:port/Analytics/version/objects/Groups/{id}/actions/updateTargetResourceWithAssignmentType/invoke
リクエストボディー
リクエストボディーの構造とオブジェクトの属性を次に示します。Action
{ "name":"...", "href":"...", "method":"...", "type":"...", "parameters":["...", ...] }
Action (Type: Action)
属性 |
データ型 |
説明 |
---|---|---|
name |
string |
操作名です。 |
href |
string |
操作の実行先URLです。 |
method |
string |
メソッド名です。 |
type |
string |
データのデータ形式です。 |
parameters |
anyType[] |
操作実行時に必要な UpdateTargetResourceWithAssignmentType のコレクション。 UpdateTargetResourceWithAssignmentType の詳細は以下の表を参照ください。 |
UpdateTargetResourceWithAssignmentType
{ "volumes":[{ "id":"...", "assignmentType":"..." }, : ], "vms":[{ "id":"...", "assignmentType":"..." }, : ], "resources":[{ "id":"...", "assignmentType":"..." }, : ], "hypervisors":[{ "id":"...", "assignmentType":"..." }, : ], "applications":[{ "id":"...", "assignmentType":"..." }, : ] }
UpdateTargetResourceWithAssignmentType (Type: UpdateTargetResourceWithAssignmentType)
属性 |
データ型 |
説明 |
---|---|---|
volumes |
TargetResource[] |
割り当てるボリュームのリスト |
vms |
TargetResource[] |
割り当てる仮想マシンのリスト |
resources |
TargetResource[] |
割り当てるホストのリスト |
hypervisors |
TargetResource[] |
割り当てるハイパーバイザ |
applications |
TargetResource[] |
割り当てるアプリケーション |
volumes (Type: TargetResource)
属性 |
データ型 |
説明 |
---|---|---|
id |
long |
リソースを特定するID |
assignmentType |
enum |
リソース割り当て区分 (指定可能な値は「列挙型一覧」のAssignmentTypeの表を参照してください。) |
vms (Type: TargetResource)
属性 |
データ型 |
説明 |
---|---|---|
id |
long |
リソースを特定するID |
assignmentType |
enum |
リソース割り当て区分 (指定可能な値は「列挙型一覧」のAssignmentTypeの表を参照してください。) |
resources (Type: TargetResource)
属性 |
データ型 |
説明 |
---|---|---|
id |
long |
リソースを特定するID |
assignmentType |
enum |
リソース割り当て区分 (指定可能な値は「列挙型一覧」のAssignmentTypeの表を参照してください。) |
hypervisors (Type: TargetResource)
属性 |
データ型 |
説明 |
---|---|---|
id |
long |
リソースを特定するID |
assignmentType |
enum |
リソース割り当て区分 (指定可能な値は「列挙型一覧」のAssignmentTypeの表を参照してください。) |
applications (Type: TargetResource)
属性 |
データ型 |
説明 |
---|---|---|
id |
long |
リソースを特定するID |
assignmentType |
enum |
リソース割り当て区分 (指定可能な値は「列挙型一覧」のAssignmentTypeの表を参照してください。) |
レスポンスボディー
レスポンスボディーの構造とオブジェクトの属性を次に示します。Job
{ "instanceID":"...", "created":"...", "updated":"...", "completed":"...", "state":"...", "affectedResource":["...", ...], "result":["...", ...] }
Job (Type: Job)
属性 |
データ型 |
説明 |
---|---|---|
instanceID |
string |
インスタンスのIDを示します。 |
created |
string |
オブジェクトの生成日付を示します。ISO8601形式です。 |
updated |
string |
オブジェクトが更新された時刻を示します。createdと同時刻が設定されます。ISO8601形式です。 |
completed |
string |
処理が完了した時刻を示します。createdと同時刻が設定されます。ISO8601形式です。 |
state |
string |
以下の値が設定されます。 “failed”: 操作が正常終了しなかったことを示します。 “success”: 操作が正常終了したことを示します。 |
affectedResource |
string[] |
操作の結果,作成または更新されたAPIのリソースのURLを示します。リソースが存在しない場合、このパラメータは空欄です。 |
result |
anyType[] |
実行結果のコレクション。空欄です。 |
ステータスコード
HTTPステータスコード |
Reason phrase |
説明 |
---|---|---|
200 |
OK |
正常終了 |
400 |
Bad Request |
リクエストボディ形式不正 |
401 |
Unauthorized |
ログイン権限がない |
403 |
Forbidden |
更新権限がない |
404 |
Not Found |
リソースが存在しない |
412 |
Precondition Failed |
サーバーが起動していない |
500 |
Internal Server Error |
サーバーサイドエラー |
使用例
[Request Header] POST /Analytics/v1/objects/Groups/10/actions/updateTargetResourceWithAssignmentType/invoke HTTP/1.1 Authorization: Basic c3lzdGVtOm1hbmFnZXI= User-Agent: curl/7.33.0 Host: localhost:22015 Accept: application/json Content-Type: application/json Accept-Language: ja Content-Length: 288 [Request Body] { "name" : "updateTargetResourceWithAssignmentType", "href" : "http://10.197.198.106:22015/Analytics/v1/objects/Groups/10/actions/updateTargetResourceWithAssignmentType/invoke", "method" : "POST", "type" : "application/json", "parameters" : [ { "volumes" : [ ], "vms" : [ { "id" : 578, "assignmentType" : "NoChange" }, { "id" : 619, "assignmentType" : "NoChange" } ], "resources" : [ ], "hypervisors" : [ ] } ] } [Response Header] HTTP/1.1 200 OK Date: Fri, 27 Nov 2015 09:11:06 GMT Server: Cosminexus HTTP Server Cache-Control: no-cache WWW-Authenticate: HSSO 154d18c71a465150d5e228e8f16bf42c4dd280_WVlGcHsLfg5ffg0I_V0810 X-Frame-Options: SAMEORIGIN Transfer-Encoding: chunked Content-Type: application/json [Response Body] { "instanceID" : "092d8a40-9bb3-4067-9d39-404c5c646101", "created" : "2016-11-22T11:30:45.805+09:00", "updated" : "2016-11-22T11:30:47.122+09:00", "completed" : "2016-11-22T11:30:47.122+09:00", "state" : "success", "affectedResource" : [ ], "result" : [ ] }