# Determinar se você pode acessar um bucket de diretório
<a name="directory-buckets-objects-HeadExamples"></a>

Os exemplos de AWS SDK a seguir mostram como usar a operação de API `HeadBucket` para determinar se existe um bucket de diretório do Amazon S3 e se você tem permissão para acessá-lo. 

## Usar SDKs da AWS
<a name="directory-bucket-copy-sdks"></a>

O exemplo a seguir para AWS SDK for Java 2.x mostra como determinar se um bucket existe e se você tem permissão para acessá-lo. 

------
#### [ SDK for Java 2.x ]

**Example**  
 AWS SDK for Java 2.x   

```
public static void headBucket(S3Client s3Client, String bucketName) {
   try {
        HeadBucketRequest headBucketRequest = HeadBucketRequest
                .builder()
                .bucket(bucketName)
                .build();
        s3Client.headBucket(headBucketRequest);
        System.out.format("Amazon S3 bucket: \"%s\" found.", bucketName);
   }

   catch (S3Exception e) {
       System.err.println(e.awsErrorDetails().errorMessage());
       System.exit(1);
   }
}
```

------

## Como usar o AWS CLI
<a name="directory-head-bucket-cli"></a>

O exemplo de comando `head-bucket` a seguir mostra como é possível usar a AWS CLI para determinar se um bucket de diretório existe e se você tem permissão para acessá-lo. Para executar esse comando, substitua os espaços reservados de entrada por suas próprias informações.

```
aws s3api head-bucket --bucket bucket-base-name--zone-id--x-s3 
```

Para ter mais informações, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-bucket.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/head-bucket.html) na *Referência de comandos da AWS CLI*.