As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# GetVirtualMachine
<a name="API_BGW_GetVirtualMachine"></a>

Ao fornecer o ARN (Nome do recurso da Amazon), essa API retorna a máquina virtual.

## Sintaxe da solicitação
<a name="API_BGW_GetVirtualMachine_RequestSyntax"></a>

```
{
   "ResourceArn": "string"
}
```

## Parâmetros da solicitação
<a name="API_BGW_GetVirtualMachine_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ResourceArn](#API_BGW_GetVirtualMachine_RequestSyntax) **   <a name="Backup-BGW_GetVirtualMachine-request-ResourceArn"></a>
O Nome do recurso da Amazon (ARN) da máquina virtual.  
Tipo: string  
Restrições de tamanho: tamanho mínimo de 50. Tamanho máximo de 500.  
Padrão: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
Obrigatório: sim

## Sintaxe da resposta
<a name="API_BGW_GetVirtualMachine_ResponseSyntax"></a>

```
{
   "VirtualMachine": { 
      "HostName": "string",
      "HypervisorId": "string",
      "LastBackupDate": number,
      "Name": "string",
      "Path": "string",
      "ResourceArn": "string",
      "VmwareTags": [ 
         { 
            "VmwareCategory": "string",
            "VmwareTagDescription": "string",
            "VmwareTagName": "string"
         }
      ]
   }
}
```

## Elementos de resposta
<a name="API_BGW_GetVirtualMachine_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [VirtualMachine](#API_BGW_GetVirtualMachine_ResponseSyntax) **   <a name="Backup-BGW_GetVirtualMachine-response-VirtualMachine"></a>
Este objeto contém os atributos básicos da `VirtualMachine` contidos na saída da `GetVirtualMachine`   
Tipo: objeto [VirtualMachineDetails](API_BGW_VirtualMachineDetails.md)

## Erros
<a name="API_BGW_GetVirtualMachine_Errors"></a>

Para obter informações sobre os erros comuns a todas as ações, consulte [Tipos de erro comuns](CommonErrors.md).

 ** InternalServerException **   
A operação não teve êxito porque ocorreu um erro interno. Tente novamente mais tarde.    
 ** ErrorCode **   
Uma descrição de qual erro interno ocorreu.
Código de status HTTP: 500

 ** ResourceNotFoundException **   
Um recurso necessário para a ação não foi encontrado.    
 ** ErrorCode **   
A descrição de qual recurso não foi encontrado.
Código de status HTTP: 400

 ** ThrottlingException **   
O TPS foi limitado para proteger contra altos volumes de solicitações intencionais ou não intencionais.    
 ** ErrorCode **   
Erro: o TPS foi limitado para proteger contra altos volumes de solicitações intencionais ou não intencionais.
Código de status HTTP: 400

 ** ValidationException **   
A operação não teve êxito porque ocorreu um erro de validação.    
 ** ErrorCode **   
Uma descrição do que causou o erro de validação.
Código de Status HTTP: 400

## Consulte também
<a name="API_BGW_GetVirtualMachine_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetVirtualMachine)