クラウドコンピューティングデバイスの API クエリーの定義

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む6読むのに数分

    • 検出パターンの作成または変更の一環として、[クラウド REST コール (Cloud REST Call)] 操作を使用して、Microsoft Azure や Amazon Web サービスなど、PaaS (Platform as a Service) タイプの構成アイテムから情報を抽出できます。

    始める前に

    必要なロール：pd_admin

    • 以下の操作を実行して、[クラウド REST コール (Cloud REST Call)] 操作を使用する構成アイテム (CI) のオペレーティングシステムがロジカルデータセンターの OS タイプ [cmdb_ci_logical_datacenter] を拡張することを確認します。
      1. CI パターンの [基本] タブに移動します。
      2. この CI のオペレーティングシステムを書き留めます。
      3. 移動先 システム定義 > テーブル.
      4. 検索フィールドを [ラベル] に設定し、パターンの [基本] タブに記されているとおりにオペレーティングシステムの名前を入力します。
      5. リストからオペレーティングシステムを見つけ、ロジカルデータセンターが [拡張テーブル] 列に表示されていることを確認します。
    • 関連するパターンステップに移動します。
      1. パターンフォームで、ディスカバリー の関連する識別セクションを選択します。

        または、サービスマッピング の関連する識別セクションまたは接続セクションを選択します。

      2. 関連するパターンステップを選択するか、ステップを追加するボタン をクリックしてステップを追加します。

    プログラミングの基礎知識が望ましいです。

    このタスクについて

    PaaS CI の検出に使用するパターンで [クラウド REST コール (Cloud REST Call)] 操作を展開します。

    [クラウド REST コール (Cloud REST Call)] 操作を使用してクエリーするデバイスのクエリー構文を入手するには、メーカーから提供されている API 関連の公式ドキュメントを参照してください。例：

    手順

    1. [操作] リストから [クラウド REST コール (Cloud REST Call)] を選択します。
    2. 必要に応じてクエリーパラメーターを定義します。
      警告:
      「パターン操作のカスタマイズ」で説明されているようにこの運用をカスタマイズした場合は、クエリーパラメーターが異なる場合があります。
      フィールド 説明
      URL Microsoft Azure または Amazon Web Services の公式ドキュメントの説明に従って URL を指定します。変数を使用できます。

      変数を使用できます。「パターンへの値と変数の入力」で説明されているように、表形式変数の特定のフィールドの値を入力することもできます。
      手法

      メソッドの値を、「GET」のようなすべて大文字の文字列で入力します。サポートされているメソッドは次のとおりです。

      • GET
      • POST
      • PUT

      詳細については、関連する API ガイドを参照してください。API ドキュメントに HTTP クエリーメソッドが明確に記載されている場合は、GET メソッドを使用します。
      本文 (オプション) 要求本文を文字列として入力します。

      文字列に引用符が含まれている場合は、引用符の前に円記号を使用して、文字列が引用符で終わっていないことを示します。
      ヘッダー (オプション) 関連する API ドキュメントで、HTTP ヘッダーの送信が必須であると述べられている場合は、該当するヘッダーを次の形式で入力します：

      Header_name1:header_value1,header_name2:header_value2

      たとえば、「Content-Type:xml」と入力します。
    3. コマンド出力全体を変数として保存するには、「6」で説明されているように [解析を定義] リストから [なし] を選択し、変数を定義します。
    4. [解析を定義] リストから解析戦略を選択します。
      解析戦略 説明

      Oracle

      LDAP ファイル

      XML ファイル

      INI ファイル

      プロパティファイル

      JSON ファイル (カスタム)

      		 ホリゾンタルファイル解析戦略です (バーティカルではありません)。この解析戦略は、テキストファイルにのみ使用できます。詳細については、「ホリゾンタルファイルのテキストの解析」を参照してください。
      バーティカルファイル 各データセットが複数の行にまたがる構造化テキストファイルからテキストを取得します。詳細については、「バーティカルファイルのテキストの解析」を参照してください。

      キーワードの後

      特定のキーワードの直後にあるテキストを取得します。詳細については、「キーワード、コマンドおよび位置タイプを使用したテキストの解析」を参照してください。

      コマンドライン Java スタイル

      Java スタイルのパラメーターを使用してコマンドラインパラメーターの値を取得します。詳細については、「キーワード、コマンドおよび位置タイプを使用したテキストの解析」を参照してください。

      コマンドライン Unix スタイル

      標準の Unix パラメーターを使用してコマンドラインパラメーターの値を取得します。詳細については、「キーワード、コマンドおよび位置タイプを使用したテキストの解析」を参照してください。

      末尾からの位置

      行の末尾からの位置で指定されたテキストを取得します。詳細については、「キーワード、コマンドおよび位置タイプを使用したテキストの解析」を参照してください。

      開始からの位置

      行の開始からの位置で指定されたテキストを取得します。詳細については、「キーワード、コマンドおよび位置タイプを使用したテキストの解析」を参照してください。
      正規表現 正規表現で指定されたテキストを取得します。このオプションは、正規表現の Java 構文に精通している必要があります。詳細については、「正規表現を使用したテキストの解析」を参照してください。
      区切り付きテキスト 区切り文字と行内の位置で指定されたテキストを取得します (汎用テキストファイルからテキストを取得する最も一般的な方法です)。「区切り付きテキストを使用したテキストの解析」を参照してください。
    5. デバッグモードで作業している場合は、次のように解析基準を定義します。
      1. [操作を実行] をクリックして、[出力] ペインで結果を確認します。
      2. [出力] ペインで、変数に含めるテキストまたは記号をマークします。
      3. 変数名ボックスに、新しい変数の名前を入力します (例：「process_name」)。

        [出力] ペインでマークされた文字列の変数名の定義
      4. Enter キーを押します。
        新しい変数が [変数] ペインに追加されます。
    6. デバッグモードで作業していない場合は、次の手順を実行して解析基準を定義します。
      1. [変数] ペインで、[変数を追加] をクリックし、新しい変数の名前を入力します。
      2. [詳細] アイコンをクリックします。

        詳細変数ペインを表示します。
      3. [列ラベルを追加] をクリックします。
      4. 解析クエリーを入力します。
      5. 区切り文字の値を入力します。
      6. 位置の値を入力します。
    7. 結果が見つからない場合は、[終了] を選択して検出を停止します。
    8. デバッグモードの場合は、[テスト] をクリックしてステップをテストし、操作が期待した結果をもたらすかどうかをチェックします。

    例

    この操作の使用場所 対象アイテム
    階層 アプリケーション
    CI タイプ ロードバランサーサービス [cmdb_ci_lb_service]
    パターン Amazon AWS 可変ロードバランサーサービス
    セクション AWS ロードバランサーサービス
    ステップ番号とステップ名 2. 最初の 100 RDS インスタンスを取得する

    [クラウド REST コール (Cloud REST Call)] 操作を使用して、Amazon クラウドの us-west-2 リージョンで実行されているデータベースインスタンスに関する情報を抽出します。


    [クラウド REST コール (Cloud REST Call)] 操作

    次のタスク