Add spec for Agentless GetAwsScanOptions (#869)

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

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

.generator/schemas/v2/openapi.yaml

@@ -46152,7 +46152,7 @@ paths:
           $ref: '#/components/responses/NotAuthorizedResponse'
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
-      summary: Get AWS Scan Options
+      summary: List AWS Scan Options
       tags:
       - Agentless Scanning
     post:
@@ -46204,6 +46204,29 @@ paths:
       summary: Delete AWS Scan Options
       tags:
       - Agentless Scanning
+    get:
+      description: Fetches the Agentless scan options for an activated account.
+      operationId: GetAwsScanOptions
+      parameters:
+      - $ref: '#/components/parameters/AwsAccountId'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AwsScanOptionsResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Get AWS scan options
+      tags:
+      - Agentless Scanning
     patch:
       description: Update the Agentless scan options for an activated account.
       operationId: UpdateAwsScanOptions

examples/v2_agentless-scanning_GetAwsScanOptions.rs

@@ -0,0 +1,17 @@
+// Get AWS scan options returns "OK" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_agentless_scanning::AgentlessScanningAPI;
+
+#[tokio::main]
+async fn main() {
+    // there is a valid "aws_scan_options" in the system
+    let aws_scan_options_id = std::env::var("AWS_SCAN_OPTIONS_ID").unwrap();
+    let configuration = datadog::Configuration::new();
+    let api = AgentlessScanningAPI::with_config(configuration);
+    let resp = api.get_aws_scan_options(aws_scan_options_id.clone()).await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

examples/v2_agentless-scanning_ListAwsScanOptions.rs

@@ -1,4 +1,4 @@
-// Get AWS Scan Options returns "OK" response
+// List AWS Scan Options returns "OK" response
 use datadog_api_client::datadog;
 use datadog_api_client::datadogV2::api_agentless_scanning::AgentlessScanningAPI;
 

src/datadogV2/api/api_agentless_scanning.rs

@@ -42,6 +42,14 @@ pub enum GetAwsOnDemandTaskError {
     UnknownValue(serde_json::Value),
 }
 
+/// GetAwsScanOptionsError is a struct for typed errors of method [`AgentlessScanningAPI::get_aws_scan_options`]
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(untagged)]
+pub enum GetAwsScanOptionsError {
+    APIErrorResponse(crate::datadogV2::model::APIErrorResponse),
+    UnknownValue(serde_json::Value),
+}
+
 /// ListAwsOnDemandTasksError is a struct for typed errors of method [`AgentlessScanningAPI::list_aws_on_demand_tasks`]
 #[derive(Debug, Clone, Serialize, Deserialize)]
 #[serde(untagged)]
@@ -641,6 +649,115 @@ impl AgentlessScanningAPI {
         }
     }
 
+    /// Fetches the Agentless scan options for an activated account.
+    pub async fn get_aws_scan_options(
+        &self,
+        account_id: String,
+    ) -> Result<
+        crate::datadogV2::model::AwsScanOptionsResponse,
+        datadog::Error<GetAwsScanOptionsError>,
+    > {
+        match self.get_aws_scan_options_with_http_info(account_id).await {
+            Ok(response_content) => {
+                if let Some(e) = response_content.entity {
+                    Ok(e)
+                } else {
+                    Err(datadog::Error::Serde(serde::de::Error::custom(
+                        "response content was None",
+                    )))
+                }
+            }
+            Err(err) => Err(err),
+        }
+    }
+
+    /// Fetches the Agentless scan options for an activated account.
+    pub async fn get_aws_scan_options_with_http_info(
+        &self,
+        account_id: String,
+    ) -> Result<
+        datadog::ResponseContent<crate::datadogV2::model::AwsScanOptionsResponse>,
+        datadog::Error<GetAwsScanOptionsError>,
+    > {
+        let local_configuration = &self.config;
+        let operation_id = "v2.get_aws_scan_options";
+
+        let local_client = &self.client;
+
+        let local_uri_str = format!(
+            "{}/api/v2/agentless_scanning/accounts/aws/{account_id}",
+            local_configuration.get_operation_host(operation_id),
+            account_id = datadog::urlencode(account_id)
+        );
+        let mut local_req_builder =
+            local_client.request(reqwest::Method::GET, local_uri_str.as_str());
+
+        // build headers
+        let mut headers = HeaderMap::new();
+        headers.insert("Accept", HeaderValue::from_static("application/json"));
+
+        // build user agent
+        match HeaderValue::from_str(local_configuration.user_agent.as_str()) {
+            Ok(user_agent) => headers.insert(reqwest::header::USER_AGENT, user_agent),
+            Err(e) => {
+                log::warn!("Failed to parse user agent header: {e}, falling back to default");
+                headers.insert(
+                    reqwest::header::USER_AGENT,
+                    HeaderValue::from_static(datadog::DEFAULT_USER_AGENT.as_str()),
+                )
+            }
+        };
+
+        // build auth
+        if let Some(local_key) = local_configuration.auth_keys.get("apiKeyAuth") {
+            headers.insert(
+                "DD-API-KEY",
+                HeaderValue::from_str(local_key.key.as_str())
+                    .expect("failed to parse DD-API-KEY header"),
+            );
+        };
+        if let Some(local_key) = local_configuration.auth_keys.get("appKeyAuth") {
+            headers.insert(
+                "DD-APPLICATION-KEY",
+                HeaderValue::from_str(local_key.key.as_str())
+                    .expect("failed to parse DD-APPLICATION-KEY header"),
+            );
+        };
+
+        local_req_builder = local_req_builder.headers(headers);
+        let local_req = local_req_builder.build()?;
+        log::debug!("request content: {:?}", local_req.body());
+        let local_resp = local_client.execute(local_req).await?;
+
+        let local_status = local_resp.status();
+        let local_content = local_resp.text().await?;
+        log::debug!("response content: {}", local_content);
+
+        if !local_status.is_client_error() && !local_status.is_server_error() {
+            match serde_json::from_str::<crate::datadogV2::model::AwsScanOptionsResponse>(
+                &local_content,
+            ) {
+                Ok(e) => {
+                    return Ok(datadog::ResponseContent {
+                        status: local_status,
+                        content: local_content,
+                        entity: Some(e),
+                    })
+                }
+                Err(e) => return Err(datadog::Error::Serde(e)),
+            };
+        } else {
+            let local_entity: Option<GetAwsScanOptionsError> =
+                serde_json::from_str(&local_content).ok();
+            let local_error = datadog::ResponseContent {
+                status: local_status,
+                content: local_content,
+                entity: local_entity,
+            };
+            Err(datadog::Error::ResponseError(local_error))
+        }
+    }
+
     /// Fetches the most recent 1000 AWS on demand tasks.
     pub async fn list_aws_on_demand_tasks(
         &self,

tests/scenarios/cassettes/v2/agentless_scanning/Get-AWS-Scan-Options-returns-OK-response.frozen

@@ -0,0 +1 @@
+2025-08-27T13:04:35.618Z

tests/scenarios/cassettes/v2/agentless_scanning/Get-AWS-scan-options-returns-Bad-Request-response.frozen

@@ -0,0 +1,33 @@
+{
+  "http_interactions": [
+    {
+      "request": {
+        "body": "",
+        "headers": {
+          "Accept": [
+            "application/json"
+          ]
+        },
+        "method": "get",
+        "uri": "https://api.datadoghq.com/api/v2/agentless_scanning/accounts/aws/not-an-account-id"
+      },
+      "response": {
+        "body": {
+          "string": "{\"errors\":[{\"title\":\"Generic Error\",\"detail\":\"missing or invalid url parameter 'accountId', expected 12 digit format '123456789012'\"}]}",
+          "encoding": null
+        },
+        "headers": {
+          "Content-Type": [
+            "application/vnd.api+json"
+          ]
+        },
+        "status": {
+          "code": 400,
+          "message": "Bad Request"
+        }
+      },
+      "recorded_at": "Wed, 27 Aug 2025 13:04:35 GMT"
+    }
+  ],
+  "recorded_with": "VCR 6.0.0"
+}

tests/scenarios/cassettes/v2/agentless_scanning/Get-AWS-scan-options-returns-Bad-Request-response.json

@@ -0,0 +1 @@
+2025-08-27T01:14:07.103Z

tests/scenarios/cassettes/v2/agentless_scanning/Get-AWS-scan-options-returns-Not-Found-response.frozen

@@ -0,0 +1,33 @@
+{
+  "http_interactions": [
+    {
+      "request": {
+        "body": "",
+        "headers": {
+          "Accept": [
+            "application/json"
+          ]
+        },
+        "method": "get",
+        "uri": "https://api.datadoghq.com/api/v2/agentless_scanning/accounts/aws/404404404404"
+      },
+      "response": {
+        "body": {
+          "string": "{\"errors\":[{\"status\":\"404\",\"detail\":\"no aws scan options found for subscription 404404404404\"}]}",
+          "encoding": null
+        },
+        "headers": {
+          "Content-Type": [
+            "application/vnd.api+json"
+          ]
+        },
+        "status": {
+          "code": 404,
+          "message": "Not Found"
+        }
+      },
+      "recorded_at": "Wed, 27 Aug 2025 01:14:07 GMT"
+    }
+  ],
+  "recorded_with": "VCR 6.0.0"
+}

tests/scenarios/cassettes/v2/agentless_scanning/Get-AWS-scan-options-returns-Not-Found-response.json

@@ -0,0 +1 @@
+2025-08-27T01:14:24.197Z