# 接続の rpId 移行を取得

`GET /v1/connections/{connection_id}/rp-id-migration` · 権限 `connections:read`

パスキー接続の最新の rpId 移行を返します。移行が実行中か、すでに終了しているかは問いません（[パスキーの rpId を変更](change-rp-id.md)を参照してください）。件数は移行の終了時に記録され、移行が `active` の間は `null` になります。読み取り操作は監査されません。

## リクエスト

| フィールド | 種類 | 必須 | 説明 |
|---|---|---|---|
| `connection_id` | パス | はい | パスキー接続 ID（`conn_…`）。 |

## レスポンス

`200 OK`:

```json
{
  "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` の期間を待ってから再試行してください。 |

## 例

```bash
curl "https://api.eu.keenauth.com/v1/connections/conn_01j9xp6q0r1s5t7v9w1x3y5z7b/rp-id-migration" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```

```bash
keenauth connections rp-id-migration conn_01j9xp6q0r1s5t7v9w1x3y5z7b
```