Add OpenAPI documentation for secmon-public-api datasets endpoints

examples/v2/security-monitoring/BatchGetSecurityMonitoringDatasetDependencies.rb

@@ -0,0 +1,19 @@
+# Get dataset dependencies returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.batch_get_security_monitoring_dataset_dependencies".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new
+
+body = DatadogAPIClient::V2::SecurityMonitoringDatasetDependenciesRequest.new({
+  data: DatadogAPIClient::V2::SecurityMonitoringDatasetDependenciesDataRequest.new({
+    attributes: DatadogAPIClient::V2::SecurityMonitoringDatasetDependenciesAttributesRequest.new({
+      dataset_ids: [
+        "dataset-1",
+      ],
+    }),
+    type: DatadogAPIClient::V2::SecurityMonitoringDatasetDependenciesType::SECURITY_MONITORING_DATASET_DEPENDENCIES,
+  }),
+})
+p api_instance.batch_get_security_monitoring_dataset_dependencies(body)

examples/v2/security-monitoring/CreateSecurityMonitoringDataset.rb

@@ -0,0 +1,30 @@
+# Create a dataset returns "Created" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.create_security_monitoring_dataset".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new
+
+body = DatadogAPIClient::V2::SecurityMonitoringDatasetCreateRequest.new({
+  data: DatadogAPIClient::V2::SecurityMonitoringDatasetCreateDataRequest.new({
+    attributes: DatadogAPIClient::V2::SecurityMonitoringDatasetCreateAttributesRequest.new({
+      definition: DatadogAPIClient::V2::SecurityMonitoringDatasetDefinition.new({
+        columns: [
+          DatadogAPIClient::V2::SecurityMonitoringDatasetDefinitionColumn.new({
+            column: "message",
+            type: DatadogAPIClient::V2::SecurityMonitoringDatasetDefinitionColumnType::STRING,
+          }),
+        ],
+        data_source: "logs",
+        indexes: [
+          "k9",
+        ],
+        name: "my_dataset",
+      }),
+      description: "A dataset for monitoring authentication events",
+    }),
+    type: DatadogAPIClient::V2::SecurityMonitoringDatasetType::SECURITY_MONITORING_DATASET,
+  }),
+})
+p api_instance.create_security_monitoring_dataset(body)

examples/v2/security-monitoring/DeleteSecurityMonitoringDataset.rb

@@ -0,0 +1,8 @@
+# Delete a dataset returns "No Content" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.delete_security_monitoring_dataset".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new
+api_instance.delete_security_monitoring_dataset("123e4567-e89b-12d3-a456-426614174000")

examples/v2/security-monitoring/GetSecurityMonitoringDataset.rb

@@ -0,0 +1,8 @@
+# Get a dataset returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.get_security_monitoring_dataset".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new
+p api_instance.get_security_monitoring_dataset("123e4567-e89b-12d3-a456-426614174000")

examples/v2/security-monitoring/GetSecurityMonitoringDatasetByVersion.rb

@@ -0,0 +1,8 @@
+# Get a dataset by version returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.get_security_monitoring_dataset_by_version".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new
+p api_instance.get_security_monitoring_dataset_by_version("123e4567-e89b-12d3-a456-426614174000", 1)

examples/v2/security-monitoring/GetSecurityMonitoringDatasetHistory.rb

@@ -0,0 +1,8 @@
+# Get dataset history returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.get_security_monitoring_dataset_history".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new
+p api_instance.get_security_monitoring_dataset_history("123e4567-e89b-12d3-a456-426614174000")

examples/v2/security-monitoring/ListSecurityMonitoringDatasets.rb

@@ -0,0 +1,8 @@
+# List all datasets returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.list_security_monitoring_datasets".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new
+p api_instance.list_security_monitoring_datasets()

examples/v2/security-monitoring/UpdateSecurityMonitoringDataset.rb

@@ -0,0 +1,31 @@
+# Update a dataset returns "No Content" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.update_security_monitoring_dataset".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new
+
+body = DatadogAPIClient::V2::SecurityMonitoringDatasetUpdateRequest.new({
+  data: DatadogAPIClient::V2::SecurityMonitoringDatasetUpdateDataRequest.new({
+    attributes: DatadogAPIClient::V2::SecurityMonitoringDatasetUpdateAttributesRequest.new({
+      definition: DatadogAPIClient::V2::SecurityMonitoringDatasetDefinition.new({
+        columns: [
+          DatadogAPIClient::V2::SecurityMonitoringDatasetDefinitionColumn.new({
+            column: "message",
+            type: DatadogAPIClient::V2::SecurityMonitoringDatasetDefinitionColumnType::STRING,
+          }),
+        ],
+        data_source: "logs",
+        indexes: [
+          "k9",
+        ],
+        name: "my_dataset",
+      }),
+      description: "Updated dataset description",
+      version: 1,
+    }),
+    type: DatadogAPIClient::V2::SecurityMonitoringDatasetType::SECURITY_MONITORING_DATASET,
+  }),
+})
+api_instance.update_security_monitoring_dataset("123e4567-e89b-12d3-a456-426614174000", body)

features/scenarios_model_mapping.rb

@@ -1590,6 +1590,35 @@
             "page_size" => "Integer",
             "page_number" => "Integer",
     },
+    "v2.ListSecurityMonitoringDatasets" => {
+            "page_size" => "Integer",
+            "page_number" => "Integer",
+            "sort" => "String",
+            "filter_query" => "String",
+    },
+    "v2.CreateSecurityMonitoringDataset" => {
+            "body" => "SecurityMonitoringDatasetCreateRequest",
+    },
+    "v2.BatchGetSecurityMonitoringDatasetDependencies" => {
+            "body" => "SecurityMonitoringDatasetDependenciesRequest",
+    },
+    "v2.DeleteSecurityMonitoringDataset" => {
+            "dataset_id" => "UUID",
+    },
+    "v2.GetSecurityMonitoringDataset" => {
+            "dataset_id" => "UUID",
+    },
+    "v2.UpdateSecurityMonitoringDataset" => {
+            "dataset_id" => "UUID",
+            "body" => "SecurityMonitoringDatasetUpdateRequest",
+    },
+    "v2.GetSecurityMonitoringDatasetHistory" => {
+            "dataset_id" => "UUID",
+    },
+    "v2.GetSecurityMonitoringDatasetByVersion" => {
+            "dataset_id" => "UUID",
+            "version" => "Integer",
+    },
     "v2.ListSecurityMonitoringRules" => {
             "page_size" => "Integer",
             "page_number" => "Integer",

features/v2/security_monitoring.feature

@@ -408,6 +408,22 @@ Feature: Security Monitoring
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Create a dataset returns "Bad Request" response
+    Given operation "CreateSecurityMonitoringDataset" enabled
+    And new "CreateSecurityMonitoringDataset" request
+    And body with value {"data": {"attributes": {"definition": {"columns": [{"column": "message", "type": "string"}], "data_source": "logs", "indexes": ["k9"], "name": "my_dataset"}, "description": "A dataset for monitoring authentication events"}, "type": "security_monitoring_dataset"}}
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Create a dataset returns "Created" response
+    Given operation "CreateSecurityMonitoringDataset" enabled
+    And new "CreateSecurityMonitoringDataset" request
+    And body with value {"data": {"attributes": {"definition": {"columns": [{"column": "message", "type": "string"}], "data_source": "logs", "indexes": ["k9"], "name": "my_dataset"}, "description": "A dataset for monitoring authentication events"}, "type": "security_monitoring_dataset"}}
+    When the request is sent
+    Then the response status is 201 Created
+
   @skip @team:DataDog/k9-cloud-security-platform
   Scenario: Create a detection rule returns "Bad Request" response
     Given new "CreateSecurityMonitoringRule" request
@@ -713,6 +729,30 @@ Feature: Security Monitoring
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Delete a dataset returns "Bad Request" response
+    Given operation "DeleteSecurityMonitoringDataset" enabled
+    And new "DeleteSecurityMonitoringDataset" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Delete a dataset returns "No Content" response
+    Given operation "DeleteSecurityMonitoringDataset" enabled
+    And new "DeleteSecurityMonitoringDataset" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 204 No Content
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Delete a dataset returns "Not Found" response
+    Given operation "DeleteSecurityMonitoringDataset" enabled
+    And new "DeleteSecurityMonitoringDataset" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 404 Not Found
+
   @skip @team:DataDog/k9-cloud-security-platform
   Scenario: Delete a non existing rule returns "Not Found" response
     Given new "DeleteSecurityMonitoringRule" request
@@ -923,6 +963,57 @@ Feature: Security Monitoring
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get a dataset by version returns "Bad Request" response
+    Given operation "GetSecurityMonitoringDatasetByVersion" enabled
+    And new "GetSecurityMonitoringDatasetByVersion" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    And request contains "version" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get a dataset by version returns "Not Found" response
+    Given operation "GetSecurityMonitoringDatasetByVersion" enabled
+    And new "GetSecurityMonitoringDatasetByVersion" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    And request contains "version" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 404 Not Found
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get a dataset by version returns "OK" response
+    Given operation "GetSecurityMonitoringDatasetByVersion" enabled
+    And new "GetSecurityMonitoringDatasetByVersion" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    And request contains "version" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get a dataset returns "Bad Request" response
+    Given operation "GetSecurityMonitoringDataset" enabled
+    And new "GetSecurityMonitoringDataset" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get a dataset returns "Not Found" response
+    Given operation "GetSecurityMonitoringDataset" enabled
+    And new "GetSecurityMonitoringDataset" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 404 Not Found
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get a dataset returns "OK" response
+    Given operation "GetSecurityMonitoringDataset" enabled
+    And new "GetSecurityMonitoringDataset" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK
+
   @generated @skip @team:DataDog/cloud-security-posture-management
   Scenario: Get a finding returns "Bad Request: The server cannot process the request due to invalid syntax in the request." response
     Given operation "GetFinding" enabled
@@ -1240,6 +1331,46 @@ Feature: Security Monitoring
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get dataset dependencies returns "Bad Request" response
+    Given operation "BatchGetSecurityMonitoringDatasetDependencies" enabled
+    And new "BatchGetSecurityMonitoringDatasetDependencies" request
+    And body with value {"data": {"attributes": {"datasetIds": ["dataset-1"]}, "type": "security_monitoring_dataset_dependencies"}}
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get dataset dependencies returns "OK" response
+    Given operation "BatchGetSecurityMonitoringDatasetDependencies" enabled
+    And new "BatchGetSecurityMonitoringDatasetDependencies" request
+    And body with value {"data": {"attributes": {"datasetIds": ["dataset-1"]}, "type": "security_monitoring_dataset_dependencies"}}
+    When the request is sent
+    Then the response status is 200 OK
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get dataset history returns "Bad Request" response
+    Given operation "GetSecurityMonitoringDatasetHistory" enabled
+    And new "GetSecurityMonitoringDatasetHistory" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get dataset history returns "Not Found" response
+    Given operation "GetSecurityMonitoringDatasetHistory" enabled
+    And new "GetSecurityMonitoringDatasetHistory" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 404 Not Found
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get dataset history returns "OK" response
+    Given operation "GetSecurityMonitoringDatasetHistory" enabled
+    And new "GetSecurityMonitoringDatasetHistory" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK
+
   @generated @skip @team:DataDog/cloud-security-posture-management
   Scenario: Get details of a signal-based notification rule returns "Bad Request" response
     Given new "GetSignalNotificationRule" request
@@ -1340,6 +1471,27 @@ Feature: Security Monitoring
     When the request is sent
     Then the response status is 200 The list of notification rules.
 
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: List all datasets returns "Bad Request" response
+    Given operation "ListSecurityMonitoringDatasets" enabled
+    And new "ListSecurityMonitoringDatasets" request
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: List all datasets returns "Not Found" response
+    Given operation "ListSecurityMonitoringDatasets" enabled
+    And new "ListSecurityMonitoringDatasets" request
+    When the request is sent
+    Then the response status is 404 Not Found
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: List all datasets returns "OK" response
+    Given operation "ListSecurityMonitoringDatasets" enabled
+    And new "ListSecurityMonitoringDatasets" request
+    When the request is sent
+    Then the response status is 200 OK
+
   @generated @skip @team:DataDog/k9-cloud-vm
   Scenario: List assets SBOMs returns "Bad request: The server cannot process the request due to invalid syntax in the request." response
     Given new "ListAssetsSBOMs" request
@@ -1907,6 +2059,42 @@ Feature: Security Monitoring
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Update a dataset returns "Bad Request" response
+    Given operation "UpdateSecurityMonitoringDataset" enabled
+    And new "UpdateSecurityMonitoringDataset" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    And body with value {"data": {"attributes": {"definition": {"columns": [{"column": "message", "type": "string"}], "data_source": "logs", "indexes": ["k9"], "name": "my_dataset"}, "description": "Updated dataset description", "version": 1}, "type": "security_monitoring_dataset"}}
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Update a dataset returns "Conflict" response
+    Given operation "UpdateSecurityMonitoringDataset" enabled
+    And new "UpdateSecurityMonitoringDataset" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    And body with value {"data": {"attributes": {"definition": {"columns": [{"column": "message", "type": "string"}], "data_source": "logs", "indexes": ["k9"], "name": "my_dataset"}, "description": "Updated dataset description", "version": 1}, "type": "security_monitoring_dataset"}}
+    When the request is sent
+    Then the response status is 409 Conflict
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Update a dataset returns "No Content" response
+    Given operation "UpdateSecurityMonitoringDataset" enabled
+    And new "UpdateSecurityMonitoringDataset" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    And body with value {"data": {"attributes": {"definition": {"columns": [{"column": "message", "type": "string"}], "data_source": "logs", "indexes": ["k9"], "name": "my_dataset"}, "description": "Updated dataset description", "version": 1}, "type": "security_monitoring_dataset"}}
+    When the request is sent
+    Then the response status is 204 No Content
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Update a dataset returns "Not Found" response
+    Given operation "UpdateSecurityMonitoringDataset" enabled
+    And new "UpdateSecurityMonitoringDataset" request
+    And request contains "dataset_id" parameter from "REPLACE.ME"
+    And body with value {"data": {"attributes": {"definition": {"columns": [{"column": "message", "type": "string"}], "data_source": "logs", "indexes": ["k9"], "name": "my_dataset"}, "description": "Updated dataset description", "version": 1}, "type": "security_monitoring_dataset"}}
+    When the request is sent
+    Then the response status is 404 Not Found
+
   @generated @skip @team:DataDog/k9-cloud-security-platform
   Scenario: Update a security filter returns "Bad Request" response
     Given new "UpdateSecurityFilter" request