Die AWS Marketplace API-Referenz wurde neu strukturiert. Weitere Informationen zu den unterstützten API-Vorgängen finden Sie in der [AWS Marketplace API-Referenz](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html). 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. # Arbeiten Sie mit EC2 Image Builder Builder-Komponentenprodukten Als AWS Marketplace Marketplace-Verkäufer können Sie AMI-based Produkte anbieten, die mithilfe von EC2 Image Builder Builder-Komponenten an AWS Marketplace Marketplace-Käufer geliefert werden. Gehen Sie nacheinander durch die folgenden Abschnitte, um Ihre Komponente zu erstellen und ein AWS Marketplace Angebot zu veröffentlichen. **Topics** + [Erstellen und Testen Ihrer Image Builder Builder-Komponente](#build-and-test-ib-component) + [Komponenten-ARN kopieren](#ib-copy-component-arn) + [Erstellen AWS Marketplace IAM-Richtlinien](#ib-create-iam-policies) + [Erstellen des AWS Marketplace IAM role (IAM-Rolle)](#ib-create-iam-role) + [Bereiten Sie Ihre Image Builder Builder-Komponentenliste vor](#prepare-ec2-ib-listing) + [Produktliste Ihrer Image Builder Builder-Komponente veröffentlichen](#publishing-ib-component-listing) + [Aktualisierung der Produktinformationen zur Image Builder Builder-Komponente](#updating-ec2-image-builder-product) + [Hinzufügen einer neuen Version zu einem vorhandenen Image Builder Builder-Komponentenprodukt](#adding-new-ec2-ib-version-existing-product) + [Informationen zu einer vorhandenen Version aktualisieren](#updating-ec2-ib-product-version) + [Einschränken der Produktversion einer Image Builder Builder-Komponente](#restricting-ec2-ib-product-version) + [Einen Änderungssatz überwachen](#monitor-changeset) + [Sicherung von Software-Downloads](#securing-software-downloads) ## Erstellen und Testen Ihrer Image Builder Builder-Komponente Erstellen und testen Sie Ihre Komponente in Image Builder. Anweisungen finden Sie unter [Entwickeln benutzerdefinierter Komponenten für Ihr Image Builder Builder-Image](https://docs.aws.amazon.com//imagebuilder/latest/userguide/create-custom-components.html) im *Image Builder Builder-Benutzerhandbuch*. Achten Sie beim Erstellen Ihrer Komponente mit Image Builder darauf, dass Sie wie folgt vorgehen: + Die Komponente und all ihre zugrunde liegenden Abhängigkeiten, wie z. B. ein Amazon Simple Storage Service (Amazon S3) -Bucket, Secrets oder Parameter, müssen in der AWS-Region USA Ost (Nord-Virginia) (`us-east-1`) erstellt werden. + Nehmen Sie die unterstützte Architektur und alle Softwareabhängigkeiten in die Komponentenbeschreibung auf. + Testen Sie Ihre Komponente in Ihrem AWS Konto, indem Sie eine [Image-Pipeline](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) erstellen und das von der Pipeline erstellte AMI bereitstellen. + Wenn Ihre Komponente Anweisungen zum Kopieren von Binärdateien, Paketen oder Dateien aus einem S3-Bucket enthält, verwenden Sie das `S3Download` Aktionsmodul. Geben Sie im `S3Download` Modul für `source` den statischen Speicherort Ihrer Datei im S3-Bucket ein. Im folgenden Beispiel wird im Rahmen der Komponenteninstallation eine Binärdatei aus einem S3-Bucket kopiert. ``` - name: DownloadMyFile action: S3Download inputs: - source: s3://amzn-s3-demo-source-bucket/path/to/package.zip destination: C:\myfolder\package.zip ``` + Komponenten können Dateien mit einer Größe von bis zu 2 GB aufnehmen, wenn sie die `S3Download` Aktion verwenden. + Wenn Ihre Komponente [Parameter](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-user-defined-variables.html#user-defined-vars-parameters) verwendet, stellen Sie sicher, dass alle Parameter Standardwerte haben. Wenn Sie beispielsweise einen Parameter benannt haben`region`, stellen Sie sicher, dass Sie einen gültigen Standardwert haben, wie `us-east-1` z. Diese Standardwerte dienen der AWS Marketplace Verarbeitung und dem Testen. Das Testen kann fehlschlagen, wenn Sie keine Standardwerte angeben. + Wenn Ihre Komponente Parameter Store oder die Fähigkeit AWS Systems Manager zum Speichern von Parametern verwendet AWS Secrets Manager, gehen Sie wie folgt vor: + + Um Werte als Schritt in Ihrer Komponente abzurufen, betten Sie AWS Command Line Interface Befehle in Ihre YAML-Konfigurationsdatei ein. + Erstellen Sie einen entsprechenden Eintrag in Secrets Manager oder Parameter Store in Ihrem AWS Konto. Verwenden Sie den Standardschlüssel und geben Sie einen gültigen Wert an, der Ihnen beim Erstellen der Komponente während des AWS Marketplace Testvorgangs hilft. Angenommen, Sie haben einen Parameter `saas_token` mit dem Standardwert aufgerufen`token`, der Parameter Store verwendet. Erstellen Sie in diesem Fall ein Schlüssel-Wert-Paar im Parameter Store. Verwenden Sie `token` es als Schlüssel. Geben Sie für den Wert ein gültiges SaaS-Token für Ihre Anwendung ein. Beachten Sie, dass die in Ihrem AWS Marketplace Verkäuferkonto gespeicherten Werte nur zu AWS Marketplace Testzwecken verwendet werden. Diese Werte werden nicht an Käufer weitergegeben. + AWS Marketplace generiert automatisch Amazon Machine Images (AMIs) für Ihre Komponente für alle kompatiblen Betriebssystemversionen, die Sie bei der Komponentenerstellung auswählen. Wählen Sie beim Erstellen Ihrer Komponente mindestens eine kompatible Betriebssystemversion aus. Überprüfen Sie die Kompatibilität Ihrer Komponente mit allen ausgewählten Betriebssystemversionen, indem Sie EC2 Image Builder Builder-Pipelines verwenden, um AMIs zu erstellen und zu testen. ## Komponenten-ARN kopieren Nachdem Sie die Komponente in Image Builder erstellt und getestet haben, kopieren und speichern Sie die Komponenten-ARN. Sie verwenden den ARN, wenn Sie die Produktliste mithilfe der AWS Marketplace Katalog-API veröffentlichen. **So kopieren Sie den ARN der Image Builder Builder-Komponente** 1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Image Builder Builder-Konsole unter[https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. Wählen Sie in der linken Navigationsleiste unter **Gespeicherte Ressourcen** die Option **Komponenten** aus. 1. Wählen Sie auf der **Komponentenseite** für **Besitzer des Filters** die Option **Owned by me** aus. 1. Wählen Sie den Namen der Komponente. 1. Kopieren Sie auf der Detailseite der Komponente im Abschnitt **Zusammenfassung** den ARN. ## Erstellen AWS Marketplace IAM-Richtlinien Erstellen Sie die folgenden IAM-Richtlinien, um AWS Marketplace Zugriff auf Ihre Image Builder Builder-Komponente und zugehörige Ressourcen wie Amazon S3 S3-Buckets und -Secrets zu gewähren. Verwenden Sie die bereitgestellten Beispielrichtlinien. Sie fügen diese Richtlinien einer [AWS Marketplace IAM-Rolle](#ib-create-iam-role) hinzu. Hilfe beim Erstellen von Richtlinien finden Sie im *IAM-Benutzerhandbuch* [unter Richtlinien mit dem JSON-Editor erstellen](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html#access_policies_create-json-editor). + Image Builder-Get-Component-Richtlinie, um den Zugriff auf Ihre Komponente in Image Builder AWS Marketplace zu ermöglichen. Diese Richtlinie ist erforderlich. Speichern Sie die Richtlinie unter dem Namen `mp_ib_ingest`. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": "imagebuilder:GetComponent", "Resource": "*" } ] } ``` ------ + Amazon S3 S3-Lesezugriffsrichtlinie, um das Abrufen von Binärdateien aus einem S3-Bucket AWS Marketplace zu ermöglichen. Diese Richtlinie ist nur erforderlich, wenn Ihre Komponente das `S3Download` Aktionsmodul verwendet und zugehörige Binärdateien in einem S3-Bucket speichert. Speichern Sie die Richtlinie unter dem Namen `mp_ib_s3_read_only`. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "ListObjectsInBucket", "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::{{bucket_name}}" ] }, { "Sid": "ReadObjectsInBucket", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:GetObjectAttributes" ], "Resource": [ "arn:aws:s3:::{{bucket_name}}/*" ] } ] } ``` ------ + Secrets Manager-Lesezugriffsrichtlinie, um das Abrufen von in Secrets Manager gespeicherten Geheimnissen AWS Marketplace zu ermöglichen. Diese Richtlinie ist nur erforderlich, wenn Ihre Komponente Secrets Manager zum Speichern von Geheimnissen verwendet. Speichern Sie die Richtlinie unter dem Namen `mp_ib_sm_read_only`. Um die Richtlinie nur auf Ihr Geheimnis zu beschränken, ersetzen Sie das `*` in dem `Resource` Abschnitt durch Ihr Geheimnis. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue" ], "Resource": [ "*" ] } ] } ``` ------ + Die Lesezugriffsrichtlinie für den Parameterspeicher ermöglicht das Abrufen von Geheimnissen, AWS Marketplace die im Parameter Store gespeichert sind. Diese Richtlinie ist nur erforderlich, wenn Ihre Komponente Parameter Store zum Speichern von Geheimnissen verwendet. Speichern Sie die Richtlinie unter dem Namen `mp_ib_ssm_parameter_read_only`. Um die Richtlinie nur auf Ihr Geheimnis zu beschränken, ersetzen Sie das `*` im `Resource` Abschnitt durch Ihr Geheimnis. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Action": [ "ssm:getParameter" ], "Resource": [ "*" ] } ] } ``` ------ ## Erstellen des AWS Marketplace IAM role (IAM-Rolle) Gehen Sie wie folgt vor, um eine AWS Marketplace IAM-Rolle mit Richtlinien zu erstellen, um AWS Marketplace Zugriff auf Ihre Komponente und ihre Abhängigkeiten zu gewähren. **Um das zu erstellen AWS Marketplace IAM role (IAM-Rolle)** 1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die IAM-Konsole unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Wählen Sie in der linken Navigationsleiste **Rollen** aus. 1. Wählen Sie **Rolle erstellen** aus. 1. Wählen Sie **Benutzerdefinierte Vertrauensrichtlinie** aus. 1. Geben Sie die folgende Aussage ein: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Principal": { "Service": "assets.marketplace.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Wählen Sie **Weiter** aus. 1. Fügen Sie die zuvor erstellte Image Builder Builder-Get-Component-Richtlinie hinzu. Die Get-Component-Richtlinie ist erforderlich. Fügen Sie die entsprechenden Richtlinien für S3, Secrets Manager und Parameter Store hinzu, wenn Ihre Komponente diese AWS Dienste verwendet. 1. Wählen Sie **Weiter** aus. 1. Geben Sie einen Rollennamen ein, z. `MPEC2IBIngestion` B. 1. Wählen Sie **Rolle erstellen** aus. ### Kopieren AWS Marketplace IAM role ARN (IAM-Rollen-ARN) Nachdem Sie die AWS Marketplace IAM-Rolle erstellt haben, kopieren und speichern Sie den Rollen-ARN. Sie verwenden den ARN, wenn Sie den Eintrag mit der AWS Marketplace Catalog API veröffentlichen. **Um das zu kopieren AWS Marketplace IAM role ARN (IAM-Rollen-ARN)** 1. Wählen Sie in der IAM-Konsole in der linken Navigationsleiste **Rollen** aus. 1. Wählen Sie die AWS Marketplace IAM-Rolle aus, die Sie zuvor erstellt haben, z. B. `MPEC2IBIngestion` 1. Kopieren Sie auf der Rollendetailseite im Abschnitt **Zusammenfassung** den ARN. ## Bereiten Sie Ihre Image Builder Builder-Komponentenliste vor Stellen Sie vor der Veröffentlichung Ihres AWS Marketplace Angebots sicher, dass Sie die folgenden Informationen parat haben: + **Produktmetadaten —** Zu den Metadaten gehören das Produktlogo, der Produkttitel, die Endbenutzer-Lizenzvereinbarung, die unterstützten Instance-Typen und die AWS-Region. + **Preisinformationen —** Sie können Ihr Produkt kostenlos, zu einem Stundensatz oder zu einem Stundensatz mit einer ersten kostenlosen Testphase anbieten. Bring Your Own License (BYOL) wird nicht unterstützt. + **Komponentendetails —** Zu den Details gehören die Amazon-Ressourcennummer (ARN) der Komponente, Nutzungsdetails und die AWS Identity and Access Management (IAM) -Rolle, die für AWS Marketplace die Verarbeitung Ihrer Komponente zuständig ist. ## Produktliste Ihrer Image Builder Builder-Komponente veröffentlichen Dieses Thema enthält Anweisungen zum Veröffentlichen Ihrer EC2 Image Builder Builder-Komponentenliste unter AWS Marketplace Verwendung der AWS Marketplace Catalog API. ### Voraussetzungen Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie Ihre Produktliste für Image Builder Builder-Komponenten veröffentlichen: + Registrierung als Verkäufer in AWS Marketplace. Weitere Informationen finden Sie unter [Als AWS Marketplace Marketplace-Verkäufer registrieren](https://catalog.workshops.aws/mpseller/en-US/pre-requisite-register-as-seller). + Ein IAM-Benutzer mit entsprechender `AWSMarketplaceSellerFullAccess` Genehmigung. + Ein öffentlich zugänglicher Amazon Simple Storage Service (Amazon S3) -Bucket zum Hosten Ihres Firmenlogos und Ihrer EULA, sofern sie in Ihrer Komponente verwendet werden. Sie geben die URL für den S3-Bucket in Ihre `ChangeSet` JSON-Datei ein. + AWS Command Line Interface (AWS CLI). Weitere Informationen finden Sie unter [Was ist die AWS-Befehlszeilenschnittstelle?](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) im *AWS Command Line Interface Benutzerhandbuch*. ### Erstellen eines Image Builder Builder-Komponentenprodukts auf AWS Marketplace Informationen zum Erstellen eines EC2 Image Builder Builder-Komponentenprodukts AWS Marketplace mithilfe der Catalog API finden Sie [Erstellen Sie ein Produkt](work-with-seller-products.md#create-product) unter. ## Aktualisierung der Produktinformationen zur Image Builder Builder-Komponente Sie können Informationen zu einem Image Builder Builder-Komponentenprodukt im AWS Marketplace Management Portal aktualisieren. **So aktualisieren Sie die Produktinformationen der Image Builder Builder-Komponente** 1. Öffnen Sie das [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour/)und melden Sie sich bei Ihrem Verkäuferkonto an. 1. Wählen Sie im Menü **Produkte** die Option **Server** aus. 1. Wählen Sie auf der Seite **Serverprodukte** das Produkt aus. 1. Wählen Sie auf der Produktdetailseite im Menü **Änderungen anfordern** den Artikel aus, der den Informationen entspricht, die Sie aktualisieren möchten. 1. Nach dem Absenden der Änderungen erscheint die Anfrage auf dem Tab „**Anfragen**“ mit dem Status „Wird geprüft“. Sobald sie abgeschlossen ist, ändert sie sich in „Erfolgreich“. ## Hinzufügen einer neuen Version zu einem vorhandenen Image Builder Builder-Komponentenprodukt Sie können einem Image Builder Builder-Komponentenprodukt eine neue Version hinzufügen, AWS Marketplace indem Sie den verwenden AWS Marketplace Catalog API. **Um eine neue Version hinzuzufügen** 1. Rufen Sie von der AWS Marketplace Management Portal die Produkt-ID ab. 1. Öffnen Sie das [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour/)und melden Sie sich bei Ihrem Verkäuferkonto an. 1. Wählen Sie im Menü **Produkte** die Option **Server** aus. 1. Wählen Sie auf der Seite **Serverprodukte** das Produkt aus. 1. Kopieren Sie in der **Produktübersicht** die **Produkt-ID**. 1. Erstellen Sie mithilfe des folgenden Codebeispiels eine Changeset-Datei im JSON-Format. Ersetzen Sie es im Beispiel {{your-product-ID}} durch die Produkt-ID, die Sie in Schritt 1 erhalten haben. {{new-version-name}}Ersetzen Sie es durch Ihren Versionstitel. {{new-delivery-option-title}}Ersetzen Sie es durch den Titel Ihrer Lieferoption. ``` [ { "ChangeType": "AddDeliveryOptions", "Entity": { "Identifier": "{{your-product-ID}}", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "Version": { "VersionTitle": "{{new-version-name}}", "ReleaseNotes": "Release notes goes here." }, "DeliveryOptions": [ { "DeliveryOptionTitle": "{{new title}}", "Details": { "Ec2ImageBuilderComponentDeliveryOptionDetails": { "UsageInstructions": "Test usage instructions for IB", "AccessRoleArn": "arn:aws:iam::123456789:role/sample", "ComponentArn": "arn:aws:imagebuilder:us-east-1:123456789:component/sample/2.0.0/1" } } } ] } } ] ``` 1. Speichern Sie die Changeset-Datei mit dem Namen. `addIBversion.json` 1. Führen Sie in Ihrem Terminal oder AWS CloudShell den folgenden Befehl aus: ``` aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://addIBversion.json ``` Der `start-change-set` Befehl gibt einen `ChangeSetId` Wert zurück. Informationen zur Überwachung eines Änderungssatzes finden Sie unter[Einen Änderungssatz überwachen](#monitor-changeset). **Asynchrone Fehler** Die folgenden Fehler beziehen sich spezifisch auf `AddDeliveryOptions` Aktionen in. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie aufrufen, `DescribeChangeSet` nachdem ein Änderungssatz verarbeitet wurde. Weitere Hinweise zur Verwendung `DescribeChangeSet` zum Abrufen des Status einer Änderungsanforderung finden Sie unter[Mit Änderungssätzen arbeiten](catalog-apis.md#working-with-change-sets). **Anmerkung** Die folgenden Fehlercodes sind spezifisch für die Image Builder Builder-Liefermethode. Informationen zu vorhandenen Fehlermeldungen in Feldern wie `Usage Instructions` `Recommended Instance type``AccessRoleArn`, und finden Sie unter[Eine neue Version hinzufügen](work-with-single-ami-products.md#ami-add-version). | Fehlercode | Fehlermeldung | | --- | --- | | ASSET\_NOT\_FOUND | Prüfen Sie, ob [Komponenten-ARN] im AWS Konto [Account-ID] vorhanden ist und ob der von AccessARN bereitgestellte [ARN] über Berechtigungen verfügt, um diese Image Builder Builder-Komponente mit anderen zu teilen. AWS Marketplace | | ASSET\_NOT\_FOUND | Der angegebene S3-Link [x] innerhalb der Komponente [x] existiert nicht. Stellen Sie einen gültigen S3-Link innerhalb der Komponente bereit. | | DUPLICATE\_COMPONENT\_NAME | Der Komponentenname [x] ist bereits in derselben Version vorhanden. Geben Sie einen anderen Komponentennamen an. | | DOPPELTER KOMPONENTENNAME | Der von Ihnen angegebene Komponentenname [x] wird bereits von einem anderen Produkt verwendet. Geben Sie einen anderen Komponentennamen an. | | DUPLICATE\_COMPONENT\_ARN | Die Komponente Arn [x] muss sich von der Komponente Arn unterscheiden, die in anderen Lieferoptionen derselben Version dieses Produkts verwendet wird. | | DUPLICATE\_COMPONENT\_ARN | Der Komponenten-ARN [x] muss sich von dem Komponenten-ARN unterscheiden, der in anderen Versionen dieses Produkts verwendet wird. | | SCAN\_ERROR | Sicherheitslücke [y] in Komponente [x] behoben. | | ASSET\_ACCESS\_EXCEPTION | Wir verfügen nicht über die erforderlichen Berechtigungen, um den Inhalt des angegebenen S3-Buckets [x] zu lesen. Stellen Sie sicher, dass der S3-Bucket über die entsprechenden Leseberechtigungen verfügt. | | ASSET\_ACCESS\_EXCEPTION | Wir haben nicht die erforderlichen Berechtigungen, um den Inhalt der angegebenen Komponente ARN [x] zu lesen. Stellen Sie sicher, dass der Komponenten-ARN über die entsprechenden Leseberechtigungen verfügt. | | ASSET\_ACCESS\_EXCEPTION | Wir haben nicht die erforderlichen Rechte, um den Inhalt der angegebenen Paket-URI [x] zu lesen. Stellen Sie sicher, dass der Paket-URI über die entsprechenden Leseberechtigungen verfügt. | | ASSET\_ACCESS\_EXCEPTION | Fehler beim Lesen aus der HTTP-Quelle [x]. Stellen Sie sicher, dass die angegebene HTTP-Quelle korrekt ist. | | INVALID\_IMAGE\_BUILDER\_COMPONENT\_PACKAGE | Komponenten-Assets überschreiten die Größenbeschränkung für die Aufnahme. Reduzieren Sie die Größe der S3/web Downloads oder eliminieren Sie unnötige Downloads, um fortzufahren. | | INVALID\_IMAGE\_BUILDER\_COMPONENT\_PACKAGE | Die Aufnahme von Komponenten-Assets dauert zu lange. Stellen Sie sicher, dass Ihre Netzwerkverbindung stabil ist und über eine ausreichende Bandbreite verfügt. | | TOO\_MANY\_IMAGE\_BUILDER\_COMPONENTS | Pro Produkt werden maximal 5 eindeutige Komponentennamen unterstützt. Beschränken Sie die zusätzliche Lieferoption. | | INCOMPLETE\_SELLER\_PUBLIC\_PROFILE | Ihr öffentliches Verkäuferprofil ist nicht vollständig. Vervollständigen Sie Ihr öffentliches Profil, bevor Sie Versionen zum Produkt hinzufügen. | | UNGÜLTIGE\_BESCHREIBUNG | Die Beschreibung fehlt. Geben Sie in der Komponente [x] eine Beschreibung mit weniger als 1024 Zeichen ein. | | UNGÜLTIGER\_KOMPONENTENNAME | Geben Sie einen Komponentennamen mit weniger als [x] Zeichen an. | | UNGÜLTIGE\_UNTERSTÜTZTE\_BETRIEBSSYSTEMVERSION | Die Betriebssystemversion fehlt. Geben Sie in Komponente [x] eine gültige unterstützte Betriebssystemversion an. | | UNGÜLTIGER\_PATH\_FORMAT | Schritt [STEP\_NAME] in Phase [PHASE\_NAME] darf keine S3- oder Web-URLs für die Aktionen verwenden. InstallMSI/UninstallMSI Stellen Sie sicher, dass der angegebene Pfad ein gültiger lokaler Pfad ist, auf den das System, das die Aktion ausführt, zugegriffen werden kann. | | INCOMPATIBLE\_OS\_TYPE | Der angegebene Komponenten-Betriebssystemtyp [x] ist nicht mit der Plattform des Basis-Images kompatibel. Geben Sie einen Betriebssystemtyp an, der mit dem Basis-Image kompatibel ist. | | ASSET\_ACCESS\_EXCEPTION | Wir verfügen nicht über die erforderlichen Berechtigungen, um den Inhalt des angegebenen SSM-Parameters [x] zu lesen. Stellen Sie sicher, dass die in der API-Eingabe angegebene IAM-Zugriffsrolle über die erforderlichen Leseberechtigungen verfügt. | | ASSET\_ACCESS\_EXCEPTION | Wir verfügen nicht über die erforderlichen Berechtigungen, um den Inhalt des angegebenen SecretsManager Geheimnisses [x] zu lesen. Stellen Sie sicher, dass die in der API-Eingabe angegebene IAM-Zugriffsrolle über die erforderlichen Leseberechtigungen verfügt. | | INVALID\_IB\_COMPONENT\_BUILD\_VERSION | Die Komponente ARN [x] hat eine Build-Version von [y]. AWS Marketplace unterstützt nur Build-Version 1. Erstellen Sie eine neue EC2 Image Builder Builder-Version mit Build-Versionen 1, und versuchen Sie es erneut AWS Marketplace | | INVALID\_IB\_COMPONENT\_PARAMETER | Der SSM-Parameter in Eingabe [x] für Komponente [y] konnte nicht analysiert werden. | | INVALID\_IB\_COMPONENT\_PARAMETER | Das SecretsManager Geheimnis in der Eingabe [x] für die Komponente [y] konnte nicht analysiert werden. | | MISSING\_IB\_COMPONENT\_PARAMETER | Der Parameter wurde in der Komponente [x] für Eingabe [y] nicht gefunden | | INVALID\_IB\_COMPONENT\_PARAMETER | Geben Sie einen Standardwert für den Parameter [x] in der Komponente [y] an. | | FAILED\_LAUNCH\_TEST | Der Starttest für Komponente [x] ist fehlgeschlagen. Fehlermeldung: [z] | | SSHAuthFailedForUserAndKeypair | Die Anmeldung bei der Instanz mit dem Betriebssystem-Standardbenutzernamen [X] ist nicht möglich. | | INVALID\_IB\_COMPONENT | Eine Bauphase für Komponenten ist erforderlich. Fügen Sie der Komponente [x] eine gültige Erstellungsphase hinzu | | DUPLICATE\_VERSION\_TITLE | Der Versionstitel muss sich von allen anderen Versionstiteln dieses Produkts unterscheiden. | | INVALID\_VERSION\_TITLE | Entfernen Sie Leerzeichen vor dem Markensymbol. | | UNGÜLTIGE\_VERSIONSTITEL | Nicht unterstützte Zeichen entfernen: [x, y, z] | | UNGÜLTIGER\_VERSIONSTITEL | Entfernen Sie Leerzeichen am Anfang des Versionstitels. | | UNGÜLTIGER\_VERSIONSTITEL | Geben Sie einen Versionstitel mit weniger als [x] Zeichen an. | | INVALID\_RELEASE\_NOTES | Entfernen Sie Leerzeichen vor dem Markensymbol. | | INVALID\_RELEASE\_NOTES | Nicht unterstützte Zeichen entfernen: [x, y, z] | | UNGÜLTIGE\_VERSIONSHINWEISE | Entfernen Sie Leerzeichen am Anfang der Versionshinweise. | | INVALID\_RELEASE\_NOTES | Geben Sie Versionshinweise mit weniger als (x) Zeichen an. | | UNGÜLTIGE VERWENDUNGSHINWEISE | Entfernen Sie Leerzeichen vor dem Markensymbol. | | UNGÜLTIGE VERWENDUNGSHINWEISE | Nicht unterstützte Zeichen entfernen: [x, y, z] | | UNGÜLTIGE NUTZUNGSANWEISUNGEN | Geben Sie Nutzungsanweisungen mit weniger als (x) Zeichen an. | | DUPLICATE\_DELIVERY\_OPTION\_TITLES | Geben Sie einen eindeutigen Titel für die Lieferoption an. | | INVALID\_DELIVERY\_OPTION\_TITLES | Der Titel der Lieferoption ist bereits vorhanden. Versuchen Sie es erneut mit einem anderen Titel. | ## Informationen zu einer vorhandenen Version aktualisieren **Um Informationen über eine bestehende Version zu aktualisieren** 1. Rufen Sie AWS Marketplace Management Portal die Produkt-ID von ab. 1. Öffnen Sie das [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour/)und melden Sie sich bei Ihrem Verkäuferkonto an. 1. Wählen Sie im Menü **Produkte** die Option **Server** aus. 1. Wählen Sie auf der Seite **Serverprodukte** das Produkt aus. 1. Kopieren Sie in der **Produktübersicht** die **Produkt-ID**. 1. Führen Sie in Ihrem Terminal den folgenden Befehl aus. Ersetzen Sie den Befehl {{your-product-ID}} durch die ID, die Sie in Schritt 1 erhalten haben. ``` aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id '{{your-product-ID}}' ``` 1. Gehen Sie in der zurückgegebenen Ausgabe zum `Versions` Abschnitt`DetailsDocument`,. Kopieren Sie den `Id` Wert für die Version`DeliveryOptions`, die Sie aktualisieren möchten. 1. Erstellen Sie mithilfe des folgenden Codebeispiels eine Changeset-Datei im JSON-Format. Ersetzen Sie es im Beispiel {{your-product-ID}} durch die Produkt-ID, die Sie in Schritt 1 erhalten haben. {{your-release-notes}}Ersetzen Sie es durch Ihre Versionshinweise. {{your-delivery-option-ID}}Ersetzen Sie es durch die ID der Lieferoption, die Sie in Schritt 3 erhalten haben. {{your-usage-instructions}}Ersetzen Sie es durch Ihre Nutzungshinweise. ``` [ { "ChangeType": "UpdateDeliveryOptions", "Entity": { "Identifier": "{{your-product-ID}}", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "Version": { "ReleaseNotes": "{{your-release-notes}}" }, "DeliveryOptions": [ { "Id": "{{your-delivery-option-ID}}", "Details": { "Ec2ImageBuilderComponentDeliveryOptionDetails": { "UsageInstructions": "{{your-usage-instructions}}" } } } ] } } ] ``` 1. Speichern Sie die Changeset-Datei mit dem Namen. `updateVersionInfo.json` 1. Führen Sie in Ihrem Terminal oder AWS CloudShell den folgenden Befehl aus: ``` aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://updateVersionInfo.json ``` Der `start-change-set` Befehl gibt einen `ChangeSetId` Wert zurück. Informationen zur Überwachung eines Änderungssatzes finden Sie unter[Einen Änderungssatz überwachen](#monitor-changeset). ## Einschränken der Produktversion einer Image Builder Builder-Komponente Wenn eine Version eingeschränkt wird, steht sie Käufern nicht zur Verfügung. Sie können eine Version Ihres Image Builder Builder-Komponentenprodukts auf die AWS Marketplace Verwendung der AWS Marketplace Katalog-API beschränken. Sie müssen mindestens eine Version Ihres Produkts uneingeschränkt nutzen. AWS Marketplace Sie können den Zugriff nicht auf die einzige öffentliche Version beschränken. **Um Informationen über eine bestehende Version zu aktualisieren** 1. Rufen Sie AWS Marketplace Management Portal die Produkt-ID von ab. 1. Öffnen Sie das [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour/)und melden Sie sich bei Ihrem Verkäuferkonto an. 1. Wählen Sie im Menü **Produkte** die Option **Server** aus. 1. Wählen Sie auf der Seite **Serverprodukte** das Produkt aus. 1. Kopieren Sie in der **Produktzusammenfassung** die **Produkt-ID**. 1. Führen Sie in Ihrem Terminal den folgenden Befehl aus. Ersetzen Sie den Befehl {{your-product-ID}} durch die ID, die Sie in Schritt 1 erhalten haben. ``` aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id '{{your-product-ID}}' ``` 1. Gehen Sie in der zurückgegebenen Ausgabe zum `Versions` Abschnitt`DetailsDocument`,. Kopieren Sie den `Id` Wert für die Version`DeliveryOptions`, die Sie aktualisieren möchten. 1. Erstellen Sie mithilfe des folgenden Codebeispiels eine Changeset-Datei im JSON-Format. Ersetzen Sie es im Beispiel {{your-product-ID}} durch die Produkt-ID, die Sie in Schritt 1 erhalten haben. {{your-delivery-option-ID}}Ersetzen Sie es durch die ID der Lieferoption, die Sie in Schritt 3 erhalten haben. ``` [ { "ChangeType": "RestrictDeliveryOptions", "Entity": { "Identifier": "{{your-product-ID}}", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "DeliveryOptionIds": [ "{{your-delivery-option-ID}}" ] } } ] ``` 1. Speichern Sie die Changeset-Datei mit dem Namen. `restrictec2ibversion.json` 1. Führen Sie in Ihrem Terminal oder AWS CloudShell den folgenden Befehl aus: ``` aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://restrictec2ibversion.json ``` Der `start-change-set` Befehl gibt einen `ChangeSetId` Wert zurück. Informationen zur Überwachung eines Änderungssatzes finden Sie unter[Einen Änderungssatz überwachen](#monitor-changeset). ## Einen Änderungssatz überwachen Der `start-change-set` Befehl gibt einen `ChangeSetId` Wert zurück. Sie können den Fortschritt des Änderungssatzes auf folgende Weise überwachen: + Führen Sie den folgenden Befehl in Ihrem Terminal aus. Im Befehl. {{changeset-ID}} durch den vom `start-change-set` Befehl zurückgegebenen `ChangeSetId` Wert ersetzen. ``` aws marketplace-catalog describe-change-set ‐‐catalog AWSMarketplace ‐‐change-set-id {{changesetID}} ``` + Sehen Sie sich den Status der Anfrage auf der Registerkarte **Anfragen** im [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/) an. ## Sicherung von Software-Downloads Um das geistige Eigentum von ISV-Software zu schützen und eine stabile, konsistente Softwarebereitstellung an AWS Marketplace Käufer sicherzustellen, AWS Marketplace werden Module in Ihrer Komponente automatisch analysiert `S3Download` und `WebDownload` bearbeitet. Die referenzierten Dateien werden dann sicher in einem privaten Amazon S3 S3-Bucket gespeichert, der von verwaltet wird AWS Marketplace. Um diesen Aufnahmeprozess zu deaktivieren und Software-Downloads unabhängig zu verwalten, führen Sie Bash-Skripte aus, die die Befehle `wget` oder `curl` download verwenden.