3.4.8. 管理 CLI での操作およびコマンドの使用

手順3.10 要求の作成、設定、および実行

1. 操作要求の構築

   操作リクエストを使用すると、管理モデルとの低レベルの対話が可能になります。サーバー設定を編集する制御方法を提供します。操作リクエストは 3 つの部分で構成されます。
   • スラッシュ(/)で始まる アドレス。
   • コロン(:)で始まる 操作名。
   • 括弧（）内の任意の パラメーター セット。

   1. アドレスの特定

      設定はアドレス指定可能なリソースの階層ツリーとして表されます。各リソースノードは異なる操作のセットを提供します。アドレスは、操作を実行するリソースノードを指定します。アドレスは以下の構文を使用します。

      /node-type=node-name

      • node-type は、リソースノード種別です。これは、設定 XML の要素名にマッピングされます。
      • node-name はリソースノード名です。これは、設定 XML の要素の name 属性にマッピングされます。
      • リソースツリーの各レベルは、スラッシュ(/)で区切ります。
      設定 XML ファイルを参照して、必要なアドレスを判断します。EAP_HOME/standalone/configuration/standalone.xml ファイルはスタンドアロンサーバーの設定を保持し、EAP_HOME/domain/configuration/domain.xml ファイルおよび EAP_HOME/domain/configuration/host.xml ファイルは管理対象ドメインの設定を保持します。
      注記

      ドメインモードで CLI コマンドを実行するには、ホストおよびサーバー仕様が必要です。例： /host=master/server=server-one/subsystem=logging

      例3.5 操作アドレスの例

      ロギングサブシステムで操作を実行するには、操作要求に以下のアドレスを使用します。

      /subsystem=logging

      Java データソースに対して操作を実行するには、操作要求に以下のアドレスを使用します。

      /subsystem=datasources/data-source=java

   2. 操作の特定

      操作は異なるタイプのリソースノードによって異なります。操作では、以下の構文を使用します。

      :operation-name

      • operation-name はリクエストする操作の名前です。
      スタンドアロンサーバーのリソースアドレスで read-operation-names 操作を使用して、利用可能な操作を一覧表示します。

      例3.6 利用可能な操作

      ロギングサブシステムのすべての利用可能な操作をリストするために、スタンドアロンサーバーの以下の要求を入力します。

      [standalone@localhost:9999 /] /subsystem=logging:read-operation-names
      {
          "outcome" => "success",
          "result" => [
              "add",
              "read-attribute",
              "read-children-names",
              "read-children-resources",
              "read-children-types",
              "read-operation-description",
              "read-operation-names",
              "read-resource",
              "read-resource-description",
              "remove",
              "undefine-attribute",
              "whoami",
              "write-attribute"
          ]
      }

   3. パラメーターの決定

      各操作では異なるパラメーターが必要な場合があります。
      パラメーターは以下の構文を使用します。

      (parameter-name=parameter-value)

      • parameter-name は、パラメーターの名前です。
      • parameter-value は、パラメーターの値です。
      • 複数のパラメーターはコンマ (,) で区切られます。
      必要なパラメーターを確認するには、リソースノードで read-operation-description コマンドを実行し、操作名をパラメーターとして渡します。詳細は、例3.7「操作パラメーターの決定」 を参照してください。

      例3.7 操作パラメーターの決定

      ロギングサブシステムで read-children-types 操作に必要なパラメーターを決定するには、以下のように read-operation-description コマンドを入力します。

      [standalone@localhost:9999 /] /subsystem=logging:read-operation-description(name=read-children-types)
      {
          "outcome" => "success",
          "result" => {
              "operation-name" => "read-children-types",
              "description" => "Gets the type names of all the children under the selected resource",
              "reply-properties" => {
                  "type" => LIST,
                  "description" => "The children types",
                  "value-type" => STRING
              },
              "read-only" => true
          }
      }

2. 完全操作要求の入力

   アドレス、操作、およびパラメーターが決定されたら、完全操作要求を入力します。

   例3.8 操作要求の例

   [standalone@localhost:9999 /] /subsystem=web/connector=http:read-resource(recursive=true)