EC2InstanceConnect

Client

class EC2InstanceConnect.Client

A low-level client representing AWS EC2 Instance Connect

AWS EC2 Connect Service is a service that enables system administrators to publish temporary SSH keys to their EC2 instances in order to establish connections to their instances without leaving a permanent authentication option.

import boto3

client = boto3.client('ec2-instance-connect')

These are the available methods:

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)

Generate a presigned url given a client, its method, and arguments

Parameters
  • ClientMethod (string) -- The client method to presign for
  • Params (dict) -- The parameters normally passed to ClientMethod.
  • ExpiresIn (int) -- The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
  • HttpMethod (string) -- The http method to use on the generated url. By default, the http method is whatever is used in the method's model.
Returns

The presigned url

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
send_ssh_public_key(**kwargs)

Pushes an SSH public key to a particular OS user on a given EC2 instance for 60 seconds.

See also: AWS API Documentation

Request Syntax

response = client.send_ssh_public_key(
    InstanceId='string',
    InstanceOSUser='string',
    SSHPublicKey='string',
    AvailabilityZone='string'
)
Parameters
  • InstanceId (string) --

    [REQUIRED]

    The EC2 instance you wish to publish the SSH key to.

  • InstanceOSUser (string) --

    [REQUIRED]

    The OS user on the EC2 instance whom the key may be used to authenticate as.

  • SSHPublicKey (string) --

    [REQUIRED]

    The public key to be published to the instance. To use it after publication you must have the matching private key.

  • AvailabilityZone (string) --

    [REQUIRED]

    The availability zone the EC2 instance was launched in.

Return type

dict

Returns

Response Syntax

{
    'RequestId': 'string',
    'Success': True|False
}

Response Structure

  • (dict) --

    • RequestId (string) --

      The request ID as logged by EC2 Connect. Please provide this when contacting AWS Support.

    • Success (boolean) --

      Indicates request success.

Exceptions

  • EC2InstanceConnect.Client.exceptions.AuthException
  • EC2InstanceConnect.Client.exceptions.InvalidArgsException
  • EC2InstanceConnect.Client.exceptions.ServiceException
  • EC2InstanceConnect.Client.exceptions.ThrottlingException
  • EC2InstanceConnect.Client.exceptions.EC2InstanceNotFoundException

Paginators

The available paginators are: