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

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

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

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

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

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

1.1. 查询云服务器类型

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

1.2. 查询数据云盘类型

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

1.3. 查询网络类型

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

1.4. 查询镜像

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