Todos los productos
Search
Centro de documentos

Compute Nest:PushMeteringData - Push metering data

Última actualización: Sep 05, 2026

Envía datos de medición desde el interior de una instancia de servicio.

Notas de uso

  • Esta operación envía datos de medición únicamente para instancias de servicio de Compute Nest con modelo pay-as-you-go. El método de reporte de los elementos facturables debe configurarse como Reported by Service Provider.

  • Para las instancias de ECS o ACK creadas por un servicio de Compute Nest, puede llamar a esta operación directamente desde la instancia para enviar los datos de medición. Para llamar a esta operación mediante OpenAPI, consulte Call PushMeteringData by using OpenAPI.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

Metering

String

Sí

Los datos de medición en formato de cadena JSON. Incluye los siguientes parámetros:

  • StartTime: hora de inicio del periodo de medición, especificada como marca de tiempo UNIX en segundos.

  • EndTime: hora de finalización del periodo de medición, especificada como marca de tiempo UNIX en segundos.

  • Entities: entidades de medición.

    • Key: nombre del elemento facturable. Los valores válidos incluyen:

      • Frequency: número de veces que se utilizó el servicio.

      • Period: duración del uso. Unidad: segundos.

        Importante

        La unidad de este parámetro es segundos, pero la unidad de facturación son horas. El sistema convierte los segundos a horas para la facturación. Por ejemplo, si reporta un uso de 1,800 segundos entre las 19:00 y las 20:00 con una tarifa de USD 1 por hora, el cargo horario se calcula como (1800 / 3600) × 1 = USD 0.5. El resultado se trunca a dos decimales.

      • Storage: espacio de almacenamiento utilizado. Unidad: bytes.

        Importante

        La unidad de este parámetro es bytes, pero la unidad de facturación son megabytes (MB). El sistema convierte los bytes a MB para la facturación. Por ejemplo, si reporta un uso de 524,288 bytes entre las 19:00 y las 20:00 con una tarifa de USD 1 por MB, el cargo horario se calcula como (524288 / 1024 / 1024) × 1 = USD 0.5. El resultado se trunca a dos decimales.

      • NetworkOut: tráfico saliente. Unidad: bytes.

        Importante

        La unidad de este parámetro es bytes, pero la unidad de facturación son megabytes (MB). El sistema convierte los bytes a MB para la facturación. Por ejemplo, si reporta un uso de 524,288 bytes entre las 19:00 y las 20:00 con una tarifa de USD 1 por MB, el cargo horario se calcula como (524288 / 1024 / 1024) × 1 = USD 0.5. El resultado se trunca a dos decimales.

      • NetworkIn: tráfico entrante. Unidad: bytes.

        Importante

        La unidad de este parámetro es bytes, pero la unidad de facturación son megabytes (MB). El sistema convierte los bytes a MB para la facturación. Por ejemplo, si reporta un uso de 524,288 bytes entre las 19:00 y las 20:00 con una tarifa de USD 1 por MB, el cargo horario se calcula como (524288 / 1024 / 1024) × 1 = USD 0.5. El resultado se trunca a dos decimales.

      • Character: número de caracteres.

      • DailyActiveUser: número de usuarios activos diarios (DAU).

      • PeriodMin: duración del uso. Unidad: minutos.

      • VirtualCpu: número de núcleos vCPU.

        • Unit: número de unidades.

        • Memory: tamaño de memoria en GB.

    • Value: valor medido. Debe ser un número entero no negativo.

Nota
  • Si el producto se factura en tiempo real, puede especificar cualquier rango de tiempo, pero EndTime debe ser posterior a StartTime.

  • Si el producto se factura por ciclo (por ejemplo, cada hora, diario o mensual), el intervalo entre StartTime y EndTime debe ser mayor a 5 minutos.

[{"StartTime":"1664451045","EndTime":"1664451198","Entities":[{"Key":"Frequency","Value":"6"}]}]

Token

String

Sí

Token que Compute Nest utiliza para comprobar que la solicitud proviene de un proveedor de servicios legítimo.

El token es el hash MD5 en minúsculas de 32 caracteres de una cadena. Esta cadena se construye al concatenar la cadena JSON de Metering, un signo et (&) y su clave de servicio. Conceptualmente, estos componentes se representan como Metering&Key.

  • Metering: valor del parámetro Metering. Ejemplo: [{"StartTime":"1664451045","EndTime":"1664451198","Entities":[{"Key":"Frequency","Value":"6"}]}]. Para obtener más información, consulte la descripción del parámetro Metering.

  • Key: clave del servicio. Ejemplo: e98893f5ecc3ae1ctest. Puede obtener la clave del servicio en la página de detalles del servicio.

    Nota

    La clave del servicio es única y no cambia con las versiones del servicio.

  • Cadena a la que se aplicará el hash: Metering=[{"StartTime":"1664451045","EndTime":"1664451198","Entities":[{"Key":"Frequency","Value":"6"}]}]&Key=e98893f5ecc3ae1ctest

  • Token resultante: 7aa81300b2aea77984b772495c8e4e83

Parámetros de respuesta

Parámetro

Tipo

Descripción

Ejemplo

RequestId

String

Identificador de la solicitud que devuelve Compute Nest.

e6862d3a-9305-4289-8dd3-9c52a680228b

Success

Boolean

Indica si la solicitud fue exitosa.

true

PushMeteringDataRequestId

String

Identificador de la solicitud que devuelve Alibaba Cloud Marketplace.

7lc658a2-tr41---c25es45vc248

Token

String

Firma digital devuelta. Puede usar este token para verificar la respuesta. Para obtener más información, consulte Verify a digital signature from Compute Nest.

50130a063c6acf833280d23169898bd4

Ejemplos

Este ejemplo muestra cómo llamar a la operación desde una instancia de ECS creada por un servicio pay-as-you-go de Compute Nest en Alibaba Cloud Marketplace.

Ejemplo con curl

  1. Obtenga el identificador de región de la instancia de ECS

    Antes de llamar a esta operación, obtenga el identificador de región de la instancia de ECS donde está desplegada su aplicación. Necesitará este identificador en un paso posterior.

    1. Ejecute el siguiente comando para consultar el identificador de región en el servicio de metadatos de la instancia:

      curl http://100.100.100.200/latest/meta-data/region-id
    2. Respuesta de ejemplo:

      cn-hangzhou
  2. Prepare los parámetros

    "Metering":"[{\"StartTime\":\"1664451045\",\"EndTime\":\"1664451198\",\"Entities\":[{\"Key\":\"Frequency\",\"Value\":\"6\"}]}]","Token":"7aa81300b2aea77984b772495c8e4e83"

    • Metering: [{\"StartTime\":\"1664451045\",\"EndTime\":\"1664451198\",\"Entities\":[{\"Key\":\"Frequency\",\"Value\":\"6\"}]}]

      Nota

      Dado que este ejemplo usa un comando curl, la cadena JSON del parámetro Metering debe escaparse con el carácter \. Si llama a la operación desde su código, no es necesario escapar la cadena.

    • Token: genere el token al crear un hash MD5 en minúsculas de 32 caracteres de la cadena que concatena el JSON Metering convertido a cadena, un signo et (&) y su clave de servicio. El token de este ejemplo es 7aa81300b2aea77984b772495c8e4e83.

  3. Envíe la solicitud

    curl -H "Content-Type: application/json" -XPOST https://cn-hangzhou.axt.aliyun.com/computeNest/marketplace/push_metering_data -d '{"Metering":"[{\"StartTime\":\"1664451045\",\"EndTime\":\"1664451198\",\"Entities\":[{\"Key\":\"Frequency\",\"Value\":\"6\"}]}]","Token":"7aa81300b2aea77984b772495c8e4e83"}'
    Nota

    En https://cn-hangzhou.axt.aliyun.com, cn-hangzhou es la región que obtuvo en Step 1. Cuando haga la llamada, reemplace la información de la región con su región real.

  4. Consulte la respuesta

    {
        "RequestId":"4ca591b5-bc30-****-****-c4d0ec5d24ed", 
        "Success":"true",
        "PushMeteringDataRequestId":"7lc658a2-tr41-****-****-c25es45vc248", 
        "Token":"50130a063c6acf833280d23169898bd4"
    }

Ejemplos de código

Python

import requests
import json
import hashlib
import time
import sys
from urllib.request import urlopen
def get_region_id():
    """Gets the region ID from the Alibaba Cloud instance metadata service."""
    try:
        with urlopen(
            "http://100.100.100.200/latest/meta-data/region-id",
            timeout=2
        ) as response:
            return response.read().decode().strip()
    except Exception as e:
        print(f"Failed to get region ID: {str(e)}", file=sys.stderr)
        sys.exit(1)
def push_metering_data(entities_map, service_key):
    # Get the current time as a UNIX timestamp in seconds.
    current_time = int(time.time())
    start_time = current_time 
    end_time = current_time + 1
    # Construct the Metering data.
    metering_data = [
        {
            "StartTime": str(start_time),
            "EndTime": str(end_time),
            "Entities": [
                {"Key": key, "Value": str(value)} 
                for key, value in entities_map.items()
            ]
        }
    ]
    metering_str = json.dumps(metering_data)
    # Get the region ID and construct the request URL.
    region_id = get_region_id()
    url = f"https://{region_id}.axt.aliyun.com/computeNest/marketplace/push_metering_data"
    # Calculate the token.
    token_str = metering_str + "&" + service_key
    token = hashlib.md5(token_str.encode()).hexdigest().lower()
    # Send the POST request.
    try:
        response = requests.post(
            url,
            json={
                "Metering": metering_str,
                "Token": token
            },
            headers={"Content-Type": "application/json"}
        )
        print(f"Request URL: {url}")
        print(f"Status Code: {response.status_code}")
        print(f"Response: {response.text}")
    except Exception as e:
        print(f"Request Failed: {str(e)}", file=sys.stderr)
if __name__ == "__main__":
    # Sample parameters. Replace the key with your billable item and the value with the metered quantity.
    entities = {
        "Frequency": "6"
    }
    # Your service key.
    service_key = "your_service_key_here"
    # Call the function.
    push_metering_data(entities, service_key)

Ejecución de ejemplo:

[root@xxx aZ ~]# vim push.py
[root@xxx aZ ~]# python3 push.py
Request URL: https://cn-hangzhou.axt.aliyun.com/computeNest/marketplace/push_metering_data
Status Code: 200
Response: {"code":200,"requestId":"5979658a-7d11-4c61-xxx","instanceId":"i-bp140hj xxx","result":{"RequestId":"B3588CBD-6C3F-51C7-xxx","PushMeteringDataRequestId":"88D8CADB-2417-5417-504-xxx","Token":"xxx"},"Success":true}

Java

import org.json.JSONArray;
import org.json.JSONObject;
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.security.MessageDigest;
import java.util.HashMap;
import java.util.Map;     
public class MeteringPusher {
    public static void main(String[] args) {
        try {
            // Get the region ID dynamically.
            String regionId = getRegionId();
            System.out.println("Detected Region ID: " + regionId);
            // Construct the request body.
            Map<String, String> entities = new HashMap<>(); // Construct the Entities. Replace with your actual data.
            entities.put("Frequency", "6");
            String serviceKey = "your_service_key_here"; // Replace with your actual service key.
            JSONObject payload = generateDynamicRequest(regionId, entities, serviceKey);
            String paylodString = payload.toString();
            // For testing purposes, you can comment out the dynamic generation and use a static payload string. Remember to replace the parameters.
            // String paylodString = "{\"Metering\":\"[{\\\"StartTime\\\":\\\"1664451045\\\",\\\"EndTime\\\":\\\"1664451198\\\",\\\"Entities\\\":[{\\\"Key\\\":\\\"Frequency\\\",\\\"Value\\\":\\\"6\\\"}]}]\",\"Token\":\"7aa81300b2aea77984b772495c8e4e83\"}";
            // Send the POST request.
            String urlStr = "https://" + regionId + ".axt.aliyun.com/computeNest/marketplace/push_metering_data";
            URL url = new URL(urlStr);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("POST");
            conn.setRequestProperty("Content-Type", "application/json");
            conn.setDoOutput(true);
            try (OutputStream os = conn.getOutputStream()) {
                byte[] input = paylodString.getBytes("UTF-8");
                os.write(input, 0, input.length);
            }
            // Read the response.
            BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            StringBuilder response = new StringBuilder();
            String responseLine;
            while ((responseLine = br.readLine()) != null) {
                response.append(responseLine);
            }
            conn.disconnect();
            System.out.println("Response: " + response.toString());
            System.out.println("Request URL: " + urlStr);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    // Get the region ID from the Alibaba Cloud instance metadata service.
    private static String getRegionId() throws Exception {
        String regionIdUrl = "http://100.100.100.200/latest/meta-data/region-id";
        HttpURLConnection conn = (HttpURLConnection) new URL(regionIdUrl).openConnection();
        conn.setRequestMethod("GET");
        conn.setConnectTimeout(2000); // 2-second timeout
        conn.setReadTimeout(2000);
        try (BufferedReader in = new BufferedReader(
            new InputStreamReader(conn.getInputStream()))) {
            return in.readLine().trim();
        }
    }
    //  Generate the request data dynamically.
    private static JSONObject generateDynamicRequest(String regionId, Map<String, String> entities, String serviceKey) throws Exception {
        // Get the current timestamp.
        long currentTime = System.currentTimeMillis() / 1000;
        long startTime = currentTime;
        long endTime = currentTime + 1;
        // Construct the Metering data.
        JSONArray meteringArray = new JSONArray();
        JSONObject meteringItem = new JSONObject();
        meteringItem.put("StartTime", String.valueOf(startTime));
        meteringItem.put("EndTime", String.valueOf(endTime));
        JSONArray entitiesArray = new JSONArray();
        for (Map.Entry<String, String> entry : entities.entrySet()) {
            entitiesArray.put(new JSONObject()
                .put("Key", entry.getKey())
                .put("Value", entry.getValue()));
        }
        meteringItem.put("Entities", entitiesArray);
        meteringArray.put(meteringItem);
        // Calculate the token.
        String meteringStr = meteringArray.toString();
        String tokenStr = meteringStr + "&" + serviceKey;
        String token = md5(tokenStr);
        // Construct the complete request payload.
        JSONObject payload = new JSONObject();
        payload.put("Metering", meteringStr);
        payload.put("Token", token);
        return payload;
    }
    // Computes the MD5 hash of a string.
    private static String md5(String input) throws Exception {
        MessageDigest md = MessageDigest.getInstance("MD5");
        byte[] messageDigest = md.digest(input.getBytes());
        StringBuilder hexString = new StringBuilder();
        for (byte b : messageDigest) {
            String hex = Integer.toHexString(0xff & b);
            if (hex.length() == 1) hexString.append('0');
            hexString.append(hex);
        }
        return hexString.toString();
    }
}
              

Ejecución de ejemplo:

[root@xxx ~]# javac MeteringPusher.java
[root@xxx ~]# java MeteringPusher
Detected Region ID: cn-hangzhou
Response: {"code":200,"requestId":"20a00ad2-bb10-4abxxx","instanceId":"i-bp140hjfmsqcuqanv6ea","result":{"RequestId":"3FF6B8A8-F72F-5Bxxx","PushMeteringDataRequestId":"E2E_862fc9bfd36fe02bf7b7380ed437ba7","Success":true}}
Request URL: https://cn-hangzhou.axt.aliyun.com/computeNest/marketplace/push_metering_data
Nota

Asegúrese de que su proyecto incluya la biblioteca org.json. Por ejemplo, si usa Maven, agregue la siguiente dependencia:

<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20230618</version>
</dependency>

Códigos de error

Código de error

Mensaje de error

Descripción

OperationDenied

The service instance does not support pushing metering data.

No se admite el envío de datos de medición porque la instancia de servicio no es de tipo pay-as-you-go.

Only metering entities classified as Custom and associated with a service can be pushed. The entity ${EntityId} is invalid.

El elemento facturable especificado no admite el envío de datos. Asegúrese de que su método de reporte esté configurado como Reported by Service Provider y de que esté asociado correctamente con el servicio.

MissingParameter.${parametersName}

The required parameter "${parametersName}" is missing.

Falta un parámetro obligatorio.

InvalidParameter.${parametersName}

The provided parameter "${parametersName}" is invalid.

El parámetro especificado no es válido.

EntityNotExist.ServiceInstance

The specified service instance cannot be found.

La instancia de servicio no existe. Esto puede ocurrir si la instancia no fue creada por Compute Nest.