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.

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. Este registro es necesario para:

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:

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

El tipo de entidad de la solución esSolution@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 de la API de AWS Marketplace catálogo.

Antes de empezar, asegúrese de que tiene lo siguiente:

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.

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

EntityTagsSolo 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 y Añadir etiquetas a una entidad y un conjunto de cambios durante la creación.

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: UpdateInformationUpdateRelatedProducts,, UpdateBuyerEngagementOptions (opcional para crear una Limited solución) yReleaseSolution. 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.

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:

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

CreateSolutionlas acciones devuelven errores específicos, además de los errores asíncronos comunes. 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.

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.

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.

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:

Para obtener información sobre las URL prefirmadas, consulte Compartir objetos con direcciones URL prefirmadas.

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

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.

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:

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

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:

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

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.

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:

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

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 LimitedPublic, oRestricted.

Si lo configura TargetVisibilityPublic, 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 oLimited.

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

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:

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 «TargetVisibilityas»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.

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.

Vida útil de la solución

Las soluciones progresan a través de los siguientes valores de 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:

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 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 (DescribeEntityListEntities, yStartChangeSet) 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"
          ]
        }
      }
    }
  ]
}