trunk_interfaces

Creates, updates, deletes, gets or lists a trunk_interfaces resource.

Overview

Name	trunk_interfaces
Type	Resource
Id	aws.ec2.trunk_interfaces

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
associate_trunk_interface	update	BranchInterfaceId, TrunkInterfaceId, region	VlanId, GreKey, ClientToken, DryRun	Associates a branch network interface with a trunk network interface. Before you create the association, use CreateNetworkInterface command and set the interface type to trunk. You must also create a network interface for each branch network interface that you want to associate with the trunk network interface.
disassociate_trunk_interface	update	AssociationId, region	ClientToken, DryRun	Removes an association between a branch network interface with a trunk network interface.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
AssociationId	string	The ID of the association
BranchInterfaceId	string	The ID of the branch network interface.
TrunkInterfaceId	string	The ID of the trunk network interface.
region	string	AWS region (default: us-east-1)
ClientToken	string	Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring idempotency.
DryRun	boolean	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.
GreKey	integer	The application key. This applies to the GRE protocol.
VlanId	integer	The ID of the VLAN. This applies to the VLAN protocol.

UPDATE examples

associate_trunk_interface

Associates a branch network interface with a trunk network interface. Before you create the association, use CreateNetworkInterface command and set the interface type to trunk. You must also create a network interface for each branch network interface that you want to associate with the trunk network interface.

UPDATE aws.ec2.trunk_interfaces
SET 
-- No updatable properties
WHERE 
BranchInterfaceId = '{{ BranchInterfaceId }}' --required
AND TrunkInterfaceId = '{{ TrunkInterfaceId }}' --required
AND region = '{{ region }}' --required
AND VlanId = '{{ VlanId}}'
AND GreKey = '{{ GreKey}}'
AND ClientToken = '{{ ClientToken}}'
AND DryRun = {{ DryRun}}
RETURNING
client_token,
interface_association;

disassociate_trunk_interface

Removes an association between a branch network interface with a trunk network interface.

UPDATE aws.ec2.trunk_interfaces
SET 
-- No updatable properties
WHERE 
AssociationId = '{{ AssociationId }}' --required
AND region = '{{ region }}' --required
AND ClientToken = '{{ ClientToken}}'
AND DryRun = {{ DryRun}}
RETURNING
client_token,
return;