# 创建带有标签的接入点
<a name="access-points-create-tag"></a>

可以在创建接入点时为其添加标签。在超过标准 S3 API 请求速率的接入点上使用标签无需额外付费。有关更多信息，请参阅 [Amazon S3 定价](https://docs.amazonaws.cn/s3/pricing/)。有关为接入点添加标签的更多信息，请参阅[将标签与通用存储桶的 S3 接入点结合使用](access-points-tagging.md)。

## 权限
<a name="access-points-create-tag-permissions"></a>

要创建带有标签的接入点，您必须具有以下权限：
+ `s3:CreateBucket`
+ `s3:TagResource`

## 错误故障排除
<a name="access-points-create-tag-troubleshooting"></a>

如果在尝试创建带有标签的接入点时遇到错误，可以执行以下操作：
+ 确认您具备创建接入点并向其添加标签所需的[权限](#access-points-create-tag-permissions)。
+ 检查 IAM 用户策略，了解是否存在任何基于属性的访问权限控制（ABAC）条件。您可能需要仅使用特定的标签键和值来标记接入点。有关更多信息，请参阅 [使用标签进行基于属性的访问权限控制（ABAC）](tagging.md#using-tags-for-abac)。

## Steps
<a name="access-points-create-tag-steps"></a>

可以使用 Amazon S3 控制台、Amazon Command Line Interface（Amazon CLI）、Amazon S3 REST API 和 Amazon SDK 来创建应用了标签的接入点。

## 使用 S3 控制台
<a name="access-points-create-tag-console"></a>

要使用 Amazon S3 控制台创建带有标签的接入点：

1. 登录到 Amazon S3 控制台，网址为：[https://console.aws.amazon.com/s3/](https://console.amazonaws.cn/s3/)。

1. 在左侧导航窗格中，选择**接入点（通用存储桶）**。

1. 选择**创建接入点**以创建新的接入点。

1. 在**创建接入点**页面上，**标签**是创建新接入点时的一个选项。

1. 输入接入点的名称。有关更多信息，请参阅 [接入点命名规则、限制和局限性](access-points-restrictions-limitations-naming-rules.md)。

1. 选择**添加新标签**以打开**标签**编辑器并输入标签键值对。标签键是必需的，但值是可选的。

1. 要添加其它标签，请再次选择**添加新标签**。最多可输入 50 个标签键值对。

1. 完成为新的接入点指定选项后，选择**创建接入点**。

## 使用 Amazon SDK
<a name="access-points-create-tag-sdks"></a>

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

此示例说明如何使用Amazon SDK for Java 2.x 创建带有标签的接入点。要使用该命令，请将{{用户输入占位符}} 替换为您自己的信息。

```
CreateAccessPointRequest createAccessPointRequest = CreateAccessPointRequest.builder()
                .accountId({{111122223333}})
                .name({{{{my-access-point}}}})
                .bucket({{{{amzn-s3-demo-bucket}}}})
                .tags(Collections.singletonList(Tag.builder().key("{{key1}}").value("{{value1}}").build()))
                .build();
 awss3Control.createAccessPoint(createAccessPointRequest);
```

------

## 使用 REST API
<a name="access-points-tag-delete-api"></a>

有关 Amazon S3 REST API 支持创建带有标签的接入点的信息，请参阅《Amazon Simple Storage Service API Reference》**中的以下部分：
+ [CreateAccessPoint](https://docs.amazonaws.cn/AmazonS3/latest/API/API_control_CreateAccessPoint.html)

## 使用 Amazon CLI
<a name="access-points-create-tag-cli"></a>

要安装 Amazon CLI，请参阅《Amazon Command Line Interface 用户指南》**中的[安装 Amazon CLI](https://docs.amazonaws.cn/cli/latest/userguide/getting-started-install.html)。

以下 CLI 示例说明如何使用 Amazon CLI 创建带有标签的接入点。要使用该命令，请将{{用户输入占位符}} 替换为您自己的信息。

**请求**

```
aws s3control create-access-point --name {{{{my-access-point}}}} \
--bucket {{{{amzn-s3-demo-bucket}}}} \
--account-id {{111122223333}} \ --profile personal \
--tags [{Key={{key1}},Value={{value1}}},{Key={{key2}},Value={{value2}}}] \
--region {{region}}
```