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.
# Integraciones de facturación, medición y licencias de productos de contenedor
AWS Marketplace se integra con otros Servicios de AWS para proporcionar precios tanto de medición como basados en contratos para su producto de contenedor. Para los productos basados en contenedor con precio de uso, utilice el [AWS Marketplace Metering Service](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html) tanto para comprobar el derecho a utilizar el producto como para el uso de medición para facturación. En el caso de los productos basados en contenedores con precios contractuales, puede utilizarlos para asociar las licencias AWS License Manager a su producto. En las siguientes secciones, se ofrece más información sobre la medición por hora y personalizada con AWS Marketplace Metering Service y los precios por contrato con AWS License Manager.
**Topics**
+ [Medición horaria y personalizada con AWS Marketplace Metering Service](#entitlement-and-metering-for-paid-products)
+ [Contrata los precios con AWS License Manager](#container-products-contracts-license-manager)
+ [Configuración de medición por hora con AWS Marketplace Metering Service](container-metering-registerusage.md)
+ [Configuración de medición personalizada para productos de contenedores con AWS Marketplace Metering Service](container-metering-meterusage.md)
+ [Contrata los precios de los productos en contenedores con AWS License Manager](container-license-manager-integration.md)
## Medición horaria y personalizada con AWS Marketplace Metering Service
El [servicio de medición de AWS Marketplace](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html) se utiliza tanto para comprobar el derecho a utilizar el producto como para el uso de medición para la facturación. Si quieres definir tus propias unidades de precios y contarnos ese uso a efectos de facturación, intégralo mediante la operación de la [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html)API. Si quieres fijar el precio de tu producto en función del número de tareas o módulos utilizados y AWS medir ese uso automáticamente, intégralo mediante la operación de la [RegisterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_RegisterUsage.html)API. Para ambos tipos de precios, puede agregar un precio por contrato a largo plazo sin cambiar la forma en que se integra en AWS Marketplace Metering Service.
Cuando creas un nuevo producto contenedor en el AWS Marketplace Management Portal, te proporcionamos un conjunto de identificadores de producto (el código del producto y la clave pública) que se utilizan para integrar tu producto con el AWS Marketplace Metering Service.
### Concesión de derechos
La integración con el AWS Marketplace Metering Service le permite verificar que el cliente que utiliza su software de pago está suscrito a su producto AWS Marketplace, lo que le evita el uso no autorizado al iniciar el contenedor. Para verificar la idoneidad, utilice las operaciones de la [RegisterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_RegisterUsage.html)API [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html)o de la API, en función de su modelo de precios. Para modelos de precios mensuales fijos y por hora, utilice la operación de API `RegisterUsage`. Para modelos de precios de medición personalizada, utilice la operación de API `MeterUsage`.
Si un comprador no tiene derecho a su producto, estas operaciones de la API devuelven la excepción `CustomerNotEntitledException`.
**nota**
Si un comprador cancela la suscripción a su producto mientras lo ejecuta, tiene derecho a seguir ejecutándolo. Sin embargo, no puede lanzar contenedores adicionales para su producto.
### Directrices de integración
Tenga en cuenta las siguientes directrices a la hora de crear y publicar sus productos de contenedor y utilizar las operaciones de API `MeterUsage` o `RegisterUsage` para la autorización y la medición:
+ No configure AWS las credenciales en el software ni en la imagen del contenedor de Docker. AWS las credenciales del comprador se obtienen automáticamente en tiempo de ejecución cuando la imagen del contenedor se ejecuta en una tarea de Amazon ECS o en un pod de Amazon EKS.
+ Para llamar a las operaciones de `RegisterUsage` API `MeterUsage` o a las operaciones de Amazon EKS, debe [usar un AWS SDK compatible](https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts-minimum-sdk.html). Para probar la integración de `MeterUsage` o de `RegisterUsage`, debe ejecutar un clúster de Amazon EKS que ejecute Kubernetes 1.13.x o una versión posterior. Se requiere Kubernetes 1.13 para los roles AWS Identity and Access Management (de IAM) para la compatibilidad con los pods. Las funciones de IAM son necesarias para que el pod en ejecución obtenga las AWS credenciales necesarias para invocar estas acciones en Amazon EKS.
+ Puede hacer el desarrollo local, pero recibirá una excepción `PlatformNotSupportedException`. Esta excepción no se producirá al lanzar el contenedor en servicios de AWS contenedores (Amazon ECS, Amazon EKS y Fargate).
### Compatible Regiones de AWS
Para obtener una lista de todos los AWS Marketplace compatibles Regiones de AWS, consulte [la tabla de regiones](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) en el sitio web de infraestructura global.
#### Obtener el Región de AWS para medir
Al integrar el contenedor de medición con la operación `MeterUsage` o con la `RegisterUsage` API, no configure el AWS SDK para que utilice una operación específica. Región de AWS La región se debe obtener de forma dinámica en el tiempo de ejecución.
**Example**
Por ejemplo, un cliente lanza una tarea de Amazon ECS o un pod de Amazon EKS. La operación de API `RegisterUsage` se invoca en una región diferente de la región en la que se lanzó la tarea de Amazon ECS o el pod de Amazon EKS. Por lo tanto, la operación de API `RegisterUsage` arroja un error `InvalidRegionException`.
AWS Los lenguajes del SDK no lo determinan `AWS_REGION` de forma coherente. Si su SDK no detecta automáticamente la `AWS_REGION`, el software debe escribirse manualmente para determinar la `AWS_Region`. Por ejemplo, AWS SDK para Java utiliza automáticamente los [metadatos de instancia de Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html) (concretamente, `ec2InstanceMetadata`) para obtener la región cuando no hay presentes variables de entorno u otro tipo de configuración. En este caso, llame solo a `ec2InstanceMetadata` si la variable de entorno `AWS_REGION` no está presente.
Para obtener información sobre cómo obtener dinámicamente una Región de AWS en tiempo de ejecución, consulta la [Guía del desarrollador del AWS SDK](https://aws.amazon.com/tools) correspondiente a tu lenguaje de programación.
### Impedir la modificación de la medición
La introducción de métodos para que los compradores modifiquen o anulen las llamadas a `RegisterUsage` o `MeterUsage` podría dar lugar a problemas de facturación y pago no deseados. Recomendamos encarecidamente que integre la lógica de medición y derechos.
Tenga en cuenta lo siguiente al diseñar su producto para evitar la modificación de la medición:
+ Si los compradores pueden insertar nuevas capas de imagen que contengan instrucciones `CMD` o `ENTRYPOINT`, integre directamente `RegisterUsage` o `MeterUsage` en el software que el comprador ejecuta a través de la imagen del contenedor. De lo contrario, las llamadas a `RegisterUsage` o `MeterUsage` ejecutadas a través de `CMD` o `ENTRYPOINT` desde la imagen base probablemente serán anuladas por el comprador.
+ Te recomendamos que administres los códigos de AWS Marketplace producto que tu software utiliza como entrada `RegisterUsage` o `MeterUsage` de forma que los compradores no puedan modificarlos. *Sin embargo, si tu producto gestiona los códigos de producto de forma que los clientes puedan anularlos (por ejemplo, mediante un gráfico de Helm o un manifiesto de Kubernetes), debes mantener una lista de códigos de producto fiables. AWS CloudFormation* AWS Marketplace El objetivo es garantizar que el código de producto que el software envía como entrada a `RegisterUsage` o `MeterUsage` sea válido.
+ Si alguno de los códigos de producto de confianza corresponde a productos gratuitos, asegúrese de que no puedan utilizarse en lugar de un código de producto de pago.
## Contrata los precios con AWS License Manager
En el caso de los productos basados en contenedores con precios por contrato, se utilizan AWS License Manager para asociar las licencias a su producto.
AWS License Manager es una herramienta de administración de licencias que permite a su aplicación realizar un seguimiento y actualizar las licencias (también conocidas como derechos) que haya adquirido un cliente. En esta sección se ofrece información sobre cómo integrar el producto en AWS License Manager. Una vez completada la integración, puede publicar su listado de productos en AWS Marketplace.
Para obtener más información al respecto AWS License Manager, consulte la [Guía del AWS License Manager usuario](https://docs.aws.amazon.com/license-manager/latest/userguide/license-manager.html) y la [AWS License Manager](https://docs.aws.amazon.com/cli/latest/reference/license-manager/index.html)sección de la Referencia de *AWS CLI comandos*.
**nota**
Los clientes no pueden lanzar nuevas instancias del contenedor después del periodo de vencimiento del contrato. Sin embargo, durante la vigencia del contrato, pueden lanzar cualquier cantidad de instancias. Estas licencias no están vinculadas a un nodo o instancia específicos. Cualquier software que se ejecute en cualquier contenedor de cualquier nodo puede retirar la licencia siempre que tenga las credenciales asignadas de AWS .
**Creación de ofertas privadas**: los vendedores pueden generar ofertas privadas para los productos mediante la herramienta de creación de ofertas privadas en AWS Marketplace Management Portal.
**Informes**: puede configurar fuentes de datos configurando un bucket de Amazon S3 en la sección **Informes** en AWS Marketplace Management Portal. Para obtener más información, consulte [Informes, fuentes de datos y paneles de control del vendedor en AWS Marketplace](reports-and-data-feed.md).
### Integración de flujos de trabajo
Los siguientes pasos muestran el flujo de trabajo para integrar su producto de contenedor en AWS License Manager:
1. El vendedor crea un producto con AWS License Manager integración.
1. El vendedor publica el producto en AWS Marketplace.
1. El comprador encuentra el producto AWS Marketplace y lo compra.
1. Se envía una licencia al comprador en su Cuenta de AWS.
1. El comprador utiliza el software lanzando la instancia de Amazon EC2, la tarea de Amazon ECS o el software de pod de Amazon EKS. El cliente realiza la implementación mediante un rol de IAM.
1. El software lee la licencia en la AWS License Manager cuenta del comprador, descubre los derechos adquiridos y aprovisiona las funciones en consecuencia.
**nota**
License Manager no realiza ningún seguimiento ni actualización. De ello se encarga la aplicación del vendedor.