Skip to content

Describe Elastic Gpus

ec2_describe_elastic_gpus R Documentation

Amazon Elastic Graphics reached end of life on January 8, 2024

Description

Amazon Elastic Graphics reached end of life on January 8, 2024. For workloads that require graphics acceleration, we recommend that you use Amazon EC2 G4, G5, or G6 instances.

Describes the Elastic Graphics accelerator associated with your instances.

Usage

ec2_describe_elastic_gpus(ElasticGpuIds, DryRun, Filters, MaxResults,
  NextToken)

Arguments

ElasticGpuIds

The Elastic Graphics accelerator IDs.

DryRun

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.

Filters

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

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

The token to request the next page of results.

Value

A list with the following syntax: 

list(
  ElasticGpuSet = list(
    list(
      ElasticGpuId = "string",
      AvailabilityZone = "string",
      ElasticGpuType = "string",
      ElasticGpuHealth = list(
        Status = "OK"|"IMPAIRED"
      ),
      ElasticGpuState = "ATTACHED",
      InstanceId = "string",
      Tags = list(
        list(
          Key = "string",
          Value = "string"
        )
      )
    )
  ),
  MaxResults = 123,
  NextToken = "string"
)

Request syntax

svc$describe_elastic_gpus(
  ElasticGpuIds = list(
    "string"
  ),
  DryRun = TRUE|FALSE,
  Filters = list(
    list(
      Name = "string",
      Values = list(
        "string"
      )
    )
  ),
  MaxResults = 123,
  NextToken = "string"
)