Regenerate client from commit 7f08212f of spec repo (#967)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>
Co-authored-by: Thomas Hervé <thomas.herve@datadoghq.com>

Author: 3 people

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.2",
-            "regenerated": "2022-04-22 12:33:55.351426",
-            "spec_repo_commit": "4de29357"
+            "regenerated": "2022-04-25 19:54:51.323794",
+            "spec_repo_commit": "7f08212f"
         },
         "v2": {
             "apigentools_version": "1.6.2",
-            "regenerated": "2022-04-22 12:33:55.363690",
-            "spec_repo_commit": "4de29357"
+            "regenerated": "2022-04-25 19:54:51.335844",
+            "spec_repo_commit": "7f08212f"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -1048,6 +1048,23 @@ components:
       type: string
       x-enum-varnames:
       - AUTHN_MAPPINGS
+    ChargebackBreakdown:
+      description: Charges breakdown.
+      properties:
+        charge_type:
+          description: The type of charge for a particular product.
+          example: on_demand
+          type: string
+        cost:
+          description: The cost for a particular product and charge type during a
+            given month.
+          format: double
+          type: number
+        product_name:
+          description: The product for which cost is being reported.
+          example: infra_host
+          type: string
+      type: object
     CloudWorkloadSecurityAgentRuleAttributes:
       description: A Cloud Workload Security Agent rule returned by the API.
       properties:
@@ -1242,6 +1259,58 @@ components:
       x-enum-varnames:
       - GZIP
       - DEFLATE
+    CostByOrg:
+      description: Cost data.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/CostByOrgAttributes'
+        id:
+          description: Unique ID of the response.
+          type: string
+        type:
+          $ref: '#/components/schemas/CostByOrgType'
+      type: object
+    CostByOrgAttributes:
+      description: Cost attributes data.
+      properties:
+        charges:
+          description: List of charges data reported for the requested month.
+          items:
+            $ref: '#/components/schemas/ChargebackBreakdown'
+          type: array
+        date:
+          description: The month requested.
+          format: date-time
+          type: string
+        org_name:
+          description: The organization name.
+          type: string
+        public_id:
+          description: The organization public ID.
+          type: string
+        total_cost:
+          description: The total cost of products for the month.
+          format: double
+          type: number
+      type: object
+    CostByOrgResponse:
+      description: Chargeback Summary response.
+      properties:
+        data:
+          description: Response containing Chargeback Summary.
+          items:
+            $ref: '#/components/schemas/CostByOrg'
+          type: array
+      type: object
+    CostByOrgType:
+      default: cost_by_org
+      description: Type of cost data.
+      enum:
+      - cost_by_org
+      example: cost_by_org
+      type: string
+      x-enum-varnames:
+      - COST_BY_ORG
     Creator:
       description: Creator of the object.
       properties:
@@ -12001,6 +12070,63 @@ paths:
       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/cost_by_org:
+    get:
+      description: Get Cost Across Multi-Org Account.
+      operationId: GetCostByOrg
+      parameters:
+      - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`
+          for cost beginning this month.'
+        in: query
+        name: start_month
+        required: true
+        schema:
+          format: date-time
+          type: string
+      - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`
+          for cost ending this month.'
+        in: query
+        name: end_month
+        required: false
+        schema:
+          format: date-time
+          type: string
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/CostByOrgResponse'
+          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 Cost Across Multi-Org Account
+      tags:
+      - Usage Metering
+      x-menu-order: 39
+      x-undo:
+        type: safe
   /api/v2/usage/observability_pipelines:
     get:
       description: Get hourly usage for Observability Pipelines.

docs/datadog_api_client.v2.model.rst

@@ -433,6 +433,14 @@ authn\_mappings\_type
    :undoc-members:
    :show-inheritance:
 
+chargeback\_breakdown
+---------------------
+
+.. automodule:: datadog_api_client.v2.model.chargeback_breakdown
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
 cloud\_workload\_security\_agent\_rule\_attributes
 --------------------------------------------------
 
@@ -545,6 +553,38 @@ content\_encoding
    :undoc-members:
    :show-inheritance:
 
+cost\_by\_org
+-------------
+
+.. automodule:: datadog_api_client.v2.model.cost_by_org
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cost\_by\_org\_attributes
+-------------------------
+
+.. automodule:: datadog_api_client.v2.model.cost_by_org_attributes
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cost\_by\_org\_response
+-----------------------
+
+.. automodule:: datadog_api_client.v2.model.cost_by_org_response
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+cost\_by\_org\_type
+-------------------
+
+.. automodule:: datadog_api_client.v2.model.cost_by_org_type
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
 creator
 -------
 

examples/v2/usage-metering/GetCostByOrg.py

@@ -0,0 +1,17 @@
+"""
+Get Cost Across Multi-Org Account 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_cost_by_org(
+        start_month=(datetime.now() + relativedelta(days=-3)).isoformat(timespec="seconds"),
+    )
+
+    print(response)