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.

Eliminar una aplicación del catálogo de aplicaciones de una organización (el catálogo de aplicaciones del 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 en la nube nacional.

Servicio global Administración pública de EE. UU. Gobierno de EE. UU. L5 (DOD) China operado por 21Vianet
✅ ✅ ✅ ❌

Permissions

En las tablas siguientes se muestran los permisos con privilegios mínimos necesarios para llamar a esta API en cada tipo de recurso admitido. Siga las prácticas recomendadas 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 las definiciones de aplicaciones en revisión.
  • Solo los administradores de 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 envió 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 autenticación y autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Nota: Use el identificador devuelto de la llamada Lista de aplicaciones publicadas para hacer referencia a la aplicación que desea eliminar. No use el identificador del manifiesto del paquete de la 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

Límites específicos del servicio de Microsoft Graph