DescribeTasks - - Alibaba Cloud Documentation Center

Menanyakan status kemajuan satu atau beberapa permintaan asinkron.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeTasks	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeTasks.
PageNumber	Integer	No	1	Nomor halaman yang dikembalikan. Halaman dimulai dari halaman 1. Nilai default: 1.
PageSize	Integer	No	10	Jumlah entri yang dikembalikan pada setiap halaman. Nilai maksimum: 100. Nilai default: 10.
RegionId	String	Yes	cn-hangzhou	ID wilayah task. Anda dapat memanggil operasi DescribeRegions untuk menanyakan daftar wilayah terbaru.
TaskIds	String	No	t-bp1hvgwromzv32iq**,t-bp179lofu2pv768w**	ID task. Anda dapat menentukan hingga 100 ID task sekaligus. Pisahkan ID task dengan koma (,).
TaskAction	String	No	ImportImage	Nama operasi yang menghasilkan task. Nilai yang valid: ImportImage ExportImage RedeployInstance ModifyDiskSpec
TaskStatus	String	No	Finished	Status task. Nilai yang valid: Finished Processing Failed Parameter ini kosong secara default. Catatan Sistem hanya mengambil task dalam status Finished, Processing, dan Failed serta mengabaikan nilai lainnya.
StartTime	String	No	2020-11-23T15:10:00Z	Titik awal periode waktu untuk menanyakan task yang dibuat. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
EndTime	String	No	2020-11-23T15:16:00Z	Titik akhir periode waktu untuk menanyakan task yang dibuat. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
ResourceIds.N	String	No	m-bp1i8huqm5u7****	ID resource N yang terkait dengan task. Nilai N yang valid: 1 hingga 100. Jika TaskAction diatur ke ImportImage atau ExportImage, atur ID resource ke ID image. Jika TaskAction diatur ke RedeployInstance, atur ID resource ke ID instans Elastic Compute Service (ECS). Jika TaskAction diatur ke ModifyDiskSpec, atur ID resource ke ID disk.

Parameter respons

Parameter	Type	Example	Description
PageSize	Integer	10	Jumlah entri yang dikembalikan per halaman.
PageNumber	Integer	1	Nomor halaman yang dikembalikan.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
TotalCount	Integer	1	Total jumlah entri yang dikembalikan.
RegionId	String	cn-hangzhou	ID wilayah task.
TaskSet	Array of Task		Detail tentang task.
Task
CreationTime	String	2020-11-24T12:50Z	Waktu saat task dibuat.
TaskStatus	String	Finished	Status task.
FinishedTime	String	2020-11-24T12:50Z	Waktu saat task selesai.
SupportCancel	String	true	Menunjukkan apakah task dapat dibatalkan.
TaskId	String	t-bp1hvgwromzv32iq****	ID task.
TaskAction	String	ImportImage	Nama task.
ResourceId	String	m-bp1i8huqm5u7****	ID resource.

Contoh

Permintaan contoh

http(s)://ecs.aliyuncs.com/?Action=DescribeTasks
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=10
&TaskIds=t-bp1hvgwromzv32iq****
&TaskAction=ImportImage
&TaskStatus=Finished
&StartTime=2020-11-23T15:10:00Z
&EndTime=2020-11-23T15:16:00Z
&Common request parameters

Respons sukses contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeTasksResponse>
    <TotalCount>1</TotalCount>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <TaskSet>
        <Task>
            <TaskId>t-bp1hvgwromzv32iq****</TaskId>
            <TaskAction>ImportImage</TaskAction>
            <SupportCancel>true</SupportCancel>
            <CreationTime>2020-11-24T12:50Z</CreationTime>
            <TaskStatus>Finished</TaskStatus>
            <FinishedTime>2020-11-24T12:50Z</FinishedTime>
        </Task>
    </TaskSet>
    <RegionId>cn-hangzhou</RegionId>
</DescribeTasksResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageSize" : 10,
  "PageNumber" : 1,
  "TaskSet" : {
    "Task" : [ {
      "TaskId" : "t-bp1hvgwromzv32iq****",
      "TaskAction" : "ImportImage",
      "SupportCancel" : true,
      "CreationTime" : "2020-11-24T12:50Z",
      "TaskStatus" : "Finished",
      "FinishedTime" : "2020-11-24T12:50Z"
    } ]
  },
  "RegionId" : "cn-hangzhou"
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Description
400	InvalidRegionId.NotFound	The specified RegionId does not exist.	Pesan kesalahan yang dikembalikan karena parameter RegionId yang ditentukan tidak ada.

Untuk daftar kode kesalahan, lihat Service error codes.