Skip to content

Modify Scheduled Report¶

POST /api/v1/crontab_report/{report_uuid}/modify

Overview¶

Route Parameters¶

Parameter Name	Type	Required	Description
report_uuid	string	Y	UUID of the scheduled report

Body Request Parameters¶

Parameter Name	Type	Required	Description
title	string	Y	Name of the scheduled report Allow empty: True Max length: 200
content	string		Content of the scheduled report Allow empty: True Max length: 1000 Allow empty string: True
dashboardUUID	string	Y	Dashboard UUID Allow empty: False
recipient	array	Y	Recipient information Example: [acnt_xxxx, xxx@guance.com, acnt_yyy] Allow empty: False
variables	json		View variable information Allow empty: True
timeRange	string	Y	Query time range Example: 1d Allow empty: True
crontab	string		Crontab of the scheduled task Example: 1 2 * * * Allow empty: True Allow empty string: True
singleExecuteTime	int		Timestamp for single execution Allow empty: True
extend	json		Additional information Allow empty: True
timezone	string	Y	Timezone of the scheduled report Example: Asia/Shanghai Allow empty: True
notifyType	string	Y	Notification type of the scheduled report Example: email Allow empty: True Options: ['email', 'dingTalkRobot', 'wechatRobot', 'feishuRobot', 'HTTPRequest', 'slackIncomingWebhook', 'teamsWorkflowWebhook']

Parameter Additional Information¶

Data Description.*

Request Parameter Description

Parameter Name	type	Description
title	string	Name of the scheduled report
content	string	Content of the scheduled report
dashboardUUID	string	Dashboard UUID of the scheduled report
recipient	list	Recipient information list of the scheduled report, user account acnt_/email/notification target uuid
variables	json	View variable information
timeRange	string	Query time range, integer plus d/h/m format, e.g.: 3d, 15m, 2h
crontab	string	Crontab for repeated scheduled tasks
singleExecuteTime	int	Timestamp for single execution
extend	json	Extended information, used for front-end interface display
timezone	string	Timezone
notifyType	string	Notification type

extend Field Description

Parameter Name	type	Description
shareConfig	json	Scheduled report sharing configuration
shareConfig.shareMethod	string	Scheduled report sharing configuration public or encipher public and encrypted default public
shareConfig.password	string	Scheduled report sharing password encrypted sharing password

Request Example¶

curl 'https://openapi.guance.com/api/v1/crontab_report/cron_xxxx32/modify' \
-H 'Accept-Language: zh' \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'Accept: application/json, text/plain, */*' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-raw '{"title":"ceshi3","content":"","dashboardUUID":"dsbd_xxxx32","recipient":["notify_xxxx32"],"timeRange":"1d","singleExecuteTime":-1,"crontab":"10 10 03,14,13 * *","variables":{},"extend":{"cycleTimeType":"day","hour":"10","minutes":"10","dashboardInfo":{}},"timezone":"Asia/Shanghai","notifyType":"dingTalkRobot"}' \
--compressed

Response¶

{
    "code": 200,
    "content": {
        "content": "",
        "createAt": 1698666812,
        "creator": "wsak_xxxxx",
        "crontab": "10 10 03,14,13 * *",
        "dashboardUUID": "dsbd_xxxx32",
        "deleteAt": -1,
        "executed": 0,
        "extend": {
            "cycleTimeType": "day",
            "dashboardInfo": {},
            "hour": "10",
            "minutes": "10"
        },
        "id": 206,
        "isLocked": 0,
        "notifyType": "dingTalkRobot",
        "recipient": [
            "notify_xxxx32"
        ],
        "singleExecuteTime": -1,
        "status": 0,
        "timeRange": "1d",
        "timezone": "Asia/Shanghai",
        "title": "ceshi3",
        "updateAt": 1698667256,
        "updator": "wsak_xxxxx",
        "uuid": "cron_xxxx32",
        "variables": {},
        "workspaceUUID": "wksp_xxxx32"
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-060F8B2A-6502-44AB-81A0-E51E4006D205"
}