View a markdown version of this page

Trabaja con conjuntos de ofertas - AWS Marketplace

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:

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 OfferSetId durante la creación de la oferta

  • Asocie las ofertas al conjunto de ofertas mediante AssociateOffers

  • Si lo desea, asocie una solución utilizando AssociateSolution para 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 UpdateAvailability cambio)

Modificaciones del conjunto de ofertas:

Cuando los compradores soliciten cambios en un conjunto de ofertas publicado, utiliza el flujo de trabajo recreativo:

  1. Crea una nueva entidad de conjunto de ofertas

  2. En el caso de las ofertas que no requieren cambios, clone las ofertas existentes a través del portal AWS Marketplace de administración

  3. En el caso de las ofertas que requieran modificaciones, cree nuevas ofertas con los cambios solicitados y especifique los nuevos OfferSetId

  4. Asocie todas las ofertas (clonadas y nuevas) al nuevo conjunto de ofertas mediante AssociateOffers

  5. Publica el nuevo conjunto de ofertas usando ReleaseOfferSet

  6. Para 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ón

  • aws-marketplace:DescribeChangeSet— Necesario para comprobar el estado y los resultados de la ejecución de los conjuntos de cambios

  • aws-marketplace:ListEntities— Necesario para incluir los conjuntos de ofertas en tu cuenta

  • aws-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 individualesarn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/*

  • Solucionesarn: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 ofertas

  • aws-marketplace:StartChangeSetpermiso con tipo de AssociateWithOfferSet cambio en cada entidad de oferta individual a la que se asocie

AssociateSolution

  • aws-marketplace:StartChangeSetpermiso sobre la entidad del conjunto de ofertas

  • aws-marketplace:StartChangeSetpermiso con tipo de AssociateWithOfferSet cambio 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.