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
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.
Disponibilidad de API
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
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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.
O- Solo los administradores del servicio de Teams o un rol con privilegios superiores pueden llamar a esta API.
| 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. |
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 enumerado en la tabla anterior y así 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.
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/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content