Add OpenAPI documentation for catalog-http service endpoints

examples/v2_software-catalog_AcceptRecommendedEntities.rs

@@ -0,0 +1,84 @@
+// Accept recommended entities in bulk returns "Accepted" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_software_catalog::SoftwareCatalogAPI;
+use datadog_api_client::datadogV2::model::EntityV3;
+use datadog_api_client::datadogV2::model::EntityV3APIVersion;
+use datadog_api_client::datadogV2::model::EntityV3DatadogCodeLocationItem;
+use datadog_api_client::datadogV2::model::EntityV3DatadogEventItem;
+use datadog_api_client::datadogV2::model::EntityV3DatadogIntegrationOpsgenie;
+use datadog_api_client::datadogV2::model::EntityV3DatadogIntegrationPagerduty;
+use datadog_api_client::datadogV2::model::EntityV3DatadogLogItem;
+use datadog_api_client::datadogV2::model::EntityV3DatadogPerformance;
+use datadog_api_client::datadogV2::model::EntityV3DatadogPipelines;
+use datadog_api_client::datadogV2::model::EntityV3Integrations;
+use datadog_api_client::datadogV2::model::EntityV3Metadata;
+use datadog_api_client::datadogV2::model::EntityV3MetadataAdditionalOwnersItems;
+use datadog_api_client::datadogV2::model::EntityV3MetadataContactsItems;
+use datadog_api_client::datadogV2::model::EntityV3MetadataLinksItems;
+use datadog_api_client::datadogV2::model::EntityV3Service;
+use datadog_api_client::datadogV2::model::EntityV3ServiceDatadog;
+use datadog_api_client::datadogV2::model::EntityV3ServiceKind;
+use datadog_api_client::datadogV2::model::EntityV3ServiceSpec;
+use datadog_api_client::datadogV2::model::RecommendedEntityWithSchema;
+
+#[tokio::main]
+async fn main() {
+    let body = vec![RecommendedEntityWithSchema::new(
+        "123abc456def".to_string(),
+        EntityV3::EntityV3Service(Box::new(
+            EntityV3Service::new(
+                EntityV3APIVersion::V3,
+                EntityV3ServiceKind::SERVICE,
+                EntityV3Metadata::new("myService".to_string())
+                    .additional_owners(vec![EntityV3MetadataAdditionalOwnersItems::new(
+                        "".to_string(),
+                    )])
+                    .contacts(vec![EntityV3MetadataContactsItems::new(
+                        "https://slack/".to_string(),
+                        "slack".to_string(),
+                    )])
+                    .id("4b163705-23c0-4573-b2fb-f6cea2163fcb".to_string())
+                    .inherit_from("application:default/myapp".to_string())
+                    .links(vec![EntityV3MetadataLinksItems::new(
+                        "mylink".to_string(),
+                        "link".to_string(),
+                        "https://mylink".to_string(),
+                    )])
+                    .namespace("default".to_string())
+                    .tags(vec!["this:tag".to_string(), "that:tag".to_string()]),
+            )
+            .datadog(
+                EntityV3ServiceDatadog::new()
+                    .code_locations(vec![EntityV3DatadogCodeLocationItem::new().paths(vec![])])
+                    .events(vec![EntityV3DatadogEventItem::new()])
+                    .logs(vec![EntityV3DatadogLogItem::new()])
+                    .performance_data(EntityV3DatadogPerformance::new().tags(vec![]))
+                    .pipelines(EntityV3DatadogPipelines::new().fingerprints(vec![])),
+            )
+            .integrations(
+                EntityV3Integrations::new()
+                    .opsgenie(EntityV3DatadogIntegrationOpsgenie::new(
+                        "https://www.opsgenie.com/service/shopping-cart".to_string(),
+                    ))
+                    .pagerduty(EntityV3DatadogIntegrationPagerduty::new(
+                        "https://www.pagerduty.com/service-directory/Pshopping-cart".to_string(),
+                    )),
+            )
+            .spec(
+                EntityV3ServiceSpec::new()
+                    .component_of(vec![])
+                    .depends_on(vec![])
+                    .languages(vec![]),
+            ),
+        )),
+    )];
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.AcceptRecommendedEntities", true);
+    let api = SoftwareCatalogAPI::with_config(configuration);
+    let resp = api.accept_recommended_entities(body).await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_software-catalog_ConvertCatalogEntities.rs

@@ -0,0 +1,84 @@
+// Convert entities between schema versions returns "OK" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_software_catalog::SoftwareCatalogAPI;
+use datadog_api_client::datadogV2::model::EntitySchemaVersion;
+use datadog_api_client::datadogV2::model::EntityV3;
+use datadog_api_client::datadogV2::model::EntityV3APIVersion;
+use datadog_api_client::datadogV2::model::EntityV3DatadogCodeLocationItem;
+use datadog_api_client::datadogV2::model::EntityV3DatadogEventItem;
+use datadog_api_client::datadogV2::model::EntityV3DatadogIntegrationOpsgenie;
+use datadog_api_client::datadogV2::model::EntityV3DatadogIntegrationPagerduty;
+use datadog_api_client::datadogV2::model::EntityV3DatadogLogItem;
+use datadog_api_client::datadogV2::model::EntityV3DatadogPerformance;
+use datadog_api_client::datadogV2::model::EntityV3DatadogPipelines;
+use datadog_api_client::datadogV2::model::EntityV3Integrations;
+use datadog_api_client::datadogV2::model::EntityV3Metadata;
+use datadog_api_client::datadogV2::model::EntityV3MetadataAdditionalOwnersItems;
+use datadog_api_client::datadogV2::model::EntityV3MetadataContactsItems;
+use datadog_api_client::datadogV2::model::EntityV3MetadataLinksItems;
+use datadog_api_client::datadogV2::model::EntityV3Service;
+use datadog_api_client::datadogV2::model::EntityV3ServiceDatadog;
+use datadog_api_client::datadogV2::model::EntityV3ServiceKind;
+use datadog_api_client::datadogV2::model::EntityV3ServiceSpec;
+use datadog_api_client::datadogV2::model::UpsertCatalogEntityRequest;
+
+#[tokio::main]
+async fn main() {
+    let body = UpsertCatalogEntityRequest::EntityV3(Box::new(EntityV3::EntityV3Service(Box::new(
+        EntityV3Service::new(
+            EntityV3APIVersion::V3,
+            EntityV3ServiceKind::SERVICE,
+            EntityV3Metadata::new("myService".to_string())
+                .additional_owners(vec![EntityV3MetadataAdditionalOwnersItems::new(
+                    "".to_string(),
+                )])
+                .contacts(vec![EntityV3MetadataContactsItems::new(
+                    "https://slack/".to_string(),
+                    "slack".to_string(),
+                )])
+                .id("4b163705-23c0-4573-b2fb-f6cea2163fcb".to_string())
+                .inherit_from("application:default/myapp".to_string())
+                .links(vec![EntityV3MetadataLinksItems::new(
+                    "mylink".to_string(),
+                    "link".to_string(),
+                    "https://mylink".to_string(),
+                )])
+                .namespace("default".to_string())
+                .tags(vec!["this:tag".to_string(), "that:tag".to_string()]),
+        )
+        .datadog(
+            EntityV3ServiceDatadog::new()
+                .code_locations(vec![EntityV3DatadogCodeLocationItem::new().paths(vec![])])
+                .events(vec![EntityV3DatadogEventItem::new()])
+                .logs(vec![EntityV3DatadogLogItem::new()])
+                .performance_data(EntityV3DatadogPerformance::new().tags(vec![]))
+                .pipelines(EntityV3DatadogPipelines::new().fingerprints(vec![])),
+        )
+        .integrations(
+            EntityV3Integrations::new()
+                .opsgenie(EntityV3DatadogIntegrationOpsgenie::new(
+                    "https://www.opsgenie.com/service/shopping-cart".to_string(),
+                ))
+                .pagerduty(EntityV3DatadogIntegrationPagerduty::new(
+                    "https://www.pagerduty.com/service-directory/Pshopping-cart".to_string(),
+                )),
+        )
+        .spec(
+            EntityV3ServiceSpec::new()
+                .component_of(vec![])
+                .depends_on(vec![])
+                .languages(vec![]),
+        ),
+    ))));
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.ConvertCatalogEntities", true);
+    let api = SoftwareCatalogAPI::with_config(configuration);
+    let resp = api
+        .convert_catalog_entities(EntitySchemaVersion::V3, body)
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_software-catalog_DeclineRecommendedEntities.rs

@@ -0,0 +1,18 @@
+// Decline recommended entities in bulk returns "No Content" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_software_catalog::SoftwareCatalogAPI;
+use datadog_api_client::datadogV2::model::RecommendedEntityID;
+
+#[tokio::main]
+async fn main() {
+    let body = vec![RecommendedEntityID::new("123abcdef".to_string())];
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.DeclineRecommendedEntities", true);
+    let api = SoftwareCatalogAPI::with_config(configuration);
+    let resp = api.decline_recommended_entities(body).await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_software-catalog_GetIDPConfigValue.rs

@@ -0,0 +1,18 @@
+// Get Internal Developer Portal configuration returns "OK" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_software_catalog::SoftwareCatalogAPI;
+
+#[tokio::main]
+async fn main() {
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.GetIDPConfigValue", true);
+    let api = SoftwareCatalogAPI::with_config(configuration);
+    let resp = api
+        .get_idp_config_value("idp_pinned_dashboards".to_string())
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_software-catalog_TriggerRecommendedEntities.rs

@@ -0,0 +1,19 @@
+// Trigger recommended entity discovery returns "Accepted" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_software_catalog::SoftwareCatalogAPI;
+use datadog_api_client::datadogV2::api_software_catalog::TriggerRecommendedEntitiesOptionalParams;
+
+#[tokio::main]
+async fn main() {
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.TriggerRecommendedEntities", true);
+    let api = SoftwareCatalogAPI::with_config(configuration);
+    let resp = api
+        .trigger_recommended_entities(TriggerRecommendedEntitiesOptionalParams::default())
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_software-catalog_UpsertIDPConfigValue.rs

@@ -0,0 +1,31 @@
+// Create or update IDP configuration returns "No Content" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_software_catalog::SoftwareCatalogAPI;
+use datadog_api_client::datadogV2::model::IDPConfigRequest;
+use datadog_api_client::datadogV2::model::IDPConfigRequestAttributes;
+use datadog_api_client::datadogV2::model::IDPConfigRequestData;
+use datadog_api_client::datadogV2::model::IDPConfigType;
+use serde_json::Value;
+use std::collections::BTreeMap;
+
+#[tokio::main]
+async fn main() {
+    let body = IDPConfigRequest::new(IDPConfigRequestData::new(
+        IDPConfigRequestAttributes::new(vec![BTreeMap::from([
+            ("displayName".to_string(), Value::from("My Dashboard")),
+            ("id".to_string(), Value::from("dashboard-1")),
+        ])]),
+        IDPConfigType::IDP_CONFIG,
+    ));
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.UpsertIDPConfigValue", true);
+    let api = SoftwareCatalogAPI::with_config(configuration);
+    let resp = api
+        .upsert_idp_config_value("idp_pinned_dashboards".to_string(), body)
+        .await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

src/datadog/configuration.rs

@@ -148,6 +148,12 @@ impl Default for Configuration {
             ("v2.link_jira_issue_to_case".to_owned(), false),
             ("v2.move_case_to_project".to_owned(), false),
             ("v2.unlink_jira_issue".to_owned(), false),
+            ("v2.accept_recommended_entities".to_owned(), false),
+            ("v2.convert_catalog_entities".to_owned(), false),
+            ("v2.decline_recommended_entities".to_owned(), false),
+            ("v2.get_idp_config_value".to_owned(), false),
+            ("v2.trigger_recommended_entities".to_owned(), false),
+            ("v2.upsert_idp_config_value".to_owned(), false),
             ("v2.create_change_request".to_owned(), false),
             ("v2.create_change_request_branch".to_owned(), false),
             ("v2.delete_change_request_decision".to_owned(), false),