API文档
云服务器相关接口
产品类型接口
JavaSDK使用说明

1. 通过 JavaSDK 获取产品规格信息

本文档说明如何通过 JavaSDK 获取您当前可用的资源规格类型信息。

本文档中涉及到的 AccessKey 和 SecretAccessKey 只用作演示用,不作为您真实操作自己资源的依据。

本文档中涉及到的链接信息实际应为https://ai.blsc.cn (opens in a new tab)

本页所有接口返回信息都包含可用区信息,可用区具体说明详见 可用区 本页不再重复说明

1.1. 查询云服务器类型

        // 实例化一个认证对象,入参需要传入智算云平台账户AccessKey和SecretAccessKey,此处还需注意密钥对的保密
        // 秘钥可前往智算云平台->个人中心->我的秘钥进行获取
        String AccessKey = "abcd";
        String SecretAccessKey = "abcd1234";
        ClientProfile clientProfile = new ClientProfile(AccessKey,SecretAccessKey);
 
        // 实例化一个请求产品的client对象
        ProductClient client = new ProductClient(clientProfile);
 
        // 实例化一个请求对象,每个接口都会对应一个request对象
	    DescribeInstanceTypesRequest describeInstanceTypesRequest = new DescribeInstanceTypesRequest();
 
        // 返回的response是一个AICloudResponse实例
        // 该实例有三个重要属性,分别是code、message和data
        AICloudResponse<List<InstanceType>> response = client.DescribeInstanceTypes(describeInstanceTypesRequest);
 
        // code属性表示本次请求返回的编码。该编码200表示正常,非200表示异常
        int code = response.getCode();
        // message属性表示本次请求返回的信息。如果code值为非200,则可通过message获得请求异常原因
        String message = response.getMessage();
        List<InstanceType> instanceTypes = response.getData();
        // data属性为实际返回的云服务器类型信息列表。数据类型为List[InstanceType],您可以通过循环的方式获取到所有云服务器类型信息
        // InstanceType类有多个属性,重要的属性包括
        // zone是该云服务器类型所属可用区信息
        // vhostModel表示云服务器规格信息,该信息在创建云服务器时会用到
        // vhostType表示云服务器所属类型
        // vhostCpus表示该云服务器规格支持CPU个数
        // vhostMemory表示该云服务器规格支持内存大小,单位字节
        // vhostGpus表示该云服务器规格支持GPU个数,该值是一个浮点型
        // vhostGpumem表示该云服务器规格支持的显存大小,单位字节
        // rootDiskTypes表示该主机规格支持的系统盘类型

1.2. 查询数据云盘类型

        // 实例化一个认证对象,入参需要传入智算云平台账户AccessKey和SecretAccessKey,此处还需注意密钥对的保密
        // 秘钥可前往智算云平台->个人中心->我的秘钥进行获取
        String AccessKey = "abcd";
        String SecretAccessKey = "abcd1234";
        ClientProfile clientProfile = new ClientProfile(AccessKey,SecretAccessKey);
 
        // 实例化一个请求产品的client对象
        ProductClient client = new ProductClient(clientProfile);
        // 实例化一个请求对象,每个接口都会对应一个request对象
        DescribeDiskTypesRequest describeDiskTypesRequest = new DescribeDiskTypesRequest();
        // 返回的response是一个AICloudResponse实例
        // 该实例有三个重要属性,分别是code、message和data
        AICloudResponse<List<DiskType>> response = client.DescribeDiskTypes(describeDiskTypesRequest);
 
        // code属性表示本次请求返回的编码。该编码200表示正常,非200表示异常
        int code = response.getCode();
        // message属性表示本次请求返回的信息。如果code值为非200,则可通过message获得请求异常原因
        String message = response.getMessage();
        // data属性为实际返回的云盘类型信息列表。数据类型为List[DiskType],您可以通过循环的方式获取到所有云盘类型信息
        // DiskType类有多个属性,重要的属性包括
        // zone是该云盘类型所属可用区信息
        // diskType表示云盘类型
        // diskSize表示该云盘类型支持的大小范围,单位是GB。比如20-32000
        List<DiskType> diskTypes = response.getData();

1.3. 查询网络类型

        // 实例化一个认证对象,入参需要传入智算云平台账户AccessKey和SecretAccessKey,此处还需注意密钥对的保密
        // 秘钥可前往智算云平台->个人中心->我的秘钥进行获取
        String AccessKey = "abcd";
        String SecretAccessKey = "abcd1234";
        ClientProfile clientProfile = new ClientProfile(AccessKey,SecretAccessKey);
 
        // 实例化一个请求产品的client对象
        ProductClient client = new ProductClient(clientProfile);
        // 实例化一个请求对象,每个接口都会对应一个request对象
        DescribeNetworkTypesRequest describeNetworkTypesRequest = new DescribeNetworkTypesRequest();
        // 返回的response是一个AICloudResponse实例
        // 该实例有三个重要属性,分别是code、message和data
        AICloudResponse<List<NetworkType>> response = client.DescribeNetworkTypes(describeNetworkTypesRequest);
 
        // code属性表示本次请求返回的编码。该编码200表示正常,非200表示异常
        int code = response.getCode();
        // message属性表示本次请求返回的信息。如果code值为非200,则可通过message获得请求异常原因
        String message = response.getMessage();
        // data属性为实际返回的云服务器类型信息列表。数据类型为List[NetworkType],您可以通过循环的方式获取到所有网络类型信息
        // NetworkType类有多个属性,重要的属性包括
        // zone是该网络类型所属可用区信息
        // networkType表示网络类型
        // networkSize表示该网络类型支持的大小范围,单位是Mbps。比如1-100
        List<NetworkType> networkTypes = response.getData();

1.4. 查询镜像

        // 实例化一个认证对象,入参需要传入智算云平台账户AccessKey和SecretAccessKey,此处还需注意密钥对的保密
        // 秘钥可前往智算云平台->个人中心->我的秘钥进行获取
        String AccessKey = "abcd";
        String SecretAccessKey = "abcd1234";
 
        ClientProfile clientProfile = new ClientProfile(AccessKey,SecretAccessKey);
 
        // 实例化一个请求产品的client对象
        ProductClient client = new ProductClient(clientProfile);
        // 实例化一个请求对象,每个接口都会对应一个request对象
        DescribeImagesRequest describeImagesRequest = new DescribeImagesRequest();
        // 返回的response是一个AICloudResponse实例
        // 该实例有三个重要属性,分别是code、message和data
        AICloudResponse<List<Image>> response = client.DescribeImages(describeImagesRequest);
 
        // code属性表示本次请求返回的编码。该编码200表示正常,非200表示异常
        int code = response.getCode();
        // message属性表示本次请求返回的信息。如果code值为非200,则可通过message获得请求异常原因
        String message = response.getMessage();
        // data属性为实际返回的镜像信息列表。数据类型为List[Image],您可以通过循环的方式获取到所有镜像信息
        // Image类有多个属性,重要的属性为
        // imageId表示镜像唯一id,创建云服务器实例的时候会用到该值
        // minDiskSize表示该镜像要求的最小系统盘大小
        // vhostType表示该镜像支持的云服务器类型列表,与云服务器类型InstanceType中的vhostType一致。
        List<Image> images = response.getData();