Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Indici vettoriali
**Nota**
Scegli con attenzione i parametri di configurazione dell’indice vettoriale. Dopo aver creato un indice vettoriale, non è possibile aggiornare il nome dell’indice vettoriale, la dimensione, la metrica della distanza o le chiavi di metadati non filtrabili. Per modificare uno di questi valori, occorre creare un nuovo indice vettoriale.
Gli indici vettoriali sono risorse all’interno di un bucket vettoriale che archiviano e organizzano i dati vettoriali per eseguire operazioni di ricerca per similarità in modo efficiente. Quando si crea un indice vettoriale, si specifica la metrica della distanza (`Cosine` o `Euclidean`), il numero di dimensioni che un vettore deve avere e, facoltativamente, un elenco di campi di metadati da escludere dal filtro durante le query di somiglianza.
Per ulteriori informazioni sui limiti di indici vettoriali per bucket, sui limiti di vettori per indice e sui limiti di dimensione per vettore, consulta [Limitazioni e restrizioni](s3-vectors-limitations.md).
Ogni indice vettoriale dispone di un nome della risorsa Amazon (ARN) univoco. Gli ARNs indici vettoriali seguono il seguente formato:
```
arn:aws:s3vectors:region:account-id:bucket/bucket-name/index/index-name
```
## Requisiti per la denominazione degli indici vettoriali
+ I nomi degli indici vettoriali devono essere univoci all’interno del bucket vettoriale.
+ I nomi degli indici vettoriali devono essere composti da un numero di caratteri compreso tra 3 e 63.
+ I caratteri validi sono lettere minuscole (a-z), numeri (0-9), trattini (-) e punti (.).
+ I nomi degli indici vettoriali devono iniziare e terminare con una lettera o un numero.
## Requisiti per la dimensione
Una dimensione è il numero di valori presenti in un vettore. Tutti i vettori aggiunti all’indice devono avere esattamente questo numero di valori.
+ Una dimensione deve essere un numero intero compreso tra 1 e 4096.
+ Una dimensione più grande richiede più spazio di archiviazione.
## Opzioni di metrica della distanza
La metrica della distanza specifica come viene calcolata la somiglianza tra i vettori. Quando si creano embedding vettoriali, si sceglie la metrica della distanza consigliata dal modello di embedding per ottenere risultati più accurati.
+ **Coseno**: misura il coseno dell’angolo tra i vettori. Ideale per vettori normalizzati e quando la direzione è più importante della grandezza.
+ **Euclideo**: misura la distanza in linea retta tra i vettori. Ideale quando sia la direzione sia la grandezza sono importanti.
## Chiavi di metadati non filtrabili
Le chiavi di metadati consentono di collegare informazioni aggiuntive ai vettori come coppie chiave-valore durante l’archiviazione e il recupero. Per impostazione predefinita, tutti i metadati sono filtrabili, quindi possono essere utilizzati per filtrare i risultati delle query. Tuttavia, è possibile designare chiavi di metadati specifiche come non filtrabili per archiviare le informazioni con vettori senza utilizzarle per il filtro.
A differenza delle chiavi di metadati predefinite, queste chiavi non possono essere utilizzate come filtri di query. Le chiavi di metadati non filtrabili possono essere recuperate ma non possono essere ricercate, sottoposte a query o filtrate. È possibile accedervi solo dopo aver individuato l’indice.
Le chiavi di metadati non filtrabili consentono di arricchire i vettori con un contesto aggiuntivo che può essere recuperato con i risultati della ricerca senza essere sottoposto al filtro. Un esempio comune di chiave di metadati non filtrabili è quando si incorpora un testo nei vettori e si desidera includere il testo originale come metadati non filtrabili. Ciò consente di restituire il testo di origine insieme ai risultati della ricerca vettoriale senza aumentare i limiti di dimensione dei metadati filtrabili. Altri esempi includono la memorizzazione dei timestamp di creazione, della fonte o delle informazioni descrittive URLs puramente a scopo di riferimento. È possibile accedere alle chiavi di metadati non filtrabili durante il recupero dei vettori ma, a differenza delle chiavi di metadati predefinite, queste chiavi non possono essere utilizzate come filtri di query.
Di seguito sono riportati i requisiti per le chiavi di metadati non filtrabili.
+ Le chiavi di metadati non filtrabili devono essere univoche all’interno dell’indice vettoriale.
+ Le chiavi di metadati non filtrabili devono essere composte da un numero di caratteri compreso tra 1 e 63.
+ Le chiavi di metadati non filtrabili non possono essere modificate dopo la creazione dell’indice vettoriale.
+ S3 Vectors supporta fino a 10 chiavi di metadati non filtrabili per indice.
Per ulteriori informazioni sulle chiavi di metadati non filtrabili, consulta [Metadati non filtrabili](s3-vectors-metadata-filtering.md#s3-vectors-metadata-filtering-non-filterable).
**Topics**
+ [Requisiti per la denominazione degli indici vettoriali](#s3-vectors-indexes-naming)
+ [Requisiti per la dimensione](#s3-vectors-indexes-dimensions)
+ [Opzioni di metrica della distanza](#s3-vectors-indexes-distance-metrics)
+ [Chiavi di metadati non filtrabili](#s3-vectors-indexes-metadata)
+ [Creazione di un indice vettoriale in un bucket vettoriale](s3-vectors-create-index.md)
+ [Elenco degli indici vettoriali](s3-vectors-index-list.md)
+ [Eliminazione di un indice vettoriale](s3-vectors-index-delete.md)
+ [Utilizzo di tag con indici vettoriali S3](vector-index-tagging.md)
# Creazione di un indice vettoriale in un bucket vettoriale
**Nota**
Scegli con attenzione i parametri di configurazione dell’indice vettoriale. Dopo aver creato un indice vettoriale, non è possibile aggiornare il nome dell’indice vettoriale, la dimensione, la metrica della distanza o le chiavi di metadati non filtrabili. Per modificare uno di questi valori, occorre creare un nuovo indice vettoriale.
Un indice vettoriale è una risorsa all’interno di un bucket vettoriale che archivia e organizza i dati vettoriali per eseguire ricerche per similarità efficienti. Quando si crea un indice vettoriale, si definiscono le caratteristiche che tutti i vettori di tale indice devono condividere, ad esempio la dimensione, la metrica della distanza utilizzata per i calcoli della similarità e, facoltativamente, le chiavi di metadati non filtrabili. È inoltre possibile configurare facoltativamente impostazioni e tag di crittografia dedicati per l'indice vettoriale al momento della creazione dell'indice. Per ulteriori informazioni sui requisiti di denominazione degli indici vettoriali, sui requisiti delle dimensioni, sulle opzioni di metrica della distanza e sulle chiavi di metadati non filtrabili, consulta [Limitazioni e restrizioni](s3-vectors-limitations.md). Per ulteriori informazioni sull'impostazione della configurazione di crittografia per gli indici vettoriali, vedere. [Protezione e crittografia dei dati in S3 Vectors](s3-vectors-data-encryption.md) Per ulteriori informazioni sull'impostazione dei tag, vedere. [Utilizzo di tag con bucket vettoriali S3](s3-vectors-tags.md)
Gli indici vettoriali devono essere creati all’interno di un bucket vettoriale esistente e richiedono parametri di configurazione specifici che non possono essere modificati dopo la creazione.
## Utilizzo della console S3
**Come creare un indice vettoriale**
1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione, scegli **Bucket di vettori**.
1. Nell’elenco dei bucket vettoriali, seleziona il nome del bucket in cui desideri creare un indice vettoriale.
1. Scegli **Crea indice di vettore**.
1. Per **Nome dell’indice di vettore**, inserisci un nome per l’indice vettoriale.
I nomi degli indici vettoriali devono essere univoci all’interno del bucket vettoriale. Il nome dell’indice deve essere composto da un numero di caratteri compreso tra 3 e 63. I caratteri validi sono lettere minuscole (a-z), numeri (0-9), trattini (-) e punti (.). Per ulteriori informazioni sui requisiti di denominazione dell’indice vettoriale, consulta [Limitazioni e restrizioni](s3-vectors-limitations.md).
1. Per **Dimensione**, inserisci il numero di valori in ogni vettore.
**Nota**
Il valore per **Dimensione** determina quanti valori numerici conterrà ogni vettore.
Tutti i vettori aggiunti a questo indice devono avere esattamente questo numero di valori.
La dimensione deve essere compresa tra 1 e 4096.
Una dimensione più grande richiede più spazio di archiviazione.
Scegli in base alle dimensioni di output del modello di embedding.
Per ulteriori informazioni sui requisiti di dimensione, consulta [Limitazioni e restrizioni](s3-vectors-limitations.md).
1. Per **Metrica della distanza**, scegli una delle seguenti opzioni:
+ **Coseno**: misura il coseno dell’angolo tra i vettori. Ideale per vettori normalizzati e quando la direzione è più importante della grandezza
+ **Euclideo**: misura la distanza in linea retta tra i vettori. Ideale quando sia la direzione sia la grandezza sono importanti.
1. (Facoltativo) In **Metadati non filtrabili**, configura le chiavi di metadati che verranno archiviate ma non utilizzate per il filtro:
Per aggiungere chiavi di metadati non filtrabili:
1. Scegliere **Add key (Aggiungi chiave)**.
1. Inserisci un nome per la chiave (da 1 a 63 caratteri e univoco all’interno dell’indice vettoriale).
1. Ripeti l’operazione per aggiungere altre chiavi (al massimo 10 chiavi).
**Nota**
È possibile collegare a ciascun vettore i metadati filtrabili come coppie chiave-valore quando si inseriscono dati vettoriali dopo aver creato l’indice vettoriale. Per impostazione predefinita, tutte le chiavi di metadati collegate ai vettori sono filtrabili e possono essere utilizzate come filtri in una query di somiglianza. Solo le chiavi di metadati specificate come non filtrabili durante la creazione dell’indice vettoriale non possono essere utilizzate come filtro. Per ulteriori informazioni sui limiti di dimensione dei metadati per vettore, inclusi i vincoli dei metadati filtrabili e totali, consulta [Limitazioni e restrizioni](s3-vectors-limitations.md).
1. Esamina attentamente la configurazione.
**Nota**
Queste impostazioni non possono essere modificate dopo la creazione.
1. In **Crittografia** scegli **Specifica il tipo di crittografia**. Hai la possibilità di **utilizzare le impostazioni del bucket per la crittografia** o sovrascrivere le impostazioni di crittografia per l'indice vettoriale. **Se sovrascrivi le impostazioni a livello di bucket, hai la possibilità di specificare il tipo di crittografia per l'indice vettoriale come crittografia lato **server con chiavi del servizio di gestione delle AWS chiavi (SSE-KMS) o crittografia lato server con chiavi gestite Amazon S3 (SSE-S3**).** Per ulteriori informazioni sull'impostazione della configurazione di crittografia per gli indici vettoriali, consulta. [Protezione e crittografia dei dati in S3 Vectors](s3-vectors-data-encryption.md)
1. In **Tag (facoltativo)**, puoi aggiungere tag come coppie chiave-valore per monitorare e organizzare i costi degli indici vettoriali utilizzando AWS Billing and Cost Management. Immettere una **chiave** e un **valore**. Per aggiungere un altro tag, scegliere **Add Tag (Aggiungi tag)**. Puoi inserire fino a 50 tag per un indice vettoriale. Per ulteriori informazioni, consulta [Utilizzo di tag con bucket vettoriali S3](s3-vectors-tags.md).
1. Scegli **Crea indice di vettore**.
## Usando il AWS CLI
Per creare un indice vettoriale in un bucket vettoriale, utilizza i seguenti comandi di esempio e sostituisci `user input placeholders` con le informazioni appropriate.
**Esempio 1: creazione di un indice vettoriale con chiavi di metadati non filtrabili**
```
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"]}'
```
**Esempio 2: creazione di un indice vettoriale senza chiavi di metadati non filtrabili**
```
aws s3vectors create-index \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx2" \
--data-type "float32" \
--dimension 4096 \
--distance-metric "euclidean"
```
Inoltre, tutti i metadati (filtrabili e non filtrabili) vengono recuperati allo stesso modo utilizzando le operazioni API `GetVectors`, `ListVectors` o `QueryVectors`. Il seguente comando della CLI mostra come recuperare i vettori con metadati (inclusi i metadati non filtrabili).
Richiesta di esempio:
```
aws s3vectors get-vectors \
--vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx" \
--keys '["vec1", "vec3"]' \
--return-data \
--return-metadata \
```
Risposta di esempio:
```
{
"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"
}
}
]
}
```
La risposta includerà tutti i metadati associati al vettore, indipendentemente dal fatto che siano stati specificati come filtrabili o non filtrabili durante la creazione dell’indice.
## Usando il 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"]}
)
```
------
# Elenco degli indici vettoriali
Puoi visualizzare tutti gli indici vettoriali all’interno di un bucket vettoriale. L’operazione di elenco supporta il filtraggio in base al prefisso per aiutarti a trovare indici specifici quando sono presenti molti indici in un bucket. Per ulteriori informazioni sui `ListIndexes` limiti dei prefissi e sui limiti di risposta, consulta il riferimento [ListIndexes](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListIndexes.html)all'API di Amazon Simple Storage Service.
## Funzionalità di ricerca dei prefissi
La ricerca dei prefissi consente di elencare gli indici che iniziano con un prefisso specifico, semplificando l’organizzazione e la ricerca degli indici vettoriali correlati. Questa funzione è particolarmente utile quando utilizzi convenzioni di denominazione che raggruppano indici correlati:
+ **Per tipo di dati:** `text-embeddings-`, `image-features-`, `audio-vectors-`
+ **Per modello:** `model1-embeddings-`, `model2-vectors-`, `custom-model-`
+ **Per caso d’uso:** `search-index-`, `recommendation-`, `similarity-`
+ **Per ambiente:** `prod-vectors-`, `staging-vectors-`, `dev-vectors-`
### Utilizzo della console S3
**Per elencare gli indici vettoriali**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione a sinistra, scegli **Bucket di vettori**.
1. Nell’elenco dei bucket vettoriali, seleziona il nome del bucket contenente gli indici che desideri visualizzare.
1. La console mostra un elenco completo di tutti gli indici vettoriali nel bucket, tra cui:
+ **Nome**: il nome di ciascun indice.
+ **Data di creazione**: quando l’indice è stato creato.
+ **Nome della risorsa Amazon (ARN)**: nome ARN completo per ciascun indice.
**Per filtrare l’elenco**
1. Inserisci il nome o il prefisso dell’indice nella casella di ricerca sopra l’elenco degli indici. Utilizza i prefissi per trovare gruppi di indici correlati.
1. L’elenco si aggiorna in tempo reale durante la digitazione.
### Utilizzando il AWS CLI
Utilizza i seguenti comandi di esempio e *user input placeholders* sostituiscili con le tue informazioni.
**Per elencare gli indici con un prefisso specifico in un bucket vettoriale**
Richiesta di esempio:
```
aws s3vectors list-indexes \
--vector-bucket-name "amzn-s3-demo-bucket" \
--prefix "idx" \
--max-results 1
```
Risposta di esempio:
```
{
"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"
}
]
}
```
**Per elencare gli indici con impaginazione**
Richiesta di esempio:
```
aws s3vectors list-indexes \
--vector-bucket-name "amzn-s3-demo-bucket" \
--prefix "idx" \
--next-token "lObb29ZkzxMGtBXs97Rkbs26xdtKemu4brsnq2jX8DCocADkILv5cRphemXS3PXXFnQBihQBmESgEeKaGA"
```
Risposta di esempio:
```
{
"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"
}
]
}
```
### Usando il 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)
```
------
# Eliminazione di un indice vettoriale
Puoi eliminare un indice vettoriale quando non è più necessario. Questa operazione rimuove definitivamente l’indice e tutti i vettori che sono memorizzati al suo interno.
**Importante**
Quando elimini un indice vettoriale, è importante tenere in considerazione quanto segue:
È possibile eliminare gli indici vettoriali anche quando contengono vettori
Tutti i vettori memorizzati nell’indice vengono eliminati definitivamente
Tutti i metadati associati a tali vettori vengono definitivamente persi
Questa operazione non può essere annullata
Qualsiasi operazione in corso sull’indice non andrà a buon fine
Le applicazioni che interrogano l’indice riceveranno errori
Il nome dell’indice può essere riutilizzato all’interno del bucket
## Utilizzando il AWS CLI
Prima di eliminare un indice vettoriale, verifica l’indice stesso. Per ulteriori informazioni su come controllare i dettagli dell'indice, consulta [GetIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetIndex.html)*Amazon S3 API* Reference. Per ulteriori informazioni su come elencare i vettori all’interno dell’indice per vedere cosa verrà eliminato, consulta [Elenco degli indici vettoriali](s3-vectors-index-list.md).
Per eliminare un indice vettoriale, utilizza i seguenti comandi di esempio. Sostituisci *user input placeholders* con le informazioni appropriate.
```
aws s3vectors delete-index --vector-bucket-name "amzn-s3-demo-vector-bucket" \
--index-name "idx2"
```
Per ulteriori informazioni su come verificare se l’indice viene eliminato, consulta [Elenco degli indici vettoriali](s3-vectors-index-list.md).
## Utilizzando il 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")
```
------
# Utilizzo di tag con indici vettoriali S3
Un AWS tag è una coppia chiave-valore che contiene i metadati relativi alle risorse, in questo caso gli indici vettoriali di Amazon S3. Puoi taggare gli indici vettoriali S3 quando li crei o gestire i tag sugli indici vettoriali esistenti. Per informazioni generali sui tag, consulta [Tagging per l’allocazione dei costi o il controllo degli accessi basato su attributi (ABAC)](tagging.md).
**Nota**
Non sono previsti costi aggiuntivi per l'utilizzo dei tag sugli indici vettoriali oltre alle tariffe di richiesta dell'API S3 standard. Per ulteriori informazioni, consulta [Prezzi di Amazon S3](https://aws.amazon.com/s3/pricing/).
## Metodi comuni per utilizzare i tag con indici vettoriali
Usa i tag sugli indici vettoriali S3 per:
+ **Allocazione dei** costi: monitora i costi di archiviazione tramite tag di indice vettoriale in AWS Billing and Cost Management. Per ulteriori informazioni, consulta [Utilizzo dei tag per l’allocazione dei costi](tagging.md#using-tags-for-cost-allocation).
+ **Controllo degli accessi basato sugli attributi (ABAC)**: ridimensiona le autorizzazioni di accesso e concedi l'accesso agli indici vettoriali S3 in base ai relativi tag. Per ulteriori informazioni, consulta [Utilizzo dei tag per il controllo degli accessi basato su attributi (ABAC)](tagging.md#using-tags-for-abac).
**Nota**
È possibile utilizzare gli stessi tag sia per l’allocazione dei costi che per il controllo degli accessi.
### ABAC per indici vettoriali S3
Gli indici vettoriali Amazon S3 supportano il controllo degli accessi basato sugli attributi (ABAC) tramite tag. Utilizza chiavi di condizione basate su tag nelle tue AWS organizzazioni, nelle politiche di indicizzazione vettoriale IAM e S3. Per le aziende, ABAC in Amazon S3 supporta l'autorizzazione su più account. AWS
Nelle tue policy IAM, puoi controllare l'accesso agli indici vettoriali S3 in base ai tag dell'indice vettoriale utilizzando le seguenti chiavi di condizione globali:
`aws:ResourceTag/key-name`
Utilizzare questa chiave per confrontare la coppia chiave-valore del tag specificata nella policy con la coppia chiave-valore associata alla risorsa. Ad esempio, puoi richiedere che l'accesso a una risorsa sia consentito solo se la risorsa dispone di una chiave di tag `Dept` collegata al valore `Marketing`. [Per ulteriori informazioni, consulta Controllo dell'accesso alle risorse. AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources)
`aws:RequestTag/key-name`
Utilizzare questa chiave per confrontare la coppia chiave-valore del tag passata nella richiesta con la coppia del tag specificata nella policy. Ad esempio, è possibile controllare che la richiesta includa la chiave del tag `Dept` e che abbia il valore `Accounting`. Per ulteriori informazioni, vedere [Controllo dell'accesso durante AWS le richieste](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-requests). È possibile utilizzare questa chiave di condizione per limitare quali coppie chiave-valore di tag possono essere passate durante le operazioni API `TagResource` e `CreateIndex`.
`aws:TagKeys`
Utilizzare questa chiave per confrontare le chiavi dei tag in una richiesta con quelle specificate nella policy. Nell'utilizzo delle policy per controllare gli accessi tramite tag, è consigliabile utilizzare la chiave di condizione `aws:TagKeys` per definire le chiavi di tag ammesse. Per esempi di policy e ulteriori informazioni, consulta [Controllo dell’accesso in base alle chiavi di tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-tag-keys). Puoi creare un indice vettoriale S3 con tag. Per consentire il tagging durante l’operazione API `CreateVectorBucket`, è necessario creare una policy che comprende entrambe le azioni `s3vectors:TagResource` e `s3vectors:CreateVectorBucket`. È quindi possibile utilizzare la chiave di condizione `aws:TagKeys` per implementare nella richiesta `CreateVectorBucket` specifici tag.
### Esempi di politiche ABAC per indici vettoriali
Vedi i seguenti esempi di politiche ABAC per gli indici vettoriali di Amazon S3.
#### 1.1 - Politica IAM per creare o modificare indici vettoriali con tag specifici
In questa policy IAM, gli utenti o i ruoli con questa policy possono creare indici vettoriali S3 solo se etichettano l'indice vettoriale con la chiave del tag `project` e il valore del tag nella richiesta di creazione dell'indice vettoriale. `Trinity` Possono anche aggiungere o modificare tag sugli indici vettoriali S3 esistenti purché la richiesta includa la coppia chiave-valore del tag. `TagResource` `project:Trinity` Questa politica non concede autorizzazioni di lettura, scrittura o eliminazione sugli indici vettoriali o sui relativi oggetti.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "CreateVectorIndexWithTags",
"Effect": "Allow",
"Action": [
"s3vectors:CreateIndex",
"s3vectors:TagResource"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:RequestTag/project": [
"Trinity"
]
}
}
}
]
}
```
#### 1.2 - Politica IAM per modificare i tag sulle risorse esistenti mantenendo la governance dei tag
In questa policy IAM, i responsabili IAM (utenti o ruoli) possono modificare i tag su un indice vettoriale solo se il valore del tag dell'indice vettoriale corrisponde al valore del `project` tag del principale. `project` Solo i quattro tag`project`, `environment``owner`, e quelli `cost-center` specificati nelle chiavi di `aws:TagKeys` condizione sono consentiti per questi indici vettoriali. Questo aiuta a rafforzare la governance dei tag, previene le modifiche non autorizzate dei tag e mantiene lo schema di tagging coerente tra gli indici vettoriali.
```
{
"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"
]
}
}
}
]
}
```
# Gestione dei tag per gli indici vettoriali
Puoi aggiungere o gestire tag per gli indici vettoriali S3 utilizzando la console Amazon S3, il AWS Command Line Interface (AWS CLI), o utilizzando S3: AWS SDKs, e. APIs [TagResource[UntagResource[ListTagsForResource](https://docs.aws.amazon.com/)](https://docs.aws.amazon.com/)](https://docs.aws.amazon.com/) Per ulteriori informazioni, consulta:
**Topics**
+ [Creazione di indici vettoriali con tag](creating-vector-indexes-with-tags.md)
+ [Aggiungere un tag a un indice vettoriale](adding-tag-vector-index.md)
+ [Visualizzazione dei tag degli indici vettoriali](viewing-vector-index-tags.md)
+ [Eliminazione di un tag da un indice vettoriale](deleting-tag-vector-index.md)
# Creazione di indici vettoriali con tag
Puoi etichettare gli indici vettoriali di Amazon S3 quando li crei. Non sono previsti costi aggiuntivi per l'utilizzo di tag su indici vettoriali oltre alle tariffe di richiesta API S3 standard. Per ulteriori informazioni, consulta [Prezzi di Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Per ulteriori informazioni sull'etichettatura degli indici vettoriali, consulta. [Utilizzo di tag con indici vettoriali S3](vector-index-tagging.md)
## Permissions
Per creare un indice vettoriale con tag, è necessario disporre delle seguenti autorizzazioni:
+ `s3vectors:CreateIndex`
+ `s3vectors:TagResource`
## Risoluzione degli errori
Se si verifica un errore durante il tentativo di creare un indice vettoriale con tag, è possibile effettuare le seguenti operazioni:
+ Verifica di disporre delle [autorizzazioni](#index-tags-permissions) necessarie per creare l'indice vettoriale e aggiungervi un tag.
+ Controllare la policy dell’utente IAM per eventuali condizioni del controllo degli accessi basato su attributi (ABAC). Potrebbe esserti richiesto di etichettare gli indici vettoriali solo con chiavi e valori di tag specifici. Per ulteriori informazioni, consulta [Utilizzo dei tag per il controllo degli accessi basato su attributi (ABAC)](tagging.md#using-tags-for-abac).
## Fasi
Puoi creare un indice vettoriale con tag applicati utilizzando la console Amazon S3,AWS CLI(), AWS Command Line Interface l'API REST di Amazon S3 e. AWS SDKs
### Utilizzo della console S3
**Per creare un indice vettoriale con tag utilizzando la console Amazon S3**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione a sinistra, scegli indici **vettoriali**.
1. Scegli **crea indice vettoriale per creare un nuovo indice vettoriale**.
1. Crea un indice vettoriale come faresti normalmente; vedi. [Creazione di un indice vettoriale in un bucket vettoriale](s3-vectors-create-index.md)
1. Nella pagina **Crea indice vettoriale**, **Tags** è un'opzione per la creazione di un nuovo indice vettoriale.
1. Immettete un nome per l'indice vettoriale.
1. Scegli **Aggiungi nuovo tag** per aprire l’editor di tag e inserisci una coppia chiave-valore di tag. La chiave di tag è obbligatoria, mentre il valore è facoltativo.
1. Per aggiungere un altro tag, scegli nuovamente **Aggiungi nuovo tag**. È possibile inserire fino a 50 coppie chiave-valore di tag.
1. Dopo aver specificato le opzioni per il nuovo indice vettoriale, scegliete **Crea** indice vettoriale.
### Utilizzo della REST API
Per informazioni sul supporto dell'API REST di Amazon S3 per la creazione di un indice vettoriale con tag, consulta la sezione seguente nel riferimento all'API *Amazon S3* Vectors:
[CreateIndex](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_CreateIndex.html)
### Usando il AWS CLI
Per installare AWS CLI, vedere [Installazione di AWS CLI nella](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) *Guida per l'AWS Command Line Interface utente*.
L'esempio CLI seguente mostra come creare un indice vettoriale con tag utilizzando. AWS CLI Per utilizzare il comando, sostituiscilo *user input placeholders* con le tue informazioni.
Quando si crea un indice vettoriale, è necessario fornire i dettagli di configurazione e utilizzare la seguente convenzione di denominazione: `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
```
# Aggiungere un tag a un indice vettoriale
Puoi aggiungere tag agli indici vettoriali di Amazon S3 e modificarli. Non sono previsti costi aggiuntivi per l'utilizzo di tag su indici vettoriali oltre alle tariffe di richiesta API S3 standard. Per ulteriori informazioni, consulta [Prezzi di Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Per ulteriori informazioni sull'etichettatura degli indici vettoriali, consulta. [Utilizzo di tag con indici vettoriali S3](vector-index-tagging.md)
## Permissions
Per aggiungere un tag a un indice vettoriale, è necessario disporre delle seguenti autorizzazioni:
+ `s3vectors:TagResource`
## Risoluzione degli errori
Se si verifica un errore durante il tentativo di aggiungere un tag a un indice vettoriale, è possibile effettuare le seguenti operazioni:
+ Verifica di disporre delle [autorizzazioni](#add-index-tag-permissions) necessarie per aggiungere un tag a un indice vettoriale.
+ Se hai cercato di aggiungere una chiave di tag che inizia con il prefisso AWS riservato`aws:`, modifica la chiave del tag e riprova.
## Fasi
Puoi aggiungere tag agli indici vettoriali utilizzando la console Amazon S3, AWS Command Line Interface ()AWS CLI, l'API REST di Amazon S3 e. AWS SDKs
### Utilizzo della console S3
**Per aggiungere tag a un indice vettoriale utilizzando la console Amazon S3**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione a sinistra, scegli indici **vettoriali**.
1. Scegliete il nome dell'indice vettoriale.
1. Scegliere la scheda **Properties (Proprietà)**.
1. Scorri la sezione **Tag** e scegli **Aggiungi nuovo tag**.
1. Viene visualizzata la pagina **Aggiungi tag**. È possibile inserire fino a 50 coppie chiave-valore di tag.
1. Se si aggiunge un nuovo tag con lo stesso nome di chiave di un tag esistente, il valore del nuovo tag sovrascrive il valore del tag esistente.
1. In queta pagina è anche possibile modificare i valori dei tag esistenti.
1. Dopo aver aggiunto i tag, scegli **Salva le modifiche**.
### Utilizzo della REST API
Per informazioni sul supporto dell'API REST di Amazon S3 per l'aggiunta di tag a un indice vettoriale, consulta la sezione seguente nel riferimento all'API *Amazon S3* Vectors:
[TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_TagResource.html)
### Usando il AWS CLI
Per installare AWS CLI, vedere [Installazione di AWS CLI nella](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) *Guida per l'AWS Command Line Interface utente*.
L'esempio CLI seguente mostra come aggiungere tag a un indice vettoriale utilizzando. AWS CLI Per utilizzare il comando, sostituiscilo *user input placeholders* con le tue informazioni.
```
aws s3vectors tag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tags Stage=Prod,CostCenter=Marketing
```
# Visualizzazione dei tag degli indici vettoriali
Puoi visualizzare o elencare i tag applicati agli indici vettoriali di Amazon S3. Per ulteriori informazioni sull'etichettatura degli indici vettoriali, consulta. [Utilizzo di tag con indici vettoriali S3](vector-index-tagging.md)
## Permissions
Per visualizzare i tag applicati a un indice vettoriale, è necessario disporre delle seguenti autorizzazioni:
+ `s3vectors:ListTagsForResource`
## Risoluzione degli errori
Se si verifica un errore durante il tentativo di elencare o visualizzare i tag di un indice vettoriale, è possibile effettuare le seguenti operazioni:
+ Verifica di disporre delle [autorizzazioni](#view-index-tag-permissions) necessarie per visualizzare o elencare i tag dell'indice vettoriale.
## Fasi
Puoi visualizzare i tag applicati agli indici vettoriali utilizzando la console Amazon S3, la AWS Command Line Interface ()AWS CLI, l'API REST di Amazon S3 e. AWS SDKs
### Utilizzo della console S3
**Per visualizzare i tag applicati a un indice vettoriale utilizzando la console Amazon S3**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione a sinistra, scegli indici **vettoriali**.
1. Scegliete il nome dell'indice vettoriale.
1. Scegliere la scheda **Properties (Proprietà)**.
1. Scorri fino alla sezione **Tag** per visualizzare tutti i tag applicati all'indice vettoriale.
1. La sezione **Tag** mostra i tag definiti dall'utente per impostazione predefinita. Puoi selezionare la scheda AWS-generated tags per visualizzare i tag applicati all'indice vettoriale dai servizi. AWS
### Utilizzo della REST API
Per informazioni sul supporto dell'API REST di Amazon S3 per la visualizzazione dei tag applicati a un indice vettoriale, consulta la sezione seguente nel riferimento all'API Amazon Simple Vectors:
[ListTagsforResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_ListTagsForResource.html)
### Usando il AWS CLI
Per installare AWS CLI, vedere [Installazione di AWS CLI nella](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) *Guida per l'AWS Command Line Interface utente*.
L'esempio CLI seguente mostra come visualizzare i tag applicati a un indice vettoriale. Per utilizzare il comando, sostituiscilo *user input placeholders* con le tue informazioni.
```
aws s3vectors list-tags-for-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index
```
# Eliminazione di un tag da un indice vettoriale
È possibile rimuovere i tag dagli indici vettoriali S3. Un AWS tag è una coppia chiave-valore che contiene i metadati relativi alle risorse, in questo caso gli indici vettoriali di Amazon S3. Per ulteriori informazioni sull'etichettatura degli indici vettoriali, consulta. [Utilizzo di tag con indici vettoriali S3](vector-index-tagging.md)
**Nota**
Se elimini un tag e in seguito scopri che veniva utilizzato per tenere traccia dei costi o per il controllo degli accessi, puoi aggiungere nuovamente il tag all'indice vettoriale.
## Permissions
Per eliminare un tag da un indice vettoriale, devi disporre delle seguenti autorizzazioni:
+ `s3vectors:UntagResource`
## Risoluzione degli errori
Se si verifica un errore durante il tentativo di eliminare un tag da un indice vettoriale, è possibile effettuare le seguenti operazioni:
+ Verifica di disporre delle [autorizzazioni](#delete-index-tag-permissions) necessarie per eliminare un tag da un indice vettoriale.
## Fasi
Puoi eliminare i tag dagli indici vettoriali utilizzando la console Amazon S3, AWS Command Line Interface ()AWS CLI, l'API REST di Amazon S3 e. AWS SDKs
### Utilizzo della console S3
**Per eliminare tag da un indice vettoriale utilizzando la console Amazon S3**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Nel riquadro di navigazione a sinistra, scegli indici **vettoriali**.
1. Scegliete il nome dell'indice vettoriale.
1. Scegliere la scheda **Properties (Proprietà)**.
1. Scorri fino alla sezione **Tag** e seleziona la casella di controllo accanto al tag o ai tag che desideri eliminare.
1. Scegli **Elimina**.
1. Viene visualizzato il pop-up **Elimina tag definiti dall’utente** che chiede di confermare l’eliminazione del tag o dei tag selezionati.
1. Seleziona **Elimina** per confermare.
### Utilizzo della REST API
*Per informazioni sul supporto dell'API REST di Amazon S3 per l'eliminazione di tag da un indice vettoriale, consulta la sezione seguente nel riferimento all'API Amazon S3 Vectors:*
[UntagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_UntagResource.html)
### Usando il AWS CLI
Per installare AWS CLI, vedere [Installazione di AWS CLI nella](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) *Guida per l'AWS Command Line Interface utente*.
L'esempio CLI seguente mostra come eliminare i tag da un indice vettoriale utilizzando. AWS CLI Per utilizzare il comando, sostituiscilo *user input placeholders* con le tue informazioni.
```
aws s3vectors untag-resource \
--resource-arn arn:aws:s3vectors:us-east-1:012345678900:bucket/acc-bucket/index/accounts-index \
--tag-keys CostCenter Department
```