SlotKeeper 設計と品質

API message catalog index

domain api route id message_id level status ログ概要 出力項目 対応すべきこと runbook output
reservations cancel_reservation POST /reservations/{reservationId}/cancel M001 cancelReservation.caller_cannot_cancel_reservation WARNING 403 呼び出し元が予約者本人でも管理者でもないため、予約取消を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.reservationId, error.code, error.message actorPrincipalIdとreservationIdの所有者を確認する。 RUNBOOK-authorization-forbidden docs/spec/40.apis/reservations/cancel_reservation/messages_gen.md
reservations cancel_reservation POST /reservations/{reservationId}/cancel M002 cancelReservation.stale_reservation_version WARNING 409 予約の版が現在値と一致しないため、予約取消を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.reservationId, error.code, error.message 利用者へ予約を再取得して取消し直すよう案内する。 RUNBOOK-optimistic-lock-conflict docs/spec/40.apis/reservations/cancel_reservation/messages_gen.md
reservations cancel_reservation POST /reservations/{reservationId}/cancel M003 cancelReservation.reservation_already_cancelled WARNING 409 予約が取消済みのため、予約取消を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.reservationId, error.code, error.message 予約詳細の履歴で取消済みであることを確認する。 RUNBOOK-reservation-conflict docs/spec/40.apis/reservations/cancel_reservation/messages_gen.md
reservations cancel_reservation POST /reservations/{reservationId}/cancel M004 cancelReservation.reservation_already_started WARNING 409 予約の開始時刻を過ぎているため、予約取消を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.reservationId, error.code, error.message 開始済み予約は取消できないことを利用者へ案内する。 RUNBOOK-reservation-conflict docs/spec/40.apis/reservations/cancel_reservation/messages_gen.md
reservations cancel_reservation POST /reservations/{reservationId}/cancel M005 cancelReservation.router_api_function_error ERROR Routerで捕捉したApiFunctionErrorにより予約取消が失敗した。 traceId, actorPrincipalId, api.statusCode, resource.reservationId, error.code, error.message, error.exceptionType, resource.version 同一routeの5xx率、直近deploy、DB状態を確認する。 RUNBOOK-unexpected-api-failure docs/spec/40.apis/reservations/cancel_reservation/messages_gen.md
reservations create_reservation POST /reservations M001 createReservation.idempotency_key_reused WARNING 409 同じIdempotency-Keyで異なる入力が送られたため、予約作成を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.resourceId, error.code, error.message 利用者へ新しいIdempotency-Keyで予約し直すよう案内する。 RUNBOOK-idempotency-conflict docs/spec/40.apis/reservations/create_reservation/messages_gen.md
reservations create_reservation POST /reservations M002 createReservation.resource_inactive WARNING 409 予約対象の資源が無効化されているため、予約作成を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.resourceId, error.code, error.message 資源の有効状態と利用者への案内を確認する。 RUNBOOK-resource-deactivation docs/spec/40.apis/reservations/create_reservation/messages_gen.md
reservations create_reservation POST /reservations M003 createReservation.slot_taken WARNING 409 同じ資源の確定予約と時間帯が重なるため、予約作成を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.resourceId, error.code, error.message 利用者へ予約表を再取得して別の時間帯を選ぶよう案内する。 RUNBOOK-reservation-conflict docs/spec/40.apis/reservations/create_reservation/messages_gen.md
reservations create_reservation POST /reservations M004 createReservation.router_api_function_error ERROR Routerで捕捉したApiFunctionErrorにより予約作成が失敗した。 traceId, actorPrincipalId, api.statusCode, resource.resourceId, error.code, error.message, error.exceptionType, resource.idempotencyKey 同一routeの4xx/5xx率、直近deploy、DB状態を確認する。 RUNBOOK-unexpected-api-failure docs/spec/40.apis/reservations/create_reservation/messages_gen.md
reservations get_reservation GET /reservations/{reservationId} M001 getReservation.caller_cannot_view_reservation WARNING 403 呼び出し元が予約者本人でも管理者でもないため、予約詳細の参照を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.reservationId, error.code, error.message actorPrincipalIdとreservationIdの所有者を確認する。 RUNBOOK-authorization-forbidden docs/spec/40.apis/reservations/get_reservation/messages_gen.md
reservations get_reservation GET /reservations/{reservationId} M002 getReservation.router_api_function_error ERROR Routerで捕捉したApiFunctionErrorにより予約詳細取得が失敗した。 traceId, actorPrincipalId, api.statusCode, resource.reservationId, error.code, error.message, error.exceptionType 同一routeの5xx率、直近deploy、DB状態を確認する。 RUNBOOK-unexpected-api-failure docs/spec/40.apis/reservations/get_reservation/messages_gen.md
reservations list_reservations GET /reservations M001 listReservations.router_api_function_error ERROR Routerで捕捉したApiFunctionErrorにより予約一覧取得が失敗した。 traceId, actorPrincipalId, api.statusCode, error.code, error.message, error.exceptionType, resource.day, resource.status 同一routeの5xx率、直近deploy、DB状態を確認する。 RUNBOOK-unexpected-api-failure docs/spec/40.apis/reservations/list_reservations/messages_gen.md
resources create_resource POST /resources M001 createResource.caller_cannot_manage_resources WARNING 403 呼び出し元が管理者ではないため、資源登録を拒否した。 traceId, actorPrincipalId, api.statusCode, error.code, error.message, resource.name actorPrincipalIdと管理者groupの割当てを確認する。 RUNBOOK-authorization-forbidden docs/spec/40.apis/resources/create_resource/messages_gen.md
resources create_resource POST /resources M002 createResource.router_api_function_error ERROR Routerで捕捉したApiFunctionErrorにより資源登録が失敗した。 traceId, actorPrincipalId, api.statusCode, error.code, error.message, error.exceptionType, resource.name 同一routeの5xx率、直近deploy、DB状態を確認する。 RUNBOOK-unexpected-api-failure docs/spec/40.apis/resources/create_resource/messages_gen.md
resources get_resource_schedule GET /resources/{resourceId}/schedule M001 getResourceSchedule.router_api_function_error ERROR Routerで捕捉したApiFunctionErrorにより予約表取得が失敗した。 traceId, actorPrincipalId, api.statusCode, resource.resourceId, error.code, error.message, error.exceptionType, resource.day 同一routeの5xx率、直近deploy、DB状態を確認する。 RUNBOOK-unexpected-api-failure docs/spec/40.apis/resources/get_resource_schedule/messages_gen.md
resources list_resources GET /resources M001 listResources.router_api_function_error ERROR Routerで捕捉したApiFunctionErrorにより資源一覧取得が失敗した。 traceId, actorPrincipalId, api.statusCode, error.code, error.message, error.exceptionType, resource.nextToken 同一routeの5xx率、直近deploy、DB状態を確認する。 RUNBOOK-unexpected-api-failure docs/spec/40.apis/resources/list_resources/messages_gen.md
resources update_resource PUT /resources/{resourceId} M001 updateResource.caller_cannot_manage_resources WARNING 403 呼び出し元が管理者ではないため、資源編集を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.resourceId, error.code, error.message actorPrincipalIdと管理者groupの割当てを確認する。 RUNBOOK-authorization-forbidden docs/spec/40.apis/resources/update_resource/messages_gen.md
resources update_resource PUT /resources/{resourceId} M002 updateResource.stale_resource_version WARNING 409 資源の公開版が現在値と一致しないため、資源編集を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.resourceId, error.code, error.message 利用者へ資源を再取得して編集し直すよう案内する。 RUNBOOK-optimistic-lock-conflict docs/spec/40.apis/resources/update_resource/messages_gen.md
resources update_resource PUT /resources/{resourceId} M003 updateResource.future_reservations_exist WARNING 409 開始前の確定予約が残っているため、資源の無効化を拒否した。 traceId, actorPrincipalId, api.statusCode, resource.resourceId, error.code, error.message 将来予約の取消または移動を予約者と調整してから無効化する。 RUNBOOK-resource-deactivation docs/spec/40.apis/resources/update_resource/messages_gen.md
resources update_resource PUT /resources/{resourceId} M004 updateResource.router_api_function_error ERROR Routerで捕捉したApiFunctionErrorにより資源編集が失敗した。 traceId, actorPrincipalId, api.statusCode, resource.resourceId, error.code, error.message, error.exceptionType, resource.version 同一routeの5xx率、直近deploy、DB状態を確認する。 RUNBOOK-unexpected-api-failure docs/spec/40.apis/resources/update_resource/messages_gen.md