Regenerate client from commit 7e023f1d of spec repo

ci.datadog-api-spec · ci.datadog-api-spec · commit 2a77ede48093 · 2025-05-02T20:48:03.000Z
diff --git a/.apigentools-info b/.apigentools-info
@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-02 04:31:10.898749",
-            "spec_repo_commit": "272cce39"
+            "regenerated": "2025-05-02 20:46:09.170182",
+            "spec_repo_commit": "7e023f1d"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-02 04:31:10.915000",
-            "spec_repo_commit": "272cce39"
+            "regenerated": "2025-05-02 20:46:09.185776",
+            "spec_repo_commit": "7e023f1d"
         }
     }
 }
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
@@ -50567,22 +50567,8 @@ paths:
       description: Get the list of devices.
       operationId: ListDevices
       parameters:
-      - description: The page number to fetch.
-        example: 0
-        in: query
-        name: page[number]
-        required: false
-        schema:
-          format: int64
-          type: integer
-      - description: The number of devices to return per page.
-        example: 10
-        in: query
-        name: page[size]
-        required: false
-        schema:
-          format: int64
-          type: integer
+      - $ref: '#/components/parameters/PageSize'
+      - $ref: '#/components/parameters/PageNumber'
       - description: The field to sort the devices by.
         example: status
         in: query
@@ -50613,6 +50599,10 @@ paths:
       summary: Get the list of devices
       tags:
       - Network Device Monitoring
+      x-pagination:
+        limitParam: page[size]
+        pageParam: page[number]
+        resultsPath: data
   /api/v2/ndm/devices/{device_id}:
     get:
       description: Get the device details.
diff --git a/examples/v2/network-device-monitoring/ListDevices_2712868412.java b/examples/v2/network-device-monitoring/ListDevices_2712868412.java
@@ -0,0 +1,26 @@
+// Get the list of devices returns "OK" response with pagination
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.PaginationIterable;
+import com.datadog.api.client.v2.api.NetworkDeviceMonitoringApi;
+import com.datadog.api.client.v2.model.DevicesListData;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    NetworkDeviceMonitoringApi apiInstance = new NetworkDeviceMonitoringApi(defaultClient);
+
+    try {
+      PaginationIterable<DevicesListData> iterable = apiInstance.listDevicesWithPagination();
+
+      for (DevicesListData item : iterable) {
+        System.out.println(item);
+      }
+    } catch (RuntimeException e) {
+      System.err.println(
+          "Exception when calling NetworkDeviceMonitoringApi#listDevicesWithPagination");
+      System.err.println("Reason: " + e.getMessage());
+      e.printStackTrace();
+    }
+  }
+}
diff --git a/src/main/java/com/datadog/api/client/v2/api/NetworkDeviceMonitoringApi.java b/src/main/java/com/datadog/api/client/v2/api/NetworkDeviceMonitoringApi.java
@@ -3,7 +3,9 @@
 import com.datadog.api.client.ApiClient;
 import com.datadog.api.client.ApiException;
 import com.datadog.api.client.ApiResponse;
+import com.datadog.api.client.PaginationIterable;
 import com.datadog.api.client.Pair;
+import com.datadog.api.client.v2.model.DevicesListData;
 import com.datadog.api.client.v2.model.GetDeviceResponse;
 import com.datadog.api.client.v2.model.GetInterfacesResponse;
 import com.datadog.api.client.v2.model.ListDevicesResponse;
@@ -12,6 +14,7 @@
 import jakarta.ws.rs.core.GenericType;
 import java.util.ArrayList;
 import java.util.HashMap;
+import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
 import java.util.concurrent.CompletableFuture;
@@ -374,30 +377,31 @@ public CompletableFuture<ApiResponse<GetInterfacesResponse>> getInterfacesWithHt
 
   /** Manage optional parameters to listDevices. */
   public static class ListDevicesOptionalParameters {
-    private Long pageNumber;
     private Long pageSize;
+    private Long pageNumber;
     private String sort;
     private String filterTag;
 
     /**
-     * Set pageNumber.
+     * Set pageSize.
      *
-     * @param pageNumber The page number to fetch. (optional)
+     * @param pageSize Size for a given page. The maximum allowed value is 100. (optional, default
+     *     to 10)
      * @return ListDevicesOptionalParameters
      */
-    public ListDevicesOptionalParameters pageNumber(Long pageNumber) {
-      this.pageNumber = pageNumber;
+    public ListDevicesOptionalParameters pageSize(Long pageSize) {
+      this.pageSize = pageSize;
       return this;
     }
 
     /**
-     * Set pageSize.
+     * Set pageNumber.
      *
-     * @param pageSize The number of devices to return per page. (optional)
+     * @param pageNumber Specific page number to return. (optional, default to 0)
      * @return ListDevicesOptionalParameters
      */
-    public ListDevicesOptionalParameters pageSize(Long pageSize) {
-      this.pageSize = pageSize;
+    public ListDevicesOptionalParameters pageNumber(Long pageNumber) {
+      this.pageNumber = pageNumber;
       return this;
     }
 
@@ -482,6 +486,59 @@ public CompletableFuture<ListDevicesResponse> listDevicesAsync(
             });
   }
 
+  /**
+   * Get the list of devices.
+   *
+   * <p>See {@link #listDevicesWithHttpInfo}.
+   *
+   * @return PaginationIterable&lt;DevicesListData&gt;
+   */
+  public PaginationIterable<DevicesListData> listDevicesWithPagination() {
+    ListDevicesOptionalParameters parameters = new ListDevicesOptionalParameters();
+    return listDevicesWithPagination(parameters);
+  }
+
+  /**
+   * Get the list of devices.
+   *
+   * <p>See {@link #listDevicesWithHttpInfo}.
+   *
+   * @return ListDevicesResponse
+   */
+  public PaginationIterable<DevicesListData> listDevicesWithPagination(
+      ListDevicesOptionalParameters parameters) {
+    String resultsPath = "getData";
+    String valueGetterPath = "";
+    String valueSetterPath = "pageNumber";
+    Boolean valueSetterParamOptional = true;
+    parameters.pageNumber(0l);
+    Long limit;
+
+    if (parameters.pageSize == null) {
+      limit = 10l;
+      parameters.pageSize(limit);
+    } else {
+      limit = parameters.pageSize;
+    }
+
+    LinkedHashMap<String, Object> args = new LinkedHashMap<String, Object>();
+    args.put("optionalParams", parameters);
+
+    PaginationIterable iterator =
+        new PaginationIterable(
+            this,
+            "listDevices",
+            resultsPath,
+            valueGetterPath,
+            valueSetterPath,
+            valueSetterParamOptional,
+            false,
+            limit,
+            args);
+
+    return iterator;
+  }
+
   /**
    * Get the list of devices.
    *
@@ -501,8 +558,8 @@ public CompletableFuture<ListDevicesResponse> listDevicesAsync(
   public ApiResponse<ListDevicesResponse> listDevicesWithHttpInfo(
       ListDevicesOptionalParameters parameters) throws ApiException {
     Object localVarPostBody = null;
-    Long pageNumber = parameters.pageNumber;
     Long pageSize = parameters.pageSize;
+    Long pageNumber = parameters.pageNumber;
     String sort = parameters.sort;
     String filterTag = parameters.filterTag;
     // create path and map variables
@@ -511,8 +568,8 @@ public ApiResponse<ListDevicesResponse> listDevicesWithHttpInfo(
     List<Pair> localVarQueryParams = new ArrayList<Pair>();
     Map<String, String> localVarHeaderParams = new HashMap<String, String>();
 
-    localVarQueryParams.addAll(apiClient.parameterToPairs("", "page[number]", pageNumber));
     localVarQueryParams.addAll(apiClient.parameterToPairs("", "page[size]", pageSize));
+    localVarQueryParams.addAll(apiClient.parameterToPairs("", "page[number]", pageNumber));
     localVarQueryParams.addAll(apiClient.parameterToPairs("", "sort", sort));
     localVarQueryParams.addAll(apiClient.parameterToPairs("", "filter[tag]", filterTag));
 
@@ -547,8 +604,8 @@ public ApiResponse<ListDevicesResponse> listDevicesWithHttpInfo(
   public CompletableFuture<ApiResponse<ListDevicesResponse>> listDevicesWithHttpInfoAsync(
       ListDevicesOptionalParameters parameters) {
     Object localVarPostBody = null;
-    Long pageNumber = parameters.pageNumber;
     Long pageSize = parameters.pageSize;
+    Long pageNumber = parameters.pageNumber;
     String sort = parameters.sort;
     String filterTag = parameters.filterTag;
     // create path and map variables
@@ -557,8 +614,8 @@ public CompletableFuture<ApiResponse<ListDevicesResponse>> listDevicesWithHttpIn
     List<Pair> localVarQueryParams = new ArrayList<Pair>();
     Map<String, String> localVarHeaderParams = new HashMap<String, String>();
 
-    localVarQueryParams.addAll(apiClient.parameterToPairs("", "page[number]", pageNumber));
     localVarQueryParams.addAll(apiClient.parameterToPairs("", "page[size]", pageSize));
+    localVarQueryParams.addAll(apiClient.parameterToPairs("", "page[number]", pageNumber));
     localVarQueryParams.addAll(apiClient.parameterToPairs("", "sort", sort));
     localVarQueryParams.addAll(apiClient.parameterToPairs("", "filter[tag]", filterTag));
 
diff --git a/src/test/resources/com/datadog/api/client/v2/api/network_device_monitoring.feature b/src/test/resources/com/datadog/api/client/v2/api/network_device_monitoring.feature
@@ -75,6 +75,12 @@ Feature: Network Device Monitoring
     And the response "data[0].attributes.interface_statuses.down" is equal to 13
     And the response "meta.page.total_filtered_count" is equal to 1
 
+  @generated @skip @team:DataDog/network-device-monitoring @with-pagination
+  Scenario: Get the list of devices returns "OK" response with pagination
+    Given new "ListDevices" request
+    When the request with pagination is sent
+    Then the response status is 200 OK
+
   @replay-only @team:DataDog/network-device-monitoring
   Scenario: Get the list of interfaces of the device returns "OK" response
     Given new "GetInterfaces" request

Original file line number	Diff line number	Diff line change
`@@ -4,13 +4,13 @@`
`4`	`4`	`"spec_versions": {`
`5`	`5`	`"v1": {`
`6`	`6`	`"apigentools_version": "1.6.6",`
`7`		`- "regenerated": "2025-05-02 04:31:10.898749",`
`8`		`- "spec_repo_commit": "272cce39"`
	`7`	`+ "regenerated": "2025-05-02 20:46:09.170182",`
	`8`	`+ "spec_repo_commit": "7e023f1d"`
`9`	`9`	`},`
`10`	`10`	`"v2": {`
`11`	`11`	`"apigentools_version": "1.6.6",`
`12`		`- "regenerated": "2025-05-02 04:31:10.915000",`
`13`		`- "spec_repo_commit": "272cce39"`
	`12`	`+ "regenerated": "2025-05-02 20:46:09.185776",`
	`13`	`+ "spec_repo_commit": "7e023f1d"`
`14`	`14`	`}`
`15`	`15`	`}`
`16`	`16`	`}`