conversationMember: remove
Espacio de nombres: microsoft.graph
Quite varios miembros de un equipo en una sola solicitud. La respuesta proporciona detalles sobre qué pertenencias se pudieron quitar y no se pudieron quitar.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
---|---|---|
Delegado (cuenta profesional o educativa) | TeamMember.ReadWrite.All | No disponible. |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | TeamMember.ReadWrite.All | No disponible. |
Solicitud HTTP
Esta API es una acción enlazada para quitar varios elementos de una colección conversationMember en una sola solicitud.
POST /teams/{team-id}/members/remove
Encabezados de solicitud
Encabezado | Valor |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Content-Type | application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione la representación JSON de la lista de derivados conversationMember que se van a quitar de un equipo. Se puede quitar un máximo de 20 derivados conversationMember en una sola solicitud.
En la tabla siguiente se muestra el parámetro que se puede usar con este método.
Parámetro | Tipo | Descripción |
---|---|---|
values | Colección conversationMember | Lista de miembros de conversación que se van a quitar. |
Respuesta
Si se ejecuta correctamente, este método devuelve una 204 No Content
respuesta si todos los miembros especificados se quitaron correctamente del equipo o una 207 Multi-Status
respuesta si solo se quitaron algunos miembros. El llamador debe inspeccionar la carga de respuesta para identificar qué eliminaciones de miembros han producido errores. El cuerpo de la respuesta contiene una colección de derivados del recurso actionResultPart . Si se produce un error en la solicitud, la API devuelve un error. Para obtener más información sobre los errores de Microsoft Graph, consulte Respuestas de error de Microsoft Graph y tipos de recursos.
Ejemplos
Ejemplo 1: Eliminación masiva de miembros de un equipo
En el ejemplo siguiente se muestra cómo quitar varios miembros de un equipo en una sola solicitud.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/v1.0/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/remove
Content-Type: application/json
{
"values": [
{
"@odata.type": "microsoft.graph.aadUserConversationMember",
"user@odata.bind": "https://graph.microsoft.com/v1.0/users('18a80140-b0fb-4489-b360-2f6efaf225a0')"
},
{
"@odata.type": "microsoft.graph.aadUserConversationMember",
"user@odata.bind": "https://graph.microsoft.com/v1.0/users('86503198-b81b-43fe-81ee-ad45b8848ac9')"
}
]
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content
Ejemplo 2: Eliminación masiva de miembros de un equipo mediante el nombre principal de usuario
En el ejemplo siguiente se muestra cómo quitar varios miembros de un equipo en una sola solicitud mediante sus nombres principales de usuario.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/v1.0/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/remove
Content-Type: application/json
{
"values": [
{
"@odata.type": "microsoft.graph.aadUserConversationMember",
"user@odata.bind": "https://graph.microsoft.com/v1.0/users('jacob@contoso.com')"
},
{
"@odata.type": "microsoft.graph.aadUserConversationMember",
"user@odata.bind": "https://graph.microsoft.com/v1.0/users('alex@contoso.com')"
}
]
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content
Ejemplo 3: Eliminación masiva de miembros de un equipo con eliminaciones erróneas
En el ejemplo siguiente se muestra cómo quitar varios miembros de un equipo cuando se produce un error en la eliminación de un miembro.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
POST https://graph.microsoft.com/v1.0/teams/e4183b04-c9a2-417c-bde4-70e3ee46a6dc/members/remove
Content-Type: application/json
{
"values": [
{
"@odata.type": "microsoft.graph.aadUserConversationMember",
"user@odata.bind": "https://graph.microsoft.com/v1.0/users('c04f28bf-ab68-40a2-974b-e6af31fa78fb')"
},
{
"@odata.type": "microsoft.graph.aadUserConversationMember",
"user@odata.bind": "https://graph.microsoft.com/v1.0/users('86503198-b81b-43fe-81ee-ad45b8848ac9')"
}
]
}
Respuesta
En el ejemplo siguiente se muestra la respuesta.
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 207 Multi-Status
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.aadUserConversationMemberResult)",
"value": [
{
"@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
"userId": "c04f28bf-ab68-40a2-974b-e6af31fa78fb",
"error": {
"code": "NotFound",
"message": "Could not find resource"
}
},
{
"@odata.type": "#microsoft.graph.aadUserConversationMemberResult",
"userId": "86503198-b81b-43fe-81ee-ad45b8848ac9",
"error": null
}
]
}