翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

ARN (Amazon リソースネーム) を指定することで、この API は仮想マシンを返します。

## リクエストの構文
<a name="API_BGW_GetVirtualMachine_RequestSyntax"></a>

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

## リクエストパラメーター
<a name="API_BGW_GetVirtualMachine_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [ResourceArn](#API_BGW_GetVirtualMachine_RequestSyntax) **   <a name="Backup-BGW_GetVirtualMachine-request-ResourceArn"></a>
仮想マシンの Amazon リソースネーム (ARN)です。  
タイプ: 文字列  
長さの制限: 最小長は 50 です。500 の最大長。  
パターン: `arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+`   
必須: はい

## レスポンスの構文
<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"
         }
      ]
   }
}
```

## レスポンス要素
<a name="API_BGW_GetVirtualMachine_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [VirtualMachine](#API_BGW_GetVirtualMachine_ResponseSyntax) **   <a name="Backup-BGW_GetVirtualMachine-response-VirtualMachine"></a>
このオブジェクトには、`GetVirtualMachine` の出力に含まれる `VirtualMachine` の基本属性が含まれています。  
型: [VirtualMachineDetails](API_BGW_VirtualMachineDetails.md) オブジェクト

## エラー
<a name="API_BGW_GetVirtualMachine_Errors"></a>

すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。

 ** InternalServerException **   
内部エラーが発生したために操作は成功しませんでした。後でもう一度お試しください。    
 ** ErrorCode **   
発生した内部エラーの説明。
HTTP ステータスコード: 500

 ** ResourceNotFoundException **   
アクションに必要なリソースが見つかりませんでした。    
 ** ErrorCode **   
見つからないリソースの説明。
HTTP ステータスコード: 400

 ** ThrottlingException **   
TPS は、意図的なまたは意図的でない、大量のリクエストを防ぐために制限されています。    
 ** ErrorCode **   
エラー: TPS は、意図的なまたは意図的でない、大量のリクエストを防ぐために制限されています。
HTTP ステータスコード: 400

 ** ValidationException **   
検証エラーが発生したため、操作は成功しませんでした。    
 ** ErrorCode **   
検証エラーの原因の説明。
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_BGW_GetVirtualMachine_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/backup-gateway-2021-01-01/GetVirtualMachine) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-gateway-2021-01-01/GetVirtualMachine)