Alibaba Cloud SDK:Preguntas frecuentes sobre el SDK para Python

¿Cómo gestiono los errores de AccessKey?

Problema: tras ejecutar el código, se devuelve el siguiente mensaje de error. Este indica que el par de AccessKey no está configurado correctamente.

• Alibaba Cloud SDK V2.0: AttributeError: 'NoneType' object has no attribute 'get_access_key_id'.

• Alibaba Cloud SDK V1.0: Error:MissingParameter The input parameter "AccessKeyId" that is mandatory for processing this request is not supplied.

Soluciones:

1. Ejecute los siguientes comandos 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 bien configuradas. Si no se devuelve ningún par o este no es 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. Revise el código en busca de errores relacionados con el par de AccessKey.

   Ejemplo de solicitud con errores:

    config = open_api_models.Config(
               access_key_id=os.environ['yourAccessKeyID'],
               access_key_secret=os.environ['yourAccessKeySecret']
           )

   Ejemplo de solicitud exitosa:

    config = open_api_models.Config(
              access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
              access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET']
           )

   Nota

   Las expresiones os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'] y os.environ("ALIBABA_CLOUD_ACCESS_KEY_SECRET") indican que el ID de AccessKey y el secreto de AccessKey se obtienen de las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET.

   Importante

   Para evitar riesgos de seguridad, no escriba el par de AccessKey directamente en el código de producción.

¿Qué hago si falla la instalación del SDK?

• Asegúrese de tener instalada una versión válida de Python, como Python 3.x.

• Incluya la opción --upgrade al instalar el SDK mediante un comando de pip. Así garantiza que se instale la versión más reciente.

pip install --upgrade <SDK_NAME>  

• Si encuentra problemas de permisos durante la instalación, por ejemplo, al instalar el SDK en el directorio del sistema de las bibliotecas de Python, utilice la opción --user para instalarlo en el directorio del usuario en lugar del directorio del sistema.

pip install --user <SDK_NAME>  

• Si tiene varias versiones de Python instaladas en la PC, asegúrese de instalar el SDK en la versión que utiliza. Por ejemplo, use python3 en lugar de python en el código y ejecute comandos pip3.

¿Qué hago si falla la importación de un módulo y se reporta el error ModuleNotFoundError?

Compruebe que el SDK esté instalado correctamente. Después, intente importar un módulo en el entorno de Python.

• Inicie el intérprete de Python.

python

• Importe un módulo.

import <SDK_NAME> 

Si no ocurre ningún error, el SDK está instalado correctamente. Si aparece el error ModuleNotFoundError o ImportError, significa que la instalación no se completó de forma adecuada.

pip install <SDK_NAME>

¿Qué hago si se devuelve el mensaje de error "AttributeError: 'CredentialModel' object has no attribute 'provider_name'"?

¿Qué hago si se devuelve el siguiente mensaje de error: code: 400, The input parameter"AccesskeyId" that is mandatory for processing this request is not supplied?

• Este mensaje se devuelve porque una solicitud enviada a la puerta de enlace no contiene un ID de AccessKey.

• Compruebe si el ID de AccessKey está bien configurado cuando utilice el código de ejemplo completo descargado de OpenAPI Explorer. Configure su ID de AccessKey y su secreto de AccessKey al llamar al método principal.

En la pestaña SDK Sample de OpenAPI Explorer, busque accessKeyId y accessKeySecret dentro del método main y reemplace los valores de marcador de posición con su AccessKey.

¿Qué hago si se devuelve el siguiente mensaje de error: Tea.exceptions.TeaException: Error: SignatureDoesNotMatch.MissingHeader code: 400, The specified signed header "accept;connection;content-type;host;user-agent;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version" is not found?

Este mensaje se devuelve porque el encabezado Connection se establece en close para implementar conexiones de corta duración al llamar a un servicio en modo autofirmado. Sin embargo, el método de firma V3 no es compatible con esta configuración, lo que provoca el error.

Para corregirlo, aplique la siguiente configuración: config.signature_algorithm = 'v2'.

¿Qué hago si se devuelve el siguiente mensaje de error: Tea.exceptions.TeaException: Connection aborted?

Este mensaje se devuelve porque el intervalo entre solicitudes supera el tiempo esperado. El servidor mantiene una conexión persistente solo durante 30 segundos, mientras que el cliente intenta mantenerla abierta de forma indefinida. En este caso, el servidor cierra la conexión después de 30 segundos. Si el cliente envía una solicitud pasado ese tiempo, la solicitud falla.

• Establezca el encabezado Connection en close para usar conexiones de corta duración.

• Configure un mecanismo de reintento para garantizar que la llamada se inicie dentro de los 30 segundos.

¿Qué hago si se agota el tiempo de espera de una llamada a la API y se devuelve el error "requests.exceptions.Timeout" o "requests.exceptions.ConnectionError"?

El agotamiento del tiempo de espera en una llamada a la API puede deberse a varios factores. A continuación se describen las causas más comunes y sus respectivas soluciones.

Problemas de conexión de red

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

Soluciones:

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, revise las directivas de bloqueo en su firewall local o en los enrutadores.

• Si se recibe respuesta, se recomienda especificar un tiempo de espera adecuado para evitar fallos causados por configuraciones incorrectas. Para obtener más información, consulte Configure a timeout period. Código de ejemplo:

• # The timeout period takes effect only for requests that use RuntimeOptions.
  runtimeOptions = RuntimeOptions(
      connect_timeout=5000  # Configure the timeout period for connection requests. Unit: milliseconds.
  )

Causa 2: tiempo prolongado de procesamiento de la solicitud

Causa: el tiempo de procesamiento de la solicitud a la API supera el tiempo de espera de lectura especificado.

Solución: aumente el tiempo de espera para la respuesta de la API. Para obtener más información, consulte Configure a timeout period. Por ejemplo, configure el parámetro de tiempo de espera de lectura para ampliar dicho periodo. Código de ejemplo:

# The timeout period takes effect only for requests that use RuntimeOptions.
runtimeOptions = RuntimeOptions(
    read_timeout=10000,  # Configure the timeout period for read requests. Unit: milliseconds.
)

¿Qué hago si en Linux se devuelve el mensaje de error "-bash: python3: command not found"?

Si ya instaló Python, este mensaje puede deberse a que los enlaces simbólicos no están configurados correctamente.

• Ejecute el comando which python3 pip3 para comprobar si existen enlaces simbólicos en el sistema. Si existen, elimínelos.

rm -rf /usr/bin/python3 /usr/bin/pip3

• Vuelva a crear los enlaces simbólicos. Busque el directorio de instalación de Python, acceda al directorio bin y localice pip3.12 y python3.12. Ejecute los siguientes comandos para crear los enlaces simbólicos:

sudo ln -s /usr/local/python3/bin/python3.12 /usr/bin/python3
sudo ln -s /usr/local/python3/bin/pip3.12 /usr/bin/pip3

¿Qué hago si al llamar a una operación de la API se reporta el error "Invalid parameters" o "MissingRequiredParameter"?

En este ejemplo se utiliza la operación SendSms de Short Message Service (SMS).

• Vaya a la página API Debugging en OpenAPI Explorer y seleccione el producto en la nube 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.

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

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

• Antes de enviar una solicitud a la API, el SDK verifica automáticamente los parámetros. Si falta uno o más parámetros obligatorios, se reporta un error como MissingRequiredParameter. Por ejemplo, si no se especifica el parámetro PhoneNumbers, se devuelve el error "MissingPhoneNumbers: code: 400". En ese caso, especifique el parámetro siguiendo las indicaciones del mensaje de error.

Si llama a la API sin el parámetro de número de celular, la consola devolverá el error MissingPhoneNumbers: code: 400.

send_sms_request = dysmsapi_20170525_models.SendSmsRequest(
            # The mobile numbers to which you want to send a text message.
            phone_numbers='<YOUR_VALUE>',
            # The name of the SMS signature.
            sign_name='<YOUR_VALUE>',
            # The code of the SMS template.
            template_code='<YOUR_VALUE>',
            # The variables of the SMS template. Specify the value in the JSON format. Example: {"code":"1234","name":"1234","time":"1234"}.
            template_param='{"code":"1234","name":"1234","time":"1234"}'
        )

¿Qué hago si falla la llamada a una operación de la API y se reporta el error "Tea.exceptions.UnretryableException"?

Asegúrese de que la región seleccionada sea compatible con el servicio al que llama. Si toma SMS como ejemplo, encontrará los endpoints del servicio en su página de producto dentro de OpenAPI Explorer. Utilice el endpoint correcto para su región.

Haga clic en la pestaña Service Area List en la página principal del producto. Use las columnas Region ID y Service Address para encontrar el endpoint correcto de cada región. Por ejemplo, el endpoint de SMS para las regiones de China continental es dysmsapi.aliyuncs.com.

¿Qué hago si se devuelve el siguiente mensaje de error: File "/usr/local/python3/lib/python3.6/site-packages/alibabacloud_slb20140515/client.py", line 4, in <module> from Tea.core import TeaCore ModuleNotFoundError: No module named 'Tea'?

Este mensaje se devuelve porque la versión de pip está desactualizada. Cuando esto ocurre, las dependencias instaladas quedan incompletas o se eliminan ciertas dependencias específicas. Para corregirlo, actualice pip y ejecute el comando pip install <Installation package>. Por ejemplo, ejecute el comando pip install alibabacloud-tea para instalar el módulo Tea.

Pregunta 13: ¿Qué hago si se devuelve el siguiente mensaje de error: Command "python setup.py egg_info" failed with error code 1 in xxx?

Este mensaje se devuelve porque la versión de Python o de pip está desactualizada, o porque faltan bibliotecas o paquetes necesarios. Como consecuencia, el SDK no funciona como se espera.

Soluciones:

1. Compruebe las versiones de SSL/TLS: asegúrese de que el entorno de Python en el dispositivo local admita la versión de SSL/TLS que el servidor usa para comunicarse. En algunos casos, el servidor solo admite TLS 1.2.

   import ssl
   import urllib3
   # Create an SSL context that uses TLS 1.2.
   ssl_context = ssl.create_urllib3_context(ssl.OP_NO_SSLv2, ssl.OP_NO_SSLv3, ssl.OP_NO_TLSv1, ssl.OP_NO_TLSv1_1)
   # Initialize the urllib3 pool manager.
   http = urllib3.PoolManager(context=ssl_context)
   # Send the request.
   response = http.request('GET', 'https://ocr-api.cn-hangzhou.aliyuncs.com/?Country=Vietnam')
             

2. Revise posibles problemas en el entorno de Python:

   1. Asegúrese de que el módulo ssl y la versión de la biblioteca urllib3 sean compatibles con la versión de Python.

   2. Utilice un entorno virtual para reinstalar Python y sus dependencias.

   python -m venv myenv
   source myenv/bin/activate
   pip install requests urllib3 pyOpenSSL

3. Compruebe si hay errores en la configuración de red.

   1. Asegúrese de que el firewall del dispositivo local permita el tráfico hacia el puerto HTTPS (puerto 443).

   2. Si utiliza un servidor proxy, asegúrese de que esté configurado correctamente.

   import requests
   # Use a proxy
   proxies = {
       'http': 'http://your-proxy-server:port',
       'https': 'https://your-proxy-server:port'
   }
   response = requests.get(
       'https://ocr-api.cn-hangzhou.aliyuncs.com/?Country=Vietnam',
       proxies=proxies
   )

4. Actualice las bibliotecas requests y urllib3 para resolver el problema.

   pip install --upgrade requests urllib3

5. Si el problema persiste después de la actualización, es posible que se deba al certificado del entorno. Configure los siguientes parámetros para omitir el certificado y ajustar el tiempo de espera:

   # Ignore certificate verification.
   runtimeOptions = RuntimeOptions(
    ignore_ssl=True # Ignores SSL certificate verification. Verification is enabled by default.
   )
   # Adjust the timeout.
   runtimeOptions = RuntimeOptions(
       read_timeout=xxx,  # Read timeout in milliseconds (ms)
       connect_timeout=xxx  # Connection timeout in milliseconds (ms)
   )

6. Si el problema continúa tras deshabilitar la verificación del certificado SSL, establezca la variable de entorno PYTHONHTTPSVERIFY en 0 para deshabilitarla por completo.

   export PYTHONHTTPSVERIFY=0  # Disable HTTPS verification.

7. Revise el certificado SSL de la máquina local: asegúrese de que esté actualizado y completo. Puede usar una herramienta como certbot para actualizar e instalar certificados.

   sudo certbot certonly --standalone --rsa-key-size 4096 --agree-tos --email yo**@email.com