Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 einer App aus dem App-Katalog einer 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.
| Weltweiter Service | 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 die bewährten 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 Berechtigung Directory.ReadWrite.All wird nur aus Gründen der Abwärtskompatibilität unterstützt. Es wird empfohlen, Ihre Lösungen so zu aktualisieren, dass Sie eine alternative Berechtigung verwenden, und die Verwendung dieser Berechtigungen in Zukunft zu vermeiden.
- Sie können die Berechtigung AppCatalog.Submit nur verwenden, um App-Definitionen zu löschen, die überprüft werden.
- Nur Teams-Dienstadministratoren oder eine Rolle mit höheren Berechtigungen 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 |
| Application | 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 |
| Application | 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 Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Hinweis: Verwenden Sie die vom Aufruf "Liste veröffentlichter Apps " zurückgegebene ID, 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. Sie 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