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

# DescribeDeviceEc2Instances
<a name="API_devicemanagement_DescribeDeviceEc2Instances"></a>

Amazon EC2互換インスタンスの現在の状態を確認します。出力は `describeDevice` に類似していますが、結果は AWS クラウド のデバイス・キャッシュから取得され、使用可能なフィールドのサブセットを含めます。

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

```
POST /managed-device/managedDeviceId/resources/ec2/describe HTTP/1.1
Content-type: application/json

{
   "instanceIds": [ "string" ]
}
```

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

リクエストでは、次のURIパラメータを使用します。

 ** [managedDeviceId](#API_devicemanagement_DescribeDeviceEc2Instances_RequestSyntax) **   <a name="Snowball-devicemanagement_DescribeDeviceEc2Instances-request-uri-managedDeviceId"></a>
管理対象デバイスの ID。  
長さの制限：最小長は 1 です。最大長は 64 文字です。  
必須：はい

## リクエストボディ
<a name="API_devicemanagement_DescribeDeviceEc2Instances_RequestBody"></a>

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

 ** [instanceIds](#API_devicemanagement_DescribeDeviceEc2Instances_RequestSyntax) **   <a name="Snowball-devicemanagement_DescribeDeviceEc2Instances-request-instanceIds"></a>
マネージドデバイスIDsに関連付けられたインスタンスのリスト。  
型: 文字列の配列  
必須：はい

## レスポンスの構文
<a name="API_devicemanagement_DescribeDeviceEc2Instances_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "instances": [ 
      { 
         "instance": { 
            "amiLaunchIndex": number,
            "blockDeviceMappings": [ 
               { 
                  "deviceName": "string",
                  "ebs": { 
                     "attachTime": number,
                     "deleteOnTermination": boolean,
                     "status": "string",
                     "volumeId": "string"
                  }
               }
            ],
            "cpuOptions": { 
               "coreCount": number,
               "threadsPerCore": number
            },
            "createdAt": number,
            "imageId": "string",
            "instanceId": "string",
            "instanceType": "string",
            "privateIpAddress": "string",
            "publicIpAddress": "string",
            "rootDeviceName": "string",
            "securityGroups": [ 
               { 
                  "groupId": "string",
                  "groupName": "string"
               }
            ],
            "state": { 
               "code": number,
               "name": "string"
            },
            "updatedAt": number
         },
         "lastUpdatedAt": number
      }
   ]
}
```

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

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

次のデータは、 サービスによって JSON 形式で返されます。

 ** [instances](#API_devicemanagement_DescribeDeviceEc2Instances_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeDeviceEc2Instances-response-instances"></a>
各インスタンスに関する情報を含む構造のリスト。  
型: [InstanceSummary](API_devicemanagement_InstanceSummary.md) オブジェクトの配列

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

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

 ** AccessDeniedException **   
このアクションを実行する十分なアクセス権限がありません。  
HTTP ステータスコード: 403

 ** InternalServerException **   
リクエストの処理中に予期しないエラーが発生しました。  
HTTP ステータスコード: 500

 ** ResourceNotFoundException **   
リクエストは、存在しないリソースを参照しています。  
HTTP ステータスコード: 404

 ** ThrottlingException **   
リクエストのスロットリングにより、リクエストが拒否されました。  
HTTP ステータスコード: 429

 ** ValidationException **   
入力が AWS サービスで指定された制約を満たさない。  
HTTP ステータスコード: 400

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

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