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

前
 
次
 

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

このリソースは、アプリケーションを更新します。アプリケーションを再デプロイせずに、デプロイメント・プラン内の動的要素を更新する場合、このリソースを使用します。セッションは失われません。再デプロイ・リソースを使用して実際のデプロイメントを更新します。デプロイメント・プラン内のすべての変更も更新しますが、セッションが失われます。

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

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/BasicApp/update

レスポンスの例

HTTP/1.1 400 Bad Request

Response Body:
{
    "messages": [{
        "message": "Failed to update the application 'BasicApp'.",
        "severity": "FAILURE"
    }],
    "links": [{
        "rel": "job",
        "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/jobs\/deployment\/id\/37"
    }],
    "item": {
        "operation": "update",
        "error": "\n The application BasicApp cannot have the resource \/deployments\/BasicApp\/plan\/Plan.xml updated dynamically. Either:\n1.) The resource does not exist. \n or \n2) The resource cannot be changed dynamically. \nPlease ensure the resource uri is correct, and redeploy the entire application for this change to take effect.",
        "status": "failed",
        "beginTime": 1390587229032,
        "endTime": 1390587229322,
        "name": "ADTR-37",
        "id": "37",
        "type": "deployment",
        "targets": [{
            "errors": ["\n The application BasicApp cannot have the resource \/deployments\/BasicApp\/plan\/Plan.xml updated dynamically. Either:\n1.) The resource does not exist. \n or \n2) The resource cannot be changed dynamically. \nPlease ensure the resource uri is correct, and redeploy the entire application for this change to take effect."],
            "status": "failed",
            "name": "myserver",
            "type": "server"
        }],
        "deploymentName": "BasicApp",
        "description": "[Deployer:149026]update application BasicApp on myserver."
    }
}