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.
Eine Auflistung von zu konvertierenden Bezeichnern. Alle Bezeichner in der Sammlung MÜSSEN denselben Quell-ID-Typ aufweisen und MÜSSEN für Elemente im selben Postfach sein. Die maximale Größe dieser Auflistung beträgt 1.000 Zeichenfolgen.
sourceIdType
exchangeIdFormat
Der ID-Typ der Bezeichner im InputIds Parameter.
targetIdType
exchangeIdFormat
Der angeforderte ID-Typ, in den konvertiert werden soll.
exchangeIdFormat-Werte
Member
Beschreibung
entryId
Das binäre Eingabe-ID-Format, das von MAPI-Clients verwendet wird.
ewsId
Das von Exchange-Webdienstclients verwendete ID-Format.
immutableEntryId
Das binäre MAPI-kompatible unveränderliche ID-Format.
restId
Das von Microsoft Graph verwendete Standard-ID-Format.
restImmutableEntryId
Das von Microsoft Graph verwendete unveränderliche ID-Format.
Die Binärformate (entryId und immutableEntryId) sind URL-sicher base64-codiert. URL-Sicherheit wird implementiert, indem die Base64-Codierung der Binärdaten wie folgt geändert wird:
Ersetzen + mit -
Ersetzen / mit _
Entfernen aller nachgestellten Auffüllungszeichen (=)
Fügen Sie am Ende der Zeichenfolge eine ganze Zahl hinzu, die angibt, wie viele Auffüllungszeichen im Ursprünglichen (0, 1oder 2) enthalten waren.
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode und eine convertIdResult-Auflistung im Antworttext zurück200 OK.
Beispiel
Das folgende Beispiel zeigt, wie mehrere Bezeichner aus dem normalen REST-API-Format (restId) in das rest-unveränderliche Format (restImmutableEntryId) konvertiert werden.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Me.TranslateExchangeIds;
using Microsoft.Graph.Models;
var requestBody = new TranslateExchangeIdsPostRequestBody
{
InputIds = new List<string>
{
"{rest-formatted-id-1}",
"{rest-formatted-id-2}",
},
SourceIdType = ExchangeIdFormat.RestId,
TargetIdType = ExchangeIdFormat.RestImmutableEntryId,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.TranslateExchangeIds.PostAsTranslateExchangeIdsPostResponseAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc users translate-exchange-ids post --user-id {user-id} --body '{\
"inputIds" : [\
"{rest-formatted-id-1}",\
"{rest-formatted-id-2}"\
],\
"sourceIdType": "restId",\
"targetIdType": "restImmutableEntryId"\
}\
'
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.users.item.translateexchangeids.TranslateExchangeIdsPostRequestBody translateExchangeIdsPostRequestBody = new com.microsoft.graph.users.item.translateexchangeids.TranslateExchangeIdsPostRequestBody();
LinkedList<String> inputIds = new LinkedList<String>();
inputIds.add("{rest-formatted-id-1}");
inputIds.add("{rest-formatted-id-2}");
translateExchangeIdsPostRequestBody.setInputIds(inputIds);
translateExchangeIdsPostRequestBody.setSourceIdType(ExchangeIdFormat.RestId);
translateExchangeIdsPostRequestBody.setTargetIdType(ExchangeIdFormat.RestImmutableEntryId);
var result = graphClient.me().translateExchangeIds().post(translateExchangeIdsPostRequestBody);
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.