使用 ARN、接入点别名或虚拟托管式 URI 来引用接入点

创建连接到 FSx for ONTAP 卷的接入点后，您可以通过 AWS CLI 和 S3 API 以及第三方 S3-compatible AWS 服务和应用程序访问您的数据。在 AWS 服务或应用程序中提及接入点时，您可以使用 Amazon 资源名称 (ARN)、接入点别名或虚拟托管样式 URI。

主题

接入点 ARN
接入点别名
Virtual-hosted—style URI

接入点 ARN

接入点具有 Amazon Resource Name（ARN）。接入点 ARN 与 S3 存储桶 ARN 类似，但它们是显式键入的，并对接入点 AWS 区域和接入点所有者的 AWS 账户 ID 进行编码。有关 ARN 的更多信息，请参阅AWS Identity and Access Management 用户指南中的使用 Amazon 资源名称 (ARN) 识别 AWS 资源。

接入点 ARN 的格式如下：


arn:aws::s3:region:account-id:accesspoint/resource

arn:aws:s3:us-west-2:777777777777:accesspoint/test代表名为的接入点test，该接入点归该地区账户 7777777777 所有。us-west-2

通过接入点访问的对象和文件的 ARN 使用以下格式：


arn:aws::s3:region:account-id:accesspoint/access-point-name/object/resource

arn:aws:s3:us-west-2:111122223333:accesspoint/test/object/lions.jpg表示通过名为的接入点访问的文件 lions.jpgtest，该接入点归该地区账户 111122223333 所有。us-west-2

有关接入点 ARN 的更多信息，请参阅 A mazon 简单存储服务用户指南中的接入点 ARN。

接入点别名

创建接入点时，Amazon S3 会自动生成一个接入点别名，您可以在任何可以使用 S3 存储桶名称访问数据的地方使用该别名。

接入点别名无法更改。对于连接到 FSx for ONTAP 卷的接入点，接入点别名由以下部分组成：


access point prefix-metadata-ext-s3alias

下图显示了连接到 FSx for ONTAP 卷的 S3 接入点的 ARN 和接入点别名，这些接入点作为对 FSx CLI 命令的响应的一部分返回。describe-s3-access-point-attachments本示例中的接入点名为my-ontap-ap。


...
        "S3AccessPoint": {
            "ResourceARN": "arn:aws:s3:us-east-1:111122223333:accesspoint/my-ontap-ap",
            "Alias": "my-ontap-ap-aqfqprnstn7aefdfbarligizwgyfouse1a-ext-s3alias",
...

注意

该-ext-s3alias后缀保留给连接到 FSx for ONTAP 卷的 S3 接入点的别名，不能用于接入点名称。

在某些 S3 数据平面操作中，您可以使用接入点别名代替 Amazon S3 接入点 ARN。有关支持的操作的列表，请参阅接入点兼容性。

有关完整的接入点别名限制，请参阅《Amazon 简单存储服务用户指南》中的接入点别名限制。

Virtual-hosted—style URI

访问点仅支持虚拟主机式寻址。在虚拟托管式的 URI 中，接入点名称和 AWS 区域是 URL 中域名的一部分。 AWS 账户要查看连接到 FSx for ONTAP 卷的接入点的 S3 URI，请在 S3 接入点详细信息下的接入点详细信息页面中，选择为 S3 接入点列出的接入点名称。这将带您进入 Amazon S3 控制台中的接入点详细信息页面。您可以在 “属性” 下找到 S3 URI。

有关更多信息，请参阅《亚马逊简单存储服务用户指南》中的 Virtual-hosted—style URI。

文档惯例

命名规则、限制和局限性

接入点兼容性