signInActivity リソースの種類

名前空間: microsoft.graph

重要

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

特定のユーザーの最後の対話型または非対話型のサインイン試行時間を提供します。 signInActivity はユーザー オブジェクトのプロパティを記述するため、ユーザー オブジェクトが存在する限り、ユーザーのサインイン アクティビティが Microsoft Entra ID に保存されます。

2023 年 12 月 1 日より、 lastSuccessfulSignInDateTime プロパティを使用すると、サインインが対話型か非対話型かに関係なく、特定のユーザーの最後に 成功した サインイン時刻を提供できます。 このプロパティのデータはバックフィルされません。

signInActivity の詳細を取得する例を参照してください。

プロパティ

プロパティ 型 説明
lastNonInteractiveSignInDateTime DateTimeOffset 特定のユーザーの非対話型の最後のサインイン日。 このフィールドを使用して、クライアントが最後にユーザーの代わりにディレクトリへのサインインを試みた時刻 (成功または失敗) を計算できます。 一部のユーザーは、テナントに直接サインインするのではなく、クライアントを使用してテナント リソースにアクセスする場合があるため、非対話型のサインイン日を lastSignInDateTime と共に使用して、非アクティブなユーザーを識別できます。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 Microsoft Entra ID は、2020 年 5 月までさかのぼって非対話型サインインを維持します。 このプロパティの値の使用方法の詳細については、「Microsoft Entra ID で非アクティブなユーザー アカウントを管理する」を参照してください。
lastNonInteractiveSignInRequestId 文字列 このユーザーによって実行された最後の非対話型サインインの要求識別子。
lastSignInDateTime DateTimeOffset 特定のユーザーの最後の対話型サインインの日時。 このフィールドを使用して、ユーザーが対話型認証方法でディレクトリに最後にサインインしようとした時間 (成功または失敗) を計算できます。 このフィールドは、非アクティブなユーザーなどのレポートの作成に使用できます。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。 Microsoft Entra ID は、2020 年 4 月までさかのぼって対話型サインインを維持します。 このプロパティの値の使用方法の詳細については、「Microsoft Entra ID で非アクティブなユーザー アカウントを管理する」を参照してください。
lastSignInRequestId 文字列 このユーザーによって実行された最後の対話型サインインの要求識別子。
lastSuccessfulSignInDateTime DateTimeOffset ユーザーの最後に成功した対話型または非対話型サインインの日時。 タイムスタンプの種類は、ISO 8601 形式を使用して、常に UTC 形式の日付と時刻情報を表します。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
lastSuccessfulSignInRequestId 文字列 前回成功したサインインの要求 ID。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

{
  "@odata.type": "#microsoft.graph.signInActivity",
  "lastNonInteractiveSignInDateTime": "String (timestamp)",
  "lastNonInteractiveSignInRequestId": "String",
  "lastSignInDateTime": "String (timestamp)",
  "lastSignInRequestId": "String",
  "lastSuccessfulSignInDateTime": "String (timestamp)",
  "lastSuccessfulSignInRequestId": "String"
}