phoneAuthenticationMethod: disableSmsSignIn

Namespace: microsoft.graph

Deaktivieren Sie die SMS-Anmeldung für eine vorhandene mobile Telefonnummer, die für einen Benutzer registriert ist. Die Nummer steht für die SMS-Anmeldung nicht mehr zur Verfügung, was verhindern kann, dass sich Ihr Benutzer anmeldet.

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

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

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungen, die für sich selbst handeln

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) UserAuthenticationMethod.ReadWrite
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung Nicht unterstützt

Berechtigungen, die auf andere Benutzer reagieren

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) UserAuthenticationMethod.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung UserAuthenticationMethod.ReadWrite.All

Wichtig

In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten, in denen der angemeldete Benutzer auf einen anderen Benutzer agiert, muss ihm eine unterstützte Microsoft Entra Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.

  • Authentifizierungsadministrator
  • Privilegierter Authentifizierungsadministrator

HTTP-Anforderung

Deaktivieren Sie die SMS-Anmeldung für Ihre eigene Authentifizierungsmethode für Mobiltelefone.

POST /me/authentication/phoneMethods/{mobilePhoneMethodId}/disableSmsSignIn

Deaktivieren Sie die SMS-Anmeldung für ihre eigene oder die Authentifizierungsmethode eines anderen Benutzers für Mobiltelefone.

POST /users/{id | userPrincipalName}/authentication/phoneMethods/{mobilePhoneMethodId}/disableSmsSignIn

Der Wert von mobilePhoneMethodId für phoneType mobile ist 3179e48a-750b-4051-897c-87b9720928f7.

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Es gibt nichts im Antworttext zurück.

Beispiele

Das folgende Beispiel illustriert, wie Sie diese API aufrufen können.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/v1.0/me/authentication/phoneMethods/3179e48a-750b-4051-897c-87b9720928f7/disableSmsSignIn

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content