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 organizationfestgelegt 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

Microsoft Graph – dienstspezifische Drosselungslimiten