Clarify a required spec for downtime scope (#1369)

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-03-07 18:54:18.529425",
-            "spec_repo_commit": "f09bf63c"
+            "regenerated": "2023-03-07 22:36:00.834683",
+            "spec_repo_commit": "73e66c9a"
         },
         "v2": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2023-03-07 18:54:18.541358",
-            "spec_repo_commit": "f09bf63c"
+            "regenerated": "2023-03-07 22:36:00.847119",
+            "spec_repo_commit": "73e66c9a"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -697,7 +697,8 @@ components:
       description: Cancel downtimes according to scope.
       properties:
         scope:
-          description: 'The scope(s) to which the downtime applies. For example, `host:app2`.
+          description: 'The scope(s) to which the downtime applies and must be in
+            `key:value` format. For example, `host:app2`.
 
             Provide multiple scopes as a comma-separated list like `env:dev,env:prod`.
 
@@ -1678,7 +1679,8 @@ components:
         recurrence:
           $ref: '#/components/schemas/DowntimeRecurrence'
         scope:
-          description: 'The scope(s) to which the downtime applies. For example, `host:app2`.
+          description: 'The scope(s) to which the downtime applies and must be in
+            `key:value` format. For example, `host:app2`.
 
             Provide multiple scopes as a comma-separated list like `env:dev,env:prod`.
 
@@ -1812,7 +1814,8 @@ components:
         recurrence:
           $ref: '#/components/schemas/DowntimeRecurrence'
         scope:
-          description: 'The scope(s) to which the downtime applies. For example, `host:app2`.
+          description: 'The scope(s) to which the downtime applies and must be in
+            `key:value` format. For example, `host:app2`.
 
             Provide multiple scopes as a comma-separated list like `env:dev,env:prod`.
 

src/datadog_api_client/v1/model/cancel_downtimes_by_scope_request.py

@@ -25,7 +25,7 @@ def __init__(self_, scope: str, **kwargs):
         """
         Cancel downtimes according to scope.
 
-        :param scope: The scope(s) to which the downtime applies. For example, ``host:app2``.
+        :param scope: The scope(s) to which the downtime applies and must be in ``key:value`` format. For example, ``host:app2``.
             Provide multiple scopes as a comma-separated list like ``env:dev,env:prod``.
             The resulting downtime applies to sources that matches ALL provided scopes ( ``env:dev`` **AND** ``env:prod`` ).
         :type scope: str

src/datadog_api_client/v1/model/downtime.py

@@ -167,7 +167,7 @@ def __init__(
         :param recurrence: An object defining the recurrence of the downtime.
         :type recurrence: DowntimeRecurrence, none_type, optional
 
-        :param scope: The scope(s) to which the downtime applies. For example, ``host:app2``.
+        :param scope: The scope(s) to which the downtime applies and must be in ``key:value`` format. For example, ``host:app2``.
             Provide multiple scopes as a comma-separated list like ``env:dev,env:prod``.
             The resulting downtime applies to sources that matches ALL provided scopes ( ``env:dev`` **AND** ``env:prod`` ).
         :type scope: [str], optional

src/datadog_api_client/v1/model/downtime_child.py

@@ -156,7 +156,7 @@ def __init__(
         :param recurrence: An object defining the recurrence of the downtime.
         :type recurrence: DowntimeRecurrence, none_type, optional
 
-        :param scope: The scope(s) to which the downtime applies. For example, ``host:app2``.
+        :param scope: The scope(s) to which the downtime applies and must be in ``key:value`` format. For example, ``host:app2``.
             Provide multiple scopes as a comma-separated list like ``env:dev,env:prod``.
             The resulting downtime applies to sources that matches ALL provided scopes ( ``env:dev`` **AND** ``env:prod`` ).
         :type scope: [str], optional