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 = JobClient(clientProfile)
        # 实例化一个请求对象,每个接口都会对应一个request对象
        request = DescribeJobsRequest()
        # 传入待查询异步任务id信息
        request.jobUuid = "c7a91ee87615482e9769d370cfd2f9ff"
        # 返回的response是一个DescribeJobsResponse实例
        # 该实例有三个重要属性,分别是code、message和data
        response = client.DescribeJobs(request)
        # code属性表示本次请求返回的编码。该编码200表示正常,非200表示异常
        code = response.code
        # message属性表示本次请求返回的信息。如果code值为非200,则可通过message获得请求异常原因
        message = response.message
        # data属性为实际返回的云服务器类型信息列表。数据类型为list[Job]
        jobs = response.data
        # Job类有如下重要属性
        # progress 表示异步任务执行进度,该属性数据类型为浮点,表示执行的百分比
        # done表示是否执行完成。True表示执行完成,False表示未执行完成
        # success表示是否执行成功。True表示执行成功,False表示执行失败。
        # result执行结果说明。
        progress = jobs[0].progress