ディレクトリのプロビジョニングログの一覧

GET /v1/directories/{directory_id}/provisioning-logs · 権限 directories:read

SCIM ディレクトリのプロビジョニングログを、新しいものから順に一覧表示します。ID プロバイダが送信した認証済みの SCIM リクエストは、それぞれ 1 件のレコードになります。レコードには、メソッド、パステンプレート（実際の ID がパスに含まれることはありません）、リソースタイプと ID、値を含まない操作の概要、無視された属性名、HTTP ステータス、scim_type、処理時間、クライアントアドレスのプレフィックス（IPv4 は /24、IPv6 は /48）、クライアントの分類、および一括デプロビジョニング保留によってリクエストが停止されたかどうかが含まれます。リクエストボディとレスポンスボディ、属性の値、完全な IP アドレス、User-Agent、トークンの値は保存されず、返されることもありません。

レコードはプランのログ保持期間の間保存されます（Free は 7 日、Startup は 14 日、Business は 30 日、Enterprise は 90 日）。順序は常に新しいものから古いものへです。order パラメータはありません。削除されたディレクトリのレコードは、GET /v1/logs?type=scim.request で引き続き読み取れます。

リクエスト

項目 型 必須 説明
directory_id path はい SCIM ディレクトリ ID（dir_…）。
limit query いいえ 1〜100、既定値は 20。
after query いいえ list_metadata.after のカーソル（より古いレコード）。
before query いいえ list_metadata.before のカーソル（より新しいレコード）。
from query いいえ 下限（この値を含む、RFC 3339）。
to query いいえ 上限（この値を含まない、RFC 3339）。

リクエストボディはありません。

レスポンス

200 OK とともに、レコードのページを返します。

{
  "data": [
    {
      "id": "evt_01j9xp4q6r8s0t2v4w6x8y0z2b",
      "occurred_at": "2026-10-20T12:00:00Z",
      "outcome": "success",
      "organization_id": "org_01j9xk1m3n5p7q9r1s3t5v7w9x",
      "token_id": "dst_01j9xn2p4q6r8s0t2v4w6x8y0z",
      "method": "PATCH",
      "path_template": "PATCH /Users/{id}",
      "resource_type": "User",
      "resource_id": "dsu_01j9xq5r7s9t1v3w5x7y9z1a3c",
      "operation_summary": ["replace:active"],
      "ignored_attributes": [],
      "status": 200,
      "scim_type": null,
      "duration_ms": 12,
      "client_ip_prefix": "203.0.113.0/24",
      "client_class": "okta",
      "held": false,
      "request_id": "0192f5e0-0000-7000-8000-000000000001",
      "trace_id": "4bf92f3577b34da6a3ce929d0e0e4736"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

エラー

HTTP code 発生条件
400 invalid_cursor カーソルの形式が不正であるか、別のリクエストに属しています。
400 range_outside_retention from がプランの保持期間より前の日時です。
404 not_found このenvironmentにディレクトリが存在しません。
422 validation_failed limit が範囲外である、from または to が RFC 3339 形式ではない、to が from より後ではない、または order が指定されています（unsupported）。
401 unauthenticated 認証情報が見つからない、無効である、または取り消されています。
403 insufficient_permissions 認証情報に必要な権限がありません。
429 rate_limited レート制限を超えました。Retry-After の期間を待ってから再試行してください。
503 service_unavailable ディレクトリ同期またはログ検索が一時的に利用できないか、このデプロイメントで設定されていません。Retry-After の期間を待ってから再試行してください。

例

curl -i "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/provisioning-logs?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth directories provisioning-logs list dir_01j9xm2n4p6q8r0s2t4v6w8y0z --from 2026-10-01T00:00:00Z

個人データ

このエンドポイントは個人データを扱います：ディレクトリ（SCIM）のユーザーです。KeenAuth API における個人データでは、保存される内容、保存期間、削除方法について説明しています。どのフィールドにも、特別な種類の個人データ（健康、生体情報、宗教、政治的意見、性的指向）を送信しないでください。