GetInstanceScreenshot - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Une fois qu'ECS renvoie une capture d'écran de l'instance encodée en Base64 au format JPG, vous devez la décoder. Nous vous recommandons d'appeler cette opération à des fins de dépannage et de diagnostic. Tenez compte des points suivants :

L'instance doit être dans l'état Running.
Vous ne pouvez pas obtenir de captures d'écran pour les instances dont les types sont obsolètes. Pour plus d'informations, consultez Types d'instances obsolètes.
Si vous appelez cette opération plusieurs fois sur une même instance, l'intervalle entre les appels doit être d'au moins 10 secondes. Sinon, l'erreur Throttling est renvoyée.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour votre commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	GetInstanceScreenshot	Opération à effectuer. Définissez la valeur sur GetInstanceScreenshot.
RegionId	String	Yes	cn-shenzhen	ID de région de l'instance. Appelez l'opération DescribeRegions pour interroger la liste des régions la plus récente.
InstanceId	String	Yes	i-bp1gbz20g229bvu5****	ID de l'instance.
WakeUp	Boolean	No	false	Indique s'il faut réveiller l'instance en mode veille. Valeurs possibles : true false Valeur par défaut : false.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.
InstanceId	String	i-bp1gbz20g229bvu5****	ID de l'instance.
Screenshot	String	iVBORw0KGgoA...AAABJRU5ErkJggg==	Capture d'écran de l'instance encodée en Base64 au format JPG.

Exemples

Exemple de requête

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

Exemple de réponse en cas de succès

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

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	MissingParameter	%s	Un paramètre requis n'est pas spécifié.
404	InvalidParameter	%s	Valeur de paramètre non valide.
405	IncorrectInstanceStatus	%s	Cette opération ne peut pas être effectuée sur l'instance dans son état actuel.
405	NotSupported	%s	Votre opération n'est pas valide.
429	Throttling	%s	La requête est refusée en raison d'une limitation de débit.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur du service.