GetInstanceScreenshot - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

ECS, JPG formatında Base64 ile kodlanmış bir örnek anlık görüntüsü döndürür; bu görüntünün kodunu çözmeniz gerekir. Bu işlemi sorun giderme ve tanılama amacıyla çağırmanızı öneririz. Aşağıdaki hususlara dikkat edin:

Örnek Çalışıyor (Running) durumunda olmalıdır.
Kullanımdan kaldırılmış örnek türlerine sahip örnekler için anlık görüntü alamazsınız. Daha fazla bilgi için bkz. Kullanımdan kaldırılmış örnek türleri.
Bu işlemi bir örnek üzerinde birden çok kez çağırırsanız çağrı aralığı en az 10 saniye olmalıdır. Aksi takdirde Throttling hatası döner.

Hata ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	GetInstanceScreenshot	Gerçekleştirmek istediğiniz işlem. Değeri GetInstanceScreenshot olarak ayarlayın.
RegionId	String	Evet	cn-shenzhen	Örneğin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
InstanceId	String	Evet	i-bp1gbz20g229bvu5****	Örneğin kimliği.
WakeUp	Boolean	Hayır	false	Uyku modundaki örneğin uyandırılıp uyandırılmayacağını belirtir. Geçerli değerler: true false Varsayılan değer: false.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	İsteğin kimliği.
InstanceId	String	i-bp1gbz20g229bvu5****	Örneğin kimliği.
Screenshot	String	iVBORw0KGgoA...AAABJRU5ErkJggg==	JPG formatında Base64 ile kodlanmış örnek anlık görüntüsü.

Örnekler

Örnek istekler

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

Başarılı yanıt örnekleri

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=="
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	MissingParameter	%s	Gerekli bir parametre belirtilmemiş.
404	InvalidParameter	%s	Geçersiz parametre değeri.
405	IncorrectInstanceStatus	%s	Bu işlem, mevcut durumdaki örnek üzerinde gerçekleştirilemez.
405	NotSupported	%s	İşleminiz geçersiz.
429	Throttling	%s	İstek kısıtlama nedeniyle reddedildi.

Hata kodlarının listesi için bkz. Hizmet hata kodları.