Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Referensi file eksternal OpenAPI spesifikasi dengan Infrastructure Composer
<a name="using-composer-external-files-examples-example1"></a>

Contoh ini menggunakan Infrastructure Composer dari konsol untuk mereferensikan file OpenAPI spesifikasi eksternal yang mendefinisikan API Gateway. REST API

Pertama, buat proyek baru dari **halaman** beranda Infrastructure Composer.

Selanjutnya, aktifkan **sinkronisasi lokal** dengan memilih **Aktifkan sinkronisasi lokal** dari **Menu**. Buat folder baru bernama`demo`, izinkan prompt untuk melihat file, dan pilih **Aktifkan**. Saat diminta, pilih **Simpan perubahan**.

![Jendela Infrastructure Composer Activate local sync dengan folder proyek demo yang dipilih dan tombol Activate siap untuk dipilih.](http://docs.aws.amazon.com/id_id/infrastructure-composer/latest/dg/images/aac_use_ex_11.png)


Selanjutnya, seret kartu Amazon API Gateway ke kanvas. Pilih **Detail** untuk memunculkan panel **Resource properties**.

![Sumber daya API Gateway di kanvas dengan panel properti Resource terbuka.](http://docs.aws.amazon.com/id_id/infrastructure-composer/latest/dg/images/aac_use_ex_12.png)


Dari panel **Resource properties**, konfigurasikan berikut ini dan **simpan**.
+ Pilih opsi **Gunakan file eksternal untuk definisi api**.
+ Masukan `./api-spec.yaml` sebagai **jalur relatif ke file eksternal**

![Jendela yang menampilkan kotak centang yang ditandai di bawah Gunakan file eksternal untuk definisi api dan jalur relatif ke file eksternal yang ditentukan.](http://docs.aws.amazon.com/id_id/infrastructure-composer/latest/dg/images/aac_use_ex_13.png)


Ini membuat direktori berikut di mesin lokal kami:

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

Sekarang, Anda dapat mengkonfigurasi file eksternal pada mesin lokal kami. Menggunakan IDE kami, buka yang `api-spec.yaml` terletak di folder proyek Anda. Ganti isinya dengan yang berikut:

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

Dalam tampilan **Template** Infrastructure Composer, Anda dapat melihat bahwa Infrastructure Composer telah secara otomatis memperbarui template Anda untuk mereferensikan file eksternal.

![Tampilan template Infrastructure Composer yang menunjukkan kode infrastruktur Anda yang dikonfigurasi untuk mereferensikan file eksternal.](http://docs.aws.amazon.com/id_id/infrastructure-composer/latest/dg/images/aac_use_ex_07.png)