GetRouterInterfaces

This data source provides information about router interfaces that connect VPCs together.

Example Usage

using Pulumi;
using AliCloud = Pulumi.AliCloud;

class MyStack : Stack
{
    public MyStack()
    {
        var routerInterfacesDs = Output.Create(AliCloud.Vpc.GetRouterInterfaces.InvokeAsync(new AliCloud.Vpc.GetRouterInterfacesArgs
        {
            NameRegex = "^testenv",
            Status = "Active",
        }));
        this.FirstRouterInterfaceId = routerInterfacesDs.Apply(routerInterfacesDs => routerInterfacesDs.Interfaces[0].Id);
    }

    [Output("firstRouterInterfaceId")]
    public Output<string> FirstRouterInterfaceId { get; set; }
}

Coming soon!

import pulumi
import pulumi_alicloud as alicloud

router_interfaces_ds = alicloud.vpc.get_router_interfaces(name_regex="^testenv",
    status="Active")
pulumi.export("firstRouterInterfaceId", router_interfaces_ds.interfaces[0]["id"])

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";

const routerInterfacesDs = pulumi.output(alicloud.vpc.getRouterInterfaces({
    nameRegex: "^testenv",
    status: "Active",
}, { async: true }));

export const firstRouterInterfaceId = routerInterfacesDs.interfaces[0].id;

Using GetRouterInterfaces

function getRouterInterfaces(args: GetRouterInterfacesArgs, opts?: InvokeOptions): Promise<GetRouterInterfacesResult>

function  get_router_interfaces(ids=None, name_regex=None, opposite_interface_id=None, opposite_interface_owner_id=None, output_file=None, role=None, router_id=None, router_type=None, specification=None, status=None, opts=None)

func GetRouterInterfaces(ctx *Context, args *GetRouterInterfacesArgs, opts ...InvokeOption) (*GetRouterInterfacesResult, error)

public static class GetRouterInterfaces {
    public static Task<GetRouterInterfacesResult> InvokeAsync(GetRouterInterfacesArgs args, InvokeOptions? opts = null)
}

The following arguments are supported:

Ids List<string>: A list of router interface IDs.
NameRegex string: A regex string used to filter by router interface name.
OppositeInterfaceId string: ID of the peer router interface.
OppositeInterfaceOwnerId string: Account ID of the owner of the peer router interface.
OutputFile string
Role string: Role of the router interface. Valid values are InitiatingSide (connection initiator) and AcceptingSide (connection receiver). The value of this parameter must be InitiatingSide if the router_type is set to VBR.
RouterId string: ID of the VRouter located in the local region.
RouterType string: Router type in the local region. Valid values are VRouter and VBR (physical connection).
Specification string: Specification of the link, such as Small.1 (10Mb), Middle.1 (100Mb), Large.2 (2Gb), …etc.
Status string: Expected status. Valid values are Active, Inactive and Idle.

Ids []string: A list of router interface IDs.
NameRegex string: A regex string used to filter by router interface name.
OppositeInterfaceId string: ID of the peer router interface.
OppositeInterfaceOwnerId string: Account ID of the owner of the peer router interface.
OutputFile string
Role string: Role of the router interface. Valid values are InitiatingSide (connection initiator) and AcceptingSide (connection receiver). The value of this parameter must be InitiatingSide if the router_type is set to VBR.
RouterId string: ID of the VRouter located in the local region.
RouterType string: Router type in the local region. Valid values are VRouter and VBR (physical connection).
Specification string: Specification of the link, such as Small.1 (10Mb), Middle.1 (100Mb), Large.2 (2Gb), …etc.
Status string: Expected status. Valid values are Active, Inactive and Idle.

ids string[]: A list of router interface IDs.
nameRegex string: A regex string used to filter by router interface name.
oppositeInterfaceId string: ID of the peer router interface.
oppositeInterfaceOwnerId string: Account ID of the owner of the peer router interface.
outputFile string
role string: Role of the router interface. Valid values are InitiatingSide (connection initiator) and AcceptingSide (connection receiver). The value of this parameter must be InitiatingSide if the router_type is set to VBR.
routerId string: ID of the VRouter located in the local region.
routerType string: Router type in the local region. Valid values are VRouter and VBR (physical connection).
specification string: Specification of the link, such as Small.1 (10Mb), Middle.1 (100Mb), Large.2 (2Gb), …etc.
status string: Expected status. Valid values are Active, Inactive and Idle.

ids List[str]: A list of router interface IDs.
name_regex str: A regex string used to filter by router interface name.
opposite_interface_id str: ID of the peer router interface.
opposite_interface_owner_id str: Account ID of the owner of the peer router interface.
output_file str
role str: Role of the router interface. Valid values are InitiatingSide (connection initiator) and AcceptingSide (connection receiver). The value of this parameter must be InitiatingSide if the router_type is set to VBR.
router_id str: ID of the VRouter located in the local region.
router_type str: Router type in the local region. Valid values are VRouter and VBR (physical connection).
specification str: Specification of the link, such as Small.1 (10Mb), Middle.1 (100Mb), Large.2 (2Gb), …etc.
status str: Expected status. Valid values are Active, Inactive and Idle.

GetRouterInterfaces Result

The following output properties are available:

Id string: The provider-assigned unique ID for this managed resource.
Ids List<string>: A list of router interface IDs.
Interfaces List<Pulumi.AliCloud.Vpc.Outputs.GetRouterInterfacesInterface>: A list of router interfaces. Each element contains the following attributes:
Names List<string>: A list of router interface names.
NameRegex string
OppositeInterfaceId string: Peer router interface ID.
OppositeInterfaceOwnerId string: Account ID of the owner of the peer router interface.
OutputFile string
Role string: Router interface role. Possible values: InitiatingSide and AcceptingSide.
RouterId string: ID of the VRouter located in the local region.
RouterType string: Router type in the local region. Possible values: VRouter and VBR.
Specification string: Router interface specification. Possible values: Small.1, Middle.1, Large.2, …etc.
Status string: Router interface status. Possible values: Active, Inactive and Idle.

Id string: The provider-assigned unique ID for this managed resource.
Ids []string: A list of router interface IDs.
Interfaces []GetRouterInterfacesInterface: A list of router interfaces. Each element contains the following attributes:
Names []string: A list of router interface names.
NameRegex string
OppositeInterfaceId string: Peer router interface ID.
OppositeInterfaceOwnerId string: Account ID of the owner of the peer router interface.
OutputFile string
Role string: Router interface role. Possible values: InitiatingSide and AcceptingSide.
RouterId string: ID of the VRouter located in the local region.
RouterType string: Router type in the local region. Possible values: VRouter and VBR.
Specification string: Router interface specification. Possible values: Small.1, Middle.1, Large.2, …etc.
Status string: Router interface status. Possible values: Active, Inactive and Idle.

id string: The provider-assigned unique ID for this managed resource.
ids string[]: A list of router interface IDs.
interfaces GetRouterInterfacesInterface[]: A list of router interfaces. Each element contains the following attributes:
names string[]: A list of router interface names.
nameRegex string
oppositeInterfaceId string: Peer router interface ID.
oppositeInterfaceOwnerId string: Account ID of the owner of the peer router interface.
outputFile string
role string: Router interface role. Possible values: InitiatingSide and AcceptingSide.
routerId string: ID of the VRouter located in the local region.
routerType string: Router type in the local region. Possible values: VRouter and VBR.
specification string: Router interface specification. Possible values: Small.1, Middle.1, Large.2, …etc.
status string: Router interface status. Possible values: Active, Inactive and Idle.

id str: The provider-assigned unique ID for this managed resource.
ids List[str]: A list of router interface IDs.
interfaces List[GetRouterInterfacesInterface]: A list of router interfaces. Each element contains the following attributes:
names List[str]: A list of router interface names.
name_regex str
opposite_interface_id str: Peer router interface ID.
opposite_interface_owner_id str: Account ID of the owner of the peer router interface.
output_file str
role str: Router interface role. Possible values: InitiatingSide and AcceptingSide.
router_id str: ID of the VRouter located in the local region.
router_type str: Router type in the local region. Possible values: VRouter and VBR.
specification str: Router interface specification. Possible values: Small.1, Middle.1, Large.2, …etc.
status str: Router interface status. Possible values: Active, Inactive and Idle.

Supporting Types

GetRouterInterfacesInterface

See the output API doc for this type.

AccessPointId string: ID of the access point used by the VBR.
CreationTime string: Router interface creation time.
Description string: Router interface description.
HealthCheckSourceIp string: Source IP address used to perform health check on the physical connection.
HealthCheckTargetIp string: Destination IP address used to perform health check on the physical connection.
Id string: Router interface ID.
Name string: Router interface name.
OppositeInterfaceId string: ID of the peer router interface.
OppositeInterfaceOwnerId string: Account ID of the owner of the peer router interface.
OppositeRegionId string: Peer router region ID.
OppositeRouterId string: Peer router ID.
OppositeRouterType string: Router type in the peer region. Possible values: VRouter and VBR.
Role string: Role of the router interface. Valid values are InitiatingSide (connection initiator) and AcceptingSide (connection receiver). The value of this parameter must be InitiatingSide if the router_type is set to VBR.
RouterId string: ID of the VRouter located in the local region.
RouterType string: Router type in the local region. Valid values are VRouter and VBR (physical connection).
Specification string: Specification of the link, such as Small.1 (10Mb), Middle.1 (100Mb), Large.2 (2Gb), …etc.
Status string: Expected status. Valid values are Active, Inactive and Idle.
VpcId string: ID of the VPC that owns the router in the local region.

AccessPointId string: ID of the access point used by the VBR.
CreationTime string: Router interface creation time.
Description string: Router interface description.
HealthCheckSourceIp string: Source IP address used to perform health check on the physical connection.
HealthCheckTargetIp string: Destination IP address used to perform health check on the physical connection.
Id string: Router interface ID.
Name string: Router interface name.
OppositeInterfaceId string: ID of the peer router interface.
OppositeInterfaceOwnerId string: Account ID of the owner of the peer router interface.
OppositeRegionId string: Peer router region ID.
OppositeRouterId string: Peer router ID.
OppositeRouterType string: Router type in the peer region. Possible values: VRouter and VBR.
Role string: Role of the router interface. Valid values are InitiatingSide (connection initiator) and AcceptingSide (connection receiver). The value of this parameter must be InitiatingSide if the router_type is set to VBR.
RouterId string: ID of the VRouter located in the local region.
RouterType string: Router type in the local region. Valid values are VRouter and VBR (physical connection).
Specification string: Specification of the link, such as Small.1 (10Mb), Middle.1 (100Mb), Large.2 (2Gb), …etc.
Status string: Expected status. Valid values are Active, Inactive and Idle.
VpcId string: ID of the VPC that owns the router in the local region.

accessPointId string: ID of the access point used by the VBR.
creationTime string: Router interface creation time.
description string: Router interface description.
healthCheckSourceIp string: Source IP address used to perform health check on the physical connection.
healthCheckTargetIp string: Destination IP address used to perform health check on the physical connection.
id string: Router interface ID.
name string: Router interface name.
oppositeInterfaceId string: ID of the peer router interface.
oppositeInterfaceOwnerId string: Account ID of the owner of the peer router interface.
oppositeRegionId string: Peer router region ID.
oppositeRouterId string: Peer router ID.
oppositeRouterType string: Router type in the peer region. Possible values: VRouter and VBR.
role string: Role of the router interface. Valid values are InitiatingSide (connection initiator) and AcceptingSide (connection receiver). The value of this parameter must be InitiatingSide if the router_type is set to VBR.
routerId string: ID of the VRouter located in the local region.
routerType string: Router type in the local region. Valid values are VRouter and VBR (physical connection).
specification string: Specification of the link, such as Small.1 (10Mb), Middle.1 (100Mb), Large.2 (2Gb), …etc.
status string: Expected status. Valid values are Active, Inactive and Idle.
vpcId string: ID of the VPC that owns the router in the local region.

access_point_id str: ID of the access point used by the VBR.
creation_time str: Router interface creation time.
description str: Router interface description.
health_check_source_ip str: Source IP address used to perform health check on the physical connection.
health_check_target_ip str: Destination IP address used to perform health check on the physical connection.
id str: Router interface ID.
name str: Router interface name.
oppositeRegionId str: Peer router region ID.
opposite_interface_id str: ID of the peer router interface.
opposite_interface_owner_id str: Account ID of the owner of the peer router interface.
opposite_router_id str: Peer router ID.
opposite_router_type str: Router type in the peer region. Possible values: VRouter and VBR.
role str: Role of the router interface. Valid values are InitiatingSide (connection initiator) and AcceptingSide (connection receiver). The value of this parameter must be InitiatingSide if the router_type is set to VBR.
router_id str: ID of the VRouter located in the local region.
router_type str: Router type in the local region. Valid values are VRouter and VBR (physical connection).
specification str: Specification of the link, such as Small.1 (10Mb), Middle.1 (100Mb), Large.2 (2Gb), …etc.
status str: Expected status. Valid values are Active, Inactive and Idle.
vpc_id str: ID of the VPC that owns the router in the local region.

Package Details

Repository: https://github.com/pulumi/pulumi-alicloud
License: Apache-2.0
Notes: This Pulumi package is based on the alicloud Terraform Provider.

The Pulumi Platform

Get Started

Migrate to Pulumi

Solutions for All Teams and Engineers

Any Code

Any Cloud

GetRouterInterfaces

Example Usage

Using GetRouterInterfaces

GetRouterInterfaces Result

Supporting Types

GetRouterInterfacesInterface

Package Details

On This Page