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 soluciones Una solución es un conjunto de productos y servicios que funcionan juntos para resolver problemas específicos de los clientes. Las soluciones pueden incluir productos de AWS Marketplace y productos que no sean de AWS Marketplace. Las soluciones le ayudan a mostrar cómo se integran varios productos para abordar casos de uso específicos del sector. La solución describe el problema del cliente, los casos de uso, los detalles de la integración y los productos relacionados. ## Soluciones en AWS Marketplace y AWS Partner Central Al migrar de Partner Central 2.0 a Partner Central 3.0, se le solicitará que cree una cuenta de AWS y se registre como vendedor de AWS Marketplace. Para obtener más información, consulte [Registrar y crear su perfil de vendedor](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html). Este registro es necesario para: + Migre sus soluciones actuales de Partner Central al catálogo de AWS Marketplace (todas las soluciones se migrarán al `AWSMarketplace` catálogo) + Permita que sus soluciones de AWS Marketplace funcionen con las API de Partner Central, como [las API de venta](https://docs.aws.amazon.com/partner-central/latest/APIReference/working-with-your-opportunities.html). ### Comprenda la vinculación y la migración de perfiles Existen dos escenarios distintos para conectar sus cuentas de Partner Central y AWS Marketplace: **Solo vinculación de perfiles**: si vincula sus cuentas de AWS Partner Central y AWS sin migrar a Partner Central 3.0, sus soluciones de AWS Marketplace y las soluciones de Partner Central permanecen separadas. Usted administra cada plataforma de forma independiente. **Migración de perfiles**: al migrar a Partner Central 3.0 con perfiles de vendedor de AWS Marketplace vinculados: + Sus soluciones de Partner Central 2.0 se migran a AWS Marketplace + Las soluciones se administran únicamente a través de AWS Marketplace. + Las API de Partner Central pueden acceder a las soluciones migradas **nota** Si ya ha vinculado sus cuentas de AWS Partner Central y de AWS (consulte [Vincular las cuentas de AWS Partner Central y AWS](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html)), no necesita crear una nueva cuenta de AWS. Sin embargo, compruebe que su cuenta de AWS actual esté registrada como vendedor de AWS Marketplace. Para que su solución esté disponible públicamente en el sitio web de compradores de AWS Marketplace, necesita un perfil público como vendedor de AWS Marketplace. Para ver las instrucciones de registro de vendedores en AWS Marketplace, consulte [Registrar y crear su perfil de vendedor](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html). ### Poner a disposición de las API de Partner Central las soluciones preexistentes de AWS Marketplace Las API de Partner Central no reconocen automáticamente las soluciones de AWS Marketplace que creó antes de la migración del perfil de Partner Central 3.0. Esto se aplica incluso después de completar la migración y vincular su cuenta de AWS a una cuenta de Partner Central. Para que las API de Partner Central puedan ver una solución previa a la migración existente, actualice cualquier campo de la solución. Puede introducir la misma información que aparece actualmente. Repita este proceso para cada solución que haya creado antes de la migración del perfil de Partner Central 3.0. Por ejemplo, utilice el tipo de `UpdateInformation` cambio para actualizar el nombre de una solución con su valor actual. Después de actualizar una solución una vez, las API de Partner Central reconocerán automáticamente cualquier actualización futura de esa solución. ## Entidad de solución Una solución es un documento de marketing que ayuda a los compradores a descubrir y entender tus ofertas. Las soluciones contienen un título, una descripción, casos de uso, productos de AWS Marketplace y productos que no son de AWS Marketplace. La solución es un tipo de entidad independiente del producto, la oferta y los conjuntos de ofertas. Cada solución tiene su propia experiencia de descubrimiento y publicación, que los compradores pueden consultar por separado de los productos individuales. **Características clave** + Agrupe varios productos, incluidos los productos de AWS Marketplace y los que no son de AWS Marketplace. + Cree una experiencia exclusiva de descubrimiento y publicación de anuncios para los compradores. + Agrupa los productos de tu propiedad con productos de otros vendedores. El tipo de entidad de la solución es`Solution@1.0`. **Identificadores de entidad** Las soluciones utilizan el formato de `soln-*` identificador (por ejemplo,`soln-abc123def456`). **Formato ARN de entidad** Las soluciones siguen el formato estándar de AWS ARN: ``` arn:{aws-partition}:aws-marketplace:{region}:{account-id}:{aws-marketplace-catalog}/Solution/{solution-id} ``` Ejemplo: ``` arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123def456 ``` ## Cómo empezar con las soluciones En esta sección se proporciona información detallada sobre la creación y la administración de soluciones mediante los [tipos de cambios](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_Change.html) de la API de AWS Marketplace catálogo. Antes de empezar, asegúrese de que tiene lo siguiente: + Registro de vendedor de AWS Marketplace válido y perfil público. Para obtener más información, consulte [Registrar y crear su perfil de vendedor](https://docs.aws.amazon.com/marketplace/latest/userguide/create-public-profile.html). + Acceso a la API y requisitos previos cumplidos como vendedor. Para obtener más información, consulte [Control de acceso para la API del catálogo de AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html). + Si conoce los conceptos básicos del uso de la API de AWS Marketplace Catalog, consulte [Uso de la API de AWS Marketplace Catalog](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html). ## Enumere sus soluciones Para ver todas las soluciones de su cuenta, llame a la operación de `ListEntities` API y `EntityType` establézcala en Solución. **Solicitud** ``` POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "Solution" } ``` **Respuesta** ``` { "EntitySummaryList": [ { "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456", "EntityId": "soln-abc123456", "EntityType": "Solution", "LastModifiedDate": "2024-10-10T19:50:43Z", "Name": "Test Solution 1", "Visibility": "Limited" } ], "NextToken": null } ``` ### Filtre las soluciones por visibilidad Puede filtrar las soluciones por visibilidad mediante el `FilterList` parámetro. **Solicitud** ``` POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "Solution", "FilterList": [ { "Name": "Visibility", "ValueList": [ "Public" ] } ] } ``` ## Obtenga los detalles de la solución Para obtener información detallada sobre una solución específica, llame a la operación de la `DescribeEntity` API. **nota** La DescribeEntity respuesta devuelve un `EntityIdentifier` que combina un `EntityId` con un `RevisionId.` Para soluciones, `EntityId` es el identificador de la solución y se `RevisionId` puede utilizar para un bloqueo optimista. Para obtener más información, consulte [Identificadores.](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#identifier) **Solicitud** ``` GET /DescribeEntity?catalog=AWSMarketplace&entityId=soln-abc123456 HTTP/1.1 ``` **Respuesta** ``` { "Details": "{...}", "DetailsDocument": { "Lifecycle": { "Visibility": "Limited" }, "Identifiers": { "Id": "soln-abc123456" }, "Presentation": { "Title": "My Solution", "Name": "solution_for_customer_X", "ShortDescription": "Solution value proposition", "LongDescription": "Detailed solution description", "LogoUrl": "https://s3.amazonaws.com/logo.jpg", "UseCases": [ { "Group": "advertising_and_marketing", "SubGroup": "ad_intelligence_and_measurement", "Item": "amazon_ads_insights", "Description": "Use case description" } ] }, "RelatedProducts": { "AwsMarketplaceProducts": [ { "ProductId": "prod-123" } ], "IntegrationDescription": "How products work together", "NonAwsMarketplaceProducts": [ { "Type": "Hardware", "Title": "A hardware product", "Url": "https://example.com", "Description": "My hardware product description" } ] }, "BuyerEngagement": [ { "EngagementOption": "RequestPrivateOffer" } ] }, "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-abc123456", "EntityIdentifier": "soln-abc123456@12", "EntityType": "Solution@1.0", "LastModifiedDate": "2025-04-22T01:02:48Z" } ``` ## Enumere el historial de cambios de una solución Para ver el historial de cambios de una solución específica, llama a la operación de la `ListChangeSets` API con un filtro de entidades. **Sintaxis de la solicitud** ``` POST /ListChangeSets HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "FilterList": [ { "Name": "EntityId", "ValueList": [ "soln-abc123456" ] } ] } ``` ## Etiquete las soluciones y los conjuntos de cambios Puede añadir etiquetas a las soluciones y los conjuntos de cambios durante la creación o actualizarlos más adelante. **Etiquete durante la creación** `EntityTags`Solo puede añadir `CreateSolution` cambios al tipo de cambio, no a otros tipos de cambio de solución. Puede añadirlo `ChangeSetTags` a cualquier `StartChangeSet` carga útil. ``` POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "CreateSolution", "Entity": { "Type": "Solution@1.0" }, "DetailsDocument": { "Name": "Test solution resource name" }, "EntityTags": [ { "Key": "Team", "Value": "Solutions" } ] } ], "ChangeSetTags": [ { "Key": "Environment", "Value": "Production" } ] } ``` **Administra las etiquetas de los recursos existentes** Utilice las operaciones `TagResource` y las de la `UntagResource` API para gestionar las etiquetas de las soluciones y los conjuntos de cambios existentes. Se utiliza `ListTagsForResource` para ver las etiquetas actuales. Para obtener más información, consulte [Administrar etiquetas en los recursos](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#managing-tags-on-resources) y [Añadir etiquetas a una entidad y un conjunto de cambios durante la creación](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html#example-adding-tags-entity-creation). ## Crear una solución Puede usar el tipo de `CreateSolution` cambio para crear un nuevo documento de solución con solo un identificador y un nombre de la solución. Los demás valores aún no están rellenados. Cuando su solicitud se procese correctamente, AWS Marketplace creará una solución de `Draft` estado para usted. Los compradores de AWS Marketplace no pueden ver esta solución incompleta. A continuación, utiliza otros tipos de cambios para completar la solución: `UpdateInformation``UpdateRelatedProducts`,, `UpdateBuyerEngagementOptions` (opcional para crear una `Limited` solución) y`ReleaseSolution`. El tipo de `ReleaseSolution` cambio valida que todos los campos obligatorios necesarios para una `Limited` solución estén presentes en la solución y, a continuación, los mueve a la `Limited` visibilidad. **nota** Para pasar una solución al estado Público o cambiar el estado de una solución, utilice el tipo de `UpdateVisibility` cambio después de proporcionar los valores necesarios. **Sintaxis de la solicitud** ``` POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "CreateSolution", "Entity": { "Type": "Solution@1.0" }, "ChangeName": "CreateSolutionChange", "DetailsDocument": { "Name": "solution_for_customerX_en", "Title": "New Partner Solution" } } ] } ``` Proporcione información sobre los campos para añadir el tipo de `CreateSolution` cambio: + `Entity`(objeto) (obligatorio): el tipo con nombre de la entidad de solución que se está creando. + `Type`(cadena) (obligatorio): `Type` debe ser`Solution@1.0`. + `DetailsDocument`(objeto) (obligatorio): detalles de la solicitud. + `Name`(cadena) (obligatorio): nombre del recurso de AWS solo como referencia del vendedor (los compradores no pueden verlo). Longitud máxima: 100 caracteres. No debe contener espacios en blanco, saltos de línea ni caracteres de control al principio o al final. También puede actualizar el mosaico de la solución mediante el tipo de cambio. `UpdateInformation` + `Title`(cadena) (opcional): el título de la solución. Longitud máxima: 255 caracteres. No debe contener espacios en blanco, saltos de línea ni caracteres de control al principio o al final. También puede configurar o actualizar el título de la solución mediante el tipo de cambio. `UpdateInformation` **Sintaxis de respuesta** Se crea un conjunto de cambios para su solicitud. La respuesta le da las `ChangeSetArn` siguientes `ChangeSetId` ventajas: ``` { "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" } ``` La solicitud de cambio se añade a una cola y se procesa. Puede comprobar el estado mediante el portal de administración de AWS Marketplace o la operación de la `DescribeChangeSet` API. Cuando la solicitud se completa correctamente (si `Status` es así`SUCCEEDED`), se genera un nuevo ID de solución. **Errores asíncronos** `CreateSolution`las acciones devuelven errores específicos, además de los errores asíncronos [comunes](#solution-error-codes). Estos errores se reciben cuando un conjunto de `DescribeChangeSet` cambios termina de procesarse. Para obtener información sobre cómo obtener el estado de una solicitud de cambio, consulte [Trabajar con conjuntos de cambios](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). | Código de error | Mensaje de error | | --- | --- | | NOMBRE\_VÁLIDO | La longitud del nombre de la solución no es válida. Introduzca un nombre de entre 1 y 100 caracteres e inténtelo de nuevo. | | NOMBRE\_FALTA | Se requiere un valor de nombre. Especifique un valor de nombre e inténtelo de nuevo. | | TÍTULO\_INVÁLIDO | La longitud del título de la solución no es válida. Introduzca un título de entre 1 y 255 caracteres e inténtelo de nuevo. | ## Actualice la información de la solución Si ya tiene una solución en AWS Marketplace, puede usar la API del catálogo para actualizar la información de la solución. Para actualizar la información de la solución, llame a la operación de la `StartChangeSet` API con el tipo de `UpdateInformation` cambio y los detalles actualizados. Consulte el siguiente ejemplo. **nota** Los tipos de `UpdateInformation` cambios se comportan como operaciones HTTP PATCH para los atributos de nivel superior. Cómo se actualizan los campos: Si hay un atributo de nivel superior en el`DetailsDocument`, el flujo de trabajo valida la entrada y sobrescribe los valores existentes. Si un campo de nivel superior no está presente en el`DetailsDocument`, se conserva el valor existente. Para anular la configuración de un campo opcional, envía un JSON explícito `null` para ese campo. AWS Marketplace verifica e incorpora el logotipo y los recursos multimedia promocionales en una ubicación de AWS Marketplace-owned . DescribeEntity devuelve una URL accesible para los archivos ingeridos, no su entrada original. StartChangeSet Para ver las URL enviadas originalmente, usa la DescribeChangeSet API. **nota** Al modificar los archivos de `PromotionalMedia` activos (proporcionando nuevas URL) en una `Public` solución, es `UpdateInformation` necesario que el equipo de operaciones de vendedores de AWS Marketplace los revise manualmente. Esto aumenta el tiempo de ejecución. En este escenario, utilícelo `UpdateInformation` por separado en su propio conjunto de cambios. **Sintaxis de la solicitud** ``` POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "UpdateInformation", "Entity": { "Identifier": "soln-1234abcd", "Type": "Solution@1.0" }, "DetailsDocument": { "Name": "project_cold_harbor", "Title": "My Awesome Solution", "ShortDescription": "Solution value proposition", "LongDescription": "Detailed solution description explaining how this addresses customer needs", "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/logo.jpg", "PromotionalMedia": [ { "Type": "Image", "Url": "https://s3.amazonaws.com/awsmp-media/image.jpg", "Title": "Sample image", "Description": "Sample image description" }, { "Type": "Video", "Url": "https://s3.amazonaws.com/awsmp-media/video.mp4", "Title": "Sample video", "PreviewUrl": "https://s3.amazonaws.com/awsmp-media/preview.png", "Description": "Sample video description" } ], "AdditionalResources": [ { "Text": "Troubleshooting guide", "Url": "https://example.com/troubleshooting" } ], "UseCases": [ { "Group": "advertising_and_marketing", "SubGroup": "ad_intelligence_and_measurement", "Item": "amazon_ads_insights", "Description": "Highlight description of this use case" } ] } } ] } ``` Proporcione información sobre los campos para añadir el tipo de `UpdateInformation` cambio: + `Entity`(objeto) (obligatorio): el tipo de entidad nombrado que se está actualizando. + `Identifier`(cadena) (obligatorio): el ID de la solución. + `Type`(cadena) (obligatorio): debe serlo`Solution@1.0`. + `DetailsDocument`(objeto) (obligatorio): los detalles de la solicitud, incluida la información que desea actualizar para su solución. Cada campo es opcional, pero debe incluir al menos un cambio para actualizarlo. + `Name`(cadena): el nombre del recurso de la solución, visible solo para el vendedor mediante las operaciones de lectura de la API del catálogo, no visible para los compradores. Longitud máxima: 100 caracteres. No debe contener espacios en blanco, saltos de línea ni caracteres de control al principio o al final. + `Title`(cadena): el título de la solución que se mostrará a los compradores. Longitud máxima: 255 caracteres. No debe contener espacios en blanco, saltos de línea ni caracteres de control al principio o al final. + `ShortDescription`(cadena): la descripción de la propuesta de valor de los aspectos clave de la solución que se mostrará a los compradores. Suele ser de 2 a 3 oraciones. Longitud máxima: 1000 caracteres. No debe contener espacios en blanco ni caracteres de control al principio o al final. + `LongDescription`(cadena): la descripción más larga de esta solución que se mostrará a los compradores. Suele ser de 1 a 3 párrafos. Longitud máxima: 5000 caracteres. No debe contener espacios en blanco ni caracteres de control al principio o al final. + `LogoUrl`(string): la URL de una imagen de un bucket de Amazon S3 de acceso público o una URL de S3 prefirmada. Debe ser una URL de S3 directa (no posterior CloudFront ni API Gateway). Longitud máxima: 2048 caracteres. Para conocer las especificaciones del logotipo, consulte los [requisitos para los logotipos de la empresa y del producto](https://docs.aws.amazon.com/marketplace/latest/userguide/product-submission.html#seller-and-product-logos). + `PromotionalMedia`(conjunto de objetos): lista de imágenes y vídeos promocionales. Máximo 15 artículos (5 vídeos y 10 imágenes). Para ver las especificaciones de los medios promocionales, consulte [Mejore su producto de AWS Marketplace con medios promocionales](https://docs.aws.amazon.com/marketplace/latest/userguide/promotional-media.html). + `Type`(cadena) (obligatorio): `Image` o bien`Video`. + `Url`(cadena) (obligatorio): la URL del archivo multimedia. Debe ser una URL de S3 directa o una URL de S3 prefirmada. Longitud máxima: 2048 caracteres. Debe ser una URL https. + `Title`(cadena) (obligatorio): el título del contenido multimedia. Longitud máxima: 100 caracteres. No debe contener espacios en blanco, saltos de línea ni caracteres de control al principio o al final. + `Description`(cadena) (obligatorio): descripción del contenido multimedia. Longitud máxima: 200 caracteres. No debe contener espacios en blanco ni caracteres de control al principio o al final. + `PreviewUrl`(cadena) (opcional): solo en el caso de los vídeos, la URL de la imagen de vista previa. Longitud máxima: 2048 caracteres. Debe ser una URL https. + `AdditionalResources`(conjunto de objetos): la lista de referencias a recursos adicionales. Máximo 8 artículos. + `Text`(cadena): el nombre o el título del recurso. Longitud máxima: 500 caracteres. No debe contener espacios en blanco, saltos de línea ni caracteres de control al principio o al final. + `Url`(cadena): la URL del recurso. Longitud máxima: 2048 caracteres. Debe ser una URL https. + `UseCases`(conjunto de objetos): la lista de casos de uso que aborda esta solución. Máximo 3 elementos. Para ver las categorías de casos de uso válidas (una combinación de grupo y elemento) SubGroup, consulte la [lista de categorías de casos de uso](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json) para ver los valores aceptados activos y sus [etiquetas de introducción](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/i18n/en.json). La combinación de Grupo e Item debe ser un elemento válido en la lista de categorías de casos de uso. SubGroup + `Group`(cadena): categoría industrial o tecnológica. Debe ser uno de los valores de grupo de la [lista de categorías de casos de uso](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json). + `SubGroup`(cadena): utilice un grupo de casos dentro de la categoría. Debe ser uno de los SubGroup valores de la [lista de categorías de casos de uso](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json). + `Item`(cadena): caso de uso específico. Debe ser uno de los valores de los elementos de la [lista de categorías de casos de uso](https://d1z4dgsxp8pfa2.cloudfront.net/awsmp-solutions/use-case-categories-list.json). + `Description`(cadena): descripción de cómo esta solución aborda el caso de uso. Longitud máxima: 500 caracteres. No debe contener espacios en blanco ni caracteres de control al principio o al final. Para obtener información sobre las URL prefirmadas, consulte [Compartir objetos con](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html) direcciones URL prefirmadas. **nota** Al solicitar el tipo de UpdateInformation cambio, siempre puedes proporcionar un subconjunto de campos para que se actualicen en el objeto. `DetailsDocument` Sin embargo, antes de mover una solución de `Draft` a`Limited`, se deben configurar correctamente los siguientes campos:`Title`, `ShortDescription``LongDescription`, y`LogoUrl`. Sin embargo, al actualizar los campos existentes en la solución, solo puede incluir los atributos que deben cambiarse en el `DetailsDocument` objeto del tipo de `UpdateInformation` cambio. **Sintaxis de respuesta** Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información `ChangeSetId` necesaria `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto. ``` { "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" } ``` La solicitud de cambio se agrega a una cola y se procesa. Para comprobar el estado de la solicitud, utilice el portal de administración de AWS Marketplace o llame a la `DescribeChangeSet` API. Tras activar este tipo de cambio con `PromotionalMedia` los activos modificados para una `Public` solución, puede tardar hasta 37 días en completarse. Esto incluye el tiempo que el equipo de operaciones de vendedores de AWS Marketplace necesita para revisar, auditar y aprobar. **Errores asíncronos** Además de los errores [asincrónicos habituales, los siguientes errores](#solution-error-codes) son específicos de las `UpdateInformation` acciones de la API del catálogo de AWS Marketplace. Estos errores se devuelven cuando 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). | Código de error | Mensaje de error | | --- | --- | | DESCRIPCIÓN\_CORTA NO VÁLIDA | La longitud de la solución ShortDescription no es válida. Introduzca un valor ShortDescription de entre 1 y 1000 caracteres e inténtelo de nuevo. | | DESCRIPCIÓN LARGA NO VÁLIDA | La longitud de la solución LongDescription no es válida. Introduzca un LongDescription que tenga entre 1 y 5000 caracteres e inténtelo de nuevo. | | NOMBRE\_INVÁLIDO | La longitud del nombre de la solución no es válida. Introduzca un nombre de entre 1 y 100 caracteres e inténtelo de nuevo. | | TÍTULO\_INVÁLIDO | La longitud del título de la solución no es válida. Introduzca un título de entre 1 y 255 caracteres e inténtelo de nuevo. | | RECURSOS\_ADICIONALES\_INVÁLIDOS | La solución AdditionalResources [%d]. La longitud del texto no es válida. Introduzca un texto de entre 1 y 500 caracteres e inténtelo de nuevo. | | RECURSOS\_ADICIONALES\_INVÁLIDOS | No se puede acceder a las siguientes direcciones URL de los recursos adicionales proporcionados: [%s]. Proporcione direcciones URL válidas y accesibles | | RECURSOS\_ADICIONALES\_INVÁLIDOS | Se requiere un valor de URL. Especifique un valor de URL e inténtelo de nuevo. | | RECURSOS\_ADICIONALES\_INVÁLIDOS | No puede faltar texto. Proporcione un texto | | CASO\_DE\_USO INVÁLIDO | La solución UseCases [%d]. La longitud de la descripción no es válida. Introduzca una descripción de entre 1 y 500 caracteres e inténtelo de nuevo. | | CASO\_DE\_USO INVÁLIDO | UseCases[%d] .Grupo: el grupo proporcionado (%s) no es válido. Proporcione un grupo válido. | | INVALID\_USE\_CASE | UseCases[%d]. SubGroup: El grupo proporcionado (%s) no es válido. Proporcione un valor válido SubGroup. | | INVALID\_USE\_CASE | UseCases[%d] .Artículo: el artículo proporcionado (%s) no es válido. Proporcione un artículo válido. | | INVALID\_USE\_CASE | UseCases[%d] .Elemento: el caso de uso proporcionado está inactivo. Proporcione un caso de uso activo | | CASO\_DE\_USO INVÁLIDO | UseCases[%d] .Grupo: no puede faltar el grupo. Proporcione un grupo. | | CASO\_DE\_USO NO VÁLIDO | UseCases[%d]. SubGroup: SubGroup no puede faltar. Proporcione un SubGroup. | | CASO DE USO NO VÁLIDO | UseCases[%d] .Artículo: no puede faltar. SubGroup Proporcione un artículo. | | INVALID\_MEDIA | La solución PromotionalMedia [%d]. La longitud del título no es válida. Introduce un título que tenga entre 1 y 100 caracteres e inténtalo de nuevo. | | INVÁLID\_MEDIA | La solución PromotionalMedia [%d]. La longitud de la descripción no es válida. Introduzca una descripción de entre 1 y 200 caracteres e inténtelo de nuevo. | | INVÁLID\_MEDIA | URL no válida: %s Proporcione una nueva URL para el contenido multimedia almacenado en S3. | | INVALID\_MEDIA | No se puede acceder a la ubicación del medio: %s Proporcione una URL nueva y accesible para el contenido multimedia almacenado en una de las siguientes ubicaciones: [S3]. | | MEDIO NO VÁLIDO | El tamaño de la imagen supera %s. Proporcione una imagen inferior a %s. | | INVALID\_MEDIA | El tamaño del vídeo supera %s. Proporcione un vídeo inferior a %s. | | INVÁLID\_MEDIA | El tamaño del logotipo supera %s. Proporcione un logotipo inferior a %s. | | MEDIA\_INVALID\_MEDIA | Se ha detectado malware en %s. Proporcione contenido multimedia sin malware. | | INVALID\_MEDIA | Contenido inapropiado: se detectó %s. Proporcione contenido multimedia sin contenido inapropiado | | INVALID\_MEDIA | Se detectó contenido explícito en %s: '{ExplicitContent}'. Proporcione contenido multimedia sin contenido explícito. | | INVALID\_MEDIA | PromotionalMedia[%s] .Url: %s no está en un formato compatible (%s). Utilice una imagen bien formada en un formato compatible: [JPEG, PNG]. | | MEDIO\_INVÁLIDO | PromotionalMedia[%s] .Url: %s no está en un formato compatible (%s). Utilice un vídeo bien formado en un formato compatible: [MP4, MOV]. | | MEDIO\_INVÁLIDO | LogoUrl en %s tiene una relación de aspecto no válida. Proporcione una imagen con una relación de aspecto de 1:1 (cuadrada) o 2:1 (ancha). | | MEDIO NO VÁLIDO | Logotipo: %s tiene dimensiones no válidas. Proporcione una imagen de entre 120 x 120 y 1080 x 1080 píxeles. | | INVALID\_MEDIA | PromotionalMedia[%d]. No se admite el tipo. Introduce PromotionalMedia un tipo compatible: %s | | DUPLICATE\_MEDIA | Se ha detectado un contenido multimedia duplicado: [%s] Proporcione los elementos multimedia sin duplicados. | | MEDIO\_INVÁLIDO | PromotionalMedia[%d] .Url: se ha detectado un malware en %s. Proporcione contenido multimedia sin malware. | | DEMASIADOS ARTÍCULOS | No proporcione más de %d %s. | ## Actualiza los productos relacionados Puede usar la API del catálogo para actualizar los productos y servicios incluidos en su solución, incluidos los productos de AWS Marketplace y los productos que no son de AWS Marketplace. Para actualizar los productos relacionados, llame a la operación de la `StartChangeSet` API con el tipo de `UpdateRelatedProducts` cambio, como se muestra en el siguiente ejemplo. **nota** El tipo de `UpdateRelatedProducts` cambio se comporta como una operación HTTP PATCH para los atributos de nivel superior. Puede proporcionar todos los tipos de productos actuales de AWS Marketplace como `AwsMarketplaceProducts` en`UpdateRelatedProducts`. **Sintaxis de la solicitud** ``` POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "UpdateRelatedProducts", "Entity": { "Type": "Solution@1.0", "Identifier": "soln-123456" }, "DetailsDocument": { "IntegrationDescription": "How to use the products in this solution (usage guide)", "AwsMarketplaceProducts": [ { "ProductId": "prod-123" }, { "ProductId": "prod-456" } ], "NonAwsMarketplaceProducts": [ { "Type": "Hardware", "Title": "Diamond engine", "Description": "Hardware details", "Url": "https://example.com/hardware-product-specs.html" } ] } } ] } ``` Proporcione información sobre los campos para añadir el tipo de `UpdateRelatedProducts` cambio: + `Entity`(objeto) (obligatorio): el tipo de entidad nombrado que se está actualizando. + `Identifier`(cadena) (obligatorio): el ID de la solución. + `Type`(cadena) (obligatorio): debe serlo`Solution@1.0`. + `DetailsDocument`(objeto) (obligatorio): detalles de la solicitud. Cada campo es opcional, pero debe incluir al menos un cambio para actualizarlo. + `IntegrationDescription`(cadena): descripción de cómo funcionan juntos los productos en esta solución. Longitud máxima: 5000 caracteres. No debe contener espacios en blanco ni caracteres de control al principio o al final. + `AwsMarketplaceProducts`(conjunto de objetos): productos de AWS Marketplace incluidos en esta solución. Máximo 5 artículos + `ProductId`(cadena): ID de producto de AWS Marketplace (un UUID o una cadena que comienza por`prod-`). Longitud máxima: 50 caracteres. + `NonAwsMarketplaceProducts`(conjunto de objetos): los productos no están disponibles en AWS Marketplace. Máximo 5 artículos. + `Type`(cadena) (obligatorio): tipo de producto. Valores posibles: `Software``Consulting`,`Hardware`,`Communication`,`Professional Service`,`Managed Service`,`Value-Added Resale`, `Training` + `Title`(cadena) (obligatorio): título del producto. Longitud máxima: 255 caracteres. No debe contener espacios en blanco, saltos de línea ni caracteres de control al principio o al final. + `Description`(cadena) (opcional): descripción del producto. Longitud máxima: 220 caracteres. No debe contener espacios en blanco ni caracteres de control al principio o al final. + `Url`(cadena) (opcional): URL para obtener más información sobre el producto. Longitud máxima: 2048 caracteres. Debe ser una URL https. **Sintaxis de respuesta** Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información `ChangeSetId` necesaria `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto. ``` { "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" } ``` La solicitud de cambio se agrega a una cola y se procesa. Para comprobar el estado de la solicitud, utilice el portal de administración de AWS Marketplace o llame a la `DescribeChangeSet` API. **Errores asíncronos** Además de los errores [asincrónicos habituales, los siguientes errores](#solution-error-codes) son específicos de las `UpdateRelatedProducts` acciones de la API del catálogo de AWS Marketplace. Estos errores se devuelven cuando 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). | Código de error | Mensaje de error | | --- | --- | | INCOMPATIBLE\_OPERATION\_UPDATE\_RELATED\_PRODUCTS\_SOLUTION | Las soluciones públicas no admiten la operación de actualización de productos relacionados. Para realizar este cambio, primero cambie la visibilidad de la solución a limitada e inténtelo de nuevo. | | NO VÁLIDO\_ AWS\_MARKETPLACE\_PRODUCTS | El producto '%s' de AWS Marketplace no está disponible para su cuenta. Elija un producto público o un producto limitado en el que tenga acceso a la lista de productos permitidos, o póngase en contacto con el vendedor para solicitar el acceso. | | INVÁLIDO\_ AWS\_MARKETPLACE\_PRODUCTS | El tipo de producto especificado '%s' no es compatible. Introduce uno de estos tipos de producto válidos: [AmiProduct, SaasProduct,,, ContainerProduct MachineLearningProduct ProfessionalServicesProduct, DataProduct] e inténtalo de nuevo. | | NO VÁLIDO\_ AWS\_MARKETPLACE\_PRODUCTS | No se encontró el producto %s. Proporcione un identificador de producto válido en el mismo catálogo. | | NO VÁLIDO\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | No se puede acceder a las URL de los productos de Non-AWS Marketplace especificadas: [%s]. Comprueba que las direcciones URL son válidas y de acceso público e inténtalo de nuevo. | | DESCRIPCIÓN\_DE INTEGRACIÓN NO VÁLIDA | Proporcione una solución IntegrationDescription de entre 1 y 5000 caracteres. | | NO VÁLIDO\_NO\_ AWS\_MARKETPLACE\_PRODUCTS | La solución NonAwsMarketplaceProduct [%d]. La longitud del título no es válida. Introduzca una descripción que tenga entre 1 y 255 caracteres e inténtelo de nuevo. | | NO VÁLIDO\_NO\_ AWS\_MARKETPLACE\_PRODUCTS | La solución NonAwsMarketplaceProduct [%d]. La longitud de la descripción no es válida. Introduzca una descripción de entre 1 y 220 caracteres e inténtelo de nuevo. | | NO VÁLIDO\_NO\_ AWS\_MARKETPLACE\_PRODUCTS | La solución NonAwsMarketplaceProduct [%d]. La longitud del tipo no es válida. Introduzca un tipo que tenga entre 1 y 50 caracteres e inténtelo de nuevo. | | NO VÁLIDO\_NO\_ AWS\_MARKETPLACE\_PRODUCTS | NonAwsMarketplaceProduct[%d] .Type no es un tipo de producto válido que no sea de AWS Marketplace. Proporcione uno de los siguientes tipos de productos que no sean de AWS Marketplace: [%s] | | NO VÁLIDO\_NO\_ AWS\_MARKETPLACE\_PRODUCTS | Se requiere un NonAwsMarketplaceProduct [%d]. El valor del título es obligatorio. Especifique un valor de título e inténtelo de nuevo. | | NO VÁLIDO\_NON\_ AWS\_MARKETPLACE\_PRODUCTS | Se requiere un NonAwsMarketplaceProduct valor de [%d] .Type. Especifique un valor de tipo e inténtelo de nuevo. | | DEMASIADOS PRODUCTOS | El número máximo de productos de AWS Marketplace que puede vincular es %d. Elimine los productos enlazados existentes antes de añadir otros nuevos. | | MUCHOS\_PRODUCTOS | El número máximo de productos de AWS Marketplace que no puede añadir es %d. Elimine los productos de AWS Marketplace que no existan antes de añadir otros nuevos. | | INVÁLIDO\_ AWS\_MARKETPLACE\_PRODUCTS | No se permiten los ID de producto de AWS Marketplace duplicados. Cada identificador de producto debe ser único en su solución. | | OPERACIÓN DE ELIMINACIÓN NO VÁLIDA | Operación no válida, no puedes eliminar todos los productos. | ## Publica una solución Puede usar la API de catálogo para publicar una `Draft` solución con `Limited` visibilidad en AWS Marketplace. El tipo de `ReleaseSolution` cambio valida que estén presentes todos los campos obligatorios de una `Limited` solución. A continuación, mueve la solución de `Draft` a la `Limited` visibilidad. Una vez que una solución está `Limited` visible, no se puede volver a `Draft` mostrar. Para lanzar una solución, llame a la operación de `StartChangeSet` API con el tipo de `ReleaseSolution` cambio, como se muestra en el siguiente ejemplo. **Sintaxis de la solicitud** ``` POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "ReleaseSolution", "Entity": { "Type": "Solution@1.0", "Identifier": "soln-1234abcd" }, "DetailsDocument": {} } ] } ``` Proporcione información sobre los campos para añadir el tipo de `ReleaseSolution` cambio: + `Entity`(objeto) (obligatorio): el tipo de entidad nombrado que se va a liberar. + `Identifier`(cadena) (obligatorio): el ID de la solución. + `Type`(cadena) (obligatorio): debe serlo`Solution@1.0`. + `DetailsDocument`(objeto) (obligatorio): debe ser un objeto vacío. El tipo de cambio `ReleaseSolution` no acepta ningún detalle. **Sintaxis de respuesta** Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información `ChangeSetId` necesaria `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto. ``` { "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" } ``` La solicitud de cambio se agrega a una cola y se procesa. Puede comprobar el estado de la solicitud a través del portal de administración de AWS Marketplace o directamente a través de la API del catálogo mediante la operación de la `DescribeChangeSet` API. **Errores asíncronos** Además de los errores [asincrónicos habituales, los siguientes errores](#solution-error-codes) son específicos de las `ReleaseSolution` acciones de la API del catálogo de AWS Marketplace. Estos errores se devuelven cuando 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). | Código de error | Mensaje de error | | --- | --- | | CAMPOS OBLIGATORIOS FALTANTES | Faltan los parámetros necesarios en la solicitud: [%s]. Especifique los valores para todos los parámetros necesarios e inténtelo de nuevo. | | INCOMPATIBLE\_OPERATION\_RELEASE\_SOLUTION | El tipo de cambio solo se puede invocar en el estado Soluciones en borrador. Actualice la visibilidad de la solución a Borrador e inténtelo de nuevo. | ## Actualiza las opciones de interacción con los compradores Puedes usar la API del catálogo para configurar la forma en que los compradores se comunican contigo en relación con tu solución. **nota** Para utilizar este tipo de cambio, debe estar inscrito activamente en el programa [Customer Engagements (ACE) de APN](https://aws.amazon.com/partners/programs/ace/). También debe vincular su cuenta de AWS con su cuenta de AWS Partner Central que esté inscrita en ACE. Para obtener instrucciones, consulte Cómo [vincular las cuentas de AWS Partner Central y AWS](https://docs.aws.amazon.com/partner-central/latest/getting-started/account-linking.html). Para actualizar las opciones de participación de los compradores, llame a la operación de la `StartChangeSet` API con el tipo de `UpdateBuyerEngagementOptions` cambio, como se muestra en el siguiente ejemplo. **Sintaxis de la solicitud** ``` POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "UpdateBuyerEngagementOptions", "Entity": { "Type": "Solution@1.0", "Identifier": "soln-1234abcd" }, "DetailsDocument": [ { "EngagementOption": "RequestProductDemo" }, { "EngagementOption": "RequestPrivateOffer" } ] } ] } ``` Proporciona información sobre los campos para añadir el tipo de `UpdateBuyerEngagementOptions` cambio: + `Entity`(objeto) (obligatorio): el tipo de entidad nombrado que se está actualizando. + `Identifier`(cadena) (obligatorio): el ID de la solución. + `Type`(cadena) (obligatorio): debe serlo`Solution@1.0`. + `DetailsDocument`(conjunto de objetos) (obligatorio): las opciones de captación de compradores que se deben activar. + `EngagementOption`(cadena) (obligatorio): el tipo de opción de contratación. Valores válidos: `RequestPrivateOffer`, `RequestProductDemo`. **Sintaxis de respuesta** Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información `ChangeSetId` necesaria `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto. ``` { "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" } ``` La solicitud de cambio se agrega a una cola y se procesa. Para comprobar el estado de la solicitud, utilice el portal de administración de AWS Marketplace o llame a la `DescribeChangeSet` API. **Errores asíncronos** Además de los errores [asincrónicos habituales, los siguientes errores](#solution-error-codes) son específicos de las `UpdateBuyerEngagementOptions` acciones de la API del catálogo de AWS Marketplace. Estos errores se devuelven cuando 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). | Código de error | Mensaje de error | | --- | --- | | VENDEDOR\_INELEGIBLE | La validación de aptitud para la ACE no está completa. Para continuar: 1) Vincula tu cuenta de AWS Marketplace a tu cuenta de APN, 2) Completa los requisitos de aptitud para el ACE. | ## Actualice la visibilidad de la solución Puede usar la API de catálogo para actualizar la visibilidad de una solución en AWS Marketplace. Puede establecer las visibilidades objetivo en `Limited``Public`, o`Restricted`. + **`Limited`**— La solución está completa y ha completado correctamente el tipo de `ReleaseSolution` cambio. Puedes obtener una vista previa de los detalles de la solución en el sitio web del comprador en esta visibilidad. En el sitio web para compradores de AWS Marketplace, solo pueden ver la solución la cuenta propietaria, los propietarios de cada producto de AWS Marketplace incluido en la solución y el equipo de operaciones de vendedores de AWS Marketplace. + **`Public`**— La solución está visible en AWS Marketplace. Los compradores pueden ver la solución e interactuar con ella. + **`Restricted`**— La solución ya no está visible para el público en el sitio web de compradores de AWS Marketplace. **nota** Para que una solución pase a ser `Public` visible, debe cumplir los siguientes requisitos: Debe tener un perfil público en AWS Marketplace. La solución no debe contener productos que no sean `Public` productos. La solución debe tener al menos 2 productos de `Public` AWS Marketplace. La solución debe tener al menos 1 producto de AWS Marketplace de la misma cuenta de AWS. La solución debe tener habilitada la opción de captación de `RequestPrivateOffer` compradores. El equipo de operaciones para vendedores de AWS Marketplace revisa todas las solicitudes para que una solución pase a `Public` ser visible. Para obtener asistencia, consulte [Obtener asistencia para AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/buyerguide/getting-support.html). Si lo configura `TargetVisibility``Public`, el tipo de `UpdateVisibility` cambio requiere una revisión manual por parte del equipo de operaciones de vendedores de AWS Marketplace. Esto aumenta el tiempo de ejecución. Úselo `UpdateVisibility` por separado en su propio conjunto de cambios. Para actualizar la visibilidad de la solución, llame a la operación de `StartChangeSet` API con el tipo de `UpdateVisibility` cambio, como se muestra en el siguiente ejemplo. **Sintaxis de la solicitud** Para cuándo `TargetVisibility` es `Public` o`Limited`. ``` POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "UpdateVisibility", "Entity": { "Type": "Solution@1.0", "Identifier": "soln-1234abcd" }, "DetailsDocument": { "TargetVisibility": "Public" } } ] } ``` Para cuándo `TargetVisibility` es`Restricted`. ``` POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "UpdateVisibility", "Entity": { "Type": "Solution@1.0", "Identifier": "soln-1234abcd" }, "DetailsDocument": { "TargetVisibility": "Restricted" } } ] } ``` Proporcione información sobre los campos para añadir el tipo de `UpdateVisibility` cambio: + `Entity`(objeto) (obligatorio): el tipo de entidad nombrado que se está actualizando. + `Identifier`(cadena) (obligatorio): el ID de la solución. + `Type`(cadena) (obligatorio): debe serlo`Solution@1.0`. + `DetailsDocument`(objeto) (obligatorio): los detalles necesarios para ejecutar el conjunto de cambios. + `TargetVisibility`(cadena) (obligatorio): la nueva visibilidad prevista de la solución. Valores posibles: `Public`, `Limited` y `Restricted`. **Sintaxis de respuesta** Se crea un conjunto de cambios para su solicitud. La respuesta a esta solicitud proporciona la información `ChangeSetId` necesaria `ChangeSetArn` para el conjunto de cambios y tiene el siguiente aspecto. ``` { "ChangeSetId": "example123456789012abcdef", "ChangeSetArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/example123456789012abcdef" } ``` La solicitud de cambio se agrega a una cola y se procesa. Puede comprobar el estado de la solicitud a través del portal de administración de AWS Marketplace o directamente a través de la API del catálogo mediante la operación de la `DescribeChangeSet` API. Tras activar este tipo de cambio con el signo «`TargetVisibility`as»`Public`, puede tardar hasta 37 días en completarse. Esto incluye el tiempo que el equipo de operaciones de vendedores de AWS Marketplace necesita para revisar, auditar y aprobar. **Errores asíncronos** Los siguientes errores son específicos de las `UpdateVisibility` acciones de la API del catálogo de AWS Marketplace. Estos errores se devuelven cuando 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](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-apis.html#working-with-change-sets). | Código de error | Mensaje de error | | --- | --- | | TRANSICIÓN\_VISIBILIDAD\_INVÁLIDA | La solución no se puede volver al estado de borrador. Una vez publicadas, las soluciones solo pueden transitar entre los estados Limitado, Público y Restringido. | | MUY POCOS CASOS DE USO | Se requiere al menos un caso de uso para hacer pública una solución. Añada un caso de uso e inténtelo de nuevo. | | MUY POCOS PRODUCTOS\_PÚBLICOS | Se requiere un mínimo de 2 productos públicos de AWS Marketplace para hacer pública una solución. Añada los productos necesarios e inténtelo de nuevo. | | PRODUCTOS\_INCOMPATIBLES | La solución contiene uno o más productos de AWS Marketplace no públicos. Para hacer pública la solución, elimine todos los productos que no sean públicos e inténtelo de nuevo. | | MUY POCOS PRODUCTOS DE PROPIEDAD PROPIA | La solución requiere al menos un producto de AWS Marketplace propiedad del propietario de la solución. Añada un producto de AWS Marketplace desde su cuenta e inténtelo de nuevo. | | INCOMPATIBLE\_BUYER\_ENGAGEMENT\_OPTIONS | La opción de participación del RequestPrivateOffer comprador debe estar habilitada para que esta solución sea pública. RequestPrivateOffer Actívala e inténtalo de nuevo. | | INCOMPATIBLE\_OPERATION\_UPDATE\_VISIBILITY | UpdateVisibility no es compatible con las soluciones en estado Borrador. Publique primero la solución de Borrador a Limitada utilizando y ReleaseSolution, a continuación, úsela UpdateVisibility para cambiarla a Pública o Restringida. | | SE HA EXCEDIDO EL LÍMITE DE MUCHÍSIMAS SOLUCIONES PÚBLICAS | Esta cuenta ha alcanzado su límite de 5 soluciones públicas. Actualice una solución pública existente a Visibilidad limitada o restringida e inténtelo de nuevo. | | FALTA LA INFORMACIÓN\_DEL\_PERFIL DEL VENDEDOR | Se requiere un perfil de vendedor público para hacer públicas las soluciones. Crea un perfil público en tu cuenta de vendedor y vuelve a intentarlo. | ## Códigos de error asíncronos comunes Existen algunas validaciones asíncronas que se aplican a todos los tipos de cambios de solución, como la comprobación de la validez de la URL y de los caracteres no admitidos, y sus códigos de error y mensajes de error se muestran aquí. Cada campo de URL proporcionado debe usar el protocolo HTTPS y cumplir con los estándares RFC2396 o RFC 2732. | Código de error | Mensaje de error | | --- | --- | | INVALID\_INPUT | El campo '%s' no es válido. Elimine los caracteres no admitidos %s. | | INVALID\_INPUT | Se encontró contenido inapropiado '%s' en el campo %s. Proporcione a %s ningún contenido inapropiado. | | UNSUPPORTED\_CATALOG | Este tipo de cambio no admite el catálogo solicitado %s. | | OPERACIÓN DE ELIMINACIÓN NO VÁLIDA | Operación no válida, no puedes eliminar %s | | ERROR DE AUDITORÍA | (varía según el resultado de la auditoría del equipo de operaciones de vendedores de AWS Marketplace) | ## Vida útil de la solución Las soluciones progresan a través de los siguientes valores de visibilidad: + `Draft`- Visibilidad inicial tras la creación. Puede añadir información progresivamente mediante otros tipos de cambios. + `Limited`- La solución está completa y tanto usted como los propietarios del producto la pueden ver para obtener una vista previa. Esto se consigue mediante el uso de`ReleaseSolution`. + `Public`- La solución está visible para todos los compradores que naveguen por el sitio web de AWS Marketplace. Esto requiere una validación adicional. + `Restricted`- Los nuevos compradores ya no pueden ver la solución. **importante** Una vez que una solución pasa de `Draft` ser `Limited` visible, no podrás volver a verla`Draft`. `ReleaseSolution`valida que todos los campos obligatorios de una `Limited` solución estén presentes antes de la transición a la `Limited` visibilidad. ### Requisitos mínimos para una solución completa Para crear una solución completa y publicarla después del estado de borrador, necesita los siguientes tipos de cambios y atributos: + **`CreateSolution`**: `Name` + **`UpdateInformation`**: `Title`, `ShortDescription`, `LongDescription`, `LogoUrl` + **`UpdateRelatedProducts`**:`IntegrationDescription`, al menos un elemento de ancho `AwsMarketplaceProducts` y `NonAwsMarketplaceProducts` + **`ReleaseSolution`** El siguiente ejemplo muestra cómo crear una solución completa con `Limited` visibilidad en un único conjunto de cambios: ``` { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "CreateSolution", "Entity": { "Type": "Solution@1.0" }, "ChangeName": "CreateSolutionChange", "DetailsDocument": { "Name": "complete_solution_example", "Title": "Complete Solution Example" } }, { "ChangeType": "UpdateInformation", "Entity": { "Type": "Solution@1.0", "Identifier": "$CreateSolutionChange.Entity.Identifier" }, "ChangeName": "UpdateInformationChange", "DetailsDocument": { "ShortDescription": "A comprehensive solution for customer needs", "LongDescription": "This solution combines multiple products to address specific customer requirements in the advertising and marketing space.", "LogoUrl": "https://s3.amazonaws.com/awsmp-logos/solution-logo.jpg", "UseCases": [ { "Group": "advertising_and_marketing", "SubGroup": "ad_intelligence_and_measurement", "Item": "amazon_ads_insights", "Description": "Provides comprehensive advertising insights and measurement capabilities" } ] } }, { "ChangeType": "UpdateRelatedProducts", "Entity": { "Type": "Solution@1.0", "Identifier": "$CreateSolutionChange.Entity.Identifier" }, "ChangeName": "UpdateRelatedProductsChange", "DetailsDocument": { "AwsMarketplaceProducts": [ { "ProductId": "prod-123" } ], "IntegrationDescription": "These products work together to provide end-to-end advertising analytics and optimization capabilities." } }, { "ChangeType": "UpdateBuyerEngagementOptions", "Entity": { "Type": "Solution@1.0", "Identifier": "$CreateSolutionChange.Entity.Identifier" }, "ChangeName": "UpdateBuyerEngagementChange", "DetailsDocument": [ { "EngagementOption": "RequestPrivateOffer" } ] }, { "ChangeType": "ReleaseSolution", "Entity": { "Type": "Solution@1.0", "Identifier": "$CreateSolutionChange.Entity.Identifier" }, "ChangeName": "ReleaseSolutionChange", "DetailsDocument": {} } ] } ``` ## Permisos de IAM para soluciones La API de AWS Marketplace Catalog utiliza permisos de IAM estándar. Consulte [Control de acceso para la API del catálogo de AWS Marketplace](https://docs.aws.amazon.com/marketplace/latest/APIReference/catalog-api-access-control.html) para obtener más información. Puede utilizarlo `AWSMarketplaceSellerProductFullAccess` para realizar todas las operaciones necesarias para acceder a la solución a través de la API Catalog y Partner Central 3.0 en la consola de administración de AWS. ### Ejemplo de política de IAM para soluciones El siguiente ejemplo de política de IAM permite acciones específicas (`DescribeEntity``ListEntities`, y`StartChangeSet`) en la `Solution@1.0` entidad. Puedes restringirla aún más para restringir el acceso de un principal a ciertos tipos de cambios en determinados ID de entidad, o ampliarla para permitir que un principal también opere en otro tipo de entidad compatible con la API de catálogo. ``` { "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:StartChangeSet" ], "Resource": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*", "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*" ], "Condition": { "StringEquals": { "catalog:ChangeType": [ "CreateSolution", "UpdateInformation", "UpdateRelatedProducts", "ReleaseSolution", "UpdateBuyerEngagementOptions", "UpdateVisibility" ] } } }, { "Effect": "Allow", "Action": [ "aws-marketplace:ListEntities", "aws-marketplace:DescribeEntity" ], "Resource": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*" ] }, { "Effect": "Allow", "Action": [ "aws-marketplace:DescribeChangeSet", "aws-marketplace:ListChangeSets", "aws-marketplace:CancelChangeSet" ], "Resource": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*" ] }, { "Effect": "Allow", "Action": [ "aws-marketplace:TagResource", "aws-marketplace:UntagResource", "aws-marketplace:ListTagsForResource" ], "Resource": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*", "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/*" ] } ] } ``` ### Restringir el acceso a soluciones específicas Puede restringir el acceso a soluciones específicas mediante el ID de solución en el ARN del recurso: ``` { "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:DescribeEntity", "aws-marketplace:StartChangeSet" ], "Resource": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-specific123" ] } ] } ``` ### Restringir el acceso a tipos de cambios específicos Puede restringir el acceso a tipos de cambios específicos mediante claves de condición: ``` { "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:StartChangeSet" ], "Resource": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*" ], "Condition": { "StringEquals": { "catalog:ChangeType": [ "UpdateInformation", "UpdateRelatedProducts" ] } } } ] } ```