# Audit Logs ## Get Audit Log `$ nirvana audit-logs get` **get** `/v1/audit_logs/{audit_log_id}` Get an Audit Log entry ### Parameters - `--audit-log-id: string` Audit Log ID ### Returns - `audit_log: object { id, action, actor, 7 more }` Audit log entry. - `id: string` Unique identifier for the audit log entry. - `action: string` The action that was performed. - `actor: object { id, name, type }` The entity that performed the action. - `id: string` Unique identifier for the actor. - `name: string` Display name of the actor. - `type: "user" or "api_key"` Type of actor. - `"user"` - `"api_key"` - `client_ip: string` Client IP address. - `created_at: string` When the action occurred. - `method: string` HTTP method of the request. - `path: string` Request path. - `status_code: number` HTTP status code of the response. - `user_agent: string` User agent string. - `target: optional object { id, type }` The target resource of the action. - `id: string` Unique identifier for the target resource. - `type: string` Type of the target resource. ### Example ```cli nirvana audit-logs get \ --api-key 'My API Key' \ --audit-log-id audit_log_id ``` #### Response ```json { "id": "123e4567-e89b-12d3-a456-426614174000", "action": "vm.created", "actor": { "id": "123e4567-e89b-12d3-a456-426614174000", "name": "Alice Smith", "type": "user" }, "client_ip": "203.0.113.1", "created_at": "2025-01-01T00:00:00Z", "method": "GET", "path": "/v1/compute/vms", "status_code": 200, "user_agent": "Mozilla/5.0", "target": { "id": "123e4567-e89b-12d3-a456-426614174000", "type": "vm" } } ``` ## List Audit Logs `$ nirvana audit-logs list` **get** `/v1/audit_logs` List Audit Log entries for an organization ### Parameters - `--cursor: optional string` Pagination cursor returned by a previous request - `--limit: optional number` Maximum number of items to return ### Returns - `audit_log_list: object { items, pagination }` - `items: array of AuditLog` - `id: string` Unique identifier for the audit log entry. - `action: string` The action that was performed. - `actor: object { id, name, type }` The entity that performed the action. - `id: string` Unique identifier for the actor. - `name: string` Display name of the actor. - `type: "user" or "api_key"` Type of actor. - `"user"` - `"api_key"` - `client_ip: string` Client IP address. - `created_at: string` When the action occurred. - `method: string` HTTP method of the request. - `path: string` Request path. - `status_code: number` HTTP status code of the response. - `user_agent: string` User agent string. - `target: optional object { id, type }` The target resource of the action. - `id: string` Unique identifier for the target resource. - `type: string` Type of the target resource. - `pagination: object { next_cursor, previous_cursor, total_count }` Pagination response details. - `next_cursor: string` - `previous_cursor: string` - `total_count: number` ### Example ```cli nirvana audit-logs list \ --api-key 'My API Key' ``` #### Response ```json { "items": [ { "id": "123e4567-e89b-12d3-a456-426614174000", "action": "vm.created", "actor": { "id": "123e4567-e89b-12d3-a456-426614174000", "name": "Alice Smith", "type": "user" }, "client_ip": "203.0.113.1", "created_at": "2025-01-01T00:00:00Z", "method": "GET", "path": "/v1/compute/vms", "status_code": 200, "user_agent": "Mozilla/5.0", "target": { "id": "123e4567-e89b-12d3-a456-426614174000", "type": "vm" } } ], "pagination": { "next_cursor": "RhwniMT4B74siYZcPF8TnCdGI1l9rpPvg", "previous_cursor": "ARhwnmi1hA7wEbHbMjdYQlOB_ZusP4fYvw", "total_count": 125 } } ``` ## Domain Types ### Audit Log - `audit_log: object { id, action, actor, 7 more }` Audit log entry. - `id: string` Unique identifier for the audit log entry. - `action: string` The action that was performed. - `actor: object { id, name, type }` The entity that performed the action. - `id: string` Unique identifier for the actor. - `name: string` Display name of the actor. - `type: "user" or "api_key"` Type of actor. - `"user"` - `"api_key"` - `client_ip: string` Client IP address. - `created_at: string` When the action occurred. - `method: string` HTTP method of the request. - `path: string` Request path. - `status_code: number` HTTP status code of the response. - `user_agent: string` User agent string. - `target: optional object { id, type }` The target resource of the action. - `id: string` Unique identifier for the target resource. - `type: string` Type of the target resource. ### Audit Log Actor - `audit_log_actor: object { id, name, type }` The entity that performed the action. - `id: string` Unique identifier for the actor. - `name: string` Display name of the actor. - `type: "user" or "api_key"` Type of actor. - `"user"` - `"api_key"` ### Audit Log List - `audit_log_list: object { items, pagination }` - `items: array of AuditLog` - `id: string` Unique identifier for the audit log entry. - `action: string` The action that was performed. - `actor: object { id, name, type }` The entity that performed the action. - `id: string` Unique identifier for the actor. - `name: string` Display name of the actor. - `type: "user" or "api_key"` Type of actor. - `"user"` - `"api_key"` - `client_ip: string` Client IP address. - `created_at: string` When the action occurred. - `method: string` HTTP method of the request. - `path: string` Request path. - `status_code: number` HTTP status code of the response. - `user_agent: string` User agent string. - `target: optional object { id, type }` The target resource of the action. - `id: string` Unique identifier for the target resource. - `type: string` Type of the target resource. - `pagination: object { next_cursor, previous_cursor, total_count }` Pagination response details. - `next_cursor: string` - `previous_cursor: string` - `total_count: number` ### Audit Log Target - `audit_log_target: object { id, type }` The target resource of the action. - `id: string` Unique identifier for the target resource. - `type: string` Type of the target resource. ### Audit Log Type - `audit_log_type: "user" or "api_key"` Type of actor. - `"user"` - `"api_key"`