Oracle Fusion Middleware Oracle WebLogic Server 12.1.3 RESTful管理インタフェース・リファレンス 12c (12.1.3) E57542-02 |
|
![]() 前 |
![]() 次 |
このリソースはサーバーを中断します。
リソースでは、次のメソッドがサポートされます。
POSTメソッドは、リソースURLで識別されるサーバーを、RUNNING状態からADMIN状態に移行します。
リクエスト問合せパラメータ
このリソースは、サーバーを中断するジョブを起動します。
(オプション)このメソッドがデタッチ(バックグラウンド)・モードで実行されるか同期的に実行されるかを指定します。
__detached=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/suspend
レスポンスの例
HTTP/1.1 200 OK Response Body: { "messages": [{ "message": "Suspended 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:_1_suspendWithTimeout" }], "item": { "operation": "suspending", "status": "completed", "beginTime": 1390587002462, "endTime": 1390587002489, "name": "_1_suspendWithTimeout", "id": "Cluster-0-Server-1:_1_suspendWithTimeout", "type": "server", "description": "suspending 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/suspend?__detached=true
レスポンスの例
HTTP/1.1 202 Accepted Response Body: { "messages": [{ "message": "Suspending 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:_9_suspendWithTimeout" }] }