Cisco NX-OS v0.0.2 published on Friday, Sep 29, 2023 by lbrlabs
nxos.getPhysicalInterface
Explore with Pulumi AI
This data source can read the configuration of a physical interface.
- API Documentation: l1PhysIf
 
Example Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Nxos = Pulumi.Nxos;
return await Deployment.RunAsync(() => 
{
    var example = Nxos.GetPhysicalInterface.Invoke(new()
    {
        InterfaceId = "eth1/10",
    });
});
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.LookupPhysicalInterface(ctx, &nxos.LookupPhysicalInterfaceArgs{
			InterfaceId: "eth1/10",
		}, 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.GetPhysicalInterfaceArgs;
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.getPhysicalInterface(GetPhysicalInterfaceArgs.builder()
            .interfaceId("eth1/10")
            .build());
    }
}
import pulumi
import pulumi_nxos as nxos
example = nxos.get_physical_interface(interface_id="eth1/10")
import * as pulumi from "@pulumi/pulumi";
import * as nxos from "@pulumi/nxos";
const example = nxos.getPhysicalInterface({
    interfaceId: "eth1/10",
});
variables:
  example:
    fn::invoke:
      Function: nxos:getPhysicalInterface
      Arguments:
        interfaceId: eth1/10
Using getPhysicalInterface
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 getPhysicalInterface(args: GetPhysicalInterfaceArgs, opts?: InvokeOptions): Promise<GetPhysicalInterfaceResult>
function getPhysicalInterfaceOutput(args: GetPhysicalInterfaceOutputArgs, opts?: InvokeOptions): Output<GetPhysicalInterfaceResult>def get_physical_interface(device: Optional[str] = None,
                           interface_id: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetPhysicalInterfaceResult
def get_physical_interface_output(device: Optional[pulumi.Input[str]] = None,
                           interface_id: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetPhysicalInterfaceResult]func LookupPhysicalInterface(ctx *Context, args *LookupPhysicalInterfaceArgs, opts ...InvokeOption) (*LookupPhysicalInterfaceResult, error)
func LookupPhysicalInterfaceOutput(ctx *Context, args *LookupPhysicalInterfaceOutputArgs, opts ...InvokeOption) LookupPhysicalInterfaceResultOutput> Note: This function is named LookupPhysicalInterface in the Go SDK.
public static class GetPhysicalInterface 
{
    public static Task<GetPhysicalInterfaceResult> InvokeAsync(GetPhysicalInterfaceArgs args, InvokeOptions? opts = null)
    public static Output<GetPhysicalInterfaceResult> Invoke(GetPhysicalInterfaceInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetPhysicalInterfaceResult> getPhysicalInterface(GetPhysicalInterfaceArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: nxos:index/getPhysicalInterface:getPhysicalInterface
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Interface
Id string - Must match first field in the output of 
show intf brief. Example:eth1/1. - Device string
 - A device name from the provider configuration.
 
- Interface
Id string - Must match first field in the output of 
show intf brief. Example:eth1/1. - Device string
 - A device name from the provider configuration.
 
- interface
Id String - Must match first field in the output of 
show intf brief. Example:eth1/1. - device String
 - A device name from the provider configuration.
 
- interface
Id string - Must match first field in the output of 
show intf brief. Example:eth1/1. - device string
 - A device name from the provider configuration.
 
- interface_
id str - Must match first field in the output of 
show intf brief. Example:eth1/1. - device str
 - A device name from the provider configuration.
 
- interface
Id String - Must match first field in the output of 
show intf brief. Example:eth1/1. - device String
 - A device name from the provider configuration.
 
getPhysicalInterface 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.
 - Fec
Mode string - FEC mode.
 - Id string
 - The distinguished name of the object.
 - Interface
Id string - Must match first field in the output of 
show intf brief. Example:eth1/1. - Layer string
 - Administrative port layer.
 - Link
Debounce intDown  - Administrative port link debounce interval.
 - Link
Debounce intUp  - Link Debounce Interval - LinkUp Event.
 - Link
Logging string - Administrative link logging.
 - Medium string
 - The administrative port medium type.
 - Mode string
 - Administrative port mode.
 - Mtu int
 - Administrative port MTU.
 - Native
Vlan string - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - Speed string
 - Administrative port speed.
 - Speed
Group string - Speed group.
 - Trunk
Vlans string - List of trunk VLANs.
 - Uni
Directional stringEthernet  - UDE (Uni-Directional Ethernet).
 - 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.
 - Fec
Mode string - FEC mode.
 - Id string
 - The distinguished name of the object.
 - Interface
Id string - Must match first field in the output of 
show intf brief. Example:eth1/1. - Layer string
 - Administrative port layer.
 - Link
Debounce intDown  - Administrative port link debounce interval.
 - Link
Debounce intUp  - Link Debounce Interval - LinkUp Event.
 - Link
Logging string - Administrative link logging.
 - Medium string
 - The administrative port medium type.
 - Mode string
 - Administrative port mode.
 - Mtu int
 - Administrative port MTU.
 - Native
Vlan string - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - Speed string
 - Administrative port speed.
 - Speed
Group string - Speed group.
 - Trunk
Vlans string - List of trunk VLANs.
 - Uni
Directional stringEthernet  - UDE (Uni-Directional Ethernet).
 - 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.
 - fec
Mode String - FEC mode.
 - id String
 - The distinguished name of the object.
 - interface
Id String - Must match first field in the output of 
show intf brief. Example:eth1/1. - layer String
 - Administrative port layer.
 - link
Debounce IntegerDown  - Administrative port link debounce interval.
 - link
Debounce IntegerUp  - Link Debounce Interval - LinkUp Event.
 - link
Logging String - Administrative link logging.
 - medium String
 - The administrative port medium type.
 - mode String
 - Administrative port mode.
 - mtu Integer
 - Administrative port MTU.
 - native
Vlan String - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - speed String
 - Administrative port speed.
 - speed
Group String - Speed group.
 - trunk
Vlans String - List of trunk VLANs.
 - uni
Directional StringEthernet  - UDE (Uni-Directional Ethernet).
 - 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.
 - fec
Mode string - FEC mode.
 - id string
 - The distinguished name of the object.
 - interface
Id string - Must match first field in the output of 
show intf brief. Example:eth1/1. - layer string
 - Administrative port layer.
 - link
Debounce numberDown  - Administrative port link debounce interval.
 - link
Debounce numberUp  - Link Debounce Interval - LinkUp Event.
 - link
Logging string - Administrative link logging.
 - medium string
 - The administrative port medium type.
 - mode string
 - Administrative port mode.
 - mtu number
 - Administrative port MTU.
 - native
Vlan string - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - speed string
 - Administrative port speed.
 - speed
Group string - Speed group.
 - trunk
Vlans string - List of trunk VLANs.
 - uni
Directional stringEthernet  - UDE (Uni-Directional Ethernet).
 - 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.
 - fec_
mode str - FEC mode.
 - id str
 - The distinguished name of the object.
 - interface_
id str - Must match first field in the output of 
show intf brief. Example:eth1/1. - layer str
 - Administrative port layer.
 - link_
debounce_ intdown  - Administrative port link debounce interval.
 - link_
debounce_ intup  - Link Debounce Interval - LinkUp Event.
 - link_
logging str - Administrative link logging.
 - medium str
 - The administrative port medium type.
 - mode str
 - Administrative port mode.
 - mtu int
 - Administrative port MTU.
 - native_
vlan str - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - speed str
 - Administrative port speed.
 - speed_
group str - Speed group.
 - trunk_
vlans str - List of trunk VLANs.
 - uni_
directional_ strethernet  - UDE (Uni-Directional Ethernet).
 - 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.
 - fec
Mode String - FEC mode.
 - id String
 - The distinguished name of the object.
 - interface
Id String - Must match first field in the output of 
show intf brief. Example:eth1/1. - layer String
 - Administrative port layer.
 - link
Debounce NumberDown  - Administrative port link debounce interval.
 - link
Debounce NumberUp  - Link Debounce Interval - LinkUp Event.
 - link
Logging String - Administrative link logging.
 - medium String
 - The administrative port medium type.
 - mode String
 - Administrative port mode.
 - mtu Number
 - Administrative port MTU.
 - native
Vlan String - Native VLAN. Possible values are 
unknown,vlan-XXorvxlan-XX. - speed String
 - Administrative port speed.
 - speed
Group String - Speed group.
 - trunk
Vlans String - List of trunk VLANs.
 - uni
Directional StringEthernet  - UDE (Uni-Directional Ethernet).
 - 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.