接続の rpId 移行を取得
GET /v1/connections/{connection_id}/rp-id-migration · 権限 connections:read
パスキー接続の最新の rpId 移行を返します。移行が実行中か、すでに終了しているかは問いません(パスキーの rpId を変更を参照してください)。件数は移行の終了時に記録され、移行が active の間は null になります。読み取り操作は監査されません。
リクエスト
| フィールド | 種類 | 必須 | 説明 |
|---|---|---|---|
connection_id |
パス | はい | パスキー接続 ID(conn_…)。 |
レスポンス
200 OK:
{
"id": "rpm_01j9xr4a6b8c0d2e4f6g8h0j2k",
"connection_id": "conn_01j9xp6q0r1s5t7v9w1x3y5z7b",
"previous_rp_id": null,
"new_rp_id": "login.example.com",
"status": "completed_early",
"started_at": "2026-10-27T10:00:00Z",
"ends_at": "2027-01-25T10:00:00Z",
"completed_at": "2026-12-01T09:00:00Z",
"revoked_count": 12,
"new_registration_count": 340,
"fallback_enabled_by_migration": false
}
| フィールド | 説明 |
|---|---|
status |
active(実行中)、completed(期間が終了)、または completed_early(期間前に終了)。 |
revoked_count |
移行の終了時に取り消された、以前の rpId 上のパスキーの数。 |
new_registration_count |
移行期間中に新しい rpId で登録されたパスキーの数。 |
エラー
| HTTP | code | 発生条件 |
|---|---|---|
| 404 | not_found |
接続がこの環境に存在しない、パスキー接続ではない、または rpId 移行を一度も行っていません。 |
| 401 | unauthenticated |
認証情報が存在しないか、無効または取り消されています。 |
| 403 | insufficient_permissions |
認証情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の期間を待ってから再試行してください。 |
| 503 | service_unavailable |
依存先が一時的に利用できません。Retry-After の期間を待ってから再試行してください。 |
例
curl "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/rp-id-migration" \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
keenauth connections rp-id-migration conn_01j9xp6q0r1s5t7v9w1x3y5z7b