加速状态查询-阿里云帮助中心

加速状态查询接口（BandStatusQuery）

查询当前宽带加速状态。返回值中分别展示了加速后，上行加速后的带宽，下行加速后的带宽。如果返回中上行/下行返回值为空，则上行/下行没有在加速状态或者加速失败。

参数列表

入参列表


参数名称	参数类型	是否必填	样例取值	参数说明
BandId	Long	是	10001L	加速宽带ID。

出参列表


参数名称	参数类型	样例取值	参数说明
RequestId	String	89078768788ada	请求ID。
Code	String	OK	状态码-返回OK代表请求成功,其他错误码详见错误码列表。
Message	String	请求成功	状态码的描述。
ResultModle	Object		查询结果，详见ResultModle 样例。

ResultModle 格式


参数名称	参数类型	样例取值	参数说明
DownloadTarget	Integer	200M	下行已经加速到的带宽，单位Mbps。
UploadTarget	Integer	10M	上行已经加速到的带宽，单位Mbps。

技术对接步骤

1. 下载SDK开发工具

SDK工具包中一共包含了2个类库，一个aliyun-java-sdk-core包，另外一个是snsu-open-api包，将这两个包执行mvn package命令或者mvn deploy命令打包出相应的jar包，添加到工程类库中依赖使用。点击进入工具包下载。

2. 编写样例程序

/**
 * 产品名称:云通信加速API产品,开发者无需替换
 */
static final String product = "Snsuapi";
/**
 * 产品域名,开发者无需替换
 */
static final String domain = "snsuapi.aliyuncs.com";

// TODO 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)
static final String accessKeyId = "yourAccessKeyId";
static final String accessKeySecret = "yourAccessKey";

public static BandStatusQueryResponse bandStatusQuery () {

    BandStatusQueryResponse response = new BandStatusQueryResponse();
    /**
     * 可自助调整超时时间
     */
    System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
    System.setProperty("sun.net.client.defaultReadTimeout", "10000");

    try {
        /**
         * 初始化acsClient,暂不支持region化
         */
        IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);
        DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);
        IAcsClient acsClient = new DefaultAcsClient(profile);

        /**
         * 组装请求对象-具体描述见控制台-文档部分内容
         */
        BandStatusQueryRequest request = new BandStatusQueryRequest();

        Long bandId = 10001L;
        request.setBandId(bandId);
        /**
         * 具体的错误码可以参考具体的文档
         * 禁止Client的自动重试，如果加速失败，最好选择手动重试
         */
        response = acsClient.getAcsResponse(request, false, 0);
        if(response.getResultCode() != null && response.getResultCode().equals("OK")) {
            // todo 查询成功
        } else {
            // todo 查询失败
        }

        return response;
    } catch (ClientException e) {
        /**
         * 需要捕获Client异常
         */
        e.printStackTrace();

        /**
         * todo 进行一些特定业务处理，重试或者抛出异常
         */
    }

    return response;
}