SchedulerX:HTTP ジョブ

GET

1. アクセス可能な HTTP サービスをデプロイします。

   • アクセス可能な HTTP サービスがすでにデプロイされている場合は、ステップ 2 を実行して、マイクロサービスエンジン (MSE) コンソールで HTTP ジョブを作成します。HTTP サービスの URL、リクエストメソッド (GET または POST)、およびその他の構成情報を準備する必要があります。

   • アクセス可能な HTTP サービスがデプロイされていない場合は、Java ベースの HTTP インターフェースを呼び出してデプロイします。サンプルコード：

     @GET
     @Path("hi")
     @Produces(MediaType.APPLICATION_JSON)
     public RestResult hi(@QueryParam("user") String user) {
         TestVo vo = new TestVo();
         vo.setName(user);
         RestResult result = new RestResult();
         result.setCode(200);
         result.setData(vo);
         return result;
     }

2. MSE コンソール にログオンし、SchedulerX バージョンページで HTTP ジョブを作成します。

   次の図は、GET メソッドを使用する HTTP ジョブの構成を示しています。スケジューリングジョブの作成方法の詳細については、「ジョブを作成する」をご参照ください。

   

次の表に、サーバーレス HTTP ジョブとエージェント HTTP ジョブのパラメーターを示します。

POST

1. アクセス可能な HTTP サービスをデプロイします。

   • アクセス可能な HTTP サービスがすでにデプロイされている場合は、ステップ 2 を実行して、MSE コンソールで HTTP ジョブを作成します。HTTP サービスの URL、リクエストメソッド (GET または POST)、およびその他の構成情報を準備する必要があります。

   • アクセス可能な HTTP サービスがデプロイされていない場合は、Java ベースの HTTP インターフェースを呼び出してデプロイします。サンプルコード：

     import com.alibaba.schedulerx.common.constants.CommonConstants;
     
     @POST
     @Path("createUser")
     @Produces(MediaType.APPLICATION_JSON)
     public RestResult createUser(@FormParam("userId") String userId, 
             @FormParam("userName") String userName) {
         TestVo vo = new TestVo();
         System.out.println("userId=" + userId + ", userName=" + userName);
         vo.setName(userName);
         RestResult result = new RestResult();
         result.setCode(200);
         result.setData(vo);
         return result;
     }

2. MSE コンソール にログオンし、SchedulerX バージョンページで HTTP ジョブを作成します。

   次の図は、POST メソッドを使用する HTTP ジョブの構成を示しています。スケジューリングジョブの作成方法の詳細については、「ジョブを作成する」をご参照ください。

   次の表に、サーバーレス HTTP ジョブとエージェント HTTP ジョブのパラメーターを示します。

   説明

   MSE コンソールでのサーバーレスモードとエージェントモードのパラメーターは同じです。

   パラメーター	説明
   [タスク名]	ジョブのカスタム名。
   [説明]	ジョブの説明。後続のクエリを容易にするために、簡単な言葉を使用することをお勧めします。
   [アプリケーション ID]	ジョブが属するアプリケーションの ID。ドロップダウンリストから値を選択します。
   [タスクタイプ]	ジョブのタイプ。この例では、Http を選択します。
   [フル URL]	http または https で始まる完全な URL を入力します。
   [リクエストメソッド]	リクエストメソッド。GET または POST を選択します。
   [レスポンス分析モード]	レスポンスを解析するモード。有効な値： HTTP レスポンスコード このモードを選択した場合、HTTP レスポンスコードが返されます。標準の HTTP レスポンスコードを構成する必要があります。 カスタム JSON このモードを選択した場合は、戻り値チェックキーと戻り値チェック値パラメーターを構成する必要があります。 デフォルトでは、JSON 形式の HTTP レスポンスがサーバーから返されます。システムは、指定した戻り値チェックキーと値に基づいて、リクエストが成功したかどうかを確認します。 { "code": 200, "data": "true", "message": "", "requestId": "446655068791923614103381232971", "success": true } 上記のサンプルコードでは、success キーの値が true、または code キーの値が 200 の場合、システムはリクエストが成功したと判断します。 カスタム文字列 このモードを選択した場合、戻り文字列が指定したカスタム文字列と一致する場合、システムはリクエストが成功したと判断します。
   [レスポンス分析モード] パラメーターを [HTTP レスポンスコード] に設定した場合：
   [HTTP レスポンスコード]	HTTP レスポンスコード。デフォルト値：200。
   [レスポンス分析モード] パラメーターを [カスタム JSON] に設定した場合：
   [戻り値チェックキー]	リクエストが成功したかどうかを判断するために使用される戻りキー。JSON 形式のレスポンスのみがサポートされています。
   [戻り値チェック値]	リクエストが成功したかどうかを判断するために使用される戻り値。JSON 形式のレスポンスのみがサポートされています。
   [レスポンス分析モード] パラメーターを [カスタム文字列] に設定した場合：
   [カスタム文字列]	指定したカスタム文字列。
   [実行タイムアウト]	実行タイムアウト期間。 実行方法を serverless に設定した場合、最大タイムアウト期間は Basic エディションで 30 秒、Professional エディションで 120 秒です。 実行方法を agent に設定した場合、タイムアウト期間に制限はありません。
   [ContentType]	[リクエストメソッド] パラメーターを [POST] に設定した場合のリクエストのデータ型。有効な値： application/x-www-form-urlencoded application/json
   [POST パラメーター]	[リクエストメソッド] パラメーターを [POST] に設定した場合の POST フォームパラメーター。 [ContentType] パラメーターを application/x-www-form-urlencoded に設定した場合の例： key1=value&key2=value2 [ContentType] パラメーターを application/json に設定した場合の例： {"key1":"val1","key2":"val2"}
   [Cookie]	キーと値のペア。例： key1=val1;key2=val2。複数のキーと値のペアはセミコロン (;) で区切ります。値の最大長は 300 バイトです。
   [実行方法]	serverless：サーバーがリクエストを開始します。インターネット経由でアクセスできる URL が必要です。 agent：エージェントがリクエストを開始します。リクエストを開始するには、V1.8.2 以降の SchedulerX エージェントをインストールする必要があります。内部 URL を構成できます。
   詳細構成
   [タスク失敗時の再試行回数]	ジョブの実行に失敗した後の再試行回数。デフォルト値：0。
   [タスク失敗時の再試行間隔]	失敗したジョブ間の再試行間隔。デフォルト値：30。単位：秒。
   [タスクの同時実行性]	同じジョブに対して同時に実行できるインスタンスの最大数。値 1 は、一度に 1 つのジョブインスタンスのみが許可されることを示します。スケジューリングジョブに対して同時に実行されるインスタンスの数が指定された値を超えると、スケジューリングジョブはスキップされます。
   [クレンジング戦略]	ジョブの実行中に生成された履歴レコードをクリアするために使用される戦略。デフォルト値：最後の N エントリを保持。N は [保持数] パラメーターの値によって指定されます。有効な値： 最後の N エントリを保持 ステータス別に最後の N エントリを保持
   [保持数]	ジョブの実行後に保持される履歴レコードの数。デフォルト値：300。