DescribeTask--大数据文件存储-火山引擎

文档中心

导航

DescribeTask

最近更新时间：2023.05.18 15:33:39首次发布时间：2023.05.18 14:53:13

调用 DescribeTask 接口，查询某次操作的后端任务详情。

请求参数

参数	类型	是否必填	示例值	说明
TaskId	String	是	59129b37-**-e5ce4a3982dd	执行某操作后，返回的后端任务 ID。

返回参数

参数	类型	示例值	说明
TaskId	String	59129b37-**-e5ce4a3982dd	后端任务 ID。
TaskType	String	CREATE_NAMESPACE	任务类型，即执行的什么操作。
ResourceType	String	NAMESPACE	操作的资源类型。 FILESYSTEM NAMESPACE ACCESS
Id	String	180143**09482159	资源的 Id。
Status	String	UP	资源的状态。

请求示例

GET https://open.volcengineapi.com?Action=DescribeTask&Version=2022-02-02&TaskId=59129b37-**-e5ce4a3982dd
Content-Type: application/json
Region: cn-beijing
ServiceName: cfs

返回示例

{
    "Result": {
        "TaskId": "34aecb63-***-976188763bfc",
        "TaskType": "CREATE_NAMESPACE",
        "ResourceType": "NAMESPACE",
        "AccessId": "180143**09482159",
        "Status": "UP"
    },
    "ResponseMetadata": {
        "RequestId": "20230424110***17AE769F1F13580D",
        "Action": "DescribeTask",
        "Version": "2022-02-02",
        "Service": "cfs",
        "Region": "cn-beijing",
        "Error": null
    }
}

错误码

下表列举了本接口的错误码信息。公共错误码信息，请参考公共错误码。

HttpCode	错误码	错误信息
400	InvalidTaskId	TaskId 不合法。
404	TaskIdNotFound	TaskId 不存在。
401	Unauthorized	无权查看该任务。