Skip to content

EC2  >  Operations  >  associate_trunk_interface

associate_trunk_interface

Operation

associate_trunk_interface async

associate_trunk_interface(input: AssociateTrunkInterfaceInput, plugins: list[Plugin] | None = None) -> AssociateTrunkInterfaceOutput

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.

Parameters:

Name Type Description Default
input AssociateTrunkInterfaceInput

An instance of AssociateTrunkInterfaceInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
AssociateTrunkInterfaceOutput

An instance of AssociateTrunkInterfaceOutput.

Input

AssociateTrunkInterfaceInput dataclass

Bases: _SerdeShape

Dataclass for AssociateTrunkInterfaceInput structure.

Attributes

branch_interface_id class-attribute instance-attribute
branch_interface_id: str | None = ...

The ID of the branch network interface.

client_token class-attribute instance-attribute
client_token: str | None = ...

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring idempotency.

This field is autopopulated if not provided.

dry_run class-attribute instance-attribute
dry_run: bool | None = ...

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.

gre_key class-attribute instance-attribute
gre_key: int | None = ...

The application key. This applies to the GRE protocol.

trunk_interface_id class-attribute instance-attribute
trunk_interface_id: str | None = ...

The ID of the trunk network interface.

vlan_id class-attribute instance-attribute
vlan_id: int | None = ...

The ID of the VLAN. This applies to the VLAN protocol.

Output

AssociateTrunkInterfaceOutput dataclass

Bases: _SerdeShape

Dataclass for AssociateTrunkInterfaceOutput structure.

Attributes

client_token class-attribute instance-attribute
client_token: str | None = ...

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring idempotency.

interface_association class-attribute instance-attribute
interface_association: TrunkInterfaceAssociation | None = ...

Information about the association between the trunk network interface and branch network interface.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.