기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Infrastructure Composer를 사용하여 OpenAPI 사양 외부 파일 참조
<a name="using-composer-external-files-examples-example1"></a>

이 예제에서는 콘솔의 Infrastructure Composer를 사용하여 API Gateway를 정의하는 외부 OpenAPI 사양 파일을 참조합니다REST API.

먼저 Infrastructure Composer **홈** 페이지에서 새 프로젝트를 생성합니다.

그런 다음 **메뉴에서** **로컬 동기화** 활성화를 선택하여 **로컬 동기화를 활성화합니다**. 라는 새 폴더를 생성하고 `demo`프롬프트가 파일을 볼 수 있도록 허용한 다음 **활성화를** 선택합니다. 메시지가 표시되면 **변경 사항 저장**을 선택합니다.

![\[데모 프로젝트 폴더가 선택된 상태에서 Infrastructure Composer 로컬 동기화 활성화 창과 활성화 버튼을 선택할 준비가 되었습니다.\]](http://docs.aws.amazon.com/ko_kr/infrastructure-composer/latest/dg/images/aac_use_ex_11.png)


그런 다음 Amazon API Gateway 카드를 캔버스로 드래그합니다. **세부 정보를** 선택하여 **리소스 속성** 패널을 불러옵니다.

![\[리소스 속성 패널이 열려 있는 캔버스의 API Gateway 리소스입니다.\]](http://docs.aws.amazon.com/ko_kr/infrastructure-composer/latest/dg/images/aac_use_ex_12.png)


**리소스 속성** 패널에서 다음을 구성하고 **저장합니다**.
+ **API 정의에 외부 파일 사용** 옵션을 선택합니다.
+ **외부 파일의 상대 경로**`./api-spec.yaml`로 입력

![\[API 정의에 외부 파일 사용 아래에 표시된 확인란과 정의된 외부 파일의 상대 경로를 보여주는 창입니다.\]](http://docs.aws.amazon.com/ko_kr/infrastructure-composer/latest/dg/images/aac_use_ex_13.png)


이렇게 하면 로컬 시스템에 다음 디렉터리가 생성됩니다.

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

이제 로컬 시스템에서 외부 파일을 구성할 수 있습니다. IDE를 사용하여 프로젝트 폴더에 `api-spec.yaml` 있는를 엽니다. 내용을 다음과 같이 바꿉니다.

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

Infrastructure Composer **템플릿** 보기에서 Infrastructure Composer가 외부 파일을 참조하도록 템플릿을 자동으로 업데이트했음을 확인할 수 있습니다.

![\[외부 파일을 참조하도록 구성된 인프라 코드를 보여주는 Infrastructure Composer 템플릿 보기입니다.\]](http://docs.aws.amazon.com/ko_kr/infrastructure-composer/latest/dg/images/aac_use_ex_07.png)