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 la 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 el servicio de medición AWS Marketplace para medir cada hora con productos en contenedores dentro. AWS Marketplace En las siguientes secciones, se muestra cómo configurar la medición por hora con AWS Marketplace Metering Service.
La RegisterUsage
API operación mide el uso de software por tarea de Amazon Elastic Container Service (AmazonECS) o por pod de Amazon Elastic Kubernetes Service (EKSAmazon), 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 del uso del software la gestiona automáticamente 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 registras el contenedor en las primeras 6 horas del lanzamiento del contenedor, AWS Marketplace Metering Service no ofrece ninguna garantía de medición para 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 Amazon ECS tasks y Amazon EKS pods, independientemente del estado de 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.
Temas
- Requisitos previos de medición por hora
- Formulario de carga de producto para la medición por hora
- Prueba del modo de integración y vista previa para RegisterUsage
- Control de errores para RegisterUsage
- Integración de su producto de contenedor con el servicio de medición AWS Marketplace mediante el AWS SDK for Java
Requisitos previos de medición por hora
Antes de publicar el producto, debe hacer lo siguiente:
-
Crea un nuevo producto contenedor en AWS Marketplace Management Portal el y anota su código de producto.
Para obtener más información, consulte Descripción general: Cree un producto en contenedor.
-
Utilice un rol AWS Identity and Access Management (IAM) para la tarea o el pod que ejecuta la aplicación con los IAM permisos necesarios para realizar la llamada
RegisterUsage
. La política IAM administradaAWSMarketplaceMeteringRegisterUsage
tiene estos permisos. -
(Opcional) Si desea ver el registro, le recomendamos que habilite el AWS CloudTrail registro en la definición de la tarea o el pod.
-
Realice una llamada de prueba a la
RegisterUsage
API operación con un registro de todas las dimensiones de precios que defina.
Formulario de carga de producto para la medición por hora
Al rellenar el formulario de carga del producto para la medición por hora, rellene los siguientes campos para su producto, además de los otros campos obligatorios y opcionales que definen su producto:
-
Precio por hora: el precio del producto por hora.
-
Tarifa dimensional a largo plazo: el precio total del software durante un contrato a largo plazo, cuando los compradores pagan por adelantado.
-
Duración a largo plazo (días): la duración, en días, del contrato a largo plazo.
Prueba del modo de integración y vista previa para RegisterUsage
Utilice la RegisterUsage
API operación para probar la integración antes de enviar la imagen AWS Marketplace para su publicación.
El modo de vista previa funciona de forma idéntica al modo de producción, excepto que el primero no realiza la verificación del derecho a utilizar el producto. Para llamar RegisterUsage
en modo de vista previa, llama RegisterUsage
desde la imagen del contenedor ejecutando tu producto en Amazon ECS o AmazonEKS. Usa la Cuenta de AWS que estás usando para publicar 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, lanza al menos una ECS tarea de Amazon o un EKS pod de Amazon que contenga tu contenedor de pago en la región EE.UU. Este (Virginia del Norte). De este modo, el equipo de AWS Marketplace operaciones puede verificar tu trabajo con los registros de esa región.
nota
Si tu producto es compatible con Amazon ECS y AmazonEKS, solo necesitas lanzarlo en Amazon EKS para que podamos validar tu 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 lo solicita, el equipo de operaciones del AWS Marketplace catálogo puede verificar la recepción de sus registros de medición en modo de vista previa.
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 inicio del contenedor, debe cerrar el contenedor para evitar su uso no autorizado.
Las excepciones que no ThrottlingException
sean las generadas solo en la llamada inicial a la RegisterUsage
API operación. Las llamadas posteriores desde la misma ECS tarea de Amazon o EKS pod de Amazon no se ejecutan CustomerNotSubscribedException
aunque el cliente cancele la suscripción mientras la tarea o el pod aún están en ejecución. 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 puede provocar la RegisterUsage
API operación. Cada lenguaje de AWS SDK programación tiene un conjunto de pautas de gestión de errores que puede 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 el uso de contadores desde la plataforma subyacente. Solo se admiten Amazon ECSEKS, Amazon y AWS Fargate yo. |
ThrottlingException
|
Las llamadas a RegisterUsage están restringidas. |
InvalidRegionException
|
RegisterUsage debe llamarse de la misma manera en Región de AWS que se lanzó la ECS tarea de Amazon o el EKS pod de Amazon. Esto impide que un contenedor elija una región (por ejemplo, withRegion(“us-east-1”) ) al llamar a RegisterUsage . |