REST Webサービスクイック アクションを実行する
2 min
アプリケーションは、クイック アクションで Web サービスを利用するためのいくつかのオプションを提供します。
- SOAP Web サービスには、 Webサービスクイック アクションを実行する を使用します。
- 単純な認証を使用する必要がある場合は、REST API Web サービスに REST Webサービスクイック アクションを実行する を使用します。
- 認証ヘッダーを含む REST API Web サービスには、 Web 申請 クイック アクション を使用します。
REST Web Service の実行クイック アクションについて
REST Web Service の実行クイック アクション を使用すると、基本認証を使用し、選択したフィールドにエラー メッセージを保存できます。 この クイック アクション では、アクション内から証明書エラーを無視することはできません。 アクションでの REST Web サービスの使用に関する詳細については、 Ivanti コミュニティ フォーラムの記事を参照してください。
REST Web サービスの実行 クイック アクションは、クラシック アクション デザイナでのみ使用できます。
実行REST Webサービスクイック アクションの使用
REST Web サービスの実行 クイック アクション は単体で、または複合 クイック アクション で使用します。
- クラシック アクション デザイナから、 新規アクションの作成 タブを選択します。
- REST Web サービスの実行 クイック アクション をスタンドアロン アクションまたは複合アクションとして使用します。
- スタンドアロン アクションのための REST Web サービスの実行 クイック アクション を選択します。
- 複合アクションで REST Web サービスの実行 クイック アクション を使用するには:
- 「新規アクションの追加 」ドロップダウン メニューから「REST Web サービスの実行」を選択します。
- 追加アイコン (+) を選択して、複合アクションに追加します。
- パラメータを入力します:
- アクション名を入力してください: アクションの一意の名前を入力します。
- アクションの説明を入力します: (オプション) アクションの実行内容を説明します。
- カテゴリを入力: (オプション) アクションを保存するカテゴリを入力します。
- URL: 対象 Web サービスの REST API URL を入力します。
- 基本認証: 基本認証を使用し、ユーザー ID とパスワードを要求する場合に選択します。 Web 申請クイック アクション は Authorization ヘッダーを使用します。
- ドメイン名: API のドメイン名を入力します。
- ユーザー ID: 有効なユーザ名または ID を入力してください。
- パスワード: ユーザー ID の有効なパスワードを入力します。
- 申請タイプ: このアクションの Web サービス メソッド (GET、POST、PUT、PATCH、または DELETE) を選択します。
- エンドポイント: パラメータを中括弧 { } で囲んで、API リクエストのエンドポイントを入力します。 例えば: 例/api/ この場合、 id はエンドポイント パラメータです。
- 結果タイプ: 詳細設定 で 結果を次のように保存するフィールドが使用される場合、変数の予想されるデータ型を選択します: テキスト、数値、ブール値、Raw、JSON、または XML。
- 結果の保存先: アプリケーションが結果を保存するフィールドを指定します。
- エラー メッセージの保存: アプリケーションが Web サービス エラーを保存するフィールドを入力します。
- ヘッダーパラメータ: リクエストヘッダーに送信するパラメータを入力します。
- 標準パラメータ: リクエスト本文に送信するパラメータを入力します。 リクエスト本体全体を 1 つの標準パラメータ内に提供します。
- エンドポイント パラメータ: エンドポイント フィールドにあるパラメータを入力します。 パラメータの名前はエンドポイント フィールドの名前と一致する必要があります。
- サーバーからの応答を他の クイック アクションで使用できる変数として保存するには、 詳細設定 を完了します。
- 結果を次のように保存します: API 呼び出しの結果を保存する変数を作成します。
結果タイプ パラメータは、この変数のデータ型を設定します。 結果タイプを選択しない場合、変数は結果をテキストとして保存します。
- 戻りコードを次のように保存します: HTTP ステータス コードを保存するテキスト変数を作成します。
- ヘッダーを次のように保存します: 応答ヘッダーを保存するテキスト変数を作成します。
- 設定を確定するには「 保存 」を選択し、保存せずに終了するには「 キャンセル 」を選択します。
