ジャンプ先

• リクエスト
• レスポンス
• 例

suspend ( timeout, ignoreSessions )

post

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

サーバーはRUNNINGからADMIN状態に正常に遷移します。

アプリケーションは管理モードです。処理中の作業が完了しました。

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

リクエスト

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

• application/json

パス・パラメータ

• 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'など任意の名前です。

本文 ()

次のフィールドが必要です。

ルート・スキーマ: Arguments

型: object

タイトル: Arguments

ソースを表示

• ignoreSessions (オプション): boolean

  正常な中断の際処理中のHTTPセッションを破棄します

• timeout (オプション): integer(int32)

  サーバーが正常に遷移するのを待機する秒数。タイムアウトすると、サーバーはforceSuspend()を呼び出します。

{
    "type":"object",
    "title":"Arguments",
    "properties":{
        "ignoreSessions":{
            "type":"boolean",
            "description":"<p>drop inflight HTTP sessions during graceful suspend</p>"
        },
        "timeout":{
            "type":"integer",
            "format":"int32",
            "description":"<p>Seconds to wait for server to transition gracefully. The server calls forceSuspend() after timeout.</p>"
        }
    },
    "description":""
}

セキュリティ

• 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>"
}

トップに戻る

例

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

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

リクエストの例

curl -v \
--user admin:admin123 \
-H X-Requested-By:MyClient \
-H Accept:application/json \
-H Content-Type:application/json \
-d "{ timeout: 10, ignoreSessions: true }" \
-X POST http://localhost:7001/management/weblogic/latest/domainRuntime/serverLifeCycleRuntimes/Cluster-0-Server-1/suspend?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/_7_suspendWithTimeout"
    }],
    "progress": "success",
    "serverName": "Cluster-0-Server-1",
    "operation": "suspendWithTimeout",
    "taskStatus": "TASK COMPLETED",
    "completed": true
}

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

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

リクエストの例

curl -v \
--user admin:admin123 \
-H X-Requested-By:MyClient \
-H Accept:application/json \
-H Content-Type:application/json \
-d "{ timeout: 10, ignoreSessions: true }" \
-H "Prefer:respond-async" \
-X POST http://localhost:7001/management/weblogic/latest/domainRuntime/serverLifeCycleRuntimes/Cluster-0-Server-1/suspend?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/_19_suspendWithTimeout"
    }],
    "progress": "success",
    "serverName": "Cluster-0-Server-1",
    "operation": "suspendWithTimeout",
    "taskStatus": "TASK COMPLETED",
    "completed": true
}

トップに戻る