/management/wls/{version}/deployments/library/id/{library-name}

このリソースは、ライブラリを管理します。

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

• DELETEメソッド

• GETメソッド

DELETEメソッド

DELETEメソッドは、リソースURLで識別されるライブラリをアンデプロイします。

ロール

管理者

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

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

_detached

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

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

レスポンス本文

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

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

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

レスポンス・コード

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

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

例

例1   ライブラリのアンデプロイ

この例は、DELETEメソッドを使用して、ライブラリをアンデプロイします。

リクエストの例

curl -v \
--user username:password \
-H X-Requested-By:MyClient \
-H Accept:application/json \
-X DELETE http://localhost:7001/management/wls/latest/deployments/library/id/airline

レスポンスの例

HTTP/1.1 200 OK

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

GETメソッド

このリソースのGETメソッドは、リソースURLによって識別されるライブラリに関する情報を返します。

ロール

管理者、デプロイヤ、オペレータ、モニター

レスポンス本文

返されるレスポンス本文には、指定したライブラリに関する情報を含むLibraryエンティティが含まれます。

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

• uri=/management/wls/{version}/deployments/library/id/{library-name}/undeploy rel=undeploy

• uri=/management/wls/{version}/deployments/library rel=parent

レスポンス・コード

このメソッドは、標準のHTTPステータス・コードのいずれかを返します。

例

例1   ライブラリの表示

この例は、GETメソッドを使用して、特定のライブラリに関する情報を検索します。

リクエストの例

curl -v \
--user username:password \
-H X-Requested-By:MyClient \
-H Accept:application/json \
-X GET http://localhost:7001/management/wls/latest/deployments/library/id/airline

レスポンスの例

HTTP/1.1 200 OK

Response Body:
{
    "links": [
        {
            "rel": "parent",
            "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/deployments\/library"
        },
        {
            "rel": "action",
            "uri": "http:\/\/localhost:7001\/management\/wls\/latest\/deployments\/library\/id\/airline\/redeploy",
            "title": "redeploy"
        }
    ],
    "item": {
        "name": "airline",
        "state": "active",
        "type": "library",
        "targets": ["myserver"],
        "displayName": "airline",
        "deploymentPath": "\/deployments\/airline.war"
    }
}