# スケジュール一覧を入手する

チームの RPA スケジュールをページ単位で一覧します。
- **副作用**：なし。読み取り専用。バックオフを入れれば安全にリトライできます。
- **用途**：各スケジュールの `taskState` が `/cloudphone/rpa/task/cancel` の完了シグナルです。

Endpoint: POST /api/cloudphone/rpa/task/page
Version: 2026-09-05

## Request fields (application/json):

  - `enabled` (boolean | null)
    スケジュールが有効かどうか

  - `searchKey` (string | null)
    スケジュール名、説明、テンプレートタイトルを対象にしたあいまい検索

  - `taskState` (integer | null)
    スケジュールの状態；0：実行待ち；1：実行中；2：実行完了 3：キャンセル

  - `pageNo` (integer | null)
    デフォルト：1

  - `pageSize` (integer | null)
    デフォルト：10

## Response 200:

  - `200` (unknown)
    成功。`data.dataList` は要求されたページのレコードで、一致するものがない場合は空配列です。`data.total`、`data.current`、`data.pages` はページング情報を示します。

## Response 200 fields (application/json):

  - `code` (integer, required)
    応答コード。0は成功、>0は失敗を示す。

  - `msg` (string | null, required)
    エラーメッセージ

  - `requestId` (string, required)
    トレースIDをリクエスト

  - `data` (object, required)

  - `data.dataList` (array, required)
    計画リスト

  - `data.dataList.id` (string)
    スケジュールID

  - `data.dataList.taskName` (string)
    スケジュールタスク名

  - `data.dataList.createMember` (string, required)
    メンバー名

  - `data.dataList.enabled` (boolean)
    有効かどうか

  - `data.dataList.endTime` (string)
    タスク終了時刻

  - `data.dataList.failCount` (integer)
    失敗した実行回数

  - `data.dataList.handleTime` (string)
    実行開始時刻

  - `data.dataList.notes` (string)
    スケジュールに関する注意事項

  - `data.dataList.scheduleConfig` (string)
    タスクスケジュールの設定

  - `data.dataList.successCount` (integer)
    実行成功回数

  - `data.dataList.taskPreviewTimeTable` (array)

  - `data.dataList.taskPreviewTimeTable.cloudPhoneId` (string)
    クラウド電話ID

  - `data.dataList.taskPreviewTimeTable.cloudPhoneName` (string)
    クラウドフォン名

  - `data.dataList.taskPreviewTimeTable.times` (array)
    実行時間一覧

  - `data.dataList.taskState` (integer)
    スケジュールされたタスクの状態。0:待機中、1:実行中、2:完了、3:キャンセル

  - `data.dataList.templateId` (string)
    テンプレートID

  - `data.dataList.templateTitle` (string)
    テンプレートタイトル

  - `data.current` (string, required)
    現在のページ番号

  - `data.pages` (string, required)
    総ページ数

  - `data.total` (string, required)
    合計数