本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 向量索引
<a name="s3-vectors-indexes"></a>

**注意**  
請仔細選擇向量索引組態參數。建立向量索引後，便無法更新向量索引名稱、維度、距離指標，或無法篩選的中繼資料索引鍵。若要變更這些值，則必須建立新的向量索引。

向量索引是向量儲存貯體中的資源，其儲存和組織向量資料以用於進行有效率的相似度搜尋作業。您在建立向量索引時，可以指定距離指標 (`Cosine` 或 `Euclidean`)、向量應有的維度，以及您想要在相似度查詢期間，從篩選條件中排除的中繼資料欄位清單。

如需有關每個儲存貯體的向量索引限制、每個索引的向量限制和每個向量的維度限制的詳細資訊，請參閱 [限制](s3-vectors-limitations.md)。

每個向量版本都有唯一的 Amazon Resource Name (ARN)。向量索引的 ARN 遵循下列格式：

```
arn:aws:s3vectors:region:account-id:bucket/bucket-name/index/index-name
```

## 向量索引命名要求
<a name="s3-vectors-indexes-naming"></a>
+ 向量索引名稱在向量儲存貯體中必須是唯一的。
+ 向量索引名稱長度必須介於 3 到 63 個字元之間。
+ 有效字元為小寫字母 (a-z)、數字 (0-9)、連字號 (-) 和點 (.)。
+ 向量索引名稱的開頭和結尾必須為字母或數字。

## 維度要求
<a name="s3-vectors-indexes-dimensions"></a>

維度是向量中值的數目。新增至索引的所有向量，必須完全具有此數量的值。
+ 維度必須是介於 1 到 4096 之間的整數。
+ 較大的維度需要更多的儲存空間。

## 距離指標選項
<a name="s3-vectors-indexes-distance-metrics"></a>

距離指標：指定向量之間的相似度計算方式：建立向量嵌入時，請選擇嵌入模型的建議距離指標，以獲得更準確的結果。
+ **餘弦** - 測量向量之間角度的餘弦。標準化向量以及當方向比大小重要時的最佳選擇
+ **歐氏幾何** - 測量向量之間的直線距離。當方向和大小都很重要時的最佳選擇。

## 不可篩選的中繼資料索引鍵
<a name="s3-vectors-indexes-metadata"></a>

中繼資料索引鍵可讓您在儲存和擷取期間，以鍵值對的形式將其他資訊連接至向量。根據預設，所有中繼資料都可篩選，因此您可以用它來篩選查詢結果。不過，當您想要將資訊與向量一起儲存，而不用於篩選時，您可以將特定中繼資料索引鍵指定為不可篩選。

不同於預設中繼資料索引鍵，這些金鑰無法用作查詢篩選條件。不可篩選的中繼資料索引鍵可以擷取，但無法搜尋、查詢或篩選。您只能在找到索引後，再進行存取。

不可篩選的中繼資料索引鍵可讓您使用您想要透過搜尋結果進行擷取，但不需要篩選的其他上下文，使向量的內容更加充實。不可篩選中繼資料索引鍵的常見範例是，當您將文字嵌入向量，並且想要將原始文字本身包含為不可篩選的中繼資料時。這可在向量搜索結果中傳回來源文字，而不會增加可篩選的中繼資料大小限制。其他範例包括僅儲存建立時間戳記、來源 URL 或描述性資訊，這些純供參考。擷取向量時可以存取不可篩選的中繼資料索引鍵，但不同於預設中繼資料索引鍵，這些索引鍵不可用作查詢篩選條件。

不可篩選中繼資料索引鍵的要求，如下所示。
+ 不可篩選的中繼資料索引鍵在向量索引中必須是唯一的。
+ 不可篩選的中繼資料索引鍵長度必須介於 1 到 63 個字元。
+ 建立向量索引後，就無法修改不可篩選的中繼資料索引鍵。
+ S3 Vectors 支援每個索引最多 10 個不可篩選的中繼資料索引鍵。

如需不可篩選中繼資料索引鍵的詳細資訊，請參閱 [不可篩選的中繼資料](s3-vectors-metadata-filtering.md#s3-vectors-metadata-filtering-non-filterable)。

**Topics**
+ [向量索引命名要求](#s3-vectors-indexes-naming)
+ [維度要求](#s3-vectors-indexes-dimensions)
+ [距離指標選項](#s3-vectors-indexes-distance-metrics)
+ [不可篩選的中繼資料索引鍵](#s3-vectors-indexes-metadata)
+ [在向量儲存貯體中建立向量索引](s3-vectors-create-index.md)
+ [列出向量索引](s3-vectors-index-list.md)
+ [刪除向量索引](s3-vectors-index-delete.md)
+ [搭配 S3 向量索引使用標籤](vector-index-tagging.md)

# 在向量儲存貯體中建立向量索引
<a name="s3-vectors-create-index"></a>

**注意**  
請仔細選擇向量索引組態參數。建立向量索引後，便無法更新向量索引名稱、維度、距離指標，或無法篩選的中繼資料索引鍵。若要變更這些值，則必須建立新的向量索引。

向量索引是向量儲存貯體內的資源，可儲存和組織向量資料以進行有效的相似度搜尋。建立向量索引時，您可以定義該索引中所有向量必須共用的特性，例如維度、用於相似度計算的距離指標，以及選用之不可篩選的中繼資料索引鍵。您也可以選擇性地在建立索引時設定向量索引的專用加密設定和標籤。如需有關向量索引命名要求、維度要求、距離指標選項和不可篩選中繼資料索引鍵的詳細資訊，請參閱 [限制](s3-vectors-limitations.md)。如需設定向量索引加密組態的詳細資訊，請參閱 [S3 Vectors 中的資料保護和加密](s3-vectors-data-encryption.md)。如需設定標籤的詳細資訊，請參閱 [搭配 S3 向量儲存貯體使用標籤](s3-vectors-tags.md)。

 向量索引必須在現有的向量儲存貯體內建立，而且需要在建立後便無法修改的特定組態參數。

## 使用 S3 主控台
<a name="s3-vectors-create-index-console"></a>

**建立向量索引**

1. 開啟位於 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 的 Amazon S3 主控台。

1. 在導覽窗格中，選擇**向量儲存貯體**。

1. 在向量儲存貯體清單中，選擇您要建立向量索引的儲存貯體名稱。

1. 選擇**建立向量索引**。

1. 針對**向量索引名稱**，輸入向量索引的名稱。

   向量索引名稱在向量儲存貯體中必須是唯一的。索引名稱長度必須介於 3 到 63 個字元之間。有效字元為小寫字母 (a-z)、數字 (0-9)、連字號 (-) 和點 (.)。如需向量索引命名要求的詳細資訊，請參閱 [限制](s3-vectors-limitations.md)。

1. 針對**維度**，輸入每個向量中的值數目。
**注意**  
**維度**的值決定了每個向量將包含的數值。
新增至此索引的所有向量，必須具有此數目的值。
維度必須介於 1 到 4096 之間。
較大的維度需要更多的儲存空間。
根據您的嵌入模型輸出維度做選擇。

   如需有關維度要求的詳細資訊，請參閱 [限制](s3-vectors-limitations.md)。

1. 針對**距離指標**，選擇以下其中一個選項：
   + **餘弦** - 測量向量之間角度的餘弦。標準化向量以及當方向比大小重要時的最佳選擇
   + **歐氏幾何** - 測量向量之間的直線距離。當方向和大小都很重要時的最佳選擇。

1. (選用) 在**不可篩選的中繼資料**下，設定要儲存但不用於篩選的中繼資料索引鍵：

   新增不可篩選的中繼資料索引鍵：

   1. 選擇 **Add key (新增金鑰)**。

   1. 輸入索引鍵名稱 (1-63 個字元，是此向量索引中的唯一)。

   1. 重複以新增其他索引鍵 (最多 10 個索引鍵)。
**注意**  
當您在建立向量索引後插入向量資料，可以將可篩選的中繼資料以鍵值對形式連接至每個向量。根據預設，連接至向量的所有中繼資料索引鍵都是可篩選的，並且可以當作相似度查詢中的篩選條件。只有在向量索引建立期間指定為不可篩選的中繼資料索引鍵，才會排除在篩選範圍外。如需每個向量中繼資料大小限制 (包括總中繼資料限制和可篩選中繼資料限制) 的詳細資訊，請參閱 [限制](s3-vectors-limitations.md)。

1. 仔細檢閱您的組態。
**注意**  
這些設定在建立後便無法變更。

1. 在**加密**下，選擇**指定加密類型**。您可以選擇**使用儲存貯體設定進行加密**，或覆寫向量索引的加密設定。如果您覆寫儲存貯體層級設定，您可以選擇將向量索引的加密類型指定為**使用 AWS Key Management Service 金鑰 (SSE-KMS) 的伺服器端加密**，或使用 **Amazon S3 受管金鑰 (SSE-S3) 的伺服器端加密**。如需設定向量索引加密組態的詳細資訊，請參閱 [S3 Vectors 中的資料保護和加密](s3-vectors-data-encryption.md)。

1. 在**標籤 （選用）** 下，您可以將標籤新增為鍵值對，以協助使用 AWS Billing and Cost Management 追蹤和組織向量索引成本。輸入 **Key (索引鍵)** 和 **Value (數值)**。若要新增其他標籤，選擇 **Add Tag (新增標籤)**。您可以為向量索引輸入最多 50 個標籤。如需詳細資訊，請參閱[搭配 S3 向量儲存貯體使用標籤](s3-vectors-tags.md)。

1. 選擇**建立向量索引**。

## 使用 AWS CLI
<a name="s3-vectors-create-index-cli"></a>

若要在向量儲存貯體中建立向量索引，請使用下列範例命令，並以您自己的資訊取代 `user input placeholders`。

**範例 1：使用不可篩選的中繼資料索引鍵建立向量索引**

```
aws s3vectors create-index \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx" \
  --data-type "float32" \
  --dimension 1 \
  --distance-metric "cosine" \
  --metadata-configuration '{"nonFilterableMetadataKeys":["nonFilterableKey1"]}'
```

**範例 2：建立不含不可篩選中繼資料索引鍵的向量索引**

```
aws s3vectors create-index \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx2" \
  --data-type "float32" \
  --dimension 4096 \
  --distance-metric "euclidean"
```

此外，使用 `GetVectors`、`ListVectors` 或 `QueryVectors` API 操作，以相同方式擷取所有中繼資料 (可篩選和不可篩選)。下列 CLI 命令示範如何擷取具有中繼資料 (包括不可篩選的中繼資料) 的向量。

範例請求：

```
aws s3vectors get-vectors \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx" \
  --keys '["vec1", "vec3"]' \
  --return-data \
  --return-metadata \
```

回應範例：

```
{
    "vectors": [
        {
            "key": "vec1",
            "data": {
                "float32": [
                    0.10000000149011612,
                    0.20000000298023224,
                    0.30000001192092896,
                    0.4000000059604645,
                    0.5
                ]
            },
            "metadata": {
                "category": "test",
                "text": "First vector"
            }
        },
        {
            "key": "vec3",
            "data": {
                "float32": [
                    0.6000000238418579,
                    0.699999988079071,
                    0.800000011920929,
                    0.8999999761581421,
                    1.0
                ]
            },
            "metadata": {
                "text": "Third vector",
                "category": "test"
            }
        }
    ]
}
```

回應內容包含與向量相關聯的所有中繼資料，無論其在建立索引期間是否指定為可篩選或不可篩選。

## 使用 AWS SDKs
<a name="s3-vectors-create-index-sdk"></a>

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

```
import boto3

# Create a S3 Vectors client in the AWS Region of your choice. 
s3vectors = boto3.client("s3vectors", region_name="us-west-2")

#Create a vector index "movies" in the vector bucket "media-embeddings" without non-filterable metadata keys
s3vectors.create_index(
    vectorBucketName="media-embeddings",
    indexName="movies",
    dimension=3,
    distanceMetric="cosine",
    dataType = "float32"
)


#Create a vector index "movies" in the vector bucket "media-embeddings" with non-filterable metadata keys
s3vectors.create_index(
    vectorBucketName="media-embeddings",
    indexName="movies",
    dimension=3,
    distanceMetric="cosine",
    dataType = "float32",
    metadataConfiguration= {"nonFilterableMetadataKeys": ["nonFilterableMetadataKey1"]}
)
```

------

# 列出向量索引
<a name="s3-vectors-index-list"></a>

您可以檢視向量儲存貯體中的所有向量索引。列表操作支援以字首為主的篩選，可協助您在存在許多索引的儲存貯體中尋找特定索引。如需有關 `ListIndexes`、字首限制和回應限制的詳細資訊，請參閱《Amazon Simple Storage Service API 參考》中的 [ListIndexes](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListIndexes.html)。

## 字首搜尋功能
<a name="s3-vectors-index-prefix-search-capability"></a>

字首搜尋功能可讓您列出以特定字首開頭的索引，讓您能更輕鬆地組織和尋找相關的向量索引。當您使用命名慣例將相關索引分在同一組時，這特別有用：
+ **依資料類型：**`text-embeddings-`、`image-features-`、`audio-vectors-`
+ **依模型：**`model1-embeddings-`、`model2-vectors-`、`custom-model-`
+ **依使用案例：**`search-index-`、`recommendation-`、`similarity-`
+ **依環境：**`prod-vectors-`、`staging-vectors-`、`dev-vectors-`

### 使用 S3 主控台
<a name="s3-vectors-index-list-console"></a>

**列出向量索引**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 開啟 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇**向量儲存貯體**。

1. 在向量儲存貯體清單中，選擇包含您要檢視之索引的儲存貯體名稱。

1. 主控台會顯示儲存貯體中所有向量索引的完整清單，包括：
   + **名稱** – 每個索引的名稱。
   + **建立日期** – 建立索引的時間。
   + **Amazon Resource Name (ARN)** – 每個索引的完整 ARN。

**篩選清單**

1. 在索引清單上方的搜尋方塊中，輸入索引名稱或字首。使用字首尋找相關索引的群組。

1. 清單會在您輸入時即時更新。

### 使用 AWS CLI
<a name="s3-vectors-list-cli"></a>

若要使用下列範例命令，請以您自己的資訊取代*使用者輸入預留位置*。

**列出向量儲存貯體中具有特定字首的索引**

範例請求：

```
aws s3vectors list-indexes \
  --vector-bucket-name "amzn-s3-demo-bucket" \
  --prefix "idx" \
  --max-results 1
```

回應範例：

```
{
    "nextToken": "lObb29ZkzxMGtBXs97Rkbs26xdtKemu4brsnq2jX8DCocADkILv5cRphemXS3PXXFnQBihQBmESgEeKaGA",
    "indexes": [
        {
            "vectorBucketName": "amzn-s3-demo-bucket",
            "indexName": "idx",
            "indexArn": "arn:aws:s3vectors:aws-region:111122223333:bucket/amzn-s3-demo-vector-bucket/index/idx",
            "creationTime": "2025-06-12T15:50:23+00:00"
        }
    ]
}
```

**列出使用分頁的索引**

範例請求：

```
aws s3vectors list-indexes \
  --vector-bucket-name "amzn-s3-demo-bucket" \
  --prefix "idx" \
  --next-token "lObb29ZkzxMGtBXs97Rkbs26xdtKemu4brsnq2jX8DCocADkILv5cRphemXS3PXXFnQBihQBmESgEeKaGA"
```

回應範例：

```
{
    "indexes": [
        {
            "vectorBucketName": "amzn-s3-demo-bucket",
            "indexName": "idx2",
            "indexArn": "arn:aws:s3vectors:aws-region:111122223333:bucket/amzn-s3-demo-vector-bucket/index/idx2",
            "creationTime": "2025-06-12T15:45:37+00:00"
        }
    ]
}
```

### 使用 AWS SDKs
<a name="s3-vectors-list-sdk"></a>

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

```
import boto3

# Create a S3 Vectors client in the AWS Region of your choice. 
s3vectors = boto3.client("s3vectors", region_name="us-west-2")

#List vector indexes in your vector bucket
response = s3vectors.list_indexes(vectorBucketName="media-embeddings")
indexes = response["indexes"]
print(indexes)
```

------

# 刪除向量索引
<a name="s3-vectors-index-delete"></a>

當您不再需要向量索引時，可以將其刪除。此操作會永久移除索引，及儲存在內部的所有向量。

**重要**  
刪除向量索引時，您需要知道下列事項：  
即使索引包含向量，您也可以刪除向量索引。
儲存在索引中的所有向量會永久刪除
與這些向量相關聯的所有中繼資料會永久遺失
操作無法復原或反轉
索引上任何進行中的操作都會立即失敗
查詢索引的應用程式會收到錯誤
索引名稱可在儲存貯體中重複使用

## 使用 AWS CLI
<a name="cli-delete-vector-index"></a>

刪除向量索引之前，請先驗證向量索引。如需如何檢查索引細節的詳細資訊，請參閱《Amazon S3 API 參考》**中的 [GetIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetIndex.html)。如需如何列出索引中向量以查看要刪除內容的詳細資訊，請參閱 [列出向量索引](s3-vectors-index-list.md)。

若要刪除向量索引，請使用下列範例命令。以您自己的資訊取代*使用者輸入預留位置*。

```
aws s3vectors delete-index --vector-bucket-name "amzn-s3-demo-vector-bucket" \
          --index-name "idx2"
```

如需如何驗證索引是否遭到刪除的詳細資訊，請參閱 [列出向量索引](s3-vectors-index-list.md)。

## 使用 AWS SDKs
<a name="sdk-delete-vector-index"></a>

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

```
import boto3

# Create a S3 Vectors client in the AWS Region of your choice. 
s3vectors = boto3.client("s3vectors", region_name="us-west-2")

#Delete a vector index
response = s3vectors.delete_index(
    vectorBucketName="media-embeddings",
    indexName="movies")
```

------

# 搭配 S3 向量索引使用標籤
<a name="vector-index-tagging"></a>

 AWS 標籤是金鑰值對，可保留資源的中繼資料，在此情況下為 Amazon S3 向量索引。您可以在建立 S3 向量索引或管理現有向量索引上的標籤時標記 S3 向量索引。如需有關標籤的一般資訊，請參閱 [成本分配或屬性型存取控制 (ABAC) 的標記](tagging.md)。

**注意**  
在超過標準 S3 API 請求率的向量索引上使用標籤不會產生額外費用。如需詳細資訊，請參閱 [Simple Storage Service (Amazon S3) 定價](https://aws.amazon.com/s3/pricing/)。

## 搭配向量索引使用標籤的常見方法
<a name="common-ways-tags-vector-indexes"></a>

在 S3 向量索引上使用標籤：
+ **成本分配** – 依 AWS Billing and Cost Management 中的向量索引標籤追蹤儲存成本。如需詳細資訊，請參閱[使用成本分配標籤](tagging.md#using-tags-for-cost-allocation)。
+ **屬性型存取控制 (ABAC)** – 擴展存取許可，並根據其標籤授予對 S3 向量索引的存取。如需詳細資訊，請參閱[使用屬性型存取控制 (ABAC) 的標籤](tagging.md#using-tags-for-abac)。

**注意**  
您可以將相同的標籤同時用於成本分配和存取控制。

### 適用於 S3 向量索引的 ABAC
<a name="abac-vector-indexes"></a>

Amazon S3 向量索引支援使用標籤的屬性型存取控制 (ABAC)。在您的 AWS 組織、IAM 和 S3 向量索引政策中使用標籤型條件索引鍵。對於企業，ABAC inAmazon S3 支援跨多個 AWS 帳戶進行授權。

在 IAM 政策中，您可以使用下列全域條件索引鍵，根據向量索引的標籤來控制對 S3 向量索引的存取：

`aws:ResourceTag/key-name`  
使用此鍵來將您在政策中所指定的標籤鍵值對與連接到資源的鍵值對進行比較。例如，您可以要求只在資源擁有連接標籤鍵 `Dept` 和值 `Marketing` 時才允許資源的存取。如需詳細資訊，請參閱[控制對 AWS 資源的存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources)。

`aws:RequestTag/key-name`  
使用此鍵來將請求中傳遞的標籤鍵/值對與您在政策中所指定的標籤對進行比較。例如，您可以檢查請求是否包含標籤鍵 `Dept` 並且其具有值 `Accounting`。如需詳細資訊，請參閱在[AWS 請求期間控制存取](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-requests)。您可以使用此條件索引鍵，限制在 `TagResource` 和 `CreateIndex` API 操作期間可以傳遞哪些標籤鍵值對。

`aws:TagKeys`  
使用此鍵來將請求中的標籤鍵與您在政策中所指定的鍵進行比較。當使用政策來控制使用標籤的存取時，建議您使用 `aws:TagKeys` 條件鍵來定義允許的標籤鍵。如需範例政策和詳細資訊，請參閱[根據標籤金鑰控制存取權限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys)。您可以使用標籤建立 S3 向量索引。若要在 `CreateVectorBucket` API 操作期間允許標記，您必須建立同時包含 `s3vectors:TagResource` 和 `s3vectors:CreateVectorBucket` 動作的政策。然後，您可以使用 `aws:TagKeys` 條件索引鍵，以強制在 `CreateVectorBucket` 請求中使用特定的標籤。

### 向量索引的 ABAC 政策範例
<a name="example-abac-policies-vector-indexes"></a>

請參閱下列 Amazon S3 向量索引的 ABAC 政策範例。

#### 1.1 - 使用特定標籤建立或修改向量索引的 IAM 政策
<a name="iam-policy-create-modify-indexes-tags"></a>

在此 IAM 政策中，具有此政策的使用者或角色只能在向量索引建立請求`Trinity`中使用標籤索引鍵`project`和標籤值標記向量索引時，才能建立 S3 向量索引。只要`TagResource`請求包含標籤鍵/值對 ，他們也可以在現有的 S3 向量索引上新增或修改標籤`project:Trinity`。此政策不會授予向量索引或其物件的讀取、寫入或刪除許可。

```
{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "CreateVectorIndexWithTags",
      "Effect": "Allow",
      "Action": [
        "s3vectors:CreateIndex",
        "s3vectors:TagResource"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:RequestTag/project": [
            "Trinity"
          ]
        }
      }
    }
  ]
}
```

#### 1.2 - 修改現有資源上的標籤以維護標記控管的 IAM 政策
<a name="iam-policy-modify-tags-governance"></a>

在此 IAM 政策中，只有在向量索引標籤的值符合主體`project`標籤的值時，IAM 主體 （使用者或角色） 才能修改向量索引上的`project`標籤。這些向量索引只允許`aws:TagKeys`條件索引鍵中`cost-center`指定的四個標籤 `project` `environment``owner`、、 和 。這有助於強制執行標籤控管、防止未經授權的標籤修改，並使標記結構描述在向量索引之間保持一致。

```
{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "EnforceTaggingRulesOnModification",
      "Effect": "Allow",
      "Action": [
        "s3vectors:TagResource"
      ],
      "Resource": "arn:aws::s3vectors:us-west-2:111122223333:bucket/*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/project": "${aws:PrincipalTag/project}"
        },
        "ForAllValues:StringEquals": {
          "aws:TagKeys": [
            "project",
            "environment",
            "owner",
            "cost-center"
          ]
        }
      }
    }
  ]
}
```

# 管理向量索引的標籤
<a name="managing-tags-vector-indexes"></a>

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、 AWS SDKs 或使用 S3 APIs 來新增或管理 S3 向量索引的標籤：[TagResource](https://docs.aws.amazon.com/)、[UntagResource](https://docs.aws.amazon.com/) 和 [ListTagsForResource](https://docs.aws.amazon.com/)。如需詳細資訊，請參閱：

**Topics**
+ [使用標籤建立向量索引](creating-vector-indexes-with-tags.md)
+ [將標籤新增至向量索引](adding-tag-vector-index.md)
+ [檢視向量索引標籤](viewing-vector-index-tags.md)
+ [從向量索引刪除標籤](deleting-tag-vector-index.md)

# 使用標籤建立向量索引
<a name="creating-vector-indexes-with-tags"></a>

您可以在建立 Amazon S3 向量索引時為其加上標籤。在超過標準 S3 API 請求率的向量索引上使用標籤不會產生額外費用。如需詳細資訊，請參閱 [Simple Storage Service (Amazon S3) 定價](https://docs.aws.amazon.com/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)。

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

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、Amazon S3 REST API 和 AWS SDKs建立套用標籤的向量索引。

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

**使用 Amazon S3 主控台建立具有標籤的向量索引**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 開啟 Amazon 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.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_CreateIndex.html)

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

若要安裝 AWS CLI，請參閱*AWS Command Line Interface 《 使用者指南*[》中的安裝 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 。

下列 CLI 範例說明如何使用 建立具有標籤的向量索引 AWS 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
```

# 將標籤新增至向量索引
<a name="adding-tag-vector-index"></a>

您可以將標籤新增至 Amazon S3 向量索引，並修改這些標籤。在超過標準 S3 API 請求率的向量索引上使用標籤不會產生額外費用。如需詳細資訊，請參閱 [Simple Storage Service (Amazon S3) 定價](https://docs.aws.amazon.com/s3/pricing/)。如需標記向量索引的詳細資訊，請參閱 [搭配 S3 向量索引使用標籤](vector-index-tagging.md)。

## 許可
<a name="add-index-tag-permissions"></a>

若要將標籤新增至向量索引，您必須具有下列許可：
+ `s3vectors:TagResource`

## 故障診斷錯誤
<a name="add-index-tag-troubleshooting"></a>

如果您在嘗試將標籤新增至向量索引時發生錯誤，可以執行下列動作：
+ 確認您具有將標籤新增至向量索引所需的[許可](#add-index-tag-permissions)。
+ 如果您嘗試新增以 AWS 預留字首 開頭的標籤金鑰`aws:`，請變更標籤金鑰，然後再試一次。

## 步驟
<a name="add-index-tag-steps"></a>

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、Amazon S3 REST API 和 AWS SDKs 將標籤新增至向量索引。

### 使用 S3 主控台
<a name="add-index-tag-console"></a>

**使用 Amazon S3 主控台將標籤新增至向量索引**

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)：// 開啟 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇**向量索引**。

1. 選擇向量索引名稱。

1. 選擇**屬性**索引標籤。

1. 捲動至**標籤**區段，選擇**新增標籤**。

1. **新增標籤**頁面隨即開啟。您最多可以輸入 50 個鍵值對。

1. 若您使用與現有標籤相同的標籤鍵名稱來新增標籤，新標籤值會覆寫現有標籤值。

1. 在此頁面上，您也可以編輯現有標籤的值。

1. 新增標籤後，選擇**儲存變更**。

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

如需將標籤新增至向量索引的 Amazon S3 REST API 支援相關資訊，請參閱《*Amazon S3 向量 API 參考*》中的下列章節：

[TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_TagResource.html)

### 使用 AWS CLI
<a name="add-index-tag-cli"></a>

若要安裝 AWS CLI，請參閱*AWS Command Line Interface 《 使用者指南*[》中的安裝 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 。

下列 CLI 範例示範如何使用 將標籤新增至向量索引 AWS CLI。若要使用此命令，請以您自己的資訊取代*使用者輸入預留位置*。

```
aws s3vectors tag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tags Stage=Prod,CostCenter=Marketing
```

# 檢視向量索引標籤
<a name="viewing-vector-index-tags"></a>

您可以檢視或列出套用至 Amazon S3 向量索引的標籤。如需標記向量索引的詳細資訊，請參閱 [搭配 S3 向量索引使用標籤](vector-index-tagging.md)。

## 許可
<a name="view-index-tag-permissions"></a>

若要檢視套用至向量索引的標籤，您必須具有下列許可：
+ `s3vectors:ListTagsForResource`

## 故障診斷錯誤
<a name="view-index-tag-troubleshooting"></a>

如果您在嘗試列出或檢視向量索引的標籤時遇到錯誤，您可以執行下列動作：
+ 確認您具有檢視或列出向量索引標籤所需的[許可](#view-index-tag-permissions)。

## 步驟
<a name="view-index-tag-steps"></a>

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、Amazon S3 REST API 和 AWS SDKs 來檢視套用至向量索引的標籤。

### 使用 S3 主控台
<a name="view-index-tag-console"></a>

**使用 Amazon S3 主控台檢視套用至向量索引的標籤**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) 開啟 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇**向量索引**。

1. 選擇向量索引名稱。

1. 選擇**屬性**索引標籤。

1. 捲動至**標籤**區段，以檢視套用至向量索引的所有標籤。

1. **標籤**區段預設會顯示使用者定義的標籤。您可以選取 AWS產生的標籤標籤，以檢視依 AWS 服務套用至向量索引的標籤。

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

如需檢視套用至向量索引之標籤的 Amazon S3 REST API 支援相關資訊，請參閱《Amazon Simple Vectors API 參考》中的下列章節：

[ListTagsForResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListTagsForResource.html)

### 使用 AWS CLI
<a name="view-index-tag-cli"></a>

若要安裝 AWS CLI，請參閱*AWS Command Line Interface 《 使用者指南*[》中的安裝 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 。

下列 CLI 範例說明如何檢視套用至向量索引的標籤。若要使用此命令，請以您自己的資訊取代*使用者輸入預留位置*。

```
aws s3vectors list-tags-for-resource \ 
  --resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index
```

# 從向量索引刪除標籤
<a name="deleting-tag-vector-index"></a>

您可以從 S3 向量索引移除標籤。 AWS 標籤是金鑰值對，可保留資源的中繼資料，在此情況下為 Amazon S3 向量索引。如需標記向量索引的詳細資訊，請參閱 [搭配 S3 向量索引使用標籤](vector-index-tagging.md)。

**注意**  
如果您刪除標籤，但後來發現它被用於追蹤成本或存取控制，您可以將該標籤新增回向量索引。

## 許可
<a name="delete-index-tag-permissions"></a>

若要從向量索引刪除標籤，您必須具有下列許可：
+ `s3vectors:UntagResource`

## 故障診斷錯誤
<a name="delete-index-tag-troubleshooting"></a>

如果您在嘗試從向量索引刪除標籤時遇到錯誤，您可以執行下列動作：
+ 確認您具有從向量索引刪除標籤所需的[許可](#delete-index-tag-permissions)。

## 步驟
<a name="delete-index-tag-steps"></a>

您可以使用 Amazon S3 主控台、 AWS Command Line Interface (AWS CLI)、Amazon S3 REST API 和 AWS SDKs，從向量索引刪除標籤。

### 使用 S3 主控台
<a name="delete-index-tag-console"></a>

**使用 Amazon S3 主控台從向量索引刪除標籤**

1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)：// 開啟 Amazon S3 主控台。

1. 在左側導覽窗格中，選擇**向量索引**。

1. 選擇向量索引名稱。

1. 選擇**屬性**索引標籤。

1. 捲動至**標籤**區段，然後選取您要刪除的標籤旁的核取方塊。

1. 選擇 **刪除**。

1. **刪除使用者定義的標籤**快顯視窗隨即出現，並且要求您確認是否刪除您選取的標籤。

1. 選擇**刪除**以確認刪除。

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

如需從向量索引刪除標籤的 Amazon S3 REST API 支援相關資訊，請參閱 *Amazon S3 Vectors API 參考*中的下列章節：

[UntagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_UntagResource.html)

### 使用 AWS CLI
<a name="delete-index-tag-cli"></a>

若要安裝 AWS CLI，請參閱*AWS Command Line Interface 《 使用者指南*[》中的安裝 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 。

下列 CLI 範例說明如何使用 從向量索引刪除標籤 AWS CLI。若要使用此命令，請以您自己的資訊取代 *使用者輸入預留位置*。

```
aws s3vectors untag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tag-keys CostCenter Department
```