Updates a time-based schedule.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UpdateSchedule

The operation that you want to perform. Set the value to UpdateSchedule.
FlowName String Yes testFlowName

The name of the flow bound to the time-based schedule you want to update.
ScheduleName String Yes testScheduleName

The name of the time-based schedule to be updated.
RequestId String No testRequestId

The ID of the request. If you do not specify this parameter, the system generates a random value.

Description String No test description

The description of the time-based schedule to be updated.
Payload String No {"key": "value"}

The trigger message of the time-based schedule to be updated. It must be in JSON format.
CronExpression String No @every 1m

The CRON expression of the time-based schedule to be updated.
Enable Boolean No true

Specifies whether to enable the time-based schedule you want to update.

Response parameters

Parameter Type Example Description
CreatedTime String 2020-01-01T01:01:01.001Z

The time when the time-based schedule was created.
CronExpression String @every 1m

The CRON expression of the time-based schedule.
Description String test description

The description of the time-based schedule.
Enable Boolean true

Indicates whether to enable the time-based schedule.
LastModifiedTime String 2020-01-01T01:01:01.001Z

The time when the time-based schedule was last updated.
Payload String {"key": "value"}

The trigger message of the time-based schedule.
RequestId String testRequestId

The ID of the request.
ScheduleId String testScheduleId

The ID of the time-based schedule.
ScheduleName String testScheduleName

The name of the time-based schedule.

Examples

Sample requests

http(s)://[Endpoint]/? Action=UpdateSchedule
&FlowName=testFlowName
&ScheduleName=testScheduleName
&<Common request parameters>

Sample success responses

XML format 

<UpdateScheduleResponse>
    <Description>Response in XML format is not supported. </Description>
</UpdateScheduleResponse>

JSON format 

{
  "Description":"test description",
  "CreatedTime":"2020-01-01T01:01:01.001Z",
  "RequestId":"testRequestId",
  "LastModifiedTime":"2020-01-01T01:01:01.001Z",
  "Enable":"true",
  "Payload":"{\"key\": \"value\"}",
  "CronExpression":"@every 1m",
  "ScheduleId":"testScheduleId",
  "ScheduleName":"testScheduleName"
}

Error codes

HttpCode Error code Error message Description
403 AccessDenied The resources doesn't belong to you. The error message returned because request authentication failed. For more information, see the actual error message.
400 APIVersionNotSupported The requested API version '%s' is not supported yet. Please check. The error message returned because the requested API version is wrong. For more information, see Make API requests.
409 ConcurrentUpdateError Update conflict, please retry. The error message returned because concurrent write operations are performed on the requested resource. Wait for a while and then try again.
404 FlowNotExists Flow %s does not exist. The error message returned because the requested resource does not exist. Ensure that the flow has been created.
500 InternalServerError An internal error has occurred. Please retry. The error message returned because an internal server error has occurred. Try again later.
400 InvalidArgument Parameter error. The error message returned because the request parameters are invalid. For more information, see the actual error message.
400 MissingRequiredHeader The HTTP header '%s' must be specified. The error message returned because the required request parameters are missing. For more information, see the actual error message.
400 MissingRequiredParams The HTTP query '%s' must be specified. The error message returned because the required request parameters are missing. For more information, see the actual error message.
412 PreconditionFailed The resource to be modified has been changed. The error message returned because resource view or check for updates failed, and the resource may be modified. Try again later.
404 ScheduleNotExists The schedule %s for flow %s does not exist. The error message returned because the time-based schedule does not exist.

For a list of error codes, visit the API Error Center.

For a list of error codes, visit the API Error Center.