Cisco NX-OS v0.0.2 published on Friday, Sep 29, 2023 by lbrlabs
nxos.getIpv4Interface
Explore with Pulumi AI
This data source can read an IPv4 interface.
- API Documentation: ipv4If
 
Example Usage
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Nxos = Pulumi.Nxos;
return await Deployment.RunAsync(() => 
{
    var example = Nxos.GetIpv4Interface.Invoke(new()
    {
        InterfaceId = "eth1/10",
        Vrf = "default",
    });
});
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.LookupIpv4Interface(ctx, &nxos.LookupIpv4InterfaceArgs{
			InterfaceId: "eth1/10",
			Vrf:         "default",
		}, 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.GetIpv4InterfaceArgs;
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.getIpv4Interface(GetIpv4InterfaceArgs.builder()
            .interfaceId("eth1/10")
            .vrf("default")
            .build());
    }
}
import pulumi
import pulumi_nxos as nxos
example = nxos.get_ipv4_interface(interface_id="eth1/10",
    vrf="default")
import * as pulumi from "@pulumi/pulumi";
import * as nxos from "@pulumi/nxos";
const example = nxos.getIpv4Interface({
    interfaceId: "eth1/10",
    vrf: "default",
});
variables:
  example:
    fn::invoke:
      Function: nxos:getIpv4Interface
      Arguments:
        interfaceId: eth1/10
        vrf: default
Using getIpv4Interface
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 getIpv4Interface(args: GetIpv4InterfaceArgs, opts?: InvokeOptions): Promise<GetIpv4InterfaceResult>
function getIpv4InterfaceOutput(args: GetIpv4InterfaceOutputArgs, opts?: InvokeOptions): Output<GetIpv4InterfaceResult>def get_ipv4_interface(device: Optional[str] = None,
                       interface_id: Optional[str] = None,
                       vrf: Optional[str] = None,
                       opts: Optional[InvokeOptions] = None) -> GetIpv4InterfaceResult
def get_ipv4_interface_output(device: Optional[pulumi.Input[str]] = None,
                       interface_id: Optional[pulumi.Input[str]] = None,
                       vrf: Optional[pulumi.Input[str]] = None,
                       opts: Optional[InvokeOptions] = None) -> Output[GetIpv4InterfaceResult]func LookupIpv4Interface(ctx *Context, args *LookupIpv4InterfaceArgs, opts ...InvokeOption) (*LookupIpv4InterfaceResult, error)
func LookupIpv4InterfaceOutput(ctx *Context, args *LookupIpv4InterfaceOutputArgs, opts ...InvokeOption) LookupIpv4InterfaceResultOutput> Note: This function is named LookupIpv4Interface in the Go SDK.
public static class GetIpv4Interface 
{
    public static Task<GetIpv4InterfaceResult> InvokeAsync(GetIpv4InterfaceArgs args, InvokeOptions? opts = null)
    public static Output<GetIpv4InterfaceResult> Invoke(GetIpv4InterfaceInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetIpv4InterfaceResult> getIpv4Interface(GetIpv4InterfaceArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
  function: nxos:index/getIpv4Interface:getIpv4Interface
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Interface
Id string - Must match first field in the output of 
show intf brief. Example:eth1/1. - Vrf string
 - VRF name.
 - 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. - Vrf string
 - VRF name.
 - 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. - vrf String
 - VRF name.
 - 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. - vrf string
 - VRF name.
 - 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. - vrf str
 - VRF name.
 - 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. - vrf String
 - VRF name.
 - device String
 - A device name from the provider configuration.
 
getIpv4Interface Result
The following output properties are available:
- Drop
Glean string - ip drop-glean enabled/disabled.
 - Forward string
 - ip forward enabled/disabled.
 - 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. - Unnumbered string
 - IP unnumbered. Reference to interface must match first field in the output of 
show intf brief. Example:eth1/1. - Urpf string
 - URPF (unicast Reverse Path Forwarding).
 - Vrf string
 - VRF name.
 - Device string
 - A device name from the provider configuration.
 
- Drop
Glean string - ip drop-glean enabled/disabled.
 - Forward string
 - ip forward enabled/disabled.
 - 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. - Unnumbered string
 - IP unnumbered. Reference to interface must match first field in the output of 
show intf brief. Example:eth1/1. - Urpf string
 - URPF (unicast Reverse Path Forwarding).
 - Vrf string
 - VRF name.
 - Device string
 - A device name from the provider configuration.
 
- drop
Glean String - ip drop-glean enabled/disabled.
 - forward String
 - ip forward enabled/disabled.
 - 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. - unnumbered String
 - IP unnumbered. Reference to interface must match first field in the output of 
show intf brief. Example:eth1/1. - urpf String
 - URPF (unicast Reverse Path Forwarding).
 - vrf String
 - VRF name.
 - device String
 - A device name from the provider configuration.
 
- drop
Glean string - ip drop-glean enabled/disabled.
 - forward string
 - ip forward enabled/disabled.
 - 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. - unnumbered string
 - IP unnumbered. Reference to interface must match first field in the output of 
show intf brief. Example:eth1/1. - urpf string
 - URPF (unicast Reverse Path Forwarding).
 - vrf string
 - VRF name.
 - device string
 - A device name from the provider configuration.
 
- drop_
glean str - ip drop-glean enabled/disabled.
 - forward str
 - ip forward enabled/disabled.
 - 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. - unnumbered str
 - IP unnumbered. Reference to interface must match first field in the output of 
show intf brief. Example:eth1/1. - urpf str
 - URPF (unicast Reverse Path Forwarding).
 - vrf str
 - VRF name.
 - device str
 - A device name from the provider configuration.
 
- drop
Glean String - ip drop-glean enabled/disabled.
 - forward String
 - ip forward enabled/disabled.
 - 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. - unnumbered String
 - IP unnumbered. Reference to interface must match first field in the output of 
show intf brief. Example:eth1/1. - urpf String
 - URPF (unicast Reverse Path Forwarding).
 - vrf String
 - VRF name.
 - 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.