Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Exemples d'API de gestion d'API Gateway utilisant AWS CLI
<a name="cli_apigatewaymanagementapi_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de l'API AWS Command Line Interface with API Gateway Management.

Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `delete-connection`
<a name="apigatewaymanagementapi_DeleteConnection_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`delete-connection`.

**AWS CLI**  
**Pour supprimer une WebSocket connexion**  
L'`delete-connection`exemple suivant déconnecte un client de l' WebSocket API spécifiée.  

```
aws apigatewaymanagementapi delete-connection \
    --connection-id L0SM9cOFvHcCIhw= \
    --endpoint-url https://aabbccddee.execute-api.us-west-2.amazonaws.com/prod
```
Cette commande ne produit aucune sortie.  
Pour plus d’informations, consultez [Utilisation des commandes @connections dans votre service dorsal](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-how-to-call-websocket-api-connections.html) dans le *Guide du développeur Amazon API Gateway*.  
+  Pour plus de détails sur l'API, reportez-vous [DeleteConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewaymanagementapi/delete-connection.html)à la section *Référence des AWS CLI commandes*. 

### `get-connection`
<a name="apigatewaymanagementapi_GetConnection_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`get-connection`.

**AWS CLI**  
**Pour obtenir des informations sur une WebSocket connexion**  
L'`get-connection`exemple suivant décrit une connexion à l' WebSocket API spécifiée.  

```
aws apigatewaymanagementapi get-connection \
    --connection-id L0SM9cOFvHcCIhw= \
    --endpoint-url https://aabbccddee.execute-api.us-west-2.amazonaws.com/prod
```
Sortie :  

```
{
    "ConnectedAt": "2020-04-30T20:10:33.236Z",
    "Identity": {
        "SourceIp": "192.0.2.1"
    },
    "LastActiveAt": "2020-04-30T20:10:42.997Z"
}
```
Pour plus d’informations, consultez [Utilisation des commandes @connections dans votre service dorsal](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-how-to-call-websocket-api-connections.html) dans le *Guide du développeur Amazon API Gateway*.  
+  Pour plus de détails sur l'API, reportez-vous [GetConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewaymanagementapi/get-connection.html)à la section *Référence des AWS CLI commandes*. 

### `post-to-connection`
<a name="apigatewaymanagementapi_PostToConnection_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`post-to-connection`.

**AWS CLI**  
**Pour envoyer des données à une WebSocket connexion**  
L'`post-to-connection`exemple suivant envoie un message à un client connecté à l' WebSocket API spécifiée.  

```
aws apigatewaymanagementapi post-to-connection \
    --connection-id L0SM9cOFvHcCIhw= \
    --data "Hello from API Gateway!" \
    --endpoint-url https://aabbccddee.execute-api.us-west-2.amazonaws.com/prod
```
Cette commande ne produit aucune sortie.  
Pour plus d’informations, consultez [Utilisation des commandes @connections dans votre service dorsal](https://docs.aws.amazon.com/apigateway/latest/developerguide/apigateway-how-to-call-websocket-api-connections.html) dans le *Guide du développeur Amazon API Gateway*.  
+  Pour plus de détails sur l'API, reportez-vous [PostToConnection](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/apigatewaymanagementapi/post-to-connection.html)à la section *Référence des AWS CLI commandes*.