As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Faça referência a um arquivo externo de OpenAPI especificação com o Infrastructure Composer
<a name="using-composer-external-files-examples-example1"></a>

Este exemplo usa o Infrastructure Composer do console para referenciar um arquivo de OpenAPI especificação externo que define um API GatewayREST API.

Primeiro, crie um novo projeto na página **inicial** do Infrastructure Composer.

Em seguida, ative a **sincronização local** selecionando **Ativar sincronização local** no **Menu**. Crie uma nova pasta chamada`demo`, permita que o prompt visualize os arquivos e selecione **Ativar**. Quando solicitado, selecione **Salvar alterações**.

![A janela de sincronização local do Infrastructure Composer Activate com uma pasta de projeto de demonstração selecionada e o botão Ativar está pronto para ser selecionado.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_use_ex_11.png)


Em seguida, arraste um cartão do Amazon API Gateway para a tela. Selecione **Detalhes** para abrir o painel **de propriedades do recurso**.

![Um recurso do API Gateway na tela com o painel de propriedades do recurso aberto.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_use_ex_12.png)


No painel **Propriedades do recurso**, configure o seguinte e **salve**.
+ Selecione a opção **Usar arquivo externo para definição de API**.
+ Entrada `./api-spec.yaml` como **caminho relativo para o arquivo externo**

![Uma janela mostrando a caixa de seleção marcada em Usar arquivo externo para definição de API e um caminho relativo para um arquivo externo definido.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_use_ex_13.png)


Isso cria o seguinte diretório em nossa máquina local:

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

Agora, você pode configurar o arquivo externo em nossa máquina local. Usando nosso IDE, abra o arquivo `api-spec.yaml` localizado na pasta do seu projeto. Substitua seu conteúdo pelo seguinte:

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

Na visualização **Modelo** do Infrastructure Composer, você pode ver que o Infrastructure Composer atualizou automaticamente seu modelo para referenciar o arquivo externo.

![A visualização do modelo do Infrastructure Composer mostrando seu código de infraestrutura configurado para referenciar o arquivo externo.](http://docs.aws.amazon.com/pt_br/infrastructure-composer/latest/dg/images/aac_use_ex_07.png)