# 通过通用存储桶的接入点下载对象
<a name="get-object-ap"></a>

本节介绍如何使用 AWS 管理控制台、AWS Command Line Interface或 REST API 通过通用存储桶的接入点下载对象。

## 使用 S3 控制台
<a name="get-object-ap-console"></a>

**在 AWS 账户中通过接入点下载对象。**

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

1. 在页面顶部的导航栏中，选择当前所显示 AWS 区域的名称。接下来，选择要列出其接入点的区域。

1. 在控制台左侧的导航窗格中，选择**接入点**。

1. （可选）按名称搜索接入点。只有您选择的 AWS 区域中的接入点才会出现在此处。

1. 选择要管理或使用的接入点的名称。

1. 在**对象**选项卡下，选择要下载的对象的名称。

1. 选择**下载**。

## 使用 AWS CLI
<a name="get-object-ap-cli"></a>

以下 `get-object` 示例命令显示了如何使用 AWS CLI 通过接入点下载对象。

以下命令使用接入点 {{my-access-point}} 下载 AWS 账户 {{111122223333}} 的对象 `puppy.jpg`。您必须包含 `outfile`，这是已下载对象的文件名，例如 `{{my_downloaded_image.jpg}}`。

```
aws s3api get-object --bucket arn:aws:s3:{{AWS 区域}}:111122223333:accesspoint/{{my-access-point}} --key puppy.jpg {{my_downloaded_image.jpg}}      
```

**注意**  
S3 会自动为所有接入点生成接入点别名，这些别名可以在任何使用存储桶名称来执行对象级操作的地方使用。有关更多信息，请参阅 [接入点别名](access-points-naming.md#access-points-alias)。

有关更多信息和示例，请参阅《AWS CLI 命令参考》**中的 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html)。

## 使用 REST API
<a name="get-object-ap-rest"></a>

您可以使用 REST API 通过接入点下载对象。有关更多信息，请参阅《Amazon Simple Storage Service API 参考》**中的 [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)。

## 使用 AWS SDK
<a name="download-object-ap-SDKs"></a>

可以使用适用于 Python 的 AWS SDK 通过接入点下载对象。

------
#### [ Python ]

在以下示例中，使用名为 {{my-access-point}} 的接入点为 AWS 账户 {{111122223333}} 下载名为 `{{hello.txt}}` 的文件。

```
import boto3
s3 = boto3.client('s3')
s3.download_file('arn:aws:s3:{{us-east-1}}:{{111122223333}}:accesspoint/{{my-access-point}}', '{{hello.txt}}', '{{/tmp/hello.txt}}')
```

------