Erstellen eines pendingExternalUserProfile

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.

Erstellen Sie ein neues pendingExternalUserProfile-Objekt .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) PendingExternalUserProfile.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application PendingExternalUserProfile.ReadWrite.All Nicht verfügbar.

Wichtig

Für den delegierten Zugriff mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle zugewiesen werden, die die für diesen Vorgang erforderlichen Berechtigungen gewährt. Dieser Vorgang unterstützt die folgenden integrierten Rollen, die nur die geringstmöglichen Berechtigungen gewähren:

  • Erweiterter Verzeichnisbenutzeradministrator
  • Teams-Dienstadministrator

HTTP-Anforderung

POST /directory/pendingExternalUserProfiles

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung eines pendingExternalUserProfile an.

Eigenschaft Typ Beschreibung
address physicalOfficeAddress Die Büroadresse des ausstehenden externen Benutzerprofils.
createdBy Zeichenfolge Die Objekt-ID des Benutzers, der das ausstehende externe Benutzerprofil erstellt hat. Schreibgeschützt. Lässt keine NULL-Werte zu.
createdDateTime DateTimeOffset Datum und Uhrzeit, zu der dieses ausstehende externe Benutzerprofil erstellt wurde. Lässt keine NULL-Werte zu. Schreibgeschützt.
CompanyName String Der Firmenname des ausstehenden externen Benutzerprofils.
deletedDateTime DateTimeOffset Datum und Uhrzeit, zu der das ausstehende externe Benutzerprofil gelöscht wurde. Immer null dann, wenn das Objekt nicht gelöscht wird.
department Zeichenfolge Die Abteilung des ausstehenden externen Benutzerprofils.
displayName Zeichenfolge Der Anzeigename des ausstehenden externen Benutzerprofils. Erforderlich.
epoch Int Die Versionsnummer des ausstehenden externen Benutzerprofils. Erhöht mit jeder Aktualisierung der Entität. Schreibgeschützt. Lässt keine NULL-Werte zu.
id Zeichenfolge Der eindeutige Bezeichner für das ausstehende externe Benutzerprofil. Beispiel: 12345678-9abc-def0-1234-56789abcde. Der Wert der id-Eigenschaft liegt häufig, aber nicht ausschließlich, in Form einer GUID vor. Behandeln Sie es als nicht transparenten Bezeichner, und verlassen Sie sich nicht darauf, dass es sich um eine GUID handelt. Key. Lässt keine Nullwerte zu. Schreibgeschützt.
isDiscoverable Boolean Gibt an, ob das ausstehende externe Benutzerprofil im Verzeichnis gefunden werden kann.
isEnabled Boolescher Wert Gibt an, ob das ausstehende externe Benutzerprofil im Verzeichnis aktiviert ist.
jobTitle Zeichenfolge Die Berufsbezeichnung des externen Benutzerprofils.
PhoneNumber Zeichenfolge Die Telefonnummer des ausstehenden externen Benutzerprofils. Muss im E164-Format sein. Erforderlich.
supervisorId Zeichenfolge Die Objekt-ID des Supervisors des ausstehenden externen Benutzerprofils.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 201 Created Antwortcode und ein pendingExternalUserProfile-Objekt zurück. Wenn dies nicht erfolgreich ist, wird ein 4xx Fehler mit spezifischen Details zurückgegeben.

Beispiel

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/directory/pendingExternalUserProfiles
Content-type: application/json

{
    "phoneNumber": "+15555555555",
    "displayName": "Bob Henry"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Content-type: application/json

{
    "id":"1e4ba82a-5f0c-423c-83e1-fc8ad69d8f02",
    "isEnabled":true,
    "createdDateTime":"2020-11-12T17:53:48Z",
    "deletedDateTime":null,
    "department":null,
    "displayName":"Bob Henry",
    "isDiscoverable":true,
    "jobTitle":null,
    "phoneNumber":"4257034568",
    "address": {
        "city": null,
        "countryOrRegion": null,
        "officeLocation": null,
        "postalCode": null,
        "state": null,
        "street": null
    },
    "epoch":1,
    "createdBy":"67670e18-bf37-416c-b5c8-3bfdaad757cc",
    "supervisorId":null,
    "companyName":null
}