Alibaba Cloud SDK:Preguntas frecuentes sobre Alibaba Cloud SDK for Node.js

¿Cómo se manejan los errores de AccessKey?

Problema: Después de ejecutar el código, se devuelve el mensaje de error a continuación. El mensaje de error indica que el par de AccessKey no está configurado correctamente.

• Alibaba Cloud SDK V2.0 for Node.js: Cannot read properties of undefined (reading 'getCredential').

• Alibaba Cloud SDK V1.0 for Node.js: AssertionError [ERR_ASSERTION]: must pass "config.accessKeyId".

Soluciones:

1. Ejecute los comandos a continuación para comprobar si las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET están configuradas.

   Linux/macOS

   echo $ALIBABA_CLOUD_ACCESS_KEY_ID
   echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET

   Windows

   echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
   echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%

   Si se devuelve un par de AccessKey válido, las variables de entorno están configuradas correctamente. Si no se devuelve ningún par de AccessKey o se devuelve un par de AccessKey no válido, configure las variables de entorno según corresponda. Para obtener más información, consulte Configure environment variables in Linux, macOS, and Windows.

2. Compruebe si hay errores relacionados con el par de AccessKey en el código.

   Ejemplo de solicitud con error:

    let config = new OpenApi.Config({
         accessKeyId: process.env['yourAccessKeyID'],
         accessKeySecret: process.env['yourAccessKeySecret'],
       });

   Ejemplo de solicitud correcta:

   let config = new OpenApi.Config({
         accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
         accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
       });

   Nota

   Las expresiones process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'] y process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'] recuperan los valores de sus respectivas variables de entorno.

   Importante

   Para evitar riesgos de seguridad, no escriba el par de AccessKey en el código en línea.

¿Qué hago si se devuelve el mensaje de error "tsc: Fail to recognize the tsc command as the name of a cmdlet, a function, a script, or a executable program..." después de ejecutar un comando tsc?

PS C:\Users\issuser\Downloads\69351a7d-c9ef-417c-8986-a371cd208ece-TypeScript> tsc
tsc : The term 'tsc' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ tsc
+ ~~~
    + CategoryInfo          : ObjectNotFound: (tsc:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

¿Qué hago si la solicitud de API agota el tiempo de espera y se devuelve el mensaje "Error: connect ETIMEDOUT"?

Causas y soluciones comunes:

El agotamiento del tiempo de espera de una llamada de API puede deberse a varios factores. La sección a continuación describe las causas comunes y las soluciones correspondientes:

Causa 1: Problemas de conexión de red

Causa: la solicitud no puede llegar al servidor porque la conexión de red entre el cliente y el servidor falla o la red es inestable.

Solución:

Ejecute el comando ping o curl para probar la conectividad entre el host local y el endpoint del servicio en la nube. Por ejemplo, ejecute el comando ping dysmsapi.aliyuncs.com o curl -v https://dysmsapi.aliyuncs.com para probar la conectividad entre su host local y el endpoint de la API de Short Message Service (SMS).

• Si el comando agota el tiempo de espera o no recibe respuesta, compruebe las políticas de bloqueo en su firewall local o en sus enrutadores.

• Si se devuelve una respuesta, se recomienda que especifique un período de tiempo de espera adecuado para evitar errores de solicitud causados por configuraciones de tiempo de espera inadecuadas. Para obtener más información, consulte Configure a timeout period. Código de ejemplo:

  JavaScript

  // Create a RuntimeOptions instance and specify runtime parameters. 
      const runtime = new RuntimeOptions({
          // Configure a timeout period for connection requests.
          connectTimeout: 10000,
      });

  TypeScript

  // Create a RuntimeOptions instance and specify runtime parameters. 
          const runtime = new $Util.RuntimeOptions({
              // Configure a timeout period for connection requests.
              connectTimeout: 10000,
          });

Causa 2: Tiempo prolongado para procesar la solicitud

Descripción: la duración del procesamiento de la solicitud de API excede el período de tiempo de espera de lectura especificado.

Solución: configure el período de tiempo de espera para adaptarlo al tiempo de respuesta prolongado de la API. Para obtener más información, consulte Configure a timeout period. Por ejemplo, puede configurar el parámetro de tiempo de espera de lectura para ampliar el período de tiempo de espera de lectura. Código de ejemplo:

// Create a RuntimeOptions instance and specify runtime parameters. 
    const runtime = new RuntimeOptions({
        // Configure a timeout period for read requests.
        readTimeout: 10000,
    });

// Create a RuntimeOptions instance and specify runtime parameters. 
        const runtime = new $Util.RuntimeOptions({
            // Configure a timeout period for read requests.
            readTimeout: 10000,
        });

¿Qué hago si se informa el error "MissingRequiredParameter" al llamar a una operación de API?

En este ejemplo, se llama a la operación SendSms del servicio Short Message Service (SMS).

• Vaya a la página API Debugging en OpenAPI Explorer y luego seleccione el producto y la API.

• Compruebe que todos los parámetros obligatorios, como phoneNumbers y signName, estén especificados en el objeto de solicitud construido. En este ejemplo, se usa el objeto SendSmsRequest.

• Compruebe que todos los parámetros obligatorios estén especificados según la referencia de API.

• Asegúrese de que los valores de los parámetros obligatorios sean válidos. Por ejemplo, compruebe que los números de celular estén especificados en formatos válidos.

• Antes de enviar una solicitud de API, el SDK comprueba automáticamente los parámetros. Si uno o más parámetros obligatorios no están especificados, se informa un error como MissingRequiredParameter. Por ejemplo, si el parámetro phoneNumbers no está especificado, se informa el error "MissingPhoneNumbers: code: 400". En este caso, especifique el parámetro según el mensaje de error.

let sendSmsRequest = new Dysmsapi20170525.SendSmsRequest({
      phoneNumbers: '<YOUR_VALUE>',
      signName: '<YOUR_VALUE>',
      templateCode: '<YOUR_VALUE>',
    });

let sendSmsRequest = new $Dysmsapi20170525.SendSmsRequest({
      phoneNumbers: "<YOUR_VALUE>",
      signName: "<YOUR_VALUE>",
      templateCode: "<YOUR_VALUE>",
    });

¿Qué hago si no puedo llamar a una operación de API porque la operación no es compatible en la región especificada y se devuelve el mensaje "getaddrinfo ENOTFOUND"?

Asegúrese de que el servicio al que está llamando esté disponible en la región seleccionada. Puede encontrar el endpoint de servicio correcto en OpenAPI Explorer. Asegúrese de usar el endpoint correcto.

En la barra de navegación superior de OpenAPI Explorer, seleccione Short Message Service. En la página principal del producto, vaya a la pestaña Service area list. El formato del endpoint es [product_code].[region_id].aliyuncs.com. La tabla enumera cada ID de región (como cn-beijing, cn-hangzhou y cn-shanghai) y su endpoint de servicio correspondiente (como dysmsapi.aliyuncs.com).

¿Cómo se manejan los errores informados por el comando npm install?

Asegúrese de que Node.js y npm estén instalados correctamente. Para obtener más información, consulte Install Node.js on Windows.

¿Cómo resuelvo un conflicto de versiones de un paquete de dependencias?

• Ejecute el comando npm ls para consultar el árbol de dependencias y asegurarse de que no haya conflictos de versiones.

• Elimine el directorio node_modules y el archivo package-lock.json y reinstale las dependencias.

 rm -rf node_modules package-lock.json
 npm install