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.

# Exporter le protocole HTTP APIs depuis API Gateway
<a name="http-api-export"></a>

Après avoir créé une API HTTP, vous pouvez exporter une définition OpenAPI 3.0 de votre API à partir d’API Gateway. Vous pouvez choisir une étape à exporter ou exporter la dernière configuration de votre API. Vous pouvez également importer une définition d’API exportée dans API Gateway pour créer une autre API identique. Pour plus d’informations sur l’importation de définitions d’API, consultez [Importation d'une API HTTP](http-api-open-api.md#http-api-import).

## Exporter une définition OpenAPI 3.0 d'une étape à l'aide de la CLI AWS
<a name="http-api-export.stage.example"></a>

La commande [export-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/export-api.html) suivante exporte une définition OpenAPI d’une étape d’API nommée `prod` dans un fichier YAML nommé `stage-definition.yaml`. Le fichier de définition exporté inclut les [extensions API Gateway](api-gateway-swagger-extensions.md) par défaut.

```
aws apigatewayv2 export-api \
    --api-id api-id  \
    --output-type YAML  \
    --specification OAS30 \
    --stage-name prod \
    stage-definition.yaml
```

## Exportez une définition OpenAPI 3.0 des dernières modifications de votre API à l'aide de la CLI AWS
<a name="http-api-export.latest.example"></a>

La commande [export-api](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/export-api.html) suivante exporte une définition OpenAPI d’une API HTTP vers un fichier JSON nommé `latest-api-definition.json`. Étant donné que la commande ne spécifie pas d’étape, API Gateway exporte la dernière configuration de votre API, qu’elle ait été déployée ou non sur une étape. Le fichier de définition exporté n’inclut pas les [extensions API Gateway](api-gateway-swagger-extensions.md).

```
aws apigatewayv2 export-api \
    --api-id api-id  \
    --output-type JSON  \
    --specification OAS30 \
    --no-include-extensions \
    latest-api-definition.json
```

Pour plus d’informations, consultez [ExportAPI](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/apis-apiid-exports-specification.html#apis-apiid-exports-specification-http-methods) dans le document *Référence des API Amazon API Gateway Version 2*.

## Exportation d’une définition OpenAPI 3.0 à l’aide de la console API Gateway
<a name="http-api-export.console"></a>

La procédure suivante illustre comment exporter une définition OpenAPI d’une API HTTP.

**Pour exporter une définition OpenAPI 3.0 à l’aide de la console API Gateway**

1. Connectez-vous à la console API Gateway à l'adresse [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1. Choisissez une API HTTP.

1. Dans le panneau de navigation principal, sous **Développer**, choisissez **Exporter**.

1. Sélectionnez l’une des options suivantes pour exporter votre API :  
![\[Options d'exportation pour HTTP APIs.\]](http://docs.aws.amazon.com/fr_fr/apigateway/latest/developerguide/images/export-http-api.png)

   1. Pour **Source**, sélectionnez une source pour la définition OpenAPI 3.0. Vous pouvez choisir une étape à exporter ou exporter la dernière configuration de votre API.

   1. Activez l’option **Inclure les extensions API Gateway** pour inclure les [extensions API Gateway](api-gateway-swagger-extensions.md).

   1. Pour **Format de sortie**, sélectionnez un format de sortie.

1. Choisissez **Téléchargement**.