Todos los productos
Search
Centro de documentos

Alibaba Cloud SDK:Configure una solicitud HTTPS

Última actualización: Sep 05, 2026

El kit de desarrollo de software (SDK) V1.0 usa el protocolo HTTP de forma predeterminada. Este tema describe cómo configurar el SDK para usar el protocolo HTTPS, que es más seguro.

Métodos de configuración

El protocolo de la solicitud se puede configurar de dos maneras. Los métodos se enumeran en orden descendente de prioridad:

  • Puede llamar al método setSysProtocol() en una instancia de la clase Request de OpenAPI. Esta configuración se aplica solo a la solicitud actual. A continuación se muestra un ejemplo de código:

    Nota

    Cada operación de OpenAPI tiene una clase Request única. El nombre de la clase sigue el formato ${OpenAPI}${Request}, por ejemplo, DescribeInstancesRequest.

    com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest request = new com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest();
    request.setSysProtocol(com.aliyuncs.http.ProtocolType.HTTPS);
  • Puede llamar al método setProtocolType() de la clase com.aliyuncs.http.HttpClientConfig. Esta configuración se aplica globalmente. El código que se muestra a continuación proporciona un ejemplo:

    com.aliyuncs.http.HttpClientConfig clientConfig = com.aliyuncs.http.HttpClientConfig.getDefault();
    clientConfig.setProtocolType(com.aliyuncs.http.ProtocolType.HTTPS);
Importante

De forma predeterminada, si envía una solicitud de API a través de HTTPS, el SDK habilita la verificación de certificados para que se compruebe la validez de los certificados SSL/TLS. Si no se configura ningún certificado SSL/TLS en el entorno de desarrollo, se notifica un error que indica que la verificación del certificado falló.

Se recomienda que, para garantizar la seguridad de la comunicación de red, habilite la verificación de certificados. Si necesita deshabilitarla en el entorno de pruebas, deshabilite la verificación de certificados mediante la configuración de parámetros que se muestra a continuación:

com.aliyuncs.http.HttpClientConfig clientConfig = com.aliyuncs.http.HttpClientConfig.getDefault();
// Disable server-side certificate validation.
clientConfig.setIgnoreSSLCerts(true)