{"record":{"id":"6dc06a7e0f05cdb9","repo":"influxdata/influxdb","slug":"0","errorCode":null,"errorMessage":"{0}","messagePattern":"\\{0\\}","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"core/influxdb_iox_client/src/client/error.rs","lineNumber":78,"sourceCode":"}\n\n/// The errors returned by this client\n#[derive(Error, Debug)]\n#[expect(missing_docs)]\npub enum Error {\n    #[error(\"The operation was cancelled: {0}\")]\n    Cancelled(ServerError<()>),\n\n    #[error(\"Unknown server error: {0}\")]\n    Unknown(ServerError<()>),\n\n    #[error(\"Client specified an invalid argument: {0}\")]\n    InvalidArgument(Box<ServerError<FieldViolation>>),\n\n    #[error(\"Deadline expired before operation could complete: {0}\")]\n    DeadlineExceeded(ServerError<()>),\n\n    #[error(\"{0}\")]\n    NotFound(Box<ServerError<NotFound>>),\n\n    #[error(\"Some entity that we attempted to create already exists: {0}\")]\n    AlreadyExists(Box<ServerError<AlreadyExists>>),\n\n    #[error(\"The caller does not have permission to execute the specified operation: {0}\")]\n    PermissionDenied(ServerError<()>),\n\n    #[error(\"Some resource has been exhausted: {0}\")]\n    ResourceExhausted(ServerError<()>),\n\n    #[error(\"The system is not in a state required for the operation's execution: {0}\")]\n    FailedPrecondition(Box<ServerError<PreconditionViolation>>),\n\n    #[error(\"The operation was aborted: {0}\")]\n    Aborted(ServerError<()>),\n\n    #[error(\"Operation was attempted past the valid range: {0}\")]","sourceCodeStart":60,"sourceCodeEnd":96,"githubUrl":"https://github.com/influxdata/influxdb/blob/06200ef96ba82c5f6727e5038a83af8e722c6875/core/influxdb_iox_client/src/client/error.rs#L60-L96","documentation":"The `Error::NotFound` variant, wrapping a boxed `ServerError<NotFound>` and displayed with no additional prefix (`{0}`). Raised when the requested resource does not exist on the server, mirroring gRPC's NOT_FOUND status; the NotFound detail carries specifics.","triggerScenarios":"Any API call referencing a non-existent resource: querying a missing table/database/namespace, fetching an unknown object by identifier, deleting an entity that was never created or already removed.","commonSituations":"Typos in table or database names, querying against the wrong environment/server, resource deleted by another process or retention policy, casing mismatches in identifiers.","solutions":["Read the wrapped NotFound detail to see exactly which resource was not found.","Verify the resource name/identifier against the server (list tables/namespaces first).","Confirm you are pointing at the intended server/environment and connection config.","Create the resource if it should exist before issuing operations against it."],"exampleFix":"// before\nclient.table(\"metricz\").await?; // typo, server has \"metrics\"\n// after\nlet name = \"metrics\";\nif !client.list_tables().await?.iter().any(|t| t == name) {\n    return Err(format!(\"table {name} does not exist\").into());\n}\nclient.table(name).await?;","handlingStrategy":"validation","validationCode":"async fn ensure_exists(client: &Client, table: &str) -> Result<(), Error> {\n    if !client.list_tables().await?.contains(&table.to_string()) {\n        return Err(Error::from(format!(\"table {table} missing\")));\n    }\n    Ok(())\n}","typeGuard":"fn is_not_found(e: &Error) -> bool { matches!(e, Error::NotFound(_)) }","tryCatchPattern":"match result {\n    Err(Error::NotFound(se)) => { eprintln!(\"missing resource: {se}\"); Err(anyhow!(\"not found: {se}\")) }\n    other => other,\n}","preventionTips":["Look up resources (list tables/namespaces) before referencing them by name.","Centralize resource-name constants to avoid typos across codebases.","Tag environments/connections so you never query the wrong server."],"tags":["grpc","not-found","influxdb"],"backgroundTag":"resource-not-found","analyzedSha":"06200ef96ba82c5f6727e5038a83af8e722c6875","analyzedAt":"2026-09-19T12:55:30.003Z","contentChangedAt":"2026-09-19T12:55:30.003Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}