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 ロールの少なくとも 1 つを必要とします。

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

注:

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

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"
}