1. コマンドライン・インタフェース
  2. Verbリファレンス
  3. EM CLI Verb
  4. modify_proxy

modify_proxy

Oracle Management Serverから管理エージェントへのHTTP(S)トラフィックを仲介するプロキシを変更します。

ノート:

このプロキシは、oracle_em_proxyターゲット・タイプとしてモデル化されます。

プロキシに関連付けられた管理エージェントは、次の2つの方法で変更できます。

  • 管理エージェント名を使用する方法。

  • 管理エージェント名のパターンを使用する方法。

現在、oracle_em_proxyターゲット・タイプのプロキシは、Oracle Management Serverから管理エージェントへのトラフィックでのみサポートされます。逆方向の(管理エージェントからOracle Management Serverに向かう)トラフィックの場合、プロキシ設定は、対応する管理エージェントのemd.propertiesファイルで指定できます。

書式

 emcli modify_proxy 
   -name="<name>"
    [-port=<port>]
    [-protocol=<http | https>]
    [-named_credential="<credential name>"]
    [
     [-agents="<name1>,<name2>,..."]
       |
       [
        [-add_agents="<name1>,<name2>,..."]
        [-delete_agents="<name1>,<name2>,..."]
       ]
    ]
    [
     [-agent_patterns="<name pattern1>,<name pattern2>,..."]
       |
       [
        [-add_agent_patterns="<name pattern1>,<name pattern2>,..."]
        [-delete_agent_patterns="<name pattern1>,<name pattern2>,..."]
      ]
    ]
    [
     [-excluded_agent_patterns="<name pattern1>,<name pattern2>,..."]

      |
      [
        [-add_excluded_agent_patterns="<name pattern1>,<name pattern2>,..."]
        [-delete_excluded_agent_patterns="<name pattern1>,<name pattern2>,..."]]
      ]
    ]

[ ]  indicates that the parameter is optional.

オプション

  • -name

    プロキシを識別する名前。

  • -port

    プロキシ・サービスを提供するプロキシ・ホストのポート。

  • -protocol

    プロキシが仲介するトラフィックで使用されるプロトコル。有効な値は次のとおりです。

    • http

    • https

  • -named_credential

    プロキシの認証で使用する名前付き資格証明の名前。

  • -agents

    プロキシが仲介する管理エージェントの名前のカンマ区切りリスト。エスケープ文字としてバックスラッシュ文字(\)を使用できます。指定した名前の管理エージェントが存在しない場合、無視されます。

  • -add_agents

    プロキシが仲介する追加の管理エージェントの名前のカンマ区切りリスト。指定した名前の管理エージェントが存在しない場合、無視されます。エスケープ文字としてバックスラッシュ文字(\)を使用できます。

  • -delete_agents

    プロキシが仲介しない管理エージェントの名前のカンマ区切りリスト。このリストは、名前によってすでにプロキシに関連付けられている管理エージェントのリストに加え、-add_agentsオプションを指定した場合、そこで指定されている管理エージェントのリストにも適用されます。エスケープ文字としてバックスラッシュ文字(\)を使用できます。

  • -agent_patterns

    プロキシが仲介する管理エージェントの名前のパターンのカンマ区切りリスト。パターンでは、次の2つのワイルドカード文字を使用できます。

    • アスタリスク文字(*)は、1つ以上の文字を表します

    • 疑問符文字(?)は、1つの文字を表します。

    • バックスラッシュ文字(\)は、エスケープ文字として使用します。

  • -add_agent_patterns

    プロキシが仲介する管理エージェントの名前の追加パターンのカンマ区切りリスト。これらのパターンでも、-agent_patternsオプションに適用されるものと同じワイルドカード文字を使用できます。

  • -delete_agent_patterns

    プロキシが仲介する管理エージェントの名前のパターンのリストから削除するパターンのカンマ区切りリスト。このリストは、すでにプロキシに関連付けられている管理エージェント名のパターンのリストに加え、-add_agent_patternsオプションを指定した場合、そこで指定されているパターンのリストに適用されます。

  • -excluded_agent_patterns

    プロキシに関連付けられた管理エージェント名のパターンによって識別される管理エージェントの名前から除外する必要のある管理エージェントの名前のパターンのカンマ区切りリスト。これらのパターンでも、-agent_patternsオプションに適用されるものと同じワイルドカード文字を使用できます。

  • -delete_excluded_agent_patterns

    プロキシに関連付けられた管理エージェント名のパターンによって識別される管理エージェントの名前から除外する必要のある管理エージェントの名前のパターンのリストから削除するパターンのカンマ区切りリスト。このリストは、すでにプロキシに関連付けられている管理エージェント名の除外パターンのリストに加え、-add_excluded_agent_patternsオプションを指定した場合、そこで指定されているリストにも適用されます。

例

例1

次のコマンドでは、us-proxy-1という名前で識別されるプロキシを、HTTPSトラフィックのみを許可するように変更します。

emcli modify_proxy
       -name="us-proxy-1"
       -protocol=https

例2

次のコマンドでは、us-proxy-1という名前で識別されるプロキシを、myhost001.us.example.com:3535およびmyhost002.us.example.com:3535管理エージェントに関連付けるように変更します。プロキシがすでにパターンを使用して他の管理エージェントに関連付けられている場合、それらのパターンおよび導出される管理エージェントのリストに変更はありません。

emcli modify_proxy
      -name="us-proxy-1"
      -format="name:script;column_separator:|"
      -agents="myhost001.us.example.com:3535,myhost002.us.example.com:3535