Crea un' WebSocket API in API Gateway

Puoi creare un' WebSocket API nella console API Gateway, utilizzando il comando AWS CLI create-api o utilizzando il CreateApi comando in un AWS SDK. Le seguenti procedure mostrano come creare una nuova API. WebSocket

Nota

WebSocket Le API supportano solo TLS 1.2. Le versioni precedenti di TLS non sono supportate.

Crea un' WebSocketAPI utilizzando i comandi AWS CLI

La creazione di un' WebSocket API utilizzando AWS CLI richiede la chiamata del comando create-api come illustrato nell'esempio seguente, che crea un'API con l'espressione di selezione del $request.body.action percorso:

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

Output di esempio:

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

Creare un' WebSocketAPI utilizzando la console API Gateway

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

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

3. In Nome API immetti il nome dell'API.

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

5. Esegui una di queste 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.