Authorizing Scheduled Events
Function
Specifies the authorization of a scheduled event.
Debugging
You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.
URI
POST /v1/{project_id}/scheduled-events/{event_id}/accept
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
project_id |
Yes |
String |
Definition: User project ID. For details, see Obtaining a Project ID and Name. Constraints: N/A Range: N/A Default Value: N/A |
|
event_id |
Yes |
String |
Definition: Scheduled event ID. The value is the event_id field in the API for querying the scheduled event list. Constraints: N/A Range: The value is automatically generated by the system. It must start with a lowercase letter and consist of digits and hyphens (-). It cannot end with a hyphen (-) and can contain a maximum of 63 characters. Default Value: N/A |
Request Parameters
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
notBefore |
No |
String |
Definition: Planned start time of an event, in the format of yyyy-MM-ddTHH:mm:ssZ. Constraints: N/A Range: later than the current time. Default Value: If this parameter is left empty, the event is executed immediately. |
Response Parameters
Status code: 200
|
Parameter |
Type |
Description |
|---|---|---|
|
X-request-id |
String |
This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname. |
|
Parameter |
Type |
Description |
|---|---|---|
|
id |
String |
Event ID. |
|
catalog |
String |
Category. |
|
type |
String |
Event type. system-maintenance: system maintenance localdisk-recovery: local disk recovery node_reboot: node reboot operation-request: O&M authorization node_maintenance: supernode maintenance node_redeploy: supernode redeployment |
|
description |
String |
Description. |
|
state |
String |
Event status. inquiring: The request is to be authorized. scheduled: The request has been authorized. executing: The request is being executed. completed: The request is completed. failed: The request failed. canceled: The request is canceled. |
|
instanceType |
String |
Definition: node type. Range:
|
|
instanceId |
String |
Definition: server ID. Instance ID automatically generated by the compute service system. The length of the ID is fewer than 63 characters. Range: N/A |
|
nodeName |
String |
Definition: node name, which is the value of metadata.name in the node details. The value is automatically generated by the system. It must start with a lowercase letter and consist of digits and hyphens (-). It cannot end with a hyphen (-) and can contain no more than 63 characters. Range: N/A |
|
poolName |
String |
Definition: Name of the resource pool. This parameter is only available for lite-cluster and standard. The value is obtained from the metadata.name field in resource pool details. The value is automatically generated by the system. It must start with a lowercase letter and consist of digits and hyphens (-). It cannot end with a hyphen (-) and can contain no more than 63 characters. Range: N/A |
|
poolDisplayName |
String |
Definition: Name of the resource pool displayed externally. This parameter is only available for lite-cluster and standard. The value is obtained from the metadata.name field in resource pool details. The value can contain 36 to 63 characters. It must start with a lowercase letter and cannot end with a hyphen (-). Digits and hyphens (-) are allowed. Range: N/A |
|
publishTime |
String |
Definition: Event release time. Constraints: The value is a UTC time string, for example, 2025-09-15T07:02:30Z. Range: N/A Default Value: N/A |
|
startTime |
String |
Definition: Start time of an event. Constraints: The value is a UTC time string, for example, 2025-09-15T07:02:30Z. Range: N/A Default Value: N/A |
|
finishTime |
String |
Definition: Event completion time. Constraints: The value is a UTC time string, for example, 2025-09-15T07:02:30Z. Range: N/A Default Value: N/A |
|
notBefore |
String |
Definition: start time of the event plan, in UTC time string format, for example, 2025-09-15T07:02:30Z. Constraints: later than the current time. Range: N/A Default Value: If this parameter is left empty, the event is executed immediately. |
|
probeMsg |
String |
Definition: Prompt information. Constraints: The value is automatically generated by the system. It must start with a lowercase letter and consist of digits and hyphens (-). It cannot end with a hyphen (-) and can contain no more than 63 characters. Range: N/A Default Value: N/A |
|
redeployType |
Array of strings |
Definition: Node redeployment type. Constraints: N/A Range: - HARD: forcible redeployment; - SOFT: redeployment Default Value: N/A |
Status code: 400
|
Parameter |
Type |
Description |
|---|---|---|
|
X-request-id |
String |
This field is the request ID number for task tracking. Format is request_uuid-timestamp-hostname. |
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. |
|
error_msg |
String |
Error description. |
Example Requests
/v1/{project_id}/scheduled-events/{event_id}/accept
{
"notBefore" : "xxxx"
}
Example Responses
None
Status Codes
|
Status Code |
Description |
|---|---|
|
200 |
Event details. |
|
400 |
Error response |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot