Modifying a Scheduled Start/Stop Policy

Updated on 2025-02-14 GMT+08:00

View PDF

Function

This API is used to modify a scheduled start/stop rule.

URI

PUT /v1/{project_id}/cae/timer-rules/{timer_rule_id}

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. See Obtaining a Project ID.
timer_rule_id	Yes	String	ID of a scheduled start/stop policy.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. To obtain a token, see Obtaining a User Token Through Password Authentication. After a response is returned, the value of X-Subject-Token in the response header is the token value. Maximum characters: 16,384
X-Enterprise-Project-ID	No	String	Enterprise project ID. When an environment is created, it will be bound with an enterprise project ID. Enter 0 or up to 36 characters in UUID format with hyphens (-). If this parameter is not specified or set to 0, resources in the default enterprise project are queried. NOTE: For more information about enterprise projects and how to obtain enterprise project IDs, see Enterprise Management User Guide.
X-Environment-ID	Yes	String	Environment ID. To obtain an environment ID, see Obtaining the Environment List in CAE API Reference. In the response, id under items indicates the environment ID.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
api_version	Yes	String	API version. Fixed value: v1. Enumerated value: v1
kind	Yes	String	API type. Fixed value: TimerRule. Enumerated value: TimerRule
spec	Yes	UpdateTimerRuleDetails object	Specifications.

**Table 4** UpdateTimerRuleDetails
Parameter	Mandatory	Type	Description
name	Yes	String	Name of a scheduled start/stop policy.
type	Yes	String	Policy type. Options: stop and start.
status	Yes	String	Policy status. Options: on and off.
apps	No	Array of AppInfo objects	Applications to which the scheduled start/stop policy applies. This parameter is mandatory only when effective_range is set to application.
components	No	Array of ComponentInfo objects	Components to which the scheduled start/stop policy applies. This parameter is mandatory only when effective_range is set to component.
cron	Yes	String	Cron expression.
effective_range	Yes	String	Scope to which a policy applies. Options: component, application, and environment.
effective_policy	Yes	String	Trigger mode. Options: onetime and periodic.

**Table 5** AppInfo
Parameter	Mandatory	Type	Description
app_id	No	String	Application ID.
app_name	No	String	Application name.

**Table 6** ComponentInfo
Parameter	Mandatory	Type	Description
component_id	No	String	Component ID.
component_name	No	String	Component name.

Response Parameters

None

Example Request

Modify a scheduled start/stop policy: Set name to test-2, type to start, effective_range to component, and effective_policy to onetime.

PUT https://{endpoint}/v1/{project_id}/cae/timer-rules/{rule_id}

{
  "api_version" : "v1",
  "kind" : "TimerRule",
  "spec" : {
    "name" : "test-2",
    "type" : "start",
    "cron" : "0 55 16 22 2 ? 2023",
    "status" : "on",
    "env_id" : "c41a8e9f-5447-406a-8783-85885f3870a3",
    "effective_range" : "component",
    "effective_policy" : "onetime",
    "components" : [ {
      "component_id" : "10f7b6be-5dc2-4fb7-b62c-e8f362dfdabf",
      "component_name" : "addd"
    }, {
      "component_id" : "3f3041f9-5063-40c9-94ee-8473517b3956",
      "component_name" : "demo-frontend-1676360408"
    } ]
  }
}