authenticationMethodsRoot: userRegistrationActivity

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

userRegistrationActivity オブジェクトで定義されている認証方法とそれに対応する登録およびリセット アクティビティの数の一覧を取得します。

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

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

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類	最小特権アクセス許可	より高い特権のアクセス許可
委任 (職場または学校のアカウント)	AuditLog.Read.All	注意事項なし。
委任 (個人用 Microsoft アカウント)	サポートされていません。	サポートされていません。
アプリケーション	サポートされていません。	サポートされていません。

重要

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

• レポート閲覧者
• セキュリティ閲覧者
• セキュリティ管理者
• グローバル閲覧者

HTTP 要求

GET /reports/authenticationMethods/userRegistrationActivity(period='{period}')

関数パラメーター

要求 URL で、次のクエリ パラメーターに値を指定します。

パラメーター	型	説明
period	aggregationPeriod	概要を取得する集計ウィンドウ。 使用できる値は、 d1 (過去 1 日)、 d7 (過去 7 日間)、 d30 (過去 30 日間) です。 必須

要求ヘッダー

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

要求本文

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

応答

成功した場合、この関数は応答コード 200 OK と、応答本文の userRegistrationActivitySummary コレクションを返します。

例

要求

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

GET https://graph.microsoft.com/beta/reports/authenticationMethods/userRegistrationActivity(period='d1')

応答

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

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

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "97d6cbb9-9323-4b6a-b89d-b2a60907ede4",
      "feature": "registration",
      "successfulActivityCount": 1,
      "failureActivityCount": 0,
      "authMethod": "windowsHelloForBusiness"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "8998b7bb-ece5-4255-8df9-4317c8a738b8",
      "feature": "registration",
      "successfulActivityCount": 83,
      "failureActivityCount": 214,
      "authMethod": "microsoftAuthenticatorPush"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "08a64d97-bc7f-412e-9555-bdd37d5a5718",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "email"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "22233ba5-c798-4580-ac6b-03011f290869",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "mobilePhone"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "d4794a86-5d93-4d6b-a5ba-4aa52920a97c",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "officePhone"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "436d1cbe-711a-4840-bef4-f4c69fa8ad74",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "alternateMobilePhone"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "3a7b2247-5a78-4c84-964d-2eb1d2e91aa0",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "securityQuestion"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "f096f3d7-aef9-4211-9e15-a30e27cbf66b",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "softwareOneTimePasscode"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "00ee088a-c208-4c6c-827c-6701fc761607",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "hardwareOneTimePasscode"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "8784730b-22ba-457c-a024-1b8361319377",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "fido2SecurityKey"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "aa3da958-fd4b-4a3e-b59c-48637acec161",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "temporaryAccessPass"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "c1926478-acad-497d-bd33-a395286486a1",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "microsoftAuthenticatorPasswordless"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "5b6c80a7-ada6-4f0d-8fa6-9cf9d76f2a37",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "macOsSecureEnclaveKey"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "520b7dff-73ca-411e-81ca-d65ac7587ba4",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "passKeyDeviceBound"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "983c4757-9a2d-43e9-8f24-5ee01515492d",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "passKeyDeviceBoundAuthenticator"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "0170d795-c5b8-4c32-b9e7-c33d17074337",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "passKeyDeviceBoundWindowsHello"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "aa8b0e59-2555-4b1b-a8fd-d3648620bbde",
      "feature": "registration",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "externalAuthMethod"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "93557928-5cbd-4968-8c88-de78f433080a",
      "feature": "reset",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "email"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "5570a753-6dd8-4063-b33a-3b6b0c77871f",
      "feature": "reset",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "mobilePhone"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "38a1efb3-5ab1-4f54-a0fb-9cd328525fcd",
      "feature": "reset",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "officePhone"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "0bcc380d-f6d3-418e-8743-027fee8b038e",
      "feature": "reset",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "alternateMobilePhone"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "6caf72c9-e0c9-4f79-aa4d-e8625a73cd27",
      "feature": "reset",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "securityQuestion"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "505b68c1-7db0-4eae-83a7-3e5f1f1baa30",
      "feature": "reset",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "microsoftAuthenticatorPush"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "0a597d38-3a54-4300-a3f2-e7f8357b51c6",
      "feature": "reset",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "sms"
    },
    {
      "@odata.type": "#microsoft.graph.userRegistrationActivitySummary",
      "id": "97ee074d-1a4a-4c96-b84b-edd902849062",
      "feature": "reset",
      "successfulActivityCount": 0,
      "failureActivityCount": 0,
      "authMethod": "oneTimePasscode"
    }
  ]
}