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.
# Auflösen von schreibgeschützten Eigenschaften
Mit dem CloudFormation IaC-Generator können Sie eine Vorlage mithilfe von Ressourcen generieren, die in Ihrem Konto bereitgestellt wurden und die noch nicht von verwaltet werden. CloudFormation Bestimmte Ressourceneigenschaften sind jedoch als *schreibgeschützt* gekennzeichnet, was bedeutet, dass sie zwar geschrieben, aber nicht gelesen werden können CloudFormation, z. B. mit einem Datenbankkennwort.
Beim Generieren von CloudFormation Vorlagen aus vorhandenen Ressourcen stellen schreibgeschützte Eigenschaften eine Herausforderung dar. CloudFormation Konvertiert diese Eigenschaften in den meisten Fällen in Parameter in der generierten Vorlage. Damit können Sie die Eigenschaften als Parameterwerte bei Importvorgängen eingeben. Es gibt jedoch Szenarien, in denen diese Konvertierung nicht möglich ist, und CloudFormation behandelt diese Fälle unterschiedlich.
## Sich gegenseitig ausschließende Eigenschaften
Einige Ressourcen haben mehrere Sätze von sich gegenseitig ausschließenden Eigenschaften, von denen zumindest einige schreibgeschützt sind. In diesen Fällen kann der IaC-Generator nicht feststellen, welcher Satz von exklusiven Eigenschaften bei der Erstellung auf die Ressource angewendet wurde. Sie können zum Beispiel den Code für [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-function.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-function.html) mit einer dieser Eigenschaftsgruppen angeben.
+ `Code/S3Bucket`,,`Code/S3Key` und optional `Code/S3ObjectVersion`
+ `Code/ImageUri`
+ `Code/ZipFile`
Alle diese Eigenschaften sind schreibgeschützt. Der IaC-Generator wählt eine der exklusiven Eigenschaftsgruppen aus und fügt sie der generierten Vorlage hinzu. Für jede der schreibgeschützten Eigenschaften werden Parameter hinzugefügt. Die Parameternamen enthalten `OneOf` und die Parameterbeschreibungen geben an, dass die entsprechende Eigenschaft durch andere exklusive Eigenschaften ersetzt werden kann. Der IaC-Generator setzt den Warnungstyp `MUTUALLY_EXCLUSIVE_PROPERTIES` für die enthaltenen Eigenschaften.
## Sich gegenseitig ausschließende Typen
In manchen Fällen kann eine schreibgeschützte Eigenschaft mehrere Datentypen haben. Zum Beispiel kann die Eigenschaft `Body` von [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-apigateway-restapi.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-apigateway-restapi.html) entweder ein `object` oder ein `string`sein. Wenn dies der Fall ist, fügt der IaC-Generator die Eigenschaft in die generierte Vorlage mit dem Typ `string` ein und setzt einen Warnungstyp `MUTUALLY_EXCLUSIVE_TYPES`.
## Array-Eigenschaften
Wenn eine schreibgeschützte Eigenschaft den Typ `array`hat, kann der IaC-Generator sie nicht in die generierte Vorlage aufnehmen, da Parameter nur skalare Werte sein können. In diesem Fall wird die Eigenschaft in der Vorlage weggelassen und ein Warnungstyp `UNSUPPORTED_PROPERTIES` festgelegt.
## Optionale Eigenschaften
Bei optionalen schreibgeschützten Eigenschaften kann der IaC-Generator nicht erkennen, ob die Eigenschaft beim Einrichten der Ressource verwendet wurde. In diesem Fall wird die Eigenschaft in der generierten Vorlage weggelassen und der Warnungstyp `UNSUPPORTED_PROPERTIES` wird festgelegt.
## Warnungen und nächste Schritte
Um festzustellen, welche Eigenschaften schreibgeschützt sind, müssen Sie sich die Warnungen ansehen, die die Konsole des IaC-Generators ausgibt. Die Referenz [AWS Ressourcen- und Eigenschaftstypen](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-template-resource-type-ref.html) zeigt nicht an, ob eine Eigenschaft schreibgeschützt ist oder ob sie mehrere Typen unterstützt.
Alternativ können Sie in den Schemata der Ressourcenanbieter sehen, welche Eigenschaften schreibgeschützt sind. Informationen zum Herunterladen der Ressourcenanbieter-Schemas finden Sie in den [CloudFormation Ressourcenanbieter-Schemas](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/resource-type-schemas.html).
**So lösen Sie Probleme mit schreibgeschützten Eigenschaften**
1. Öffnen Sie die [IaC-Generatorseite der Konsole](https://console.aws.amazon.com/cloudformation/home?#iac-generator). CloudFormation
1. Wählen Sie in der Navigationsleiste oben auf dem Bildschirm das AWS-Region für Ihre Vorlage aus.
1. Wählen Sie die Registerkarte **Vorlagen** und wählen Sie dann den Namen der von Ihnen erstellten Vorlage.
1. Wenn die generierte Vorlage Ressourcen mit schreibgeschützten Eigenschaften enthält, zeigt die Konsole des IaC-Generators auf der Registerkarte **Vorlagendefinition** eine Warnung mit einer Zusammenfassung der Art der Probleme an. Beispiel:
![\[Konsolenwarnung des IaC-Generators über schreibgeschützte Eigenschaften in der generierten Vorlage\]](http://docs.aws.amazon.com/de_de/AWSCloudFormation/latest/UserGuide/images/IaC-generator-write-only-property-warning.png)
1. Wählen Sie **Details zur Warnung anzeigen** für weitere Details. Die Ressourcen mit schreibgeschützten Eigenschaften werden durch die in der generierten Vorlage verwendete logische ID und den Ressourcentyp identifiziert.
Verwenden Sie die Liste der Warnungen, um Ressourcen mit schreibgeschützten Eigenschaften zu identifizieren, und sehen Sie sich jede Ressource an, um festzustellen, welche Änderungen (wenn überhaupt) an der generierten Vorlage vorgenommen werden müssen.
![\[Die Konsole des IaC-Generators warnt ausführlich vor schreibgeschützten Eigenschaften in der generierten Vorlage\]](http://docs.aws.amazon.com/de_de/AWSCloudFormation/latest/UserGuide/images/IaC-generator-write-only-property-resource-warning.png)
1. Wenn Ihre Vorlage aktualisiert werden muss, um Probleme mit schreibgeschützten Eigenschaften zu beheben, gehen Sie wie folgt vor:
1. Wählen Sie **Download** um eine Kopie der Vorlage herunterzuladen.
1. Bearbeiten Sie Ihre Vorlage.
1. Wenn die Änderungen abgeschlossen sind, können Sie auf die Schaltfläche **Bearbeitete Vorlage importieren** klicken, um den Importvorgang fortzusetzen.
# Wie Sie Probleme mit schreibgeschützten Eigenschaften in AWS::ApiGateway::RestAPI-Ressourcen beheben
In diesem Thema wird erklärt, wie Sie Probleme mit schreibgeschützten Eigenschaften in [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-apigateway-restapi.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-apigateway-restapi.html)-Ressourcen beheben, wenn Sie den IaC-Generator verwenden.
## Problem
Wenn eine generierte Vorlage `AWS::ApiGateway::RestApi`-Ressourcen enthält, werden Warnungen erzeugt, die besagen, dass die Eigenschaften,`Body` `BodyS3Location`und `CloneFrom` als `UNSUPPORTED_PROPERTIES`identifiziert werden. Dies liegt daran, dass es sich um optionale schreibgeschützte Eigenschaften handelt. Der IaC-Generator weiß nicht, ob diese Eigenschaften jemals auf die Ressource angewendet wurden. Daher lässt es diese Eigenschaften in der generierten Vorlage weg.
## Auflösung
Um die Eigenschaft `Body` für Ihre REST-API festzulegen, aktualisieren Sie Ihre generierte Vorlage.
1. Verwenden Sie die Amazon API Gateway [https://docs.aws.amazon.com/apigateway/latest/api/API_GetExport.html](https://docs.aws.amazon.com/apigateway/latest/api/API_GetExport.html) API-Aktion, um die API herunterzuladen. Zum Beispiel mit dem [https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-export.html](https://docs.aws.amazon.com/cli/latest/reference/apigateway/get-export.html) AWS CLI Befehl. Weitere Informationen finden Sie unter [Exportieren einer REST-API aus API Gateway](https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-export-api.html) im *API-Gateway-Entwicklerleitfaden*.
1. Rufen Sie die Eigenschaft `Body` aus der Antwort der API-Aktion `GetExport` ab. Laden Sie sie in einen Amazon S3-Bucket hoch.
1. Laden Sie die generierte Vorlage herunter.
1. Fügen Sie die Eigenschaften `BodyS3Location/Bucket` und `BodyS3Location/Key` zur Vorlage hinzu und geben Sie den Bucket-Namen und den Schlüssel an, in dem `Body` gespeichert ist.
1. Öffnen Sie die generierte Vorlage in der Konsole des IaC-Generators und wählen Sie **Bearbeitete Vorlage importieren**.
# Wie Sie Probleme mit schreibgeschützten Eigenschaften in AWS::Lambda::Function-Ressourcen beheben
In diesem Thema wird erklärt, wie Sie Probleme mit schreibgeschützten Eigenschaften in [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-function.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-function.html)-Ressourcen beheben, wenn Sie den IaC-Generator verwenden.
## Problem
Die Ressource `AWS::Lambda::Function` hat drei sich gegenseitig ausschließende Sätze von Eigenschaften zur Angabe des Lambda-Codes:
+ die Eigenschaften`Code/S3Bucket` und `Code/S3Key` und optional die Eigenschaft `Code/S3ObjectVersion` .
+ `Code/ImageUri` Eigenschaft
+ `Code/ZipFile` Eigenschaft
Für eine bestimmte `AWS::Lambda::Function`-Ressource kann nur eines dieser Sets verwendet werden.
Der IaC-Generator kann nicht feststellen, welcher Satz von exklusiven schreibgeschützten Eigenschaften zum Erstellen oder Aktualisieren der Ressource verwendet wurde. Daher wird nur der erste Satz von Eigenschaften in die generierte Vorlage aufgenommen. Die Eigenschaften `Code/ImageUri` und `Code/ZipFile` werden weggelassen.
Außerdem gibt der IaC-Generator die folgenden Warnungen aus:
+ **`MUTUALLY_EXCLUSIVE_PROPERTIES`**- warnt davor, dass `Code/S3Bucket` und `Code/S3Key` als sich gegenseitig ausschließende Eigenschaften identifiziert werden.
+ **`UNSUPPORTED_PROPERTIES`**- Warnt, dass die Eigenschaft `Code/S3ObjectVersion` nicht unterstützt wird.
Um `AWS::Lambda::Function`-Ressourcen in eine generierte Vorlage aufzunehmen, müssen Sie die Vorlage herunterladen und mit den richtigen Code-Eigenschaften aktualisieren.
## Auflösung
**Wenn Sie Ihren Lambda-Code in einem Amazon S3-Bucket speichern und die `S3ObjectVersion` Eigenschaft**nicht verwenden, können Sie die generierte Vorlage ohne Änderungen importieren. Der IaC-Generator wird Sie während des Importvorgangs nach dem Amazon S3-Bucket und dem Schlüssel als Vorlagenparameter fragen.
****Wenn Sie Ihren Lambda-Code in einem Amazon ECR-Repository speichern**, können Sie Ihre Vorlage anhand der folgenden Anweisungen aktualisieren:**
1. Laden Sie die generierte Vorlage herunter.
1. Entfernen Sie die Eigenschaften und die entsprechenden Parameter für die Eigenschaften `Code/S3Bucket` und `Code/S3Key` aus der generierten Vorlage.
1. Ersetzen Sie die entfernten Eigenschaften in der generierten Vorlage durch die Eigenschaft `Code/ImageUri`, die die URL für das Amazon ECR-Repository angibt.
1. Öffnen Sie die generierte Vorlage in der IaC-Generator-Konsole und wählen Sie die Schaltfläche **Bearbeitete Vorlage importieren** .
****Wenn Sie Ihren Lambda-Code in einer Zip-Datei speichern**, können Sie Ihre Vorlage anhand der folgenden Anweisungen aktualisieren:**
1. Laden Sie die generierte Vorlage herunter.
1. Entfernen Sie die Eigenschaften und die entsprechenden Parameter für die Eigenschaften `Code/S3Bucket` und `Code/S3Key` aus der generierten Vorlage.
1. Ersetzen Sie die entfernten Eigenschaften in der generierten Vorlage durch die Eigenschaft `Code/ZipFile` .
1. Öffnen Sie die generierte Vorlage in der IaC-Generator-Konsole und wählen Sie die Schaltfläche **Bearbeitete Vorlage importieren** .
****Wenn Sie keine Kopie Ihres Lambda-Codes haben**, können Sie Ihre Vorlage anhand der folgenden Anweisungen aktualisieren:**
1. Verwenden Sie die AWS Lambda [https://docs.aws.amazon.com/lambda/latest/api/API_GetFunction.html](https://docs.aws.amazon.com/lambda/latest/api/API_GetFunction.html)API-Aktion (z. B. mithilfe des [https://docs.aws.amazon.com/cli/latest/reference/lambda/get-function.html](https://docs.aws.amazon.com/cli/latest/reference/lambda/get-function.html) AWS CLI Befehls).
1. In der Antwort lautet der Parameter `RepositoryType` `S3`, wenn sich der Code in einem Amazon S3-Bucket befindet, oder `ECR`, wenn sich der Code in einem Amazon ECR-Repository befindet.
1. In der Antwort enthält der Parameter `Location` eine vorsignierte URL, mit der Sie das Bereitstellungspaket für 10 Minuten herunterladen können. Laden Sie den Code herunter.
1. Laden Sie den Code in einen Amazon S3-Bucket hoch.
1. Führen Sie einen Importvorgang mit der generierten Vorlage aus und geben Sie den Bucketnamen und den Schlüssel als Parameterwerte an.