2.13 ブレードサーバの電源をリセットする

instanceIDに指定したブレードサーバの電源をリセットするタスクを登録します。

ロール

Admin/Modify

リクエストライン

PUT http://<host>:<port>/ComputeSystemsManager/v1/objects/Blades/<instanceID>/actions/Reset/invoke

instanceID:
serverUniqueKeyをbase64urlでエンコードした文字列。

リクエストボディー

リクエストボディーの構造とオブジェクトの属性を次に示します。

ServerPowerReset

{
       "schedule":"...",
       "time":"...",
       "elapseTime":...,
       "emailNotificationType":"..."
}

属性データ型説明
schedulestring0~1ブレードサーバの電源をリセットするスケジュールを指定します。
  • NOW:即時開始
  • LATER:timeで指定した日時に開始。LATER を指定する場合は,timeも合わせて指定してください。
デフォルトの値はNOWです。
timestring0~1ブレードサーバの電源をリセットする日付と時刻をYYYY/MM/DD HH:MM:SS の形式で指定します。過去の時刻は指定できません。scheduleが'LATER'のときに有効です。
elapseTimeinteger0~1ブレードサーバの電源がリセットされるまでのタイムアウト時間を指定します。0から9999(単位:秒)の値を指定できます。
0を指定した場合,または省略した場合は,デフォルトの値が設定されます。デフォルトの値はGUIで設定されたタイムアウト時間です。
emailNotificationTypestring0~1Eメール通知の方法を指定します。
  • SEND:Eメールを送信します。
  • SEND_ONLY_TASK_FAILED:タスクが失敗したときだけEメールを送信します。
  • NOT_SEND:Eメールを送信しません。
デフォルトの値はNOT_SENDです。

レスポンスボディー

レスポンスボディーの構造とオブジェクトの属性を次に示します。

ApiResult

{
       "id":...
}

属性データ型説明
idinteger1ブレードサーバの電源をリセットするために登録されたタスクのタスクIDが返ります。

リターンコード

HTTPステータスコード結果コード詳細コード説明
200--正常終了。
4002010101リクエストボディーの書式が無効です。JSONの書式で記述してください。
4002010102elapseTimeに指定した値が範囲外です。
4002010103scheduleに無効な値を指定しました。
4002010104timeに無効な値を指定しました。
4002010105emailNotificationTypeに無効な値を指定しました。
4002010107scheduleに'LATER'を指定する場合は,timeも指定する必要があります。
4002010108指定した日付は2100年12月31日以降です。
40110001HTTPヘッダーのAuthorizationが指定されていません。
40110002HTTPヘッダーのAuthorizationの値が不正です(Basic認証,HSSOセッション認証のどちらでもありません)。
40110003HTTPヘッダーのAuthorizationのBasic認証の値が不正です(認証情報のフォーマットが不正です)。
40110004ログインに失敗しました。
40110021ログインセッションが切断されました。または,不正なHSSOトークンが指定されました。
40310031基本ライセンスが登録されていない,または有効期限を過ぎています。
40320171管理対象を参照または操作する権限がありません。
404--指定したinstanceIDまたはcollectionはありません。
405--サポートされていないメソッドです。
40620101HTTPヘッダーのAcceptの値が不正です。
4122018106timeに過去の時刻を指定しました。
415--HTTPヘッダーのContent-Typeにサポートされていない形式が指定されています。
500--HTTPヘッダーのContent-Typeに不正な値が指定されている,またはそれ以外の内部エラーです。
50010001ログインに失敗しました(内部エラー)。
5003000100内部エラーが発生しました。
50320201要求の数がAPIの同時最大接続数を超えました。
50320202タスク登録に失敗しました。しばらくしてから,再度実行してください。