如何使用Instructure Canvas REST API将用户从Section中移除？

要通过Canvas API将学生从原Section移除，你之前使用的DELETE /api/v1/sections/:section_id/enrollments端点是错误的，这就是请求返回404的核心原因。正确的操作逻辑是先定位学生在目标Section对应的Enrollment ID，再删除单个Enrollment资源。

正确步骤及代码示例 #

1. 获取学生在原Section的Enrollment ID
   先调用GET /api/v1/sections/:section_id/enrollments接口，筛选出目标学生的Enrollment记录，从中提取id字段：

   import requests
   
   # 替换为你的实际配置
   baseUrl = "https://your-canvas-domain.instructure.com"
   section_id = "原Section的ID"
   user_id = "目标学生的ID"
   auth_token = "你的API令牌"
   
   # 发起请求获取目标学生的Enrollment记录
   url = f"{baseUrl}/api/v1/sections/{section_id}/enrollments"
   params = {"user_id": user_id, "type": "StudentEnrollment"}
   headers = {"Authorization": f"Bearer {auth_token}"}
   
   response = requests.get(url, headers=headers, params=params)
   enrollments = response.json()
   
   # 提取Enrollment ID（正常情况下只会返回一条匹配记录）
   if enrollments:
       enrollment_id = enrollments[0]["id"]
   else:
       print("该学生不在目标Section中")
       exit()
   

2. 删除对应Enrollment，完成学生从Section移除
   调用DELETE /api/v1/enrollments/:enrollment_id接口，删除刚才获取的Enrollment：

   # 发起删除请求
   delete_url = f"{baseUrl}/api/v1/enrollments/{enrollment_id}"
   # 可选参数：task=delete 直接删除，也可设置enrollment_state为"deleted"
   delete_params = {"task": "delete"}
   
   delete_response = requests.delete(delete_url, headers=headers, params=delete_params)
   if delete_response.status_code == 200:
       print("学生已成功从原Section移除")
   else:
       print(f"删除失败，状态码：{delete_response.status_code}，响应：{delete_response.text}")
   

补充说明 #

• 你之前实现的添加Section操作是正确的，完成原Section的Enrollment删除后，再执行已有的POST请求，就能实现学生从原Section迁移到新Section的效果。
• 批量处理场景下，只需循环遍历需要移动的学生列表，依次执行上述两步操作即可。

内容的提问来源于stack exchange，提问作者Brian Tompsett - 汤莱恩