Oracle Fusion Middleware Oracle WebLogic Server 12.1.3 RESTful管理インタフェース・リファレンス 12c (12.1.3) E57542-02 |
|
![]() 前 |
![]() 次 |
このリソースは、アプリケーションを再デプロイします。
リソースでは、次のメソッドがサポートされます。
リソースでは、次のメソッドがサポートされます。
このPOSTメソッドは、リソースURLで識別されるアプリケーションを再デプロイします。再デプロイするファイルが管理サーバーのファイル・システムにすでにある場合、このメソッドを使用します。たとえば、デプロイメントが参照するファイルを物理的に置き換えて、新規ファイルを使用してデプロイメントを開始する場合などです。
このメソッドは、基底のデプロイメント・アーカイブまたは展開済ディレクトリを更新した後に呼び出す必要があります。
リクエスト問合せパラメータ
このリソースは、アプリケーションを再デプロイするジョブを起動します。
(オプション)このメソッドがデタッチ(バックグラウンド)・モードで実行されるか同期的に実行されるかを指定します。
__detached=true問合せパラメータが指定されている場合(デタッチ呼出し)、このメソッドはジョブの起動後ただちに返されます。そうでない場合、ジョブが完了、失敗またはタイムアウトするのを待機します(同期呼び出し)。
レスポンス本文
メソッドが同期的に呼び出され、ジョブが正常に起動された場合、レスポンス本文には、ジョブの状態(完了、失敗またはタイムアウトで依然実行中)およびジョブ・リソースへのリンクを含むDeploymentJobエンティティが含まれます。
このメソッドは次のリンクを返すことができます。
uri=/wls/jobs/deployment/{job-id} rel=job title=id
レスポンス・コード
メソッドが同期的に呼び出され、ジョブが正常に完了した場合、メソッドは200 OKステータス・コードを返します。ジョブがタイムアウトした場合、メソッドは202 Acceptedステータス・コードを返します。
メソッドがデタッチで呼び出され、ジョブが正常に起動された場合、メソッドは202 Acceptedステータス・コードおよびジョブ・リソースへのリンクを返します。この場合、レスポンスにはDeploymentJobエンティティが含まれません。
例
この例は、POSTメソッドを使用して、指定されたアプリケーションを再デプロイします。
リクエストの例
curl -v \ --user username:password \ -H X-Requested-By:MyClient \ -H Accept:application/json \ -X POST http://localhost:7001/management/wls/latest/deployments/application/id/fairShare/redeploy
レスポンスの例
HTTP/1.1 200 OK Response Body: { "messages": [{ "message": "Redeployed the application 'fairShare'.", "severity": "SUCCESS" }], "links": [{ "rel": "job", "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/jobs\/deployment\/id\/25" }], "item": { "operation": "redeploy", "status": "completed", "beginTime": 1390587186018, "endTime": 1390587186120, "name": "ADTR-25", "id": "25", "type": "deployment", "targets": [ { "errors": [], "status": "completed", "name": "Cluster-0", "type": "cluster" }, { "errors": [], "status": "completed", "name": "myserver", "type": "server" } ], "deploymentName": "fairShare", "description": "[Deployer:149026]redeploy application fairShare on Cluster-0,myserver." } }
この例は、POSTメソッドを使用して、指定されたアプリケーションを非同期で再デプロイします。
リクエストの例
curl -v \ --user username:password \ -H X-Requested-By:MyClient \ -H Accept:application/json \ -X POST http://localhost:7001/management/wls/latest/deployments/application/id/fairShare/redeploy?__detached=true
レスポンスの例
HTTP/1.1 202 Accepted Response Body: { "messages": [{ "message": "Redeploying the application 'fairShare'.", "severity": "SUCCESS" }], "links": [{ "rel": "job", "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/jobs\/deployment\/id\/34" }] }
このPOSTメソッドは、アプリケーションをアップロードおよび再デプロイします。再デプロイするファイルがクライアントのファイル・システムに存在する場合、このメソッドを使用します。ファイルを管理サーバーにアップロードし、次にそれを使用して起動するようにデプロイメントに信号を送信します。
リクエスト問合せパラメータ
このリソースは、アプリケーションをアップロードし再デプロイするジョブを起動します。
(オプション)このメソッドがデタッチ(バックグラウンド)・モードで実行されるか同期的に実行されるかを指定します。
__detached=true問合せパラメータが指定されている場合(デタッチ呼出し)、このメソッドはジョブの起動後ただちに返されます。そうでない場合、ジョブが完了、失敗またはタイムアウトするのを待機します(同期呼び出し)。
リクエスト本文
リクエスト本文には、multipart/form-dataのContent-Typeヘッダーを含むフォーム・データおよび次のフォーム・フィールドが含まれます。
(必須)再デプロイするアプリケーションを指定します。Content-Dispositionヘッダーの名前パラメータはdeployment
に設定する必要があり、ファイル名パラメータを、デプロイメント・アーカイブのサーバー上でのファイル名に設定する必要があります。Content-Typeヘッダーはapplication/octet-stream
である必要があり、コンテンツはデプロイメント・アーカイブ・データである必要があります。
(オプション)アプリケーションの新規デプロイメント・プランを指定します。Content-Dispositionヘッダーの名前パラメータはplan
に設定する必要があり、ファイル名パラメータは、デプロイメント・プランのサーバー上でのファイル名に設定する必要があります。Content-Typeヘッダーはapplication/octet-stream
である必要があり、コンテンツはデプロイメント・プラン・データである必要があります。
(オプション)アーカイブ・バージョンを文字列として指定します。Content-Dispositionヘッダーの名前パラメータはarchiveVersion
に設定する必要があります。Content-Typeヘッダーはtext/plain
である必要があります。
(オプション)プラン・バージョンを文字列として指定します。Content-Dispositionヘッダーの名前パラメータはplanVersion
に設定する必要があります。Content-Typeヘッダーはtext/plain
である必要があります。
レスポンス本文
メソッドが同期的に呼び出され、ジョブが正常に起動された場合、レスポンス本文には、ジョブの状態(完了、失敗またはタイムアウトで依然実行中)およびジョブ・リソースへのリンクを含むDeploymentJobエンティティが含まれます。
このメソッドは次のリンクを返すことができます。
uri=/wls/jobs/deployment/{job-id} rel=job title=id
レスポンス・コード
メソッドが同期的に呼び出され、ジョブが正常に完了した場合、メソッドは200 OKステータス・コードを返します。ジョブがタイムアウトした場合、メソッドは202 Acceptedステータス・コードを返します。
メソッドがデタッチで呼び出され、ジョブが正常に起動された場合、メソッドは202 Acceptedステータス・コードおよびジョブ・リソースへのリンクを返します。この場合、レスポンスにはDeploymentJobエンティティが含まれません。
例
この例は、POSTメソッドを使用して、アーカイブをアップロードし、アプリケーションとして再デプロイします。
リクエストの例
curl -v \ --user username:password \ -H X-Requested-By:MyClient \ -H Accept:application/json \ -H Content-Type:multipart/form-data \ -F "deployment=@/deployments/fairShare.war" \ -X POST http://localhost:7001/management/wls/latest/deployments/application/id/myapp/redeploy
レスポンスの例
HTTP/1.1 200 OK Response Body: { "messages": [{ "message": "Redeployed the application 'myapp'.", "severity": "SUCCESS" }], "links": [{ "rel": "job", "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/jobs\/deployment\/id\/29" }], "item": { "operation": "deploy", "status": "completed", "beginTime": 1390587195811, "endTime": 1390587196066, "name": "ADTR-29", "id": "29", "type": "deployment", "targets": [ { "errors": [], "status": "completed", "name": "Cluster-0", "type": "cluster" }, { "errors": [], "status": "completed", "name": "myserver", "type": "server" } ], "deploymentName": "myapp", "description": "[Deployer:149026]deploy application myapp on Cluster-0,myserver." } }
この例は、POSTメソッドを使用して、非同期でアーカイブをアップロードし、それをアプリケーションとして再デプロイします。
リクエストの例
curl -v \ --user username:password \ -H X-Requested-By:MyClient \ -H Accept:application/json \ -H Content-Type:multipart/form-data \ -F "deployment=@/deployments/fairShare.war" \ -X POST http://localhost:7001/management/wls/latest/deployments/library/id/airline/redeploy?__detached=true
レスポンスの例
HTTP/1.1 202 Accepted Response Body: { "messages": [{ "message": "Redeploying the library 'airline'.", "severity": "SUCCESS" }], "links": [{ "rel": "job", "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/jobs\/deployment\/id\/13" }] }