describe_accelerators

describe_accelerators(**kwargs)

Describes information over a provided set of accelerators belonging to an account.

See also: AWS API Documentation

Request Syntax

response = client.describe_accelerators(
    acceleratorIds=[
        'string',
    ],
    filters=[
        {
            'name': 'string',
            'values': [
                'string',
            ]
        },
    ],
    maxResults=123,
    nextToken='string'
)
Parameters
  • acceleratorIds (list) --

    The IDs of the accelerators to describe.

    • (string) --
  • filters (list) --

    One or more filters. Filter names and values are case-sensitive. Valid filter names are: accelerator-types: can provide a list of accelerator type names to filter for. instance-id: can provide a list of EC2 instance ids to filter for.

    • (dict) --

      A filter expression for the Elastic Inference Accelerator list.

      • name (string) --

        The filter name for the Elastic Inference Accelerator list. It can assume the following values: accelerator-type: the type of Elastic Inference Accelerator to filter for. instance-id: an EC2 instance id to filter for.

      • values (list) --

        The values for the filter of the Elastic Inference Accelerator list.

        • (string) --
  • maxResults (integer) -- The total number of items to return in the command's output. If the total number of items available is more than the value specified, a NextToken is provided in the command's output. To resume pagination, provide the NextToken value in the starting-token argument of a subsequent command. Do not use the NextToken response element directly outside of the AWS CLI.
  • nextToken (string) -- A token to specify where to start paginating. This is the NextToken from a previously truncated response.
Return type

dict

Returns

Response Syntax

{
    'acceleratorSet': [
        {
            'acceleratorHealth': {
                'status': 'string'
            },
            'acceleratorType': 'string',
            'acceleratorId': 'string',
            'availabilityZone': 'string',
            'attachedResource': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • acceleratorSet (list) --

      The details of the Elastic Inference Accelerators.

      • (dict) --

        The details of an Elastic Inference Accelerator.

        • acceleratorHealth (dict) --

          The health of the Elastic Inference Accelerator.

          • status (string) --

            The health status of the Elastic Inference Accelerator.

        • acceleratorType (string) --

          The type of the Elastic Inference Accelerator.

        • acceleratorId (string) --

          The ID of the Elastic Inference Accelerator.

        • availabilityZone (string) --

          The availability zone where the Elastic Inference Accelerator is present.

        • attachedResource (string) --

          The ARN of the resource that the Elastic Inference Accelerator is attached to.

    • nextToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previously truncated response.

Exceptions

  • ElasticInference.Client.exceptions.BadRequestException
  • ElasticInference.Client.exceptions.ResourceNotFoundException
  • ElasticInference.Client.exceptions.InternalServerException