# 列出目录存储桶
<a name="directory-buckets-objects-ListExamples"></a>

以下示例显示如何使用 Amazon Web Services 管理控制台、Amazon SDK 和 Amazon CLI 列出目录存储桶。

## 使用 S3 控制台
<a name="directory-bucket-list-console"></a>

1. 登录到 Amazon Web Services 管理控制台，然后通过以下网址打开 Amazon S3 控制台：[https://console.aws.amazon.com/s3/](https://console.amazonaws.cn/s3/)。

1. 在页面顶部的导航栏中，选择当前所显示 Amazon Web Services 区域的名称。接下来，选择要在其中查看目录存储桶列表的区域。

1. 在左侧导航窗格中，选择**目录存储桶**。将显示目录存储桶列表。要查看存储桶中的对象、存储桶属性、存储桶权限、指标、与存储桶关联的接入点，或者要管理存储桶，请选择存储桶名称。

## 使用 Amazon SDK
<a name="directory-bucket-list-sdks"></a>

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

**Example**  
下面的示例通过使用 Amazon SDK for Java 2.x 列出目录桶。  

```
 public static void listBuckets(S3Client s3Client) {
        try {
            ListDirectoryBucketsRequest listDirectoryBucketsRequest = ListDirectoryBucketsRequest.builder().build();
            ListDirectoryBucketsResponse response = s3Client.listDirectoryBuckets(listDirectoryBucketsRequest);
            if (response.hasBuckets()) {
                for (Bucket bucket: response.buckets()) {
                    System.out.println(bucket.name());
                    System.out.println(bucket.creationDate());
                }
            }
        } 
        
        catch (S3Exception e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }
    }
```

------
#### [ SDK for Python ]

**Example**  
下面的示例通过使用 适用于 Python (Boto3) 的 Amazon SDK 列出目录桶。  

```
import logging
import boto3
from botocore.exceptions import ClientError
                                       
def list_directory_buckets(s3_client):
'''
Prints a list of all directory buckets in a Region
                                           
:param s3_client: boto3 S3 client                                         
:return: True if there are buckets in the Region, else False
'''
try:
    response = s3_client.list_directory_buckets()
    for bucket in response['Buckets']:
        print (bucket['Name'])
except ClientError as e:
    logging.error(e)
    return False
return True
                                          
                                          
if __name__ == '__main__': 
    region = 'us-east-1'
    s3_client = boto3.client('s3', region_name = region)
    list_directory_buckets(s3_client)
```

------
#### [ 适用于 .NET 的 Amazon SDK ]

**Example**  
下面的示例通过使用 适用于 .NET 的 Amazon SDK 列出目录桶。  

```
var listDirectoryBuckets = await amazonS3Client.ListDirectoryBucketsAsync(new ListDirectoryBucketsRequest
{
  MaxDirectoryBuckets = 10
  }).ConfigureAwait(false);
```

------
#### [ SDK for PHP ]

**Example**  
下面的示例通过使用 适用于 PHP 的 Amazon SDK 列出目录桶。  

```
require 'vendor/autoload.php';

$s3Client = new S3Client([
    'region'      => 'us-east-1',
]);
$result = $s3Client->listDirectoryBuckets();
```

------
#### [ SDK for Ruby ]

**Example**  
下面的示例通过使用 适用于 Ruby 的 Amazon SDK 列出目录桶。  

```
s3 = Aws::S3::Client.new(region:'us-west-1')
s3.list_directory_buckets
```

------

## 使用 Amazon CLI
<a name="list-directory-buckets-cli"></a>

以下 `list-directory-buckets` 示例命令显示如何使用 Amazon CLI 列出 *us-east-1* 区域中的目录存储桶。要运行此命令，请将 `user input placeholders` 替换为您自己的信息。

```
aws s3api list-directory-buckets --region us-east-1 
```

有关更多信息，请参阅《Amazon CLI Command Reference》**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-directory-buckets.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-directory-buckets.html)。