Se reestructuró la referencia de la Centro de socios de AWS API. Para obtener más información sobre las operaciones de API compatibles, consulte la referencia [ de la ](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)Centro de socios de AWS API. 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 sus participaciones en ingresos de Marketplace Un reparto de ingresos de Marketplace es un dato de un producto de AWS Marketplace que declara la parte de los ingresos totales del producto recaudada a través de AWS Marketplace.AWS utiliza esta información para correlacionar los Marketplace-collected ingresos de un socio con otras señales de ingresos. El servicio Marketplace Revenue Share expone las API para crear, recuperar y enumerar los recursos de Marketplace Revenue Share y para administrar sus asignaciones (los porcentajes de participación en los ingresos declarados por los socios y las ventanas de fechas de entrada en vigor). Las operaciones de AWS etiquetado estándar se admiten en el recurso Marketplace Revenue Share. ## ¿Qué es un reparto de ingresos de Marketplace? Un reparto de ingresos de Marketplace tiene dos niveles: + **La acción**: una entrada para un solo producto de AWS Marketplace, identificado por Marketplace`ProductId`. Hay exactamente un reparto de ingresos de Marketplace por producto. + **Una o más asignaciones**: cada asignación declara una `RevenueSharePercent` y una ventana de fecha de entrada en vigor (`EffectiveDate`opcionalmente`ExpirationDate`). Una acción puede tener muchas asignaciones a lo largo del tiempo, pero en cualquier momento solo se puede aplicar una `ACTIVE` asignación. Las asignaciones tienen las siguientes propiedades clave: + **Estado**: `ACTIVE` o. `INACTIVE` Al crearlo, el estado se establece de forma predeterminada en. `ACTIVE` Solo `ACTIVE` las asignaciones participan en los cálculos de ingresos y en las comprobaciones de superposición. + **Invariante de superposición**: dentro de una sola acción, no es posible que dos `ACTIVE` asignaciones tengan rangos superpuestos. `[EffectiveDate, ExpirationDate]` Se permite como máximo una `ACTIVE` asignación indefinida (no`ExpirationDate`) por acción en cualquier momento. ## Trabaje con sus participaciones en ingresos de Marketplace Los socios administran los ingresos compartidos de Marketplace y sus asignaciones a través del servicio Marketplace Revenue Share. El ciclo de vida progresa a través de dos flujos: el flujo de acciones (crear, recuperar, enumerar, etiquetar) y el flujo de asignaciones (crear, actualizar, eliminar temporalmente, recuperar y enumerar). ### Creación de una participación en los ingresos de Marketplace El primer paso es crear un reparto de ingresos de Marketplace para un producto de AWS Marketplace mediante la acción de la `CreateMarketplaceRevenueShare` API. El Marketplace identifica la acción `ProductId` y sirve como contenedor para todas las asignaciones posteriores. Al crear un reparto de ingresos de Marketplace, los socios deben proporcionar: + **`Catalog`**— `AWS` para producción o `Sandbox` para pruebas. + **`ProductId`**— el identificador de producto de Marketplace de 25 caracteres. Patrón:`[a-z0-9]{25}`. Los socios pueden proporcionar opcionalmente: + **`Tags`**— hasta 50 pares clave-valor para la organización de los recursos en el momento de la creación. Se utiliza `TagResource` para añadir etiquetas después de la creación. + **`ClientToken`**— un símbolo de idempotencia para evitar que se dupliquen las creaciones al volver a intentarlo. 64 caracteres como máximo. Los SDK generan automáticamente este token. Validación del producto: al crearlo, el servicio verifica con AWS Marketplace que el producto es propiedad de la cuenta de la persona que llama o de una cuenta subsidiaria conectada a la persona que llama a través de Partner Account Connection (PAC). Si el producto no existe o el propietario de la cuenta no está autorizado para la persona que llama, la API se devuelve con el motivo. `ValidationException` `PRODUCT_NOT_FOUND_OR_NOT_OWNED` Una acción por producto: una segunda compra por `CreateMarketplaceRevenueShare` lo mismo y con `ProductId` las mismas `Catalog` devoluciones. `ConflictException` La respuesta devuelve la acción `Arn` (formato`arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}`), el `Catalog``ProductId`, el `Version` número inicial (que comienza en 1 y aumenta con cada mutación de asignación) y cualquier etiqueta aplicada en el momento de la creación. ### Añadir asignaciones Una vez que se crea una participación en los ingresos de Marketplace, los socios declaran un porcentaje de participación en los ingresos y una ventana de fecha de entrada en vigor mediante la creación de una asignación mediante la acción de la `CreateMarketplaceRevenueShareAllocation` API. Al crear una asignación, los socios deben proporcionar: + **`Catalog`**— `AWS` o`Sandbox`. + **`MarketplaceRevenueShareIdentifier`**— el identificador de la acción principal. + **`RevenueSharePercent`**— el porcentaje de los ingresos del producto recaudados a través de Marketplace indicado en forma decimal (por ejemplo, `0.45` para un 45%). + **`EffectiveDate`**— la fecha natural en la que esta asignación entra en vigor. Formato: `YYYY-MM-DD`. La respuesta devuelve la asignación `Id` (formato`mrsa-[A-Za-z0-9]{13}`), el estado de la asignación (`ACTIVE`en el momento de la creación) y la acción matriz superada `Version` (en cada mutación de asignación se añade un entero de una sola versión por acción, lo que se utiliza para fijar de forma optimista las actualizaciones de asignación posteriores). ### Actualizar las asignaciones Los socios pueden actualizar una asignación mediante la acción de la `UpdateMarketplaceRevenueShareAllocation` API. Los campos actualizables dependen de si la asignación tiene fecha futura, está en vigor actualmente o está fechada en el pasado. Al actualizar una asignación, los socios deben proporcionar: + **`Catalog`**— `AWS` o`Sandbox`. + **`MarketplaceRevenueShareIdentifier`**— el identificador de la acción principal. + **`AllocationId`**— el `mrsa-` ID de la asignación que se va a actualizar. + **`MarketplaceRevenueShareVersion`**— la versión actual de la acción principal para fijar la asignación de forma optimista. `ConflictException`Vuelven los conflictos de Bump. Los socios pueden proporcionar opcionalmente: + **`RevenueSharePercent`**— el porcentaje de participación en los ingresos actualizado. Solo se puede editar en asignaciones con fecha futura. + **`EffectiveDate`**— la fecha de entrada en vigor actualizada. Solo se puede editar en asignaciones con fecha futura. + **`ExpirationDate`**— la fecha de caducidad actualizada. Se puede editar en las asignaciones con fecha futura (cualquier valor`> EffectiveDate`) y en las asignaciones actualmente en vigor o abiertas (cualquier valor). `≥ today` + **`Status`**`INACTIVE`— o. `ACTIVE` Si se selecciona esta opción, `INACTIVE` se suprime temporalmente la asignación. Solo se puede editar en asignaciones con fecha futura. + **`ClientToken`**— un símbolo de idempotencia. ### Visualización de los detalles del reparto de ingresos de Marketplace Los socios pueden recuperar la información completa de un único reparto de ingresos de Marketplace mediante la acción de la `GetMarketplaceRevenueShare` API. Esto devuelve la acción`Arn`, `Catalog``ProductId`, `Version` (la versión actual de la acción principal) y cualquier etiqueta aplicada a la acción. `CreatedDate` `LastModifiedDate` Los socios pueden recuperar una única asignación mediante la acción de la `GetMarketplaceRevenueShareAllocation` API junto con la de la asignación`Id`. Esto muestra: + La asignación `Id` y las acciones principales`MarketplaceRevenueShareArn`. + `RevenueSharePercent`, `EffectiveDate`, `ExpirationDate`. + `Status`(`ACTIVE`o`INACTIVE`). + La parte principal es `MarketplaceRevenueShareVersion` para fijar con optimismo las actualizaciones posteriores. + `CreatedDate` y `LastModifiedDate`. ### Cotización de acciones en ingresos de Marketplace Los socios pueden ver todos los ingresos compartidos de Marketplace que pertenecen a su cuenta mediante la acción de la `ListMarketplaceRevenueShares` API. Esto devuelve una lista paginada de resúmenes de acciones. Los socios pueden filtrar los resultados por: + **`Catalog`**— `AWS` o `Sandbox` (obligatorio). + **`ProductIds`**— una lista de identificadores de productos específicos de Marketplace para recuperar. La respuesta incluye un resumen de cada acción `Arn` compartida: `Catalog``ProductId`,, `Version``CreatedDate`, la última y`LastModifiedDate`. Utilice `MaxResults` y `NextToken` para paginar conjuntos de resultados de gran tamaño. ### Listar las asignaciones Los socios pueden enumerar las asignaciones de un porcentaje de ingresos de Marketplace específico mediante la acción de la `ListMarketplaceRevenueShareAllocations` API. Esto devuelve una lista paginada de resúmenes de asignaciones con funciones de filtrado. Los socios pueden filtrar los resultados por: + **`Status`**— `ACTIVE` o`INACTIVE`. + **Intervalo de fechas de entrada en vigor**:`EffectiveDateOnOrAfter`/`EffectiveDateOnOrBefore`para recuperar las asignaciones cuya fecha de entrada en vigor se encuentre dentro de un período específico. La respuesta incluye información resumida para cada asignación:`Id`,,, `RevenueSharePercent` `EffectiveDate` `ExpirationDate` `Status``MarketplaceRevenueShareVersion`, y las marcas de tiempo de la auditoría. ## Etiquetado de las acciones de ingresos de Marketplace Las operaciones de AWS etiquetado estándar se admiten en el recurso de participación en los ingresos de Marketplace: + **`TagResource`**— añadir o sobrescribir etiquetas en un Marketplace Revenue Share. Máximo 50 etiquetas por acción. + **`UntagResource`**— eliminar etiquetas específicas por clave. + **`ListTagsForResource`**— recuperar todas las etiquetas actualmente aplicadas a un Marketplace Revenue Share. Las asignaciones no admiten etiquetas. Etiquete el recurso compartido principal para organizar las asignaciones relacionadas. Cada operación de etiquetado acepta el recurso compartido `Arn` (formato`arn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}`) como identificador de recursos. También se admite el método estándar AWS de etiquetar al crear a través del campo on. `Tags` `CreateMarketplaceRevenueShare`