maintenance-window

Update a maintenance window.

Changed on

Spaces method and path for this operation:

<div><span class="operation-verb patch">patch</span>&nbsp;<span class="operation-path">/s/{space_id}/api/maintenance_window/{id}</span></div>

Refer to Spaces for more information.

[Required authorization] Route required privileges: write-maintenance-window.

patch/api/maintenance_window/{id}

Request

  • Base URL
    https://localhost:5601
  • URL
    https://localhost:5601/api/maintenance_window/{id}
  • Auth
    • API key in header Authorization
    • or HTTP basic

Path parameters

idstring required

The identifier for the maintenance window.

Headers

kbn-xsrfstring required
Example:true

A required header to protect against CSRF attacks

Request body

enabledboolean

Whether the current maintenance window is enabled. Disabled maintenance windows do not suppress notifications.

titlestring

The name of the maintenance window. While this name does not have to be unique, a distinctive name can help you identify a specific maintenance window.

Response

Indicates a successful call.

created_atstring required

The date and time when the maintenance window was created.

created_bystring nullable

The identifier for the user that created the maintenance window.

enabledboolean required

Whether the current maintenance window is enabled. Disabled maintenance windows do not suppress notifications.

idstring required

The identifier for the maintenance window.

status'running' | 'upcoming' | 'finished' | 'archived' | 'disabled' required

The current status of the maintenance window.

titlestring required

The name of the maintenance window.

updated_atstring required

The date and time when the maintenance window was last updated.

updated_bystring nullable

The identifier for the user that last updated this maintenance window.

Changes

  • 97699059d3b3Revision changes
    • info

      the //// request property's min was decreased from 1.00 to -1.00

  • 43068c4185f9Revision changes
    • warning

      the // request property's maxLength was set to 100

    • warning

      the /// request property's maxLength was set to 100

    • warning

      the /// request property's maxLength was set to 100

    • warning

      the //// request property's maxLength was set to 10

    • warning

      the // request property's maxLength was set to 100

    • warning

      the // request property's maxLength was set to 64