Mark dashboard 'is_read_only' and 'restricted_roles' properties as deprecated (#1827)

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.6",
-            "regenerated": "2024-01-12 20:45:42.549804",
-            "spec_repo_commit": "bdf7d582"
+            "regenerated": "2024-01-18 22:52:00.053133",
+            "spec_repo_commit": "4d921fb1"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-01-12 20:45:42.564088",
-            "spec_repo_commit": "bdf7d582"
+            "regenerated": "2024-01-18 22:52:00.067802",
+            "spec_repo_commit": "4d921fb1"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -1142,9 +1142,12 @@ components:
         is_read_only:
           default: false
           deprecated: true
-          description: Whether this dashboard is read-only. If True, only the author
-            and admins can make changes to it. Prefer using `restricted_roles` to
-            manage write authorization.
+          description: 'Whether this dashboard is read-only. If True, only the author
+            and admins can make changes to it.
+
+
+            This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies/)
+            instead to manage write authorization for individual dashboards.'
           example: false
           type: boolean
         layout_type:
@@ -1165,8 +1168,13 @@ components:
         reflow_type:
           $ref: '#/components/schemas/DashboardReflowType'
         restricted_roles:
-          description: A list of role identifiers. Only the author and users associated
+          deprecated: true
+          description: 'A list of role identifiers. Only the author and users associated
             with at least one of these roles can edit this dashboard.
+
+
+            This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies/)
+            instead to manage write authorization for individual dashboards.'
           items:
             description: A role UUID.
             type: string
@@ -1439,8 +1447,13 @@ components:
           description: Dashboard identifier.
           type: string
         is_read_only:
-          description: Whether this dashboard is read-only. If True, only the author
+          deprecated: true
+          description: 'Whether this dashboard is read-only. If True, only the author
             and admins can make changes to it.
+
+
+            This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies/)
+            instead to manage write authorization for individual dashboards.'
           type: boolean
         layout_type:
           $ref: '#/components/schemas/DashboardLayoutType'

src/datadog_api_client/v1/model/dashboard.py

@@ -126,7 +126,9 @@ def __init__(
         :param id: ID of the dashboard.
         :type id: str, optional
 
-        :param is_read_only: Whether this dashboard is read-only. If True, only the author and admins can make changes to it. Prefer using ``restricted_roles`` to manage write authorization. **Deprecated**.
+        :param is_read_only: Whether this dashboard is read-only. If True, only the author and admins can make changes to it.
+
+            This property is deprecated; please use the `Restriction Policies API <https://docs.datadoghq.com/api/latest/restriction-policies/>`_ instead to manage write authorization for individual dashboards. **Deprecated**.
         :type is_read_only: bool, optional
 
         :param layout_type: Layout type of the dashboard.
@@ -144,6 +146,8 @@ def __init__(
         :type reflow_type: DashboardReflowType, optional
 
         :param restricted_roles: A list of role identifiers. Only the author and users associated with at least one of these roles can edit this dashboard.
+
+            This property is deprecated; please use the `Restriction Policies API <https://docs.datadoghq.com/api/latest/restriction-policies/>`_ instead to manage write authorization for individual dashboards. **Deprecated**.
         :type restricted_roles: [str], optional
 
         :param tags: List of team names representing ownership of a dashboard.

src/datadog_api_client/v1/model/dashboard_summary_definition.py

@@ -77,6 +77,8 @@ def __init__(
         :type id: str, optional
 
         :param is_read_only: Whether this dashboard is read-only. If True, only the author and admins can make changes to it.
+
+            This property is deprecated; please use the `Restriction Policies API <https://docs.datadoghq.com/api/latest/restriction-policies/>`_ instead to manage write authorization for individual dashboards. **Deprecated**.
         :type is_read_only: bool, optional
 
         :param layout_type: Layout type of the dashboard.