Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Indeks vektor
**catatan**
Pilih parameter konfigurasi indeks vektor Anda dengan hati-hati. Setelah membuat indeks vektor, Anda tidak dapat memperbarui nama indeks vektor, dimensi, metrik jarak, atau kunci metadata yang tidak dapat difilter. Untuk mengubah salah satu dari nilai-nilai ini, Anda harus membuat indeks vektor baru.
Indeks vektor adalah sumber daya dalam bucket vektor yang menyimpan dan mengatur data vektor untuk operasi pencarian kesamaan yang efisien. Saat Anda membuat indeks vektor, Anda menentukan metrik jarak (`Cosine`atau`Euclidean`), jumlah dimensi yang harus dimiliki vektor, dan secara opsional daftar bidang metadata yang ingin Anda kecualikan dari pemfilteran selama kueri kesamaan.
Untuk informasi selengkapnya tentang batas indeks vektor per ember, batas vektor per indeks, dan batas dimensi per vektor, lihat[Keterbatasan dan pembatasan](s3-vectors-limitations.md).
Setiap indeks vektor memiliki Nama Sumber Daya Amazon (ARN) yang unik. Indeks vektor mengikuti format berikut: ARNs
```
arn:aws:s3vectors:region:account-id:bucket/bucket-name/index/index-name
```
## Persyaratan penamaan indeks vektor
+ Nama indeks vektor harus unik dalam ember vektor.
+ Nama indeks vektor harus antara 3 dan 63 karakter.
+ Karakter yang valid adalah huruf kecil (a-z), angka (0-9), tanda hubung (-), dan titik (.).
+ Nama indeks vektor harus dimulai dan diakhiri dengan huruf atau angka.
## Persyaratan dimensi
Dimensi adalah jumlah nilai dalam vektor. Semua vektor yang ditambahkan ke indeks harus memiliki jumlah nilai yang tepat.
+ Dimensi harus berupa bilangan bulat antara 1 dan 4096.
+ Dimensi yang lebih besar membutuhkan lebih banyak ruang penyimpanan.
## Opsi metrik jarak
Metrik jarak menentukan bagaimana kesamaan antara vektor dihitung. Saat membuat penyematan vektor, pilih metrik jarak yang direkomendasikan model penyematan Anda untuk hasil yang lebih akurat.
+ **Cosinus** — Mengukur kosinus sudut antar vektor. Terbaik untuk vektor yang dinormalisasi dan ketika arah lebih penting daripada besarnya.
+ **Euclidean** — Mengukur jarak garis lurus antara vektor. Terbaik ketika arah dan besarnya penting.
## Tombol metadata yang tidak dapat disaring
Tombol metadata memungkinkan Anda untuk melampirkan informasi tambahan ke vektor Anda sebagai pasangan nilai kunci selama penyimpanan dan pengambilan. Secara default, semua metadata dapat difilter, sehingga Anda dapat menggunakannya untuk memfilter hasil kueri. Namun, Anda dapat menetapkan kunci metadata tertentu sebagai tidak dapat difilter saat Anda ingin menyimpan informasi dengan vektor tanpa menggunakannya untuk pemfilteran.
Tidak seperti kunci metadata default, kunci ini tidak dapat digunakan sebagai filter kueri. Kunci metadata yang tidak dapat difilter dapat diambil tetapi tidak dapat dicari, ditanyakan, atau difilter. Anda hanya dapat mengaksesnya setelah menemukan indeks.
Tombol metadata yang tidak dapat difilter memungkinkan Anda untuk memperkaya vektor dengan konteks tambahan yang ingin Anda ambil dengan hasil pencarian tetapi tidak perlu untuk pemfilteran. Contoh umum dari kunci metadata yang tidak dapat difilter adalah ketika Anda menyematkan teks ke dalam vektor dan ingin menyertakan teks asli itu sendiri sebagai metadata yang tidak dapat difilter. Ini memungkinkan Anda mengembalikan teks sumber bersama hasil pencarian vektor tanpa meningkatkan batas ukuran metadata yang dapat difilter. Contoh lain termasuk menyimpan stempel waktu pembuatan, sumber URLs, atau informasi deskriptif murni untuk referensi. Kunci metadata yang tidak dapat difilter dapat diakses saat mengambil vektor tetapi, tidak seperti kunci metadata default, kunci ini tidak dapat digunakan sebagai filter kueri.
Persyaratan untuk kunci metadata yang tidak dapat difilter adalah sebagai berikut.
+ Kunci metadata yang tidak dapat difilter harus unik dalam indeks vektor.
+ Tombol metadata yang tidak dapat difilter harus memiliki panjang 1 hingga 63 karakter.
+ Kunci metadata yang tidak dapat difilter tidak dapat dimodifikasi setelah indeks vektor dibuat.
+ Vektor S3 mendukung hingga 10 kunci metadata yang tidak dapat difilter per indeks.
Untuk informasi selengkapnya tentang kunci metadata yang tidak dapat difilter, lihat. [Metadata yang tidak dapat disaring](s3-vectors-metadata-filtering.md#s3-vectors-metadata-filtering-non-filterable)
**Topics**
+ [Persyaratan penamaan indeks vektor](#s3-vectors-indexes-naming)
+ [Persyaratan dimensi](#s3-vectors-indexes-dimensions)
+ [Opsi metrik jarak](#s3-vectors-indexes-distance-metrics)
+ [Tombol metadata yang tidak dapat disaring](#s3-vectors-indexes-metadata)
+ [Membuat indeks vektor dalam ember vektor](s3-vectors-create-index.md)
+ [Daftar indeks vektor](s3-vectors-index-list.md)
+ [Menghapus indeks vektor](s3-vectors-index-delete.md)
+ [Menggunakan tag dengan indeks vektor S3](vector-index-tagging.md)
# Membuat indeks vektor dalam ember vektor
**catatan**
Pilih parameter konfigurasi indeks vektor Anda dengan hati-hati. Setelah membuat indeks vektor, Anda tidak dapat memperbarui nama indeks vektor, dimensi, metrik jarak, atau kunci metadata yang tidak dapat difilter. Untuk mengubah salah satu dari nilai-nilai ini, Anda harus membuat indeks vektor baru.
Indeks vektor adalah sumber daya dalam bucket vektor yang menyimpan dan mengatur data vektor untuk pencarian kesamaan yang efisien. Saat Anda membuat indeks vektor, Anda menentukan karakteristik yang harus dibagikan oleh semua vektor dalam indeks tersebut, seperti dimensi, metrik jarak yang digunakan untuk perhitungan kesamaan, dan kunci metadata opsional yang tidak dapat difilter. Anda juga dapat secara opsional mengonfigurasi pengaturan enkripsi khusus dan tag untuk indeks vektor pada saat pembuatan indeks. Untuk informasi selengkapnya tentang persyaratan penamaan indeks vektor, persyaratan dimensi, opsi metrik jarak, dan kunci metadata yang tidak dapat difilter, lihat. [Keterbatasan dan pembatasan](s3-vectors-limitations.md) Untuk informasi selengkapnya tentang pengaturan konfigurasi enkripsi untuk indeks vektor, lihat[Perlindungan data dan enkripsi di Vektor S3](s3-vectors-data-encryption.md). Untuk informasi selengkapnya tentang menyetel tag, lihat[Menggunakan tag dengan ember vektor S3](s3-vectors-tags.md).
Indeks vektor harus dibuat dalam bucket vektor yang ada dan memerlukan parameter konfigurasi khusus yang tidak dapat dimodifikasi setelah pembuatan.
## Menggunakan konsol S3
**Untuk membuat indeks vektor**
1. Buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi, pilih **Bucket vektor**.
1. Dalam daftar bucket vektor, pilih nama bucket tempat Anda ingin membuat indeks vektor.
1. Pilih **Buat indeks vektor**.
1. Untuk **nama indeks Vector**, masukkan nama untuk indeks vektor Anda.
Nama indeks vektor harus unik dalam ember vektor. Nama indeks harus antara 3 dan 63 karakter. Karakter yang valid adalah huruf kecil (a-z), angka (0-9), tanda hubung (-), dan titik (.). Untuk informasi selengkapnya tentang persyaratan penamaan indeks vektor, lihat[Keterbatasan dan pembatasan](s3-vectors-limitations.md).
1. Untuk **Dimensi**, masukkan jumlah nilai di setiap vektor.
**catatan**
Nilai untuk **Dimensi** menentukan berapa banyak nilai numerik yang akan dikandung setiap vektor.
Semua vektor yang ditambahkan ke indeks ini harus memiliki jumlah nilai yang tepat.
Dimensi harus antara 1 dan 4096.
Dimensi yang lebih besar membutuhkan lebih banyak ruang penyimpanan.
Pilih berdasarkan dimensi keluaran model embedding Anda.
Untuk informasi selengkapnya tentang persyaratan dimensi, lihat[Keterbatasan dan pembatasan](s3-vectors-limitations.md).
1. Untuk **metrik Jarak**, pilih salah satu opsi berikut:
+ **Cosinus** — Mengukur kosinus sudut antar vektor. Terbaik untuk vektor yang dinormalisasi dan ketika arah lebih penting daripada besarnya
+ **Euclidean** — Mengukur jarak garis lurus antara vektor. Terbaik ketika arah dan besarnya penting.
1. (Opsional) Di bawah metadata yang **tidak dapat difilter, konfigurasikan kunci metadata** yang akan disimpan tetapi tidak digunakan untuk pemfilteran:
Untuk menambahkan kunci metadata yang tidak dapat difilter:
1. Pilih **Tambah kunci**.
1. Masukkan nama kunci (1-63 karakter dan unik dalam indeks vektor ini).
1. Ulangi untuk menambahkan tombol tambahan (maksimum 10 tombol).
**catatan**
Anda dapat melampirkan metadata yang dapat difilter sebagai pasangan nilai kunci ke setiap vektor saat Anda memasukkan data vektor setelah Anda membuat indeks vektor. Secara default, semua kunci metadata yang dilampirkan ke vektor dapat difilter dan dapat digunakan sebagai filter dalam kueri kesamaan. Hanya kunci metadata yang ditetapkan sebagai tidak dapat difilter selama pembuatan indeks vektor yang dikecualikan dari pemfilteran. Untuk informasi selengkapnya tentang batas ukuran metadata per vektor, termasuk batasan metadata total dan dapat difilter, lihat. [Keterbatasan dan pembatasan](s3-vectors-limitations.md)
1. Tinjau konfigurasi Anda dengan cermat.
**catatan**
Pengaturan ini tidak dapat diubah setelah pembuatan.
1. Di bawah **Enkripsi**, pilih **Tentukan jenis enkripsi**. Anda memiliki opsi untuk **Menggunakan pengaturan bucket untuk enkripsi** atau mengganti pengaturan enkripsi untuk indeks vektor. **Jika Anda mengganti pengaturan tingkat ember, Anda memiliki opsi untuk menentukan jenis enkripsi untuk indeks vektor sebagai enkripsi sisi Server dengan kunci **Layanan Manajemen AWS Kunci (SSE-KMS) atau enkripsi sisi Server dengan kunci terkelola Amazon S3 (SSE-S3)**.** Untuk informasi selengkapnya tentang pengaturan konfigurasi enkripsi untuk indeks vektor, lihat[Perlindungan data dan enkripsi di Vektor S3](s3-vectors-data-encryption.md).
1. Di bawah **Tag (Opsional)**, Anda dapat menambahkan tag sebagai pasangan nilai kunci untuk membantu melacak dan mengatur biaya indeks vektor menggunakan AWS Billing and Cost Management. Masukkan **Kunci** dan **Nilai**. Untuk menambahkan tag lainnya, pilih **Tambahkan tag**. Anda dapat memasukkan hingga 50 tag untuk indeks vektor. Untuk informasi selengkapnya, lihat [Menggunakan tag dengan ember vektor S3](s3-vectors-tags.md).
1. Pilih **Buat indeks vektor**.
## Menggunakan AWS CLI
Untuk membuat indeks vektor dalam bucket vektor, gunakan contoh perintah berikut dan ganti `user input placeholders` dengan informasi Anda sendiri.
**Contoh 1: Membuat indeks vektor dengan kunci metadata yang tidak dapat difilter**
```
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"]}'
```
**Contoh 2: Membuat indeks vektor tanpa kunci metadata yang tidak dapat difilter**
```
aws s3vectors create-index \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx2" \
--data-type "float32" \
--dimension 4096 \
--distance-metric "euclidean"
```
Selain itu, semua metadata (baik yang dapat difilter maupun yang tidak dapat difilter) diambil dengan cara yang sama dengan menggunakan,, atau operasi API. `GetVectors` `ListVectors` `QueryVectors` Perintah CLI berikut menunjukkan cara mengambil vektor dengan metadata (termasuk metadata yang tidak dapat difilter).
Permintaan contoh:
```
aws s3vectors get-vectors \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx" \
--keys '["vec1", "vec3"]' \
--return-data \
--return-metadata \
```
Contoh respons:
```
{
"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"
}
}
]
}
```
Respons akan mencakup semua metadata yang terkait dengan vektor, terlepas dari apakah itu ditentukan sebagai dapat disaring atau tidak dapat disaring selama pembuatan indeks.
## Menggunakan AWS SDKs
------
#### [ 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"]}
)
```
------
# Daftar indeks vektor
Anda dapat melihat semua indeks vektor dalam ember vektor. Operasi listing mendukung pemfilteran berbasis awalan untuk membantu Anda menemukan indeks tertentu ketika Anda memiliki banyak indeks dalam bucket. Untuk informasi selengkapnya tentang`ListIndexes`, batas awalan, dan batas respons, lihat [ListIndexes](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListIndexes.html)di Referensi API Amazon Simple Storage Service.
## Kemampuan pencarian awalan
Pencarian awalan memungkinkan Anda untuk membuat daftar indeks yang dimulai dengan awalan tertentu, sehingga lebih mudah untuk mengatur dan menemukan indeks vektor terkait. Ini sangat berguna ketika Anda menggunakan konvensi penamaan yang mengelompokkan indeks terkait bersama-sama:
+ **Berdasarkan tipe data:**`text-embeddings-`,`image-features-`, `audio-vectors-`
+ **Dengan model:**`model1-embeddings-`,`model2-vectors-`, `custom-model-`
+ **Dengan kasus penggunaan:**`search-index-`,`recommendation-`, `similarity-`
+ **Berdasarkan lingkungan:**`prod-vectors-`,`staging-vectors-`, `dev-vectors-`
### Menggunakan konsol S3
**Untuk daftar indeks vektor**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **ember Vektor**.
1. Dalam daftar bucket vektor, pilih nama bucket yang berisi indeks yang ingin Anda lihat.
1. Konsol menampilkan daftar lengkap semua indeks vektor di bucket, termasuk:
+ **Nama** — Nama untuk setiap indeks.
+ **Buat tanggal** — Saat indeks dibuat.
+ **Nama Sumber Daya Amazon (ARN) — ARN** Lengkap untuk setiap indeks.
**Untuk memfilter daftar**
1. Masukkan nama indeks atau awalan di kotak pencarian di atas daftar indeks. Gunakan awalan untuk menemukan kelompok indeks terkait.
1. Daftar diperbarui secara real-time saat Anda mengetik.
### Menggunakan AWS CLI
Gunakan contoh perintah berikut dan ganti *user input placeholders* dengan informasi Anda sendiri.
**Untuk membuat daftar indeks dengan awalan tertentu dalam bucket vektor**
Contoh permintaan:
```
aws s3vectors list-indexes \
--vector-bucket-name "amzn-s3-demo-bucket" \
--prefix "idx" \
--max-results 1
```
Contoh respons:
```
{
"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"
}
]
}
```
**Untuk daftar indeks dengan pagination**
Contoh permintaan:
```
aws s3vectors list-indexes \
--vector-bucket-name "amzn-s3-demo-bucket" \
--prefix "idx" \
--next-token "lObb29ZkzxMGtBXs97Rkbs26xdtKemu4brsnq2jX8DCocADkILv5cRphemXS3PXXFnQBihQBmESgEeKaGA"
```
Contoh respons:
```
{
"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"
}
]
}
```
### Menggunakan AWS SDKs
------
#### [ 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)
```
------
# Menghapus indeks vektor
Anda dapat menghapus indeks vektor saat Anda tidak lagi membutuhkannya. Operasi ini secara permanen menghapus indeks dan semua vektor yang disimpan di dalamnya.
**penting**
Saat Anda menghapus indeks vektor, Anda perlu mengetahui hal berikut:
Anda dapat menghapus indeks vektor bahkan ketika indeks berisi vektor.
Semua vektor yang disimpan dalam indeks dihapus secara permanen
Semua metadata yang terkait dengan vektor tersebut hilang secara permanen
Operasi tidak dapat dibatalkan atau dibalik
Setiap operasi yang sedang berlangsung pada indeks akan segera gagal
Aplikasi yang menanyakan indeks akan menerima kesalahan
Nama indeks tersedia untuk digunakan kembali di dalam bucket
## Menggunakan AWS CLI
Sebelum Anda menghapus indeks vektor, verifikasi indeks vektor. Untuk informasi selengkapnya tentang cara memeriksa detail indeks, lihat [GetIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetIndex.html)di Referensi *API Amazon S3*. Untuk informasi selengkapnya tentang cara membuat daftar vektor di dalam indeks untuk melihat apa yang akan dihapus, lihat[Daftar indeks vektor](s3-vectors-index-list.md).
Untuk menghapus indeks vektor, gunakan contoh perintah berikut. Ganti *user input placeholders* dengan informasi Anda sendiri.
```
aws s3vectors delete-index --vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx2"
```
Untuk informasi selengkapnya tentang cara memverifikasi apakah indeks dihapus, lihat[Daftar indeks vektor](s3-vectors-index-list.md).
## Menggunakan AWS SDKs
------
#### [ 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")
```
------
# Menggunakan tag dengan indeks vektor S3
AWS Tag adalah pasangan nilai kunci yang menyimpan metadata tentang sumber daya, dalam hal ini indeks vektor Amazon S3. Anda dapat menandai indeks vektor S3 saat Anda membuatnya atau mengelola tag pada indeks vektor yang ada. Untuk informasi umum tentang tag, lihat[Penandaan untuk alokasi biaya atau kontrol akses berbasis atribut (ABAC)](tagging.md).
**catatan**
Tidak ada biaya tambahan untuk menggunakan tag pada indeks vektor di luar tarif permintaan API S3 standar. Untuk informasi selengkapnya, lihat [Harga Amazon S3](https://aws.amazon.com/s3/pricing/).
## Cara umum untuk menggunakan tag dengan indeks vektor
Gunakan tag pada indeks vektor S3 Anda untuk:
+ **Alokasi biaya** — Lacak biaya penyimpanan dengan tag indeks vektor di AWS Billing and Cost Management. Untuk informasi selengkapnya, lihat [Menggunakan tag untuk alokasi biaya](tagging.md#using-tags-for-cost-allocation).
+ **Attribute-based access control (ABAC)** — Skala izin akses dan berikan akses ke indeks vektor S3 berdasarkan tag mereka. Untuk informasi selengkapnya, lihat [Menggunakan tag untuk kontrol akses berbasis atribut (ABAC)](tagging.md#using-tags-for-abac).
**catatan**
Anda dapat menggunakan tanda yang sama untuk alokasi biaya dan kontrol akses.
### ABAC untuk indeks vektor S3
Indeks vektor Amazon S3 mendukung kontrol akses berbasis atribut (ABAC) menggunakan tag. Gunakan kunci kondisi berbasis tag di AWS organisasi, IAM, dan kebijakan indeks vektor S3 Anda. Untuk perusahaan, ABAC inAmazon S3 mendukung otorisasi di beberapa akun. AWS
Dalam kebijakan IAM Anda, Anda dapat mengontrol akses ke indeks vektor S3 berdasarkan tag indeks vektor dengan menggunakan kunci kondisi global berikut:
`aws:ResourceTag/key-name`
Gunakan kunci ini untuk membandingkan pasangan nilai kunci tag yang Anda tentukan dalam kebijakan dengan pasangan nilai kunci yang dilampirkan ke sumber daya. Misalnya, Anda dapat meminta agar akses ke sumber daya hanya diperbolehkan jika sumber daya memiliki kunci tanda yang dilampirkan `Dept` dengan nilai `Marketing`. Untuk informasi selengkapnya, lihat [Mengontrol akses ke AWS sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).
`aws:RequestTag/key-name`
Gunakan kunci ini untuk membandingkan pasangan nilai kunci tanda yang diteruskan dalam permintaan dengan pasangan tanda yang Anda sebutkan dalam kebijakan. Misalnya, Anda dapat memeriksa apakah permintaan tersebut menyertakan kunci tanda `Dept` dan memiliki nilai `Accounting`. Untuk informasi selengkapnya, lihat [Mengontrol akses selama AWS permintaan](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-requests). Anda dapat menggunakan kunci kondisi ini untuk membatasi pasangan nilai kunci tag mana yang dapat diteruskan selama operasi `TagResource` dan `CreateIndex` API.
`aws:TagKeys`
Gunakan kunci ini untuk membandingkan kunci tanda dalam permintaan dengan kunci yang Anda sebutkan dalam kebijakan. Sebaiknya saat Anda menggunakan kebijakan untuk mengontrol akses menggunakan tag, gunakan tombol `aws:TagKeys` kondisi untuk menentukan kunci tag apa yang diizinkan. Misalnya kebijakan dan informasi selengkapnya, lihat [Mengontrol akses berdasarkan kunci tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys). Anda dapat membuat indeks vektor S3 dengan tag. Untuk mengizinkan penandaan selama operasi `CreateVectorBucket` API, Anda harus membuat kebijakan yang mencakup `s3vectors:CreateVectorBucket` tindakan `s3vectors:TagResource` dan tindakan. Anda kemudian dapat menggunakan kunci `aws:TagKeys` kondisi untuk menerapkan menggunakan tag tertentu dalam `CreateVectorBucket` permintaan.
### Contoh kebijakan ABAC untuk indeks vektor
Lihat contoh kebijakan ABAC berikut untuk indeks vektor Amazon S3.
#### 1.1 - Kebijakan IAM untuk membuat atau memodifikasi indeks vektor dengan tag tertentu
Dalam kebijakan IAM ini, pengguna atau peran dengan kebijakan ini hanya dapat membuat indeks vektor S3 jika mereka menandai indeks vektor dengan kunci tag `project` dan nilai tag `Trinity` dalam permintaan pembuatan indeks vektor. Mereka juga dapat menambahkan atau memodifikasi tag pada indeks vektor S3 yang ada selama `TagResource` permintaan menyertakan pasangan nilai kunci tag. `project:Trinity` Kebijakan ini tidak memberikan izin baca, tulis, atau hapus pada indeks vektor atau objeknya.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "CreateVectorIndexWithTags",
"Effect": "Allow",
"Action": [
"s3vectors:CreateIndex",
"s3vectors:TagResource"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:RequestTag/project": [
"Trinity"
]
}
}
}
]
}
```
#### 1.2 - Kebijakan IAM untuk memodifikasi tag pada sumber daya yang ada mempertahankan tata kelola penandaan
Dalam kebijakan IAM ini, prinsipal IAM (pengguna atau peran) dapat memodifikasi tag pada indeks vektor hanya jika nilai tag indeks vektor cocok dengan nilai `project` tag prinsipal. `project` Hanya empat tag`project`,, `environment``owner`, dan `cost-center` ditentukan dalam kunci `aws:TagKeys` kondisi yang diizinkan untuk indeks vektor ini. Ini membantu menegakkan tata kelola tag, mencegah modifikasi tag yang tidak sah, dan menjaga skema penandaan tetap konsisten di seluruh indeks vektor Anda.
```
{
"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"
]
}
}
}
]
}
```
# Mengelola tag untuk indeks vektor
Anda dapat menambahkan atau mengelola tag untuk indeks vektor S3 menggunakan Konsol Amazon S3,AWS CLI(), AWS Command Line Interface yang, AWS SDKs atau menggunakan APIs S3 [TagResource](https://docs.aws.amazon.com/):,, dan. [UntagResource[ListTagsForResource](https://docs.aws.amazon.com/)](https://docs.aws.amazon.com/) Untuk informasi lebih lanjut, lihat:
**Topics**
+ [Membuat indeks vektor dengan tag](creating-vector-indexes-with-tags.md)
+ [Menambahkan tag ke indeks vektor](adding-tag-vector-index.md)
+ [Melihat tag indeks vektor](viewing-vector-index-tags.md)
+ [Menghapus tag dari indeks vektor](deleting-tag-vector-index.md)
# Membuat indeks vektor dengan tag
Anda dapat menandai indeks vektor Amazon S3 saat Anda membuatnya. Tidak ada biaya tambahan untuk menggunakan tag pada indeks vektor di luar tarif permintaan API S3 standar. Untuk informasi selengkapnya, lihat [Harga Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Untuk informasi selengkapnya tentang menandai indeks vektor, lihat. [Menggunakan tag dengan indeks vektor S3](vector-index-tagging.md)
## Izin
Untuk membuat indeks vektor dengan tag, Anda harus memiliki izin berikut:
+ `s3vectors:CreateIndex`
+ `s3vectors:TagResource`
## Memecahkan masalah kesalahan
Jika Anda mengalami kesalahan saat mencoba membuat indeks vektor dengan tag, Anda dapat melakukan hal berikut:
+ Verifikasi bahwa Anda memiliki [Izin](#index-tags-permissions) yang diperlukan untuk membuat indeks vektor dan menambahkan tag ke dalamnya.
+ Periksa kebijakan pengguna IAM Anda untuk mengetahui kondisi kontrol akses berbasis atribut (ABAC) apa pun. Anda mungkin diminta untuk memberi label indeks vektor Anda hanya dengan kunci dan nilai tag tertentu. Untuk informasi selengkapnya, lihat [Menggunakan tag untuk kontrol akses berbasis atribut (ABAC)](tagging.md#using-tags-for-abac).
## Langkah-langkah
Anda dapat membuat indeks vektor dengan tag yang diterapkan menggunakan konsol Amazon S3, AWS Command Line Interface (AWS CLI), Amazon S3 REST API, dan. AWS SDKs
### Menggunakan konsol S3
**Untuk membuat indeks vektor dengan tag menggunakan konsol Amazon S3**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **indeks vektor**.
1. Pilih **buat indeks vektor** untuk membuat indeks vektor baru.
1. Buat indeks vektor seperti biasanya; lihat[Membuat indeks vektor dalam ember vektor](s3-vectors-create-index.md).
1. Pada halaman **Buat indeks vektor**, **Tag** adalah opsi saat membuat indeks vektor baru.
1. Masukkan nama untuk indeks vektor.
1. Pilih **Tambahkan Tag baru** untuk membuka editor Tag dan masukkan pasangan nilai kunci tag. Kunci tag diperlukan, tetapi nilainya opsional.
1. Untuk menambahkan tag lain, pilih **Tambah Tag baru** lagi. Anda dapat memasukkan hingga 50 pasangan nilai kunci tag.
1. Setelah Anda menyelesaikan menentukan opsi untuk indeks vektor baru Anda, pilih **Buat indeks vektor**.
### Penggunaan API REST
Untuk informasi tentang dukungan Amazon S3 REST API untuk membuat indeks vektor dengan tag, lihat bagian berikut di Referensi API Vektor *Amazon S3*:
[CreateIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_CreateIndex.html)
### Menggunakan AWS CLI
Untuk menginstal AWS CLI, lihat [Menginstal AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) di *Panduan AWS Command Line Interface Pengguna*.
Contoh CLI berikut menunjukkan cara membuat indeks vektor dengan tag dengan menggunakan. AWS CLI Untuk menggunakan perintah ganti *user input placeholders* dengan informasi Anda sendiri.
Saat Anda membuat indeks vektor, Anda harus memberikan detail konfigurasi dan menggunakan konvensi penamaan berikut: `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
```
# Menambahkan tag ke indeks vektor
Anda dapat menambahkan tag ke indeks vektor Amazon S3 dan memodifikasi tag ini. Tidak ada biaya tambahan untuk menggunakan tag pada indeks vektor di luar tarif permintaan API S3 standar. Untuk informasi selengkapnya, lihat [Harga Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Untuk informasi selengkapnya tentang menandai indeks vektor, lihat. [Menggunakan tag dengan indeks vektor S3](vector-index-tagging.md)
## Izin
Untuk menambahkan tag ke indeks vektor, Anda harus memiliki izin berikut:
+ `s3vectors:TagResource`
## Memecahkan masalah kesalahan
Jika Anda mengalami kesalahan saat mencoba menambahkan tag ke indeks vektor, Anda dapat melakukan hal berikut:
+ Verifikasi bahwa Anda memiliki [Izin](#add-index-tag-permissions) yang diperlukan untuk menambahkan tag ke indeks vektor.
+ Jika Anda mencoba menambahkan kunci tag yang dimulai dengan awalan AWS cadangan`aws:`, ubah kunci tag dan coba lagi.
## Langkah-langkah
Anda dapat menambahkan tag ke indeks vektor dengan menggunakan konsol Amazon S3,AWS CLI(), AWS Command Line Interface Amazon S3 REST API, dan. AWS SDKs
### Menggunakan konsol S3
**Untuk menambahkan tag ke indeks vektor menggunakan konsol Amazon S3**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **indeks vektor**.
1. Pilih nama indeks vektor.
1. Pilih tab **Properti**.
1. Gulir ke bagian **Tag** dan pilih **Tambahkan Tag baru**.
1. Ini membuka halaman **Tambah Tag**. Anda dapat memasukkan hingga 50 pasangan nilai kunci tag.
1. Jika Anda menambahkan tag baru dengan nama kunci yang sama dengan tag yang ada, nilai tag baru akan menggantikan nilai tag yang ada.
1. Anda juga dapat mengedit nilai tag yang ada di halaman ini.
1. Setelah Anda menambahkan tag, pilih **Simpan perubahan**.
### Penggunaan API REST
Untuk informasi tentang dukungan Amazon S3 REST API untuk menambahkan tag ke indeks vektor, lihat bagian berikut di Referensi API Vektor *Amazon S3*:
[TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_TagResource.html)
### Menggunakan AWS CLI
Untuk menginstal AWS CLI, lihat [Menginstal AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) di *Panduan AWS Command Line Interface Pengguna*.
Contoh CLI berikut menunjukkan cara menambahkan tag ke indeks vektor dengan menggunakan. AWS CLI Untuk menggunakan perintah ganti *user input placeholders* dengan informasi Anda sendiri.
```
aws s3vectors tag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tags Stage=Prod,CostCenter=Marketing
```
# Melihat tag indeks vektor
Anda dapat melihat atau mencantumkan tag yang diterapkan ke indeks vektor Amazon S3. Untuk informasi selengkapnya tentang menandai indeks vektor, lihat. [Menggunakan tag dengan indeks vektor S3](vector-index-tagging.md)
## Izin
Untuk melihat tag yang diterapkan ke indeks vektor, Anda harus memiliki izin berikut:
+ `s3vectors:ListTagsForResource`
## Memecahkan masalah kesalahan
Jika Anda mengalami kesalahan saat mencoba membuat daftar atau melihat tag indeks vektor, Anda dapat melakukan hal berikut:
+ Verifikasi bahwa Anda memiliki [Izin](#view-index-tag-permissions) yang diperlukan untuk melihat atau mencantumkan tag indeks vektor.
## Langkah-langkah
Anda dapat melihat tag yang diterapkan ke indeks vektor menggunakan konsol Amazon S3,AWS CLI(), AWS Command Line Interface Amazon S3 REST API, dan. AWS SDKs
### Menggunakan konsol S3
**Untuk melihat tag yang diterapkan ke indeks vektor menggunakan konsol Amazon S3**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **indeks vektor**.
1. Pilih nama indeks vektor.
1. Pilih tab **Properti**.
1. Gulir ke bagian **Tag** untuk melihat semua tag yang diterapkan pada indeks vektor.
1. Bagian **Tag** menunjukkan tag yang ditentukan pengguna secara default. Anda dapat memilih tab tag AWS yang dihasilkan untuk melihat tag yang diterapkan ke indeks vektor Anda berdasarkan AWS layanan.
### Penggunaan API REST
Untuk informasi tentang dukungan Amazon S3 REST API untuk melihat tag yang diterapkan pada indeks vektor, lihat bagian berikut di Referensi API Amazon Simple Vectors:
[ListTagsforResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListTagsForResource.html)
### Menggunakan AWS CLI
Untuk menginstal AWS CLI, lihat [Menginstal AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) di *Panduan AWS Command Line Interface Pengguna*.
Contoh CLI berikut menunjukkan cara melihat tag yang diterapkan pada indeks vektor. Untuk menggunakan perintah ganti *user input placeholders* dengan informasi Anda sendiri.
```
aws s3vectors list-tags-for-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index
```
# Menghapus tag dari indeks vektor
Anda dapat menghapus tag dari indeks vektor S3. AWS Tag adalah pasangan nilai kunci yang menyimpan metadata tentang sumber daya, dalam hal ini indeks vektor Amazon S3. Untuk informasi selengkapnya tentang menandai indeks vektor, lihat. [Menggunakan tag dengan indeks vektor S3](vector-index-tagging.md)
**catatan**
Jika Anda menghapus tag dan kemudian mengetahui bahwa tag tersebut digunakan untuk melacak biaya atau untuk kontrol akses, Anda dapat menambahkan tag kembali ke indeks vektor.
## Izin
Untuk menghapus tag dari indeks vektor, Anda harus memiliki izin berikut:
+ `s3vectors:UntagResource`
## Memecahkan masalah kesalahan
Jika Anda mengalami kesalahan saat mencoba menghapus tag dari indeks vektor, Anda dapat melakukan hal berikut:
+ Verifikasi bahwa Anda memiliki [Izin](#delete-index-tag-permissions) yang diperlukan untuk menghapus tag dari indeks vektor.
## Langkah-langkah
Anda dapat menghapus tag dari indeks vektor dengan menggunakan konsol Amazon S3,AWS CLI(), AWS Command Line Interface Amazon S3 REST API, dan. AWS SDKs
### Menggunakan konsol S3
**Untuk menghapus tag dari indeks vektor menggunakan konsol Amazon S3**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **indeks vektor**.
1. Pilih nama indeks vektor.
1. Pilih tab **Properti**.
1. Gulir ke bagian **Tag** dan pilih kotak centang di sebelah tag atau tag yang ingin Anda hapus.
1. Pilih **Hapus**.
1. Pop-up **Hapus tag yang ditentukan pengguna** muncul dan meminta Anda mengonfirmasi penghapusan tag atau tag yang Anda pilih.
1. Pilih **Hapus** untuk mengonfirmasi.
### Penggunaan API REST
Untuk informasi tentang dukungan Amazon S3 REST API untuk menghapus tag dari indeks vektor, lihat bagian berikut di Referensi API Vektor *Amazon S3*:
[UntagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_UntagResource.html)
### Menggunakan AWS CLI
Untuk menginstal AWS CLI, lihat [Menginstal AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) di *Panduan AWS Command Line Interface Pengguna*.
Contoh CLI berikut menunjukkan cara menghapus tag dari indeks vektor dengan menggunakan. AWS CLI Untuk menggunakan perintah ganti *user input placeholders* dengan informasi Anda sendiri.
```
aws s3vectors untag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tag-keys CostCenter Department
```