ジャンプ先

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

このWebサーバーの変更

post

/management/weblogic/{version}/edit/serverTemplates/{name}/webServer

このWebサーバーを変更します。

リクエスト

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

• application/json

パス・パラメータ

• name: string
  コレクション内のインスタンスのnameプロパティ。
• version: string
  WebLogic RESTインタフェースのバージョン。

ヘッダー・パラメータ

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

本文()

変更されたWebサーバー・モデルを含める必要があります。

ルート・スキーマ: Web Server

タイプ: object

ソースを表示

• acceptContextPathInGetRealPath(optional): boolean
  デフォルト値: false

  このサーバーでcontext.getRealPath()への仮想パスにコンテキスト・パスを含めることができるかどうかを示します。(チェックされている場合、contextPathと同じ名前のサブ・ディレクトリは使用できません)。これは互換性スイッチであり、9.0.0.0の将来のリリースで非推奨になる予定です。

  WebServerMBeanオブジェクトのacceptContextPathInGetRealPath属性を取得します。

• authCookieEnabled(optional): boolean
  デフォルト値: true

  authcookie機能が有効かどうかを示します。

  制約

  • セキュア・デフォルト: true
• chunkedTransferDisabled(optional): boolean
  デフォルト値: false

  HTTP/1.1のチャンク転送エンコーディングの使用が有効かどうかを示します。

• clientIpHeader(optional): string

  WebSerevrMBeanからクライアントIPヘッダーを取得します。

• defaultWebAppContextRoot(optional): string

  このWebサーバーにおけるデフォルトWebアプリケーションの元のcontext-rootを戻します。application.xmlまたはweblogic.xmlのcontext-root属性を使用して、デフォルトのWebアプリケーションを設定することもできます。デフォルトのWebアプリケーションへのcontext-rootは/です。""(空の文字列)が指定されている場合、Webサーバーではデフォルトで/に設定されます。

• deploymentOrder(optional): integer(int32)
  最小値: 0

  最大値: 2147483647

  デフォルト値: 1000

  デプロイの優先度。サーバーはこの値を使用して項目のデプロイ順を決定します。優先度は、同じタイプでデプロイ可能なアイテム間で決められます。

  たとえば、サーバーではすべてのEJBを優先度に従ってデプロイしてから、起動クラスを優先度に従ってデプロイします。

  「デプロイ順序」の値が小さい項目から順にデプロイされます。「デプロイ順序」の値が等しいデプロイメントの順序付けは保証されていません。クラスタ間の順序付けは保証されていません。

• dynamicallyCreated(optional): boolean
  読取り専用: true

  デフォルト値: false

  MBeanが動的に作成されたか、config.xmlに対して永続化されているかが返されます

• frontendHost(optional): string
  デフォルト値: oracle.doceng.json.BetterJsonNull@6c51c472

  リダイレクト対象のすべてのURLが送られるホストの名前。これを指定すると、WebLogic ServerはHOSTヘッダーの値ではなくこの値を使用するようになります。

  HTTP frontendHostを設定すると、リクエストがファイアウォールまたはプロキシ経由で届いている場合でもWebアプリケーションが常に正しいHOST情報を取得できるようにするための手法が提供されます。このパラメータを構成すると、HOSTヘッダーは無視され、かわりにこのパラメータの情報が使用されます。

• frontendHTTPPort(optional): integer(int32)
  デフォルト値: 0

  リダイレクト対象のすべてのURLが送られるHTTPポートの名前。これを指定すると、WebLogic ServerはHOSTヘッダーの値ではなくこの値を使用するようになります。

  フロントエンドHTTPポートを設定すると、リクエストがファイアウォールまたはプロキシ経由で届いている場合でもWebアプリケーションが常に正しいPORT情報を取得できるようにするための手法が提供されます。このパラメータを構成すると、HOSTヘッダーは無視され、かわりにこのパラメータの情報が使用されます。

• frontendHTTPSPort(optional): integer(int32)
  デフォルト値: 0

  リダイレクト対象のすべてのURLが送られるセキュアHTTPポートの名前。これを指定すると、WebLogic ServerはHOSTヘッダーの値ではなくこの値を使用するようになります。

  frontendHTTPSPortを設定すると、リクエストがファイアウォールまたはプロキシ経由で届いている場合でもWebアプリケーションが常に正しいPORT情報を取得できるようにするための手法が提供されます。このパラメータを構成すると、HOSTヘッダーは無視され、かわりにこのパラメータの情報が使用されます。

• httpsKeepAliveSecs(optional): integer(int32)
  最小値: 30

  最大値: 360

  デフォルト値: 60

  このサーバーで非アクティブなHTTPS接続を閉じるまでに待機する時間。

  リクエストをタイム・アウトするまでHTTPSキープアライブを維持する秒数。

  制約

  • セキュア・デフォルト: 60
• id(optional): integer(int64)
  読取り専用: true

  このMBeanインスタンスの一意のIDを返します

• keepAliveEnabled(optional): boolean
  デフォルト値: true

  このサーバーに永続的に接続している必要があるかどうかを示します。(これを設定することでWebアプリケーションのパフォーマンスが向上する必要があります。)

  WebServerMBeanオブジェクトのkeepAliveEnabled属性を取得します。

  制約

  • セキュア・デフォルト: true
• keepAliveSecs(optional): integer(int32)
  最小値: 5

  最大値: 3600

  デフォルト値: 30

  このサーバーで非アクティブなHTTP接続を閉じるまでに待機する時間。

  リクエストをタイム・アウトするまでHTTPキープアライブを維持する秒数。

  制約

  • セキュア・デフォルト: 30
• maxPostSize(optional): integer(int32)
  デフォルト値: -1

  このサーバーで許可される、サーブレット・リクエスト中のHTTP POSTおよびPUTデータの読取りに対する最大POSTサイズ。

  0より小さい値は、サイズが無制限であることを示します。

  WebServerMBeanオブジェクトのmaxPostSize属性を取得します。

• maxPostTimeSecs(optional): integer(int32)
  デフォルト値: -1

  サーブレット・リクエスト中のHTTP POSTデータの読取りに対する最大POST時間(単位は秒)。MaxPostTime < 0は無制限を意味します

  WebServerMBeanオブジェクトのmaxPostTimeSecs属性を取得します。

• maxRequestParameterCount(optional): integer(int32)
  デフォルト値: 10000

  このサーバーで許可される、サーブレット・リクエスト中の最大HTTP POSTパラメータ数の読取りに対する最大リクエスト・パラメータ数。

  WebServerMBeanオブジェクトのmaxRequestParameterCount属性を取得します。

• name(optional): string
  読取り専用: true

  このMBeanインスタンスのユーザー定義の名前。

  この名前は、MBeanのjavax.management.ObjectNameに、主要なプロパティとして含まれています

  Name=user-specified-name

  制約

  • 有効なnull
• notes(optional): string

  この構成の説明として任意に入力できる情報。

  WebLogic Serverは、ドメインの構成ファイル(config.xml)に、このメモをXML PCDATAとして保存します。すべての左山カッコ(<)はXMLエンティティ<に変換されます。キャリッジ・リターンとライン・フィードは維持されます。

  注意: 管理コンソールからメモを作成または編集した場合、キャリッジ・リターンとライン・フィードは維持されません。

• overloadResponseCode(optional): integer(int32)
  最小値: 100

  最大値: 599

  デフォルト値: 503

  アプリケーションが過負荷状態の場合に使用されるレスポンス・コードを取得します。アプリケーションは、保留中のリクエストの数がワーク・マネージャで指定された最大容量に到達した場合、またはサーバーのメモリーが少ない場合に、過負荷状態になる可能性があります。低メモリー条件は、OverloadProtectionMBean#getFreeMemoryPercentLowThreshold()を使用して決定されます。

• postTimeoutSecs(optional): integer(int32)
  最小値: 0

  最大値: 120

  デフォルト値: 30

  サーブレット・リクエスト中のHTTP POSTデータを読み取る際のタイムアウト(秒単位)。POSTデータがチャンク化されている場合は、データの最後のチャンクの受信完了からHTTP POSTの次のデータ・チャンクの受信完了までの間に、タイムアウトするまでこのサーバーが待機する時間(これは、POSTデータでサーバーを過負荷状態にしようとするサービス拒否攻撃を防止するために使用します。)

  WebServerMBeanオブジェクトのpostTimeoutSecs属性を取得します。

  制約

  • セキュア・デフォルト: 30
• sendServerHeaderEnabled(optional): boolean
  デフォルト値: false

  このサーバー名をHTTPレスポンスとともに送信するかどうかを示します。(これは、ヘッダーの領域に制限がある無線アプリケーションで便利です。)

  このサーバー・インスタンスが、サーバー名およびWebLogic Serverのバージョン番号をHTTPレスポンス・ヘッダーに含めるかどうかを示します。

  制約

  • セキュア・デフォルト: false
• singleSignonDisabled(optional): boolean
  デフォルト値: false

  singleSignonDisabled属性が有効かどうかを示します。

• tags(optional): array Items
  タイトル: Items

  この構成MBeanのすべてのタグを返します

• targets(optional): array Target References
  タイトル: Target References

  ターゲット参照の配列を含みます。

  現在のドメインでこの項目をデプロイできるターゲットのリストから、MBeanをデプロイするターゲットを選択する必要があります。ターゲットはサーバーまたはクラスタです。デプロイメントが重複している場合、デプロイメントは1回のみ行われます。

• type(optional): string
  読取り専用: true

  MBeanのタイプを戻します。

  制約

  • 収集不可
• useHeaderEncoding(optional): boolean
  デフォルト値: false

  制約

  • セキュア・デフォルト: false
• useHighestCompatibleHTTPVersion(optional): boolean
  デフォルト値: true

  レスポンスの中で、互換性のあるHTTPプロトコルのバージョン文字列のうち、最新のバージョンを使用できるようにします。たとえばHTTP仕様では、HTTP/1.0を使用したリクエストに対するレスポンスではHTTP/1.1のバージョン文字列を使用するのが望ましいとされています。これは、必ずしもレスポンス形式に影響するとはかぎりません。

• WAPEnabled(optional): boolean
  デフォルト値: false

  セッションIDにJVM情報を含めるかどうかを示します(URLのサイズを128文字に制限するWAPデバイスでURLの書換えを行う場合は、このボックスを選択することが必要な場合があります。また、これによりクラスタにおけるレプリケートされたセッションの使用に影響が及ぶ場合もあります)。このボックスを選択すると、URLのデフォルト・サイズは52文字に設定されます。また、特殊文字はURLに含まれなくなります。

  WebServerMBeanオブジェクトの「WAPの有効化」属性を取得します。

• writeChunkBytes(optional): integer(int32)
  読取り専用: true

  デフォルト値: 512

  ネットワーク・レイヤーに書き込まれるデフォルトのブロック・サイズ。

  WebServerMBeanオブジェクトのwriteChunkBytes属性を取得します。

{
    "type":"object",
    "properties":{
        "WAPEnabled":{
            "default":false,
            "type":"boolean",
            "description":"<p>Indicates whether the session ID should include JVM information. (Checking this box may be necessary when using URL rewriting with WAP devices that limit the size of the URL to 128 characters, and may also affect the use of replicated sessions in a cluster.) When this box is selected, the default size of the URL will be set at 52 characters, and it will not contain any special characters.</p><p>Gets the WAPEnabled attribute of the WebServerMBean object</p>"
        },
        "acceptContextPathInGetRealPath":{
            "default":false,
            "type":"boolean",
            "description":"<p>Indicates whether this server allows the inclusion of the context path in the virtual path to <code>context.getRealPath()</code>. (If checked, you cannot use sub directories with the same name as <code>contextPath</code>). This is a compatibility switch that will be deprecated 9.0.0.0 in future releases.</p><p>Gets the acceptContextPathInGetRealPath attribute of the WebServerMBean object</p>"
        },
        "authCookieEnabled":{
            "x-weblogic-secureDefault":true,
            "default":true,
            "type":"boolean",
            "description":"<p>Whether authcookie feature is enabled or not.</p><p><h5>Constraints</h5></p><ul><li>secure default : true</li></ul>"
        },
        "chunkedTransferDisabled":{
            "default":false,
            "type":"boolean",
            "description":"<p>Indicates whether the use of Chunk Transfer-Encoding in HTTP/1.1 is enabled.</p>"
        },
        "clientIpHeader":{
            "type":"string",
            "description":"<p>Get the Client IP Header from WebSerevrMBean.</p>"
        },
        "defaultWebAppContextRoot":{
            "type":"string",
            "description":"<p>Returns the original context-root for the default Web application for this Web server. Alternatively, you can use the context-root attributes in application.xml or weblogic.xml to set a default Web application. The context-root for a default Web application is /. If \"\" (empty string) is specified, the Web server defaults to /.</p>"
        },
        "deploymentOrder":{
            "default":1000,
            "minimum":0,
            "maximum":2147483647,
            "type":"integer",
            "format":"int32",
            "description":"<p>A priority that the server uses to determine when it deploys an item. The priority is relative to other deployable items of the same type.</p><p>For example, the server prioritizes and deploys all EJBs before it prioritizes and deploys startup classes.</p><p>Items with the lowest Deployment Order value are deployed first. There is no guarantee on the order of deployments with equal Deployment Order values. There is no guarantee of ordering across clusters.</p>"
        },
        "dynamicallyCreated":{
            "readOnly":true,
            "default":false,
            "type":"boolean",
            "description":"<p>Return whether the MBean was created dynamically or is persisted to config.xml</p>"
        },
        "frontendHTTPPort":{
            "default":0,
            "type":"integer",
            "format":"int32",
            "description":"<p>The name of the HTTP port to which all redirected URLs will be sent. If specified, WebLogic Server will use this value rather than the one in the HOST header.</p><p>Sets the frontendHTTPPort Provides a method to ensure that the webapp will always have the correct PORT information, even when the request is coming through a firewall or a proxy. If this parameter is configured, the HOST header will be ignored and the information in this parameter will be used in its place.</p>"
        },
        "frontendHTTPSPort":{
            "default":0,
            "type":"integer",
            "format":"int32",
            "description":"<p>The name of the secure HTTP port to which all redirected URLs will be sent. If specified, WebLogic Server will use this value rather than the one in the HOST header.</p><p>Sets the frontendHTTPSPort Provides a method to ensure that the webapp will always have the correct PORT information, even when the request is coming through a firewall or a proxy. If this parameter is configured, the HOST header will be ignored and the information in this parameter will be used in its place.</p>"
        },
        "frontendHost":{
            "default":null,
            "type":"string",
            "description":"<p>The name of the host to which all redirected URLs will be sent. If specified, WebLogic Server will use this value rather than the one in the HOST header.</p><p>Sets the HTTP frontendHost Provides a method to ensure that the webapp will always have the correct HOST information, even when the request is coming through a firewall or a proxy. If this parameter is configured, the HOST header will be ignored and the information in this parameter will be used in its place.</p>"
        },
        "httpsKeepAliveSecs":{
            "x-weblogic-secureDefault":60,
            "default":60,
            "minimum":30,
            "maximum":360,
            "type":"integer",
            "format":"int32",
            "description":"<p>The amount of time this server waits before closing an inactive HTTPS connection.</p><p>Number of seconds to maintain HTTPS keep-alive before timing out the request.</p><p><h5>Constraints</h5></p><ul><li>secure default : 60</li></ul>"
        },
        "id":{
            "readOnly":true,
            "type":"integer",
            "format":"int64",
            "description":"<p>Return the unique id of this MBean instance</p>"
        },
        "keepAliveEnabled":{
            "x-weblogic-secureDefault":true,
            "default":true,
            "type":"boolean",
            "description":"<p>Indicates whether there should be a persistent connection to this server. (This may improve the performance of your Web applications.)</p><p>Gets the keepAliveEnabled attribute of the WebServerMBean object</p><p><h5>Constraints</h5></p><ul><li>secure default : true</li></ul>"
        },
        "keepAliveSecs":{
            "x-weblogic-secureDefault":30,
            "default":30,
            "minimum":5,
            "maximum":3600,
            "type":"integer",
            "format":"int32",
            "description":"<p>The amount of time this server waits before closing an inactive HTTP connection.</p><p>Number of seconds to maintain HTTP keep-alive before timing out the request.</p><p><h5>Constraints</h5></p><ul><li>secure default : 30</li></ul>"
        },
        "maxPostSize":{
            "default":-1,
            "type":"integer",
            "format":"int32",
            "description":"<p>The maximum post size this server allows for reading HTTP POST and PUT data in a servlet request.</p><p>A value less than 0 indicates an unlimited size.</p><p>Gets the maxPostSize attribute of the WebServerMBean object</p>"
        },
        "maxPostTimeSecs":{
            "default":-1,
            "type":"integer",
            "format":"int32",
            "description":"<p>Max Post Time (in seconds) for reading HTTP POST data in a servlet request. MaxPostTime < 0 means unlimited</p><p>Gets the maxPostTimeSecs attribute of the WebServerMBean object</p>"
        },
        "maxRequestParameterCount":{
            "default":10000,
            "type":"integer",
            "format":"int32",
            "description":"<p>Max Request Parameter Count this server allows for reading maximum HTTP POST Parameters count in a servlet request.</p><p>Gets the maxRequestParameterCount attribute of the WebServerMBean object</p>"
        },
        "name":{
            "readOnly":true,
            "x-weblogic-legalNull":true,
            "type":"string",
            "description":"<p>The user-specified name of this MBean instance.</p><p>This name is included as one of the key properties in the MBean's <code>javax.management.ObjectName</code></p><p><code>Name=<i>user-specified-name</i></code></p><p><h5>Constraints</h5></p><ul><li>legal null</li></ul>"
        },
        "notes":{
            "type":"string",
            "description":"<p>Optional information that you can include to describe this configuration.</p><p>WebLogic Server saves this note in the domain's configuration file (<code>config.xml</code>) as XML PCDATA. All left angle brackets (<) are converted to the XML entity <code>&lt;</code>. Carriage returns/line feeds are preserved.</p><p>Note: If you create or edit a note from the Administration Console, the Administration Console does not preserve carriage returns/line feeds.</p>"
        },
        "overloadResponseCode":{
            "default":503,
            "minimum":100,
            "maximum":599,
            "type":"integer",
            "format":"int32",
            "description":"<p>Get the response code to be used when an application is overloaded. An application can get overloaded when the number of pending requests has reached the max capacity specified in the WorkManager or when the server is low on memory. The low memory condition is determined using OverloadProtectionMBean#getFreeMemoryPercentLowThreshold().</p>"
        },
        "postTimeoutSecs":{
            "x-weblogic-secureDefault":30,
            "default":30,
            "minimum":0,
            "maximum":120,
            "type":"integer",
            "format":"int32",
            "description":"<p>Timeout (in seconds) for reading HTTP POST data in a servlet request. If the POST data is chunked, the amount of time the server waits between the end of receiving the last chunk of data and the end of receiving the next chunk of data in an HTTP POST before it times out. (This is used to prevent denial-of-service attacks that attempt to overload the server with POST data.)</p><p>Gets the postTimeoutSecs attribute of the WebServerMBean object</p><p><h5>Constraints</h5></p><ul><li>secure default : 30</li></ul>"
        },
        "sendServerHeaderEnabled":{
            "x-weblogic-secureDefault":false,
            "default":false,
            "type":"boolean",
            "description":"<p>Indicates whether this server name is sent with the HTTP response. (This is useful for wireless applications where there is limited space for headers.)</p><p>Indicates whether this server instance includes its name and WebLogic Server version number in HTTP response headers.</p><p><h5>Constraints</h5></p><ul><li>secure default : false</li></ul>"
        },
        "singleSignonDisabled":{
            "default":false,
            "type":"boolean",
            "description":"<p>Indicates whether the singleSignonDisabled attribute is enabled</p>"
        },
        "tags":{
            "title":"Items",
            "type":"array",
            "items":{
                "type":"string",
                "description":""
            },
            "description":"<p>Return all tags on this Configuration MBean</p>"
        },
        "targets":{
            "title":"Target References",
            "type":"array",
            "items":{
                "title":"Target Reference",
                "type":"object",
                "properties":{
                    "identity":{
                        "title":"Identity",
                        "type":"array",
                        "items":{
                            "type":"string",
                            "description":""
                        },
                        "description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
                    }
                },
                "description":"Contains the target reference."
            },
            "description":"Contains the array of target references. <p>You must select a target on which an MBean will be deployed from this list of the targets in the current domain on which this item can be deployed. Targets must be either servers or clusters. The deployment will only occur once if deployments overlap.</p>"
        },
        "type":{
            "readOnly":true,
            "x-weblogic-unharvestable":true,
            "type":"string",
            "description":"<p>Returns the type of the MBean.</p><p><h5>Constraints</h5></p><ul><li>unharvestable</li></ul>"
        },
        "useHeaderEncoding":{
            "x-weblogic-secureDefault":false,
            "default":false,
            "type":"boolean",
            "description":"<p><h5>Constraints</h5></p><ul><li>secure default : false</li></ul>"
        },
        "useHighestCompatibleHTTPVersion":{
            "default":true,
            "type":"boolean",
            "description":"<p>Enables use of the highest compatible HTTP protocol version-string in the response. E.g. HTTP spec suggests that HTTP/1.1 version-string should be used in response to a request using HTTP/1.0. This does not necessarily affect the response format.</p>"
        },
        "writeChunkBytes":{
            "readOnly":true,
            "default":512,
            "type":"integer",
            "format":"int32",
            "description":"<p>The default size of the blocks to be written to the network layer.</p><p>Gets the writeChunkBytes attribute of the WebServerMBean object</p>"
        }
    },
    "description":""
}

ネストされたスキーマ: Items

タイプ: array

タイトル: Items

この構成MBeanのすべてのタグを返します

ソースを表示

• 配列: string

{
    "title":"Items",
    "type":"array",
    "items":{
        "type":"string",
        "description":""
    },
    "description":"<p>Return all tags on this Configuration MBean</p>"
}

ネストされたスキーマ: Target References

タイプ: array

タイトル: Target References

ターゲット参照の配列を含みます。

現在のドメインでこの項目をデプロイできるターゲットのリストから、MBeanをデプロイするターゲットを選択する必要があります。ターゲットはサーバーまたはクラスタです。デプロイメントが重複している場合、デプロイメントは1回のみ行われます。

ソースを表示

• 配列: object Target Reference
  タイトル: Target Reference

  ターゲット参照を含みます。

{
    "title":"Target References",
    "type":"array",
    "items":{
        "title":"Target Reference",
        "type":"object",
        "properties":{
            "identity":{
                "title":"Identity",
                "type":"array",
                "items":{
                    "type":"string",
                    "description":""
                },
                "description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
            }
        },
        "description":"Contains the target reference."
    },
    "description":"Contains the array of target references. <p>You must select a target on which an MBean will be deployed from this list of the targets in the current domain on which this item can be deployed. Targets must be either servers or clusters. The deployment will only occur once if deployments overlap.</p>"
}

ネストされたスキーマ: Target Reference

タイプ: object

タイトル: Target Reference

ターゲット参照を含みます。

ソースを表示

• identity(optional): array Identity
  タイトル: Identity

  DOC TEAM TBD - アイデンティティの説明 - 別のWLS RESTリソースへの参照です。

{
    "title":"Target Reference",
    "type":"object",
    "properties":{
        "identity":{
            "title":"Identity",
            "type":"array",
            "items":{
                "type":"string",
                "description":""
            },
            "description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
        }
    },
    "description":"Contains the target reference."
}

ネストされたスキーマ: Identity

タイプ: array

タイトル: Identity

DOC TEAM TBD - アイデンティティの説明 - 別のWLS RESTリソースへの参照です。

ソースを表示

• 配列: string

{
    "title":"Identity",
    "type":"array",
    "items":{
        "type":"string",
        "description":""
    },
    "description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
}

セキュリティ

• 管理者: 基本
  タイプ: basic

  説明: A user in the Admin security role.
• デプロイヤ: 基本
  タイプ: basic

  説明: A user in the Deployer security role.

トップに戻る

レスポンス

200レスポンス

トップに戻る