Add metrics bulk-config endpoint (#818)

* support empty lookup

* Regenerate client from commit cdd703e of spec repo

Co-authored-by: Jiri Kuncar <[email protected]>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>
Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: 3 people

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.2",
-            "regenerated": "2022-02-14 20:16:50.775696",
-            "spec_repo_commit": "5d7c376"
+            "regenerated": "2022-02-15 12:44:12.175938",
+            "spec_repo_commit": "cdd703e"
         },
         "v2": {
             "apigentools_version": "1.6.2",
-            "regenerated": "2022-02-14 20:16:50.787694",
-            "spec_repo_commit": "5d7c376"
+            "regenerated": "2022-02-15 12:44:12.189619",
+            "spec_repo_commit": "cdd703e"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -3458,6 +3458,132 @@ components:
           $ref: '#/components/schemas/MetricAllTags'
       readOnly: true
       type: object
+    MetricBulkConfigureTagsType:
+      default: metric_bulk_configure_tags
+      description: The metric bulk configure tags resource.
+      enum:
+      - metric_bulk_configure_tags
+      example: metric_bulk_configure_tags
+      x-enum-varnames:
+      - BULK_MANAGE_TAGS
+    MetricBulkTagConfigCreate:
+      description: Request object to bulk configure tags for metrics matching the
+        given prefix.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/MetricBulkTagConfigCreateAttributes'
+        id:
+          $ref: '#/components/schemas/MetricBulkTagConfigNamePrefix'
+        type:
+          $ref: '#/components/schemas/MetricBulkConfigureTagsType'
+      required:
+      - id
+      - type
+      type: object
+    MetricBulkTagConfigCreateAttributes:
+      description: Optional parameters for bulk creating metric tag configurations.
+      properties:
+        emails:
+          $ref: '#/components/schemas/MetricBulkTagConfigEmailList'
+        tags:
+          $ref: '#/components/schemas/MetricBulkTagConfigTagNameList'
+      type: object
+    MetricBulkTagConfigCreateRequest:
+      description: Wrapper object for a single bulk tag configuration request.
+      properties:
+        data:
+          $ref: '#/components/schemas/MetricBulkTagConfigCreate'
+      required:
+      - data
+      type: object
+    MetricBulkTagConfigDelete:
+      description: Request object to bulk delete all tag configurations for metrics
+        matching the given prefix.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/MetricBulkTagConfigDeleteAttributes'
+        id:
+          $ref: '#/components/schemas/MetricBulkTagConfigNamePrefix'
+        type:
+          $ref: '#/components/schemas/MetricBulkConfigureTagsType'
+      required:
+      - id
+      - type
+      type: object
+    MetricBulkTagConfigDeleteAttributes:
+      description: Optional parameters for bulk deleting metric tag configurations.
+      properties:
+        emails:
+          $ref: '#/components/schemas/MetricBulkTagConfigEmailList'
+      type: object
+    MetricBulkTagConfigDeleteRequest:
+      description: Wrapper object for a single bulk tag deletion request.
+      properties:
+        data:
+          $ref: '#/components/schemas/MetricBulkTagConfigDelete'
+      required:
+      - data
+      type: object
+    MetricBulkTagConfigEmailList:
+      description: A list of account emails to notify when the configuration is applied.
+      example:
+      - [email protected]
+      - [email protected]
+      items:
+        description: An email address.
+        format: email
+        type: string
+      type: array
+    MetricBulkTagConfigNamePrefix:
+      description: A text prefix to match against metric names.
+      example: kafka.lag
+      type: string
+    MetricBulkTagConfigResponse:
+      description: Wrapper for a single bulk tag configuration status response.
+      properties:
+        data:
+          $ref: '#/components/schemas/MetricBulkTagConfigStatus'
+      type: object
+    MetricBulkTagConfigStatus:
+      description: 'The status of a request to bulk configure metric tags.
+
+        It contains the fields from the original request for reference.'
+      properties:
+        attributes:
+          $ref: '#/components/schemas/MetricBulkTagConfigStatusAttributes'
+        id:
+          $ref: '#/components/schemas/MetricBulkTagConfigNamePrefix'
+        type:
+          $ref: '#/components/schemas/MetricBulkConfigureTagsType'
+      required:
+      - id
+      - type
+      type: object
+    MetricBulkTagConfigStatusAttributes:
+      description: Optional attributes for the status of a bulk tag configuration
+        request.
+      properties:
+        emails:
+          $ref: '#/components/schemas/MetricBulkTagConfigEmailList'
+        status:
+          description: The status of the request.
+          example: Accepted
+          type: string
+        tags:
+          $ref: '#/components/schemas/MetricBulkTagConfigTagNameList'
+      type: object
+    MetricBulkTagConfigTagNameList:
+      description: A list of tag names to apply to the configuration.
+      example:
+      - host
+      - pod_name
+      - is_shadow
+      items:
+        description: A metric tag name.
+        maxLength: 200
+        pattern: ^[A-Za-z][A-Za-z0-9\.\-\_:\/]*$
+        type: string
+      type: array
     MetricCustomAggregation:
       description: A time and space aggregation combination for use in query.
       example:
@@ -8153,6 +8279,137 @@ paths:
         is only accessible for Metrics without Limits™ beta customers.\nIf you\u2019re
         interested in Metrics without Limits™, please contact your Customer
         Success Manager.**"
+  /api/v2/metrics/config/bulk-tags:
+    delete:
+      description: 'Delete all custom lists of queryable tag keys for a set of existing
+        count, gauge, rate, and distribution metrics.
+
+        Metrics are selected by passing a metric name prefix.
+
+        Results can be sent to a set of account email addresses, just like the same
+        operation in the Datadog web app.
+
+        Can only be used with application keys of users with the `Manage Tags for
+        Metrics` permission.'
+      operationId: DeleteBulkTagsMetricsConfiguration
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/MetricBulkTagConfigDeleteRequest'
+        required: true
+      responses:
+        '202':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MetricBulkTagConfigResponse'
+          description: Accepted
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Too Many Requests
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Configure tags for multiple metrics
+      tags:
+      - Metrics
+      x-codegen-request-body-name: body
+      x-menu-order: 9
+      x-undo:
+        type: idempotent
+    post:
+      description: 'Create and define a list of queryable tag keys for a set of existing
+        count, gauge, rate, and distribution metrics.
+
+        Metrics are selected by passing a metric name prefix. Use the Delete method
+        of this API path to remove tag configurations.
+
+        Results can be sent to a set of account email addresses, just like the same
+        operation in the Datadog web app.
+
+        If multiple calls include the same metric, the last configuration applied
+        (not by submit order) is used, do not
+
+        expect deterministic ordering of concurrent calls.
+
+        Can only be used with application keys of users with the `Manage Tags for
+        Metrics` permission.'
+      operationId: CreateBulkTagsMetricsConfiguration
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/MetricBulkTagConfigCreateRequest'
+        required: true
+      responses:
+        '202':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/MetricBulkTagConfigResponse'
+          description: Accepted
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not Found
+        '429':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Too Many Requests
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Configure tags for multiple metrics
+      tags:
+      - Metrics
+      x-codegen-request-body-name: body
+      x-menu-order: 8
+      x-undo:
+        operationId: DeleteBulkTagsMetricsConfiguration
+        parameters:
+        - name: body
+          source: ''
+        type: unsafe
   /api/v2/metrics/{metric_name}/all-tags:
     get:
       description: View indexed tag key-value pairs for a given metric name.

docs/datadog_api_client.v2.model.rst

@@ -1673,6 +1673,102 @@ metric\_all\_tags\_response
    :undoc-members:
    :show-inheritance:
 
+metric\_bulk\_configure\_tags\_type
+-----------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_configure_tags_type
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_create
+---------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_create
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_create\_attributes
+---------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_create_attributes
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_create\_request
+------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_create_request
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_delete
+---------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_delete
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_delete\_attributes
+---------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_delete_attributes
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_delete\_request
+------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_delete_request
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_email\_list
+--------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_email_list
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_response
+-----------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_response
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_status
+---------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_status
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_status\_attributes
+---------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_status_attributes
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+metric\_bulk\_tag\_config\_tag\_name\_list
+------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.metric_bulk_tag_config_tag_name_list
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
 metric\_custom\_aggregation
 ---------------------------