全部產品
Search
文件中心

Alibaba Cloud SDK:HTTPS 請求配置

更新時間:Oct 10, 2025

V1.0 SDK 預設採用HTTP協議。若您需要使用更安全的HTTPS協議,請根據本文指引進行配置。

配置方式

請求的協議支援兩種配置方式,優先順序順序為高到低:

  • 通過OpenAPI Request類的執行個體調用setSysProtocol()方法進行配置,僅對當前請求生效。範例程式碼如下:

    說明

    每個OpenAPI都有獨立的Request類,命名方式為:${OpenAPI}${Request},例如DescribeInstancesRequest。

    com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest request = new com.aliyuncs.ecs.model.v20140526.DescribeInstancesRequest();
    request.setSysProtocol(com.aliyuncs.http.ProtocolType.HTTPS);
  • 通過com.aliyuncs.http.HttpClientConfig類的setProtocolType()方法進行配置,全域生效。範例程式碼如下:

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

使用 HTTPS 協議訪問 OpenAPI 時,SDK 會預設開啟校正 SSL/TLS 認證有效性,若您代碼環境沒有認證環境,則會報錯認證校正失敗。

為保障生產環境通訊安全,建議您保持開啟,若在測試環境必須忽略認證校正,可以通過以下參數設定

com.aliyuncs.http.HttpClientConfig clientConfig = com.aliyuncs.http.HttpClientConfig.getDefault();
// 設定不校正服務端認證
clientConfig.setIgnoreSSLCerts(true)