Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Ember vektor
Bucket vektor adalah jenis bucket Amazon S3 yang dirancang khusus untuk menyimpan dan menanyakan data vektor. Bucket vektor digunakan khusus APIs untuk mengelola data vektor secara efisien dan mengurangi biaya pengunggahan, penyimpanan, dan kueri embeddings vektor. Bucket vektor menyediakan dasar untuk mengatur data vektor Anda ke dalam indeks, memungkinkan Anda melakukan pencarian kesamaan di seluruh kumpulan data besar sambil memanfaatkan ketersediaan, daya tahan, skalabilitas, dan efektivitas biaya Amazon S3.
Ember vektor dioptimalkan untuk penyimpanan vektor jangka panjang dengan waktu pencarian sub-detik. Anda dapat melakukan kueri kesamaan pada data vektor Anda dan secara opsional melampirkan metadata untuk memfilter kueri berdasarkan kondisi tertentu seperti tanggal, kategori, atau preferensi pengguna.
Setiap bucket vektor memiliki Nama Sumber Daya Amazon (ARN) unik dan kebijakan sumber daya yang dilampirkan padanya. Ember vektor mengikuti format berikut: ARNs
```
arn:aws:s3vectors:Region:OwnerAccountID:bucket/bucket-name
```
Dalam bucket vektor, Anda membuat indeks vektor untuk menyimpan dan menanyakan data Anda. Setiap bucket vektor ada dalam AWS Region tertentu dan Anda dapat membuat beberapa indeks vektor di dalam bucket vektor. Vector bucket mendukung mekanisme keamanan dan kontrol akses, termasuk kebijakan berbasis identitas IAM dan kebijakan bucket. Anda dapat menggunakan kebijakan bucket untuk memberikan atau membatasi akses ke indeks tertentu dalam bucket vektor Anda.
Karakteristik utama dari ember vektor:
+ Dibuat khusus untuk penyimpanan vektor dan operasi pencarian kesamaan.
+ Penulisan yang sangat konsisten memastikan bahwa data vektor segera dapat diakses.
+ Optimalisasi otomatis data vektor untuk kinerja harga terbaik sebagai skala dataset.
Untuk informasi selengkapnya tentang batas indeks vektor per bucket dan batasan lainnya, lihat[Keterbatasan dan pembatasan](s3-vectors-limitations.md).
**Topics**
+ [Aturan penamaan ember vektor](s3-vectors-buckets-naming.md)
+ [Membuat ember vektor](s3-vectors-buckets-create.md)
+ [Daftar ember vektor](s3-vectors-buckets-list.md)
+ [Melihat atribut bucket vektor](s3-vectors-buckets-details.md)
+ [Menghapus ember vektor kosong](s3-vectors-buckets-delete.md)
+ [Mengelola kebijakan bucket vektor](s3-vectors-bucket-policy.md)
+ [Menggunakan tag dengan ember vektor S3](s3-vectors-tags.md)
# Aturan penamaan ember vektor
Nama bucket vektor harus mengikuti konvensi penamaan tertentu untuk memastikan keunikan dalam suatu Wilayah. AWS Amazon S3 memberlakukan persyaratan penamaan bucket berikut, dan Anda tidak dapat membuat bucket vektor jika aturan ini tidak diikuti. Selain itu, ada praktik terbaik yang, meskipun tidak ditegakkan, membantu mencegah konflik saat bekerja dengan bucket vektor secara terprogram atau melalui konsol.
## Persyaratan penamaan ember vektor
Saat membuat ember vektor, Anda harus mengikuti persyaratan ini:
+ Nama bucket vektor harus unik di AWS akun yang sama untuk setiap AWS Wilayah.
+ Nama bucket vektor harus memiliki panjang antara 3 dan 63 karakter.
+ Nama bucket vektor hanya dapat terdiri dari huruf kecil (a-z), angka (0-9), dan tanda hubung (-).
+ Nama bucket vektor harus dimulai dan diakhiri dengan huruf atau angka.
## Praktik terbaik untuk penamaan
Sebaiknya ikuti praktik terbaik ini saat memberi nama bucket vektor Anda:
+ Gunakan nama deskriptif yang mencerminkan tujuan data vektor Anda (misalnya, rekomendasi produk, penyisipan dokumen).
+ Hindari menggunakan informasi sensitif dalam nama bucket karena mungkin muncul di log dan URLs.
+ Buat nama ringkas tetapi bermakna untuk memudahkan manajemen dan identifikasi.
Konvensi penamaan ini memastikan bahwa bucket vektor Anda dapat diakses dengan andal melalui AWS Management Console, Amazon S3 REST API, CLI, dan. AWS AWS SDKs
# Membuat ember vektor
Anda dapat membuat bucket vektor menggunakan konsol S3 atau AWS CLI. Semua data yang disimpan dalam ember vektor selalu dienkripsi saat istirahat. Secara default, bucket vektor menggunakan SSE-S3 untuk mengenkripsi data vektor. Anda dapat memilih untuk mengonfigurasi bucket untuk menggunakan enkripsi sisi server dengan AWS kunci Key Management Service (AWS KMS) (SSE-KMS) sebagai gantinya. Pengaturan enkripsi bucket tidak dapat diubah setelah bucket vektor dibuat, jadi penting untuk memilih metode enkripsi yang sesuai berdasarkan persyaratan keamanan dan kebutuhan kepatuhan Anda. Untuk informasi selengkapnya tentang keamanan dalam bucket vektor, lihat[Perlindungan data dan enkripsi di Vektor S3](s3-vectors-data-encryption.md).
## Menggunakan konsol 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, pilih **Bucket vektor**.
1. Pilih **Buat ember vektor**.
1. Untuk **nama bucket Vector**, masukkan nama untuk bucket Anda.
Nama bucket harus mengikuti aturan penamaan:
+ Nama bucket harus memiliki panjang antara 3 dan 63 karakter.
+ Nama bucket hanya dapat menyertakan huruf kecil, angka, dan tanda hubung.
+ Nama bucket harus unik dalam AWS akun Anda untuk suatu AWS Wilayah.
Untuk informasi selengkapnya tentang aturan penamaan bucket vektor, lihat[Aturan penamaan ember vektor](s3-vectors-buckets-naming.md).
**penting**
Anda tidak dapat mengubah nama bucket vektor setelah membuat bucket.
1. Untuk **Enkripsi**, pilih salah satu opsi berikut:
+ **Jangan tentukan jenis enkripsi** — Amazon S3 secara otomatis menerapkan enkripsi sisi server dengan kunci terkelola Amazon S3 (SSE-S3) sebagai tingkat dasar enkripsi untuk vektor baru. Pilih opsi ini untuk pengaturan paling sederhana tanpa konfigurasi tambahan.
+ **Tentukan jenis enkripsi** - Pilih metode enkripsi tertentu:
+ **Enkripsi sisi server dengan kunci terkelola Amazon S3 (SSE-S3) - Secara eksplisit memilih untuk menggunakan SSE-S3**. Amazon S3 mengenkripsi data vektor Anda saat menulisnya ke penyimpanan dan mendekripsi saat Anda mengaksesnya. AWS mengelola semua kunci enkripsi secara otomatis.
+ **Enkripsi sisi server dengan AWS kunci Layanan Manajemen Kunci (SSE-KMS) — Menggunakan kunci terkelola pelanggan (CMKs)** di AWS KMS, memberi Anda kontrol lebih besar atas kunci enkripsi, rotasi kunci, dan kebijakan akses Anda.
Jika Anda memilih SSE-KMS, Anda memiliki opsi tambahan:
+ **Pilih dari AWS KMS kunci Anda** — Pilih kunci terkelola pelanggan yang sudah ada dari akun Anda.
+ **Masukkan AWS KMS kunci ARN** — Tentukan ARN lengkap dari kunci KMS (format yang diperlukan).
+ **Buat kunci KMS** — Membuka konsol AWS KMS untuk membuat kunci terkelola pelanggan baru.
Persyaratan utama KMS:
+ Kunci KMS harus berada di Region yang sama dengan bucket vektor.
+ Anda harus menentukan ARN kunci KMS lengkap ( IDs kunci dan alias tidak didukung).
+ Anda harus memberikan S3 Vectors service principal (`indexing.s3vectors.amazonaws.com`) `kms:Decrypt` izin untuk menggunakan kunci. Untuk informasi selengkapnya tentang kebijakan AWS KMS kunci contoh, lihat[Perlindungan data dan enkripsi di Vektor S3](s3-vectors-data-encryption.md).
Untuk informasi rinci tentang opsi enkripsi dan pengaturan kunci KMS, lihat[Menggunakan enkripsi SSE-KMS](s3-vectors-data-encryption.md#s3-vectors-sse-kms-encryption).
**penting**
Pengaturan enkripsi tidak dapat diubah setelah bucket vektor dibuat. Pilih dengan hati-hati berdasarkan persyaratan keamanan dan kepatuhan jangka panjang Anda.
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 ember vektor**.
Setelah pembuatan, Anda akan melihat pesan konfirmasi. Bucket vektor baru muncul di daftar bucket vektor Anda dan siap untuk membuat indeks vektor di dalam bucket.
## Menggunakan AWS CLI
Anda dapat membuat bucket vektor dengan enkripsi SSE-S3 menggunakan perintah berikut. Untuk menggunakan contoh ini, ganti *user input placeholders*dengan informasi Anda sendiri.
```
aws s3vectors create-vector-bucket \
--vector-bucket-name "amzn-s3-demo-vector-bucket"
```
Untuk membuat bucket vektor dengan enkripsi SSE-KMS menggunakan kunci KMS yang dikelola pelanggan:
```
aws s3vectors create-vector-bucket \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--encryption-configuration '{"sseType": "aws:kms", "kmsKeyArn": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"}'
```
## 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 bucket
s3vectors.create_vector_bucket(vectorBucketName="media-embeddings")
```
------
# Daftar ember vektor
Anda dapat melihat semua bucket vektor menggunakan konsol Amazon S3 AWS CLI,, atau. AWS SDKs Operasi daftar mendukung pemfilteran berbasis awalan untuk membantu Anda menemukan bucket tertentu ketika Anda memiliki banyak bucket vektor di akun Anda. Untuk informasi selengkapnya tentang`ListVectorBuckets`, batas awalan, dan batas respons, lihat [ListVectorBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListVectorBuckets.html)di Referensi *API Amazon S3*.
## Kemampuan pencarian awalan
Pencarian awalan memungkinkan Anda membuat daftar bucket yang dimulai dengan awalan tertentu, sehingga lebih mudah untuk mengatur dan menemukan bucket vektor terkait. Ini sangat berguna saat Anda menggunakan konvensi penamaan yang mengelompokkan bucket terkait bersama-sama:
+ **Berbasis lingkungan**:`production-vectors-`,, `staging-vectors-` `dev-vectors-`
+ **Gunakan berbasis kasus**:`ml-model-vectors-`,, `document-search-` `image-similarity-`
+ **Berbasis tim**:`data-science-vectors-`, `ml-platform-vectors-`
## Menggunakan konsol S3
Untuk daftar ember 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, pilih **ember Vektor**.
Konsol menampilkan daftar semua bucket vektor Anda dengan informasi berikut:
+ **Nama** — Nama unik dari bucket vektor
+ **Tanggal pembuatan** - Saat ember dibuat
+ **Amazon Resource Name (ARN)** — ARN lengkap untuk akses terprogram
Untuk memfilter daftar:
+ Untuk menemukan bucket berdasarkan awal nama bucket, masukkan nama bucket vektor atau awalan di kotak pencarian di atas bucket list.
+ Gunakan awalan untuk menemukan grup ember terkait (misalnya, ketik “prod-” untuk menemukan semua ember produksi)
Daftar diperbarui secara real-time saat Anda mengetik
## Menggunakan AWS CLI
```
aws s3vectors list-vector-buckets
```
## 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 buckets
response = s3vectors.list_vector_buckets()
buckets = response["vectorBuckets"]
print(buckets)
```
------
# Melihat atribut bucket vektor
Anda dapat melihat informasi terperinci tentang bucket vektor, termasuk properti, pengaturan enkripsi, dan detail pembuatannya menggunakan Amazon S3 REST API, Konsol S3 AWS SDKs, atau Antarmuka Baris AWS Perintah (CLI AWS ). Untuk informasi selengkapnya`GetVectorBucket`, lihat [GetVectorBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_GetVectorBucket.html)di Referensi *API Amazon S3*.
## Menggunakan konsol S3
1. Masuk ke konsol dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi, pilih **ember Vektor**.
1. Konsol menampilkan daftar semua bucket vektor Anda. Temukan bucket berdasarkan awal nama bucket, masukkan nama bucket vektor atau awalan di kotak pencarian di atas bucket list. Setelah menemukan bucket vektor, Anda dapat melihat informasi mendetail tentangnya, termasuk pengaturan enkripsi, tag, dan detail pembuatannya di tab **Properties**.
## Menggunakan AWS CLI
```
aws s3vectors get-vector-bucket --vector-bucket-name "amzn-s3-demo-vector-bucket"
```
# Menghapus ember vektor kosong
Anda dapat menghapus ember vektor saat Anda tidak lagi membutuhkannya. Untuk menghapus bucket vektor, Anda harus terlebih dahulu menghapus semua indeks vektor di dalam bucket. Saat Anda menghapus indeks vektor, semua data vektor di dalamnya akan dihapus. Gunakan Amazon S3 REST API,, S3 Console AWS SDKs, atau AWS Command Line Interface (AWS CLI) untuk menghapus bucket vektor.
Sebelum Anda dapat menghapus ember vektor, Anda harus:
+ Hapus semua indeks vektor di ember.
+ Pastikan tidak ada operasi yang sedang berlangsung di bucket atau indeksnya.
**penting**
Penghapusan ember bersifat permanen dan tidak dapat dibatalkan.
Semua data dan konfigurasi yang terkait dengan bucket hilang secara permanen.
Nama bucket tersedia untuk digunakan kembali setelah penghapusan.
Setiap aplikasi atau skrip yang mereferensikan bucket akan menerima kesalahan setelah penghapusan.
## Menggunakan konsol S3
1. Masuk ke konsol dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi, pilih **ember Vektor**.
1. Konsol menampilkan daftar semua bucket vektor Anda. Temukan bucket berdasarkan awal nama bucket, masukkan nama bucket vektor atau awalan di kotak pencarian di atas bucket list. Setelah Anda menemukan dan memilih bucket vektor Anda, pilih opsi **Hapus**.
1. Untuk mengonfirmasi penghapusan ini, ketik **delete** lalu pilih **Delete vector bucket**.
## Menggunakan AWS CLI
Pertama, periksa apakah tidak ada indeks vektor di ember. Untuk informasi selengkapnya tentang cara memverifikasi bucket kosong, lihat[Daftar indeks vektor](s3-vectors-index-list.md).
Jika indeks ada, Anda harus menghapus semua vektor dari setiap indeks dan kemudian menghapus indeks. Untuk informasi selengkapnya tentang cara memverifikasi bucket kosong, lihat[Daftar vektor](s3-vectors-list.md),[Menghapus vektor dari indeks vektor](s3-vectors-delete.md), dan[Menghapus indeks vektor](s3-vectors-index-delete.md).
Untuk menghapus bucket vektor kosong, gunakan perintah contoh berikut dan ganti *user input placeholders* dengan informasi Anda sendiri.
```
aws s3vectors delete-vector-bucket \
--vector-bucket-name "amzn-s3-demo-vector-bucket"
```
## 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 bucket
response = s3vectors.delete_vector_bucket(vectorBucketName="media-embeddings")
```
------
# Mengelola kebijakan bucket vektor
Kebijakan bucket vektor adalah kebijakan berbasis sumber daya yang Anda lampirkan langsung ke bucket vektor untuk mengontrol akses ke bucket dan isinya. Anda dapat menambahkan, melihat, mengedit, menghapus kebijakan bucket vektor menggunakan Amazon S3 REST API, Konsol S3 AWS SDKs, atau Antarmuka Baris AWS Perintah (CLI AWS ). Kebijakan bucket untuk bucket vektor dapat memberikan izin kepada prinsipal dari AWS akun lain, sehingga berguna untuk skenario akses lintas akun.
## Operasi manajemen kebijakan
+ [PutVectorBucketPolicy](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_PutVectorBucketPolicy.html)— Tambahkan atau perbarui kebijakan bucket.
+ [GetVectorBucketPolicy](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_GetVectorBucketPolicy.html)— Ambil kebijakan bucket saat ini.
+ [DeleteVectorBucketPolicy](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_DeleteVectorBucketPolicy.html)— Hapus kebijakan bucket.
## Menambahkan kebijakan bucket vektor
### Menggunakan konsol S3
1. Buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Amazon** S3.
1. Pilih **Vector bucket** dan pilih nama bucket vektor yang ingin Anda tambahkan kebijakan.
1. Pilih tab **Izin**.
1. Di bawah **kebijakan bucket vektor**, pilih **Edit**.
1. Di editor kebijakan, masukkan JSON kebijakan Anda.
1. (Opsional) Pilih **contoh Kebijakan** untuk melihat contoh kebijakan yang dapat Anda sesuaikan dengan kebutuhan Anda.
1. Setelah memasukkan kebijakan Anda, pilih **Simpan perubahan**.
### Menggunakan AWS CLI
Untuk menambah atau memperbarui kebijakan bucket, gunakan perintah contoh berikut dan ganti *user input placeholders* dengan informasi Anda sendiri.
```
aws s3vectors put-vector-bucket-policy \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--policy '{"Version": "2012-10-17", "Statement":[{"Effect":"Allow","Principal":{"AWS":"arn:aws:iam::111122223333:root"},"Action":"s3vectors:*","Resource":"arn:aws:s3vectors:aws-region:111122223333:bucket/amzn-s3-demo-vector-bucket"}]}'
```
## Melihat kebijakan bucket vektor
### Menggunakan konsol S3
1. Buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Amazon** S3.
1. Pilih **Vector bucket** dan pilih nama bucket vektor yang ingin Anda lihat kebijakannya.
1. Pilih tab **Izin**.
### Menggunakan AWS CLI
Untuk mengambil kebijakan bucket, gunakan perintah contoh berikut dan ganti *user input placeholders* dengan informasi Anda sendiri.
```
aws s3vectors get-vector-bucket-policy \
--vector-bucket-name "amzn-s3-demo-vector-bucket"
```
## Menghapus kebijakan bucket vektor
### Menggunakan konsol S3
1. Buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Amazon** S3.
1. Pilih **Vector bucket** dan pilih nama bucket vektor yang ingin Anda hapus kebijakannya.
1. Pilih tab **Izin**.
1. Di bawah **kebijakan bucket Vector**, pilih **Hapus**.
### Menggunakan AWS CLI
Untuk menghapus kebijakan bucket, gunakan perintah contoh berikut dan ganti *user input placeholders* dengan informasi Anda sendiri.
```
aws s3vectors delete-vector-bucket-policy \
--vector-bucket-name "amzn-s3-demo-vector-bucket"
```
Untuk informasi terperinci tentang membuat dan mengelola kebijakan bucket, termasuk contoh kebijakan dan praktik terbaik, lihat[Contoh kebijakan berbasis sumber daya Vektor S3](s3-vectors-resource-based-policies.md).
# Menggunakan tag dengan ember vektor S3
AWS Tag adalah pasangan nilai kunci yang menyimpan metadata tentang sumber daya, dalam hal ini bucket vektor Amazon S3. Anda dapat menandai bucket vektor S3 saat Anda membuatnya atau mengelola tag pada bucket 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 bucket 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 ember vektor
Gunakan tag pada bucket vektor S3 Anda untuk:
+ **Kontrol akses berbasis atribut (ABAC)** — Skala izin akses dan berikan akses ke bucket vektor S3 berdasarkan tag mereka. Untuk informasi selengkapnya, lihat [Menggunakan tag untuk kontrol akses berbasis atribut (ABAC)](tagging.md#using-tags-for-abac).
### ABAC untuk ember vektor S3
Bucket vektor Amazon S3 mendukung kontrol akses berbasis atribut (ABAC) menggunakan tag. Gunakan kunci kondisi berbasis tag di AWS organisasi, IAM, dan kebijakan bucket vektor S3 Anda. Untuk perusahaan, ABAC inAmazon S3 mendukung otorisasi di beberapa akun. AWS
Dalam kebijakan IAM, Anda dapat mengontrol akses ke bucket vektor S3 berdasarkan tag bucket 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 `CreateVectorBucket` 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 bucket 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.
`s3vectors:VectorBucketTag/tag-key`
Gunakan kunci kondisi ini untuk memberikan izin ke data tertentu dalam bucket vektor menggunakan tag. Kunci kondisi ini bekerja pada tag yang ditetapkan ke bucket vektor untuk semua tindakan Vektor S3. Bahkan saat Anda membuat indeks dengan tag, kunci kondisi ini bekerja pada tag yang diterapkan pada bucket vektor yang berisi indeks tersebut. Misalnya, Anda dapat meminta akses ke bucket hanya diizinkan jika bucket memiliki kunci tag terlampir `Dept` dengan nilainya`Marketing`. Saat mengakses indeks, kondisi ini mereferensikan tag yang terkait dengan bucket vektor yang berisi indeks itu, sedangkan `aws:ResourceTag/tag-key` akan mereferensikan tag indeks itu sendiri.
### Contoh kebijakan ABAC untuk bucket vektor
Lihat contoh kebijakan ABAC berikut untuk bucket vektor Amazon S3.
#### 1.1 - Kebijakan IAM untuk membuat atau memodifikasi bucket vektor dengan tag tertentu
Dalam kebijakan IAM ini, pengguna atau peran dengan kebijakan ini hanya dapat membuat bucket vektor S3 jika mereka menandai bucket vektor dengan kunci tag `project` dan nilai tag `Trinity` dalam permintaan pembuatan bucket vektor. Mereka juga dapat menambahkan atau memodifikasi tag pada bucket vektor S3 yang ada selama `TagResource` permintaan tersebut menyertakan pasangan nilai kunci tag. `project:Trinity` Kebijakan ini tidak memberikan izin baca, tulis, atau hapus pada bucket vektor atau objeknya.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "CreateVectorBucketWithTags",
"Effect": "Allow",
"Action": [
"s3vectors:CreateVectorBucket",
"s3vectors:TagResource"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:RequestTag/project": [
"Trinity"
]
}
}
}
]
}
```
#### 1.2 - Kebijakan bucket vektor untuk membatasi operasi pada bucket vektor menggunakan tag
Dalam kebijakan bucket vektor ini, prinsipal IAM (pengguna dan peran) dapat melakukan operasi menggunakan `PutVectorBucketPolicy` aksi pada bucket vektor hanya jika nilai tag bucket vektor cocok dengan nilai `project` tag prinsipal. `project`
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowObjectOperations",
"Effect": "Allow",
"Principal": {
"AWS": "111122223333"
},
"Action": "s3vectors:PutVectorBucketPolicy",
"Resource": "arn:aws::s3vectors:us-west-2:111122223333:bucket/amzn-s3-demo-vector-bucket",
"Condition": {
"StringEquals": {
"aws:ResourceTag/project": "${aws:PrincipalTag/project}"
}
}
}
]
}
```
#### 1.3 - 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 bucket vektor hanya jika nilai tag bucket vektor cocok dengan nilai `project` tag prinsipal. `project` Hanya empat tag`project`,, `environment``owner`, dan `cost-center` ditentukan dalam tombol `aws:TagKeys` kondisi yang diizinkan untuk ember vektor ini. Ini membantu menegakkan tata kelola tag, mencegah modifikasi tag yang tidak sah, dan menjaga skema penandaan tetap konsisten di seluruh bucket 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"
]
}
}
}
]
}
```
#### 1.4 - Menggunakan tombol `s3vectors:VectorBucketTag` kondisi
Dalam kebijakan IAM ini, pernyataan kondisi mengizinkan akses ke operasi bucket vektor dan indeks vektor hanya jika bucket vektor memiliki kunci tag `Environment` dan nilai `Production` tag.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowAccessToTaggedBucket",
"Effect": "Allow",
"Action": "*",
"Resource": "arn:aws::s3vectors:us-west-2:111122223333:bucket/*",
"Condition": {
"StringEquals": {
"s3vectors:VectorBucketTag/Environment": "Production"
}
}
}
]
}
```
# Mengelola tag untuk ember vektor
Anda dapat menambahkan atau mengelola tag untuk bucket 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 ember vektor dengan tag
Anda dapat menandai ember vektor Amazon S3 saat Anda membuatnya. Tidak ada biaya tambahan untuk menggunakan tag pada bucket 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 bucket vektor, lihat. [Menggunakan tag dengan ember vektor S3](s3-vectors-tags.md)
## Izin
Untuk membuat bucket vektor dengan tag, Anda harus memiliki izin berikut:
+ `s3vectors:CreateVectorBucket`
+ `s3vectors:TagResource`
## Memecahkan masalah kesalahan
Jika Anda mengalami kesalahan saat mencoba membuat bucket vektor dengan tag, Anda dapat melakukan hal berikut:
+ Verifikasi bahwa Anda memiliki [Izin](#bucket-tags-permissions) yang diperlukan untuk membuat bucket 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 bucket 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 bucket 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 bucket 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 **ember vektor**.
1. Pilih **buat bucket vektor** untuk membuat bucket vektor baru.
1. Buat ember vektor seperti biasa; lihat[Membuat ember vektor](s3-vectors-buckets-create.md).
1. Pada halaman **Buat bucket vektor**, **Tag** adalah opsi saat membuat bucket vektor baru.
1. Masukkan nama untuk bucket 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 bucket vektor baru Anda, pilih **Buat bucket vektor**.
### Penggunaan API REST
Untuk informasi tentang dukungan Amazon S3 REST API untuk membuat bucket vektor dengan tag, lihat bagian berikut di Referensi API Vektor *Amazon S3*:
[CreateVectorBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_CreateVectorBucket.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 bucket vektor dengan tag dengan menggunakan. AWS CLI Untuk menggunakan perintah ganti *user input placeholders* dengan informasi Anda sendiri.
Saat membuat bucket vektor, Anda harus memberikan detail konfigurasi dan menggunakan konvensi penamaan berikut: `example-vector-bucket`
```
aws s3vector create-vector-bucket --vector-bucket-name acc-bucket \
--tags Department=Accounting,Stage=Prod
```
# Menambahkan tag ke bucket vektor
Anda dapat menambahkan tag ke bucket vektor Amazon S3 dan memodifikasi tag ini. Tidak ada biaya tambahan untuk menggunakan tag pada bucket 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 bucket vektor, lihat. [Menggunakan tag dengan ember vektor S3](s3-vectors-tags.md)
## Izin
Untuk menambahkan tag ke bucket vektor, Anda harus memiliki izin berikut:
+ `s3vectors:TagResource`
## Memecahkan masalah kesalahan
Jika Anda mengalami kesalahan saat mencoba menambahkan tag ke bucket vektor, Anda dapat melakukan hal berikut:
+ Pastikan Anda memiliki [Izin](#add-bucket-tag-permissions) yang diperlukan untuk menambahkan tag ke bucket 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 bucket 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 bucket 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 **ember vektor**.
1. Pilih nama bucket 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 bucket 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 bucket 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 \
--tags Stage=Prod,CostCenter=Marketing
```
# Melihat tag ember vektor
Anda dapat melihat atau mencantumkan tag yang diterapkan ke bucket vektor Amazon S3. Untuk informasi selengkapnya tentang menandai bucket vektor, lihat. [Menggunakan tag dengan ember vektor S3](s3-vectors-tags.md)
## Izin
Untuk melihat tag yang diterapkan ke bucket vektor, Anda harus memiliki izin berikut:
+ `s3vectors:ListTagsForResource`
## Memecahkan masalah kesalahan
Jika Anda mengalami kesalahan saat mencoba membuat daftar atau melihat tag bucket vektor, Anda dapat melakukan hal berikut:
+ Pastikan Anda memiliki [Izin](#view-bucket-tag-permissions) yang diperlukan untuk melihat atau mencantumkan tag bucket vektor.
## Langkah-langkah
Anda dapat melihat tag yang diterapkan ke bucket vektor dengan 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 bucket 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 **ember vektor**.
1. Pilih nama bucket vektor.
1. Pilih tab **Properti**.
1. Gulir ke bagian **Tag** untuk melihat semua tag yang diterapkan ke bucket 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 bucket vektor berdasarkan AWS layanan.
### Penggunaan API REST
Untuk informasi tentang dukungan Amazon S3 REST API untuk melihat tag yang diterapkan ke bucket 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 ke bucket 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
```
# Menghapus tag dari bucket vektor
Anda dapat menghapus tag dari ember vektor S3. AWS Tag adalah pasangan nilai kunci yang menyimpan metadata tentang sumber daya, dalam hal ini bucket vektor Amazon S3. Untuk informasi selengkapnya tentang menandai bucket vektor, lihat. [Menggunakan tag dengan ember vektor S3](s3-vectors-tags.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 bucket vektor.
## Izin
Untuk menghapus tag dari bucket vektor, Anda harus memiliki izin berikut:
+ `s3vectors:UntagResource`
## Memecahkan masalah kesalahan
Jika Anda mengalami kesalahan saat mencoba menghapus tag dari bucket vektor, Anda dapat melakukan hal berikut:
+ Pastikan Anda memiliki [Izin](#delete-bucket-tag-permissions) yang diperlukan untuk menghapus tag dari bucket vektor.
## Langkah-langkah
Anda dapat menghapus tag dari bucket 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 bucket 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 **ember vektor**.
1. Pilih nama bucket 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 bucket 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 bucket 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 \
--tag-keys CostCenter Department
```