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