Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verweisen Sie mit Infrastructure Composer auf eine externe OpenAPI Spezifikationsdatei
<a name="using-composer-external-files-examples-example1"></a>

In diesem Beispiel wird Infrastructure Composer von der Konsole aus verwendet, um auf eine externe OpenAPI Spezifikationsdatei zu verweisen, die ein API Gateway definiertREST API.

Erstellen Sie zunächst auf der Infrastructure **Composer-Startseite** ein neues Projekt.

Aktivieren Sie anschließend die **lokale Synchronisierung**, indem Sie im **Menü** die Option **Lokale Synchronisierung aktivieren** auswählen. Erstellen Sie einen neuen Ordner mit dem Namen`demo`, warten Sie auf die Aufforderung, Dateien anzuzeigen, und wählen Sie **Aktivieren**. Wenn Sie dazu aufgefordert werden, wählen Sie **Änderungen speichern** aus.

![Das Fenster Infrastructure Composer Activate Local Sync mit einem ausgewählten Demo-Projektordner und der Schaltfläche Aktivieren steht zur Auswahl bereit.](http://docs.aws.amazon.com/de_de/infrastructure-composer/latest/dg/images/aac_use_ex_11.png)


Ziehen Sie als Nächstes eine Amazon API Gateway Gateway-Karte auf die Leinwand. Wählen Sie **Details** aus, um den Bereich mit den **Ressourceneigenschaften** aufzurufen.

![Eine API-Gateway-Ressource auf der Arbeitsfläche mit geöffnetem Bereich mit den Ressourceneigenschaften.](http://docs.aws.amazon.com/de_de/infrastructure-composer/latest/dg/images/aac_use_ex_12.png)


Konfigurieren Sie im Bereich **mit den Ressourceneigenschaften** Folgendes und **speichern Sie** es.
+ Wählen Sie die Option **Externe Datei für API-Definition verwenden**.
+ Eingabe `./api-spec.yaml` als **relativer Pfad zur externen Datei**

![Ein Fenster mit dem Kontrollkästchen „Externe Datei für API-Definition verwenden“ und einem relativen Pfad zu einer definierten externen Datei.](http://docs.aws.amazon.com/de_de/infrastructure-composer/latest/dg/images/aac_use_ex_13.png)


Dadurch wird das folgende Verzeichnis auf unserem lokalen Computer erstellt:

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

Jetzt können Sie die externe Datei auf unserem lokalen Computer konfigurieren. Öffnen Sie mit unserer IDE den Ordner, der `api-spec.yaml` sich in Ihrem Projektordner befindet. Ersetzen Sie den Inhalt durch Folgendes:

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

In der Infrastructure **Composer-Vorlagenansicht** können Sie sehen, dass Infrastructure Composer Ihre Vorlage automatisch aktualisiert hat, sodass sie auf die externe Datei verweist.

![Die Infrastructure Composer-Vorlagenansicht zeigt Ihren Infrastrukturcode, der so konfiguriert ist, dass er auf die externe Datei verweist.](http://docs.aws.amazon.com/de_de/infrastructure-composer/latest/dg/images/aac_use_ex_07.png)