https://github.com/netascode/terraform-nxos-interface-ethernet
Terraform NX-OS Ethernet Interface Module
https://github.com/netascode/terraform-nxos-interface-ethernet
cisco nx-os nxos terraform terraform-module
Last synced: 3 months ago
JSON representation
Terraform NX-OS Ethernet Interface Module
- Host: GitHub
- URL: https://github.com/netascode/terraform-nxos-interface-ethernet
- Owner: netascode
- License: apache-2.0
- Created: 2022-04-26T09:30:54.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-02-10T12:04:18.000Z (over 1 year ago)
- Last Synced: 2025-01-14T14:14:07.179Z (4 months ago)
- Topics: cisco, nx-os, nxos, terraform, terraform-module
- Language: HCL
- Homepage: https://registry.terraform.io/modules/netascode/interface-ethernet/nxos
- Size: 46.9 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/netascode/terraform-nxos-interface-ethernet/actions/workflows/test.yml)
# Terraform NX-OS Ethernet Interface Module
Manages NX-OS Ethernet Interface
Model Documentation: [Link](https://developer.cisco.com/docs/cisco-nexus-3000-and-9000-series-nx-api-rest-sdk-user-guide-and-api-reference-release-9-3x/#!configuring-an-ethernet-interface)
## Examples
```hcl
module "nxos_interface_ethernet" {
source = "netascode/interface-ethernet/nxos"
version = ">= 0.1.0"
id = "1/23"
description = "Terraform was here"
layer3 = true
link_debounce_down = 0
mtu = 9000
ipv4_address = "1.1.1.1/24"
vrf = "VRF1"
urpf = "loose"
}
```
## Requirements
| Name | Version |
|------|---------|
| [terraform](#requirement\_terraform) | >= 1.0.0 |
| [nxos](#requirement\_nxos) | >= 0.5.0 |
## Providers
| Name | Version |
|------|---------|
| [nxos](#provider\_nxos) | >= 0.5.0 |
## Inputs
| Name | Description | Type | Default | Required |
|------|-------------|------|---------|:--------:|
| [device](#input\_device) | A device name from the provider configuration. | `string` | `null` | no |
| [id](#input\_id) | Interface ID. Allowed format: `1/1`. | `string` | n/a | yes |
| [access\_vlan](#input\_access\_vlan) | Native VLAN. Minimum value: 1. Maximum value: 3967. | `number` | `1` | no |
| [admin\_state](#input\_admin\_state) | Administrative port state. Set `true` for `up` or `false` for `down`. | `bool` | `true` | no |
| [auto\_negotiation](#input\_auto\_negotiation) | Administrative port auto-negotiation. Choices: `on`, `off`, `25G`. | `string` | `"on"` | no |
| [bandwidth](#input\_bandwidth) | Interface bandwidth. Minimum value: 0. Maximum value: 100000000. | `number` | `0` | no |
| [delay](#input\_delay) | The administrative port delay time. Minimum value: 1. Maximum value: 16777215. | `number` | `1` | no |
| [description](#input\_description) | Interface description. | `string` | `""` | no |
| [duplex](#input\_duplex) | Interface mode. Choices: `auto`, `full`, `half`. | `string` | `"auto"` | no |
| [fec\_mode](#input\_fec\_mode) | FEC mode. Choices: `fc-fec`, `rs-fec`, `fec-off`, `auto`, `rs-ieee`, `rs-cons16`, `kp-fec`. | `string` | `"auto"` | no |
| [layer3](#input\_layer3) | Administrative port layer. | `bool` | `false` | no |
| [link\_debounce\_down](#input\_link\_debounce\_down) | Link debounce time. Minimum value: 0. Maximum value: 20000. | `number` | `100` | no |
| [link\_debounce\_up](#input\_link\_debounce\_up) | Link debounce time - link-up event. Minimum value: 0. Maximum value: 20000. | `number` | `0` | no |
| [link\_logging](#input\_link\_logging) | FEC mode. Choices: `default`, `enable`, `disable`. | `string` | `"default"` | no |
| [medium](#input\_medium) | Administrative port medium type. | `string` | `"broadcast"` | no |
| [mode](#input\_mode) | Interface mode. Choices: `access`, `trunk`, `fex-fabric`, `dot1q-tunnel`, `promiscuous`, `host`, `trunk_secondary`, `trunk_promiscuous`, `vntag`. | `string` | `"access"` | no |
| [mtu](#input\_mtu) | Administrative port MTU. Minimum value: 576. Maximum value: 9216. | `number` | `1500` | no |
| [native\_vlan](#input\_native\_vlan) | Native VLAN. Possible values are `unknown`, `vlan-XX` or `vxlan-XX`. | `number` | `1` | no |
| [speed](#input\_speed) | Administrative port speed. Choices: `unknown`, `100M`, `1G`, `10G`, `40G`, `auto`, `auto 100M`, `auto 100M 1G`, `100G`, `25G`, `10M`, `50G`, `200G`, `400G`, `2.5G`, `5G`, `auto 2.5G 5G 10G`, `auto 100M 1G 2.5G 5G`. | `string` | `"auto"` | no |
| [speed\_group](#input\_speed\_group) | Speed group. Choices: `unknown`, `1000`, `10000`, `40000`, `auto`, `25000`. | `string` | `"auto"` | no |
| [trunk\_vlans](#input\_trunk\_vlans) | List of trunk VLANs. Allowed format: `1-2,4-5,100`. | `string` | `"1-4094"` | no |
| [uni\_directional\_ethernet](#input\_uni\_directional\_ethernet) | UDE (Uni-Directional Ethernet). Choices: `disable`, `send-only`, `receive-only`. | `string` | `"disable"` | no |
| [vrf](#input\_vrf) | VRF Name. | `string` | `"default"` | no |
| [ip\_unnumbered](#input\_ip\_unnumbered) | IP unnumbered. Reference to interface must match first field in the output of show intf brief. Example: `lo1`. | `string` | `"unspecified"` | no |
| [urpf](#input\_urpf) | URPF (unicast Reverse Path Forwarding). Choices: `disabled`, `strict`, `loose`, `loose-allow-default`, `strict-allow-vni-hosts`. | `string` | `"disabled"` | no |
| [ipv4\_address](#input\_ipv4\_address) | Interface IPv4 address. | `string` | `null` | no |
## Outputs
| Name | Description |
|------|-------------|
| [dn](#output\_dn) | Distinguished name of the object. |
## Resources
| Name | Type |
|------|------|
| [nxos_ipv4_interface.ipv4If](https://registry.terraform.io/providers/CiscoDevNet/nxos/latest/docs/resources/ipv4_interface) | resource |
| [nxos_ipv4_interface_address.ipv4Addr](https://registry.terraform.io/providers/CiscoDevNet/nxos/latest/docs/resources/ipv4_interface_address) | resource |
| [nxos_physical_interface.l1PhysIf](https://registry.terraform.io/providers/CiscoDevNet/nxos/latest/docs/resources/physical_interface) | resource |
| [nxos_physical_interface_vrf.nwRtVrfMbr](https://registry.terraform.io/providers/CiscoDevNet/nxos/latest/docs/resources/physical_interface_vrf) | resource |