2.8.3 仮想マシンの監視状態変更に必要な情報の取得
仮想マシンの監視状態を変更するために必要な情報を取得します。
権限
Admin, Modify
APIのバージョン
v1
リクエスト形式
GET http[s]://host:port/Analytics/version/services/VirtualMachines/actions/changeManagedType
リクエストボディー
リクエストボディーには何も設定しません。
レスポンスボディー
レスポンスボディーの構造とオブジェクトの属性を次に示します。Action
{
"name":"...",
"href":"...",
"method":"...",
"type":"...",
"parameters":["...", ...]
}
Action (Type: Action)
|
属性 |
データ型 |
説明 |
|---|---|---|
|
name |
string |
操作名です。 |
|
href |
string |
操作の実行先URLです。 |
|
method |
string |
メソッド名です。 |
|
type |
string |
データのデータ形式です。 |
|
parameters |
anyType[] |
操作実行時に必要な ChangeManagedTypeParamForVM のコレクション。 ChangeManagedTypeParamForVM の詳細は以下の表を参照ください。 |
ChangeManagedTypeParamForVM
{
"newMonitoringOperationType":"...",
"virtualMachineIds":["...", ...]
}
ChangeManagedTypeParamForVM (Type: ChangeManagedTypeParamForVM)
|
属性 |
データ型 |
説明 |
|---|---|---|
|
newMonitoringOperationType |
enum |
変更したい監視状態を指定します。 (指定可能な値は「列挙型一覧」のMonitoringOperationTypeの表を参照してください。) 以下に示す値のみ指定可能です。
|
|
virtualMachineIds |
long[] |
仮想マシンを特定するIDを指定します。複数同時に指定する場合は，IDを連結して指定します。 instanceID=50,51を指定する場合は以下のように指定します。 virtualMachineIds : [ 50, 51 ] |
ステータスコード
|
HTTPステータスコード |
Reason phrase |
説明 |
|---|---|---|
|
200 |
OK |
正常終了 |
|
401 |
Unauthorized |
ログイン権限がない |
|
403 |
Forbidden |
参照権限がない |
|
412 |
Precondition Failed |
サーバーが起動していない |
|
500 |
Internal Server Error |
サーバーサイドエラー |
使用例
[Request Header]
GET /Analytics/v1/services/VirtualMachines/actions 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:17:42 GMT
Server: Cosminexus HTTP Server
Cache-Control: no-cache
WWW-Authenticate: HSSO 1e89694342cfad52de32bd8e1a2921a48b8d8_WVlGcHsLfg5ffg0I_V0810
X-Frame-Options: SAMEORIGIN
Transfer-Encoding: chunked
Content-Type: application/json
[Response Body]
{
"name" : "changeManagedType",
"href" : "http://localhost:22015/Analytics/v1/services/VirtualMachines/actions/changeManagedType/invoke",
"method" : "POST",
"type" : "application/json",
"parameters" : [ {
"newMonitoringOperationType" : "Monitor",
"virtualMachineIds" : [ ]
} ]
}