

# 创建带有标签的向量索引
<a name="creating-vector-indexes-with-tags"></a>

您可以在创建 Amazon S3 向量索引时为其添加标签。在向量索引上使用标签时，除了标准 S3 API 请求费率之外，没有任何其他费用。有关更多信息，请参阅 [Amazon S3 定价](https://www.amazonaws.cn/s3/pricing/)。有关为向量索引添加标签的更多信息，请参阅[将标签与 S3 向量索引结合使用](vector-index-tagging.md)。

## 权限
<a name="index-tags-permissions"></a>

要创建带有标签的向量索引，您必须具有以下权限：
+ `s3vectors:CreateIndex`
+ `s3vectors:TagResource`

## 错误故障排除
<a name="index-tags-troubleshooting"></a>

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

## Steps
<a name="index-tags-steps"></a>

您可以使用 Amazon S3 控制台、Amazon Command Line Interface（Amazon CLI）、Amazon S3 REST API 和 Amazon SDK 来创建应用了标签的向量索引。

### 使用 S3 控制台
<a name="index-tags-console"></a>

**使用 Amazon S3 控制台创建带有标签的向量索引**

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

1. 在左侧导航窗格中，选择**向量索引**。

1. 选择**创建向量索引**以创建新的向量索引。

1. 像往常一样创建一个向量索引；请参阅[在向量存储桶中创建向量索引](s3-vectors-create-index.md)。

1. 在**创建向量索引**页面上，**标签**是创建新向量索引时的一个选项。

1. 输入向量索引的名称。

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

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

1. 在您完成为新的向量索引指定选项后，选择**创建向量索引**。

### 使用 REST API
<a name="index-tags-api"></a>

有关 Amazon S3 REST API 支持创建带有标签的向量索引的相关信息，请参阅《Amazon S3 Vectors API 参考》**中的以下部分：

[CreateIndex](https://docs.amazonaws.cn/AmazonS3/latest/API/API_S3VectorBuckets_CreateIndex.html)

### 使用 Amazon CLI
<a name="index-tags-cli"></a>

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

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

创建向量索引时，必须提供配置详细信息并使用以下命名约定：`example-vector-index`

```
aws s3vectors create-index --vector-bucket-name {{acc-bucket}} --data-type "float32" \
 --index-name {{accounts-index}} --dimension 1024 --distance-metric euclidean \
 --tags {{Department}}={{Accounting}},{{Stage}}={{Prod}}
```