Cisco NX-OS v0.0.2 published on Friday, Sep 29, 2023 by lbrlabs
nxos.getPortChannelInterface
Explore with Pulumi AI
This data source can read the configuration of a port-channel interface.
- API Documentation: pcAggrIf
 
Example Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Nxos = Pulumi.Nxos;
return await Deployment.RunAsync(() => 
{
    var example = Nxos.GetPortChannelInterface.Invoke(new()
    {
        InterfaceId = "po1",
    });
});
package main
import (
	"github.com/lbrlabs/pulumi-nxos/sdk/go/nxos"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := nxos.LookupPortChannelInterface(ctx, &nxos.LookupPortChannelInterfaceArgs{
			InterfaceId: "po1",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.nxos.NxosFunctions;
import com.pulumi.nxos.inputs.GetPortChannelInterfaceArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var example = NxosFunctions.getPortChannelInterface(GetPortChannelInterfaceArgs.builder()
            .interfaceId("po1")
            .build());
    }
}
import pulumi
import pulumi_nxos as nxos
example = nxos.get_port_channel_interface(interface_id="po1")
import * as pulumi from "@pulumi/pulumi";
import * as nxos from "@pulumi/nxos";
const example = nxos.getPortChannelInterface({
    interfaceId: "po1",
});
variables:
  example:
    fn::invoke:
      Function: nxos:getPortChannelInterface
      Arguments:
        interfaceId: po1
Using getPortChannelInterface
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getPortChannelInterface(args: GetPortChannelInterfaceArgs, opts?: InvokeOptions): Promise<GetPortChannelInterfaceResult>
function getPortChannelInterfaceOutput(args: GetPortChannelInterfaceOutputArgs, opts?: InvokeOptions): Output<GetPortChannelInterfaceResult>def get_port_channel_interface(device: Optional[str] = None,
                               interface_id: Optional[str] = None,
                               opts: Optional[InvokeOptions] = None) -> GetPortChannelInterfaceResult
def get_port_channel_interface_output(device: Optional[pulumi.Input[str]] = None,
                               interface_id: Optional[pulumi.Input[str]] = None,
                               opts: Optional[InvokeOptions] = None) -> Output[GetPortChannelInterfaceResult]func LookupPortChannelInterface(ctx *Context, args *LookupPortChannelInterfaceArgs, opts ...InvokeOption) (*LookupPortChannelInterfaceResult, error)
func LookupPortChannelInterfaceOutput(ctx *Context, args *LookupPortChannelInterfaceOutputArgs, opts ...InvokeOption) LookupPortChannelInterfaceResultOutput> Note: This function is named LookupPortChannelInterface in the Go SDK.
public static class GetPortChannelInterface 
{
    public static Task<GetPortChannelInterfaceResult> InvokeAsync(GetPortChannelInterfaceArgs args, InvokeOptions? opts = null)
    public static Output<GetPortChannelInterfaceResult> Invoke(GetPortChannelInterfaceInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetPortChannelInterfaceResult> getPortChannelInterface(GetPortChannelInterfaceArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: nxos:index/getPortChannelInterface:getPortChannelInterface
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Interface
Id string - Must match first field in the output of 
show intf brief. Example:po1. - Device string
 - A device name from the provider configuration.
 
- Interface
Id string - Must match first field in the output of 
show intf brief. Example:po1. - Device string
 - A device name from the provider configuration.
 
- interface
Id String - Must match first field in the output of 
show intf brief. Example:po1. - device String
 - A device name from the provider configuration.
 
- interface
Id string - Must match first field in the output of 
show intf brief. Example:po1. - device string
 - A device name from the provider configuration.
 
- interface_
id str - Must match first field in the output of 
show intf brief. Example:po1. - device str
 - A device name from the provider configuration.
 
- interface
Id String - Must match first field in the output of 
show intf brief. Example:po1. - device String
 - A device name from the provider configuration.
 
getPortChannelInterface Result
The following output properties are available:
- Access
Vlan string - Access VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - Admin
State string - Administrative port state.
 - Auto
Negotiation string - Administrative port auto-negotiation.
 - Bandwidth int
 - The bandwidth parameter for a routed interface, port channel, or subinterface.
 - Delay int
 - The administrative port delay time.
 - Description string
 - Interface description.
 - Duplex string
 - Duplex.
 - Id string
 - The distinguished name of the object.
 - Interface
Id string - Must match first field in the output of 
show intf brief. Example:po1. - Layer string
 - Administrative port layer.
 - Link
Logging string - Administrative link logging.
 - Maximum
Links int - Maximum links.
 - Medium string
 - The administrative port medium type.
 - Minimum
Links int - Minimum links.
 - Mode string
 - Administrative port mode.
 - Mtu int
 - Administrative port MTU.
 - Native
Vlan string - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - Port
Channel stringMode  - The aggregated interface protocol channel mode.
 - Speed string
 - Administrative port speed.
 - Suspend
Individual string - Suspend Individual Port.
 - Trunk
Vlans string - List of trunk VLANs.
 - User
Configured stringFlags  - Port User Config Flags.
 - Device string
 - A device name from the provider configuration.
 
- Access
Vlan string - Access VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - Admin
State string - Administrative port state.
 - Auto
Negotiation string - Administrative port auto-negotiation.
 - Bandwidth int
 - The bandwidth parameter for a routed interface, port channel, or subinterface.
 - Delay int
 - The administrative port delay time.
 - Description string
 - Interface description.
 - Duplex string
 - Duplex.
 - Id string
 - The distinguished name of the object.
 - Interface
Id string - Must match first field in the output of 
show intf brief. Example:po1. - Layer string
 - Administrative port layer.
 - Link
Logging string - Administrative link logging.
 - Maximum
Links int - Maximum links.
 - Medium string
 - The administrative port medium type.
 - Minimum
Links int - Minimum links.
 - Mode string
 - Administrative port mode.
 - Mtu int
 - Administrative port MTU.
 - Native
Vlan string - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - Port
Channel stringMode  - The aggregated interface protocol channel mode.
 - Speed string
 - Administrative port speed.
 - Suspend
Individual string - Suspend Individual Port.
 - Trunk
Vlans string - List of trunk VLANs.
 - User
Configured stringFlags  - Port User Config Flags.
 - Device string
 - A device name from the provider configuration.
 
- access
Vlan String - Access VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - admin
State String - Administrative port state.
 - auto
Negotiation String - Administrative port auto-negotiation.
 - bandwidth Integer
 - The bandwidth parameter for a routed interface, port channel, or subinterface.
 - delay Integer
 - The administrative port delay time.
 - description String
 - Interface description.
 - duplex String
 - Duplex.
 - id String
 - The distinguished name of the object.
 - interface
Id String - Must match first field in the output of 
show intf brief. Example:po1. - layer String
 - Administrative port layer.
 - link
Logging String - Administrative link logging.
 - maximum
Links Integer - Maximum links.
 - medium String
 - The administrative port medium type.
 - minimum
Links Integer - Minimum links.
 - mode String
 - Administrative port mode.
 - mtu Integer
 - Administrative port MTU.
 - native
Vlan String - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - port
Channel StringMode  - The aggregated interface protocol channel mode.
 - speed String
 - Administrative port speed.
 - suspend
Individual String - Suspend Individual Port.
 - trunk
Vlans String - List of trunk VLANs.
 - user
Configured StringFlags  - Port User Config Flags.
 - device String
 - A device name from the provider configuration.
 
- access
Vlan string - Access VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - admin
State string - Administrative port state.
 - auto
Negotiation string - Administrative port auto-negotiation.
 - bandwidth number
 - The bandwidth parameter for a routed interface, port channel, or subinterface.
 - delay number
 - The administrative port delay time.
 - description string
 - Interface description.
 - duplex string
 - Duplex.
 - id string
 - The distinguished name of the object.
 - interface
Id string - Must match first field in the output of 
show intf brief. Example:po1. - layer string
 - Administrative port layer.
 - link
Logging string - Administrative link logging.
 - maximum
Links number - Maximum links.
 - medium string
 - The administrative port medium type.
 - minimum
Links number - Minimum links.
 - mode string
 - Administrative port mode.
 - mtu number
 - Administrative port MTU.
 - native
Vlan string - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - port
Channel stringMode  - The aggregated interface protocol channel mode.
 - speed string
 - Administrative port speed.
 - suspend
Individual string - Suspend Individual Port.
 - trunk
Vlans string - List of trunk VLANs.
 - user
Configured stringFlags  - Port User Config Flags.
 - device string
 - A device name from the provider configuration.
 
- access_
vlan str - Access VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - admin_
state str - Administrative port state.
 - auto_
negotiation str - Administrative port auto-negotiation.
 - bandwidth int
 - The bandwidth parameter for a routed interface, port channel, or subinterface.
 - delay int
 - The administrative port delay time.
 - description str
 - Interface description.
 - duplex str
 - Duplex.
 - id str
 - The distinguished name of the object.
 - interface_
id str - Must match first field in the output of 
show intf brief. Example:po1. - layer str
 - Administrative port layer.
 - link_
logging str - Administrative link logging.
 - maximum_
links int - Maximum links.
 - medium str
 - The administrative port medium type.
 - minimum_
links int - Minimum links.
 - mode str
 - Administrative port mode.
 - mtu int
 - Administrative port MTU.
 - native_
vlan str - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - port_
channel_ strmode  - The aggregated interface protocol channel mode.
 - speed str
 - Administrative port speed.
 - suspend_
individual str - Suspend Individual Port.
 - trunk_
vlans str - List of trunk VLANs.
 - user_
configured_ strflags  - Port User Config Flags.
 - device str
 - A device name from the provider configuration.
 
- access
Vlan String - Access VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - admin
State String - Administrative port state.
 - auto
Negotiation String - Administrative port auto-negotiation.
 - bandwidth Number
 - The bandwidth parameter for a routed interface, port channel, or subinterface.
 - delay Number
 - The administrative port delay time.
 - description String
 - Interface description.
 - duplex String
 - Duplex.
 - id String
 - The distinguished name of the object.
 - interface
Id String - Must match first field in the output of 
show intf brief. Example:po1. - layer String
 - Administrative port layer.
 - link
Logging String - Administrative link logging.
 - maximum
Links Number - Maximum links.
 - medium String
 - The administrative port medium type.
 - minimum
Links Number - Minimum links.
 - mode String
 - Administrative port mode.
 - mtu Number
 - Administrative port MTU.
 - native
Vlan String - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - port
Channel StringMode  - The aggregated interface protocol channel mode.
 - speed String
 - Administrative port speed.
 - suspend
Individual String - Suspend Individual Port.
 - trunk
Vlans String - List of trunk VLANs.
 - user
Configured StringFlags  - Port User Config Flags.
 - device String
 - A device name from the provider configuration.
 
Package Details
- Repository
 - nxos lbrlabs/pulumi-nxos
 - License
 - Apache-2.0
 - Notes
 - This Pulumi package is based on the 
nxosTerraform Provider.