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.
Dieser Artikel enthält Informationen zu bekannten Problemen im Zusammenhang mit Microsoft Graph-APIs.
Authentifizierung
Die Herausgebermeldung "nicht überprüft" wird während der Zustimmung der PowerShell- und CLI-App angezeigt
Auf der Zustimmungsseite wird angezeigt, dass die Befehlszeilen-App, die PowerShell und CLI unterstützt, von einem nicht überprüften Herausgeber stammt.
Problemumgehung
Um die Meldung "nicht überprüft" zu entfernen, können Sie eine eigene App-Registrierung durchführen, auf der Sie sich als verifizierter Herausgeber festlegen können. Sie müssen den Herausgeberüberprüfungsprozess durchlaufen und die App-ID im Microsoft Graph PowerShell SDK wie folgt verwenden:
Connect-MgGraph -AppId "{your-own-app-id}" -Scopes "scope"
Eine Vorabgenehmigung für Apps vom Cloudlösungsanbieter funktioniert bei einigen Kundenmandanten nicht
Unter bestimmten Umständen funktioniert die Vorabzustimmung für Cloud Solution Provider(CSP)-Apps für einige Ihrer Kundenmandanten möglicherweise nicht.
Für Apps, die delegierte Berechtigungen verwenden, wird bei der ersten Verwendung der App mit einem neuen Kundenmandanten möglicherweise der folgende Fehler nach der Anmeldung angezeigt: AADSTS50000: There was an error issuing a token.
Für Apps, die Anwendungsberechtigungen verwenden, kann Ihre App ein Token erfassen, beim Aufrufen von Microsoft Graph wird jedoch unerwartet die Meldung angezeigt, dass der Zugriff verweigert wurde.
Wir arbeiten daran, dieses Problem zu beheben, damit die Vorabzustimmung für alle CSP-Kundenmandanten funktioniert.
Problemumgehung
Um die Blockierung von Entwicklung und Tests aufzuheben, können Sie die folgende Problemumgehung verwenden.
Hinweis
Dies ist keine dauerhafte Lösung und dient nur dazu, die Blockierung der Entwicklung aufzuheben. Diese Problemumgehung wird nicht mehr erforderlich sein, sobald das Problem behoben ist. Diese Problemumgehung muss nicht rückgängig gemacht werden, nachdem der Fix vorhanden ist.
Öffnen Sie eine Azure AD v2 PowerShell-Sitzung, und stellen Sie eine Verbindung mit Ihrem Kundenmandanten her, indem Sie Ihre Administratoranmeldeinformationen in das Anmeldefenster eingeben. Sie können Azure AD PowerShell V2 von hier herunterladen und installieren.
Connect-AzureAd -TenantId {customerTenantIdOrDomainName}Erstellen Sie den Microsoft Graph-Dienstprinzipal.
New-AzureADServicePrincipal -AppId 00000003-0000-0000-c000-000000000000
Der Azure AD v2.0-Endpunkt wird für CSP-Apps nicht unterstützt
Cloud Solution Provider-Apps (CSP) müssen Token von den Azure AD (v1)-Endpunkten abrufen, um Microsoft Graph erfolgreich in ihren partnerverwalteten Kunden aufrufen zu können. Derzeit wird das Beziehen eines Tokens über den neueren Azure AD v2.0-Endpunkt nicht unterstützt.
Kalender
Fehler beim Anfügen von großen Dateien an Ereignisse
Eine App mit delegierten Berechtigungen gibt HTTP 403 Forbidden zurück, wenn Sie versuchen, große Dateien an eine Outlook-Nachricht oder ein Ereignis anzufügen, die bzw. das sich in einem freigegebenen oder delegierten Postfach befindet. Bei delegierten Berechtigungen ist createUploadSession nur dann erfolgreich, wenn sich die Nachricht oder das Ereignis im Postfach des signierten Benutzers befindet.
Benachrichtigungen ändern
Upgradeereignisse für die Installation einer Teams-App Änderungsbenachrichtigungen im Chatbereich werden nicht übermittelt
Wenn eine Änderungsbenachrichtigung für eine Teams-App-Installation erstellt wird, werden Upgradeereignisse/Benachrichtigungen nicht an den Abonnenten übermittelt, wenn der Bereich für Chats spezifisch ist oder diese umfasst.
Beispiel: Wenn ein Kunde abonniert /appCatalogs/teamsApps/{teams-app-id}/installations?$filter=(scopeInfo/scope eq 'groupChat')hat, erhält er keine Benachrichtigungen zu Upgrade-/Update-Ereignissen. Sie erhalten jedoch weitere Benachrichtigungen zu Installationen und Löschungen.
Ein weiteres Beispiel: Wenn ein Kunde den abonniert /appCatalogs/teamsApps/{teams-app-id}/installationshat, erhält er keine Benachrichtigungen über Upgrade-/Update-Ereignisse, die speziell in Chats auftreten. Sie erhalten jedoch alle anderen Formen von Benachrichtigungen in Teams und im persönlichen Bereich des Benutzers. In Chats erhalten sie jedoch nur Installations- und Löschbenachrichtigungen.
Problemumgehung
Derzeit ist keine Problemumgehung für dieses Problem verfügbar.
Kundenbuchung
Fehler beim Abfragen von bookingBusinesses
Das Abrufen der Liste der bookingBusinesses schlägt mit dem folgenden Fehlercode fehl, wenn eine organization über mehrere Bookings-Unternehmen verfügt und das Konto, das die Anforderung stellt, kein Administrator ist:
{
"error": {
"code": "ErrorExceededFindCountLimit",
"message": "The GetBookingMailboxes request returned too many results. Please specify a query to limit the results."
}
}
Problemumgehung
Sie können die Gruppe von Unternehmen, die von der Anforderung zurückgegeben werden, einschränken, indem Sie z. B. einen Abfrageparameter einfügen:
GET https://graph.microsoft.com/beta/bookingBusinesses?query=Fabrikam
Delta-Abfrage
OData-Kontext wird falsch zurückgegeben
OData-Kontext wird beim Nachverfolgen von Änderungen an Beziehungen manchmal falsch zurückgegeben.
Verwaltung von Geräten und Apps
Zugreifen auf und Aktualisieren von Bereitstellungszielgruppen wird nicht unterstützt
Das Zugreifen auf und Aktualisieren von Bereitstellungszielgruppen auf Bereitstellungs-Ressourcen, die über Intune erstellt wurden, wird derzeit nicht unterstützt.
- Das Auflisten von Bereitstellungszielgruppenmitgliedern und Auflisten von Ausschlüssen von Bereitstellungszielgruppen gibt
404 Not Foundzurück. - Das Aktualisieren von Mitgliedern und Ausschlüssen der Bereitstellungszielgruppe oder die Aktualisierung nach ID gibt
202 Acceptedzurück, aber die Zielgruppe wird nicht aktualisiert.
Gruppen
Ein Nichtadministratorbenutzer kann sich während der Gruppenerstellung oder -aktualisierung nicht selbst als Gruppenbesitzer hinzufügen
Wenn ein Nichtadministratorbenutzer die API zum Erstellen einer Gruppe , zur Aktualisierung der Gruppen-API oder zur Upsert-Gruppe aufruft und seine Benutzer-ID im Anforderungstext in der owners@odata.bind Sammlung hinzufügt, schlägt die Anforderung mit einem 400 Bad Request Fehlercode mit der Meldung "Anforderung enthält eine Eigenschaft mit doppelten Werten" fehl. Ein Nichtadministratorbenutzer kann sich nicht explizit als Gruppenbesitzer hinzufügen.
Problemumgehung
Für diesen Fehler gibt es keine Problemumgehung.
Standardmäßig wird ein Nichtadministratorbenutzer, der eine Sicherheits- oder Microsoft 365-Gruppe über die API zum Erstellen einer Gruppe oder zur Upsert-Gruppe erstellt, automatisch zur Besitzersammlung der Gruppe hinzugefügt, wenn er keine Gruppenbesitzer angibt. Wenn sie andere Personen als Gruppenbesitzer angeben, wird der Nichtadministrator-Gruppenersteller trotzdem automatisch zur Besitzersammlung der Sicherheitsgruppe hinzugefügt, jedoch nicht für die Microsoft 365-Gruppe. Der Benutzer kann sich während des Gruppenupdates immer noch nicht selbst zur Besitzersammlung hinzufügen.
GET /groups/{id}/members gibt in Version 1.0 keine Dienstprinzipale zurück
Der API-Vorgang "Gruppenmitglieder auflisten " auf dem v1.0-Endpunkt gibt derzeit keine Dienstprinzipale zurück, die möglicherweise Mitglieder der abgefragten Gruppe sind.
Problemumgehung
Benutzen Sie als Problemumgehung eine der folgenden Optionen:
- Verwenden Sie den API-Vorgang "Gruppenmitglieder auflisten" auf dem Betaendpunkt.
- Verwenden Sie den
/groups/{id}?$expand=membersAPI-Vorgang.
Identität und Zugriff
Die Verwendung bestimmter Abfrageparameter für /subscribedSkus und /domains gibt nicht die erwarteten Ergebnisse zurück
Die folgende Verwendung von Abfrageparametern, die auf subscribedSKUs und Domänenentitäten abzielen, gibt möglicherweise nicht die erwarteten Ergebnisse zurück:
- Verwendung von
$searchsowohl für subscribedSKUs als auch für Domänenentitäten - Verwendung von
$topund$filterauf der Domänenentität
Derzeit werden diese Parameter effektiv ignoriert, und die Abfragen geben nicht die erwarteten Ergebnisse zurück.
Problemumgehung
Um Unterbrechungen Ihrer Geschäftsprozesse zu vermeiden, empfehlen wir, dass Sie Ihren Anwendungscode ändern, um die Verwendung dieser Abfrageparameter aus Abfragen zu entfernen, die auf die subscribedSKUs oder Domänenentitäten abzielen, und die Suche, die Oberseite und den Filter auf der Clientseite auszuführen.
Für das Konfigurieren von Verbunddomänen in delegierten Szenarien ist die Berechtigung Directory.AccessAsUser.All erforderlich.
Für die Funktionen "InternalDomainVerbund erstellen", "internalDomainVerbund aktualisieren" und "internalDomainFederation löschen " müssen Sie möglicherweise der Berechtigung Directory.AccessAsUser.All zustimmen. Diese Anforderung ist eine vorübergehende Problemumgehung, bis wir eine präzisere delegierte Berechtigung für die Verwaltung von Verbunddomänen bereitstellen.
Anspruchszuordnungsrichtlinie erfordert möglicherweise die Zustimmung zu zusätzlichen Berechtigungen
Die claimsMappingPolicy-API erfordert möglicherweise die Zustimmung sowohl der Policy.Read.All- als auch der Policy.ReadWrite.ConditionalAccess-Berechtigung für die LIST /policies/claimsMappingPolicies- und GET /policies/claimsMappingPolicies/{id}-Methoden wie folgt:
- Wenn keine ClaimsMappingPolicy-Objekte zum Abrufen in einem LIST-Vorgang verfügbar sind, reicht eine der beiden Berechtigungen aus, um diese Methode aufzurufen.
- Wenn claimsMappingPolicy-Objekte abgerufen werden müssen, muss Ihre App beiden Berechtigungen zustimmen. Wenn nicht, wird ein
403 ForbiddenFehler zurückgegeben.
In Zukunft wird jede Berechtigung ausreichen, um beide Methoden aufzurufen.
Richtlinie für bedingten Zugriff erfordert Zustimmung zu zusätzlicher Berechtigung
Die conditionalAccessPolicy API erfordert derzeit die Zustimmung zur Policy.Read.All Berechtigung zum Aufrufen der POST- und PATCH-Methoden. In Zukunft können Sie mit der Berechtigung Policy.ReadWrite.ConditionalAccess Richtlinien aus dem Verzeichnis lesen.
Die Bereitstellung von vorregistrierten Passkeys wird nicht unterstützt
Die FIDO2-Bereitstellungs-API unterstützt das Hinzufügen von Passkeys, die bei der Erstellung aktiv sind. Die Bereitstellung, bei der Passkeys während der Geräteherstellung oder -verteilung mit Microsoft Entra ID vorregistriert und deaktiviert bleiben, bis ein Administrator sie aktiviert, wird in der aktuellen Version v1.0 nicht unterstützt.
Für die FIDO2-Bereitstellungs-API muss die Self-Service-Einrichtung aktiviert sein
Um die FIDO2-Bereitstellungs-API (fido2AuthenticationMethod erstellen) zu verwenden, müssen Administratoren Self-Service-Setup zulassen in der FIDO2-Authentifizierungsmethodenrichtlinie aktivieren. In Version 1.0 ermöglicht diese Einstellung auch die FIDO2-Registrierung von Endbenutzern über "Meine Anmeldungen". Das Aktivieren der API-basierten Bereitstellung unabhängig von der Self-Service-Registrierung wird derzeit nicht unterstützt.
Microsoft Entra External ID: Externe Benutzer haben keinen Zugriff auf "Meine Anmeldungen", daher wirkt sich die Aktivierung dieser Einstellung nicht auf die Self-Service-Registrierung für externe Benutzer aus. Administratoren müssen die Einstellung zur Verwendung der Bereitstellungs-API weiterhin aktivieren.
JSON-Batchverarbeitung
Anforderungsabhängigkeiten sind begrenzt
Individuelle Wünsche können von anderen individuellen Anforderungen abhängen. Derzeit können Anforderungen nur von einer einzigen anderen Anforderung abhängen und müssen einem dieser drei Muster entsprechen:
- Parallel : Keine einzelne Anforderung gibt eine Abhängigkeit in der dependsOn-Eigenschaft an.
- Seriell - alle individuellen Anfragen hängen von der vorherigen individuellen Anfrage ab.
- Gleich: Alle einzelnen Anforderungen, die eine Abhängigkeit in der dependsOn-Eigenschaft angeben, geben dieselbe Abhängigkeit an. Note: Anforderungen, die mit diesem Muster vorgenommen werden, werden sequenziell ausgeführt.
In der weiteren Entwicklung der JSON-Batchverarbeitung werden diese Einschränkungen entfernt.
Deltaaufrufe an die Nachrichten-API mit unveränderlichen IDs
Wenn Sie /delta die Nachrichten-API mit unveränderlichen IDs aufrufen (z. B. wenn eine Nachricht aus einem Ordner verschoben und dann wieder hineinverschoben wird), verpassen Sie möglicherweise einige Änderungsbenachrichtigungen.
Der Kommentarparameter zum Erstellen eines Entwurfs ist nicht Teil des Nachrichtentexts
Der Kommentarparameter zum Erstellen eines Antwort- oder Weiterleitungsentwurfs (createReply, createReplyAll, createForward) ist nicht Teil des Textkörpers des Antwortnachrichtenentwurfs.
Abfrageparameter
$search für Verzeichnisobjekte schlägt bei codiertem kaufmännischem Und-Zeichen (&) fehl
Gemäß RFC 3986 und wie unter Codieren von Abfrageparametern beschrieben, müssen reservierte Zeichen in Abfragezeichenfolgen prozentual codiert sein. Beispielsweise lautet die Syntax für $search einen Gruppennamen wie "Wandern&Erholung" wie folgt:
GET https://graph.microsoft.com/v1.0/groups?$search="displayName:Hiking%26Recreation group"
Microsoft Graph gibt derzeit einen 400 Bad Request Fehlercode auf dem v1.0-Endpunkt für Suchvorgänge zurück, die codierte kaufmännische Und-Zeichen (&) enthalten, mit der folgenden Fehlermeldung: Unrecognized query argument specified: ''.. Die gleiche Anforderung ist auf dem Beta-Endpunkt erfolgreich.
Einige Apps haben als Problemumgehung eine Doppelprozent-Codierung auf dem v1.0-Endpunkt implementiert. Beispielsweise wird die zweiprozentig codierte Anforderung zu /users?$search="displayName:Hiking%2526Recreation group". Dies ist jedoch nicht die offiziell empfohlene Problemumgehung.
Problemumgehung
Problemumgehung 1:
Wenn Sie auf dem v1.0-Endpunkt die richtige prozentuale Kodierung verwenden, schließen Sie den Anforderungsheader ein, der Prefer auf festgelegt ist legacySearch=false. Zum Beispiel:
GET https://graph.microsoft.com/v1.0/groups?$search="displayName:Hiking%26Recreation group"
ConsistencyLevel: eventual
Prefer: legacySearch=false
In Zukunft wird das Verhalten auf dem v1.0-Endpunkt korrigiert, und Sie müssen diesen Header nicht mehr einschließen.
Problemumgehung 2:
Wenn das Verhalten auf dem v1.0-Endpunkt korrigiert wird, können bei Apps, die von der Doppelprozent-Codierung abhängig sind, schwerwiegende Änderungen auftreten, es sei denn, sie haben sich für die Beibehaltung ihrer Implementierung entschieden, indem sie den Prefer Anforderungsheader auf legacySearch=trueeinschließen. Zum Beispiel:
GET https://graph.microsoft.com/v1.0/groups?$search="displayName:Hiking%2526Recreation group"
ConsistencyLevel: eventual
Prefer: legacySearch=true
Einige Beschränkungen gelten für Abfrageparameter
Die folgenden Beschränkungen gelten für Abfrageparameter:
- Mehrere Namespaces werden nicht unterstützt.
- GET-Anforderungen
$refund -Umwandlung werden für Benutzer, Gruppen, Geräte, Dienstprinzipale und Anwendungen nicht unterstützt. -
@odata.bindwird nicht unterstützt. Dies bedeutet, dass Sie die Navigationseigenschaft acceptedSenders oder rejectedSenders für eine Gruppe nicht ordnungsgemäß festlegen können. -
@odata.idist bei Nicht-Containment-Navigationen (wie Nachrichten) nicht vorhanden, wenn minimale Metadaten verwendet werden. -
$expandÜber Beziehungen von Verzeichnisobjekten:- Gibt maximal 20 Objekte zurück, mit Ausnahme von
/users?$expand=registeredDevices, das bis zu 100 Objekte zurückgibt. - Keine Unterstützung für
@odata.nextLink. - Keine Unterstützung für mehr als eine Erweiterungsebene.
- Es gibt keine Unterstützung für das Verschachteln anderer Abfrageparameter, z. B
$filter. und$selectinnerhalb einer$expandAbfrage.
- Gibt maximal 20 Objekte zurück, mit Ausnahme von
-
$filter:-
/attachmentsEndpunkt unterstützt keine Filter. Falls vorhanden, wird der$filter-Parameter ignoriert. - Die arbeitsauslastungsübergreifende Filterung wird nicht unterstützt.
- Bei Verwendung des
inOperators ist die Anforderung standardmäßig auf 15 Ausdrücke in der Filterklausel beschränkt ODER auf eine URL-Länge von 2.048 Zeichen bei Verwendung erweiterter Abfragefunktionen. - Beim Filtern mit dem
eqOperator beträgt die maximale Grenze des abzugleichenden Werts 120 Zeichen. Das heißt,$filter=displayName eq 'value-to-match-max-120-char'. Diese Beschränkung gilt sogar für Eigenschaften wie displayName für Verzeichnisobjekte, die bis zu 256 Zeichen lang sein können. Bei der Verwendung erweiterter Abfragen wird das Limit auf die URL-Länge auf 2.048 Zeichen anstelle des übereinstimmenden Werts angewendet.
-
-
$search:- Volltextsuche ist nur für einige Entitäten wie Nachrichten verfügbar.
- Die workloadübergreifende Suche wird nicht unterstützt.
- Die Suche wird in Azure AD B2C-Mandanten nicht unterstützt.
-
$count:- Wird in Azure AD B2C-Mandanten nicht unterstützt.
- Wenn die
$count=trueAbfragezeichenfolge beim Abfragen von Verzeichnisressourcen verwendet wird, ist die@odata.countEigenschaft nur auf der ersten Seite der ausgelagerten Daten vorhanden.
- Abfrageparameter, die in einer Anforderung angegeben sind, können im Hintergrund einen Fehler verursachen. Dies kann für nicht unterstützte Abfrageparameter und für nicht unterstützte Kombinationen von Abfrageparametern gelten.
Suchen
Das Erstellen einer externalConnection mit einer defekten adaptiven Karte gibt die Antwort "503 Service Unavailable" (Dienst nicht verfügbar), gefolgt von einem 409-Konfliktfehler zurück
Wenn Sie Microsoft Graph-APIs verwenden, um eine externe Verbindung mit einer fehlerhaften adaptiven Karte für das Ergebnislayout herzustellen, schlägt der erste Aufruf mit einem 503 Service Unavailable Fehler fehl. Dann schlägt der zweite Aufruf mit 409 Conflict einem Fehler fehl, der darauf hinweist, dass bereits eine Verbindung mit demselben Namen besteht.
Obwohl die erste Anforderung mit einer 503-Antwort fehlschlug, wurde die Verbindung dennoch hergestellt. Die adaptive Kartenvorlage wurde jedoch nicht registriert, da sie beschädigt ist.
Websites und Listen
Websites mit Folgen/Nicht folgen werden folgendermaßen nicht mit SharePoint synchronisiert
Beim Abfragen von verfolgten Websites über Microsoft Graph hat die Antwort möglicherweise falsche Ergebnisse, und diese Ergebnisse stimmen möglicherweise nicht mit den Ergebnissen aus dem folgenden Inhalt in SharePoint überein.
Problemumgehung
Verwenden Sie die folgende Personen und Inhalts-REST-API .
Teamarbeit und Kommunikation
Auflisten von callRecords participant_v2 gibt möglicherweise nicht alle Teilnehmer zurück
In einigen Grenzfällen kann eine Anforderung, participants_v2 für einen callRecord aufzulisten, eine unvollständige Liste zurückgeben.
Problemumgehung
Sie können die vorhandene Teilnehmereigenschaft eines callRecord für eine vollständige Teilnehmerliste verwenden.
SDK für Kommunikationen: Inkonsistente aufgezeichnete Teilnehmernummer wird auf dem Teams-Client angezeigt, wenn Bot-Gruppierung aktiviert ist
Wenn Bot-Anwendungen die Bot-Gruppierung aktivieren, ist die Anzahl der Teilnehmer, die vom Teams-Client als aufgezeichnet angezeigt werden, nicht korrekt. Da die Teilnehmer gruppiert sind, ist die angezeigte Anzahl der Teilnehmer, die erfasst werden, niedriger als die tatsächliche Anzahl.
Problemumgehung
Deaktivieren Sie die Bot-Gruppierung, um eine genaue Anzahl anzuzeigen.
Die callRecords-API stellt Anwendungsteilnehmer als Benutzer in communicationsIdentitySet dar.
In der callRecord-Teilnehmerressource werden Anwendungs-/Botteilnehmer derzeit durch communicationsUserIdentity anstelle von communicationsApplicationIdentity dargestellt.
Problemumgehung
Verwenden Sie den Benutzer-Agent-headerValue für die Ressource participantEndpoint in einer callRecord-Sitzung, um Anwendungsteilnehmer zu identifizieren und zusätzliche Details zur Anwendungsidentität anzuzeigen.
Communication Calling SDK: Unterstützung für Multi-Endpunkt-Anwendungsfall im Delta-Listen-Benachrichtigungsmodus fehlt
Wenn dieselbe Anwendung oder ein Benutzer mit mehreren Endpunkten an derselben Besprechung teilnimmt und der Benachrichtigungsmodus für die Liste "Deltaliste" ist, erfassen die vom Kommunikations-SDK bereitgestellten Aktualisierungen der Teilnehmerliste möglicherweise nicht die zusätzlichen Endpunkte, die dem laufenden Anruf hinzugefügt wurden.
Problemumgehung
Der Legacymodus für die Liste unterstützt den Anwendungsfall mit mehreren Endpunkten. Verwenden Sie die SDK-Version 1.2.0.7270 oder früher.
Communication Calling SDK: Ausnahme bei der Verarbeitung von Webhooknachrichten: System.Security.Cryptography.CryptographicException
Die Veröffentlichung der KBs führte zu einem Problem mit Anwendungen, die mit den Communication Calling SDKs entwickelt wurden.
Die Microsoft Graph-Methode löst eine Ausnahme aus, wenn der Bot AnswerAsync versucht, eingehende Anrufe anzunehmen. Dies steht im Zusammenhang mit den folgenden Windows-Updates:
- KW22 - KB5038282
- KW19 - KB5038283
Weitere Informationen finden Sie unter SHA256 ComputeHash hat angefangen zu werfen – Microsoft Community.
Problemumgehung
Führen Sie ein Rollback für die KBs durch, bis eine aktualisierte Version des SDK vorliegt.
Anforderungen für die Änderungsnachverfolgung für APIs, die Artefakte von Onlinebesprechungen exportieren, geben bereits synchronisierte Elemente zurück
Anforderungen der Änderungsnachverfolgung (/delta) an getAllTranscripts oder getAllRecordings geben möglicherweise Elemente zurück, die bereits in früheren Anforderungen synchronisiert wurden.
Dies geschieht, wenn die Besprechung andere, nicht damit verbundene Aktualisierungen enthielt, z. B. das Hinzufügen von Teilnehmern, Notizen oder Dateien.
Problemumgehung
Überprüfen Sie für jedes Element in der Antwort die createdDateTime der Aufzeichnung oder des Transkripts, und vergleichen Sie sie mit dem vorherigen Synchronisierungszeitstempel. Wenn createdDateTime vor dem Zeitstempel der letzten Synchronisierung liegt, ist das Element bereits synchronisiert und kann ignoriert werden.
APIs, die Artefakte von Onlinebesprechungen exportieren, geben keine Aufzeichnungen für Besprechungen ohne aktivierte Transkriptionen zurück
Die getAllRecordings-API gibt keine Aufzeichnungen für Besprechungen zurück, für die die Transkription nicht aktiviert ist.
APIs, die Artefakte von Onlinebesprechungen exportieren, geben möglicherweise nicht nextLink zurück, wenn die Anforderung den Abfrageparameter $top verwendet
Wenn Sie die getAllRecordings - oder getAllTranscripts-APIs aufrufen, gibt das Übergeben des $top Filters möglicherweise nicht den zurück, auch @odata.nextLinkwenn weitere Elemente exportiert werden müssen.
Problemumgehung
Übergeben $top Sie den Abfrageparameter erst, wenn das Problem behoben ist.
APIs, die Artefakte von Onlinebesprechungen exportieren, können während des Dienstupdates Duplikate zurückgeben
Während eines geplanten Dienstupdates, das voraussichtlich bis zum 31. August 2026 abgeschlossen sein wird, kann es bei paginierten Anforderungen an die APIs getAllRecordings oder getAllTranscripts zu einer automatischen Zurücksetzung des Paginierungstokens kommen. Eine Anforderung kann eine 200 OK Antwort mit einer leeren Auflistung und einer @odata.nextLink. Die Paginierung wird dann neu gestartet und kann Aufzeichnungs- oder Transkriptelemente zurückgeben, die zuvor zurückgegeben wurden.
Problemumgehung
Folgen Sie @odata.nextLink auch dann weiter, wenn die Sammlung leer ist. Deduplizieren Sie nachfolgende Elemente, indem Sie die id-Eigenschaft jeder Aufzeichnung oder jedes Transkripts nachverfolgen.
Wenn Sie Delta-Abfragen mit diesen Methoden verwenden, folgen Sie dem zurückgegebenen Delta-Link, ohne Filter anzufügen oder erneut anzuwenden. Das Token behält den Filter aus der ursprünglichen Anforderung bei. Die Bereitstellung eines Filters mit dem Token gibt eine 400 Bad Request Antwort als DeltaFilterNotAllowed Wert zurück innerError.code .
Auflisten der Teammitglieder-API schlägt mit 401-Fehlern in neu erstellten Mandanten fehl
Wenn ein neu erstellter Mandant eine Listenmitgliederanforderung mithilfe erweiterter Azure AD-Abfragefunktionen sendet, tritt ein HTTP 401-Fehler auf.
Problemumgehung
- Rufen Sie die Listenteams-API auf, und warten Sie einige Sekunden.
- Rufen Sie an
/teams/{id}/members, und prüfen Sie, ob eine Antwort erfolgreich war.
Die Methode "Team klonen" umfasst nicht alle Besitzer des Quellteams im geklonten Team
Wenn Sie die Methode zum Klonen von Teams aufrufen und das Quellteam mehr als einen Besitzer enthält, wird nur ein Besitzer im geklonten Team beibehalten. Die anderen Besitzer werden Mitglieder des neuen geklonten Teams. Es ist nicht möglich auszuwählen oder zu konfigurieren, welcher Besitzer als Besitzer des neuen Teams beibehalten wird.
Problemumgehung
Verwenden Sie nach dem Klonen des Teams die Methode "Mitglieder hinzufügen ", um die ursprünglichen Besitzer von Mitgliedern zurück zu Besitzern zu aktualisieren.
Kanal erstellen kann eine Fehlerantwort zurückgeben
Wenn Sie beim Erstellen eines Kanals Sonderzeichen in Ihrem Kanalnamen verwenden, gibt die Get filesFolder-API eine 400 Bad Request Fehlerantwort zurück. Stellen Sie beim Erstellen eines Kanals sicher, dass der displayName für den Kanal Folgendes nicht aufweist:
- Enthalten Sie eines der folgenden Sonderzeichen:
~ # % & * { } + / \ : < > ? | ' ". - Beginnen Sie mit einem Unterstrich (
_) oder Punkt (.), oder enden Sie mit einem Punkt (.).
Auf einen mandantenübergreifenden freigegebenen Kanal kann nicht zugegriffen werden, wenn die Anforderungs-URL „tenants/{cross-tenant-id}“ enthält.
Die API ruft die Eigenschaft auf teams/{team-id}/incomingChannels und teams/{team-id}/allChannels gibt sie @odata.id zurück, mit der Sie auf den Kanal zugreifen und andere Operationen für das Kanalobjekt ausführen können. Wenn Sie die von der @odata.id Eigenschaft zurückgegebene URL aufrufen, schlägt die Anforderung beim Versuch, auf den mandantenübergreifenden freigegebenen Kanal zuzugreifen, mit dem folgenden Fehler fehl:
GET /tenants/{tenant-id}/teams/{team-id}/channels/{channel-id}
{
"error": {
"code": "BadRequest",
"message": "TenantId in the optional tenants/{tenantId} segment should match the tenantId(tid) in the token used to call Graph.",
"innerError": {
"date": "2022-03-08T07:33:50",
"request-id": "dff19596-b5b2-421d-97d3-8d4b023263f3",
"client-request-id": "32ee2cbd-27f8-2441-e3be-477dbe0cedfa"
}
}
}
Problemumgehung
Entfernen Sie den /tenants/{tenant-id} Teil aus der URL, bevor Sie die API aufrufen, um auf den mandantenübergreifenden freigegebenen Kanal zuzugreifen.
Anforderungen zum Filtern von Teammitgliedern nach Rolle erfordern einen Parameter
Alle Anforderungen zum Filtern von Teammitgliedern nach Rollen erwarten entweder einen skipToken-Parameter oder einen obersten Parameter in der Anforderung, aber nicht beides. Wenn beide Parameter in der Anforderung übergeben werden, wird der top-Parameter ignoriert.
Teammitglieder können nicht nach Rollen gefiltert werden
Rollenabfragefilter und andere Filter GET /teams/team-id/members?$filter=roles/any(r:r eq 'owner') and displayName eq 'dummy' funktionieren möglicherweise nicht. Der Server reagiert möglicherweise mit einem BAD REQUEST.
Das Menü "Besprechungsdetails anzeigen" ist auf Microsoft Teams Client nicht verfügbar
Der Microsoft Teams-Client zeigt das Menü "Besprechungsdetails anzeigen" für Kanalbesprechungen, die über die Cloud Kommunikations-API erstellt wurden, nicht an.
Vertraulichkeitsbezeichnung wird auf der Teams-Benutzeroberfläche nicht angezeigt
Vertraulichkeitsbezeichnungen, die manchmal auf Teams angewendet werden, werden nicht auf der Teams-Benutzeroberfläche angezeigt, obwohl sie sowohl auf der zugrunde liegenden SharePoint-Website als auch im Admin Center deutlich sichtbar sind.
Einige Eigenschaften für Chatmitglieder können möglicherweise in der Antwort auf eine GET-Anforderung fehlen
In bestimmten Fällen wird diedisplayName-Eigenschaft dertenantId-E-Mail// für die einzelnen Mitglieder eines Chats möglicherweise nicht mit einer GET /chats/chat-id/members oder-Anforderung GET /chats/chat-id/members/membership-id ausgefüllt.
Chat-Limit für erweiterte Mitglieder aktualisieren
Diese API funktioniert in einer oder mehreren nationalen Clouds anders. Weitere Informationen finden Sie unter Implementierungsunterschiede in nationalen Clouds. Wenn $expand=members enthalten ist, gibt diese API maximal 25 Elemente zurück, auch wenn ein größerer $top Wert angegeben ist.
layoutType-Eigenschaft gibt beim Auflisten aller Kanäle zurück null
Die layoutType-Eigenschaft wird beim Auflisten aller Kanäle zurückgegeben null . Um den Layouttyp eines bestimmten Kanals abzurufen, verwenden Sie die API zum Abrufen des Kanals .
Benutzer
APIs, die Artefakte von Onlinebesprechungen exportieren, geben möglicherweise Transkript-URLs zurück, die keinen Inhalt enthalten
Die getAllTranscripts-API gibt möglicherweise Transkriptinhalts-URLs für einige Besprechungen zurück, die keine transkribierten Wörter enthalten. Aufrufe der Inhalts-URL für diese Besprechungen geben einen Fehler zurück.
Problemumgehung
Überprüfen Sie, ob die Besprechung transkribiert wurde und ob gültige Inhalte vorhanden sind. Wenn ja, melden Sie dies zur weiteren Untersuchung. Andernfalls ignorieren Sie die Inhalts-URL.
Die Eigenschaft showInAddressList ist nicht mit Microsoft Exchange synchron.
Beim Abfragen von Benutzern über Microsoft Graph gibt die Eigenschaft showInAddressList möglicherweise nicht denselben Status an, der in Microsoft Exchange angezeigt wird. Wir empfehlen, dass Sie diese Funktionalität direkt mit Microsoft Exchange über das Microsoft 365 Admin Center verwalten und diese Eigenschaft nicht in Microsoft Graph verwenden.
Der Zugriff auf das Profilfoto eines Benutzers ist eingeschränkt
Benutzerprofilfotos können nur gelesen und aktualisiert werden, wenn der Benutzer über ein Postfach verfügt. Beim Auftreten eines Fehlers beim Lesen oder Aktualisieren eines Fotos wird die folgende Meldung angezeigt:
{
"error": {
"code": "ErrorNonExistentMailbox",
"message": "The SMTP address has no mailbox associated with it."
}
}
Alle Fotos, die zuvor mit der thumbnailPhoto-Eigenschaft (mithilfe der Azure AD Graph-API (derzeit im Ruhezustand) oder über die AD Connect-Synchronisierung) gespeichert wurden, sind nicht mehr über die Microsoft Graph photo-Eigenschaft der Benutzerressource zugänglich.
Das Verwalten von Benutzerfotos über die profilePhoto-Ressource der Microsoft Graph-API wird in Azure AD B2C-Mandanten derzeit nicht unterstützt.