Regenerate client from commit 9a73736 of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -41081,6 +41081,16 @@ components:
           example: report_id
           type: string
       type: object
+    SbomFormat:
+      description: The SBOM standard
+      enum:
+      - CycloneDX
+      - SPDX
+      example: CycloneDX
+      type: string
+      x-enum-varnames:
+      - CYCLONEDX
+      - SPDX
     ScalarColumn:
       description: A single column in a scalar query response.
       oneOf:
@@ -51419,13 +51429,29 @@ components:
       - attributes
       - relationships
       type: object
-    VulnerabilityAttributes:
-      description: The JSON:API attributes of the vulnerability.
+    VulnerabilityAdvisory:
+      description: Advisory that associated with the vulnerability.
       properties:
-        advisory_id:
+        id:
           description: Vulnerability advisory ID.
           example: TRIVY-CVE-2023-0615
           type: string
+        last_modification_date:
+          description: Vulnerability advisory last modification date.
+          example: 2024-09-19 21:23:08+00:00
+          type: string
+        publish_date:
+          description: Vulnerability advisory publish date.
+          example: 2024-09-19 21:23:08+00:00
+          type: string
+      required:
+      - id
+      type: object
+    VulnerabilityAttributes:
+      description: The JSON:API attributes of the vulnerability.
+      properties:
+        advisory:
+          $ref: '#/components/schemas/VulnerabilityAdvisory'
         code_location:
           $ref: '#/components/schemas/CodeLocation'
         cve_list:
@@ -70913,7 +70939,7 @@ paths:
           format: int64
           minimum: 1
           type: integer
-      - description: Filter by name.
+      - description: Filter by name. This field supports the usage of wildcards (*).
         example: datadog-agent
         in: query
         name: filter[name]
@@ -71208,7 +71234,7 @@ paths:
       security:
       - apiKeyAuth: []
         appKeyAuth: []
-      summary: List assets SBOMs
+      summary: List SBOMs
       tags:
       - Security Monitoring
       x-unstable: '**Note**: This endpoint is a private preview.
@@ -71241,6 +71267,13 @@ paths:
         required: false
         schema:
           type: string
+      - description: The standard of the SBOM.
+        example: CycloneDX
+        in: query
+        name: ext:format
+        required: false
+        schema:
+          $ref: '#/components/schemas/SbomFormat'
       responses:
         '200':
           content:
@@ -71468,7 +71501,8 @@ paths:
         consider a request to be the first request when there is no `page[token]`
         parameter.\n\nThe response of this first request contains the newly created
         token in the `links` section.\n\nThis token can then be used in the subsequent
-        paginated requests.\n\n#### Subsequent requests\n\nAny request containing
+        paginated requests.\n\n*Note: The first request may take longer to complete
+        than subsequent requests.*\n\n#### Subsequent requests\n\nAny request containing
         valid `page[token]` and `page[number]` parameters will be considered a subsequent
         request.\n\nIf the `token` is invalid, a `404` response will be returned.\n\nIf
         the page `number` is invalid, a `400` response will be returned.\n\n### Filtering\n\nThe
@@ -71488,7 +71522,12 @@ paths:
         For more details on each of the properties included in this section, check
         the endpoints response tables.\n\n```JSON\n{\n  \"data\": [...],\n  \"meta\":
         {\n    \"total\": 1500,\n    \"count\": 18732,\n    \"token\": \"some_token\"\n
-        \ },\n  \"links\": {...}\n}\n```"
+        \ },\n  \"links\": {...}\n}\n```\n### Extensions\n\nThe request in some cases
+        can include extensions to update behavior of the endpoint requested. The format
+        of the filter parameters follows the [JSON:API format](https://jsonapi.org/extensions/#extensions):
+        `ext:$extension_name`, where `extension_name` is the name of the modifier
+        that is being applied.\n\nExtensions can only include one value at the moment:
+        `ext:modifier=value`."
       operationId: ListVulnerabilities
       parameters:
       - description: Its value must come from the `links` section of the response
@@ -71596,7 +71635,7 @@ paths:
       - description: Filter by advisory ID.
         example: TRIVY-CVE-2023-0615
         in: query
-        name: filter[advisory_id]
+        name: filter[advisory.id]
         required: false
         schema:
           type: string
@@ -71696,7 +71735,8 @@ paths:
         required: false
         schema:
           type: string
-      - description: Filter by asset name.
+      - description: Filter by asset name. This field supports the usage of wildcards
+          (*).
         example: datadog-agent
         in: query
         name: filter[asset.name]

examples/v2/security-monitoring/ListAssetsSBOMs.java

@@ -1,10 +1,8 @@
-// List assets SBOMs returns "OK" response
+// List SBOMs returns "OK" response
 
 import com.datadog.api.client.ApiClient;
 import com.datadog.api.client.ApiException;
 import com.datadog.api.client.v2.api.SecurityMonitoringApi;
-import com.datadog.api.client.v2.api.SecurityMonitoringApi.ListAssetsSBOMsOptionalParameters;
-import com.datadog.api.client.v2.model.AssetType;
 import com.datadog.api.client.v2.model.ListAssetsSBOMsResponse;
 
 public class Example {
@@ -14,11 +12,7 @@ public static void main(String[] args) {
     SecurityMonitoringApi apiInstance = new SecurityMonitoringApi(defaultClient);
 
     try {
-      ListAssetsSBOMsResponse result =
-          apiInstance.listAssetsSBOMs(
-              new ListAssetsSBOMsOptionalParameters()
-                  .filterPackageName("pandas")
-                  .filterAssetType(AssetType.SERVICE));
+      ListAssetsSBOMsResponse result = apiInstance.listAssetsSBOMs();
       System.out.println(result);
     } catch (ApiException e) {
       System.err.println("Exception when calling SecurityMonitoringApi#listAssetsSBOMs");

examples/v2/security-monitoring/ListAssetsSBOMs_339414484.java

@@ -0,0 +1,31 @@
+// List assets SBOMs returns "OK" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.SecurityMonitoringApi;
+import com.datadog.api.client.v2.api.SecurityMonitoringApi.ListAssetsSBOMsOptionalParameters;
+import com.datadog.api.client.v2.model.AssetType;
+import com.datadog.api.client.v2.model.ListAssetsSBOMsResponse;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    defaultClient.setUnstableOperationEnabled("v2.listAssetsSBOMs", true);
+    SecurityMonitoringApi apiInstance = new SecurityMonitoringApi(defaultClient);
+
+    try {
+      ListAssetsSBOMsResponse result =
+          apiInstance.listAssetsSBOMs(
+              new ListAssetsSBOMsOptionalParameters()
+                  .filterPackageName("pandas")
+                  .filterAssetType(AssetType.SERVICE));
+      System.out.println(result);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling SecurityMonitoringApi#listAssetsSBOMs");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

src/main/java/com/datadog/api/client/v2/api/SecurityMonitoringApi.java

@@ -33,6 +33,7 @@
 import com.datadog.api.client.v2.model.PatchNotificationRuleParameters;
 import com.datadog.api.client.v2.model.RunHistoricalJobRequest;
 import com.datadog.api.client.v2.model.SBOMComponentLicenseType;
+import com.datadog.api.client.v2.model.SbomFormat;
 import com.datadog.api.client.v2.model.SecurityFilterCreateRequest;
 import com.datadog.api.client.v2.model.SecurityFilterResponse;
 import com.datadog.api.client.v2.model.SecurityFilterUpdateRequest;
@@ -4029,6 +4030,7 @@ public ApiResponse<GetRuleVersionHistoryResponse> getRuleVersionHistoryWithHttpI
   /** Manage optional parameters to getSBOM. */
   public static class GetSBOMOptionalParameters {
     private String filterRepoDigest;
+    private SbomFormat extFormat;
 
     /**
      * Set filterRepoDigest.
@@ -4041,6 +4043,17 @@ public GetSBOMOptionalParameters filterRepoDigest(String filterRepoDigest) {
       this.filterRepoDigest = filterRepoDigest;
       return this;
     }
+
+    /**
+     * Set extFormat.
+     *
+     * @param extFormat The standard of the SBOM. (optional)
+     * @return GetSBOMOptionalParameters
+     */
+    public GetSBOMOptionalParameters extFormat(SbomFormat extFormat) {
+      this.extFormat = extFormat;
+      return this;
+    }
   }
 
   /**
@@ -4155,6 +4168,7 @@ public ApiResponse<GetSBOMResponse> getSBOMWithHttpInfo(
           400, "Missing the required parameter 'filterAssetName' when calling getSBOM");
     }
     String filterRepoDigest = parameters.filterRepoDigest;
+    SbomFormat extFormat = parameters.extFormat;
     // create path and map variables
     String localVarPath =
         "/api/v2/security/sboms/{asset_type}"
@@ -4167,6 +4181,7 @@ public ApiResponse<GetSBOMResponse> getSBOMWithHttpInfo(
         apiClient.parameterToPairs("", "filter[asset_name]", filterAssetName));
     localVarQueryParams.addAll(
         apiClient.parameterToPairs("", "filter[repo_digest]", filterRepoDigest));
+    localVarQueryParams.addAll(apiClient.parameterToPairs("", "ext:format", extFormat));
 
     Invocation.Builder builder =
         apiClient.createBuilder(
@@ -4229,6 +4244,7 @@ public CompletableFuture<ApiResponse<GetSBOMResponse>> getSBOMWithHttpInfoAsync(
       return result;
     }
     String filterRepoDigest = parameters.filterRepoDigest;
+    SbomFormat extFormat = parameters.extFormat;
     // create path and map variables
     String localVarPath =
         "/api/v2/security/sboms/{asset_type}"
@@ -4241,6 +4257,7 @@ public CompletableFuture<ApiResponse<GetSBOMResponse>> getSBOMWithHttpInfoAsync(
         apiClient.parameterToPairs("", "filter[asset_name]", filterAssetName));
     localVarQueryParams.addAll(
         apiClient.parameterToPairs("", "filter[repo_digest]", filterRepoDigest));
+    localVarQueryParams.addAll(apiClient.parameterToPairs("", "ext:format", extFormat));
 
     Invocation.Builder builder;
     try {
@@ -6198,7 +6215,7 @@ public ListAssetsSBOMsOptionalParameters filterLicenseType(
   }
 
   /**
-   * List assets SBOMs.
+   * List SBOMs.
    *
    * <p>See {@link #listAssetsSBOMsWithHttpInfo}.
    *
@@ -6210,7 +6227,7 @@ public ListAssetsSBOMsResponse listAssetsSBOMs() throws ApiException {
   }
 
   /**
-   * List assets SBOMs.
+   * List SBOMs.
    *
    * <p>See {@link #listAssetsSBOMsWithHttpInfoAsync}.
    *
@@ -6225,7 +6242,7 @@ public CompletableFuture<ListAssetsSBOMsResponse> listAssetsSBOMsAsync() {
   }
 
   /**
-   * List assets SBOMs.
+   * List SBOMs.
    *
    * <p>See {@link #listAssetsSBOMsWithHttpInfo}.
    *
@@ -6239,7 +6256,7 @@ public ListAssetsSBOMsResponse listAssetsSBOMs(ListAssetsSBOMsOptionalParameters
   }
 
   /**
-   * List assets SBOMs.
+   * List SBOMs.
    *
    * <p>See {@link #listAssetsSBOMsWithHttpInfoAsync}.
    *
@@ -6347,7 +6364,7 @@ public ApiResponse<ListAssetsSBOMsResponse> listAssetsSBOMsWithHttpInfo(
   }
 
   /**
-   * List assets SBOMs.
+   * List SBOMs.
    *
    * <p>See {@link #listAssetsSBOMsWithHttpInfo}.
    *
@@ -8650,7 +8667,8 @@ public ListVulnerabilitiesOptionalParameters filterOrigin(String filterOrigin) {
     /**
      * Set filterAssetName.
      *
-     * @param filterAssetName Filter by asset name. (optional)
+     * @param filterAssetName Filter by asset name. This field supports the usage of wildcards (*).
+     *     (optional)
      * @return ListVulnerabilitiesOptionalParameters
      */
     public ListVulnerabilitiesOptionalParameters filterAssetName(String filterAssetName) {
@@ -8938,6 +8956,8 @@ public CompletableFuture<ListVulnerabilitiesResponse> listVulnerabilitiesAsync(
    *
    * <p>This token can then be used in the subsequent paginated requests.
    *
+   * <p><em>Note: The first request may take longer to complete than subsequent requests.</em>
+   *
    * <h3>Subsequent requests</h3>
    *
    * <p>Any request containing valid <code>page[token]</code> and <code>page[number]</code>
@@ -8989,6 +9009,16 @@ public CompletableFuture<ListVulnerabilitiesResponse> listVulnerabilitiesAsync(
    *   "links": {...}
    * }</code>
    *
+   * <h3>Extensions</h3>
+   *
+   * <p>The request in some cases can include extensions to update behavior of the endpoint
+   * requested. The format of the filter parameters follows the <a
+   * href="https://jsonapi.org/extensions/#extensions">JSON:API format</a>: <code>
+   * ext:$extension_name</code>, where <code>extension_name</code> is the name of the modifier that
+   * is being applied.
+   *
+   * <p>Extensions can only include one value at the moment: <code>ext:modifier=value</code>.
+   *
    * @param parameters Optional parameters for the request.
    * @return ApiResponse&lt;ListVulnerabilitiesResponse&gt;
    * @throws ApiException if fails to make API call
@@ -9085,7 +9115,7 @@ public ApiResponse<ListVulnerabilitiesResponse> listVulnerabilitiesWithHttpInfo(
     localVarQueryParams.addAll(
         apiClient.parameterToPairs("", "filter[library.version]", filterLibraryVersion));
     localVarQueryParams.addAll(
-        apiClient.parameterToPairs("", "filter[advisory_id]", filterAdvisoryId));
+        apiClient.parameterToPairs("", "filter[advisory.id]", filterAdvisoryId));
     localVarQueryParams.addAll(
         apiClient.parameterToPairs(
             "", "filter[risks.exploitation_probability]", filterRisksExploitationProbability));
@@ -9271,7 +9301,7 @@ public ApiResponse<ListVulnerabilitiesResponse> listVulnerabilitiesWithHttpInfo(
     localVarQueryParams.addAll(
         apiClient.parameterToPairs("", "filter[library.version]", filterLibraryVersion));
     localVarQueryParams.addAll(
-        apiClient.parameterToPairs("", "filter[advisory_id]", filterAdvisoryId));
+        apiClient.parameterToPairs("", "filter[advisory.id]", filterAdvisoryId));
     localVarQueryParams.addAll(
         apiClient.parameterToPairs(
             "", "filter[risks.exploitation_probability]", filterRisksExploitationProbability));
@@ -9418,7 +9448,7 @@ public ListVulnerableAssetsOptionalParameters pageNumber(Long pageNumber) {
     /**
      * Set filterName.
      *
-     * @param filterName Filter by name. (optional)
+     * @param filterName Filter by name. This field supports the usage of wildcards (*). (optional)
      * @return ListVulnerableAssetsOptionalParameters
      */
     public ListVulnerableAssetsOptionalParameters filterName(String filterName) {