Dizin sağlama günlüklerini listeleyin

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

Bir SCIM dizininin sağlama günlüğünü en yeniden en eskiye doğru listeler. Kimlik sağlayıcının gönderdiği kimliği doğrulanmış her SCIM isteği bir kayıttır: yöntem, yol şablonu (gerçek kimlik yolda hiçbir zaman yer almaz), kaynak türü ve kimliği, değer içermeyen bir işlem özeti, yok sayılan öznitelik adları, HTTP durumu, scim_type, süre, istemci adresinin önek bölümü (IPv4 /24, IPv6 /48), istemci sınıfı ve isteğin toplu hesap kaldırma beklemesi tarafından durdurulup durdurulmadığı. İstek ve yanıt gövdeleri, öznitelik değerleri, tam IP adresi, User-Agent ve belirteç değeri hiçbir zaman saklanmaz ve hiçbir zaman döndürülmez.

Kayıtlar planınızın günlük saklama süresi boyunca tutulur (Free 7 gün, Startup 14, Business 30, Enterprise 90). Sıralama her zaman en yeniden en eskiye doğrudur; order parametresi yoktur. Silinmiş bir dizinin kayıtları GET /v1/logs?type=scim.request ile okunmaya devam eder.

İstek

Alan Tür Zorunlu Açıklama
directory_id yol evet SCIM dizin kimliği (dir_…).
limit sorgu hayır 1–100, varsayılan 20.
after sorgu hayır list_metadata.after değerinden gelen imleç (daha eski kayıtlar).
before sorgu hayır list_metadata.before değerinden gelen imleç (daha yeni kayıtlar).
from sorgu hayır Dahil alt sınır (RFC 3339).
to sorgu hayır Hariç üst sınır (RFC 3339).

İstek gövdesi yoktur.

Yanıt

Kayıtlardan oluşan bir sayfa içeren 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
  }
}

Hatalar

HTTP code Ne zaman
400 invalid_cursor İmleç hatalı biçimde veya başka bir isteğe ait.
400 range_outside_retention from, planınızın saklama süresinden daha eski.
404 not_found Dizin bu ortamda mevcut değil.
422 validation_failed limit aralık dışında, from veya to RFC 3339 biçiminde değil, to değeri from değerinden sonra değil ya da order verilmiş (unsupported).
401 unauthenticated Kimlik bilgisi eksik, geçersiz veya iptal edilmiş.
403 insufficient_permissions Kimlik bilgisinin gerekli izni yok.
429 rate_limited Hız sınırı aşıldı; Retry-After süresinden sonra yeniden deneyin.
503 service_unavailable Dizin senkronizasyonu veya günlük araması geçici olarak kullanılamıyor ya da bu dağıtımda yapılandırılmamış; Retry-After süresinden sonra yeniden deneyin.

Örnek

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

Kişisel veriler

Bu uç nokta kişisel veri içerir: dizin (SCIM) kullanıcıları. KeenAuth API'lerinde kişisel veriler sayfası, neyin saklandığını, ne kadar süre tutulduğunu ve nasıl silindiğini açıklar. Hiçbir alanda özel nitelikli kişisel verileri (sağlık, biyometrik veriler, din, siyasi görüşler, cinsel yönelim) göndermeyin.