Configuración de medición por hora con AWS Marketplace Metering Service - AWS Marketplace
Requisitos previos de medición por horaProbando la integración para RegisterUsageControl de errores para RegisterUsage

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.

Configuración de medición por hora con AWS Marketplace Metering Service

Si el producto de contenedor utiliza precios de tareas o por pod por hora en lugar de dimensiones de precios medidos personalizadas, no es necesario definir dimensiones de medición personalizadas. Puede utilizar AWS Marketplace Metering Service para la medición por hora con productos de contenedores en AWS Marketplace. En las siguientes secciones, se muestra cómo configurar la medición por hora con AWS Marketplace Metering Service.

La operación de API RegisterUsage mide el uso del software por tarea de Amazon Elastic Container Service (Amazon ECS) o por pod de Amazon Elastic Kubernetes Service (Amazon EKS), por hora, con el uso prorrateado al segundo. En el caso de las tareas o los pods que tienen una vida útil muy corta, se aplica un uso mínimo de un minuto. La medición continua para el uso del software es gestionada automáticamente por el AWS Marketplace Metering Control Plane. No es necesario que el software realice ninguna acción específica de medición, excepto llamar RegisterUsage una vez para comenzar a medir el uso del software.

Se debe llamar a RegisterUsage inmediatamente al momento de lanzar un contenedor. Si no registra el contenedor en las primeras 6 horas desde su lanzamiento, el servicio de medición de AWS Marketplace no ofrece ninguna garantía de medición respecto a los meses anteriores. Sin embargo, la medición continuará durante el mes en curso hasta que finalice el contenedor.

El AWS Marketplace Metering Control Plane sigue facturando a los clientes por la ejecución de las tareas de Amazon ECS y los pods de Amazon EKS, independientemente del estado de la suscripción del cliente. Esto elimina la necesidad de que el software realice comprobaciones de derechos tras el lanzamiento inicial correcto de la tarea o el pod.

Para obtener más información sobre la integración de la AWS Marketplace Metering Service API con productos de contenedores con precios por hora, consulte el laboratorio sobre cómo integrar la medición por hora del taller para AWS Marketplace vendedores.

Temas

Requisitos previos de medición por hora

Antes de publicar el producto, debe hacer lo siguiente:

  1. Cree un nuevo producto contenedor en el AWS Marketplace Management Portal y anote su código de producto.

    Para obtener más información, consulte Descripción general: creación de un producto de contenedor.

  2. Utilice un rol AWS Identity and Access Management (IAM) para la tarea o el pod que ejecuta la aplicación con los permisos de IAM necesarios para realizar la llamada. RegisterUsage La política administrada de AWSMarketplaceMeteringRegisterUsage tiene estos permisos. Para obtener más información sobre la política, consulte la Referencia AWSMarketplaceMeteringFullAccessde políticas AWS gestionadas.

  3. (Opcional) Si desea ver el registro, le recomendamos que habilite el AWS CloudTrail registro en la definición de la tarea o el módulo.

  4. Realice una llamada de prueba a la operación de API RegisterUsage con un registro para todas las dimensiones de precios que defina.

Probando la integración para RegisterUsage

Usa la operación de la RegisterUsage API para probar la integración antes de enviar la imagen AWS Marketplace para su publicación.

Llama RegisterUsage desde la imagen del contenedor ejecutando tu producto en Amazon ECS o Amazon EKS. Usa la AWS cuenta en la que estás publicando el producto AWS Marketplace. Su integración de medición debe configurarlo de forma dinámica Región de AWS, en lugar de codificarlo de forma rígida. Sin embargo, al realizar las pruebas, lance al menos una tarea de Amazon ECS o un pod de Amazon EKS que contenga su contenedor de pago en la región del Este de EE. UU. (Virginia del Norte). De este modo, el equipo de AWS Marketplace operaciones puede verificar su trabajo con los registros de esa región.

nota

Si el producto es compatible con Amazon ECS y con Amazon EKS, bastará con que realice el lanzamiento solo en Amazon EKS para que podamos validar la integración.

No puede probar totalmente la integración hasta que el producto se publique con todos los metadatos y la información de precios correspondiente. Si se solicita, el equipo de operaciones del AWS Marketplace catálogo puede verificar la recepción de sus registros de medición.

Control de errores para RegisterUsage

Si la imagen del contenedor se integra con el contenedor AWS Marketplace Metering Service y recibe una excepción que no sea ThrottlingException al arrancar el contenedor, debe cerrar el contenedor para evitar su uso no autorizado.

Las excepciones distintas de ThrottlingException se lanzan solo en la llamada inicial a la operación de API RegisterUsage. Las llamadas posteriores desde la misma tarea de Amazon ECS o pod de Amazon EKS no iniciarán la excepción CustomerNotSubscribedException, ni siquiera aunque el cliente cancele la suscripción mientras la tarea se está ejecutando. A estos clientes se les sigue cobrando la ejecución de los contenedores después de darse de baja y se realiza un seguimiento de su uso.

En la siguiente tabla se describen los errores que la operación de API RegisterUsage podrían lanzar. Cada lenguaje de programación del AWS SDK tiene un conjunto de pautas de gestión de errores que puedes consultar para obtener información adicional.

Error Descripción
InternalServiceErrorException RegisterUsage no está disponible.
CustomerNotEntitledException El cliente no tiene una suscripción válida para el producto.
InvalidProductCodeException El valor de ProductCode que se pasa como parte de la solicitud no existe.
InvalidPublicKeyException El valor de PublicKeyVersion que se pasa como parte de la solicitud no existe.
PlatformNotSupportedException AWS Marketplace no admite la medición del uso de la plataforma subyacente. Solo se admiten Amazon ECS y AWS Fargate Amazon EKS.
ThrottlingException Las llamadas a RegisterUsage están restringidas.
InvalidRegionException RegisterUsagedebe llamarse de la misma manera en Región de AWS que se lanzó la tarea de Amazon ECS o el pod de Amazon EKS. Esto impide que un contenedor elija una región (por ejemplo, withRegion(“us-east-1”)) al llamar a RegisterUsage.