View a markdown version of this page

Arbeiten Sie mit EC2 Image Builder Builder-Komponentenprodukten - AWS Marketplace

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.

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.

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 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 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 verwendet, stellen Sie sicher, dass alle Parameter Standardwerte haben. Wenn Sie beispielsweise einen Parameter benannt habenregion, 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 aufgerufentoken, 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 unterhttps://console.aws.amazon.com/imagebuilder/.

  2. Wählen Sie in der linken Navigationsleiste unter Gespeicherte Ressourcen die Option Komponenten aus.

  3. Wählen Sie auf der Komponentenseite für Besitzer des Filters die Option Owned by me aus.

  4. Wählen Sie den Namen der Komponente.

  5. 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 hinzu. Hilfe beim Erstellen von Richtlinien finden Sie im IAM-Benutzerhandbuch unter Richtlinien mit dem JSON-Editor erstellen.

  • 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/.

  2. Wählen Sie in der linken Navigationsleiste Rollen aus.

  3. Wählen Sie Rolle erstellen aus.

  4. Wählen Sie Benutzerdefinierte Vertrauensrichtlinie aus.

  5. 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" } ] }
  6. Wählen Sie Weiter aus.

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

  8. Wählen Sie Weiter aus.

  9. Geben Sie einen Rollennamen ein, z. MPEC2IBIngestion B.

  10. 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.

  2. Wählen Sie die AWS Marketplace IAM-Rolle aus, die Sie zuvor erstellt haben, z. B. MPEC2IBIngestion

  3. 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.

  • 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? 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 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 Portalund melden Sie sich bei Ihrem Verkäuferkonto an.

  2. Wählen Sie im Menü Produkte die Option Server aus.

  3. Wählen Sie auf der Seite Serverprodukte das Produkt aus.

  4. Wählen Sie auf der Produktdetailseite im Menü Änderungen anfordern den Artikel aus, der den Informationen entspricht, die Sie aktualisieren möchten.

  5. 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 Portalund melden Sie sich bei Ihrem Verkäuferkonto an.

    2. Wählen Sie im Menü Produkte die Option Server aus.

    3. Wählen Sie auf der Seite Serverprodukte das Produkt aus.

    4. Kopieren Sie in der Produktübersicht die Produkt-ID.

  2. 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-nameErsetzen Sie es durch Ihren Versionstitel. new-delivery-option-titleErsetzen 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" } } } ] } } ]
  3. Speichern Sie die Changeset-Datei mit dem Namen. addIBversion.json

  4. 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 unterEinen Änderungssatz überwachen.

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 unterMit Änderungssätzen arbeiten.

Anmerkung

Die folgenden Fehlercodes sind spezifisch für die Image Builder Builder-Liefermethode. Informationen zu vorhandenen Fehlermeldungen in Feldern wie Usage Instructions Recommended Instance typeAccessRoleArn, und finden Sie unterEine neue Version hinzufügen.

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 Portalund melden Sie sich bei Ihrem Verkäuferkonto an.

    2. Wählen Sie im Menü Produkte die Option Server aus.

    3. Wählen Sie auf der Seite Serverprodukte das Produkt aus.

    4. Kopieren Sie in der Produktübersicht die Produkt-ID.

  2. 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'
  3. Gehen Sie in der zurückgegebenen Ausgabe zum Versions AbschnittDetailsDocument,. Kopieren Sie den Id Wert für die VersionDeliveryOptions, die Sie aktualisieren möchten.

  4. 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-notesErsetzen Sie es durch Ihre Versionshinweise. your-delivery-option-IDErsetzen Sie es durch die ID der Lieferoption, die Sie in Schritt 3 erhalten haben. your-usage-instructionsErsetzen 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" } } } ] } } ]
  5. Speichern Sie die Changeset-Datei mit dem Namen. updateVersionInfo.json

  6. 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 unterEinen Änderungssatz überwachen.

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 Portalund melden Sie sich bei Ihrem Verkäuferkonto an.

    2. Wählen Sie im Menü Produkte die Option Server aus.

    3. Wählen Sie auf der Seite Serverprodukte das Produkt aus.

    4. Kopieren Sie in der Produktzusammenfassung die Produkt-ID.

  2. 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'
  3. Gehen Sie in der zurückgegebenen Ausgabe zum Versions AbschnittDetailsDocument,. Kopieren Sie den Id Wert für die VersionDeliveryOptions, die Sie aktualisieren möchten.

  4. 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-IDErsetzen 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" ] } } ]
  5. Speichern Sie die Changeset-Datei mit dem Namen. restrictec2ibversion.json

  6. 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 unterEinen Änderungssatz überwachen.

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