A maintenance window that defines a scheduled time period during which case-related notifications and automation rules are suppressed. Each maintenance window applies to cases matching a specified query.
attributes [required]
object
Attributes of a maintenance window, including its schedule and the query that determines which cases are affected.
created_by
string
The UUID of the user who created this maintenance window. Read-only.
end_at [required]
date-time
The ISO 8601 timestamp when the maintenance window ends and normal notification behavior resumes.
name [required]
string
A human-readable name for the maintenance window (for example, Database migration - Dec 15).
query [required]
string
A case search query that determines which cases are affected during the maintenance window. Uses the same syntax as the Case Management search bar.
start_at [required]
date-time
The ISO 8601 timestamp when the maintenance window begins and notifications start being suppressed.
updated_by
string
The UUID of the user who last modified this maintenance window. Read-only.
id [required]
string
The maintenance window's identifier.
type [required]
enum
JSON:API resource type for maintenance windows.
Allowed enum values: maintenance_window
## default
#
# Path parameters exportmaintenance_window_id="a1b2c3d4-e5f6-7890-abcd-ef1234567890" # Use a Personal Access Token or Service Access Token exportDD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"python3"example.py"
# Update a maintenance window returns "OK" responserequire"datadog_api_client"DatadogAPIClient.configuredo|config|config.access_token=ENV["DD_BEARER_TOKEN"]endapi_instance=DatadogAPIClient::V2::CaseManagementAPI.newbody=DatadogAPIClient::V2::MaintenanceWindowUpdateRequest.new({data:DatadogAPIClient::V2::MaintenanceWindowUpdate.new({attributes:DatadogAPIClient::V2::MaintenanceWindowUpdateAttributes.new({}),type:DatadogAPIClient::V2::MaintenanceWindowResourceType::MAINTENANCE_WINDOW,}),})papi_instance.update_maintenance_window("maintenance_window_id",body)
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"rb"example.rb"
// Update a maintenance window returns "OK" responsepackagemainimport("context""encoding/json""fmt""os""github.com/DataDog/datadog-api-client-go/v2/api/datadog""github.com/DataDog/datadog-api-client-go/v2/api/datadogV2")funcmain(){body:=datadogV2.MaintenanceWindowUpdateRequest{Data:datadogV2.MaintenanceWindowUpdate{Attributes:&datadogV2.MaintenanceWindowUpdateAttributes{},Type:datadogV2.MAINTENANCEWINDOWRESOURCETYPE_MAINTENANCE_WINDOW,},}ctx:=datadog.NewDefaultContext(context.Background())ctx=context.WithValue(ctx,datadog.ContextAccessToken,os.Getenv("DD_BEARER_TOKEN"))configuration:=datadog.NewConfiguration()apiClient:=datadog.NewAPIClient(configuration)api:=datadogV2.NewCaseManagementApi(apiClient)resp,r,err:=api.UpdateMaintenanceWindow(ctx,"maintenance_window_id",body)iferr!=nil{fmt.Fprintf(os.Stderr,"Error when calling `CaseManagementApi.UpdateMaintenanceWindow`: %v\n",err)fmt.Fprintf(os.Stderr,"Full HTTP response: %v\n",r)}responseContent,_:=json.MarshalIndent(resp,""," ")fmt.Fprintf(os.Stdout,"Response from `CaseManagementApi.UpdateMaintenanceWindow`:\n%s\n",responseContent)}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"go run"main.go"
// Update a maintenance window returns "OK" responseimportcom.datadog.api.client.ApiClient;importcom.datadog.api.client.ApiException;importcom.datadog.api.client.v2.api.CaseManagementApi;importcom.datadog.api.client.v2.model.MaintenanceWindowResourceType;importcom.datadog.api.client.v2.model.MaintenanceWindowResponse;importcom.datadog.api.client.v2.model.MaintenanceWindowUpdate;importcom.datadog.api.client.v2.model.MaintenanceWindowUpdateAttributes;importcom.datadog.api.client.v2.model.MaintenanceWindowUpdateRequest;publicclassExample{publicstaticvoidmain(String[]args){ApiClientdefaultClient=ApiClient.getDefaultApiClient();defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN"));CaseManagementApiapiInstance=newCaseManagementApi(defaultClient);MaintenanceWindowUpdateRequestbody=newMaintenanceWindowUpdateRequest().data(newMaintenanceWindowUpdate().attributes(newMaintenanceWindowUpdateAttributes()).type(MaintenanceWindowResourceType.MAINTENANCE_WINDOW));try{MaintenanceWindowResponseresult=apiInstance.updateMaintenanceWindow("a1b2c3d4-e5f6-7890-abcd-ef1234567890",body);System.out.println(result);}catch(ApiExceptione){System.err.println("Exception when calling CaseManagementApi#updateMaintenanceWindow");System.err.println("Status code: "+e.getCode());System.err.println("Reason: "+e.getResponseBody());System.err.println("Response headers: "+e.getResponseHeaders());e.printStackTrace();}}}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"java"Example.java"
// Update a maintenance window returns "OK" response
usedatadog_api_client::datadog;usedatadog_api_client::datadogV2::api_case_management::CaseManagementAPI;usedatadog_api_client::datadogV2::model::MaintenanceWindowResourceType;usedatadog_api_client::datadogV2::model::MaintenanceWindowUpdate;usedatadog_api_client::datadogV2::model::MaintenanceWindowUpdateAttributes;usedatadog_api_client::datadogV2::model::MaintenanceWindowUpdateRequest;#[tokio::main]asyncfnmain(){letbody=MaintenanceWindowUpdateRequest::new(MaintenanceWindowUpdate::new(MaintenanceWindowResourceType::MAINTENANCE_WINDOW).attributes(MaintenanceWindowUpdateAttributes::new()),);letconfiguration=datadog::Configuration::new();letapi=CaseManagementAPI::with_config(configuration);letresp=api.update_maintenance_window("maintenance_window_id".to_string(),body).await;ifletOk(value)=resp{println!("{:#?}",value);}else{println!("{:#?}",resp.unwrap_err());}}
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_API_KEY="<DD_API_KEY>"DD_APP_KEY="<DD_APP_KEY>"cargo run
/**
* Update a maintenance window returns "OK" response
*/import{client,v2}from"@datadog/datadog-api-client";constconfiguration=client.createConfiguration({authMethods:{AuthZ:{accessToken: process.env.DD_BEARER_TOKENasstring,},},});constapiInstance=newv2.CaseManagementApi(configuration);constparams: v2.CaseManagementApiUpdateMaintenanceWindowRequest={body:{data:{attributes:{},type:"maintenance_window",},},maintenanceWindowId:"maintenance_window_id",};apiInstance.updateMaintenanceWindow(params).then((data: v2.MaintenanceWindowResponse)=>{console.log("API called successfully. Returned data: "+JSON.stringify(data));}).catch((error: any)=>console.error(error));
DD_SITE="datadoghq.comus3.datadoghq.comus5.datadoghq.comdatadoghq.euap1.datadoghq.comap2.datadoghq.comuk1.datadoghq.comddog-gov.comus2.ddog-gov.com"DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"tsc"example.ts"
Request a personalized demo
Get Started with Datadog
Ask AI
AI-generated responses may be inaccurate. Verify important info.