Skip to content

Update Acceleration Scheduling Configuration

API Description

This API is used to modify the refresh/scheduling configuration of a materialization plan, including:

  • whether scheduling is enabled

  • cron expression

  • full/incremental configuration

  • time-window upper and lower bounds

⚠️ For external materialization (EXTERNAL) plans:

  • This configuration is used only for frontend display

  • The system does not actually schedule execution

  • API URL

POST /anymetrics/api/{version}/accelerate/plan/updateRefreshConfig

Request parameters

Common Request Headers

parameter Type required Description
tenant-id String Yes Tenant ID, used to identify the tenant for metric query content.
auth-type String Yes Authentication method. Supports UID, TOKEN, ACCOUNT, and APIKEY.
auth-value String Yes Authentication value corresponding to auth-type.

How to Obtain Common parameters

View this in the top navigation of Aloudata CAN under Metric Applications > API Integration.

image.png

Request parameters

Field Type required Description
uuid String Yes Plan unique ID
refreshConfig.cron String No Scheduling expression. required when scheduling is enabled
refreshConfig.isScheduleUpdate Boolean No Whether scheduling is enabled
refreshConfig.updateUpperInterval Integer No Upper bound offset
refreshConfig.updateLowerInterval Integer No Lower bound offset
refreshConfig.granularity String No Time granularity, such as DAY
refreshConfig.isFullRefresh Boolean No Whether to perform full refresh. Used for acceleration materialization and external materialization
refreshConfig.increment Boolean No Whether incremental mode is enabled. Used only for result materialization

Request Example

{
  "uuid": "ecfc2a9539a04ef49897a9b4e3d65e7f",
  "refreshConfig": {
    "cron": "0 0 0 * * ?",
    "isScheduleUpdate": true,
    "updateUpperInterval": -1,
    "updateLowerInterval": -3,
    "granularity": "DAY",
    "isFullRefresh": true
  }
}

Response parameter Description

Field Type Description
data String Fixed value "success"
success Boolean Whether successful
code String Status code
errorMsg String Error message
detailErrorMsg String Detailed error message

Response Example

{
  "data": "success",
  "success": true,
  "code": "200",
  "errorMsg": null
}