teamsApp löschen
Namespace: microsoft.graph
Löschen Sie eine App aus dem App-Katalog eines organization (dem Mandanten-App-Katalog). Um eine App zu löschen, muss die distributionMethod-Eigenschaft für die App auf organization
festgelegt werden.
Sie können diese API auch verwenden, um eine übermittelte App aus dem Überprüfungsprozess zu entfernen.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Berechtigungen
Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
O: Nur Teams-Dienstadministratoren oder eine höher privilegierte Rolle können diese API aufrufen.
Berechtigungstyp | Berechtigungen mit den geringsten Berechtigungen | Berechtigungen mit höheren Berechtigungen |
---|---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | AppCatalog.Submit | AppCatalog.ReadWrite.All, Directory.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt | Nicht unterstützt |
Anwendung | Nicht unterstützt | Nicht unterstützt |
Hinweis
- Die Directory.ReadWrite.All-Berechtigung wird nur aus Gründen der Abwärtskompatibilität unterstützt. Es wird empfohlen, Ihre Lösungen zu aktualisieren, sodass sie eine alternative Berechtigung verwenden, die in der vorherigen Tabelle aufgeführt ist, und diese Berechtigungen in Zukunft nicht mehr verwenden.
- Sie können nur die Berechtigung AppCatalog.Submit verwenden, um App-Definitionen in der Überprüfung zu löschen.
HTTP-Anforderung
So löschen Sie eine App aus dem App-Katalog:
DELETE /appCatalogs/teamsApps/{id}
So löschen Sie eine App, die übermittelt, aber noch nicht genehmigt wurde:
DELETE appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId}
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Anmerkung: Verwenden Sie die ID, die vom Aufruf veröffentlichter Apps auflisten zurückgegeben wird, um auf die App zu verweisen, die Sie löschen möchten. Verwenden Sie nicht die ID aus dem Manifest des ZIP-App-Pakets.
Antwort
Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content
zurückgegeben. Es gibt nichts im Antworttext zurück.
Beispiel
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
DELETE https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8
Antwort
Das folgende Beispiel zeigt die Antwort.
HTTP/1.1 204 No Content