{"record":{"id":"3b99f3f3dbc097f0","repo":"apache/hadoop","slug":"access-points-usage-is-required-but-not-configured","errorCode":null,"errorMessage":"Access Points usage is required but not configured for the bucket.","messagePattern":"Access Points usage is required but not configured for the bucket\\.","errorType":"exception","errorClass":"PathIOException","httpStatus":null,"severity":"error","filePath":"hadoop-tools/hadoop-aws/src/main/java/org/apache/hadoop/fs/s3a/S3AFileSystem.java","lineNumber":605,"sourceCode":"        LOG.trace(\"Filesystem for {} created; fs.s3a.impl.disable.cache = {}\",\n            name, originalConf.getBoolean(\"fs.s3a.impl.disable.cache\", false),\n            new RuntimeException(super.toString()));\n      }\n      // clone the configuration into one with propagated bucket options\n      Configuration conf = propagateBucketOptions(originalConf, bucket);\n      // HADOOP-17894. remove references to s3a stores in JCEKS credentials.\n      conf = ProviderUtils.excludeIncompatibleCredentialProviders(\n          conf, S3AFileSystem.class);\n      String arn = String.format(ARN_BUCKET_OPTION, bucket);\n      String configuredArn = conf.getTrimmed(arn, \"\");\n      if (!configuredArn.isEmpty()) {\n        accessPoint = ArnResource.accessPointFromArn(configuredArn);\n        LOG.info(\"Using AccessPoint ARN \\\"{}\\\" for bucket {}\", configuredArn, bucket);\n        bucket = accessPoint.getFullArn();\n      } else if (conf.getBoolean(AWS_S3_ACCESSPOINT_REQUIRED, false)) {\n        LOG.warn(\"Access Point usage is required because \\\"{}\\\" is enabled,\" +\n            \" but not configured for the bucket: {}\", AWS_S3_ACCESSPOINT_REQUIRED, bucket);\n        throw new PathIOException(bucket, AP_REQUIRED_EXCEPTION);\n      }\n\n      // fix up the classloader of the configuration to be whatever\n      // classloader loaded this filesystem.\n      // See: HADOOP-17372 and follow-up on HADOOP-18993\n      S3AUtils.maybeIsolateClassloader(conf, this.getClass().getClassLoader());\n\n      // patch the Hadoop security providers\n      patchSecurityCredentialProviders(conf);\n      // look for delegation token support early.\n      boolean delegationTokensEnabled = hasDelegationTokenBinding(conf);\n      if (delegationTokensEnabled) {\n        LOG.debug(\"Using delegation tokens\");\n      }\n      // set the URI, this will do any fixup of the URI to remove secrets,\n      // canonicalize.\n      setUri(name, delegationTokensEnabled);\n      super.initialize(uri, conf);","sourceCodeStart":587,"sourceCodeEnd":623,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-tools/hadoop-aws/src/main/java/org/apache/hadoop/fs/s3a/S3AFileSystem.java#L587-L623","documentation":"Error \"Access Points usage is required but not configured for the bucket.\" thrown in apache/hadoop.","triggerScenarios":"Thrown at hadoop-tools/hadoop-aws/src/main/java/org/apache/hadoop/fs/s3a/S3AFileSystem.java:605 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Configure the access point for the bucket via fs.s3a.bucket.<bucket>.accesspoint.arn, or disable fs.s3a.accesspoint.required."],"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-23T01:17:44.959Z"}