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

# Crea WebSocket APIs in API Gateway
<a name="apigateway-websocket-api-create-empty-api"></a>

Puoi creare un' WebSocket API nella console API Gateway, utilizzando il comando AWS CLI [create-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html) o utilizzando il `CreateApi` comando in un AWS SDK. Le seguenti procedure mostrano come creare una nuova API. WebSocket 

**Nota**  
WebSocket APIs supporta solo TLS 1.2 e TLS 1.3. Le versioni precedenti di TLS non sono supportate.

## Crea un' WebSocket API utilizzando i comandi AWS CLI
<a name="apigateway-websocket-api-create-using-awscli"></a>

Il comando [create-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html) seguente crea un’API con l’espressione di selezione dell’instradamento `$request.body.action`:

```
aws apigatewayv2 --region us-east-1 create-api --name "myWebSocketApi3" --protocol-type WEBSOCKET --route-selection-expression '$request.body.action'
```

L'output sarà simile al seguente:

```
{
    "ApiKeySelectionExpression": "$request.header.x-api-key",
    "Name": "myWebSocketApi3",
    "CreatedDate": "2018-11-15T06:23:51Z",
    "ProtocolType": "WEBSOCKET",
    "RouteSelectionExpression": "'$request.body.action'",
    "ApiId": "aabbccddee"
}
```

## Creare un' WebSocket API utilizzando la console API Gateway
<a name="apigateway-websocket-api-create-using-console"></a>

Puoi creare un' WebSocket API nella console scegliendo il WebSocket protocollo e assegnando un nome all'API.

**Importante**  
Dopo aver creato l'API, non puoi modificare il protocollo scelto per la stessa. Non è possibile convertire un' WebSocket API in un'API REST o viceversa.

**Per creare un' WebSocket API utilizzando la console API Gateway**

1. Accedere alla console API Gateway e scegliere **Create API (Crea API)**.

1. In **WebSocket API**, scegli **Build**. Sono supportati solo gli endpoint regionali.

1. In **Nome API** immetti il nome dell'API.

1. Per **Espressione di selezione dell'instradamento** immetti un valore. Ad esempio, `$request.body.action`. 

   Per ulteriori informazioni sulle espressioni di selezione della route, consulta [Espressioni di selezione dell'instradamento](websocket-api-develop-routes.md#apigateway-websocket-api-route-selection-expressions).

1. Esegui una delle seguenti operazioni:
   + Scegli **Crea API vuota** per creare un'API senza instradamenti.
   + Scegli **Successivo** per collegare gli instradamenti all'API.

   Puoi collegare gli instradamenti dopo aver creato l'API.