Oracle WebLogic ServerのRESTfulドメイン実行時管理インタフェース

forceSuspend

post

/management/weblogic/{version}/domainRuntime/serverLifeCycleRuntimes/{name}/forceSuspend

処理中の作業を取り消して、サーバーをRUNNINGからADMIN状態に強制的に遷移させます。

取り消しできない作業はドロップされます。アプリケーションは強制的に管理モードに移行します。

このメソッドは、非同期呼出しとベスト・エフォート同期呼出しの両方をサポートします。動作は'Prefer'ヘッダーによって制御されます。

リクエスト

パス・パラメータ

name: string

コレクション内のインスタンスのnameプロパティ。
version: string

WebLogic RESTインタフェースのバージョン。

ヘッダー・パラメータ

Prefer (オプション): string

'Prefer'ヘッダー・パラメータを使用すると、このメソッドの実行方法に関するプリファレンスを指定できます。値を'respond-async'にすると、リクエストを発行し、完了を待機せずにすぐに返すというプリファレンスになります。また、値を'wait =#seconds'にすると、メソッドが完了するまで#seconds間待機してから返すというプリファレンスになります。Preferヘッダーが指定されていないか無効な場合、待機時間は300秒になります。
X-Requested-By: string

'X - Requested - By'ヘッダーは、クロスサイト・リクエスト・フォージェリ(CSRF)攻撃からの保護に使用されます。値は、'MyClient'など任意の名前です。

セキュリティ

Admin: basic

タイプ: Basic

説明: A user in the Admin security role.
オペレータ: basic

タイプ: Basic

説明: A user in the Operator security role.

トップに戻る

レスポンス

サポートされているメディア・タイプ

application/json

200レスポンス

次のフィールドを返します。

ルート・スキーマ: Return

型: object

タイトル: Return

ソースを表示

return (オプション): array Server Life Cycle Task Runtime Reference

タイトル: Server Life Cycle Task Runtime Reference

サーバー・ライフサイクル・タスク・ランタイム参照が含まれます。
アクションの結果を返します。

{
    "type":"object",
    "title":"Return",
    "properties":{
        "return":{
            "title":"Server Life Cycle Task Runtime Reference",
            "type":"array",
            "items":{
                "type":"string",
                "description":""
            },
            "description":"Contains the server life cycle task runtime reference. <p>Returns the action's result.</p>"
        }
    },
    "description":""
}

ネストされたスキーマ: Server Life Cycle Task Runtime Reference

型: array

タイトル: Server Life Cycle Task Runtime Reference

サーバー・ライフサイクル・タスク・ランタイム参照が含まれます。

アクションの結果を返します。

ソースを表示

配列: 文字列

{
    "title":"Server Life Cycle Task Runtime Reference",
    "type":"array",
    "items":{
        "type":"string",
        "description":""
    },
    "description":"Contains the server life cycle task runtime reference. <p>Returns the action's result.</p>"
}

トップに戻る

例

forceSuspendアクションを同期的に呼び出します。

この例では、POSTメソッドを使用してforceSuspendアクションの同期呼出しを行います。

リクエストの例

curl -v \
--user admin:admin123 \
-H X-Requested-By:MyClient \
-H Accept:application/json \
-H Content-Type:application/json \
-d "{}" \
-X POST http://localhost:7001/management/weblogic/latest/domainRuntime/serverLifeCycleRuntimes/Cluster-0-Server-1/forceSuspend?links=job,abort&fields=completed,progress,serverName,operation,taskStatus

レスポンスの例

HTTP/1.1 200 OK

Response Body:
{
    "links": [{
        "rel": "job",
        "href": "http:\//localhost:7001/management/weblogic/latest/domainRuntime/serverLifeCycleRuntimes/Cluster-0-Server-1/tasks/_8_forceSuspend"
    }],
    "progress": "success",
    "serverName": "Cluster-0-Server-1",
    "operation": "forceSuspend",
    "taskStatus": "TASK COMPLETED",
    "completed": true
}

forceSuspendアクションを非同期的に呼び出します。

この例では、POSTメソッドを使用してforceSuspendアクションの非同期呼出しを行います。

リクエストの例

curl -v \
--user admin:admin123 \
-H X-Requested-By:MyClient \
-H Accept:application/json \
-H Content-Type:application/json \
-d "{}" \
-H "Prefer:respond-async" \
-X POST http://localhost:7001/management/weblogic/latest/domainRuntime/serverLifeCycleRuntimes/Cluster-0-Server-1/forceSuspend?links=job,abort&fields=completed,progress,serverName,operation,taskStatus

レスポンスの例

HTTP/1.1 200 OK

Response Body:
{
    "links": [{
        "rel": "job",
        "href": "http:\//localhost:7001/management/weblogic/latest/domainRuntime/serverLifeCycleRuntimes/Cluster-0-Server-1/tasks/_20_forceSuspend"
    }],
    "progress": "success",
    "serverName": "Cluster-0-Server-1",
    "operation": "forceSuspend",
    "taskStatus": "TASK COMPLETED",
    "completed": true
}

トップに戻る