Freigeben über


teamsApp löschen

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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

In den folgenden Tabellen sind die Berechtigungen mit den geringsten Berechtigungen aufgeführt, die zum Aufrufen dieser API für jeden unterstützten Ressourcentyp erforderlich sind. Befolgen Sie bewährte Methoden , um Berechtigungen mit den geringsten Berechtigungen anzufordern. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Hinweis

  • Die Directory.ReadWrite.All-Berechtigung wird nur aus Gründen der Abwärtskompatibilität unterstützt. Es wird empfohlen, dass Sie Ihre Lösungen so aktualisieren, dass sie eine alternative Berechtigung verwenden 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.
  • Nur globale Administratoren können diese API aufrufen.

Berechtigungen für die folgende HTTP-Anforderung:

DELETE /appCatalogs/teamsApps/{id}
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

Berechtigungen für die folgende HTTP-Anforderung:

DELETE /appCatalogs/teamsApps/{appId}/appDefinitions/{appDefinitionId}
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

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/beta/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Microsoft Graph – dienstspezifische Drosselungslimiten