GetVirtualMachine
Al proporcionar el ARN (nombre de recurso de Amazon), esta API devuelve la máquina virtual.
Sintaxis de la solicitud
{
"ResourceArn": "string"
}Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en formato JSON.
- ResourceArn
-
El nombre de recurso de Amazon (ARN) de la máquina virtual.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+$Obligatorio: sí
Sintaxis de la respuesta
{
"VirtualMachine": {
"HostName": "string",
"HypervisorId": "string",
"LastBackupDate": number,
"Name": "string",
"Path": "string",
"ResourceArn": "string",
"VmwareTags": [
{
"VmwareCategory": "string",
"VmwareTagDescription": "string",
"VmwareTagName": "string"
}
]
}
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- VirtualMachine
-
Este objeto contiene los atributos básicos de las
VirtualMachinecontenidas en el resultado deGetVirtualMachineTipo: objeto VirtualMachineDetails
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InternalServerException
-
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.
Código de estado HTTP: 500
- ResourceNotFoundException
-
No se encontró un recurso necesario para la acción.
Código de estado HTTP: 400
- ThrottlingException
-
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400
- ValidationException
-
La operación no se realizó correctamente porque se produjo un error de validación.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
