{"record":{"id":"c8fec4855d1f2bec","repo":"apache/hadoop","slug":"invalid-snapshot-name","errorCode":null,"errorMessage":"Invalid snapshot name: {}","messagePattern":"Invalid snapshot name: (.+?)","errorType":"exception","errorClass":"InvalidPathException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/FSDirSnapshotOp.java","lineNumber":109,"sourceCode":"   * @param pc FS permission checker\n   * @param snapshotRoot The directory path where the snapshot is taken\n   * @param snapshotName The name of the snapshot\n   * @param logRetryCache whether to record RPC ids in editlog for retry cache\n   *                      rebuilding.\n   */\n  static String createSnapshot(\n      FSDirectory fsd, FSPermissionChecker pc, SnapshotManager snapshotManager,\n      String snapshotRoot, String snapshotName, boolean logRetryCache)\n      throws IOException {\n    final INodesInPath iip = fsd.resolvePath(pc, snapshotRoot, DirOp.WRITE);\n    if (fsd.isPermissionEnabled()) {\n      fsd.checkOwner(pc, iip);\n    }\n\n    if (snapshotName == null || snapshotName.isEmpty()) {\n      snapshotName = Snapshot.generateDefaultSnapshotName();\n    } else if (!DFSUtil.isValidNameForComponent(snapshotName)) {\n      throw new InvalidPathException(\"Invalid snapshot name: \" + snapshotName);\n    }\n\n    String snapshotPath;\n    verifySnapshotName(fsd, snapshotName, snapshotRoot);\n    // time of snapshot creation\n    final long now = Time.now();\n    fsd.writeLock();\n    try {\n      snapshotPath = snapshotManager.createSnapshot(\n          fsd.getFSNamesystem().getLeaseManager(),\n          iip, snapshotRoot, snapshotName, now);\n    } finally {\n      fsd.writeUnlock();\n    }\n    fsd.getEditLog().logCreateSnapshot(snapshotRoot, snapshotName,\n        logRetryCache, now);\n    LOG.info(\"Created Snapshot for SnapshotRoot {}\", snapshotRoot);\n    return snapshotPath;","sourceCodeStart":91,"sourceCodeEnd":127,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/FSDirSnapshotOp.java#L91-L127","documentation":"Error \"Invalid snapshot name: {}\" thrown in apache/hadoop.","triggerScenarios":"Creating a snapshot with a name that is null, empty, '.', '..', or otherwise not a valid snapshot name.","commonSituations":"See trigger scenarios.","solutions":["Provide a valid, non-empty snapshot name that is not '.' or '..' and contains no path separators."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2add9630210752f88ceb1bb74eb65e37bf41da8e","analyzedAt":"2026-08-22T19:55:07.957Z","schemaVersion":2},"datasetVersion":"2026-08-22T20:17:22.307Z"}