プライマリ・コンテンツに移動
Oracle Fusion Middleware Oracle WebLogic Server 12.1.3 RESTful管理インタフェース・リファレンス
12c (12.1.3)
E57542-02
  目次へ移動
目次

前
 
次
 

/management/wls/{version}/deployments/application/id/{application-name}/redeploy

このリソースは、アプリケーションを再デプロイします。

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

POSTメソッド

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

application/json"を受け入れるPOST

このPOSTメソッドは、リソースURLで識別されるアプリケーションを再デプロイします。再デプロイするファイルが管理サーバーのファイル・システムにすでにある場合、このメソッドを使用します。たとえば、デプロイメントが参照するファイルを物理的に置き換えて、新規ファイルを使用してデプロイメントを開始する場合などです。

このメソッドは、基底のデプロイメント・アーカイブまたは展開済ディレクトリを更新した後に呼び出す必要があります。

ロール

管理者、デプロイヤ

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

このリソースは、アプリケーションを再デプロイするジョブを起動します。

_detached

(オプション)このメソッドがデタッチ(バックグラウンド)・モードで実行されるか同期的に実行されるかを指定します。

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

レスポンス本文

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

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

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

レスポンス・コード

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

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

例1   アプリケーションの再デプロイ

この例は、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."
    }
}
例2   アプリケーションの非同期再デプロイ

この例は、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"
    }]
}

"multipart/form-data"を受け入れるPOST

このPOSTメソッドは、アプリケーションをアップロードおよび再デプロイします。再デプロイするファイルがクライアントのファイル・システムに存在する場合、このメソッドを使用します。ファイルを管理サーバーにアップロードし、次にそれを使用して起動するようにデプロイメントに信号を送信します。

ロール

管理者

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

このリソースは、アプリケーションをアップロードし再デプロイするジョブを起動します。

_detached

(オプション)このメソッドがデタッチ(バックグラウンド)・モードで実行されるか同期的に実行されるかを指定します。

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

リクエスト本文

リクエスト本文には、multipart/form-dataのContent-Typeヘッダーを含むフォーム・データおよび次のフォーム・フィールドが含まれます。

deployment

(必須)再デプロイするアプリケーションを指定します。Content-Dispositionヘッダーの名前パラメータはdeploymentに設定する必要があり、ファイル名パラメータを、デプロイメント・アーカイブのサーバー上でのファイル名に設定する必要があります。Content-Typeヘッダーはapplication/octet-streamである必要があり、コンテンツはデプロイメント・アーカイブ・データである必要があります。

plan

(オプション)アプリケーションの新規デプロイメント・プランを指定します。Content-Dispositionヘッダーの名前パラメータはplanに設定する必要があり、ファイル名パラメータは、デプロイメント・プランのサーバー上でのファイル名に設定する必要があります。Content-Typeヘッダーはapplication/octet-streamである必要があり、コンテンツはデプロイメント・プラン・データである必要があります。

archiveVersion

(オプション)アーカイブ・バージョンを文字列として指定します。Content-Dispositionヘッダーの名前パラメータはarchiveVersionに設定する必要があります。Content-Typeヘッダーはtext/plainである必要があります。

planVersion

(オプション)プラン・バージョンを文字列として指定します。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エンティティが含まれません。

例1   アプリケーションのアップロードおよび再デプロイ

この例は、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."
    }
}
例2   アプリケーションの非同期でのアップロードおよび再デプロイ

この例は、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"
    }]
}