如何通过Microsoft Graph API为Entra ID组批量添加多个所有者

嗨，我懂你的需求——不想一次次调用API给组加所有者，而是希望一次性搞定多个。虽然Graph API没有直接的单端点批量添加组所有者的功能，但我们可以用**批量请求（Batch Request）**来实现，这是官方推荐的批量操作方式，能把多个添加请求打包成一个调用完成，效率高不少。

实现思路 #

批量请求的核心是把多个独立的「添加组所有者」请求打包，发送到Graph API的/batch端点。每个子请求都会被单独处理，你还能拿到每个请求的执行结果，方便排查问题。

修改后的异步函数代码 #

这里基于你现有的代码改造，支持传入多个用户ID，一次性批量添加：

from msgraph_core import BatchRequestContent, BatchRequestStep
from msgraph.generated.models.reference_create import ReferenceCreate
import logging

async def add_multiple_team_owners(graph_client, group_name, group_id, user_ids: list[str]):
    """
    Add multiple users as owners of a group in one batch call
    Args:
        graph_client (GraphServiceClient): The Graph client
        group_name (str): Name of the group to update
        group_id (str): The ID of the group to update
        user_ids (list[str]): List of Azure user IDs to add as owners
    Returns:
        dict: Batch response containing results of each sub-request
    """
    # 构造批量请求的步骤列表
    batch_steps = []
    for idx, user_id in enumerate(user_ids):
        # 每个子请求对应一个用户，生成唯一的请求ID
        request_id = f"req_{idx+1}"
        # 构造添加所有者的请求体，和你原来的单请求一致
        request_body = ReferenceCreate(
            odata_id=f"https://graph.microsoft.com/v1.0/users/{user_id}"
        )
        # 创建批量请求步骤：POST到组所有者的ref端点
        step = BatchRequestStep(
            id=request_id,
            method="POST",
            url=f"/groups/{group_id}/owners/$ref",
            body=request_body
        )
        batch_steps.append(step)
    
    # 打包批量请求内容
    batch_content = BatchRequestContent(batch_steps)
    
    try:
        # 发送批量请求
        batch_response = await graph_client.batch.post(batch_content)
        # 解析响应结果
        response_data = await batch_response.json()
        
        # 日志记录每个请求的状态
        for resp in response_data.get("responses", []):
            req_id = resp.get("id")
            status = resp.get("status")
            if status == 204:
                user_id = user_ids[int(req_id.split("_")[1])-1]
                logging.info(f"Successfully added user {user_id} as owner to group {group_name} ({group_id})")
            else:
                logging.error(f"Failed to add user (request {req_id}): {resp.get('error', {}).get('message', 'Unknown error')}")
        
        return response_data
    except Exception as e:
        logging.error(f"Error sending batch request for group {group_name} - {group_id}")
        logging.error(f"Error detail: {e}")
        raise

关键注意事项 #

• 批量请求限制：Graph API的批量请求最多允许包含20个独立子请求，如果你的用户ID列表超过20个，记得要分成多个批量请求来处理（比如每20个用户一批）。
• 权限要求：确保你的Graph客户端拥有Group.ReadWrite.All或者Directory.ReadWrite.All的权限，和单个添加请求的权限要求一致。
• 结果排查：批量响应里会返回每个子请求的状态，204代表添加成功，如果有失败的情况，可以通过响应里的错误信息排查问题（比如用户ID不存在、权限不足等）。

备选方案（不推荐） #

如果暂时不想用批量请求，也可以循环调用你原来的单添加函数，但这种方式会发送多次API请求，效率低，而且容易触发API速率限制，所以更推荐用批量请求的方式。

备注：内容来源于stack exchange，提问作者Gilphe