本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在基础架构编辑器中引用外部文件
<a name="using-composer-external-files"></a>

您可以将外部文件与 AWS Serverless Application Model (AWS SAM) 模板配合使用，以重复使用代码并组织项目。例如，您可能有多个由OpenAPI规范描述的 Amazon API Gateway REST API 资源。您可以创建一个外部文件并为每个资源引用该文件，而不必在模板中复制OpenAPI规范代码。

AWS 基础设施编辑器 支持以下外部文件用例：
+ 由外部OpenAPI规范文件定义的 API Gateway REST API 资源。
+ AWS Step Functions 由外部状态机定义文件定义的状态机资源。

要了解有关为支持的资源配置外部文件的更多信息，请参阅以下内容：
+ 用于 `AWS::Serverless::Api` 的 `[ DefinitionBody](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-api.html#sam-api-definitionbody)`。
+ 用于 `AWS::Serverless::StateMachine` 的 `[ DefinitionUri](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-resource-statemachine.html#sam-statemachine-definitionuri)`。

**注意**  
要通过基础设施编排控制台使用基础设施编排器引用外部文件，您必须在**本地同步**模式下使用基础设施编排器。有关更多信息，请参阅 [在基础设施编排控制台中本地同步并保存您的项目](using-composer-project-local-sync.md)。

**Topics**
+ [基础设施编排器外部参考文件的最佳实践](using-composer-external-files-best-practices.md)
+ [在基础设施编排器中创建外部文件引用](using-composer-external-files-new.md)
+ [在基础架构编辑器中加载带有外部文件引用的项目](using-composer-external-files-load.md)
+ [在基础架构编排器中创建引用外部文件的应用程序](using-composer-external-files-examples-example3.md)
+ [使用基础设施编排器引用OpenAPI规范外部文件](using-composer-external-files-examples-example1.md)