Add region field and note about multiregion start (#1386)

Co-authored-by: ci.datadog-api-spec <[email protected]>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2023-04-10 11:13:51.597147",
-            "spec_repo_commit": "04eeb6ee"
+            "regenerated": "2023-04-10 15:00:10.961149",
+            "spec_repo_commit": "615bff17"
         },
         "v2": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2023-04-10 11:13:51.609315",
-            "spec_repo_commit": "04eeb6ee"
+            "regenerated": "2023-04-10 15:00:11.011293",
+            "spec_repo_commit": "615bff17"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -3606,6 +3606,10 @@ components:
         public_id:
           description: The organization public ID.
           type: string
+        region:
+          description: The region of the Datadog instance that the organization belongs
+            to.
+          type: string
         tag_config_source:
           description: The source of the usage attribution tag configuration and the
             selected tags in the format of `<source_org_name>:::<selected tag 1>///<selected
@@ -7068,6 +7072,10 @@ components:
         public_id:
           description: The organization public ID.
           type: string
+        region:
+          description: The region of the Datadog instance that the organization belongs
+            to.
+          type: string
         tag_config_source:
           description: The source of the usage attribution tag configuration and the
             selected tags in the format `<source_org_name>:::<selected tag 1>///<selected
@@ -28591,10 +28599,11 @@ paths:
       - Usage Metering
   /api/v1/usage/hourly-attribution:
     get:
-      description: "Get hourly usage attribution.\n\nThis API endpoint is paginated.
-        To make sure you receive all records, check if the value of `next_record_id`
-        is\nset in the response. If it is, make another request and pass `next_record_id`
-        as a parameter.\nPseudo code example:\n\n```\nresponse := GetHourlyUsageAttribution(start_month)\ncursor
+      description: "Get hourly usage attribution. Multi-region data is available starting
+        March 1, 2023.\n\nThis API endpoint is paginated. To make sure you receive
+        all records, check if the value of `next_record_id` is\nset in the response.
+        If it is, make another request and pass `next_record_id` as a parameter.\nPseudo
+        code example:\n\n```\nresponse := GetHourlyUsageAttribution(start_month)\ncursor
         := response.metadata.pagination.next_record_id\nWHILE cursor != null BEGIN\n
         \ sleep(5 seconds)  # Avoid running into rate limit\n  response := GetHourlyUsageAttribution(start_month,
         next_record_id=cursor)\n  cursor := response.metadata.pagination.next_record_id\nEND\n```"
@@ -29102,10 +29111,11 @@ paths:
       - Usage Metering
   /api/v1/usage/monthly-attribution:
     get:
-      description: "Get monthly usage attribution.\n\nThis API endpoint is paginated.
-        To make sure you receive all records, check if the value of `next_record_id`
-        is\nset in the response. If it is, make another request and pass `next_record_id`
-        as a parameter.\nPseudo code example:\n\n```\nresponse := GetMonthlyUsageAttribution(start_month)\ncursor
+      description: "Get monthly usage attribution. Multi-region data is available
+        starting March 1, 2023.\n\nThis API endpoint is paginated. To make sure you
+        receive all records, check if the value of `next_record_id` is\nset in the
+        response. If it is, make another request and pass `next_record_id` as a parameter.\nPseudo
+        code example:\n\n```\nresponse := GetMonthlyUsageAttribution(start_month)\ncursor
         := response.metadata.pagination.next_record_id\nWHILE cursor != null BEGIN\n
         \ sleep(5 seconds)  # Avoid running into rate limit\n  response := GetMonthlyUsageAttribution(start_month,
         next_record_id=cursor)\n  cursor := response.metadata.pagination.next_record_id\nEND\n```"

src/datadog_api_client/v1/api/usage_metering_api.py

@@ -1392,7 +1392,7 @@ def get_hourly_usage_attribution(
     ) -> HourlyUsageAttributionResponse:
         """Get hourly usage attribution.
 
-        Get hourly usage attribution.
+        Get hourly usage attribution. Multi-region data is available starting March 1, 2023.
 
         This API endpoint is paginated. To make sure you receive all records, check if the value of ``next_record_id`` is
         set in the response. If it is, make another request and pass ``next_record_id`` as a parameter.
@@ -1550,7 +1550,7 @@ def get_monthly_usage_attribution(
     ) -> MonthlyUsageAttributionResponse:
         """Get monthly usage attribution.
 
-        Get monthly usage attribution.
+        Get monthly usage attribution. Multi-region data is available starting March 1, 2023.
 
         This API endpoint is paginated. To make sure you receive all records, check if the value of ``next_record_id`` is
         set in the response. If it is, make another request and pass ``next_record_id`` as a parameter.

src/datadog_api_client/v1/model/hourly_usage_attribution_body.py

@@ -29,6 +29,7 @@ def openapi_types(_):
             "hour": (datetime,),
             "org_name": (str,),
             "public_id": (str,),
+            "region": (str,),
             "tag_config_source": (str,),
             "tags": (UsageAttributionTagNames,),
             "total_usage_sum": (float,),
@@ -40,6 +41,7 @@ def openapi_types(_):
         "hour": "hour",
         "org_name": "org_name",
         "public_id": "public_id",
+        "region": "region",
         "tag_config_source": "tag_config_source",
         "tags": "tags",
         "total_usage_sum": "total_usage_sum",
@@ -52,6 +54,7 @@ def __init__(
         hour: Union[datetime, UnsetType] = unset,
         org_name: Union[str, UnsetType] = unset,
         public_id: Union[str, UnsetType] = unset,
+        region: Union[str, UnsetType] = unset,
         tag_config_source: Union[str, UnsetType] = unset,
         tags: Union[UsageAttributionTagNames, UnsetType] = unset,
         total_usage_sum: Union[float, UnsetType] = unset,
@@ -71,6 +74,9 @@ def __init__(
         :param public_id: The organization public ID.
         :type public_id: str, optional
 
+        :param region: The region of the Datadog instance that the organization belongs to.
+        :type region: str, optional
+
         :param tag_config_source: The source of the usage attribution tag configuration and the selected tags in the format of ``<source_org_name>:::<selected tag 1>///<selected tag 2>///<selected tag 3>``.
         :type tag_config_source: str, optional
 
@@ -96,6 +102,8 @@ def __init__(
             kwargs["org_name"] = org_name
         if public_id is not unset:
             kwargs["public_id"] = public_id
+        if region is not unset:
+            kwargs["region"] = region
         if tag_config_source is not unset:
             kwargs["tag_config_source"] = tag_config_source
         if tags is not unset:

src/datadog_api_client/v1/model/monthly_usage_attribution_body.py

@@ -29,6 +29,7 @@ def openapi_types(_):
             "month": (datetime,),
             "org_name": (str,),
             "public_id": (str,),
+            "region": (str,),
             "tag_config_source": (str,),
             "tags": (UsageAttributionTagNames,),
             "updated_at": (datetime,),
@@ -39,6 +40,7 @@ def openapi_types(_):
         "month": "month",
         "org_name": "org_name",
         "public_id": "public_id",
+        "region": "region",
         "tag_config_source": "tag_config_source",
         "tags": "tags",
         "updated_at": "updated_at",
@@ -50,6 +52,7 @@ def __init__(
         month: Union[datetime, UnsetType] = unset,
         org_name: Union[str, UnsetType] = unset,
         public_id: Union[str, UnsetType] = unset,
+        region: Union[str, UnsetType] = unset,
         tag_config_source: Union[str, UnsetType] = unset,
         tags: Union[UsageAttributionTagNames, UnsetType] = unset,
         updated_at: Union[datetime, UnsetType] = unset,
@@ -68,6 +71,9 @@ def __init__(
         :param public_id: The organization public ID.
         :type public_id: str, optional
 
+        :param region: The region of the Datadog instance that the organization belongs to.
+        :type region: str, optional
+
         :param tag_config_source: The source of the usage attribution tag configuration and the selected tags in the format ``<source_org_name>:::<selected tag 1>///<selected tag 2>///<selected tag 3>``.
         :type tag_config_source: str, optional
 
@@ -90,6 +96,8 @@ def __init__(
             kwargs["org_name"] = org_name
         if public_id is not unset:
             kwargs["public_id"] = public_id
+        if region is not unset:
+            kwargs["region"] = region
         if tag_config_source is not unset:
             kwargs["tag_config_source"] = tag_config_source
         if tags is not unset: