# 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`.

```json
{
  "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

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

```bash
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](/docs/policies/personal-data) 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.