GetInstanceScreenshot - - Alibaba Cloud Documentation Center

Mengambil tangkapan layar dari instans Elastic Compute Service (ECS).

Catatan penggunaan

Setelah ECS mengembalikan tangkapan layar instans yang dikodekan dalam Base64 dengan format JPG, Anda harus mendekode tangkapan layar tersebut. Operasi ini disarankan untuk troubleshooting dan diagnostik. Perhatikan hal-hal berikut:

Instans harus berada dalam status Running.
Untuk instans dengan jenis instans yang telah ditarik, Anda tidak dapat mengambil tangkapan layar. Untuk informasi selengkapnya, lihat Retired instance types.
Jika Anda memanggil operasi ini pada suatu instans beberapa kali, interval antar pemanggilan harus minimal 10 detik. Jika tidak, kesalahan Throttling akan dikembalikan.

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	GetInstanceScreenshot	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke GetInstanceScreenshot.
RegionId	String	Yes	cn-shenzhen	ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
InstanceId	String	Yes	i-bp1gbz20g229bvu5****	ID instans.
WakeUp	Boolean	No	false	Menentukan apakah akan membangunkan instans yang berada dalam mode tidur. Nilai yang valid: true false Nilai default: false.

Parameter respons

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
InstanceId	String	i-bp1gbz20g229bvu5****	ID instans.
Screenshot	String	iVBORw0KGgoA...AAABJRU5ErkJggg==	Tangkapan layar instans yang dikodekan dalam Base64 dengan format JPG.

Contoh

Contoh permintaan

http://ecs-cn-hangzhou.example.com/?Action=GetInstanceScreenshot
&InstanceId=i-bp1gbz20g229bvu5****
&RegionId=cn-shenzhen
&WakeUp=false
&<Common request parameters>

Contoh respons sukses

XML format

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

<GetInstanceScreenshotResponse>
    <RequestId>22A1933F-AD02-4560-A6A7-53CF2231D942</RequestId>
    <InstanceId>i-bp1gbz20g229bvu5****</InstanceId>
    <Screenshot>iVBORw0KGgoA...AAABJRU5ErkJggg==</Screenshot>
</GetInstanceScreenshotResponse>

JSON format

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

{
  "RequestId" : "22A1933F-AD02-4560-A6A7-53CF2231D942",
  "InstanceId" : "i-bp1gbz20g229bvu5****",
  "Screenshot" : "iVBORw0KGgoA...AAABJRU5ErkJggg=="
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	MissingParameter	%s	Parameter yang diperlukan tidak ditentukan.
404	InvalidParameter	%s	Nilai parameter tidak valid.
405	IncorrectInstanceStatus	%s	Operasi ini tidak dapat dilakukan pada instans dalam status saat ini.
405	NotSupported	%s	Operasi Anda tidak valid.
429	Throttling	%s	Permintaan ditolak karena Pembatasan kecepatan.

Untuk daftar kode kesalahan, lihat Service error codes.