Regenerate client from commit 7e023f1d of spec repo

Author: ci.datadog-api-spec

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-02 04:31:13.587503",
-            "spec_repo_commit": "272cce39"
+            "regenerated": "2025-05-02 20:46:06.351468",
+            "spec_repo_commit": "7e023f1d"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-05-02 04:31:13.603582",
-            "spec_repo_commit": "272cce39"
+            "regenerated": "2025-05-02 20:46:06.367616",
+            "spec_repo_commit": "7e023f1d"
         }
     }
 }

.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.

examples/v2/network-device-monitoring/ListDevices_2712868412.rb

@@ -0,0 +1,5 @@
+# Get the list of devices returns "OK" response with pagination
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V2::NetworkDeviceMonitoringAPI.new
+api_instance.list_devices_with_pagination() { |item| puts item }

features/scenarios_model_mapping.rb

@@ -2013,8 +2013,8 @@
             "body" => "MonitorConfigPolicyEditRequest",
     },
     "v2.ListDevices" => {
-            "page_number" => "Integer",
             "page_size" => "Integer",
+            "page_number" => "Integer",
             "sort" => "String",
             "filter_tag" => "String",
     },

features/v2/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

lib/datadog_api_client/v2/api/network_device_monitoring_api.rb

@@ -169,8 +169,8 @@ def list_devices(opts = {})
     # Get the list of devices.
     #
     # @param opts [Hash] the optional parameters
-    # @option opts [Integer] :page_number The page number to fetch.
-    # @option opts [Integer] :page_size The number of devices to return per page.
+    # @option opts [Integer] :page_size Size for a given page. The maximum allowed value is 100.
+    # @option opts [Integer] :page_number Specific page number to return.
     # @option opts [String] :sort The field to sort the devices by.
     # @option opts [String] :filter_tag Filter devices by tag.
     # @return [Array<(ListDevicesResponse, Integer, Hash)>] ListDevicesResponse data, response status code and response headers
@@ -184,8 +184,8 @@ def list_devices_with_http_info(opts = {})
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'page[number]'] = opts[:'page_number'] if !opts[:'page_number'].nil?
       query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'page[number]'] = opts[:'page_number'] if !opts[:'page_number'].nil?
       query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
       query_params[:'filter[tag]'] = opts[:'filter_tag'] if !opts[:'filter_tag'].nil?
 
@@ -224,6 +224,28 @@ def list_devices_with_http_info(opts = {})
       return data, status_code, headers
     end
 
+    # Get the list of devices.
+    #
+    # Provide a paginated version of {#list_devices}, returning all items.
+    #
+    # To use it you need to use a block: list_devices_with_pagination { |item| p item }
+    #
+    # @yield [DevicesListData] Paginated items
+    def list_devices_with_pagination(opts = {})
+        api_version = "V2"
+        page_size = @api_client.get_attribute_from_path(opts, "page_size", 10)
+        @api_client.set_attribute_from_path(api_version, opts, "page_size", Integer, page_size)
+        @api_client.set_attribute_from_path(api_version, opts, "page_number", Integer, 0)
+        while true do
+            response = list_devices(opts)
+            @api_client.get_attribute_from_path(response, "data").each { |item| yield(item) }
+            if @api_client.get_attribute_from_path(response, "data").length < page_size
+              break
+            end
+            @api_client.set_attribute_from_path(api_version, opts, "page_number", Integer, @api_client.get_attribute_from_path(opts, "page_number", 0) + 1)
+        end
+    end
+
     # Get the list of tags for a device.
     #
     # @see #list_device_user_tags_with_http_info