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:
Nota
|
|
|
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
|
|
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
-
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.
-
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 -
Respuesta de ejemplo:
cn-hangzhou
-
-
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\"}]}]NotaDado que este ejemplo usa un comando curl, la cadena JSON del parámetro
Meteringdebe 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 JSONMeteringconvertido a cadena, un signo et (&) y su clave de servicio. El token de este ejemplo es7aa81300b2aea77984b772495c8e4e83.
-
-
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"}'NotaEn
https://cn-hangzhou.axt.aliyun.com,cn-hangzhoues 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. -
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
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. |