feat(iam): new method to add group members (#181)

Author: scaleway-bot

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

@@ -53,6 +53,7 @@
     UpdateGroupRequest,
     SetGroupMembersRequest,
     AddGroupMemberRequest,
+    AddGroupMembersRequest,
     RemoveGroupMemberRequest,
     CreatePolicyRequest,
     UpdatePolicyRequest,
@@ -62,6 +63,7 @@
 )
 from .marshalling import (
     marshal_AddGroupMemberRequest,
+    marshal_AddGroupMembersRequest,
     marshal_CreateAPIKeyRequest,
     marshal_CreateApplicationRequest,
     marshal_CreateGroupRequest,
@@ -968,6 +970,45 @@ async def add_group_member(
         self._throw_on_error(res)
         return unmarshal_Group(res.json())
 
+    async def add_group_members(
+        self,
+        *,
+        group_id: str,
+        user_ids: Optional[List[str]] = None,
+        application_ids: Optional[List[str]] = None,
+    ) -> Group:
+        """
+        Add multiple users and applications to a group.
+        Add multiple users and applications to a group in a single call. You can specify an array of `user_id`s and `application_id`s. Note that any existing users and applications in the group will remain. To add new users/applications and delete pre-existing ones, use the [Overwrite users and applications of a group](#path-groups-overwrite-users-and-applications-of-a-group) method.
+        :param group_id: ID of the group.
+        :param user_ids: IDs of the users to add.
+        :param application_ids: IDs of the applications to add.
+        :return: :class:`Group <Group>`
+
+        Usage:
+        ::
+
+            result = await api.add_group_members(group_id="example")
+        """
+
+        param_group_id = validate_path_param("group_id", group_id)
+
+        res = self._request(
+            "POST",
+            f"/iam/v1alpha1/groups/{param_group_id}/add-members",
+            body=marshal_AddGroupMembersRequest(
+                AddGroupMembersRequest(
+                    group_id=group_id,
+                    user_ids=user_ids,
+                    application_ids=application_ids,
+                ),
+                self.client,
+            ),
+        )
+
+        self._throw_on_error(res)
+        return unmarshal_Group(res.json())
+
     async def remove_group_member(
         self,
         *,

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

@@ -40,6 +40,7 @@
     UpdateGroupRequest,
     SetGroupMembersRequest,
     AddGroupMemberRequest,
+    AddGroupMembersRequest,
     RemoveGroupMemberRequest,
     CreatePolicyRequest,
     UpdatePolicyRequest,
@@ -642,6 +643,16 @@ def marshal_AddGroupMemberRequest(
     }
 
 
+def marshal_AddGroupMembersRequest(
+    request: AddGroupMembersRequest,
+    defaults: ProfileDefaults,
+) -> Dict[str, Any]:
+    return {
+        "application_ids": request.application_ids,
+        "user_ids": request.user_ids,
+    }
+
+
 def marshal_CreateAPIKeyRequest(
     request: CreateAPIKeyRequest,
     defaults: ProfileDefaults,

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

@@ -1199,6 +1199,24 @@ class AddGroupMemberRequest:
     """
 
 
+@dataclass
+class AddGroupMembersRequest:
+    group_id: str
+    """
+    ID of the group.
+    """
+
+    user_ids: Optional[List[str]]
+    """
+    IDs of the users to add.
+    """
+
+    application_ids: Optional[List[str]]
+    """
+    IDs of the applications to add.
+    """
+
+
 @dataclass
 class RemoveGroupMemberRequest:
     group_id: str

scaleway/scaleway/iam/v1alpha1/api.py

@@ -53,6 +53,7 @@
     UpdateGroupRequest,
     SetGroupMembersRequest,
     AddGroupMemberRequest,
+    AddGroupMembersRequest,
     RemoveGroupMemberRequest,
     CreatePolicyRequest,
     UpdatePolicyRequest,
@@ -62,6 +63,7 @@
 )
 from .marshalling import (
     marshal_AddGroupMemberRequest,
+    marshal_AddGroupMembersRequest,
     marshal_CreateAPIKeyRequest,
     marshal_CreateApplicationRequest,
     marshal_CreateGroupRequest,
@@ -968,6 +970,45 @@ def add_group_member(
         self._throw_on_error(res)
         return unmarshal_Group(res.json())
 
+    def add_group_members(
+        self,
+        *,
+        group_id: str,
+        user_ids: Optional[List[str]] = None,
+        application_ids: Optional[List[str]] = None,
+    ) -> Group:
+        """
+        Add multiple users and applications to a group.
+        Add multiple users and applications to a group in a single call. You can specify an array of `user_id`s and `application_id`s. Note that any existing users and applications in the group will remain. To add new users/applications and delete pre-existing ones, use the [Overwrite users and applications of a group](#path-groups-overwrite-users-and-applications-of-a-group) method.
+        :param group_id: ID of the group.
+        :param user_ids: IDs of the users to add.
+        :param application_ids: IDs of the applications to add.
+        :return: :class:`Group <Group>`
+
+        Usage:
+        ::
+
+            result = api.add_group_members(group_id="example")
+        """
+
+        param_group_id = validate_path_param("group_id", group_id)
+
+        res = self._request(
+            "POST",
+            f"/iam/v1alpha1/groups/{param_group_id}/add-members",
+            body=marshal_AddGroupMembersRequest(
+                AddGroupMembersRequest(
+                    group_id=group_id,
+                    user_ids=user_ids,
+                    application_ids=application_ids,
+                ),
+                self.client,
+            ),
+        )
+
+        self._throw_on_error(res)
+        return unmarshal_Group(res.json())
+
     def remove_group_member(
         self,
         *,

scaleway/scaleway/iam/v1alpha1/marshalling.py

@@ -40,6 +40,7 @@
     UpdateGroupRequest,
     SetGroupMembersRequest,
     AddGroupMemberRequest,
+    AddGroupMembersRequest,
     RemoveGroupMemberRequest,
     CreatePolicyRequest,
     UpdatePolicyRequest,
@@ -642,6 +643,16 @@ def marshal_AddGroupMemberRequest(
     }
 
 
+def marshal_AddGroupMembersRequest(
+    request: AddGroupMembersRequest,
+    defaults: ProfileDefaults,
+) -> Dict[str, Any]:
+    return {
+        "application_ids": request.application_ids,
+        "user_ids": request.user_ids,
+    }
+
+
 def marshal_CreateAPIKeyRequest(
     request: CreateAPIKeyRequest,
     defaults: ProfileDefaults,

scaleway/scaleway/iam/v1alpha1/types.py

@@ -1199,6 +1199,24 @@ class AddGroupMemberRequest:
     """
 
 
+@dataclass
+class AddGroupMembersRequest:
+    group_id: str
+    """
+    ID of the group.
+    """
+
+    user_ids: Optional[List[str]]
+    """
+    IDs of the users to add.
+    """
+
+    application_ids: Optional[List[str]]
+    """
+    IDs of the applications to add.
+    """
+
+
 @dataclass
 class RemoveGroupMemberRequest:
     group_id: str