Note: this is not designed to duplicate the exact checks that GCS would perform on the\n * server side. We make some checks that are relevant to using GCS as a file system.\n *\n * @param bucketName Bucket name to check.\n */\n static String validateBucketName(String bucketName) {\n // If the name ends with '/', remove it.\n bucketName = toFilePath(bucketName);\n\n if (isNullOrEmpty(bucketName)) {\n throw new IllegalArgumentException(\"GCS bucket name cannot be empty.\");\n }\n\n if (!BUCKET_NAME_CHAR_MATCHER.matchesAllOf(bucketName)) {\n throw new IllegalArgumentException(String.format(\n \"Invalid GCS bucket name '%s': bucket name must contain only 'a-z0-9_.-' characters.\",\n bucketName));\n }\n\n return bucketName;\n }\n\n /**\n * Validate the given object name to make sure that it can be used as a part of a file system\n * path.\n *\n *
Note: this is not designed to duplicate the exact checks that GCS would perform on the\n * server side. We make some checks that are relevant to using GCS as a file system.\n *","sourceCodeStart":40,"sourceCodeEnd":76,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-cloud-storage-project/hadoop-gcp/src/main/java/org/apache/hadoop/fs/gs/StringPaths.java#L40-L76","documentation":"StringPaths.validateBucketName (reached via StorageResourceId.fromUriPath) rejects an empty bucket name: after stripping any trailing '/', the authority must be non-empty. This means the supplied gs URI has no bucket - e.g. 'gs://', 'gs:/path', or 'gs:///key'.","triggerScenarios":"fromUriPath on a URI whose authority is null/empty: 'gs:///object', 'gs://', or a URI built with String.format where the bucket variable was null or empty.","commonSituations":"Building gs:// URIs by string concatenation with an unset bucket config/variable; paths from configs missing the authority; URI parsing that drops the authority component (e.g. resolve() edge cases).","solutions":["Always include the bucket as the URI authority: gs://