リクエストの送信
Oracle WebLogic Server REST APIを使用してリクエストを送信する際は、次のガイドラインを使用してください。
URL構造
リクエストのURL構造は次のとおりです。
http://<host>:<port>/management/weblogic/<version>/<resource-path>
-
<host>:<port>
は、WebLogic Serverが実行されているホストとポートです。たとえば、localhost:7001
のようになります。 -
management
は、すべてのリソースのコンテキスト・ルートです。 -
<version>
はWebLogic RESTオブジェクト・バージョンです。latest
は、オブジェクトが最新バージョンであることを示すために使用されます。 -
<resource-path>
は、対話するリソースを識別する相対パスです。オプションとして、そのリソースに対して実行するアクションを追加します。たとえば、サーバーを起動するには、次のRESTエンドポイントを使用します。management/weblogic/<version>/domainRuntime/serverRuntimes/<serverName>/start
サポートされるメソッド
次の表にまとめているように、標準のHTTPメソッド・リクエストを使用して、リソースに対して基本的なCRUD操作(作成、読取り、更新、削除)を実行します。
HTTPメソッド | 説明 |
GET |
WebLogic Serverのリソースに関する情報を取得します。 |
POST |
WebLogic Serverのリソースを作成、更新または変更します。 |
OPTIONS |
WebLogicサーバー・リソースのオプションおよび要件に関する情報を取得します。 |
DELETE |
WebLogic Serverリソースを削除します。 |
メディア・タイプ
WebLogic Server REST APIでは、すべてのリクエスト本文およびレスポンス本文にメディア・タイプとしてapplication/json
が使用されます。
サポートされているヘッダー
次の表は、WebLogic ServerのRESTリクエストを送るために使用する必要がある標準ヘッダーを示しています。
ヘッダー | 説明 |
Accept:application/json |
クライアントがレスポンスにJSONを含めようとしていることを示します。このヘッダーはGET、POSTおよびDELETEメソッドを呼び出す場合に使用されます。 |
Content-Type:application/json |
クライアントがJSONを含むレスポンスを送っていることを示します。このヘッダーはPOSTメソッドに必要です。サポートされている他のコンテンツ・タイプ(たとえば、デプロイメントのアップロードする時)およびそれらがどのような場合にサポートされるかは、例に示されています。 |
X-Requested-By:MyClient |
REST経由でのクロスサイト・リクエスト・フォージェリ(CSRF)攻撃からの保護に使用されます。このヘッダーはPOSTおよびDELETEメソッドには必須で、OPTIONSおよびGETメソッドでは無視されます。 |