elastic_gpus

Creates, updates, deletes, gets or lists an elastic_gpus resource.

Overview

Name	elastic_gpus
Type	Resource
Id	aws.ec2.elastic_gpus

Fields

The following fields are returned by SELECT queries:

describe_elastic_gpus

Name	Datatype	Description
availability_zone	string	The Availability Zone in the which the Elastic Graphics accelerator resides.
elastic_gpu_health	string	The status of the Elastic Graphics accelerator.
elastic_gpu_id	string	The ID of the Elastic Graphics accelerator.
elastic_gpu_state	string	The state of the Elastic Graphics accelerator.
elastic_gpu_type	string	The type of Elastic Graphics accelerator.
instance_id	string	The ID of the instance to which the Elastic Graphics accelerator is attached.
tags	string	The tags assigned to the Elastic Graphics accelerator.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
describe_elastic_gpus	select	region	ElasticGpuId, DryRun, Filter, MaxResults, NextToken	Amazon Elastic Graphics reached end of life on January 8, 2024. Describes the Elastic Graphics accelerator associated with your instances.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)
DryRun	boolean	Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
ElasticGpuId	array	The Elastic Graphics accelerator IDs.
Filter	array	The filters. availability-zone - The Availability Zone in which the Elastic Graphics accelerator resides. elastic-gpu-health - The status of the Elastic Graphics accelerator (OK | IMPAIRED). elastic-gpu-state - The state of the Elastic Graphics accelerator (ATTACHED). elastic-gpu-type - The type of Elastic Graphics accelerator; for example, eg1.medium. instance-id - The ID of the instance to which the Elastic Graphics accelerator is associated.
MaxResults	integer	The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value. This value can be between 5 and 1000.
NextToken	string	The token to request the next page of results.

SELECT examples

describe_elastic_gpus

Amazon Elastic Graphics reached end of life on January 8, 2024. Describes the Elastic Graphics accelerator associated with your instances.

SELECT
availability_zone,
elastic_gpu_health,
elastic_gpu_id,
elastic_gpu_state,
elastic_gpu_type,
instance_id,
tags
FROM aws.ec2.elastic_gpus
WHERE region = '{{ region }}' -- required
AND ElasticGpuId = '{{ ElasticGpuId }}'
AND DryRun = '{{ DryRun }}'
AND Filter = '{{ Filter }}'
AND MaxResults = '{{ MaxResults }}'
AND NextToken = '{{ NextToken }}'
;