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à.

# Creazione di una raccolta (CLI)
<a name="serverless-create-cli"></a>

Utilizza le procedure in questa sezione per creare una raccolta OpenSearch Serverless utilizzando. AWS CLI

**Topics**
+ [Prima di iniziare](#serverless-create-cli-before-you-begin)
+ [Creazione di una raccolta](#serverless-create-cli-creating)
+ [Creazione di una raccolta con un indice di arricchimento semantico automatico](#serverless-create-cli-automatic-semantic-enrichment)

## Prima di iniziare
<a name="serverless-create-cli-before-you-begin"></a>

Prima di creare una raccolta utilizzando la AWS CLI, utilizzate la procedura seguente per creare le politiche richieste per la raccolta.

**Nota**  
In ciascuna delle seguenti procedure, quando si specifica un nome per una raccolta, il nome deve soddisfare i seguenti criteri:  
È unico per il tuo account e Regione AWS
Contiene solo lettere minuscole a-z, i numeri da 0 a 9 e i trattini (-)
Contiene da 3 a 32 caratteri

**Per creare le politiche necessarie per una raccolta**

1. Aprite AWS CLI ed eseguite il comando seguente per creare una [politica di crittografia](serverless-encryption.md) con un modello di risorse che corrisponda al nome previsto della raccolta. 

   ```
   &aws opensearchserverless create-security-policy \
     --name policy name \
     --type encryption --policy "{\"Rules\":[{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/collection name\"]}],\"AWSOwnedKey\":true}"
   ```

   Ad esempio, se intendi dare un nome all'*applicazione dei log* della raccolta, potresti creare una policy di crittografia come questa:

   ```
   &aws opensearchserverless create-security-policy \
     --name logs-policy \
     --type encryption --policy "{\"Rules\":[{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AWSOwnedKey\":true}"
   ```

   Se prevedi di utilizzare la policy per raccolte aggiuntive, puoi rendere la regola più ampia, come `collection/logs*` o `collection/*`.

1. Eseguite il comando seguente per configurare le impostazioni di rete per la raccolta utilizzando una [politica di rete](serverless-network.md). È possibile creare policy di rete dopo aver creato una raccolta, tuttavia consigliamo di farlo prima.

   ```
   &aws opensearchserverless create-security-policy \
     --name policy name \
     --type network --policy "[{\"Description\":\"description\",\"Rules\":[{\"ResourceType\":\"dashboard\",\"Resource\":[\"collection\/collection name\"]},{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/collection name\"]}],\"AllowFromPublic\":true}]"
   ```

   Utilizzando l'esempio precedente *applicazione-log*, è possibile creare la seguente policy di rete:

   ```
   &aws opensearchserverless create-security-policy \
     --name logs-policy \
     --type network --policy "[{\"Description\":\"Public access for logs collection\",\"Rules\":[{\"ResourceType\":\"dashboard\",\"Resource\":[\"collection\/logs-application\"]},{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AllowFromPublic\":true}]"
   ```

## Creazione di una raccolta
<a name="serverless-create-cli-creating"></a>

La procedura seguente utilizza l'azione [CreateCollection](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateCollection.html)API per creare una raccolta di tipo `SEARCH` o`TIMESERIES`. Se non specifichi un tipo di raccolta nella richiesta, il valore predefinito sarà `TIMESERIES`. Per ulteriori informazioni su questi tipi, vedere[Scelta di un tipo di raccolta](serverless-overview.md#serverless-usecase). Per creare una raccolta di *ricerca vettoriale*, vedere[Lavorare con le raccolte di ricerca vettoriale](serverless-vector-search.md). 

Se la raccolta è crittografata con un Chiave di proprietà di AWS, `kmsKeyArn` è `auto` anziché un ARN.

**Importante**  
Dopo aver creato una raccolta, non potrai accedervi a meno che non corrisponda a una policy di accesso ai dati. Per ulteriori informazioni, consulta [Controllo dell'accesso ai dati per Amazon OpenSearch Serverless](serverless-data-access.md).

**Come creare una raccolta**

1. Verifica di aver creato le politiche richieste descritte in[Prima di iniziare](#serverless-create-cli-before-you-begin).

1. Eseguire il seguente comando seguente. Per `type` specificare `SEARCH` o`TIMESERIES`.

   ```
   &aws opensearchserverless create-collection --name "collection name" --type collection type --description "description"
   ```

## Creazione di una raccolta con un indice di arricchimento semantico automatico
<a name="serverless-create-cli-automatic-semantic-enrichment"></a>

Utilizzare la procedura seguente per creare una nuova raccolta OpenSearch Serverless con un indice configurato per l'arricchimento semantico [automatico](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-semantic-enrichment.html). La procedura utilizza l'azione OpenSearch Serverless [CreateIndex](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_CreateIndex.html)API.

**Per creare una nuova raccolta con un indice configurato per l'arricchimento semantico automatico**

Eseguite il comando seguente per creare la raccolta e un indice.

```
&aws opensearchserverless create-index \
--region Region ID \
--id collection name --index-name index name \
--index-schema \
'mapping in json'
```

Ecco un esempio:

```
&aws opensearchserverless create-index \
--region us-east-1 \
--id conversation_history --index-name conversation_history_index \
--index-schema \ 
'{
    "mappings": {
        "properties": {
            "age": {
                "type": "integer"
            },
            "name": {
                "type": "keyword"
            },
            "user_description": {
                "type": "text"
            },
            "conversation_history": {
                "type": "text",
                "semantic_enrichment": {
                    "status": "ENABLED",
                    // Specifies the sparse tokenizer for processing multi-lingual text
                    "language_option": "MULTI-LINGUAL", 
                    // If embedding_field is provided, the semantic embedding field will be set to the given name rather than original field name + "_embedding"
                    "embedding_field": "conversation_history_user_defined" 
                }
            },
            "book_title": {
                "type": "text",
                "semantic_enrichment": {
                    // No embedding_field is provided, so the semantic embedding field is set to "book_title_embedding"
                    "status": "ENABLED",
                    "language_option": "ENGLISH"
                }
            },
            "abstract": {
                "type": "text",
                "semantic_enrichment": {
                    // If no language_option is provided, it will be set to English.
                    // No embedding_field is provided, so the semantic embedding field is set to "abstract_embedding"
                    "status": "ENABLED" 
                }
            }
        }
    }
}'
```