Clarify a required spec for downtime scope (#1058)

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

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:27.602100",
-            "spec_repo_commit": "f09bf63c"
+            "regenerated": "2023-03-07 22:36:05.692522",
+            "spec_repo_commit": "73e66c9a"
         },
         "v2": {
             "apigentools_version": "1.6.4",
-            "regenerated": "2023-03-07 18:54:27.614041",
-            "spec_repo_commit": "f09bf63c"
+            "regenerated": "2023-03-07 22:36:05.705736",
+            "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`.
 

packages/datadog-api-client-v1/models/CancelDowntimesByScopeRequest.ts

@@ -11,7 +11,7 @@ import { AttributeTypeMap } from "../../datadog-api-client-common/util";
  */
 export class CancelDowntimesByScopeRequest {
   /**
-   * The scope(s) to which the downtime applies. For example, `host:app2`.
+   * 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`).
    */

packages/datadog-api-client-v1/models/Downtime.ts

@@ -81,7 +81,7 @@ export class Downtime {
    */
   "recurrence"?: DowntimeRecurrence;
   /**
-   * The scope(s) to which the downtime applies. For example, `host:app2`.
+   * 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`).
    */

packages/datadog-api-client-v1/models/DowntimeChild.ts

@@ -73,7 +73,7 @@ export class DowntimeChild {
    */
   "recurrence"?: DowntimeRecurrence;
   /**
-   * The scope(s) to which the downtime applies. For example, `host:app2`.
+   * 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`).
    */