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.

# Référencez un fichier externe de OpenAPI spécification avec Infrastructure Composer
<a name="using-composer-external-files-examples-example1"></a>

Cet exemple utilise Infrastructure Composer depuis la console pour référencer un fichier de OpenAPI spécification externe qui définit une API GatewayREST API.

Créez d'abord un nouveau projet depuis la page d'**accueil** d'Infrastructure Composer.

Activez ensuite la **synchronisation locale** en sélectionnant **Activer la synchronisation locale** **dans le menu**. Créez un nouveau dossier nommé`demo`, autorisez l'invite à afficher les fichiers, puis sélectionnez **Activer**. Lorsque vous y êtes invité, sélectionnez **Enregistrer les modifications**.

![La fenêtre de synchronisation locale Infrastructure Composer Activate avec un dossier de projet de démonstration sélectionné et le bouton Activer est prêt à être sélectionné.](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_use_ex_11.png)


Ensuite, faites glisser une carte Amazon API Gateway sur le canevas. Sélectionnez **Détails** pour afficher le panneau **des propriétés des ressources**.

![Une ressource API Gateway sur le canevas avec le panneau des propriétés des ressources ouvert.](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_use_ex_12.png)


Dans le panneau **des propriétés de la ressource**, configurez les éléments suivants et **enregistrez**.
+ Sélectionnez l'option **Utiliser un fichier externe pour la définition de l'API**.
+ Entrée `./api-spec.yaml` en tant que **chemin relatif vers le fichier externe**

![Une fenêtre affichant la case à cocher marquée sous Utiliser un fichier externe pour la définition de l'API et un chemin relatif vers un fichier externe défini.](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_use_ex_13.png)


Cela crée le répertoire suivant sur notre machine locale :

```
demo
└── api-spec.yaml
```

Vous pouvez maintenant configurer le fichier externe sur notre machine locale. À l'aide de notre IDE, ouvrez le fichier `api-spec.yaml` situé dans le dossier de votre projet. Remplacez son contenu par ce qui suit :

```
openapi: '3.0'
info: {}
paths:
  /:
    get:
      responses: {}
    post:
      x-amazon-apigateway-integration:
        credentials:
          Fn::GetAtt:
            - ApiQueuesendmessageRole
            - Arn
        httpMethod: POST
        type: aws
        uri:
          Fn::Sub: arn:${AWS::Partition}:apigateway:${AWS::Region}:sqs:path/${AWS::AccountId}/${Queue.QueueName}
        requestParameters:
          integration.request.header.Content-Type: '''application/x-www-form-urlencoded'''
        requestTemplates:
          application/json: Action=SendMessage&MessageBody={"data":$input.body}
        responses:
          default:
            statusCode: 200
      responses:
        '200':
          description: 200 response
```

Dans la vue **Modèle** d'Infrastructure Composer, vous pouvez voir qu'Infrastructure Composer a automatiquement mis à jour votre modèle pour référencer le fichier externe.

![La vue du modèle Infrastructure Composer montrant le code de votre infrastructure configuré pour référencer le fichier externe.](http://docs.aws.amazon.com/fr_fr/infrastructure-composer/latest/dg/images/aac_use_ex_07.png)