AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Associates a virtual interface with a specified link aggregation group (LAG) or connection. Connectivity to Amazon Web Services is temporarily interrupted as the virtual interface is being migrated. If the target connection or LAG has an associated virtual interface with a conflicting VLAN number or a conflicting IP address, the operation fails.

Virtual interfaces associated with a hosted connection cannot be associated with a LAG; hosted connections must be migrated along with their virtual interfaces using AssociateHostedConnection.

To reassociate a virtual interface to a new connection or LAG, the requester must own either the virtual interface itself or the connection to which the virtual interface is currently associated. Additionally, the requester must own the connection or LAG for the association.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginAssociateVirtualInterface and EndAssociateVirtualInterface.

Namespace: Amazon.DirectConnect
Assembly: AWSSDK.DirectConnect.dll
Version: 3.x.y.z

Syntax

C#
public abstract Task<AssociateVirtualInterfaceResponse> AssociateVirtualInterfaceAsync(
         AssociateVirtualInterfaceRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.DirectConnect.Model.AssociateVirtualInterfaceRequest

Container for the necessary parameters to execute the AssociateVirtualInterface service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the AssociateVirtualInterface service method, as returned by DirectConnect.

Exceptions

ExceptionCondition
DirectConnectClientException One or more parameters are not valid.
DirectConnectServerException A server-side error occurred.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also