ConnectionMaster · pull · May 27, 2026 · May 27, 2026 · May 27, 2026 · May 27, 2026
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
@@ -19897,6 +19897,45 @@ components:
       x-enum-varnames:
         - "TRUE"
         - "FALSE"
+    CostTagMetadataMonth:
+      description: A month that has Cloud Cost Management tag metadata available for a given provider.
+      properties:
+        id:
+          description: The month, in `YYYY-MM` format.
+          example: "2026-04"
+          type: string
+        type:
+          $ref: "#/components/schemas/CostTagMetadataMonthType"
+      required:
+        - id
+        - type
+      type: object
+    CostTagMetadataMonthType:
+      default: cost_tag_metadata_month
+      description: Type of the Cloud Cost Management tag metadata month resource.
+      enum:
+        - cost_tag_metadata_month
+      example: cost_tag_metadata_month
+      type: string
+      x-enum-varnames:
+        - COST_TAG_METADATA_MONTH
+    CostTagMetadataMonthsResponse:
+      description: List of months that have Cloud Cost Management tag metadata for the requested provider, ordered most-recent first and capped at 36 months.
+      example:
+        data:
+          - id: "2026-04"
+            type: cost_tag_metadata_month
+          - id: "2026-03"
+            type: cost_tag_metadata_month
+      properties:
+        data:
+          description: List of months that have tag metadata available.
+          items:
+            $ref: "#/components/schemas/CostTagMetadataMonth"
+          type: array
+      required:
+        - data
+      type: object
     CostTagType:
       default: cost_tag
       description: Type of the Cloud Cost Management tag resource.
@@ -55585,6 +55624,7 @@ components:
         - $ref: "#/components/schemas/ObservabilityPipelineSyslogNgDestination"
         - $ref: "#/components/schemas/ObservabilityPipelineDatabricksZerobusDestination"
         - $ref: "#/components/schemas/ObservabilityPipelineDatadogMetricsDestination"
+        - $ref: "#/components/schemas/ObservabilityPipelineSplunkHecMetricsDestination"
     ObservabilityPipelineConfigPipelineType:
       default: logs
       description: The type of data being ingested. Defaults to `logs` if not specified.
@@ -59706,6 +59746,81 @@ components:
       type: string
       x-enum-varnames:
         - SPLUNK_HEC
+    ObservabilityPipelineSplunkHecMetricsDestination:
+      description: |-
+        The `splunk_hec_metrics` destination forwards metrics to Splunk using the HTTP Event Collector (HEC).
+
+        **Supported pipeline types:** metrics
+      properties:
+        buffer:
+          $ref: "#/components/schemas/ObservabilityPipelineBufferOptions"
+        compression:
+          $ref: "#/components/schemas/ObservabilityPipelineSplunkHecMetricsDestinationCompression"
+        default_namespace:
+          description: Optional default namespace for metrics sent to Splunk HEC.
+          example: "custom_namespace"
+          type: string
+        endpoint_url_key:
+          description: Name of the environment variable or secret that holds the Splunk HEC endpoint URL.
+          example: SPLUNK_HEC_ENDPOINT_URL
+          type: string
+        id:
+          description: The unique identifier for this component. Used in other parts of the pipeline to reference this component (for example, as the `input` to downstream components).
+          example: splunk-hec-metrics-destination
+          type: string
+        index:
+          description: Optional name of the Splunk index where metrics are written.
+          example: "metrics"
+          type: string
+        inputs:
+          description: A list of component IDs whose output is used as the `input` for this component.
+          example: ["metrics-filter-processor"]
+          items:
+            description: The ID of a component whose output is used as input for this destination.
+            type: string
+          type: array
+        source:
+          description: The Splunk source field value for metric events.
+          example: "observability_pipelines"
+          type: string
+        sourcetype:
+          description: The Splunk sourcetype to assign to metric events.
+          example: "custom_sourcetype"
+          type: string
+        tls:
+          $ref: "#/components/schemas/ObservabilityPipelineTls"
+        token_key:
+          description: Name of the environment variable or secret that holds the Splunk HEC token.
+          example: SPLUNK_HEC_TOKEN
+          type: string
+        type:
+          $ref: "#/components/schemas/ObservabilityPipelineSplunkHecMetricsDestinationType"
+      required:
+        - id
+        - type
+        - inputs
+      type: object
+      x-pipeline-types: [metrics]
+    ObservabilityPipelineSplunkHecMetricsDestinationCompression:
+      default: none
+      description: Compression algorithm applied when sending metrics to Splunk HEC.
+      enum:
+        - none
+        - gzip
+      example: none
+      type: string
+      x-enum-varnames:
+        - NONE
+        - GZIP
+    ObservabilityPipelineSplunkHecMetricsDestinationType:
+      default: splunk_hec_metrics
+      description: The destination type. Always `splunk_hec_metrics`.
+      enum:
+        - splunk_hec_metrics
+      example: splunk_hec_metrics
+      type: string
+      x-enum-varnames:
+        - SPLUNK_HEC_METRICS
     ObservabilityPipelineSplunkHecSource:
       description: |-
         The `splunk_hec` source implements the Splunk HTTP Event Collector (HEC) API.
@@ -111135,6 +111250,68 @@ paths:
       x-unstable: |-
         **Note**: This endpoint is in preview and is subject to change.
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
+  /api/v2/cost/tag_metadata/months:
+    get:
+      description: |-
+        List months that have Cloud Cost Management tag metadata for a given provider,
+        ordered most-recent first. The response is capped at 36 months.
+      operationId: ListCostTagMetadataMonths
+      parameters:
+        - description: |-
+            Provider to scope the query to. Use the value of the `providername` tag in CCM
+            (for example, `aws`, `azure`, `gcp`, `Oracle`, `Confluent Cloud`, `Snowflake`).
+            For costs uploaded through the Custom Costs API, use `custom`.
+            Values are case-sensitive.
+          example: aws
+          in: query
+          name: filter[provider]
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      - id: "2026-04"
+                        type: cost_tag_metadata_month
+                      - id: "2026-03"
+                        type: cost_tag_metadata_month
+              schema:
+                $ref: "#/components/schemas/CostTagMetadataMonthsResponse"
+          description: OK
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/APIErrorResponse"
+          description: Bad Request
+        "403":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/APIErrorResponse"
+          description: Forbidden
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+      security:
+        - apiKeyAuth: []
+          appKeyAuth: []
+        - AuthZ:
+            - cloud_cost_management_read
+      summary: List Cloud Cost Management tag metadata months
+      tags:
+        - Cloud Cost Management
+      "x-permission":
+        operator: OR
+        permissions:
+          - cloud_cost_management_read
+      x-unstable: |-
+        **Note**: This endpoint is in preview and is subject to change.
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).
   /api/v2/cost/tag_metadata/orchestrators:
     get:
       description: List container orchestrators (for example, `kubernetes`, `ecs`) detected in Cloud Cost Management data for the requested period.

diff --git a/examples/v2/cloud-cost-management/ListCostTagMetadataMonths.rb b/examples/v2/cloud-cost-management/ListCostTagMetadataMonths.rb
@@ -0,0 +1,8 @@
+# List Cloud Cost Management tag metadata months returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.list_cost_tag_metadata_months".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::CloudCostManagementAPI.new
+p api_instance.list_cost_tag_metadata_months("filter[provider]")
diff --git a/features/scenarios_model_mapping.rb b/features/scenarios_model_mapping.rb
@@ -2643,6 +2643,9 @@
             "filter_month" => "String",
             "filter_provider" => "String",
     },
+    "v2.ListCostTagMetadataMonths" => {
+            "filter_provider" => "String",
+    },
     "v2.ListCostTagMetadataOrchestrators" => {
             "filter_month" => "String",
             "filter_provider" => "String",

diff --git a/features/v2/cloud_cost_management.feature b/features/v2/cloud_cost_management.feature
@@ -606,6 +606,22 @@ Feature: Cloud Cost Management
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/cloud-cost-management
+  Scenario: List Cloud Cost Management tag metadata months returns "Bad Request" response
+    Given operation "ListCostTagMetadataMonths" enabled
+    And new "ListCostTagMetadataMonths" request
+    And request contains "filter[provider]" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/cloud-cost-management
+  Scenario: List Cloud Cost Management tag metadata months returns "OK" response
+    Given operation "ListCostTagMetadataMonths" enabled
+    And new "ListCostTagMetadataMonths" request
+    And request contains "filter[provider]" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK
+
   @generated @skip @team:DataDog/cloud-cost-management
   Scenario: List Cloud Cost Management tag sources returns "Bad Request" response
     Given operation "ListCostTagKeySources" enabled

diff --git a/features/v2/undo.json b/features/v2/undo.json
@@ -1898,6 +1898,12 @@
       "type": "safe"
     }
   },
+  "ListCostTagMetadataMonths": {
+    "tag": "Cloud Cost Management",
+    "undo": {
+      "type": "safe"
+    }
+  },
   "ListCostTagMetadataOrchestrators": {
     "tag": "Cloud Cost Management",
     "undo": {

diff --git a/lib/datadog_api_client/configuration.rb b/lib/datadog_api_client/configuration.rb
@@ -387,6 +387,7 @@ def initialize
             "v2.list_cost_tag_key_sources": false,
             "v2.list_cost_tag_metadata": false,
             "v2.list_cost_tag_metadata_metrics": false,
+            "v2.list_cost_tag_metadata_months": false,
             "v2.list_cost_tag_metadata_orchestrators": false,
             "v2.search_cost_recommendations": false,
             "v2.create_dashboard_secure_embed": false,

diff --git a/lib/datadog_api_client/inflector.rb b/lib/datadog_api_client/inflector.rb
@@ -2234,6 +2234,9 @@ def overrides
           "v2.cost_tag_keys_response" => "CostTagKeysResponse",
           "v2.cost_tag_key_type" => "CostTagKeyType",
           "v2.cost_tag_metadata_daily_filter" => "CostTagMetadataDailyFilter",
+          "v2.cost_tag_metadata_month" => "CostTagMetadataMonth",
+          "v2.cost_tag_metadata_months_response" => "CostTagMetadataMonthsResponse",
+          "v2.cost_tag_metadata_month_type" => "CostTagMetadataMonthType",
           "v2.cost_tags_response" => "CostTagsResponse",
           "v2.cost_tag_type" => "CostTagType",
           "v2.coverage_summary_attributes" => "CoverageSummaryAttributes",
@@ -4729,6 +4732,9 @@ def overrides
           "v2.observability_pipeline_splunk_hec_destination_encoding" => "ObservabilityPipelineSplunkHecDestinationEncoding",
           "v2.observability_pipeline_splunk_hec_destination_token_strategy" => "ObservabilityPipelineSplunkHecDestinationTokenStrategy",
           "v2.observability_pipeline_splunk_hec_destination_type" => "ObservabilityPipelineSplunkHecDestinationType",
+          "v2.observability_pipeline_splunk_hec_metrics_destination" => "ObservabilityPipelineSplunkHecMetricsDestination",
+          "v2.observability_pipeline_splunk_hec_metrics_destination_compression" => "ObservabilityPipelineSplunkHecMetricsDestinationCompression",
+          "v2.observability_pipeline_splunk_hec_metrics_destination_type" => "ObservabilityPipelineSplunkHecMetricsDestinationType",
           "v2.observability_pipeline_splunk_hec_source" => "ObservabilityPipelineSplunkHecSource",
           "v2.observability_pipeline_splunk_hec_source_type" => "ObservabilityPipelineSplunkHecSourceType",
           "v2.observability_pipeline_splunk_hec_source_valid_token" => "ObservabilityPipelineSplunkHecSourceValidToken",

diff --git a/lib/datadog_api_client/v2/api/cloud_cost_management_api.rb b/lib/datadog_api_client/v2/api/cloud_cost_management_api.rb
@@ -3039,6 +3039,79 @@ def list_cost_tag_metadata_metrics_with_http_info(filter_month, opts = {})
       return data, status_code, headers
     end
 
+    # List Cloud Cost Management tag metadata months.
+    #
+    # @see #list_cost_tag_metadata_months_with_http_info
+    def list_cost_tag_metadata_months(filter_provider, opts = {})
+      data, _status_code, _headers = list_cost_tag_metadata_months_with_http_info(filter_provider, opts)
+      data
+    end
+
+    # List Cloud Cost Management tag metadata months.
+    #
+    # List months that have Cloud Cost Management tag metadata for a given provider,
+    # ordered most-recent first. The response is capped at 36 months.
+    #
+    # @param filter_provider [String] Provider to scope the query to. Use the value of the `providername` tag in CCM (for example, `aws`, `azure`, `gcp`, `Oracle`, `Confluent Cloud`, `Snowflake`). For costs uploaded through the Custom Costs API, use `custom`. Values are case-sensitive.
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(CostTagMetadataMonthsResponse, Integer, Hash)>] CostTagMetadataMonthsResponse data, response status code and response headers
+    def list_cost_tag_metadata_months_with_http_info(filter_provider, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_cost_tag_metadata_months".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_cost_tag_metadata_months")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_cost_tag_metadata_months"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: CloudCostManagementAPI.list_cost_tag_metadata_months ...'
+      end
+      # verify the required parameter 'filter_provider' is set
+      if @api_client.config.client_side_validation && filter_provider.nil?
+        fail ArgumentError, "Missing the required parameter 'filter_provider' when calling CloudCostManagementAPI.list_cost_tag_metadata_months"
+      end
+      # resource path
+      local_var_path = '/api/v2/cost/tag_metadata/months'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'filter[provider]'] = filter_provider
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CostTagMetadataMonthsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :list_cost_tag_metadata_months,
+        :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::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: CloudCostManagementAPI#list_cost_tag_metadata_months\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List Cloud Cost Management orchestrators.
     #
     # @see #list_cost_tag_metadata_orchestrators_with_http_info