AWS API Changes

2017/02/09 - Amazon Elastic Compute Cloud - 4 new api methods

Changes This feature allows customers to associate an IAM profile to running instances that do not have any.

AssociateIamInstanceProfile (new)

Associates an IAM instance profile with a running or stopped instance. You cannot associate more than one IAM instance profile with an instance.

See also: AWS API Documentation

Request Syntax

client.associate_iam_instance_profile(
    IamInstanceProfile={
        'Arn': 'string',
        'Name': 'string'
    },
    InstanceId='string'
)

type IamInstanceProfile

dict

param IamInstanceProfile

[REQUIRED]

The IAM instance profile.

Arn (string) --

The Amazon Resource Name (ARN) of the instance profile.
Name (string) --

The name of the instance profile.

type InstanceId

string

param InstanceId

[REQUIRED]

The ID of the instance.

rtype

dict

returns

Response Syntax

{
    'IamInstanceProfileAssociation': {
        'AssociationId': 'string',
        'InstanceId': 'string',
        'IamInstanceProfile': {
            'Arn': 'string',
            'Id': 'string'
        },
        'State': 'associating'|'associated'|'disassociating'|'disassociated',
        'Timestamp': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) --
- IamInstanceProfileAssociation (dict) --
  
  Information about the IAM instance profile association.
  - AssociationId (string) --
    
    The ID of the association.
  - InstanceId (string) --
    
    The ID of the instance.
  - IamInstanceProfile (dict) --
    
    The IAM instance profile.
    - Arn (string) --
      
      The Amazon Resource Name (ARN) of the instance profile.
    - Id (string) --
      
      The ID of the instance profile.
  - State (string) --
    
    The state of the association.
  - Timestamp (datetime) --
    
    The time the IAM instance profile was associated with the instance.

DisassociateIamInstanceProfile (new)

Link ¶

Disassociates an IAM instance profile from a running or stopped instance.

Use DescribeIamInstanceProfileAssociations to get the association ID.

See also: AWS API Documentation

Request Syntax

client.disassociate_iam_instance_profile(
    AssociationId='string'
)

type AssociationId

string

param AssociationId

[REQUIRED]

The ID of the IAM instance profile association.

rtype

dict

returns

Response Syntax

{
    'IamInstanceProfileAssociation': {
        'AssociationId': 'string',
        'InstanceId': 'string',
        'IamInstanceProfile': {
            'Arn': 'string',
            'Id': 'string'
        },
        'State': 'associating'|'associated'|'disassociating'|'disassociated',
        'Timestamp': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) --
- IamInstanceProfileAssociation (dict) --
  
  Information about the IAM instance profile association.
  - AssociationId (string) --
    
    The ID of the association.
  - InstanceId (string) --
    
    The ID of the instance.
  - IamInstanceProfile (dict) --
    
    The IAM instance profile.
    - Arn (string) --
      
      The Amazon Resource Name (ARN) of the instance profile.
    - Id (string) --
      
      The ID of the instance profile.
  - State (string) --
    
    The state of the association.
  - Timestamp (datetime) --
    
    The time the IAM instance profile was associated with the instance.

ReplaceIamInstanceProfileAssociation (new)

Link ¶

Replaces an IAM instance profile for the specified instance. You can use this action to change the IAM instance profile that's associated with an instance without having to disassociate the existing IAM instance profile first.

Use DescribeIamInstanceProfileAssociations to get the association ID.

See also: AWS API Documentation

Request Syntax

client.replace_iam_instance_profile_association(
    IamInstanceProfile={
        'Arn': 'string',
        'Name': 'string'
    },
    AssociationId='string'
)

type IamInstanceProfile

dict

param IamInstanceProfile

[REQUIRED]

The IAM instance profile.

Arn (string) --

The Amazon Resource Name (ARN) of the instance profile.
Name (string) --

The name of the instance profile.

type AssociationId

string

param AssociationId

[REQUIRED]

The ID of the existing IAM instance profile association.

rtype

dict

returns

Response Syntax

{
    'IamInstanceProfileAssociation': {
        'AssociationId': 'string',
        'InstanceId': 'string',
        'IamInstanceProfile': {
            'Arn': 'string',
            'Id': 'string'
        },
        'State': 'associating'|'associated'|'disassociating'|'disassociated',
        'Timestamp': datetime(2015, 1, 1)
    }
}

Response Structure

(dict) --
- IamInstanceProfileAssociation (dict) --
  
  Information about the IAM instance profile association.
  - AssociationId (string) --
    
    The ID of the association.
  - InstanceId (string) --
    
    The ID of the instance.
  - IamInstanceProfile (dict) --
    
    The IAM instance profile.
    - Arn (string) --
      
      The Amazon Resource Name (ARN) of the instance profile.
    - Id (string) --
      
      The ID of the instance profile.
  - State (string) --
    
    The state of the association.
  - Timestamp (datetime) --
    
    The time the IAM instance profile was associated with the instance.

DescribeIamInstanceProfileAssociations (new)

Link ¶

Describes your IAM instance profile associations.

See also: AWS API Documentation

Request Syntax

client.describe_iam_instance_profile_associations(
    AssociationIds=[
        'string',
    ],
    Filters=[
        {
            'Name': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    MaxResults=123,
    NextToken='string'
)

type AssociationIds

list

param AssociationIds

One or more IAM instance profile associations.

(string) --

type Filters

list

param Filters

One or more filters.

instance-id - The ID of the instance.
state - The state of the association ( associating | associated | disassociating | disassociated ).

(dict) --

A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria, such as tags, attributes, or IDs.
- Name (string) --
  
  The name of the filter. Filter names are case-sensitive.
- Values (list) --
  
  One or more filter values. Filter values are case-sensitive.
  - (string) --

type MaxResults

integer

param 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.

type NextToken

string

param NextToken

The token to request the next page of results.

rtype

dict

returns

Response Syntax

{
    'IamInstanceProfileAssociations': [
        {
            'AssociationId': 'string',
            'InstanceId': 'string',
            'IamInstanceProfile': {
                'Arn': 'string',
                'Id': 'string'
            },
            'State': 'associating'|'associated'|'disassociating'|'disassociated',
            'Timestamp': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) --
- IamInstanceProfileAssociations (list) --
  
  Information about one or more IAM instance profile associations.
  - (dict) --
    
    Describes an association between an IAM instance profile and an instance.
    - AssociationId (string) --
      
      The ID of the association.
    - InstanceId (string) --
      
      The ID of the instance.
    - IamInstanceProfile (dict) --
      
      The IAM instance profile.
      - Arn (string) --
        
        The Amazon Resource Name (ARN) of the instance profile.
      - Id (string) --
        
        The ID of the instance profile.
    - State (string) --
      
      The state of the association.
    - Timestamp (datetime) --
      
      The time the IAM instance profile was associated with the instance.
- NextToken (string) --
  
  The token to use to retrieve the next page of results. This value is null when there are no more results to return.