datadog_api_client 2.44.0 → 2.46.0

data/lib/datadog_api_client/v2/api/on_call_api.rb

@@ -492,7 +492,7 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
-    # Get the schedule on-call user.
+    # Get scheduled on-call user.
     #
     # @see #get_schedule_on_call_user_with_http_info
     def get_schedule_on_call_user(schedule_id, opts = {})
@@ -500,7 +500,7 @@ module DatadogAPIClient::V2
       data
     end
 
-    # Get the schedule on-call user.
+    # Get scheduled on-call user.
     #
     # Retrieves the user who is on-call for the specified schedule at a given time.
     #

data/lib/datadog_api_client/v2/api/reference_tables_api.rb

@@ -33,7 +33,11 @@ module DatadogAPIClient::V2
 
     # Create reference table.
     #
-    # Create a new reference table. You can provide data in two ways: 1) Call POST api/v2/reference-tables/upload first to get an upload ID, then PUT chunks of CSV data to each provided URL, and finally call this POST endpoint with the upload_id in file_metadata, OR 2) Provide access_details in file_metadata pointing to a CSV file in cloud storage (Amazon S3, Azure Blob Storage, or GCP Cloud Storage).
+    # Creates a reference table. You can provide data in two ways:
+    # 1. Call POST /api/v2/reference-tables/upload to get an upload ID. Then, PUT the CSV data
+    #    (not the file itself) in chunks to each URL in the request body. Finally, call this
+    #    POST endpoint with `upload_id` in `file_metadata`.
+    # 2. Provide `access_details` in `file_metadata` pointing to a CSV file in cloud storage.
     #
     # @param body [CreateTableRequest] 
     # @param opts [Hash] the optional parameters
@@ -157,6 +161,78 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # Delete rows.
+    #
+    # @see #delete_rows_with_http_info
+    def delete_rows(id, body, opts = {})
+      delete_rows_with_http_info(id, body, opts)
+      nil
+    end
+
+    # Delete rows.
+    #
+    # Delete multiple rows from a Reference Table by their primary key values.
+    #
+    # @param id [String] Unique identifier of the reference table to delete rows from
+    # @param body [BatchDeleteRowsRequestArray] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def delete_rows_with_http_info(id, body, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ReferenceTablesAPI.delete_rows ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ReferenceTablesAPI.delete_rows"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling ReferenceTablesAPI.delete_rows"
+      end
+      # resource path
+      local_var_path = '/api/v2/reference-tables/tables/{id}/rows'.sub('{id}', CGI.escape(id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['*/*'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :delete_rows,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Delete, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ReferenceTablesAPI#delete_rows\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Delete table.
     #
     # @see #delete_table_with_http_info
@@ -169,7 +245,7 @@ module DatadogAPIClient::V2
     #
     # Delete a reference table by ID
     #
-    # @param id [String] The ID of the reference table to delete
+    # @param id [String] Unique identifier of the reference table to delete
     # @param opts [Hash] the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def delete_table_with_http_info(id, opts = {})
@@ -234,7 +310,7 @@ module DatadogAPIClient::V2
     #
     # Get reference table rows by their primary key values.
     #
-    # @param id [String] The ID of the reference table
+    # @param id [String] Unique identifier of the reference table to get rows from
     # @param row_id [Array<String>] List of row IDs (primary key values) to retrieve from the reference table.
     # @param opts [Hash] the optional parameters
     # @return [Array<(TableRowResourceArray, Integer, Hash)>] TableRowResourceArray data, response status code and response headers
@@ -306,7 +382,7 @@ module DatadogAPIClient::V2
     #
     # Get a reference table by ID
     #
-    # @param id [String] The ID of the reference table to retrieve
+    # @param id [String] Unique identifier of the reference table to retrieve
     # @param opts [Hash] the optional parameters
     # @return [Array<(TableResultV2, Integer, Hash)>] TableResultV2 data, response status code and response headers
     def get_table_with_http_info(id, opts = {})
@@ -372,9 +448,9 @@ module DatadogAPIClient::V2
     # List all reference tables in this organization.
     #
     # @param opts [Hash] the optional parameters
-    # @option opts [Integer] :limit Number of tables to return.
-    # @option opts [Integer] :offset Number of tables to skip for pagination.
-    # @option opts [ReferenceTableSortType] :sort Sort field and direction. Use field name for ascending, prefix with "-" for descending.
+    # @option opts [Integer] :page_limit Number of tables to return.
+    # @option opts [Integer] :page_offset Number of tables to skip for pagination.
+    # @option opts [ReferenceTableSortType] :sort Sort field and direction for the list of reference tables. Use field name for ascending, prefix with "-" for descending.
     # @option opts [String] :filter_status Filter by table status.
     # @option opts [String] :filter_table_name_exact Filter by exact table name match.
     # @option opts [String] :filter_table_name_contains Filter by table name containing substring.
@@ -384,14 +460,14 @@ module DatadogAPIClient::V2
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: ReferenceTablesAPI.list_tables ...'
       end
-      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] > 100
-        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ReferenceTablesAPI.list_tables, must be smaller than or equal to 100.'
+      if @api_client.config.client_side_validation && !opts[:'page_limit'].nil? && opts[:'page_limit'] > 100
+        fail ArgumentError, 'invalid value for "opts[:"page_limit"]" when calling ReferenceTablesAPI.list_tables, must be smaller than or equal to 100.'
       end
-      if @api_client.config.client_side_validation && !opts[:'limit'].nil? && opts[:'limit'] < 1
-        fail ArgumentError, 'invalid value for "opts[:"limit"]" when calling ReferenceTablesAPI.list_tables, must be greater than or equal to 1.'
+      if @api_client.config.client_side_validation && !opts[:'page_limit'].nil? && opts[:'page_limit'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page_limit"]" when calling ReferenceTablesAPI.list_tables, must be greater than or equal to 1.'
       end
-      if @api_client.config.client_side_validation && !opts[:'offset'].nil? && opts[:'offset'] < 0
-        fail ArgumentError, 'invalid value for "opts[:"offset"]" when calling ReferenceTablesAPI.list_tables, must be greater than or equal to 0.'
+      if @api_client.config.client_side_validation && !opts[:'page_offset'].nil? && opts[:'page_offset'] < 0
+        fail ArgumentError, 'invalid value for "opts[:"page_offset"]" when calling ReferenceTablesAPI.list_tables, must be greater than or equal to 0.'
       end
       allowable_values = ['updated_at', 'table_name', 'status', '-updated_at', '-table_name', '-status']
       if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
@@ -402,8 +478,8 @@ module DatadogAPIClient::V2
 
       # query parameters
       query_params = opts[:query_params] || {}
-      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
-      query_params[:'offset'] = opts[:'offset'] if !opts[:'offset'].nil?
+      query_params[:'page[limit]'] = opts[:'page_limit'] if !opts[:'page_limit'].nil?
+      query_params[:'page[offset]'] = opts[:'page_offset'] if !opts[:'page_offset'].nil?
       query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
       query_params[:'filter[status]'] = opts[:'filter_status'] if !opts[:'filter_status'].nil?
       query_params[:'filter[table_name][exact]'] = opts[:'filter_table_name_exact'] if !opts[:'filter_table_name_exact'].nil?
@@ -456,7 +532,7 @@ module DatadogAPIClient::V2
     #
     # Update a reference table by ID. You can update the table's data, description, and tags. Note: The source type cannot be changed after table creation. For data updates: For existing tables of type `source:LOCAL_FILE`, call POST api/v2/reference-tables/uploads first to get an upload ID, then PUT chunks of CSV data to each provided URL, and finally call this PATCH endpoint with the upload_id in file_metadata. For existing tables with `source:` types of `S3`, `GCS`, or `AZURE`, provide updated access_details in file_metadata pointing to a CSV file in the same type of cloud storage.
     #
-    # @param id [String] The ID of the reference table to update
+    # @param id [String] Unique identifier of the reference table to update
     # @param body [PatchTableRequest] 
     # @param opts [Hash] the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
@@ -515,5 +591,77 @@ module DatadogAPIClient::V2
       end
       return data, status_code, headers
     end
+
+    # Upsert rows.
+    #
+    # @see #upsert_rows_with_http_info
+    def upsert_rows(id, body, opts = {})
+      upsert_rows_with_http_info(id, body, opts)
+      nil
+    end
+
+    # Upsert rows.
+    #
+    # Create or update rows in a Reference Table by their primary key values. If a row with the specified primary key exists, it is updated; otherwise, a new row is created.
+    #
+    # @param id [String] Unique identifier of the reference table to upsert rows into
+    # @param body [BatchUpsertRowsRequestArray] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def upsert_rows_with_http_info(id, body, opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: ReferenceTablesAPI.upsert_rows ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling ReferenceTablesAPI.upsert_rows"
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling ReferenceTablesAPI.upsert_rows"
+      end
+      # resource path
+      local_var_path = '/api/v2/reference-tables/tables/{id}/rows'.sub('{id}', CGI.escape(id.to_s).gsub('%2F', '/'))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['*/*'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :upsert_rows,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: ReferenceTablesAPI#upsert_rows\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end

data/lib/datadog_api_client/v2/api/restriction_policies_api.rb

@@ -35,7 +35,7 @@ module DatadogAPIClient::V2
     #
     # Deletes the restriction policy associated with a specified resource.
     #
-    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `dashboard`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`, `rum-application`, `cross-org-connection`, `spreadsheet`, `on-call-schedule`, `on-call-escalation-policy`, `on-call-team-routing-rules.
+    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `dashboard`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`, `rum-application`, `cross-org-connection`, `spreadsheet`, `on-call-schedule`, `on-call-escalation-policy`, `on-call-team-routing-rules`, `logs-pipeline`.
     # @param opts [Hash] the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def delete_restriction_policy_with_http_info(resource_id, opts = {})
@@ -100,7 +100,7 @@ module DatadogAPIClient::V2
     #
     # Retrieves the restriction policy associated with a specified resource.
     #
-    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `dashboard`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`, `rum-application`, `cross-org-connection`, `spreadsheet`, `on-call-schedule`, `on-call-escalation-policy`, `on-call-team-routing-rules.
+    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `dashboard`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`, `rum-application`, `cross-org-connection`, `spreadsheet`, `on-call-schedule`, `on-call-escalation-policy`, `on-call-team-routing-rules`, `logs-pipeline`.
     # @param opts [Hash] the optional parameters
     # @return [Array<(RestrictionPolicyResponse, Integer, Hash)>] RestrictionPolicyResponse data, response status code and response headers
     def get_restriction_policy_with_http_info(resource_id, opts = {})
@@ -189,6 +189,7 @@ module DatadogAPIClient::V2
     # - On-Call Schedules: `on-call-schedule`
     # - On-Call Escalation Policies: `on-call-escalation-policy`
     # - On-Call Team Routing Rules: `on-call-team-routing-rules`
+    # - Logs Pipelines: `logs-pipeline`
     #
     # #### Supported relations for resources
     # Resource Type               | Supported Relations
@@ -215,8 +216,9 @@ module DatadogAPIClient::V2
     # On-Call Schedules           | `viewer`, `overrider`, `editor`
     # On-Call Escalation Policies | `viewer`, `editor`
     # On-Call Team Routing Rules  | `viewer`, `editor`
+    # Logs Pipelines              | `viewer`, `processors_editor`, `editor`
     #
-    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `dashboard`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`, `rum-application`, `cross-org-connection`, `spreadsheet`, `on-call-schedule`, `on-call-escalation-policy`, `on-call-team-routing-rules.
+    # @param resource_id [String] Identifier, formatted as `type:id`. Supported types: `dashboard`, `integration-service`, `integration-webhook`, `notebook`, `reference-table`, `security-rule`, `slo`, `workflow`, `app-builder-app`, `connection`, `connection-group`, `rum-application`, `cross-org-connection`, `spreadsheet`, `on-call-schedule`, `on-call-escalation-policy`, `on-call-team-routing-rules`, `logs-pipeline`.
     # @param body [RestrictionPolicyUpdateRequest] Restriction policy payload
     # @param opts [Hash] the optional parameters
     # @option opts [Boolean] :allow_self_lockout Allows admins (users with the `user_access_manage` permission) to remove their own access from the resource if set to `true`. By default, this is set to `false`, preventing admins from locking themselves out.