すべてのプロダクト
Search

このプロダクト

    PolarDB:UpdatePolarClawCronJob

    ドキュメントセンター

    PolarDB:UpdatePolarClawCronJob

    最終更新日:Apr 29, 2026

    PolarClaw 定期タスクの構成を更新します。一部のフィールドのみを更新できます。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエスト構文

    POST  HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ApplicationId

    string

    必須

    アプリケーション ID。

    pa-xxx
    JobId

    string

    必須

    更新する定期タスクの ID。

    0ee00f56-f467-4d41-858c-ca4ede2c770e
    Name

    string

    任意

    タスクの新しい名前。

    afternoon-report
    Schedule

    object

    任意

    スケジューリング構成。

    {"Kind":"cron","Expr":"0 12 * * *","Tz":"America/New_York"}
    Kind

    string

    任意

    スケジュールタイプ。

    cron
    Expr

    string

    任意

    cron 式。

    0 9 * * *
    Tz

    string

    任意

    タイムゾーン。

    Asia/Shanghai
    StaggerMs

    integer

    任意

    決定論的ジッターウィンドウ（ミリ秒単位）。

    0
    EveryMs

    integer

    任意

    間隔（ミリ秒単位）。このパラメーターは Schedule.Kind が every の場合に必須です。

    100000
    AnchorMs

    integer

    任意

    間隔配置用の基準タイムスタンプ（ミリ秒単位）。

    1777370572518
    At

    string

    任意

    ISO 8601 タイムスタンプ。Schedule.Kind が at の場合に必須です。例：2026-04-10T09:00:00+08:00。

    2026-04-10T09:00:00+08:00
    SessionTarget

    string

    任意

    新しいセッションターゲット。

    isolated
    WakeMode

    string

    任意

    新しいウェイクモード。

    now
    Payload

    object

    任意

    新しいペイロード構成。

    {"Kind":"agentTurn","Message":"Updated: Generate afternoon report."}
    Kind

    string

    任意

    ペイロードタイプ。有効な値は、agentTurn（エージェント会話）または systemEvent（システムイベント）です。

    agentTurn
    Message

    string

    任意

    エージェント会話のプロンプト。Payload.Kind が agentTurn の場合に必須です。

    Generate the daily report and send it to the team.
    Text

    string

    任意

    システムイベントのテキスト。Payload.Kind が systemEvent の場合に必須です。

    Send a reminder to the user.
    Model

    string

    任意

    モデルオーバーライド。

    anthropic/sonnet-4.6
    Fallbacks

    array

    任意

    フォールバックモデルのリスト。

    string

    任意

    フォールバックモデル。

    modelA
    Thinking

    string

    任意

    思考レベル。有効な値：off、minimal、low、medium、high、および xhigh。

    medium
    TimeoutSeconds

    integer

    任意

    実行タイムアウト（秒単位）。

    10
    LightContext

    boolean

    任意

    軽量コンテキストを使用するかどうかを指定します。

    false
    Deliver

    boolean

    任意

    出力をチャンネルに配信するかどうかを指定します。

    false
    Channel

    string

    任意

    配信チャンネルの ID。

    telegram
    To

    string

    任意

    配信先。

    team
    BestEffortDeliver

    boolean

    任意

    配信失敗を無視するかどうかを指定します。

    AgentId

    string

    任意

    タスクを実行するエージェントの ID。

    work
    SessionKey

    string

    任意

    セッションルーティングキー。

    agent:main:feishu:direct:***
    Description

    string

    任意

    タスクの新しい説明。

    Daily report generation
    Enabled

    boolean

    任意

    タスクが有効かどうかを指定します。

    false
    DeleteAfterRun

    boolean

    任意

    初回実行後にタスクを削除するかどうかを指定します。

    true
    Delivery

    object

    任意

    結果配信構成。

    {"Mode":"announce","Channel":"telegram"}
    Mode

    string

    任意

    配信モード。有効な値：none、announce、および webhook。

    announce
    Channel

    string

    任意

    配信チャンネル。

    telegram
    AccountId

    string

    任意

    チャンネルのアカウント ID。

    accountId123
    To

    string

    任意

    配信先。Delivery.Mode が webhook の場合は必須で、URL である必要があります。

    https://example.com/webhook
    BestEffort

    boolean

    任意

    配信失敗を無視するかどうかを指定します。

    false
    FailureAlert

    object

    任意

    失敗時のアラート構成。false を設定すると、アラートが無効になります。

    {"After":3,"Channel":"telegram"}
    After

    integer

    任意

    アラートを送信するまでの連続失敗回数。

    3
    Channel

    string

    任意

    アラートチャンネル。

    email
    AccountId

    string

    任意

    チャンネルのアカウント ID。

    accountId123
    To

    string

    任意

    アラート送信先。

    user@example.com
    CooldownMs

    integer

    任意

    2 回のアラート間の最小間隔（ミリ秒単位）。

    5000
    Mode

    string

    任意

    アラートモード。有効な値：announce および webhook。

    announce
    Restart

    boolean

    任意

    更新後にゲートウェイを再起動するかどうかを指定します。デフォルト値：true。

    true

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答スキーマ。

    RequestId

    string

    リクエスト ID。

    2281C6C9-CBAB-1AFD-8400-670750CF6025_2212
    Message

    string

    成功メッセージ。

    successful
    Code

    integer

    HTTP ステータスコード。

    200
    ApplicationId

    string

    アプリケーション ID。

    pa-**************
    Ok

    boolean

    操作が成功したかどうかを示します。

    true
    Job

    object

    更新されたタスクの詳細。

    Id

    string

    タスク ID（UUID）。

    0ee00f56-f467-4d41-858c-ca4ede2c770e
    Name

    string

    タスク名。

    daily-report
    Enabled

    boolean

    タスクが有効かどうかを示します。

    false
    DeleteAfterRun

    boolean

    初回実行後にタスクが削除されるかどうかを示します。

    false
    CreatedAtMs

    integer

    作成タイムスタンプ（ミリ秒単位）。

    1777368967284
    UpdatedAtMs

    integer

    最終更新タイムスタンプ（ミリ秒単位）。

    1777370572517
    Schedule

    object

    スケジュール構成。

    Kind

    string

    スケジュールタイプ。有効な値：cron（cron 式）、every（固定間隔）、または at（1 回限り）。

    cron
    Expr

    string

    cron 式。Kind が cron の場合に必須です。

    0 9 * * *
    Tz

    string

    IANA タイムゾーン（例：Asia/Shanghai）。

    Asia/Shanghai
    EveryMs

    integer

    間隔（ミリ秒単位）。Kind が every の場合に必須です。

    100000
    AnchorMs

    integer

    間隔配置用の基準タイムスタンプ（ミリ秒単位）。

    1777370572518
    At

    string

    ISO 8601 タイムスタンプ。Kind が at の場合に必須です。

    2026-04-10T09:00:00+08:00
    SessionTarget

    string

    セッションターゲット。有効な値：main、isolated、または current。

    main
    WakeMode

    string

    ウェイクモード。有効な値：now または next-heartbeat。

    now
    Payload

    object

    実行ペイロード構成。

    Kind

    string

    ペイロードタイプ。有効な値：agentTurn（エージェント会話）または systemEvent（システムイベント）。

    agentTurn
    Message

    string

    エージェント会話のプロンプト。

    Generate the daily report.
    Text

    string

    システムイベントのテキスト。

    Generate the daily report.
    Model

    string

    モデルオーバーライド。

    anthropic/sonnet-4.6
    TimeoutSeconds

    integer

    オプションの実行タイムアウト（秒単位）。

    10
    LightContext

    boolean

    軽量コンテキストを使用するかどうかを示します。

    false
    Deliver

    boolean

    出力をチャンネルに配信するかどうかを示します。

    false
    Channel

    string

    オプションの配信チャンネル ID。

    telegram
    To

    string

    オプションの配信先。

    team
    BestEffortDeliver

    boolean

    配信失敗を無視するかどうかを示します。

    false
    AgentId

    string

    タスクを実行するエージェントのオプション ID。

    work
    SessionKey

    string

    オプションのセッションルーティングキー。

    abc123
    Description

    string

    オプションのタスク説明。

    Daily report generation
    Delivery

    object

    オプションの結果配信構成。

    Mode

    string

    配信モード。有効な値：none、announce、または webhook。

    announce
    Channel

    string

    配信チャンネル。

    telegram
    AccountId

    string

    オプションのチャンネルアカウント ID。

    default
    To

    string

    配信先。Mode が webhook の場合は必須で、URL である必要があります。

    https://example.com/webhook
    BestEffort

    boolean

    配信失敗を無視するかどうかを示します。

    State

    object

    タスクの実行状態。

    NextRunAtMs

    integer

    次回実行のタイムスタンプ（ミリ秒単位）。

    1777424400000
    LastRunAtMs

    integer

    前回実行のタイムスタンプ（ミリ秒単位）。

    1777370544931
    LastRunStatus

    string

    前回実行のステータス（オプション）。

    ok
    ConsecutiveErrors

    integer

    連続失敗回数。

    0
    Runs

    array<object>

    実行履歴。IncludeRuns が true の場合にのみ返されます。

    array<object>

    1 回のタスク実行の詳細。

    Ts

    integer

    実行タイムスタンプ（ミリ秒単位）。

    1777370572518
    JobId

    string

    関連付けられたタスク ID。

    0ee00f56-f467-4d41-858c-ca4ede2c770e
    Action

    string

    実行された操作。有効な値：finished、error、または skipped。

    finished
    Status

    string

    実行ステータス。有効な値：ok、error、または skipped。

    ok
    Summary

    string

    実行のまとめテキスト。

    Report generated successfully.
    Delivered

    boolean

    結果が配信されたかどうかを示します。

    true
    DeliveryStatus

    string

    配信ステータス。

    delivered
    SessionId

    string

    関連付けられたセッション ID。

    abc123
    RunAtMs

    integer

    実際の実行タイムスタンプ（ミリ秒単位）。

    1777370544931
    DurationMs

    integer

    実行時間（ミリ秒単位）。

    27586
    NextRunAtMs

    integer

    次回予定実行のタイムスタンプ（ミリ秒単位）。

    1777424400000
    Model

    string

    実行に使用されたモデル。

    anthropic/sonnet-4.6
    Provider

    string

    モデルプロバイダー。

    anthropic
    Usage

    object

    オプションのトークン使用量の詳細。

    InputTokens

    integer

    入力トークン数。

    30250
    OutputTokens

    integer

    出力トークン数。

    30250
    TotalTokens

    integer

    トークン総数。

    60500
    JobName

    string

    タスク名。

    daily-report

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "2281C6C9-CBAB-1AFD-8400-670750CF6025_2212",
  "Message": "successful",
  "Code": 200,
  "ApplicationId": "pa-**************",
  "Ok": true,
  "Job": {
    "Id": "0ee00f56-f467-4d41-858c-ca4ede2c770e",
    "Name": "daily-report",
    "Enabled": false,
    "DeleteAfterRun": false,
    "CreatedAtMs": 1777368967284,
    "UpdatedAtMs": 1777370572517,
    "Schedule": {
      "Kind": "cron",
      "Expr": "0 9 * * *",
      "Tz": "Asia/Shanghai",
      "EveryMs": 100000,
      "AnchorMs": 1777370572518,
      "At": "2026-04-10T09:00:00+08:00"
    },
    "SessionTarget": "main",
    "WakeMode": "now",
    "Payload": {
      "Kind": "agentTurn",
      "Message": "Generate the daily report.",
      "Text": "Generate the daily report.",
      "Model": "anthropic/sonnet-4.6",
      "TimeoutSeconds": 10,
      "LightContext": false,
      "Deliver": false,
      "Channel": "telegram",
      "To": "team",
      "BestEffortDeliver": false
    },
    "AgentId": "work",
    "SessionKey": "abc123",
    "Description": "Daily report generation",
    "Delivery": {
      "Mode": "announce",
      "Channel": "telegram",
      "AccountId": "default",
      "To": "https://example.com/webhook",
      "BestEffort": false
    },
    "State": {
      "NextRunAtMs": 1777424400000,
      "LastRunAtMs": 1777370544931,
      "LastRunStatus": "ok",
      "ConsecutiveErrors": 0
    },
    "Runs": [
      {
        "Ts": 1777370572518,
        "JobId": "0ee00f56-f467-4d41-858c-ca4ede2c770e",
        "Action": "finished",
        "Status": "ok",
        "Summary": "Report generated successfully.",
        "Delivered": true,
        "DeliveryStatus": "delivered",
        "SessionId": "abc123",
        "RunAtMs": 1777370544931,
        "DurationMs": 27586,
        "NextRunAtMs": 1777424400000,
        "Model": "anthropic/sonnet-4.6",
        "Provider": "anthropic",
        "Usage": {
          "InputTokens": 30250,
          "OutputTokens": 30250,
          "TotalTokens": 60500
        },
        "JobName": "daily-report"
      }
    ]
  }
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。