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. # Precios de medición personalizada para productos de AMI con AWS Marketplace Metering Service Con AWS Marketplace Metering Service, puede modificar el software para enviar registros de mediciones a un punto de conexión para capturar el uso. Puede seleccionar una categoría de uso y definir hasta 24 dimensiones de esa categoría. Estas dimensiones se miden una vez cada hora, se acumulan y se cobran de acuerdo con el plan de precios que defina. Como vendedor, debe determinar la dimensión que desea utilizar. Una vez que se publique la AMI, ya no podrá cambiarla. En las siguientes secciones, se ofrece información acerca de AWS Marketplace Metering Service. **Topics** + [Conceptos del servicio de medición](#metering-service-concepts) + [Establecimiento del precio del software](#pricing-your-software) + [Añadir tu producto a AWS Marketplace](#listing-your-product-on-aws-marketplace) + [Modificación del software para usar el servicio de medición](#modifying-your-software-to-use-the-metering-service) + [Etiquetado medido por el proveedor (opcional)](#ami-vendor-metered-tagging) + [Configuración de medición personalizada](#configure-custom-metering) + [Configuración de la medición personalizada para los productos AMI con AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md) ## Conceptos del servicio de medición Antes de usar AWS Marketplace Metering Service, tenga en cuenta los siguientes conceptos de servicio importantes: + **Categoría de uso**: cualquier producto de software cuyo precio se base en el uso del servicio de medición se clasifica según una categoría de uso, que determina la forma adecuada de cobrar a los clientes. Las categorías de uso incluyen, pero no se limitan a: + **Usuarios**: un conjunto definido de permisos asociados a un solo identificador. Esta categoría es adecuada para el software al que los usuarios de un cliente se conectan directamente (por ejemplo, el software de administración de relaciones con el cliente o de informes de inteligencia empresarial). + **Hosts**: cualquier servidor, nodo, instancia, punto de enlace u otro componente de un sistema informático. Esta categoría es adecuada para el software que monitoriza o analiza muchas instancias propiedad del cliente (por ejemplo, para controlar su desempeño o su seguridad). + **Datos**: almacenamiento o información medidos en MB, GB o TB. Esta categoría es adecuada para software que administra datos almacenados o procesa datos en lotes. + **Ancho de banda**: medido en Mbps o Gbps. Esta categoría es adecuada para el software que permite a los clientes especificar la cantidad de ancho de banda que van a aprovisionar. + **Unidad**: unidad de medida; vea los ejemplos que se describen a continuación. + **Unidad de uso**: una unidad de uso específica del producto de software que se corresponde con la categoría de uso seleccionada. Esta unidad de uso describe la unidad por la que cobrará el software. Entre los ejemplos se incluyen: + **NodesHrs**(correspondiente a la categoría Anfitriones) + **UserHrs**(correspondiente a la categoría de usuario) + **GBStored**(correspondiente a la categoría de datos) + **Consumo**: el consumo de los productos de software cuyo precio se calcula mediante el servicio de medición se cargará de una de estas tres maneras: + Aprovisionado: el software permite a los clientes configurar una cantidad específica de recursos para su uso (por ejemplo, el número de usuarios o una cantidad fija de ancho de banda). Cada hora, se cargarán a los clientes los productos que hayan aprovisionado. + Concurrente: el software permite la conexión de cualquier número de hosts o usuarios diferentes. Cada hora, se cargará un precio a los clientes en función del número de hosts o usuarios que hayan tenido acceso al software. + Acumulado: el software permite a los clientes utilizar (procesar o almacenar) cualquier cantidad de datos. Cada hora, se cargará a los clientes la cantidad acumulada. + **Precios**: para los productos de software cuyo precio se calcula mediante el servicio de medición, se debe especificar un precio único o se deben definir hasta 24 dimensiones, cada una de ellas con su propio precio. Los detalles sobre las opciones de precios incluyen: + Dimensión única: se trata de la opción de precios más simple. Los clientes pagan un único precio por unidad de recurso por hora, independientemente del tamaño o el volumen (por ejemplo, 0,014 \$1 por usuario por hora o 0,070 \$1 por host por hora). + Varias dimensiones: esta opción de precios resulta apropiada cuando la categoría de uso seleccionada varía a lo largo de varios ejes. Por ejemplo, en el caso de monitoreo de host, se puede configurar un precio distinto en función del tamaño del host. O bien, para precios basados en los usuarios, se puede configurar un precio distinto en función del tipo de usuario (por ejemplo, administrador, usuario avanzado o usuario de solo lectura). + **Medición**: todo el uso se registra como un evento de medición, una vez cada hora. El software debe configurarse para enviar la dimensión y la cantidad de uso apropiadas al servicio de medición de AWS Marketplace. + Asignaciones: si lo desea, puede distribuir el uso en asignaciones por propiedades de las que realiza un seguimiento. Estas asignaciones se representan como etiquetas para el comprador. Las etiquetas permiten al comprador ver sus costes divididos en gastos de uso por etiqueta. Por ejemplo, si cobra por usuario y los usuarios tienen la propiedad “Departamento”, puede crear asignaciones de uso con etiquetas que tengan la clave “Departamento” y una asignación por valor. Este enfoque no cambia el precio, las dimensiones ni el uso total del que se informa. Sin embargo, permite a su cliente ver sus costes por categorías apropiadas para su producto. ## Establecimiento del precio del software Cuando ponga precios a su software con el servicio de medición de AWS Marketplace, primero debe decidirse por una categoría de uso y por cómo se consumirá. Este servicio admite seis casos de precios diferentes. Debe seleccionar únicamente uno de los siguientes elementos para su producto: + Usuario aprovisionado (por hora) + Usuario simultáneo (por hora) + Host aprovisionado (por hora) + Host simultáneo (por hora) + Ancho de banda aprovisionado (por hora) + Datos acumulados (por hora) A continuación debe decidir el precio de la categoría de uso seleccionada: + Único precio + Varias dimensiones (hasta 24) [Añadir tu producto a AWS Marketplace](#listing-your-product-on-aws-marketplace) describe cómo proporcionar una descripción fácil de recordar para los clientes de su dimensión y sus precios. ### Ejemplo: ancho de banda aprovisionado con precios no lineales Imagine que ofrece software de dispositivo de red. Elige facturar por ancho de banda proporcionado. Para su categoría de uso, seleccione **ancho de banda**. Además de cobrar por ancho de banda, quiere cargar otro precio cuando los compradores amplían sus productos. Puede definir varias dimensiones dentro de la categoría de ancho de banda. Puede definir un precio diferente para 25 Mbps, 100 Mbps y 1 Gbps. ### Ejemplo: hosts simultáneos con varias dimensiones Imagine que ofrece software que monitorea otras instancias Amazon EC2. En este caso ha elegido facturar por número de hosts que se monitorean. Para su categoría de uso, seleccione **Host**. Además de cobrar por host, puede interesarle cobrar por el valor adicional de monitorear hosts más grandes. Puede usar varias dimensiones dentro de la categoría de host. Puede definir un precio diferente para microinstancias, pequeñas instancias, instancias medianas, instancias extragrandes, 2XL, 4XL y 8XL. Su software es responsable de mapear cada host concreto a una de sus dimensiones definidas. Su software es el responsable de enviar un registro de medición independiente por cada dimensión de su categoría de su uso si procede. ## Añadir tu producto a AWS Marketplace Para aprovechar el servicio de medición, debes crear un nuevo producto para ponerlo AWS Marketplace a la venta. Si su producto ya está en el AWS Marketplace, tendrá que decidir si el nuevo producto de AWS Marketplace Metering Service estará disponible además del producto actual o si sustituirá a su producto actual como la única versión disponible para los nuevos usuarios. Si opta por la sustitución, el producto existente se eliminará de la AWS Marketplace versión para que deje de estar disponible para nuevos compradores. Los clientes existentes seguirán teniendo acceso a su antiguo producto e instancias, pero no podrán migrar al nuevo producto cuando así lo decidan. El nuevo producto debe medir el uso en el servicio de medición de AWS Marketplace, tal y como se describe en [Modificación del software para usar el servicio de medición](#modifying-your-software-to-use-the-metering-service). Una vez que tenga su AMI, siga el proceso estándar para compartir y analizar su AMI utilizando la herramienta de autoservicio. Además de utilizar la plantilla disponible en el portal de administración, debe cumplimentar el formulario de carga de producto y cargarlo para iniciar el proceso de adquisición. Utilice las siguientes definiciones para cumplimentar los campos del formulario de carga de producto del servicio de medición de AWS Marketplace. En el formulario de carga del producto, estos campos están etiquetados como **FCP (precios de consumo flexible)** para diferenciarlos de los productos que se cobran por hora y mensualmente. + **Título**: si ya tienes un producto AWS Marketplace y vas a añadir el mismo producto que él AWS Marketplace Metering Service, incluye la categoría y la dimensión del FCP entre paréntesis para diferenciarlas (por ejemplo, «TÍTULO DEL PRODUCTO (datos)»). + **Modelo de precios**: en la lista desplegable, elija **Uso**. + **Categoría FCP**: categoría en la que se cobran a los clientes los productos de pago con un componente de precios **Uso**. En la lista desplegable, seleccione **Usuarios**, **Hosts**, **Datos** o **Ancho de banda**. + **Unidad FCP**: unidad de medida por la que se cobrarán a los clientes los productos de pago con un componente de precios **Uso**. Las opciones aparecerán en la lista desplegable en función de la categoría de FCP que haya seleccionado. En la tabla siguiente se muestran las unidades válidas para cada categoría. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/marketplace/latest/userguide/custom-metering-pricing-ami-products.html) + **Nombre de dimensión de FCP**: el nombre utilizado al enviar registros de mediciones llamando a la operación `MeterUsage`. Este nombre está visible en los informes de facturación. Sin embargo, como no está orientado al exterior, no es necesario que el nombre sea fácil de recordar. El nombre no puede superar los 15 caracteres y solo pueden incluir caracteres alfanuméricos y guiones bajos. Una vez que haya establecido el nombre y hecho público el producto, no podrá cambiarlo. Para cambiar el nombre se necesita una nueva AMI. + **Descripción de la dimensión FCP**: declaración al cliente que describe la dimensión para el producto. La descripción no puede superar los 70 caracteres y debe ser fácil de recordar. Entre los ejemplos de descripciones se incluyen los siguientes: administradores por hora y por Mbps de ancho de banda aprovisionado. Después de publicar el producto, no puede cambiar esta descripción. + **Tarifa FCP**: el cargo de software por unidad para este producto. Este campo es compatible con ocho decimales. **Notas:** No es necesario rellenar los campos de precios por hora y anual. La prueba gratuita y los precios anuales no son compatibles. Los productos que utilizan una AMI y la función Clústeres y AWS recursos no pueden utilizar el servicio de medición de AWS Marketplace. El precio, el tipo de instancia o el Región de AWS cambio seguirán el mismo proceso que los demás AWS Marketplace productos. Los productos con el servicio de medición de AWS Marketplace no se pueden convertir a otros modelos de precios como por hora, mensual o Bring Your Own License (BYOL). AWS Marketplace recomienda añadir la información sobre la política de IAM en las instrucciones de uso o en el documento. Puede incluir hasta 24 dimensiones FCP en total. Una vez creadas y publicadas, no puede modificar las dimensiones existentes, pero puede agregar otras nuevas (hasta un límite de 24). Si tiene alguna pregunta, póngase en contacto con el equipo de [Operaciones de vendedores de AWS Marketplace](https://aws.amazon.com/marketplace/management/contact-us/). ## Modificación del software para usar el servicio de medición Tendrá que modificar su software para registrar el uso del cliente, enviar informes de uso por hora al servicio de medición y gestionar nuevos modos de error. El software opera con independencia de los precios, pero debe tener información sobre la categoría de uso, cómo se consume y todas las dimensiones. ### Medición del consumo Su software debe establecer cuánta cantidad de la categoría de uso seleccionada y qué dimensiones ha consumido el cliente. Este valor se enviará, una vez por cada hora, al servicio de medición de . En todos los casos, se presupone que el software tiene la capacidad de medir, registrar y leer el consumo de recursos con el objeto de enviarlo cada hora al servicio de medición. El consumo aprovisionado se suele leer en la configuración del software como un valor muestreado, aunque también puede ser un valor máximo configurado, registrado cada hora. El consumo simultáneas puede ser una muestra periódica o un valor máximo registrado cada hora. El consumo acumulado será un valor que se acumula cada hora. Para saber los precios de varias dimensiones, deben medirse varios valores y enviarlos al servicio de medición, uno por cada dimensión. Esto requiere que el software esté programado o configurado con el conjunto de dimensiones conocido cuando proporcione la AMI. El conjunto de dimensiones no puede cambiar una vez que el producto se ha creado. Para cada escenario de precios, en la siguiente tabla se describen las formas recomendadas de medir el consumo cada hora. | **Escenario** | **Cómo medirlo ** | | --- | --- | | Usuario aprovisionado | Número actual de usuarios aprovisionados (muestreados). - O BIEN - Número máximo de usuarios aprovisionados (vistos en esa hora). | | Usuario simultáneo | Número actual de usuarios simultáneos (muestreados). - O BIEN - Número máximo de usuarios simultáneos (vistos en esa hora). - O BIEN - Número total de usuarios diferenciados (vistos en esa hora). | | Host aprovisionado | Número actual de hosts aprovisionados (muestreados). - O BIEN - Número máximo de hosts aprovisionados (vistos en esa hora). | | Host simultáneo | Número actual de hosts simultáneos (muestreados). - O BIEN - Número máximo de hosts simultáneos (vistos en esa hora). - O BIEN - Número total de hosts diferenciados (vistos en esa hora). | | Ancho de banda aprovisionado | Valor del ancho de banda aprovisionado actual (muestreado). - O BIEN - Ancho de banda aprovisionado máximo (visto esa hora). | | Datos acumulados | GB de datos actualmente almacenados (muestreados). - O BIEN - Cantidad máxima de GB de datos almacenados (observados esa hora). - O BIEN - Cantidad total de GB de datos añadidos o procesados esa hora. - O BIEN - Cantidad total de GB de datos procesados esa hora. | ## Etiquetado medido por el proveedor (opcional) El etiquetado medido por el proveedor ayuda a los proveedores de software independientes (ISVs) a ofrecer al comprador una visión más detallada del uso que hacen del software y puede ayudarle a asignar los costes. Para etiquetar el uso de software de un comprador, es necesario determinar cómo se asignan los costes. En primer lugar, pregunte a sus compradores qué es lo que desean ver en su asignación de costes. A continuación, puede dividir el uso entre las propiedades de las que haga un seguimiento para la cuenta del comprador. Entre los ejemplos de propiedades se incluyen `Account ID`, `Business Unit`, `Cost Centers` y otros metadatos relevantes para su producto. Estas propiedades se exponen al comprador en forma de etiquetas. Con las etiquetas, los compradores pueden ver sus costes divididos en consumo según los valores de las etiquetas en su AWS consola de facturación (). [https://console.aws.amazon.com/costmanagement/](https://console.aws.amazon.com/costmanagement/) El etiquetado medido por el proveedor no cambia el precio, las dimensiones ni el uso total que declara. Permite a sus clientes ver sus costes por categorías adecuadas a su producto. En un caso de uso común, un comprador se suscribe a su producto con una Cuenta de AWS. El comprador también tiene varios usuarios asociados a la misma suscripción de producto. Puede crear asignaciones de uso con etiquetas que tengan una clave de `Account ID` y, a continuación, asignar el uso a cada usuario. En este caso, los compradores pueden activar la etiqueta `Account ID` en su consola de administración de costes y facturación, y analizar el uso individual de los usuarios. ### Experiencia del vendedor Los vendedores pueden agregar los registros de medición de los recursos con el mismo conjunto de etiquetas en lugar de agregar el uso de todos los recursos. Por ejemplo, los vendedores pueden crear un registro de medición que incluya diferentes grupos de `UsageAllocations`. Cada bucket representa `UsageQuantity` para un conjunto de etiquetas, como `AccountId` y `BusinessUnit`. En el siguiente diagrama, **Recurso 1** tiene un conjunto único de etiquetas `AccountId` y `BusinessUnit`, y aparece en el **Registro de medición** como una entrada única. Tanto **Recurso 2** como **Recurso 3** tienen la misma etiqueta de `AccountId`, `2222`, y la misma etiqueta de `BusinessUnit`, `Operations`. Como resultado, se combinan en una sola entrada de `UsageAllocations` en el **Registro de medición**. ![\[Diagrama que muestra cómo las etiquetas de medición de los vendedores combinan los datos de uso. Tres recursos (los recursos 1, 2 y 3) BusinessUnits son diferentes AccountIds y se consolidan en un solo registro de medición UsageAllocations agrupados por AccountId y BusinessUnit antes de enviarlos al AWS Marketplace Metering Service.\]](http://docs.aws.amazon.com/es_es/marketplace/latest/userguide/images/seller-vendor-meter-tag.png) Los vendedores también pueden combinar los recursos sin etiquetas en una sola `UsageAllocation` con la cantidad de uso asignada y enviarlos como una de las entradas en `UsageAllocations`. Los límites incluyen: + Número de etiquetas: 5 + Tamaño de `UsageAllocations` (cardinalidad): 2500 La validación incluye lo siguiente: + Se admiten caracteres para la clave y el valor de la etiqueta: 0-9\$1 -= a-zA-Z . \$1:\$1 /@ + Número máximo de etiquetas en la lista de `UsageAllocation`: 5 + Dos `UsageAllocations` no pueden tener las mismas etiquetas (es decir, la misma combinación de claves y valores de etiqueta). Si ese es el caso, deben usar la misma `UsageAllocation`. + La suma de `AllocatedUsageQuantity` de `UsageAllocation` debe ser igual a `UsageQuantity`, que es el uso agregado. ### Experiencia del comprador En la siguiente tabla se muestra un ejemplo de la experiencia del comprador después de activar las etiquetas de proveedor `AccountId` y `BusinessUnit`. En este ejemplo, el comprador puede ver el uso asignado en su **Informe de uso de costes**. Las etiquetas medidas por el proveedor utilizan el prefijo `“aws:marketplace:isv”`. Los compradores pueden activarlas en la consola de administración de costes y facturación, en **Etiquetas de asignación de costes**, **Etiquetas de asignación de costes generadas por AWS**. La primera y la última fila del **Informe de uso de costes** son relevantes para lo que el vendedor envía al servicio de medición (como se muestra en el ejemplo [Experiencia del vendedor](container-metering-meterusage.md#container-vendor-metered-tag-seller)). **Informe de uso de costes (simplificado)** | ProductCode | Comprador | UsageDimension | UsageQuantity | `aws:marketplace:isv:AccountId ` | `aws:marketplace:isv:BusinessUnit` | | --- | --- | --- | --- | --- | --- | | xyz | 111122223333 | Red: por (GB) inspeccionado | 70 | 2222 | Operaciones | | xyz | 111122223333 | Red: por (GB) inspeccionado | 30 | 3333 | Finanzas | | xyz | 111122223333 | Red: por (GB) inspeccionado | 20 | 4444 | TI | | xyz | 111122223333 | Red: por (GB) inspeccionado | 20 | 5555 | Marketing | | xyz | 111122223333 | Red: por (GB) inspeccionado | 30 | 1111 | Marketing | Para ver un ejemplo del código, consulte [`MeterUsage` con etiquetado de asignación de uso (opcional)](custom-metering-with-mp-metering-service.md#ami-meterusage-code-example). ## Configuración de medición personalizada Para obtener más información acerca de cómo trabajar con AWS Marketplace Metering Service, consulte [Configuración de la medición personalizada para los productos AMI con AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md). # Configuración de la medición personalizada para los productos AMI con AWS Marketplace Metering Service **nota** En el caso de los productos basados en AMI con precios de medición personalizados, el software debe llamar a la [MeterUsage API](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-metering_MeterUsage.html) con AWS las credenciales temporales del rol de IAM para Amazon Elastic Compute Cloud adjunto a la instancia de Amazon EC2. No se admiten claves de acceso a largo plazo. El servicio AWS Marketplace Metering Service es una característica de precios y medición que puede utilizar para cobrar directamente su software por categoría de uso. Hay cinco categorías de uso: usuarios, datos, ancho de banda, hosts o unidad. Puede utilizar el servicio de medición con productos basados en Imagen de máquina de Amazon (AMI), contenedores y software como servicio (SaaS). En las siguientes secciones, se ofrece información acerca de cómo configurar la medición personalizada con AWS Marketplace Metering Service. El servicio de medición de AWS Marketplace posibilita varios escenarios nuevos. Por ejemplo, si el software monitoriza hosts, puede cobrar por host monitorizado. Puede tener distintos precios en función del tamaño del host y cobrar por el número de hosts simultáneos que se monitorizan cada hora. Del mismo modo, si el software permite que varios usuarios de una organización inicien sesión, puede cobrar por el número de usuarios. Cada hora se carga al cliente el número total de usuarios aprovisionados. Para obtener más información, consulte la [https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html). Para obtener más información sobre la integración de la AWS Marketplace Metering Service API para productos basados en AMI con precios de medición personalizados, consulta el laboratorio Lista de [productos AMI con precios por unidades personalizadas](https://catalog.workshops.aws/mpseller/en-US/ami/list-ami-custom-units) del taller del *AWS Marketplace vendedor*. **Topics** + [Requisitos](#metering-service-requirements) + [Llamada al a servicio de medición de AWS Marketplace](#call-aws-marketplace-metering-service) + [Administración de errores](#important-information-about-failure-handling) + [Limitaciones](#limitations) + [Ejemplo de código](#ami-metering-code-example) ## Requisitos Todo el software en AMI que utiliza el servicio de medición debe cumplir los requisitos siguientes: + El software debe lanzarse desde AWS Marketplace una Amazon Machine Image (AMI). + Si ya tiene un producto AWS Marketplace, debe enviar una AMI nueva y crear uno nuevo para habilitar esta función. + Todo el software debe estar aprovisionado con una función AWS Identity and Access Management (IAM). El cliente final deberá añadir un rol de IAM a la instancia de Amazon Elastic Compute Cloud (Amazon EC2) que el usuario esté aprovisionando con el software. El uso de una función de IAM es opcional al implementar el software a través de él. AWS Marketplace Es obligatorio cuando se implementa el software del servicio de medición de AWS Marketplace. + Debe ser capaz de determinar el consumo de algún modo. ## Llamada al a servicio de medición de AWS Marketplace Su software debe llamar al servicio de medición cada hora y registrar el valor de consumo de dicha hora. Cuando se inicia el software, debe registrar el punto minute-of-the-hour en el que se inició. Esto se denomina el *minuto de comienzo*. Cada vez que se cumpla una hora en relación con el minuto de comienzo, el software debe determinar el valor de consumo para dicha hora y llamar al servicio de medición. Para obtener información sobre cómo obtener este valor, consulte [Modificación del software para utilizar el servicio de medición](https://docs.aws.amazon.com/marketplace/latest/userguide/custom-metering-pricing-ami-products.html#modifying-your-software-to-use-the-metering-service). Para activarse cada hora según el minuto de comienzo, su software debe aplicar uno de los métodos siguientes: + Un subproceso dentro de su software. + Un proceso daemon que se inicie con la instancia o el software. + Un trabajo cron configurado durante el arranque de la aplicación. **nota** Su software debe llamar al servicio de medición de AWS Marketplace con la función de IAM configurada en la instancia del cliente y especificar la dimensión de consumo y la cantidad. Su software puede usar el AWS SDK para llamar al AWS Marketplace Metering Service, de forma similar a la implementación de ejemplo siguiente: 1. Use el perfil de instancia para crear un cliente de servicio. Esto requiere el rol configurado para la instancia EC2. El SDK actualiza de forma automática las credenciales del rol. 1. Cada hora lea la configuración y el estado del software para determinar los valores de consumo para esa hora. Esto podría incluir la recopilación de un value-per-dimension. 1. Llame al método `meterUsage` del cliente SDK con los siguientes parámetros (llamada adicional para cada dimensión con uso): + `timestamp`: marca de tiempo de la hora que se registra (en UTC). + `productCode`: código de producto asignado al software. + `dimension`: dimensión (o dimensiones) asignada al software. + `quantity`: valor de consumo de la hora. + `allocations`: (Opcional) puede proporcionar asignaciones para el uso entre las propiedades de las que realiza un seguimiento. Estas asignaciones deben sumarse al consumo total del registro. Para el comprador, se muestran como posibles etiquetas de asignación de costes en sus herramientas de facturación (como la Administración de facturación y costos de AWS consola). El comprador debe activar las etiquetas en su cuenta para poder hacer un seguimiento de sus costes con estas etiquetas. Además el software debe llamar a un punto de conexión del servicio de medición de AWS Marketplace de la región. El producto debe tener una configuración de punto de conexión regional correcta, para que `us-east-1` envíe los registros al punto de conexión `us-east-1` y `us-west-2` envíe los registros al punto de conexión `us-west-2`. Las llamadas intrarregionales dan a los compradores una experiencia más estable y evitan que se produzcan situaciones en las que la disponibilidad de una región no relacionada afecte a un software que se ejecuta en otra región. Al enviar los registros de mediciones al servicio, debe conectarse al servicio de medición de AWS Marketplace de su región. Utilice el método de ayudante `getCurrentRegion()` para establecer la región en la que se está ejecutando la instancia EC2 y pase esta información de región al constructor `MeteringServiceClient`. Si no especificas ninguna Región de AWS en el constructor del SDK, se utilizará `us-east-1` la región predeterminada. Si la aplicación intenta realizar las llamadas al servicio entre regiones, estas se rechazan. Para obtener más información, consulte [Determinar la región actual de una aplicación](https://java.awsblog.com/post/Tx3GBOIEN1JJMQ5/Determining-an-Application-s-Current-Region) y [getCurrentRegion()](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/regions/Regions.html#getCurrentRegion()). ## Administración de errores El producto debe enviar los registros de mediciones al servicio, un punto de enlace de Internet público, para que se pueda capturar y facturar el uso. Como es posible que un cliente pueda modificar los ajustes de red de forma que impida que los registros de mediciones se entreguen, el producto debe tener en cuenta esta posibilidad y elegir un modo de error. **nota** Algunos errores de medición pueden ser problemas transitorios al conectarse al. AWS Marketplace Metering Service AWS Marketplace recomienda encarecidamente implementar los reintentos durante un máximo de 30 minutos, con una reducción exponencial, para evitar interrupciones de corta duración o problemas de red. Normalmente, se puede producir un error de apertura (se proporciona un mensaje de advertencia, pero se mantiene la funcionalidad completa) o un error de cierre (se deshabilita toda la funcionalidad de la aplicación hasta que se restablece una conexión). Puede optar por un error de apertura, de cierre o algo específico de su aplicación. Le recomendamos encarecidamente que se abstenga de aplicar un error de cierre después de menos de dos horas de errores de medición. Como ejemplo de error parcialmente abierto, puede seguir permitiendo el acceso al software, pero no permitir que el comprador modifique la configuración del software. O bien un comprador puede seguir teniendo acceso al software, pero no podrá crear usuarios adicionales. Su software es responsable de definir y aplicar este modo de error. El modo de error de su software debe estar incluido cuando envía la AMI y no se puede cambiar más adelante. ## Limitaciones Tenga en cuenta estas limitaciones a la hora de diseñar y publicar software habilitado para el servicio de medición: + **Requisitos de rol de IAM y puerta de enlace de Internet para los clientes**: los clientes deben tener una puerta de enlace de Internet y deben lanzar el software con un rol de IAM y unos permisos específicos. Para obtener más información, consulte [AWS Marketplace permisos de API de medición y asignación de derechos](iam-user-policy-for-aws-marketplace-actions.md). El software no puede conectarse al servicio de medición si no se cumplen estas dos condiciones. + **Imposibilidad de añadir una nueva categoría o cambiar la categoría de uso a un producto de servicio de medición**: cuando los clientes se suscriben a un producto de software, aceptan una serie de términos y condiciones. El cambio de categorías de uso de los productos con el servicio de medición requiere un producto nuevo y una suscripción nueva. + **Imposibilidad de cambiar dimensiones en un producto de servicio de medición existente**: cuando los clientes se suscriben a un producto de software, aceptan una serie de términos y condiciones. El cambio de las dimensiones de los productos con el servicio de medición requiere un producto nuevo y una suscripción nueva. *Puede* añadir nuevas dimensiones a los productos existentes, hasta un límite de 24. + **Inexistencia de prueba gratuita y suscripciones anuales**: los productos que hacen uso del servicio de medición no admiten pruebas gratuitas ni suscripciones anuales en el momento del lanzamiento. + **Consideraciones sobre la implementación en varias instancias o basada en clúster**: algunos productos de software se implementan formando parte de una implementación de varias instancias. Al diseñar software, tenga en cuenta cómo y dónde se mide el consumo y dónde se emiten los registros de mediciones. ## Ejemplo de código El siguiente ejemplo de código se proporciona para ayudarlo a integrar su producto de AMI con AWS Marketplace APIs lo necesario para publicar y mantener su producto. ### `MeterUsage` con etiquetado de asignación de uso (opcional) El siguiente ejemplo de código es relevante para productos de AMI con modelos de precios de consumo. El ejemplo de Python envía un registro de medición con las etiquetas de asignación de uso adecuadas AWS Marketplace para cobrar pay-as-you-go las tarifas a sus clientes. ``` # NOTE: Your application will need to aggregate usage for the # customer for the hour and set the quantity as seen below. # AWS Marketplace can only accept records for up to an hour in the past. # # productCode is supplied after the AWS Marketplace Ops team has # published the product to limited # Import AWS Python SDK import boto3 import time usageRecord = [ { "AllocatedUsageQuantity": 2, "Tags": [ { "Key": "BusinessUnit", "Value": "IT" }, { "Key": "AccountId", "Value": "123456789" }, ] }, { "AllocatedUsageQuantity": 1, "Tags": [ { "Key": "BusinessUnit", "Value": "Finance" }, { "Key": "AccountId", "Value": "987654321" }, ] } ] marketplaceClient = boto3.client("meteringmarketplace") response = marketplaceClient.meter_usage( ProductCode="testProduct", Timestamp=int(time.time()), UsageDimension="Dimension1", UsageQuantity=3, DryRun=False, UsageAllocations=usageRecord ) ``` Para obtener más información al respecto`MeterUsage`, consulte la [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html)referencia de la *API del servicio de AWS Marketplace medición*. ### Ejemplo de respuesta ``` { "MeteringRecordId": "string" } ```