Se reestructuró la referencia de API de AWS Marketplace. Para obtener más información sobre las operaciones de API compatibles, consulte la [referencia de API de AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/Welcome.html). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Trabaje con los productos componentes de EC2 Image Builder Como vendedor de AWS Marketplace, puede publicar AMI-based productos entregados a compradores de AWS Marketplace mediante componentes de EC2 Image Builder. Para crear su componente y publicar un AWS Marketplace listado, siga las siguientes secciones de forma secuencial. **Topics** + [Creación y prueba del componente Image Builder](#build-and-test-ib-component) + [Copiar el ARN del componente](#ib-copy-component-arn) + [Creación AWS Marketplace Políticas de IAM](#ib-create-iam-policies) + [Creando el AWS Marketplace rol de IAM](#ib-create-iam-role) + [Prepare su lista de componentes de Image Builder](#prepare-ec2-ib-listing) + [Publicar la lista de productos de los componentes de Image Builder](#publishing-ib-component-listing) + [Actualización de la información del producto del componente Image Builder](#updating-ec2-image-builder-product) + [Añadir una nueva versión a un producto componente de Image Builder existente](#adding-new-ec2-ib-version-existing-product) + [Actualización de la información sobre una versión existente](#updating-ec2-ib-product-version) + [Restringir la versión de un producto componente de Image Builder](#restricting-ec2-ib-product-version) + [Supervisión de un conjunto de cambios](#monitor-changeset) + [Proteger las descargas de software](#securing-software-downloads) ## Creación y prueba del componente Image Builder Cree y pruebe su componente en Image Builder. Para obtener instrucciones, consulte [Desarrollo de componentes personalizados para la imagen de Image Builder](https://docs.aws.amazon.com//imagebuilder/latest/userguide/create-custom-components.html) en la *Guía del usuario de Image Builder*. Al crear el componente mediante Image Builder, asegúrese de hacer lo siguiente: + El componente y todas sus dependencias subyacentes, como un bucket, los secretos o los parámetros de Amazon Simple Storage Service (Amazon S3), deben crearse en la región de AWS de EE. UU. Este (Virginia del Norte`us-east-1`) (). + Incluya la arquitectura compatible y cualquier dependencia del software en la descripción del componente. + Pruebe el componente en su AWS cuenta creando una [canalización de imágenes](https://docs.aws.amazon.com/imagebuilder/latest/userguide/start-build-image-pipeline.html) e implementando la AMI creada por la canalización. + Si su componente contiene instrucciones para copiar binarios, paquetes o archivos de un bucket de S3, utilice el módulo de `S3Download` acción. En el `S3Download` módulo, para`source`, introduzca la ubicación estática del archivo en el bucket de S3. En el siguiente ejemplo, se copia un binario de un bucket de S3 como parte de la instalación del componente. ``` - name: DownloadMyFile action: S3Download inputs: - source: s3://amzn-s3-demo-source-bucket/path/to/package.zip destination: C:\myfolder\package.zip ``` + Los componentes pueden ingerir archivos de hasta 2 GB al utilizar la `S3Download` acción. + Si el componente usa [parámetros](https://docs.aws.amazon.com/imagebuilder/latest/userguide/toe-user-defined-variables.html#user-defined-vars-parameters), asegúrese de que todos los parámetros tengan valores predeterminados. Por ejemplo, si tiene un nombre para un parámetro`region`, asegúrese de tener un valor predeterminado válido, como`us-east-1`. Estos valores predeterminados son para el AWS Marketplace procesamiento y las pruebas. Las pruebas pueden fallar si no incluye los valores predeterminados. + Si su componente utiliza AWS Secrets Manager un almacén de parámetros o la capacidad de AWS Systems Manager almacenar parámetros, haga lo siguiente: + + Para recuperar valores como un paso de tu componente, inserta AWS Command Line Interface los comandos en tu archivo de configuración YAML. + Cree la entrada correspondiente en Secrets Manager o Parameter Store en su AWS cuenta. Utilice la clave predeterminada y proporcione un valor válido que ayude a construir el componente durante el proceso de AWS Marketplace prueba. Por ejemplo, supongamos que tiene un parámetro llamado `saas_token` con un valor predeterminado de `token` que utiliza Parameter Store. En este caso, cree un par clave-valor en el almacén de parámetros. Úselo `token` como clave. Para el valor, introduzca un token de SaaS válido para su aplicación. Ten en cuenta que los valores almacenados en tu cuenta de AWS Marketplace vendedor solo se utilizarán con fines AWS Marketplace de prueba. Estos valores no se compartirán con los compradores. + AWS Marketplace genera automáticamente Amazon Machine Images (AMI) para su componente en todas las versiones de sistemas operativos compatibles que elija durante el proceso de creación del componente. Al crear el componente, elija al menos una versión de sistema operativo compatible. Valide la compatibilidad de su componente con todas las versiones del sistema operativo elegidas mediante las canalizaciones de EC2 Image Builder para crear y probar las AMI. ## Copiar el ARN del componente Tras crear y probar el componente en Image Builder, copie y guarde el ARN del componente. Utilizarás el ARN cuando publiques la lista de productos mediante la API de AWS Marketplace catálogo. **Para copiar el ARN del componente Image Builder** 1. Inicie sesión en la consola de administración de AWS y abra la consola de Image Builder en[https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. En la barra de navegación izquierda, en **Recursos guardados**, elija **Componentes**. 1. En la página **Componentes**, en **Propietario del filtro**, selecciona **De mi propiedad**. 1. Elija el nombre del componente. 1. En la página de detalles del componente, en la sección **Resumen**, copie el ARN. ## Creación AWS Marketplace Políticas de IAM Cree las siguientes políticas de IAM para conceder AWS Marketplace acceso a su componente Image Builder y a los recursos relacionados, como los buckets y secretos de Amazon S3. Utilice las políticas de ejemplo que se proporcionan. Estas políticas se asocian a un [rol de AWS Marketplace IAM](#ib-create-iam-role). Si necesitas ayuda para crear políticas, consulta [Cómo crear políticas con el editor JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html#access_policies_create-json-editor) en la Guía del *usuario de IAM*. + Política de obtención de componentes de Image Builder, para permitir el acceso AWS Marketplace a su componente en Image Builder. Esta política es obligatoria. Llame a la política `mp_ib_ingest`. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": "imagebuilder:GetComponent", "Resource": "*" } ] } ``` ------ + Política de acceso de lectura de Amazon S3, que permite AWS Marketplace recuperar archivos binarios de un bucket de S3. Esta política solo es necesaria si su componente usa el módulo de `S3Download` acción y almacena los binarios asociados en un bucket de S3. Llame a la política `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}}/*" ] } ] } ``` ------ + Política de acceso de lectura a Secrets Manager, que permite AWS Marketplace recuperar los secretos almacenados en Secrets Manager. Esta política solo es necesaria si el componente usa Secrets Manager para almacenar secretos. Llame a la política `mp_ib_sm_read_only`. Para restringir la política únicamente a su secreto, sustituya lo que `*` aparece en la `Resource` sección por su secreto. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "VisualEditor0", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue" ], "Resource": [ "*" ] } ] } ``` ------ + Política de acceso de lectura a Parameter Store, que permite AWS Marketplace recuperar los secretos almacenados en Parameter Store. Esta política solo es necesaria si el componente utiliza Parameter Store para almacenar secretos. Llame a la política `mp_ib_ssm_parameter_read_only`. Para restringir la política únicamente a su secreto, sustituya lo que `*` aparece en la `Resource` sección por su secreto. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Action": [ "ssm:getParameter" ], "Resource": [ "*" ] } ] } ``` ------ ## Creando el AWS Marketplace rol de IAM Utilice el siguiente procedimiento para crear un rol de AWS Marketplace IAM con políticas que permitan el AWS Marketplace acceso a su componente y sus dependencias. **Para crear el AWS Marketplace rol de IAM** 1. Inicie sesión en la consola AWS de administración y abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. En la barra de navegación izquierda, selecciona **Roles**. 1. Elija **Crear rol**. 1. Selecciona **Política de confianza personalizada**. 1. Introduce la siguiente declaración: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Principal": { "Service": "assets.marketplace.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. Elija **Siguiente**. 1. Agregue la política de obtención de componentes de Image Builder que creó anteriormente. Se requiere la política de obtención de componentes. Agregue las políticas pertinentes para S3, Secrets Manager y Parameter Store si su componente utiliza estos AWS servicios. 1. Elija **Siguiente**. 1. Introduzca un nombre de función, por ejemplo`MPEC2IBIngestion`. 1. Elija **Crear rol**. ### Copiar AWS Marketplace ARN del rol de IAM Tras crear el rol de AWS Marketplace IAM, copie y guarde el ARN del rol. Utilizarás el ARN cuando publiques el listado mediante la API de AWS Marketplace catálogo. **Para copiar el AWS Marketplace ARN del rol de IAM** 1. En la consola de IAM, en la barra de navegación izquierda, elija **Roles**. 1. Elija el rol AWS Marketplace de IAM que creó anteriormente, por ejemplo. `MPEC2IBIngestion` 1. En la página de detalles del rol, en la sección **Resumen**, copia el ARN. ## Prepare su lista de componentes de Image Builder Antes de publicar tu AWS Marketplace anuncio, asegúrate de tener lista la siguiente información: + **Metadatos del producto:** los metadatos incluyen el logotipo del producto, el título del producto, el acuerdo de licencia de usuario final, los tipos de instancias compatibles y la región de AWS. + **Información sobre precios:** puede ofrecer su producto de forma gratuita, con una tarifa por hora o con un período de prueba inicial gratuito. No se admite la licencia Bring Your Own License (BYOL). + **Detalles del componente:** los detalles incluyen el número de recurso de Amazon (ARN) del componente, los detalles de uso y la función AWS Identity and Access Management (IAM) que AWS Marketplace asumirá al procesar el componente. ## Publicar la lista de productos de los componentes de Image Builder Este tema contiene instrucciones para publicar la lista de componentes de EC2 Image Builder AWS Marketplace sobre el uso de AWS Marketplace la API de catálogo. ### Requisitos previos Asegúrese de disponer de lo siguiente antes de publicar la lista de productos de los componentes de Image Builder: + Registro como vendedor en AWS Marketplace. Para obtener más información, consulte [Registrarse como vendedor de AWS Marketplace](https://catalog.workshops.aws/mpseller/en-US/pre-requisite-register-as-seller). + Usuario de IAM con `AWSMarketplaceSellerFullAccess` permiso. + Un depósito de Amazon Simple Storage Service (Amazon S3) de acceso público para alojar el logotipo de su empresa y el EULA, si se utiliza en su componente. Introducirá la URL del bucket de S3 en su archivo `ChangeSet` JSON. + AWS Command Line Interface (AWS CLI). Para obtener más información, consulte [¿Qué es la interfaz de línea de comandos de AWS?](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html) en la *Guía AWS Command Line Interface del usuario*. ### Creación de un producto componente de Image Builder en AWS Marketplace Para crear un producto componente de EC2 Image Builder mediante AWS Marketplace la API de catálogo, consulte[Cree un producto](work-with-seller-products.md#create-product). ## Actualización de la información del producto del componente Image Builder Puede actualizar la información sobre un producto componente de Image Builder en el Portal AWS Marketplace de administración. **Para actualizar la información del producto de los componentes de Image Builder** 1. Abra el [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour/) e inicie sesión en su cuenta de vendedor. 1. En el menú **Productos**, seleccione **Servidor**. 1. En la página de **productos para servidores**, seleccione el producto. 1. En la página de detalles del producto, en el menú **Solicitar cambios**, selecciona el artículo que corresponda a la información que deseas actualizar. 1. Tras enviar cualquier cambio, la solicitud aparecerá en la pestaña **Solicitudes** con el estado «En revisión» y cambiará a «Aceptada» una vez completada. ## Añadir una nueva versión a un producto componente de Image Builder existente Puede añadir una nueva versión a un producto componente de Image Builder al AWS Marketplace utilizar el AWS Marketplace Catalog API. **Agregar una nueva versión** 1. Desde el AWS Marketplace Management Portal, obtenga el ID del producto. 1. Abra el [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour/) e inicie sesión en su cuenta de vendedor. 1. En el menú **Productos**, selecciona **Servidor**. 1. En la página de **productos para servidores**, seleccione el producto. 1. En el **resumen del producto**, copia el **identificador del producto**. 1. Con el siguiente ejemplo de código, cree un archivo de conjunto de cambios en formato JSON. En el ejemplo, {{your-product-ID}} sustitúyalo por el identificador de producto que obtuviste en el paso 1. {{new-version-name}}Sustitúyalo por el título de la versión. {{new-delivery-option-title}}Sustitúyalo por el título de la opción de envío. ``` [ { "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. Guarda el archivo del conjunto de cambios con el nombre`addIBversion.json`. 1. En tu terminal o AWS CloudShell ejecuta el siguiente comando: ``` aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://addIBversion.json ``` El `start-change-set` comando devolverá un `ChangeSetId` valor. Para supervisar un conjunto de cambios, consulte[Supervisión de un conjunto de cambios](#monitor-changeset). **Errores asíncronos** Los siguientes errores son específicos de las `AddDeliveryOptions` acciones de. AWS Marketplace Catalog API Estos errores se devuelven cuando se llama `DescribeChangeSet` después de que se esté procesando un conjunto de cambios. Para obtener más información sobre cómo `DescribeChangeSet` obtener el estado de una solicitud de cambio, consulte[Trabajar con conjuntos de cambios](catalog-apis.md#working-with-change-sets). **nota** Los siguientes códigos de error son específicos del método de entrega de Image Builder. Para ver los mensajes de error existentes en campos como `Usage Instructions``Recommended Instance type`, y`AccessRoleArn`, consulte[Agregar una nueva versión](work-with-single-ami-products.md#ami-add-version). | Código de error | Mensaje de error | | --- | --- | | ASSET\_NOT\_FOUND | Compruebe si [component arn] existe en la AWS cuenta [account-id] y si el AccessARN proporcionado [ARN] tiene permisos para compartir este componente de Image Builder. AWS Marketplace | | ASSET\_NOT\_FOUND | El enlace S3 [x] especificado dentro del componente [x] no existe. Proporcione un enlace S3 válido dentro del componente. | | DUPLICATE\_COMPONENT\_NAME | El nombre del componente [x] ya existe en la misma versión. Proporcione un nombre de componente diferente. | | DUPLICATE\_COMPONENT\_NAME | El nombre del componente [x] que ha proporcionado ya está siendo utilizado en otro producto. Proporcione un nombre de componente diferente. | | DUPLICATE\_COMPONENT\_ARN | El componente Arn [x] debe ser diferente del componente Arn utilizado en otras opciones de entrega de la misma versión de este producto. | | DUPLICATE\_COMPONENT\_ARN | El ARN del componente [x] debe ser diferente del ARN del componente utilizado en otras versiones de este producto. | | SCAN\_ERROR | Corrige la vulnerabilidad de seguridad [y] en el componente [x]. | | ASSET\_ACCESS\_EXCEPTION | No tenemos los permisos necesarios para leer el contenido del bucket de S3 especificado [x]. Asegúrese de que el bucket de S3 tenga los permisos de lectura adecuados. | | ASSET\_ACCESS\_EXCEPTION | No tenemos los permisos necesarios para leer el contenido del ARN [x] del componente especificado. Asegúrese de que el ARN del componente tenga los permisos de lectura adecuados. | | ASSET\_ACCESS\_EXCEPTION | No tenemos los permisos necesarios para leer el contenido del URI [x] del paquete especificado. Asegúrese de que el URI del paquete tenga los permisos de lectura adecuados. | | ASSET\_ACCESS\_EXCEPTION | No se pudo leer la fuente HTTP [x]. Compruebe que la fuente HTTP proporcionada sea correcta. | | INVALID\_IMAGE\_BUILDER\_COMPONENT\_PACKAGE | Los activos de los componentes superan el límite de tamaño para su ingestión. Reduzca el tamaño de las S3/web descargas o elimine las descargas innecesarias para continuar. | | INVALID\_IMAGE\_BUILDER\_COMPONENT\_PACKAGE | Los activos de los componentes tardan demasiado en ingerirse. Asegúrese de que la conexión de red sea estable y tenga el ancho de banda adecuado. | | DEMASIADOS COMPONENTES DE IMAGE\_BUILDER\_COMPONENTS | Se admite un máximo de 5 nombres de componentes únicos por producto, lo que restringe la opción de entrega adicional. | | INCOMPLETE\_SELLER\_PUBLIC\_PROFILE | Tu perfil público de vendedor no está completo. Completa tu perfil público antes de añadir versiones al producto. | | DESCRIPCIÓN\_INVÁLIDA | Falta la descripción. Proporcione una descripción con menos de 1024 caracteres en el componente [x]. | | NOMBRE\_DE\_COMPONENTE NO VÁLIDO | Proporcione un nombre de componente con menos de [x] caracteres. | | VERSIÓN DE SISTEMA OPERATIVO ADMITIDA NO VÁLIDA | Falta la versión del sistema operativo. Proporcione una versión de sistema operativo compatible válida en el componente [x]. | | FORMATO\_DE\_RUTA NO VÁLIDO | El paso [STEP\_NAME] de la fase [PHASE\_NAME] no puede utilizar S3 o URL web para las acciones. InstallMSI/UninstallMSI Asegúrese de que la ruta especificada sea una ruta local válida a la que se pueda acceder desde el sistema que ejecuta la acción. | | INCOMPATIBLE\_OS\_TYPE | El tipo de sistema operativo del componente especificado [x] no es compatible con la plataforma de la imagen base. Proporcione un tipo de sistema operativo que sea compatible con la imagen base. | | ASSET\_ACCESS\_EXCEPTION | No tenemos los permisos necesarios para leer el contenido del parámetro SSM especificado [x]. Asegúrese de que la función de acceso a IAM proporcionada en la entrada de la API tenga los permisos de lectura necesarios. | | ASSET\_ACCESS\_EXCEPTION | No tenemos los permisos necesarios para leer el contenido del secreto especificado SecretsManager [x]. Asegúrese de que la función de acceso a IAM proporcionada en la entrada de la API tenga los permisos de lectura necesarios. | | INVALID\_IB\_COMPONENT\_BUILD\_VERSION | El componente ARN [x] tiene una versión de compilación de [y]. AWS Marketplace solo es compatible con la versión de compilación 1. Cree una nueva versión de EC2 Image Builder con las versiones 1 de Build e inténtelo de nuevo AWS Marketplace | | INVALID\_IB\_COMPONENT\_PARAMETER | No se pudo analizar el parámetro SSM en la entrada [x] para el componente [y]. | | INVÁLID\_IB\_COMPONENT\_PARAMETER | No se pudo analizar el SecretsManager secreto de la entrada [x] del componente [y]. | | MISSING\_IB\_COMPONENT\_PARAMETER | No se encontró el parámetro en el componente [x] para la entrada [y] | | INVÁLID\_IB\_COMPONENT\_PARAMETER | Proporcione un valor predeterminado para el parámetro [x] del componente [y]. | | FALLED\_LAUNCH\_TEST | La prueba de lanzamiento del componente [x] ha fallado. Mensaje de error: [z] | | SSHAuthFailedForUserAndKeypair | No se puede iniciar sesión en la instancia con el nombre de usuario predeterminado del sistema operativo [X]. | | INVÁLID\_IB\_COMPONENT | Se requiere una fase de creación del componente. Añada una fase de construcción válida al componente [x] | | DUPLICATE\_VERSION\_TITLE | El título de la versión debe ser diferente al de cualquier otro título de versión de este producto. | | TITLE\_DE\_VERSIÓN\_INVÁLIDO | Elimine los espacios antes del símbolo de la marca comercial. | | TITULO\_DE\_VERSIÓN\_INVALIDO | Eliminar caracteres no admitidos: [x, y, z] | | TÍTULO\_DE\_VERSIÓN\_INVÁLIDO | Elimine los espacios del principio del título de la versión. | | TITLE\_DE\_VERSIÓN\_INVÁLIDO | Proporcione el título de la versión con menos de [x] caracteres. | | NOTAS DE PUBLICACIÓN NO VÁLIDAS | Elimine los espacios antes del símbolo de la marca comercial. | | INVALID\_RELEASE\_NOTES | Eliminar caracteres no admitidos: [x, y, z] | | NOTAS DE PUBLICACIÓN NO VÁLIDAS | Elimine los espacios del principio de las notas de la versión. | | NOTAS DE PUBLICACIÓN NO VÁLIDAS | Proporcione las notas de la versión con menos de (x) caracteres. | | INSTRUCCIONES\_DE\_USO INVÁLIDAS | Elimine los espacios antes del símbolo de la marca comercial. | | INSTRUCCIONES DE USO NO VÁLIDAS | Eliminar caracteres no admitidos: [x, y, z] | | INSTRUCCIONES\_DE\_USO INVÁLIDAS | Proporcione instrucciones de uso con menos de (x) caracteres. | | DUPLICATE\_DELIVERY\_OPTION\_TITLES | Proporcione un título exclusivo para la opción de entrega. | | TÍTULO\_DE\_OPCIÓN\_DE\_ENTREGA NO VÁLIDOS | El título de la opción de envío ya existe. Vuelva a intentarlo con un título diferente. | ## Actualización de la información sobre una versión existente **Para actualizar la información sobre una versión existente** 1. Desde AWS Marketplace Management Portal, obtenga el identificador del producto. 1. Abra el [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour/) e inicie sesión en su cuenta de vendedor. 1. En el menú **Productos**, selecciona **Servidor**. 1. En la página de **productos para servidores**, seleccione el producto. 1. En el **resumen del producto**, copia el **identificador del producto**. 1. En tu terminal, ejecuta el siguiente comando. En el comando, {{your-product-ID}} sustitúyalo por el ID que obtuviste en el paso 1. ``` aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id '{{your-product-ID}}' ``` 1. En el resultado devuelto, vaya a la `Versions` sección`DetailsDocument`,. Copia el `Id` valor`DeliveryOptions`, de la versión que deseas actualizar. 1. Con el siguiente ejemplo de código, cree un archivo de conjunto de cambios en formato JSON. En el ejemplo, {{your-product-ID}} sustitúyalo por el identificador de producto que obtuviste en el paso 1. {{your-release-notes}}Sustitúyalo por las notas de la versión. {{your-delivery-option-ID}}Sustitúyalo por el identificador de la opción de entrega que obtuviste en el paso 3. {{your-usage-instructions}}Sustitúyalo por tus instrucciones de uso. ``` [ { "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. Guarda el archivo del conjunto de cambios con el nombre`updateVersionInfo.json`. 1. En tu terminal o AWS CloudShell ejecuta el siguiente comando: ``` aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://updateVersionInfo.json ``` El `start-change-set` comando devolverá un `ChangeSetId` valor. Para supervisar un conjunto de cambios, consulte[Supervisión de un conjunto de cambios](#monitor-changeset). ## Restringir la versión de un producto componente de Image Builder Restringir una versión hace que no esté disponible para los compradores. Puede restringir una versión de su producto componente de Image Builder AWS Marketplace mediante la API de AWS Marketplace catálogo. Debe conservar al menos una versión de su producto sin restricciones AWS Marketplace. No puedes restringir el acceso a la única versión pública. **Para actualizar la información sobre una versión existente** 1. Desde AWS Marketplace Management Portal, obtenga el identificador del producto. 1. Abra el [AWS Marketplace Management Portal](https://aws.amazon.com/marketplace/management/tour/) e inicie sesión en su cuenta de vendedor. 1. En el menú **Productos**, selecciona **Servidor**. 1. En la página de **productos para servidores**, seleccione el producto. 1. En el **resumen del producto**, copia el **identificador del producto**. 1. En tu terminal, ejecuta el siguiente comando. En el comando, {{your-product-ID}} sustitúyalo por el ID que obtuviste en el paso 1. ``` aws marketplace-catalog describe-entity --catalog AWSMarketplace --region us-east-1 --entity-id '{{your-product-ID}}' ``` 1. En el resultado devuelto, vaya a la `Versions` sección`DetailsDocument`,. Copia el `Id` valor`DeliveryOptions`, de la versión que deseas actualizar. 1. Con el siguiente ejemplo de código, cree un archivo de conjunto de cambios en formato JSON. En el ejemplo, {{your-product-ID}} sustitúyalo por el identificador de producto que obtuviste en el paso 1. {{your-delivery-option-ID}}Sustitúyalo por el identificador de la opción de entrega que obtuviste en el paso 3. ``` [ { "ChangeType": "RestrictDeliveryOptions", "Entity": { "Identifier": "{{your-product-ID}}", "Type": "AmiProduct@1.0" }, "DetailsDocument": { "DeliveryOptionIds": [ "{{your-delivery-option-ID}}" ] } } ] ``` 1. Guarda el archivo del conjunto de cambios con el nombre`restrictec2ibversion.json`. 1. En tu terminal o AWS CloudShell ejecuta el siguiente comando: ``` aws marketplace-catalog start-change-set --catalog AWSMarketplace --region us-east-1 --change-set file://restrictec2ibversion.json ``` El `start-change-set` comando devolverá un `ChangeSetId` valor. Para supervisar un conjunto de cambios, consulte[Supervisión de un conjunto de cambios](#monitor-changeset). ## Supervisión de un conjunto de cambios El `start-change-set` comando devolverá un `ChangeSetId` valor. Puede supervisar el progreso del conjunto de cambios de las siguientes maneras: + Ejecuta el siguiente comando en tu terminal. En el comando, {{changeset-ID}} sustituya por el `ChangeSetId` valor devuelto por el `start-change-set` comando. ``` aws marketplace-catalog describe-change-set ‐‐catalog AWSMarketplace ‐‐change-set-id {{changesetID}} ``` + Consulte el estado de la solicitud en la pestaña **Solicitudes** del [portal AWS Marketplace de administración](https://aws.amazon.com/marketplace/management/). ## Proteger las descargas de software Para proteger la propiedad intelectual del software ISV y garantizar una entrega de software estable y coherente a AWS Marketplace los compradores, analiza `S3Download` y activa AWS Marketplace automáticamente los `WebDownload` módulos de su componente. A continuación, los archivos a los que se hace referencia se almacenan de forma segura en un bucket privado de Amazon S3 gestionado por AWS Marketplace. Para excluirse de este proceso de ingesta y gestionar las descargas de software de forma independiente, ejecute scripts bash que utilicen los comandos `wget` or `curl` download.