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.
Trabaja con conjuntos de ofertas
Los conjuntos de ofertas de AWS Marketplace permiten a los vendedores empaquetar varias ofertas privadas en paquetes negociables unificados de varios productos para los compradores. Esta capacidad responde a la creciente demanda de los clientes de soluciones integrales e integrales en entornos empresariales complejos.
Tradicionalmente, los compradores tenían que descubrir y adquirir productos individuales de varios vendedores, lo que se traducía en experiencias fragmentadas, problemas de integración y ciclos de adquisición más largos. Los conjuntos de ofertas simplifican esta tarea al permitir a los socios de AWS Marketplace combinar varias ofertas, lo que agiliza el proceso de transacción mediante ofertas privadas coordinadas en las que los clientes pueden revisar y aceptar todos los componentes con una aprobación única.
Los conjuntos de ofertas funcionan junto con las soluciones para ofrecer ofertas integrales de varios productos. Las soluciones proporcionan un rico contenido de marketing que incluye descripciones detalladas, diagramas de arquitectura y documentación de casos de uso, mientras que los conjuntos de ofertas gestionan los paquetes negociables y las condiciones comerciales para unificar las adquisiciones.
Ofrezca un conjunto de entidades
Un conjunto de ofertas es un contenedor que agrupa de 2 a 7 ofertas privadas en un solo paquete negociable. Cada oferta de un conjunto de ofertas mantiene sus propios precios, condiciones de pago, duración y contrato de licencia de usuario final (EULA) distintos, mientras que el conjunto de ofertas ofrece una experiencia unificada de descubrimiento y aceptación para los compradores.
Características clave:
Agrupa múltiples ofertas privadas (mínimo 2, máximo 7)
Permite que los compradores acepten todas las ofertas de forma unificada con una sola acción
Mantiene la flexibilidad con condiciones distintas para cada oferta
Crea acuerdos separados para cada producto, lo que permite una administración independiente después de la compra
Se puede asociar opcionalmente a una solución para mejorar el contenido de marketing
El tipo de entidad del conjunto de ofertas esOfferSet@1.0.
Identificadores de entidad
Los conjuntos de ofertas utilizan el formato de offerset-* identificador (por ejemplo,offerset-abc123def456).
Formato ARN de entidad
Los conjuntos de ofertas siguen el formato estándar de AWS ARN:
arn:aws:aws-marketplace:{region}:{account-id}:AWSMarketplace/OfferSet/{offerset-id}
Ejemplo:
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-abc123def456
Cómo empezar con los conjuntos de ofertas
En esta sección, se proporciona información detallada sobre la creación y la gestión de conjuntos de ofertas mediante los tipos de cambios 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.
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.
Si conoce los conceptos básicos del uso de la API de AWS Marketplace Catalog, consulte Uso de la API de AWS Marketplace Catalog.
Enumere los conjuntos de ofertas
Para ver todos los conjuntos de ofertas de tu cuenta, llama a la operación de ListEntities API con EntityType set toOfferSet.
Solicitud
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet" }
Respuesta
{ "EntitySummaryList": [ { "EntityType": "OfferSet", "EntityId": "offerset-xyz123", "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123", "LastModifiedDate": "2025-06-25T23:46:25Z", "OfferSetSummary": { "Name": "Enterprise Security Solution Offer Set", "State": "Released", "ReleaseDate": "2025-06-25T23:46:20Z", "SolutionId": "soln-abc987", "AssociatedOfferIds": [ "offer-abc123", "offer-def456", "offer-ghi789" ] } } ], "NextToken": null }
Filtra los conjuntos de ofertas por estado
Puede filtrar los conjuntos de ofertas por estado mediante el EntityTypeFilters parámetro.
Solicitud
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "State": { "ValueList": [ "Released" ] } } } }
Filtre los conjuntos de ofertas por ID de solución
Puede filtrar los conjuntos de ofertas por ID de solución mediante el EntityTypeFilters parámetro.
Solicitud
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "SolutionId": { "ValueList": [ "soln-abc987" ] } } } }
Filtra los conjuntos de ofertas por fecha de lanzamiento
Puedes filtrar los conjuntos de ofertas por fecha de lanzamiento y ordenar los resultados mediante los EntityTypeSort parámetros EntityTypeFilters y.
Solicitud
POST /ListEntities HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "EntityType": "OfferSet", "EntityTypeFilters": { "OfferSetFilters": { "ReleaseDate": { "AfterValue": "2025-11-01" } } }, "EntityTypeSort": { "OfferSetSort": { "SortBy": "ReleaseDate", "SortOrder": "DESCENDING" } } }
Describe un conjunto de ofertas
Para obtener información detallada sobre un conjunto de ofertas específico, llama a la operación de la DescribeEntity API.
Solicitud
GET /DescribeEntity?catalog=AWSMarketplace&entityId=offerset-xyz123 HTTP/1.1
Respuesta
{ "EntityType": "OfferSet@1.0", "EntityId": "offerset-xyz123", "EntityArn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/offerset-xyz123", "LastModifiedDate": "2025-06-25T23:46:25Z", "DetailsDocument": { "Id": "offerset-xyz123", "Name": "Enterprise Security Solution Offer Set", "BuyerNotes": "Complete security solution including endpoint protection and network monitoring", "State": "Released", "SolutionId": "soln-abc987", "ReleaseDate": "2025-06-25T23:46:20Z", "AssociatedOffers": [ { "OfferId": "offer-abc123" }, { "OfferId": "offer-def456" }, { "OfferId": "offer-ghi789" } ] } }
Crea un conjunto de ofertas
Utilice el tipo de CreateOfferSet cambio para crear una nueva entidad de conjunto de ofertas en el estado Borrador. Este es el primer paso del ciclo de vida del conjunto de ofertas, en el que se establece la entidad fundamental que, posteriormente, se configurará con las asociaciones de ofertas y los metadatos antes de ponerla a disposición de los compradores.
Sintaxis de la solicitud
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "CreateOfferSet", "Entity": { "Type": "OfferSet@1.0" }, "ChangeName": "CreateOfferSetChange", "DetailsDocument": { "Name": "Enterprise Security Solution Offer Set" } } ] }
Proporciona información sobre los campos para añadir el tipo de CreateOfferSet cambio:
Entity(objeto) (obligatorio): el tipo de entidad que se está creando.Type(cadena) (obligatorio): debe serloOfferSet@1.0.
DetailsDocument(objeto) (obligatorio): detalles de la solicitud.Name(cadena) (obligatorio): el nombre asociado al conjunto de ofertas para que usted y sus clientes puedan leerlo mejor. Longitud mínima: 1 carácter. Longitud máxima: 150 caracteres.
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. Esto incluye la validación de la información para garantizar que cumpla con las directrices de AWS Marketplace. El proceso de validación puede tardar unos minutos.
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 procesarse correctamente, AWS Marketplace genera un conjunto de ofertas en estado Borrador con un identificador único con offerset- el prefijo.
Actualice la información del conjunto de ofertas
Usa el tipo de UpdateInformation cambio para modificar los detalles de un conjunto de ofertas existente, incluidos su nombre y las notas del comprador.
Sintaxis de la solicitud
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "UpdateInformation", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Name": "Updated Enterprise Security Offer Set", "BuyerNotes": "Complete security solution including endpoint protection, network monitoring, and professional services implementation" } } ] }
Proporcione información sobre los campos para añadir el tipo de UpdateInformation cambio:
Entity(objeto) (obligatorio): la entidad que se está actualizando.Identifier(cadena) (obligatorio): el ID de tu conjunto de ofertas. Para obtener más información, consulte Identificador.Type(cadena) (obligatorio): debe serloOfferSet@1.0.
DetailsDocument(objeto) (obligatorio): se debe proporcionar al menos un campo.Name(cadena) (opcional): nombre para mostrar visible para los compradores. Longitud mínima: 1 carácter. Longitud máxima: 150 caracteres.BuyerNotes(cadena) (opcional): información detallada sobre el conjunto de ofertas que ayuda a los compradores a entender su finalidad y su contenido. Longitud mínima: 1 carácter. Longitud máxima: 1000 caracteres.
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. Esto incluye la validación de la información para garantizar que cumpla con las directrices de AWS Marketplace. El proceso de validación puede tardar unos minutos.
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.
Asocie las ofertas a un conjunto de ofertas
Usa el tipo de AssociateOffers cambio para asociar varias AWS Marketplace ofertas a un conjunto de ofertas. Esto crea la relación entre las ofertas y el conjunto de ofertas, haciendo que las ofertas formen parte de la configuración negociable del conjunto de ofertas.
La operación es idempotente y permite asociar ofertas independientemente de su estado actual, lo que permite una configuración completa antes de que se publiquen las ofertas individuales. Cada oferta solo puede pertenecer a un conjunto de ofertas.
importante
La OfferSetId oferta no individual es inmutable y solo se puede configurar durante la creación de la oferta. Antes de asociar las ofertas a un conjunto de ofertas mediante el usoAssociateOffers, primero debes crear las ofertas individuales y especificarlas OfferSetId durante la creación de la oferta. Si necesitas incluir una oferta existente que no tenga la correctaOfferSetId, debes crear una nueva oferta con la correcta OfferSetId especificada.
Para obtener información sobre los permisos de IAM necesarios, consultePermisos de IAM para conjuntos de ofertas.
Sintaxis de la solicitud
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "AssociateOffers", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Offers": [ { "OfferId": "offer-xyz789" }, { "OfferId": "offer-def456" }, { "OfferId": "offer-ghi123" } ] } } ] }
Proporcione información sobre los campos para añadir el tipo de AssociateOffers cambio:
Entity(objeto) (obligatorio): la entidad que se está actualizando.Identifier(cadena) (obligatorio): el ID de tu conjunto de ofertas. Para obtener más información, consulte Identificador.Type(cadena) (obligatorio): debe serloOfferSet@1.0.
DetailsDocument(objeto) (obligatorio): detalles de la solicitud.Offers(matriz) (obligatorio): lista de AWS Marketplace ofertas para asociar. Mínimo: 1 artículo. Máximo: 7 artículos.OfferId(cadena) (obligatorio): el identificador de la AWS Marketplace oferta. Longitud mínima: 1 carácter. Longitud máxima: 36 caracteres.
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. Esto incluye la validación de la información para garantizar que cumpla con las directrices de AWS Marketplace. El proceso de validación puede tardar unos minutos.
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
Los siguientes errores son específicos de las AssociateOffers acciones de la API del AWS Marketplace catálogo. Estos errores se devuelven cuando llamas 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, consulteTrabajar con conjuntos de cambios.
| Código de error | Mensaje de error |
|---|---|
DEMASIADAS OFERTAS |
Asocie hasta 7 ofertas al conjunto de ofertas. |
INCOMPATIBLE_OFFER_SET_REFERENCE |
Asegúrese de que todas las ofertas se hayan creado específicamente para este conjunto de ofertas. |
INVALID_UPDATE_REQUEST |
El cambio solicitado no se podrá realizar después de que se publique el conjunto de ofertas. |
Disocia las ofertas de un conjunto de ofertas
Usa el tipo de DisassociateOffers cambio para eliminar varias AWS Marketplace ofertas de un conjunto de ofertas. Esta operación idempotente elimina la relación de asociación y, al mismo tiempo, conserva el atributo de OfferSetId la oferta. Las ofertas disociadas pasan a estar ocultas para que el comprador las descubra hasta que se vuelvan a asociar al mismo conjunto de ofertas. No se pueden asociar a un conjunto de ofertas diferente.
Sintaxis de la solicitud
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "DisassociateOffers", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "Offers": [ { "OfferId": "offer-xyz789" } ] } } ] }
Proporcione información sobre los campos para añadir el tipo de DisassociateOffers cambio:
Entity(objeto) (obligatorio): la entidad que se está actualizando.Identifier(cadena) (obligatorio): el ID de tu conjunto de ofertas. Para obtener más información, consulte Identificador.Type(cadena) (obligatorio): debe serloOfferSet@1.0.
DetailsDocument(objeto) (obligatorio): detalles de la solicitud.Offers(matriz) (obligatorio): lista de ofertas que se van a desasociar. Mínimo: 1 artículo. Máximo: 7 artículos.OfferId(string) (obligatorio): el identificador de la oferta de AWS Marketplace. Longitud mínima: 1 carácter. Longitud máxima: 36 caracteres.
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. Esto incluye la validación de la información para garantizar que cumpla con las directrices de AWS Marketplace. El proceso de validación puede tardar unos minutos.
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
Los siguientes errores son específicos de las DisassociateOffers acciones de la API del AWS Marketplace catálogo. Estos errores se devuelven cuando llamas 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, consulteTrabajar con conjuntos de cambios.
| Código de error | Mensaje de error |
|---|---|
INVALID_UPDATE_REQUEST |
El cambio solicitado no se podrá realizar después de que se publique el conjunto de ofertas. |
Asocie una solución a un conjunto de ofertas
Utilice el tipo de AssociateSolution cambio para asociar una única solución de AWS Marketplace a un conjunto de ofertas. Esto crea una relación que permite a los compradores descubrir la conexión del conjunto de ofertas con la solución y acceder al rico contenido de marketing de la solución, como descripciones detalladas, diagramas de arquitectura y documentación de casos de uso.
nota
Se trata de una asociación vagamente acoplada. AWS Marketplace no impone la coherencia entre la solución y el conjunto de ofertas. Las soluciones no pueden incluir productos de AWS Marketplace, productos diferentes a los del conjunto de ofertas o productos superpuestos. Dispone de total flexibilidad para asociar cualquier solución que posea con fines de marketing y descubrimiento.
Para obtener información sobre los permisos de IAM necesarios, consultePermisos de IAM para conjuntos de ofertas.
Sintaxis de la solicitud
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "AssociateSolution", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "SolutionId": "soln-xyz789" } } ] }
Proporcione información sobre los campos para añadir el tipo de AssociateSolution cambio:
Entity(objeto) (obligatorio): la entidad que se está actualizando.Identifier(cadena) (obligatorio): el ID de tu conjunto de ofertas. Para obtener más información, consulte Identificador.Type(cadena) (obligatorio): debe serloOfferSet@1.0.
DetailsDocument(objeto) (obligatorio): detalles de la solicitud.SolutionId(string) (obligatorio): el identificador de la solución de AWS Marketplace que se va a asociar. Longitud mínima: 1 carácter. Longitud máxima: 50 caracteres. Debe coincidir con el patrón^soln-[A-Za-z0-9]+$.
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. Esto incluye la validación de la información para garantizar que cumpla con las directrices de AWS Marketplace. El proceso de validación puede tardar unos minutos.
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
Los siguientes errores son específicos de las AssociateSolution acciones de la API del AWS Marketplace catálogo. Estos errores se devuelven cuando llamas 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, consulteTrabajar con conjuntos de cambios.
| Código de error | Mensaje de error |
|---|---|
ASOCIACIÓN_SOLUCIÓN_INCOMPATIBLE_SOLUCIÓN |
Desasocie la solución existente antes de asociar una nueva solución. |
INVALID_UPDATE_REQUEST |
El cambio solicitado no se podrá realizar después de que se publique el conjunto de ofertas. |
Disocia una solución de un conjunto de ofertas
Utilice el tipo de DisassociateSolution cambio para eliminar la asociación entre una solución y un conjunto de ofertas. Esto elimina el contenido de marketing de la solución del conjunto de ofertas y, al mismo tiempo, mantiene la funcionalidad negociable del conjunto de ofertas.
Sintaxis de la solicitud
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "DisassociateSolution", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": { "SolutionId": "soln-xyz789" } } ] }
Proporcione información sobre los campos para añadir el tipo de DisassociateSolution cambio:
Entity(objeto) (obligatorio): la entidad que se está actualizando.Identifier(cadena) (obligatorio): el ID de tu conjunto de ofertas. Para obtener más información, consulte Identificador.Type(cadena) (obligatorio): debe serloOfferSet@1.0.
DetailsDocument(objeto) (obligatorio): detalles de la solicitud.SolutionId(cadena) (obligatorio): el identificador de la solución que se va a desasociar. Longitud mínima: 1 carácter. Longitud máxima: 50 caracteres.
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. Esto incluye la validación de la información para garantizar que cumpla con las directrices de AWS Marketplace. El proceso de validación puede tardar unos minutos.
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
Los siguientes errores son específicos de las DisassociateSolution acciones de la API del AWS Marketplace catálogo. Estos errores se devuelven cuando llamas 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, consulteTrabajar con conjuntos de cambios.
| Código de error | Mensaje de error |
|---|---|
INVALID_UPDATE_REQUEST |
El cambio solicitado no se podrá realizar después de que se publique el conjunto de ofertas. |
Publica un conjunto de ofertas
Usa el tipo de ReleaseOfferSet cambio para poner un conjunto de ofertas a disposición de los compradores. Una vez publicado, el conjunto de ofertas pasa del estado Borrador al Publicado, pasa a estar AWS Marketplace disponible y las ofertas asociadas solo se pueden encontrar como parte del paquete unificado.
Los conjuntos de ofertas publicados generan notificaciones en dos niveles: las ofertas individuales y el conjunto de ofertas en sí. Todas las notificaciones de ofertas individuales incluyen las de OfferSetId los canales de notificación existentes (notificaciones por correo electrónico y EventBridge eventos de Amazon). Las notificaciones a nivel de conjunto de ofertas se envían para eventos clave, como el momento en que se publica el conjunto de ofertas.
Sintaxis de la solicitud
POST /StartChangeSet HTTP/1.1 Content-type: application/json { "Catalog": "AWSMarketplace", "ChangeSet": [ { "ChangeType": "ReleaseOfferSet", "Entity": { "Type": "OfferSet@1.0", "Identifier": "offerset-abc123" }, "DetailsDocument": {} } ] }
Proporcione información sobre los campos para añadir el tipo de ReleaseOfferSet cambio:
Entity(objeto) (obligatorio): la entidad que se está actualizando.Identifier(cadena) (obligatorio): el ID de tu conjunto de ofertas. Para obtener más información, consulte Identificador.Type(cadena) (obligatorio): debe serloOfferSet@1.0.
DetailsDocument(objeto) (obligatorio): objeto vacío para esta operación.
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. Esto incluye la validación de la información para garantizar que cumpla con las directrices de AWS Marketplace. El proceso de validación puede tardar unos minutos.
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
Los siguientes errores son específicos de las ReleaseOfferSet acciones de la API del AWS Marketplace catálogo. Estos errores se devuelven cuando llamas 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, consulteTrabajar con conjuntos de cambios.
| Código de error | Mensaje de error |
|---|---|
MISSING_BUYER_NOTES |
BuyerNotes Entréguelo antes de lanzar el conjunto de ofertas. |
MISSING_OFFERS |
Asocie al menos dos ofertas al conjunto de ofertas antes de publicarlo. |
DEMASIADAS OFERTAS POR PRODUCTO |
Asocia solo una oferta por producto al conjunto de ofertas. |
INCONSISTENT_OFFER_CURRENCY_CODE |
Asegúrese de que todas las ofertas asociadas coincidan. CurrencyCode |
INCONSISTENT_OFFER_AVAILABILITY_END_DATE |
Asegúrese de que todas las ofertas asociadas coincidan. AvailabilityEndDate |
INCONSISTENT_OFFER_TARGETING_RULE |
Asegúrese de que todas las ofertas asociadas coincidan. TargetingRule |
INCOMPATIBLE_OFFER_TARGETING_RULE |
Solo las ofertas dirigidas a los compradores se pueden asociar a un conjunto de ofertas. |
EXPIRED_OFFERS |
Desvincule las ofertas caducadas del conjunto de ofertas o amplíe sus ofertas. AvailabilityEndDates |
DRAFT_OFFERS |
Publica todas las ofertas asociadas antes de lanzar el conjunto de ofertas. |
INCOMPATIBLE_SOLUTION_STATE |
Proporcione una solución en estado público o limitado. |
INVÁLID_UPDATE_REQUEST |
El cambio solicitado no se podrá realizar después de que se publique el conjunto de ofertas. |
Ciclo de vida de la oferta
El ciclo de vida del conjunto de ofertas consta de las siguientes etapas:
Fase de creación
Cree la entidad del conjunto de ofertas en estado Borrador utilizando el tipo de CreateOfferSet cambio. El conjunto de ofertas recibe un identificador único y comienza en estado Borrador.
Fase de configuración
Durante la configuración, usted:
Agrega o actualiza los metadatos mediante
UpdateInformation(nombre, notas del comprador)Crea ofertas privadas individuales especificándolas
OfferSetIddurante la creación de la ofertaAsocie las ofertas al conjunto de ofertas mediante
AssociateOffersSi lo desea, asocie una solución utilizando
AssociateSolutionpara mejorar el contenido de marketing
importante
La opción OfferSetId de ofertas individuales es inmutable y solo se puede configurar durante la creación de la oferta. Antes de asociar las ofertas a un conjunto de ofertas mediante el usoAssociateOffers, primero debes crear las ofertas individuales y especificarlas OfferSetId durante la creación de la oferta. Si necesitas incluir una oferta existente que no tenga la correctaOfferSetId, debes crear una nueva oferta con la correcta OfferSetId especificada.
Fase de validación
Antes de lanzar un conjunto de ofertas, asegúrate de:
El conjunto de ofertas contiene entre 2 y 7 ofertas
Todas las ofertas asociadas deben ser:
En estado publicado
Activo
¿Utilizan la misma moneda
Dirigirse a los mismos ID de cuenta de AWS del comprador
Tener fechas de caducidad idénticas
Fase de lanzamiento
Cuando esté listo, utilice el tipo de ReleaseOfferSet cambio para hacer que el conjunto de ofertas pase del estado Borrador al estado Publicado. De este modo, los compradores podrán descubrir el conjunto de ofertas a través AWS Marketplace de él.
Post-release administración
Gestión de vencimientos:
El vencimiento efectivo de un conjunto de ofertas se calcula como la fecha de vencimiento más temprana de todas las ofertas asociadas
Puedes modificar las fechas de caducidad de cada oferta mediante las funciones de gestión de ofertas existentes (tipo de
UpdateAvailabilitycambio)
Modificaciones del conjunto de ofertas:
Cuando los compradores soliciten cambios en un conjunto de ofertas publicado, utiliza el flujo de trabajo recreativo:
Crea una nueva entidad de conjunto de ofertas
En el caso de las ofertas que no requieren cambios, clone las ofertas existentes a través del portal AWS Marketplace de administración
En el caso de las ofertas que requieran modificaciones, cree nuevas ofertas con los cambios solicitados y especifique los nuevos
OfferSetIdAsocie todas las ofertas (clonadas y nuevas) al nuevo conjunto de ofertas mediante
AssociateOffersPublica el nuevo conjunto de ofertas usando
ReleaseOfferSetPara caducar el conjunto de ofertas original, establece la fecha de finalización de la disponibilidad de las ofertas asociadas
Permisos de IAM para conjuntos de ofertas
Para trabajar con conjuntos de ofertas mediante la API de AWS Marketplace catálogo, necesitas permisos de IAM específicos. En esta sección se describen los permisos necesarios para las operaciones del conjunto de ofertas y los requisitos de autorización entre entidades.
Acciones obligatorias
Las siguientes acciones de IAM son necesarias para las operaciones de conjuntos de ofertas:
aws-marketplace:StartChangeSet— Necesario para todos los tipos de cambio de conjuntos de ofertas, incluidas las operaciones de creación, actualización, asociación y publicaciónaws-marketplace:DescribeChangeSet— Necesario para comprobar el estado y los resultados de la ejecución de los conjuntos de cambiosaws-marketplace:ListEntities— Necesario para incluir los conjuntos de ofertas en tu cuentaaws-marketplace:DescribeEntity— Necesario para recuperar información detallada sobre un conjunto de ofertas
Permisos de recursos
Utilice los siguientes patrones de ARN para conceder permisos en recursos específicos:
Conjuntos de ofertas:
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*Ofertas individuales —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*Soluciones —
arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*
Para obtener permisos más restrictivos, sustituya el comodín (*) por identificadores de entidad específicos.
Cross-entity autorización
Algunas operaciones del conjunto de ofertas requieren permisos tanto en el conjunto de ofertas como en las entidades asociadas:
AssociateOffers
aws-marketplace:StartChangeSetpermiso sobre la entidad del conjunto de ofertasaws-marketplace:StartChangeSetpermiso con tipo deAssociateWithOfferSetcambio en cada entidad de oferta individual a la que se asocie
AssociateSolution
aws-marketplace:StartChangeSetpermiso sobre la entidad del conjunto de ofertasaws-marketplace:StartChangeSetpermiso con tipo deAssociateWithOfferSetcambio en la entidad de solución que se está asociando
nota
Tener solo un permiso DescribeEntity (de solo lectura) para las ofertas o soluciones no es suficiente para las operaciones de asociación. Debe tener StartChangeSet permiso para AssociateWithOfferSet cambiar el tipo de cambio en las entidades asociadas al conjunto de ofertas.
Ejemplos de políticas de IAM
Gestión básica del conjunto de ofertas
Esta política proporciona permisos para las operaciones de conjuntos de ofertas básicos sin asociaciones entre entidades:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "aws-marketplace:StartChangeSet", "aws-marketplace:DescribeChangeSet", "aws-marketplace:ListEntities", "aws-marketplace:DescribeEntity" ], "Resource": [ "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*" ] } ] }
Cross-entity permisos para AssociateOffers
Esta política demuestra los permisos y condiciones específicos necesarios para AssociateOffers:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateOffers"] } } }, { "Effect": "Allow", "Action": "aws-marketplace:DescribeEntity", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*" }, { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateWithOfferSet"] } } } ] }
Para obtener permisos más restrictivos, sustituya el comodín (*) por identificadores de entidad específicos.
Cross-entity permisos para AssociateSolution
Esta política demuestra los permisos y condiciones específicos necesarios para AssociateSolution:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/OfferSet/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateSolution"] } } }, { "Effect": "Allow", "Action": "aws-marketplace:DescribeEntity", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*" }, { "Effect": "Allow", "Action": "aws-marketplace:StartChangeSet", "Resource": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/*", "Condition": { "StringEquals": { "catalog:ChangeType": ["AssociateWithOfferSet"] } } } ] }
Para obtener permisos más restrictivos, sustituya el comodín (*) por identificadores de entidad específicos.