Die AWS Marketplace-API-Referenz wurde umstrukturiert. 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-Komponentenprodukten Als AWS Marketplace-Verkäufer können Sie AMI-based Produkte anbieten, die mithilfe von EC2 Image Builder-Komponenten an AWS 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-Komponente](#build-and-test-ib-component) + [Kopieren des Komponenten-ARN](#ib-copy-component-arn) + [Erstellen AWS Marketplace IAM-Richtlinien](#ib-create-iam-policies) + [Erstellen der AWS Marketplace IAM role (IAM-Rolle)](#ib-create-iam-role) + [Bereiten Sie Ihre Image Builder-Komponentenliste vor](#prepare-ec2-ib-listing) + [Veröffentlichen Sie Ihre Produktliste für die Image Builder-Komponente](#publishing-ib-component-listing) + [Aktualisierung der Produktinformationen der Image Builder-Komponente](#updating-ec2-image-builder-product) + [Hinzufügen einer neuen Version zu einem vorhandenen Image Builder-Komponentenprodukt](#adding-new-ec2-ib-version-existing-product) + [Informationen zu einer vorhandenen Version aktualisieren](#updating-ec2-ib-product-version) + [Einschränkung der Produktversion einer Image Builder-Komponente](#restricting-ec2-ib-product-version) + [Einen Änderungssatz überwachen](#monitor-changeset) + [Sicherung von Softwaredownloads](#securing-software-downloads) ## Erstellen und Testen Ihrer Image Builder-Komponente Erstellen und testen Sie Ihre Komponente in Image Builder. Anweisungen finden Sie unter [ Entwickeln benutzerdefinierter Komponenten für Ihr Image * Builder-Image *](https://docs.aws.amazon.com/imagebuilder/latest/userguide/create-custom-components.html) im Image Builder-Benutzerhandbuch. Wenn Sie Ihre Komponente mit Image Builder erstellen, stellen Sie sicher, dass Sie Folgendes tun: + Die Komponente und alle ihr zugrunde liegenden Abhängigkeiten, wie z. B. ein Amazon Simple Storage Service (Amazon S3) -Bucket, Geheimnisse 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 erstellen ](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) 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 z. `source` B. 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 bis zu 2 GB aufnehmen, wenn sie die `S3Download` Aktion verwenden. + Wenn Ihre Komponente [ Parameter verwendet](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-user-defined-variables.html#user-defined-vars-parameters), 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 wie haben`us-east-1`. 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 eine Funktion von 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 beim Erstellen der Komponente während des AWS Marketplace Testvorgangs hilft. Nehmen wir zum Beispiel an, 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. `token`Als Schlüssel verwenden. 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 ausgewählt haben. 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-Pipelines verwenden, um AMIs zu erstellen und zu testen. ## Kopieren des Komponenten-ARN Nachdem Sie die Komponente in Image Builder erstellt und getestet haben, kopieren und speichern Sie den Komponenten-ARN. Sie verwenden den ARN, wenn Sie die Produktliste mithilfe der AWS Marketplace Catalog API veröffentlichen. **Um den ARN der Image Builder-Komponente zu kopieren** 1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Image 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 ** Seite ** Komponenten für ** Filterbesitzer ** die Option Mir ** gehört aus**. 1. Wählen Sie den Komponentennamen aus. 1. Kopieren Sie auf der Komponentendetailseite im ** Abschnitt ** Zusammenfassung den ARN. ## Erstellen AWS Marketplace IAM-Richtlinien Erstellen Sie die folgenden IAM-Richtlinien, um AWS Marketplace Zugriff auf Ihre Image Builder-Komponente und zugehörige Ressourcen wie Amazon 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 unter [ Erstellen von Richtlinien mit dem JSON-Editor ](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html#access_policies_create-json-editor) im * IAM-Benutzerhandbuch. * + 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-Richtlinie für Lesezugriff, 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 die zugehörigen 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-Richtlinie für den Lesezugriff, um das Abrufen von Geheimnissen AWS Marketplace zu ermöglichen, die in Secrets Manager gespeichert sind. 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 `*` im `Resource` Abschnitt durch Ihr Geheimnis. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue" ], "Resource": [ "*" ] } ] } ``` ------ + Richtlinie für den Lesezugriff auf den Parameterspeicher, um das Abrufen von Geheimnissen AWS Marketplace zu ermöglichen, die im Parameterspeicher 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 der AWS Marketplace IAM role (IAM-Rolle) Gehen Sie wie folgt vor, um eine AWS Marketplace IAM-Rolle mit Richtlinien zu erstellen, die AWS Marketplace den Zugriff auf Ihre Komponente und ihre Abhängigkeiten 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 Image Builder-Get-Component-Richtlinie hinzu, die Sie zuvor erstellt haben. Die Get-Component-Richtlinie ist erforderlich. Fügen Sie die relevanten 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 mithilfe 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-Komponentenliste vor Stellen Sie vor der Veröffentlichung Ihres AWS Marketplace Angebots sicher, dass Sie über die folgenden Informationen verfügen: + **Produktmetadaten — Zu den ** Metadaten gehören das Produktlogo, der Produkttitel, die Endbenutzer-Lizenzvereinbarung, unterstützte Instanztypen 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 Resource Number (ARN) der Komponente, Nutzungsdetails und die Rolle AWS Identity and Access Management (IAM), die bei der Verarbeitung Ihrer Komponente übernommen AWS Marketplace wird. ## Veröffentlichen Sie Ihre Produktliste für die Image Builder-Komponente Dieses Thema enthält Anweisungen zur Veröffentlichung Ihrer EC2 Image Builder-Komponentenliste AWS Marketplace mithilfe der AWS Marketplace Catalog API. ### Voraussetzungen Stellen Sie sicher, dass Sie über Folgendes verfügen, bevor Sie Ihre Produktliste für Image Builder-Komponenten veröffentlichen: + Registrierung als Verkäufer in AWS Marketplace. Weitere Informationen finden Sie unter Als AWS Marketplace-Verkäufer [ registrieren](https://catalog.workshops.aws/mpseller/en-US/pre-requisite-register-as-seller). + Ein IAM-Benutzer mit `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-Komponentenprodukts auf AWS Marketplace Informationen zum Erstellen eines EC2 Image 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 der Image Builder-Komponente Sie können Informationen zu einem Image Builder-Komponentenprodukt im AWS Marketplace Management Portal aktualisieren. **Um die Produktinformationen der Image Builder-Komponente zu aktualisieren** 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 ** ** Serverproduktseite 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. Nachdem Sie alle Änderungen eingereicht haben, erscheint die Anfrage auf der ** Registerkarte „**Anfragen“ mit dem Status „Wird geprüft“ und ändert sich nach Abschluss in „Erfolgreich“. ## Hinzufügen einer neuen Version zu einem vorhandenen Image Builder-Komponentenprodukt Sie können einem Image Builder-Komponentenprodukt eine neue Version hinzufügen, AWS Marketplace indem Sie die verwenden AWS Marketplace Catalog API. **Um eine neue Version hinzuzufügen** 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 ** ** Serverproduktseite das Produkt aus. 1. Kopieren Sie in der ** Produktübersicht ** die ** Produkt-ID**. 1. Erstellen Sie anhand des folgenden Codebeispiels eine Changeset-Datei im JSON-Format. Ersetzen Sie 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 ihn 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 der. AWS Marketplace Catalog API Diese Fehler werden zurückgegeben, wenn Sie `DescribeChangeSet` nach der Verarbeitung eines Änderungssatzes aufrufen. Weitere Hinweise zur Verwendung`DescribeChangeSet`, um den Status einer Änderungsanforderung abzurufen, 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-Bereitstellungsmethode. Bestehende Fehlermeldungen in Feldern wie `Usage Instructions` `Recommended Instance type``AccessRoleArn`, und finden Sie unter[Fügen Sie eine neue Version hinzu](work-with-single-ami-products.md#ami-add-version). | Fehlercode | Fehlermeldung | | --- | --- | | ASSET\_NICHT\_GEFUNDEN | Prüfen Sie, ob [component arn] im AWS Konto [account-id] vorhanden ist und das von AccessArn bereitgestellte [ARN] über die Berechtigungen verfügt, diese Image Builder-Komponente mit anderen zu teilen. AWS Marketplace | | ASSET\_NICHT\_GEFUNDEN | Der angegebene S3-Link [x] in der Komponente [x] existiert nicht. Geben Sie einen gültigen S3-Link innerhalb der Komponente an. | | DUPLIZIERTER\_KOMPONENTENNAME | Der Komponentenname [x] ist bereits in derselben Version vorhanden. Geben Sie einen anderen Komponentennamen an. | | DUPLIZIERTER\_KOMPONENTENNAME | Der von Ihnen angegebene Komponentenname [x] wird bereits von einem anderen Produkt verwendet. Geben Sie einen anderen Komponentennamen an. | | DUPLIZIERTE\_KOMPONENTE\_ARN | Die Komponente Arn [x] muss sich von der Komponente Arn unterscheiden, die in anderen Lieferoptionen derselben Version dieses Produkts verwendet wird. | | DUPLIZIERTE\_KOMPONENTE\_ARN | Die Komponenten-ARN [x] muss sich von der Komponenten-ARN unterscheiden, die in anderen Versionen dieses Produkts verwendet wird. | | SCAN\_ERROR | Behebt die Sicherheitslücke [y] auf der Komponente [x]. | | ASSET\_ACCESS\_EXCEPTION | Wir haben nicht die erforderlichen Berechtigungen, um den Inhalt aus dem angegebenen S3-Bucket [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 Berechtigungen, 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 entfernen 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. | | ZUVIELE\_IMAGE\_BUILDER\_KOMPONENTEN | Pro Produkt werden maximal 5 eindeutige Komponentennamen unterstützt. Schränken Sie die zusätzliche Lieferoption ein. | | UNVOLLSTÄNDIGES\_ÖFFENTLICHES VERKÄUFERPROFIL | Ihr öffentliches Verkäuferprofil ist nicht vollständig. Vervollständigen Sie Ihr öffentliches Profil, bevor Sie dem Produkt Versionen 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ÜLTIGES\_PFADFORMAT | 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 vom System aus zugegriffen werden kann, das die Aktion ausführt. | | INKOMPATIBLE\_BETRIEBSSYSTEMTYP | Der angegebene Komponenten-Betriebssystemtyp [x] ist nicht mit der Plattform des Basisimages kompatibel. Geben Sie einen Betriebssystemtyp an, der mit dem Basisimage kompatibel ist. | | ASSET\_ACCESS\_EXCEPTION | Wir haben nicht 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 haben nicht 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. | | UNGÜLTIGE\_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-Version mit Build-Versionen 1 und versuchen Sie es erneut AWS Marketplace | | UNGÜLTIGER\_IB\_COMPONENT\_PARAMETER | Der SSM-Parameter in der Eingabe [x] für die Komponente [y] konnte nicht analysiert werden. | | UNGÜLTIGER\_IB\_KOMPONENTENPARAMETER | Das SecretsManager Geheimnis in der Eingabe [x] für die Komponente [y] konnte nicht analysiert werden. | | FEHLENDER\_IB\_COMPONENT\_PARAMETER | Der Parameter wurde in der Komponente [x] für die Eingabe [y] nicht gefunden | | UNGÜLTIGER\_IB\_COMPONENT\_PARAMETER | Geben Sie einen Standardwert für den Parameter [x] in der Komponente [y] an. | | FEHLGESCHLAGEN\_STARTTEST | Der Starttest für die Komponente [x] ist fehlgeschlagen. Fehlermeldung: [z] | | SSHAuthFailedForUserAndKeypair | Die Anmeldung bei der Instanz mit dem Betriebssystem-Standardbenutzernamen [X] ist nicht möglich. | | UNGÜLTIGE\_IB\_COMPONENT | Eine Phase der Komponentenerstellung ist erforderlich. Fügt der Komponente [x] eine gültige Build-Phase hinzu | | DUPLIZIERTER\_VERSIONSTITEL | Der Versionstitel muss sich von allen anderen Versionstiteln dieses Produkts unterscheiden. | | UNGÜLTIGER\_VERSIONSTITEL | Entfernen Sie Leerzeichen vor dem Markensymbol. | | UNGÜLTIGER\_VERSIONSTITEL | Nicht unterstützte Zeichen entfernen: [x, y, z] | | UNGÜLTIGER\_VERSIONSTITEL | Entfernen Sie Leerzeichen am Anfang des Versionstitels. | | UNGÜLTIGER\_VERSIONSTITEL | Geben Sie den Versionstitel mit weniger als [x] Zeichen an. | | UNGÜLTIGE\_VERSIONSHINWEIS | Entfernen Sie Leerzeichen vor dem Markensymbol. | | UNGÜLTIGE\_VERSIONSHINWEIS | Nicht unterstützte Zeichen entfernen: [x, y, z] | | INVALID\_RELEASE\_NOTES | Entfernen Sie Leerzeichen am Anfang der Versionshinweise. | | UNGÜLTIGE\_VERSIONSHINWEIS | Geben Sie Versionshinweise mit weniger als (x) Zeichen an. | | UNGÜLTIGE\_NUTZUNGSANWEISUNGEN | Entfernen Sie Leerzeichen vor dem Markensymbol. | | UNGÜLTIGE\_NUTZUNGSANWEISUNGEN | Nicht unterstützte Zeichen entfernen: [x, y, z] | | UNGÜLTIGE\_USAGE\_INSTRUCTIONS | Geben Sie Nutzungsanweisungen mit weniger als (x) Zeichen an. | | DUPLIZIERTE\_LIEFEROPTION\_TITEL | Geben Sie einen eindeutigen Titel der Lieferoption an. | | UNGÜLTIGE\_LIEFEROPTION\_TITEL | Der Titel der Versandoption ist bereits vorhanden. Versuchen Sie es erneut mit einem anderen Titel. | ## Informationen zu einer vorhandenen Version aktualisieren **Um Informationen zu einer vorhandenen 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 ** ** Serverproduktseite 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`DeliveryOptions`, für die Version, die Sie aktualisieren möchten. 1. Erstellen Sie anhand des folgenden Codebeispiels eine Changeset-Datei im JSON-Format. Ersetzen Sie 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 Nutzungsanweisungen. ``` [ { "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 unter 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änkung der Produktversion einer Image Builder-Komponente Wenn Sie eine Version einschränken, ist sie für Käufer nicht verfügbar. Sie können eine Version Ihres Image Builder-Komponentenprodukts auf die AWS Marketplace Verwendung der AWS Marketplace Catalog API einschränken. Sie müssen mindestens eine Version Ihres Produkts uneingeschränkt aktivieren AWS Marketplace. Sie können den Zugriff auf die einzige öffentliche Version nicht einschränken. **Um Informationen zu einer vorhandenen 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 ** ** Serverproduktseite 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`DeliveryOptions`, für die Version, die Sie aktualisieren möchten. 1. Erstellen Sie anhand des folgenden Codebeispiels eine Changeset-Datei im JSON-Format. Ersetzen Sie 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. Ersetzen Sie im Befehl. {{changeset-ID}} durch den vom `start-change-set` Befehl zurückgegebenen `ChangeSetId` Wert. ``` aws marketplace-catalog describe-change-set ‐‐catalog AWSMarketplace ‐‐change-set-id {{changesetID}} ``` + Sehen Sie sich den Anforderungsstatus auf der ** Registerkarte ** Anfragen im [AWS Marketplace Management Portal ](https://aws.amazon.com/marketplace/management/) an. ## Sicherung von Softwaredownloads Um das geistige Eigentum von ISV-Software zu schützen und eine stabile, konsistente Softwarebereitstellung an AWS Marketplace Käufer zu gewährleisten, AWS Marketplace werden in Ihrer Komponente automatische Analysen `S3Download` und `WebDownload` Aktionsmodule installiert. Die referenzierten Dateien werden dann sicher in einem privaten Amazon S3-Bucket gespeichert, der von verwaltet wird. AWS Marketplace Um diesen Aufnahmevorgang zu deaktivieren und Softwaredownloads unabhängig zu verwalten, führen Sie Bash-Skripts aus, die die Befehle `wget` oder `curl` download verwenden.