次の方法で共有


phoneAuthenticationMethod を取得する

名前空間: microsoft.graph

ユーザーの 1 つの phoneAuthenticationMethod オブジェクトを取得します。 この方法は、標準のMicrosoft Entra IDおよび B2B ユーザーにのみ使用できますが、B2C ユーザーには使用できません。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

自己に対して動作するアクセス許可

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) UserAuthenticationMethod.Read、UserAuthenticationMethod.ReadWrite
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション サポートされていません。

他のユーザーに対して動作するアクセス許可

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) UserAuthenticationMethod.Read.All、UserAuthenticationMethod.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション UserAuthenticationMethod.Read.All、UserAuthenticationMethod.ReadWrite.All

重要

サインインしているユーザーが別のユーザーを操作している職場または学校アカウントで委任されたシナリオでは、サポートされているMicrosoft Entraロールまたはサポートされているロールのアクセス許可を持つカスタム ロールを割り当てる必要があります。 この操作では、次の最小特権ロールがサポートされています。

  • グローバル閲覧者
  • 認証管理者
  • 特権認証管理者

注:

認証管理者には、マスクされた電話番号のみが表示されます。

HTTP 要求

独自の電話認証方法の詳細を取得します。

GET /me/authentication/phoneMethods/{phoneMethodId}

自分または別のユーザーの電話認証方法の詳細を取得します。

GET /users/{userId | userPrincipalName}/authentication/phoneMethods/{phoneMethodId}

phoneType に対応する phoneMethodId の値は、次のいずれかです。

  • b6332ec1-7057-4abe-9331-3d72feddfe41 を使用して、 alternateMobilephoneType を取得します。
  • e37fc753-ff3b-4958-9484-eaa9425c82bc を使用して、 officephoneType を取得します。
  • 3179e48a-750b-4051-897c-87b9720928f7 を使用して、 mobilephoneType を取得します。

オプションのクエリ パラメーター

このメソッドでは、応答をカスタマイズするためのオプションのクエリ パラメーターはサポートされていません。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で要求された phoneAuthenticationMethod オブジェクトを返します。

要求

次の例は要求を示しています。

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

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-type: application/json

{
  "phoneNumber": "+1 2065555555",
  "phoneType": "mobile",
  "smsSignInState": "ready",
  "id": "3179e48a-750b-4051-897c-87b9720928f7"
}