feat(iam/v1alpha1): add method to create a user (#264)

Author: scaleway-bot

scaleway-async/scaleway_async/iam/v1alpha1/api.py

@@ -47,6 +47,7 @@
     User,
     CreateSSHKeyRequest,
     UpdateSSHKeyRequest,
+    CreateUserRequest,
     CreateApplicationRequest,
     UpdateApplicationRequest,
     CreateGroupRequest,
@@ -69,6 +70,7 @@
     marshal_CreateGroupRequest,
     marshal_CreatePolicyRequest,
     marshal_CreateSSHKeyRequest,
+    marshal_CreateUserRequest,
     marshal_RemoveGroupMemberRequest,
     marshal_SetGroupMembersRequest,
     marshal_SetRulesRequest,
@@ -464,6 +466,40 @@ async def delete_user(
         self._throw_on_error(res)
         return None
 
+    async def create_user(
+        self,
+        *,
+        email: str,
+        organization_id: Optional[str] = None,
+    ) -> User:
+        """
+        Create a new user.
+        Create a new user. You must define the `organization_id` and the `email` in your request.
+        :param organization_id: ID of the Organization.
+        :param email: Email of the user.
+        :return: :class:`User <User>`
+
+        Usage:
+        ::
+
+            result = await api.create_user(email="example")
+        """
+
+        res = self._request(
+            "POST",
+            f"/iam/v1alpha1/users",
+            body=marshal_CreateUserRequest(
+                CreateUserRequest(
+                    email=email,
+                    organization_id=organization_id,
+                ),
+                self.client,
+            ),
+        )
+
+        self._throw_on_error(res)
+        return unmarshal_User(res.json())
+
     async def list_applications(
         self,
         *,

scaleway-async/scaleway_async/iam/v1alpha1/marshalling.py

@@ -34,6 +34,7 @@
     User,
     CreateSSHKeyRequest,
     UpdateSSHKeyRequest,
+    CreateUserRequest,
     CreateApplicationRequest,
     UpdateApplicationRequest,
     CreateGroupRequest,
@@ -753,6 +754,16 @@ def marshal_CreateSSHKeyRequest(
     }
 
 
+def marshal_CreateUserRequest(
+    request: CreateUserRequest,
+    defaults: ProfileDefaults,
+) -> Dict[str, Any]:
+    return {
+        "email": request.email,
+        "organization_id": request.organization_id or defaults.default_organization_id,
+    }
+
+
 def marshal_RemoveGroupMemberRequest(
     request: RemoveGroupMemberRequest,
     defaults: ProfileDefaults,

scaleway-async/scaleway_async/iam/v1alpha1/types.py

@@ -991,6 +991,19 @@ class DeleteUserRequest:
     """
 
 
+@dataclass
+class CreateUserRequest:
+    organization_id: Optional[str]
+    """
+    ID of the Organization.
+    """
+
+    email: str
+    """
+    Email of the user.
+    """
+
+
 @dataclass
 class ListApplicationsRequest:
     order_by: Optional[ListApplicationsRequestOrderBy]

scaleway/scaleway/iam/v1alpha1/api.py

@@ -47,6 +47,7 @@
     User,
     CreateSSHKeyRequest,
     UpdateSSHKeyRequest,
+    CreateUserRequest,
     CreateApplicationRequest,
     UpdateApplicationRequest,
     CreateGroupRequest,
@@ -69,6 +70,7 @@
     marshal_CreateGroupRequest,
     marshal_CreatePolicyRequest,
     marshal_CreateSSHKeyRequest,
+    marshal_CreateUserRequest,
     marshal_RemoveGroupMemberRequest,
     marshal_SetGroupMembersRequest,
     marshal_SetRulesRequest,
@@ -464,6 +466,40 @@ def delete_user(
         self._throw_on_error(res)
         return None
 
+    def create_user(
+        self,
+        *,
+        email: str,
+        organization_id: Optional[str] = None,
+    ) -> User:
+        """
+        Create a new user.
+        Create a new user. You must define the `organization_id` and the `email` in your request.
+        :param organization_id: ID of the Organization.
+        :param email: Email of the user.
+        :return: :class:`User <User>`
+
+        Usage:
+        ::
+
+            result = api.create_user(email="example")
+        """
+
+        res = self._request(
+            "POST",
+            f"/iam/v1alpha1/users",
+            body=marshal_CreateUserRequest(
+                CreateUserRequest(
+                    email=email,
+                    organization_id=organization_id,
+                ),
+                self.client,
+            ),
+        )
+
+        self._throw_on_error(res)
+        return unmarshal_User(res.json())
+
     def list_applications(
         self,
         *,

scaleway/scaleway/iam/v1alpha1/marshalling.py

@@ -34,6 +34,7 @@
     User,
     CreateSSHKeyRequest,
     UpdateSSHKeyRequest,
+    CreateUserRequest,
     CreateApplicationRequest,
     UpdateApplicationRequest,
     CreateGroupRequest,
@@ -753,6 +754,16 @@ def marshal_CreateSSHKeyRequest(
     }
 
 
+def marshal_CreateUserRequest(
+    request: CreateUserRequest,
+    defaults: ProfileDefaults,
+) -> Dict[str, Any]:
+    return {
+        "email": request.email,
+        "organization_id": request.organization_id or defaults.default_organization_id,
+    }
+
+
 def marshal_RemoveGroupMemberRequest(
     request: RemoveGroupMemberRequest,
     defaults: ProfileDefaults,

scaleway/scaleway/iam/v1alpha1/types.py

@@ -991,6 +991,19 @@ class DeleteUserRequest:
     """
 
 
+@dataclass
+class CreateUserRequest:
+    organization_id: Optional[str]
+    """
+    ID of the Organization.
+    """
+
+    email: str
+    """
+    Email of the user.
+    """
+
+
 @dataclass
 class ListApplicationsRequest:
     order_by: Optional[ListApplicationsRequestOrderBy]