Add endpoint for cloning roles

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.5.1.dev2",
-            "regenerated": "2021-12-21 22:39:17.263983",
-            "spec_repo_commit": "90bc255"
+            "regenerated": "2021-12-21 23:32:28.136622",
+            "spec_repo_commit": "4bb7a8e"
         },
         "v2": {
             "apigentools_version": "1.5.1.dev2",
-            "regenerated": "2021-12-21 22:39:17.741810",
-            "spec_repo_commit": "90bc255"
+            "regenerated": "2021-12-21 23:32:28.666161",
+            "spec_repo_commit": "4bb7a8e"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -3927,6 +3927,36 @@ components:
           readOnly: true
           type: integer
       type: object
+    RoleClone:
+      description: Data for the clone role request.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/RoleCloneAttributes'
+        type:
+          $ref: '#/components/schemas/RolesType'
+      required:
+      - type
+      - attributes
+      type: object
+    RoleCloneAttributes:
+      description: Attributes required to create a new role by cloning an existing
+        one.
+      properties:
+        name:
+          description: Name of the new role that is cloned.
+          example: cloned-role
+          type: string
+      required:
+      - name
+      type: object
+    RoleCloneRequest:
+      description: Request to create a role by cloning an existing role.
+      properties:
+        data:
+          $ref: '#/components/schemas/RoleClone'
+      required:
+      - data
+      type: object
     RoleCreateAttributes:
       description: Attributes of the created role.
       properties:
@@ -8028,6 +8058,68 @@ paths:
       x-menu-order: 4
       x-undo:
         type: idempotent
+  /api/v2/roles/{role_id}/clone:
+    post:
+      description: Clone an existing role
+      operationId: CloneRole
+      parameters:
+      - $ref: '#/components/parameters/RoleID'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/RoleCloneRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RoleResponse'
+          description: OK
+        '400':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Authentication error
+        '404':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Not found
+        '409':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Conflict
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - user_access_manage
+      summary: Create a new role by cloning an existing role
+      tags:
+      - Roles
+      x-codegen-request-body-name: body
+      x-menu-order: 12
+      x-permission: OR(USER_ACCESS_MANAGE)
+      x-undo:
+        operationId: DeleteRole
+        parameters:
+        - name: role_id
+          source: data.id
+        type: unsafe
   /api/v2/roles/{role_id}/permissions:
     delete:
       description: Removes a permission from a role.

examples/v2/roles/CloneRole.py

@@ -0,0 +1,30 @@
+"""
+Create a new role by cloning an existing role returns "OK" response
+"""
+
+from os import environ
+from datadog_api_client.v2 import ApiClient, Configuration
+from datadog_api_client.v2.api.roles_api import RolesApi
+from datadog_api_client.v2.model.role_clone import RoleClone
+from datadog_api_client.v2.model.role_clone_attributes import RoleCloneAttributes
+from datadog_api_client.v2.model.role_clone_request import RoleCloneRequest
+from datadog_api_client.v2.model.roles_type import RolesType
+
+# there is a valid "role" in the system
+ROLE_DATA_ID = environ["ROLE_DATA_ID"]
+
+body = RoleCloneRequest(
+    data=RoleClone(
+        attributes=RoleCloneAttributes(
+            name="Example-Create_a_new_role_by_cloning_an_existing_role_returns_OK_response clone"
+        ),
+        type=RolesType("roles"),
+    )
+)
+
+configuration = Configuration()
+with ApiClient(configuration) as api_client:
+    api_instance = RolesApi(api_client)
+    response = api_instance.clone_role(role_id=ROLE_DATA_ID, body=body)
+
+    print(response)