Aprenda a comprobar la vigencia de una instancia de servicio mediante la API CheckOutLicense.
Limitaciones
Su servicio debe cumplir uno de los siguientes requisitos:
El servicio está configurado para ventas personalizadas.
El servicio aparece listado en Alibaba Cloud Marketplace.
Cómo funciona
Cuando Compute Nest aprovisiona una instancia de servicio, etiqueta automáticamente los recursos subyacentes. Estas etiquetas incluyen el identificador de la instancia de servicio (ServiceInstanceId) y el identificador del servicio (ServiceId). La API CheckOutLicense utiliza dichas etiquetas para identificar la instancia de servicio asociada al recurso que inicia la llamada.
Obtenga el
ServiceIddel servicio desde la consola de Compute Nest.Al llamar a
CheckOutLicense, pase elServiceIdcomo parámetro. Compute Nest compara este parámetro con el identificador de servicio presente en las etiquetas del recurso. Si coinciden, la API devuelve los detalles de la licencia.
Ejemplo de llamada a la API
Este ejemplo muestra cómo llamar a la API CheckOutLicense desde una instancia ECS perteneciente a un servicio que cumple los requisitos descritos en Limitaciones.
-
Obtenga el identificador de región de la instancia ECS
Antes de llamar a la API CheckOutLicense, obtenga el identificador de región de la instancia ECS donde se despliega su aplicación. Guarde este identificador para el siguiente paso.
-
Ejecute el siguiente comando para obtener el identificador de región.
curl http://100.100.100.200/latest/meta-data/region-id -
Salida de ejemplo:
cn-hangzhou
-
-
Obtenga el
ServiceIddesde la consola de Compute Nest.
-
Solicitud de ejemplo
Este ejemplo muestra una llamada iniciada desde la región China (Hangzhou). Reemplace la región en la URL y el ServiceId con sus valores reales.
# Replace the value of ServiceId with your actual service ID. curl -H "Content-Type: application/json" -XPOST https://cn-hangzhou.axt.aliyun.com/computeNest/license/check_out_license -d '{"ServiceId":"service-8fff945fe6844906****"}' -
Respuesta de ejemplo
{ "code":200, "requestId":"6af1efb7-c59c-4cee-9094-e1e3bbefb639", "instanceId":"i-0jl957dfri612gxxxxxx", "result":{ "RequestId":"B22723B7-FC31-18F5-A33E-1AF4C82736AA", "ServiceInstanceId":"si-0f14037f30c14292****", "LicenseMetadata":"{\"TemplateName\":\"Custom_Image_Ecs\",\"SpecificationName\":\"\",\"CustomData\":\"xxxx\"}", "TrialType":"NotTrial", "Token":"58d4574bd0d967bb431cd8936b5e80c4", "ExpireTime":"2024-08-28T06:27:08Z", "ServiceId":"service-8fff945fe6844906****", "Components":"{\"package_version\":\"yuncode55xxxxxxxx\",\"SystemDiskSize\":\"40\",\"DataDiskSize\":\"100\"}" } }A continuación se describen los parámetros clave de la respuesta.
Parámetro
Descripción
Ejemplo
ServiceInstanceId
Identificador de la instancia de servicio.
si-0f14037f30c14292****
ServiceId
Identificador del servicio.
service-8fff945fe6844906****
ExpireTime
Fecha y hora de vencimiento de la instancia de servicio.
2024-08-28T06:27:08Z
LicenseMetadata
Metadatos personalizados.
Estos datos se definen en la configuración de ventas personalizadas.
{\"TemplateName\":\"Custom_Image_Ecs\",\"SpecificationName\":\"\",\"CustomData\":\"xxxx\"}
Components
Detalles de los componentes de facturación complementarios de Alibaba Cloud Marketplace.
{\"package_version\":\"yuncode55xxxxxxxx\",\"SystemDiskSize\":\"40\",\"DataDiskSize\":\"100\"}
Ejemplos de código
Python
import requests
import json
import hashlib
import time
import sys
from urllib.request import urlopen
def get_region_id():
"""Get the region ID (for example, cn-hangzhou) from the Alibaba Cloud 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 checkout_license():
# Dynamically get the region ID and build the URL.
region_id = get_region_id()
url = f"https://{region_id}.axt.aliyun.com/computeNest/license/check_out_license"
# Send the POST request.
try:
response = requests.post(
url,
json={
# Optional: Include ServiceId to scope the check to a specific service.
# If omitted, Compute Nest identifies the service from resource tags.
# "ServiceId": "service-ec9cbf77f9be443db938"
},
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__":
# Call the function.
checkout_license()
Salida de ejemplo:

Java
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.security.MessageDigest;
public class CheckoutLicense {
public static void main(String[] args) {
try {
// === Dynamically get the region ID ===
String regionId = getRegionId();
System.out.println("Detected Region ID: " + regionId);
String checkoutLicenseString = "{}";
// Optional: Include ServiceId to scope the check to a specific service.
// If omitted, Compute Nest identifies the service from resource tags.
// String checkoutLicenseString = "{\"ServiceId\": \"service-ec9cbf77f9be443db938\"}";
// === Send the POST request ===
String urlStr = "https://" + regionId + ".axt.aliyun.com/computeNest/license/check_out_license";
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 = checkoutLicenseString.getBytes("UTF-8");
os.write(input, 0, input.length);
}
// === Read the response ===
try (BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {
StringBuilder response = new StringBuilder();
String responseLine;
while ((responseLine = br.readLine()) != null) {
response.append(responseLine);
}
System.out.println("Response: " + response.toString());
}
conn.disconnect();
System.out.println("Request URL: " + urlStr);
} catch (Exception e) {
e.printStackTrace();
}
}
// === Get the region ID from the Alibaba Cloud 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();
}
}
}
Salida de ejemplo:
