/management/wls/{version}/servers/id/{server-name}/shutdown

このリソースは、特定のサーバーの正常な停止を実行します。

リソースでは、次のメソッドがサポートされます。

• POSTメソッド

POSTメソッド

POSTメソッドは、リソースURLで識別されるサーバーを停止します。

ロール

管理者、デプロイヤ、オペレータ

リクエスト問合せパラメータ

このリソースは、サーバーを停止するジョブを起動します。

_detached

(オプション)このメソッドがデタッチ(バックグラウンド)・モードで実行されるか同期的に実行されるかを指定します。__detached=true問合せパラメータが指定されている場合(デタッチ呼出し)、このメソッドはジョブの起動後ただちに返されます。そうでない場合、ジョブが完了、失敗またはタイムアウトするのを待機します(同期呼び出し)。

force

(オプション)サーバーを正常に停止するか(false、デフォルト)、サーバーを強制的に停止するかを指定します(true)。

レスポンス本文

メソッドが同期的に呼び出され、ジョブが正常に起動された場合、レスポンス本文には、ジョブの状態(完了、失敗またはタイムアウトで依然実行中)およびジョブ・リソースへのリンクを含むServerJobエンティティが含まれます。

このメソッドは次のリンクを返すことができます。

• uri=/wls/jobs/server/{job-id} rel=job title=name

レスポンス・コード

メソッドが同期的に呼び出され、ジョブが正常に完了した場合、メソッドは200 OKステータス・コードを返します。ジョブがタイムアウトした場合、メソッドは202 Acceptedステータス・コードを返します。

メソッドがデタッチで呼び出され、ジョブが正常に起動された場合、メソッドは202 Acceptedステータス・コードおよびジョブ・リソースへのリンクを返します。この場合、レスポンスにはServerJobエンティティが含まれません。

例

例1   サーバーの停止

この例は、POSTメソッドを使用して、サーバーを同期的に停止します。

リクエストの例

curl -v \
--user username:password \
-H X-Requested-By:MyClient \
-H Accept:application/json \
-X POST http://localhost:7001/management/wls/latest/servers/id/Cluster-0-Server-1/shutdown

レスポンスの例

HTTP/1.1 200 OK

Response Body:
{
    "messages": [{
        "message": "Shutdown the server 'Cluster-0-Server-1'.",
        "severity": "SUCCESS"
    }],
    "links": [{
        "rel": "job",
        "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/jobs\/server\/id\/Cluster-0-Server-1:_7_shutdown"
    }],
    "item": {
        "operation": "shutdown",
        "status": "completed",
        "beginTime": 1390587036811,
        "endTime": 1390587036940,
        "name": "_7_shutdown",
        "id": "Cluster-0-Server-1:_7_shutdown",
        "type": "server",
        "description": "Shutting down Cluster-0-Server-1 server ...",
        "serverName": "Cluster-0-Server-1"
    }
}

例2   サーバーの非同期停止

この例は、POSTメソッドを使用して、デタッチ・モードでサーバーを停止します。

リクエストの例

curl -v \
--user username:password \
-H X-Requested-By:MyClient \
-H Accept:application/json \
-X POST http://localhost:7001/management/wls/latest/servers/id/Cluster-0-Server-1/shutdown?__detached=true

レスポンスの例

HTTP/1.1 202 Accepted

Response Body:
{
    "messages": [{
        "message": "Shutting down the server 'Cluster-0-Server-1'.",
        "severity": "SUCCESS"
    }],
    "links": [{
        "rel": "job",
        "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/jobs\/server\/id\/Cluster-0-Server-1:_11_shutdown"
    }]
}