Add Incident Notification Template Public Docs (#897)

Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -1,7 +1,6 @@
 Component,Origin,License,Copyright
 addr2line,https://github.com/gimli-rs/addr2line,Apache-2.0 OR MIT,The addr2line Authors
 adler2,https://github.com/oyvindln/adler2,0BSD OR MIT OR Apache-2.0,"Jonas Schievink <[email protected]>, oyvindln <[email protected]>"
-android-tzdata,https://github.com/RumovZ/android-tzdata,MIT OR Apache-2.0,RumovZ
 android_system_properties,https://github.com/nical/android_system_properties,MIT OR Apache-2.0,Nicolas Silva <[email protected]>
 anyhow,https://github.com/dtolnay/anyhow,MIT OR Apache-2.0,David Tolnay <[email protected]>
 async-stream,https://github.com/tokio-rs/async-stream,MIT,Carl Lerche <[email protected]>
@@ -181,6 +180,7 @@ windows-core,https://github.com/microsoft/windows-rs,MIT OR Apache-2.0,Microsoft
 windows-implement,https://github.com/microsoft/windows-rs,MIT OR Apache-2.0,Microsoft
 windows-interface,https://github.com/microsoft/windows-rs,MIT OR Apache-2.0,Microsoft
 windows-link,https://github.com/microsoft/windows-rs,MIT OR Apache-2.0,Microsoft
+windows-link,https://github.com/microsoft/windows-rs,MIT OR Apache-2.0,The windows-link Authors
 windows-result,https://github.com/microsoft/windows-rs,MIT OR Apache-2.0,Microsoft
 windows-strings,https://github.com/microsoft/windows-rs,MIT OR Apache-2.0,Microsoft
 windows-sys,https://github.com/microsoft/windows-rs,MIT OR Apache-2.0,Microsoft

LICENSE-3rdparty.csv

@@ -0,0 +1,53 @@
+// Create incident notification template returns "Created" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_incidents::IncidentsAPI;
+use datadog_api_client::datadogV2::model::CreateIncidentNotificationTemplateRequest;
+use datadog_api_client::datadogV2::model::IncidentNotificationTemplateCreateAttributes;
+use datadog_api_client::datadogV2::model::IncidentNotificationTemplateCreateData;
+use datadog_api_client::datadogV2::model::IncidentNotificationTemplateCreateDataRelationships;
+use datadog_api_client::datadogV2::model::IncidentNotificationTemplateType;
+use datadog_api_client::datadogV2::model::IncidentTypeType;
+use datadog_api_client::datadogV2::model::RelationshipToIncidentType;
+use datadog_api_client::datadogV2::model::RelationshipToIncidentTypeData;
+
+#[tokio::main]
+async fn main() {
+    // there is a valid "incident_type" in the system
+    let incident_type_data_id = std::env::var("INCIDENT_TYPE_DATA_ID").unwrap();
+    let body = CreateIncidentNotificationTemplateRequest::new(
+        IncidentNotificationTemplateCreateData::new(
+            IncidentNotificationTemplateCreateAttributes::new(
+                "alert".to_string(),
+                r#"An incident has been declared.
+
+Title: Sample Incident Title
+Severity: SEV-2
+Affected Services: web-service, database-service
+Status: active
+
+Please join the incident channel for updates."#
+                    .to_string(),
+                "Example-Incident".to_string(),
+                "SEV-2 Incident: Sample Incident Title".to_string(),
+            ),
+            IncidentNotificationTemplateType::NOTIFICATION_TEMPLATES,
+        )
+        .relationships(
+            IncidentNotificationTemplateCreateDataRelationships::new().incident_type(
+                RelationshipToIncidentType::new(RelationshipToIncidentTypeData::new(
+                    incident_type_data_id.clone(),
+                    IncidentTypeType::INCIDENT_TYPES,
+                )),
+            ),
+        ),
+    );
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.CreateIncidentNotificationTemplate", true);
+    let api = IncidentsAPI::with_config(configuration);
+    let resp = api.create_incident_notification_template(body).await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_incidents_CreateIncidentNotificationTemplate.rs

@@ -0,0 +1,23 @@
+// Delete a notification template returns "No Content" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_incidents::DeleteIncidentNotificationTemplateOptionalParams;
+use datadog_api_client::datadogV2::api_incidents::IncidentsAPI;
+use uuid::Uuid;
+
+#[tokio::main]
+async fn main() {
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.DeleteIncidentNotificationTemplate", true);
+    let api = IncidentsAPI::with_config(configuration);
+    let resp = api
+        .delete_incident_notification_template(
+            Uuid::parse_str("00000000-0000-0000-0000-000000000001").expect("invalid UUID"),
+            DeleteIncidentNotificationTemplateOptionalParams::default(),
+        )
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_incidents_DeleteIncidentNotificationTemplate.rs

@@ -0,0 +1,26 @@
+// Delete incident notification template returns "No Content" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_incidents::DeleteIncidentNotificationTemplateOptionalParams;
+use datadog_api_client::datadogV2::api_incidents::IncidentsAPI;
+
+#[tokio::main]
+async fn main() {
+    // there is a valid "notification_template" in the system
+    let notification_template_data_id =
+        uuid::Uuid::parse_str(&std::env::var("NOTIFICATION_TEMPLATE_DATA_ID").unwrap())
+            .expect("Invalid UUID");
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.DeleteIncidentNotificationTemplate", true);
+    let api = IncidentsAPI::with_config(configuration);
+    let resp = api
+        .delete_incident_notification_template(
+            notification_template_data_id.clone(),
+            DeleteIncidentNotificationTemplateOptionalParams::default(),
+        )
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_incidents_DeleteIncidentNotificationTemplate_1602689347.rs

@@ -0,0 +1,26 @@
+// Get incident notification template returns "OK" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_incidents::GetIncidentNotificationTemplateOptionalParams;
+use datadog_api_client::datadogV2::api_incidents::IncidentsAPI;
+
+#[tokio::main]
+async fn main() {
+    // there is a valid "notification_template" in the system
+    let notification_template_data_id =
+        uuid::Uuid::parse_str(&std::env::var("NOTIFICATION_TEMPLATE_DATA_ID").unwrap())
+            .expect("Invalid UUID");
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.GetIncidentNotificationTemplate", true);
+    let api = IncidentsAPI::with_config(configuration);
+    let resp = api
+        .get_incident_notification_template(
+            notification_template_data_id.clone(),
+            GetIncidentNotificationTemplateOptionalParams::default(),
+        )
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_incidents_GetIncidentNotificationTemplate.rs

@@ -0,0 +1,21 @@
+// List incident notification templates returns "OK" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_incidents::IncidentsAPI;
+use datadog_api_client::datadogV2::api_incidents::ListIncidentNotificationTemplatesOptionalParams;
+
+#[tokio::main]
+async fn main() {
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.ListIncidentNotificationTemplates", true);
+    let api = IncidentsAPI::with_config(configuration);
+    let resp = api
+        .list_incident_notification_templates(
+            ListIncidentNotificationTemplatesOptionalParams::default(),
+        )
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_incidents_ListIncidentNotificationTemplates.rs

@@ -0,0 +1,55 @@
+// Update incident notification template returns "OK" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_incidents::IncidentsAPI;
+use datadog_api_client::datadogV2::api_incidents::UpdateIncidentNotificationTemplateOptionalParams;
+use datadog_api_client::datadogV2::model::IncidentNotificationTemplateType;
+use datadog_api_client::datadogV2::model::IncidentNotificationTemplateUpdateAttributes;
+use datadog_api_client::datadogV2::model::IncidentNotificationTemplateUpdateData;
+use datadog_api_client::datadogV2::model::PatchIncidentNotificationTemplateRequest;
+
+#[tokio::main]
+async fn main() {
+    // there is a valid "notification_template" in the system
+    let notification_template_data_id =
+        uuid::Uuid::parse_str(&std::env::var("NOTIFICATION_TEMPLATE_DATA_ID").unwrap())
+            .expect("Invalid UUID");
+    let body = PatchIncidentNotificationTemplateRequest::new(
+        IncidentNotificationTemplateUpdateData::new(
+            notification_template_data_id.clone(),
+            IncidentNotificationTemplateType::NOTIFICATION_TEMPLATES,
+        )
+        .attributes(
+            IncidentNotificationTemplateUpdateAttributes::new()
+                .category("update".to_string())
+                .content(
+                    r#"Incident Status Update:
+
+Title: Sample Incident Title
+New Status: resolved
+Severity: SEV-2
+Services: web-service, database-service
+Commander: John Doe
+
+For more details, visit the incident page."#
+                        .to_string(),
+                )
+                .name("Example-Incident".to_string())
+                .subject("Incident Update: Sample Incident Title - resolved".to_string()),
+        ),
+    );
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.UpdateIncidentNotificationTemplate", true);
+    let api = IncidentsAPI::with_config(configuration);
+    let resp = api
+        .update_incident_notification_template(
+            notification_template_data_id.clone(),
+            body,
+            UpdateIncidentNotificationTemplateOptionalParams::default(),
+        )
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_incidents_UpdateIncidentNotificationTemplate.rs

@@ -161,25 +161,30 @@ impl Default for Configuration {
             ("v2.get_data_deletion_requests".to_owned(), false),
             ("v2.create_incident".to_owned(), false),
             ("v2.create_incident_integration".to_owned(), false),
+            ("v2.create_incident_notification_template".to_owned(), false),
             ("v2.create_incident_todo".to_owned(), false),
             ("v2.create_incident_type".to_owned(), false),
             ("v2.delete_incident".to_owned(), false),
             ("v2.delete_incident_integration".to_owned(), false),
+            ("v2.delete_incident_notification_template".to_owned(), false),
             ("v2.delete_incident_todo".to_owned(), false),
             ("v2.delete_incident_type".to_owned(), false),
             ("v2.get_incident".to_owned(), false),
             ("v2.get_incident_integration".to_owned(), false),
+            ("v2.get_incident_notification_template".to_owned(), false),
             ("v2.get_incident_todo".to_owned(), false),
             ("v2.get_incident_type".to_owned(), false),
             ("v2.list_incident_attachments".to_owned(), false),
             ("v2.list_incident_integrations".to_owned(), false),
+            ("v2.list_incident_notification_templates".to_owned(), false),
             ("v2.list_incidents".to_owned(), false),
             ("v2.list_incident_todos".to_owned(), false),
             ("v2.list_incident_types".to_owned(), false),
             ("v2.search_incidents".to_owned(), false),
             ("v2.update_incident".to_owned(), false),
             ("v2.update_incident_attachments".to_owned(), false),
             ("v2.update_incident_integration".to_owned(), false),
+            ("v2.update_incident_notification_template".to_owned(), false),
             ("v2.update_incident_todo".to_owned(), false),
             ("v2.update_incident_type".to_owned(), false),
             ("v2.create_aws_account".to_owned(), false),