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

前
 
次
 

/management/wls/{version}/deployments/library/id/{library-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/library/id/airline/redeploy

レスポンスの例

HTTP/1.1 200 OK

Response Body:
{
    "messages": [{
        "message": "Redeployed the library 'airline'.",
        "severity": "SUCCESS"
    }],
    "links": [{
        "rel": "job",
        "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/jobs\/deployment\/id\/5"
    }],
    "item": {
        "operation": "redeploy",
        "status": "completed",
        "beginTime": 1390587126314,
        "endTime": 1390587126328,
        "name": "ADTR-5",
        "id": "5",
        "type": "deployment",
        "targets": [{
            "errors": [],
            "status": "completed",
            "name": "myserver",
            "type": "server"
        }],
        "deploymentName": "airline",
        "description": "[Deployer:149117]redeploy library airline on myserver."
    }
}

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

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

ロール

管理者、デプロイヤ

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

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

_detached

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

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

リクエスト本文

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

deployment

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

レスポンス本文

メソッドが同期的に呼び出され、ジョブが正常に起動された場合、レスポンス本文には、ジョブの状態(完了、失敗またはタイムアウトで依然実行中)およびジョブ・リソースへのリンクを含む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/library/id/airline/redeploy

レスポンスの例

HTTP/1.1 200 OK

Response Body:
{
    "messages": [{
        "message": "Redeployed the library 'airline'.",
        "severity": "SUCCESS"
    }],
    "links": [{
        "rel": "job",
        "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/jobs\/deployment\/id\/9"
    }],
    "item": {
        "operation": "deploy",
        "status": "completed",
        "beginTime": 1390587135085,
        "endTime": 1390587135333,
        "name": "ADTR-9",
        "id": "9",
        "type": "deployment",
        "targets": [{
            "errors": [],
            "status": "completed",
            "name": "myserver",
            "type": "server"
        }],
        "deploymentName": "airline",
        "description": "[Deployer:149117]deploy library airline on 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"
    }]
}