Todos los productos
Search
Centro de documentos

Compute Nest:Comprobar la vigencia de una instancia de servicio

Última actualización: Sep 09, 2026

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.

  1. Obtenga el ServiceId del servicio desde la consola de Compute Nest.

  2. Al llamar a CheckOutLicense, pase el ServiceId como 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.

  1. 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.

    1. Ejecute el siguiente comando para obtener el identificador de región.

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

      cn-hangzhou
  2. Obtenga el ServiceId desde la consola de Compute Nest.

    imagen

  3. 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****"}'
  4. 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:

imagen

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:

imagen