Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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