Regenerate client from commit 0f3171c9 of spec repo

Author: ci.datadog-api-spec

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.2",
-            "regenerated": "2022-04-04 08:22:32.909165",
-            "spec_repo_commit": "42159e33"
+            "regenerated": "2022-04-04 09:27:13.763934",
+            "spec_repo_commit": "0f3171c9"
         },
         "v2": {
             "apigentools_version": "1.6.2",
-            "regenerated": "2022-04-04 08:22:32.923119",
-            "spec_repo_commit": "42159e33"
+            "regenerated": "2022-04-04 09:27:13.780157",
+            "spec_repo_commit": "0f3171c9"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -14570,6 +14570,11 @@ components:
             all hours in the current date for all organizations.
           format: int64
           type: integer
+        observability_pipelines_bytes_processed_sum:
+          description: Sum of all observability pipelines bytes processed over all
+            hours in the current date for the given org.
+          format: int64
+          type: integer
         online_archive_events_count_sum:
           description: Sum of all online archived events over all hours in the current
             date for all organizations.
@@ -14887,6 +14892,11 @@ components:
             all hours in the current date for the given org.
           format: int64
           type: integer
+        observability_pipelines_bytes_processed_sum:
+          description: Sum of all observability pipelines bytes processed over all
+            hours in the current date for the given org.
+          format: int64
+          type: integer
         online_archive_events_count_sum:
           description: Sum of all online archived events over all hours in the current
             date for the given org.
@@ -15228,6 +15238,11 @@ components:
             all hours in the current months for all organizations.
           format: int64
           type: integer
+        observability_pipelines_bytes_processed_agg_sum:
+          description: Sum of all observability pipelines bytes processed over all
+            hours in the current months for all organizations.
+          format: int64
+          type: integer
         online_archive_events_count_agg_sum:
           description: Sum of all online archived events over all hours in the current
             months for all organizations.

.generator/schemas/v2/openapi.yaml

@@ -1594,6 +1594,11 @@ components:
       required:
       - name
       type: object
+    HourlyUsageType:
+      description: Usage type that is being measured.
+      enum:
+      - observability_pipelines_bytes_processed
+      type: string
     IncidentCreateAttributes:
       description: The incident's attributes for a create request.
       properties:
@@ -6441,6 +6446,60 @@ components:
       required:
       - data
       type: object
+    UsageAttributesObject:
+      description: Usage attributes data.
+      properties:
+        org_name:
+          description: The organization name.
+          type: string
+        product_family:
+          description: The product for which usage is being reported.
+          type: string
+        public_id:
+          description: The organization public ID.
+          type: string
+        timeseries:
+          description: List of usage data reported for each requested hour.
+          items:
+            $ref: '#/components/schemas/UsageTimeSeriesObject'
+          type: array
+        usage_type:
+          $ref: '#/components/schemas/HourlyUsageType'
+      type: object
+    UsageDataObject:
+      description: Usage data.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/UsageAttributesObject'
+        id:
+          description: Unique ID of the response.
+          type: string
+        type:
+          description: Type of usage data.
+          type: string
+      type: object
+    UsageObservabilityPipelinesResponse:
+      description: Observability Pipelines usage response.
+      properties:
+        data:
+          description: Response containing Observability Pipelines usage.
+          items:
+            $ref: '#/components/schemas/UsageDataObject'
+          type: array
+      type: object
+    UsageTimeSeriesObject:
+      description: Usage timeseries data.
+      properties:
+        timestamp:
+          description: Datetime in ISO-8601 format, UTC. The hour for the usage.
+          format: date-time
+          type: string
+        value:
+          description: Contains the number measured for the given usage_type during
+            the hour.
+          format: int64
+          type: integer
+      type: object
     User:
       description: User object returned by the API.
       properties:
@@ -11830,6 +11889,68 @@ paths:
         type: idempotent
       x-unstable: '**Note**: This endpoint is in public beta.
 
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/usage/observability-pipelines:
+    get:
+      description: Get hourly usage for Observability Pipelines.
+      operationId: GetUsageObservabilityPipelines
+      parameters:
+      - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
+          for usage beginning at this hour.'
+        in: query
+        name: start_hr
+        required: true
+        schema:
+          format: date-time
+          type: string
+      - description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`
+          for usage ending
+
+          **before** this hour.'
+        in: query
+        name: end_hr
+        required: false
+        schema:
+          format: date-time
+          type: string
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/UsageObservabilityPipelinesResponse'
+          description: OK
+        '400':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden - User is not authorized
+        '429':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Too many requests
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - usage_read
+      summary: Get hourly usage for Observability Pipelines.
+      tags:
+      - Usage Metering
+      x-menu-order: 38
+      x-undo:
+        type: safe
+      x-unstable: '**Note**: This endpoint is in public beta.
+
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/user_invitations:
     post:
@@ -12396,6 +12517,27 @@ tags:
   name: Security Monitoring
 - description: Create, edit, and disable service accounts.
   name: Service Accounts
+- description: 'The usage metering API allows you to get hourly, daily, and
+
+    monthly usage across multiple facets of Datadog.
+
+    This API is available to all Pro and Enterprise customers.
+
+    Usage is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/).
+
+
+    **Note**: Usage data is delayed by up to 72 hours from when it was incurred.
+
+    It is retained for the past 15 months.
+
+
+    You can retrieve up to 24 hours of hourly usage data for multiple organizations,
+
+    and up to two months of hourly usage data for a single organization in one request.'
+  externalDocs:
+    description: Find out more at
+    url: https://docs.datadoghq.com/account_management/billing/usage_details/
+  name: Usage Metering
 - description: Create, edit, and disable users.
   externalDocs:
     url: https://docs.datadoghq.com/account_management/users

docs/datadog_api_client.rst

@@ -5,7 +5,6 @@ datadog\_api\_client
    :maxdepth: 4
 
    datadog_api_client.v1
-   datadog_api_client.v2
 
 
 api\_client

examples/v2/usage-metering/GetUsageObservabilityPipelines.py

@@ -0,0 +1,18 @@
+"""
+Get hourly usage for Observability Pipelines. returns "OK" response
+"""
+
+from datetime import datetime
+from dateutil.relativedelta import relativedelta
+from datadog_api_client.v2 import ApiClient, Configuration
+from datadog_api_client.v2.api.usage_metering_api import UsageMeteringApi
+
+configuration = Configuration()
+with ApiClient(configuration) as api_client:
+    api_instance = UsageMeteringApi(api_client)
+    response = api_instance.get_usage_observability_pipelines(
+        start_hr=(datetime.now() + relativedelta(days=-5)).isoformat(timespec="seconds"),
+        end_hr=(datetime.now() + relativedelta(days=-3)).isoformat(timespec="seconds"),
+    )
+
+    print(response)