datadog_api_client 2.44.0 → 2.45.0

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

@@ -2299,12 +2299,15 @@ module DatadogAPIClient::V2
     #
     # The bulk update endpoint for creating, updating, and deleting attachments for a given incident.
     #
+    # @deprecated This API is deprecated.
+    #
     # @param incident_id [String] The UUID of the incident.
     # @param body [IncidentAttachmentUpdateRequest] Incident Attachment Payload.
     # @param opts [Hash] the optional parameters
     # @option opts [Array<IncidentAttachmentRelatedObject>] :include Specifies which types of related objects are included in the response.
     # @return [Array<(IncidentAttachmentUpdateResponse, Integer, Hash)>] IncidentAttachmentUpdateResponse data, response status code and response headers
     def update_incident_attachments_with_http_info(incident_id, body, opts = {})
+      warn "[DEPRECATION] `UpdateIncidentAttachments` is deprecated."
       unstable_enabled = @api_client.config.unstable_operations["v2.update_incident_attachments".to_sym]
       if unstable_enabled
         @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.update_incident_attachments")

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

@@ -496,7 +496,8 @@ module DatadogAPIClient::V2
 
     # Get one application key owned by current user.
     #
-    # Get an application key owned by current user
+    # Get an application key owned by current user.
+    # The `key` field is not returned for organizations in [One-Time Read mode](https://docs.datadoghq.com/account_management/api-app-keys/#one-time-read-mode).
     #
     # @param app_key_id [String] The ID of the application key.
     # @param opts [Hash] the optional parameters
@@ -947,7 +948,8 @@ module DatadogAPIClient::V2
 
     # Edit an application key owned by current user.
     #
-    # Edit an application key owned by current user
+    # Edit an application key owned by current user.
+    # The `key` field is not returned for organizations in [One-Time Read mode](https://docs.datadoghq.com/account_management/api-app-keys/#one-time-read-mode).
     #
     # @param app_key_id [String] The ID of the application key.
     # @param body [ApplicationKeyUpdateRequest] 

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
@@ -169,7 +173,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 +238,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 +310,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 +376,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 +388,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 +406,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 +460,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

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.