Creazione di API WebSocket in Gateway API - Gateway Amazon API
Creazione di un'API WebSocket mediante comandi AWS CLICreazione di un'API WebSocket mediante la console API Gateway

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 API WebSocket in Gateway API

È possibile creare un'API WebSocket nella console Gateway API tramite il comando create-api di AWS CLI o il comando CreateApi in un AWS SDK. Le procedure seguenti mostrano come creare una nuova API WebSocket.

Nota

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

Creazione di un'API WebSocket mediante comandi AWS CLI

Il comando create-api 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"
}

Creazione di un'API WebSocket mediante la console API Gateway

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

Importante

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

Per creare un'API WebSocket mediante la console API Gateway

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

  2. In WebSocket API (API WebSocket), scegliere Build (Crea). 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.