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

# Fai riferimento a un file esterno di OpenAPI specifiche con Infrastructure Composer
<a name="using-composer-external-files-examples-example1"></a>

Questo esempio utilizza Infrastructure Composer dalla console per fare riferimento a un file di OpenAPI specifiche esterno che definisce un API GatewayREST API.

Innanzitutto, crea un nuovo progetto dalla **home page** di Infrastructure Composer.

Quindi, attiva la **sincronizzazione locale** selezionando **Attiva sincronizzazione locale** dal **menu**. Crea una nuova cartella denominata`demo`, consenti alla richiesta di visualizzare i file e seleziona **Attiva**. Quando richiesto, seleziona **Salva** modifiche.

![La finestra di sincronizzazione locale di Infrastructure Composer Activate con una cartella di progetto demo selezionata e il pulsante Activate è pronto per essere selezionato.](http://docs.aws.amazon.com/it_it/infrastructure-composer/latest/dg/images/aac_use_ex_11.png)


Successivamente, trascina una scheda Amazon API Gateway sull'area di disegno. Seleziona **Dettagli** per visualizzare il pannello **delle proprietà delle risorse**.

![Una risorsa API Gateway sull'area di lavoro con il pannello delle proprietà della risorsa aperto.](http://docs.aws.amazon.com/it_it/infrastructure-composer/latest/dg/images/aac_use_ex_12.png)


Dal pannello **delle proprietà delle risorse**, configura quanto segue e **salva**.
+ Seleziona l'opzione **Usa file esterno per la definizione dell'API**.
+ Immissione `./api-spec.yaml` come **percorso relativo al file esterno**

![Una finestra che mostra la casella di controllo contrassegnata in Usa un file esterno per la definizione dell'API e un percorso relativo a un file esterno definito.](http://docs.aws.amazon.com/it_it/infrastructure-composer/latest/dg/images/aac_use_ex_13.png)


Questo crea la seguente directory sul nostro computer locale:

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

Ora puoi configurare il file esterno sul nostro computer locale. Usando il nostro IDE, apri il file che `api-spec.yaml` si trova nella cartella del tuo progetto. Sostituisci il suo contenuto con quanto segue:

```
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
```

Nella vista **Modello** di Infrastructure Composer, puoi vedere che Infrastructure Composer ha aggiornato automaticamente il modello in modo che faccia riferimento al file esterno.

![La visualizzazione del modello di Infrastructure Composer che mostra il codice dell'infrastruttura configurato per fare riferimento al file esterno.](http://docs.aws.amazon.com/it_it/infrastructure-composer/latest/dg/images/aac_use_ex_07.png)