Skip to content

Commit 00c24b3

Browse files
api-clients-generation-pipeline[bot]ci.datadog-api-spec
api-clients-generation-pipeline[bot]
and
ci.datadog-api-spec
authored
Add Maintenances and minor updates to Status Pages API (#3520)
Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>
1 parent 220cd83 commit 00c24b3

File tree

86 files changed

+8257
-433
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

86 files changed

+8257
-433
lines changed

‎.generator/schemas/v2/openapi.yaml‎

Lines changed: 764 additions & 73 deletions
Large diffs are not rendered by default.

‎examples/v2/status-pages/CreateMaintenance.java‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
// Schedule maintenance returns "Created" response
2+
3+
import com.datadog.api.client.ApiClient;
4+
import com.datadog.api.client.ApiException;
5+
import com.datadog.api.client.v2.api.StatusPagesApi;
6+
import com.datadog.api.client.v2.model.CreateMaintenanceRequest;
7+
import com.datadog.api.client.v2.model.CreateMaintenanceRequestData;
8+
import com.datadog.api.client.v2.model.CreateMaintenanceRequestDataAttributes;
9+
import com.datadog.api.client.v2.model.CreateMaintenanceRequestDataAttributesComponentsAffectedItems;
10+
import com.datadog.api.client.v2.model.Maintenance;
11+
import com.datadog.api.client.v2.model.PatchMaintenanceRequestDataAttributesComponentsAffectedItemsStatus;
12+
import com.datadog.api.client.v2.model.PatchMaintenanceRequestDataType;
13+
import java.time.OffsetDateTime;
14+
import java.util.Collections;
15+
import java.util.UUID;
16+
17+
public class Example {
18+
public static void main(String[] args) {
19+
ApiClient defaultClient = ApiClient.getDefaultApiClient();
20+
StatusPagesApi apiInstance = new StatusPagesApi(defaultClient);
21+
22+
CreateMaintenanceRequest body =
23+
new CreateMaintenanceRequest()
24+
.data(
25+
new CreateMaintenanceRequestData()
26+
.attributes(
27+
new CreateMaintenanceRequestDataAttributes()
28+
.completedDate(OffsetDateTime.parse("2026-02-18T19:51:13.332360075Z"))
29+
.completedDescription(
30+
"We have completed maintenance on the API to improve performance.")
31+
.componentsAffected(
32+
Collections.singletonList(
33+
new CreateMaintenanceRequestDataAttributesComponentsAffectedItems()
34+
.id(UUID.fromString("1234abcd-12ab-34cd-56ef-123456abcdef"))
35+
.status(
36+
PatchMaintenanceRequestDataAttributesComponentsAffectedItemsStatus
37+
.OPERATIONAL)))
38+
.inProgressDescription(
39+
"We are currently performing maintenance on the API to improve"
40+
+ " performance.")
41+
.scheduledDescription(
42+
"We will be performing maintenance on the API to improve"
43+
+ " performance.")
44+
.startDate(OffsetDateTime.parse("2026-02-18T19:21:13.332360075Z"))
45+
.title("API Maintenance"))
46+
.type(PatchMaintenanceRequestDataType.MAINTENANCES));
47+
48+
try {
49+
Maintenance result =
50+
apiInstance.createMaintenance(
51+
UUID.fromString("9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"), body);
52+
System.out.println(result);
53+
} catch (ApiException e) {
54+
System.err.println("Exception when calling StatusPagesApi#createMaintenance");
55+
System.err.println("Status code: " + e.getCode());
56+
System.err.println("Reason: " + e.getResponseBody());
57+
System.err.println("Response headers: " + e.getResponseHeaders());
58+
e.printStackTrace();
59+
}
60+
}
61+
}

‎examples/v2/status-pages/CreateMaintenance_2202276054.java‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
// Create maintenance returns "Created" response
2+
import com.datadog.api.client.ApiClient;
3+
import com.datadog.api.client.ApiException;
4+
import com.datadog.api.client.v2.api.StatusPagesApi;
5+
import com.datadog.api.client.v2.model.CreateMaintenanceRequest;
6+
import com.datadog.api.client.v2.model.CreateMaintenanceRequestData;
7+
import com.datadog.api.client.v2.model.CreateMaintenanceRequestDataAttributes;
8+
import com.datadog.api.client.v2.model.CreateMaintenanceRequestDataAttributesComponentsAffectedItems;
9+
import com.datadog.api.client.v2.model.Maintenance;
10+
import com.datadog.api.client.v2.model.PatchMaintenanceRequestDataAttributesComponentsAffectedItemsStatus;
11+
import com.datadog.api.client.v2.model.PatchMaintenanceRequestDataType;
12+
import java.time.OffsetDateTime;
13+
import java.util.Collections;
14+
import java.util.UUID;
15+
16+
public class Example {
17+
public static void main(String[] args) {
18+
ApiClient defaultClient = ApiClient.getDefaultApiClient();
19+
StatusPagesApi apiInstance = new StatusPagesApi(defaultClient);
20+
21+
// there is a valid "status_page" in the system
22+
UUID STATUS_PAGE_DATA_ATTRIBUTES_COMPONENTS_0_COMPONENTS_0_ID = null;
23+
try {
24+
STATUS_PAGE_DATA_ATTRIBUTES_COMPONENTS_0_COMPONENTS_0_ID =
25+
UUID.fromString(
26+
System.getenv("STATUS_PAGE_DATA_ATTRIBUTES_COMPONENTS_0_COMPONENTS_0_ID"));
27+
} catch (IllegalArgumentException e) {
28+
System.err.println("Error parsing UUID: " + e.getMessage());
29+
}
30+
UUID STATUS_PAGE_DATA_ID = null;
31+
try {
32+
STATUS_PAGE_DATA_ID = UUID.fromString(System.getenv("STATUS_PAGE_DATA_ID"));
33+
} catch (IllegalArgumentException e) {
34+
System.err.println("Error parsing UUID: " + e.getMessage());
35+
}
36+
37+
CreateMaintenanceRequest body =
38+
new CreateMaintenanceRequest()
39+
.data(
40+
new CreateMaintenanceRequestData()
41+
.attributes(
42+
new CreateMaintenanceRequestDataAttributes()
43+
.title("API Maintenance")
44+
.scheduledDescription(
45+
"We will be performing maintenance on the API to improve"
46+
+ " performance.")
47+
.inProgressDescription(
48+
"We are currently performing maintenance on the API to improve"
49+
+ " performance.")
50+
.completedDescription(
51+
"We have completed maintenance on the API to improve performance.")
52+
.startDate(OffsetDateTime.now().plusHours(1))
53+
.completedDate(OffsetDateTime.now().plusHours(2))
54+
.componentsAffected(
55+
Collections.singletonList(
56+
new CreateMaintenanceRequestDataAttributesComponentsAffectedItems()
57+
.id(
58+
STATUS_PAGE_DATA_ATTRIBUTES_COMPONENTS_0_COMPONENTS_0_ID)
59+
.status(
60+
PatchMaintenanceRequestDataAttributesComponentsAffectedItemsStatus
61+
.OPERATIONAL))))
62+
.type(PatchMaintenanceRequestDataType.MAINTENANCES));
63+
64+
try {
65+
Maintenance result = apiInstance.createMaintenance(STATUS_PAGE_DATA_ID, body);
66+
System.out.println(result);
67+
} catch (ApiException e) {
68+
System.err.println("Exception when calling StatusPagesApi#createMaintenance");
69+
System.err.println("Status code: " + e.getCode());
70+
System.err.println("Reason: " + e.getResponseBody());
71+
System.err.println("Response headers: " + e.getResponseHeaders());
72+
e.printStackTrace();
73+
}
74+
}
75+
}

‎examples/v2/status-pages/GetMaintenance.java‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
// Get maintenance returns "OK" response
2+
3+
import com.datadog.api.client.ApiClient;
4+
import com.datadog.api.client.ApiException;
5+
import com.datadog.api.client.v2.api.StatusPagesApi;
6+
import com.datadog.api.client.v2.model.Maintenance;
7+
import java.util.UUID;
8+
9+
public class Example {
10+
public static void main(String[] args) {
11+
ApiClient defaultClient = ApiClient.getDefaultApiClient();
12+
StatusPagesApi apiInstance = new StatusPagesApi(defaultClient);
13+
14+
// there is a valid "status_page" in the system
15+
UUID STATUS_PAGE_DATA_ID = null;
16+
try {
17+
STATUS_PAGE_DATA_ID = UUID.fromString(System.getenv("STATUS_PAGE_DATA_ID"));
18+
} catch (IllegalArgumentException e) {
19+
System.err.println("Error parsing UUID: " + e.getMessage());
20+
}
21+
22+
// there is a valid "maintenance" in the system
23+
UUID MAINTENANCE_DATA_ID = null;
24+
try {
25+
MAINTENANCE_DATA_ID = UUID.fromString(System.getenv("MAINTENANCE_DATA_ID"));
26+
} catch (IllegalArgumentException e) {
27+
System.err.println("Error parsing UUID: " + e.getMessage());
28+
}
29+
30+
try {
31+
Maintenance result = apiInstance.getMaintenance(STATUS_PAGE_DATA_ID, MAINTENANCE_DATA_ID);
32+
System.out.println(result);
33+
} catch (ApiException e) {
34+
System.err.println("Exception when calling StatusPagesApi#getMaintenance");
35+
System.err.println("Status code: " + e.getCode());
36+
System.err.println("Reason: " + e.getResponseBody());
37+
System.err.println("Response headers: " + e.getResponseHeaders());
38+
e.printStackTrace();
39+
}
40+
}
41+
}

‎examples/v2/status-pages/ListMaintenances.java‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
// List maintenances returns "OK" response
2+
3+
import com.datadog.api.client.ApiClient;
4+
import com.datadog.api.client.ApiException;
5+
import com.datadog.api.client.v2.api.StatusPagesApi;
6+
import com.datadog.api.client.v2.model.MaintenanceArray;
7+
8+
public class Example {
9+
public static void main(String[] args) {
10+
ApiClient defaultClient = ApiClient.getDefaultApiClient();
11+
StatusPagesApi apiInstance = new StatusPagesApi(defaultClient);
12+
13+
try {
14+
MaintenanceArray result = apiInstance.listMaintenances();
15+
System.out.println(result);
16+
} catch (ApiException e) {
17+
System.err.println("Exception when calling StatusPagesApi#listMaintenances");
18+
System.err.println("Status code: " + e.getCode());
19+
System.err.println("Reason: " + e.getResponseBody());
20+
System.err.println("Response headers: " + e.getResponseHeaders());
21+
e.printStackTrace();
22+
}
23+
}
24+
}

‎examples/v2/status-pages/UpdateMaintenance.java‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
// Update maintenance returns "OK" response
2+
3+
import com.datadog.api.client.ApiClient;
4+
import com.datadog.api.client.ApiException;
5+
import com.datadog.api.client.v2.api.StatusPagesApi;
6+
import com.datadog.api.client.v2.model.Maintenance;
7+
import com.datadog.api.client.v2.model.PatchMaintenanceRequest;
8+
import com.datadog.api.client.v2.model.PatchMaintenanceRequestData;
9+
import com.datadog.api.client.v2.model.PatchMaintenanceRequestDataAttributes;
10+
import com.datadog.api.client.v2.model.PatchMaintenanceRequestDataType;
11+
import java.util.UUID;
12+
13+
public class Example {
14+
public static void main(String[] args) {
15+
ApiClient defaultClient = ApiClient.getDefaultApiClient();
16+
StatusPagesApi apiInstance = new StatusPagesApi(defaultClient);
17+
18+
// there is a valid "status_page" in the system
19+
UUID STATUS_PAGE_DATA_ID = null;
20+
try {
21+
STATUS_PAGE_DATA_ID = UUID.fromString(System.getenv("STATUS_PAGE_DATA_ID"));
22+
} catch (IllegalArgumentException e) {
23+
System.err.println("Error parsing UUID: " + e.getMessage());
24+
}
25+
26+
// there is a valid "maintenance" in the system
27+
UUID MAINTENANCE_DATA_ID = null;
28+
try {
29+
MAINTENANCE_DATA_ID = UUID.fromString(System.getenv("MAINTENANCE_DATA_ID"));
30+
} catch (IllegalArgumentException e) {
31+
System.err.println("Error parsing UUID: " + e.getMessage());
32+
}
33+
34+
PatchMaintenanceRequest body =
35+
new PatchMaintenanceRequest()
36+
.data(
37+
new PatchMaintenanceRequestData()
38+
.attributes(
39+
new PatchMaintenanceRequestDataAttributes()
40+
.scheduledDescription(
41+
"We will be performing maintenance on the API to improve"
42+
+ " performance for 40 minutes.")
43+
.inProgressDescription(
44+
"We are currently performing maintenance on the API to improve"
45+
+ " performance for 40 minutes."))
46+
.id(MAINTENANCE_DATA_ID)
47+
.type(PatchMaintenanceRequestDataType.MAINTENANCES));
48+
49+
try {
50+
Maintenance result =
51+
apiInstance.updateMaintenance(STATUS_PAGE_DATA_ID, MAINTENANCE_DATA_ID, body);
52+
System.out.println(result);
53+
} catch (ApiException e) {
54+
System.err.println("Exception when calling StatusPagesApi#updateMaintenance");
55+
System.err.println("Status code: " + e.getCode());
56+
System.err.println("Reason: " + e.getResponseBody());
57+
System.err.println("Response headers: " + e.getResponseHeaders());
58+
e.printStackTrace();
59+
}
60+
}
61+
}

0 commit comments

Comments
 (0)