Oracle Fusion Middleware Oracle WebLogic Server 12.1.3 RESTful管理インタフェース・リファレンス 12c (12.1.3) E57542-02 |
|
![]() 前 |
![]() 次 |
このリソースは、特定のサーバーの正常な停止を実行します。
リソースでは、次のメソッドがサポートされます。
POSTメソッドは、リソースURLで識別されるサーバーを停止します。
リクエスト問合せパラメータ
このリソースは、サーバーを停止するジョブを起動します。
(オプション)このメソッドがデタッチ(バックグラウンド)・モードで実行されるか同期的に実行されるかを指定します。__detached=true問合せパラメータが指定されている場合(デタッチ呼出し)、このメソッドはジョブの起動後ただちに返されます。そうでない場合、ジョブが完了、失敗またはタイムアウトするのを待機します(同期呼び出し)。
(オプション)サーバーを正常に停止するか(false、デフォルト)、サーバーを強制的に停止するかを指定します(true)。
レスポンス本文
メソッドが同期的に呼び出され、ジョブが正常に起動された場合、レスポンス本文には、ジョブの状態(完了、失敗またはタイムアウトで依然実行中)およびジョブ・リソースへのリンクを含むServerJobエンティティが含まれます。
このメソッドは次のリンクを返すことができます。
uri=/wls/jobs/server/{job-id} rel=job title=name
レスポンス・コード
メソッドが同期的に呼び出され、ジョブが正常に完了した場合、メソッドは200 OKステータス・コードを返します。ジョブがタイムアウトした場合、メソッドは202 Acceptedステータス・コードを返します。
メソッドがデタッチで呼び出され、ジョブが正常に起動された場合、メソッドは202 Acceptedステータス・コードおよびジョブ・リソースへのリンクを返します。この場合、レスポンスにはServerJobエンティティが含まれません。
例
この例は、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" } }
この例は、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" }] }