Eliminar teamsApp
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Elimine una aplicación del catálogo de aplicaciones de una organización (el catálogo de aplicaciones de inquilino). Para eliminar una aplicación, la propiedad distributionMethod de la aplicación debe establecerse en organization.
También puede usar esta API para quitar una aplicación enviada del proceso de revisión.
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
En las tablas siguientes se muestran los permisos o permisos con privilegios mínimos necesarios para llamar a esta API en cada tipo de recurso admitido. Siga los procedimientos recomendados para solicitar permisos con privilegios mínimos. 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.
Nota:
- El permiso Directory.ReadWrite.All solo se admite para la compatibilidad con versiones anteriores. Se recomienda actualizar las soluciones para usar un permiso alternativo y evitar el uso de estos permisos en el futuro.
- Solo puede usar el permiso AppCatalog.Submit para eliminar definiciones de aplicación en revisión.
- Solo los administradores del servicio de Teams o un rol con privilegios superiores pueden llamar a esta API.
Permisos para la siguiente solicitud HTTP:
DELETE /appCatalogs/teamsApps/{id}
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | AppCatalog.Submit | AppCatalog.ReadWrite.All, Directory.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | No admitida. | No admitida. |
Permisos para la siguiente solicitud HTTP:
DELETE /appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId}
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | AppCatalog.Submit | AppCatalog.ReadWrite.All, Directory.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | No admitida. | No admitida. |
Solicitud HTTP
Para eliminar una aplicación del catálogo de aplicaciones:
DELETE /appCatalogs/teamsApps/{id}
Para eliminar una aplicación que se envía pero que aún no se ha aprobado:
DELETE appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId}
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Nota: Use el identificador devuelto desde la llamada a List published apps (Lista de aplicaciones publicadas ) para hacer referencia a la aplicación que desea eliminar. No use el identificador del manifiesto del paquete de aplicación zip.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.
Ejemplo
Solicitud
En el ejemplo siguiente se muestra la solicitud.
DELETE https://graph.microsoft.com/beta/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content