Stop Server (os-stop Action)
起動状態のサーバを停止します。
注意:
IaaSポータル／APIから仮想サーバを「停止」した場合、一定時間内にシャットダウン処理が完了しないと仮想サーバが強制停止（電源強制断に相当）されます。正常に停止状態にするには、仮想サーバにログインしてシャットダウン操作を実施してください。
注意:
Linuxのイメージで作成した仮想サーバを起動した場合、sshdの設定が初期化され、起動後に仮想サーバにログインできなくなる場合があります。「Reboot server」 の注意事項を参照し、必要に応じて、仮想サーバの停止前に作業を実施してください。
APIエンドポイント
| リージョン | APIエンドポイント |
|---|---|
| 西日本リージョン3の場合 | https://compute.jp-west-3.cloud.global.fujitsu.com |
| 東日本リージョン3の場合 | https://compute.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI
POST
/v2.1/{project_id}/servers/{server_id}/action
HTTPステータスコード
正常時：202
エラー時：401, 403, 404, 409
リクエストパラメータの説明
| 名前 | In | Type |
デフォルト値 /必須指定 |
Description |
|---|---|---|---|---|
| project_id | path | string | 必須 | プロジェクトのUUID |
| server_id | path | string | 必須 | サーバのUUID |
| os-stop | body | none | 必須 | 起動状態のサーバを停止するアクション |
リクエスト例
{
"os-stop" : null
}