FIC Interface

This page describes operations you can perform on fic_interfaces. List, and get details for.

List Fic Interface

List all visible fic_interfaces.

Synchronous / Asynchronous

  • Synchronous

Request

HTTP Request Method

  • GET

HTTP Request Path

{endpoint}/v2.0/fic_interfaces

HTTP Request Parameters

Parameter Style Type Format Enumeration Description Required
description query string - - Description of the FIC Interface resource no
fic_gw_id query string hyph-uuid-or-empty - FIC Gateway to which this interface is connected no
id query string - - Unique ID of the FIC Interface resource no
name query string - - Name of the FIC Interface resource no
status query string - - The FIC Interface status. no
tenant_id query string non-hyph-uuid - Tenant ID of the owner (UUID) no

Response

HTTP Response Code List

Response Code Description
200 OK
400 Bad Request
401 UnAuthorized
404 Not Found
500 Internal Server Error

HTTP Response Parameters

Parameter Type Format Description
fic_interfaces array<object> datatype_fic_interface -
description string - Description of the FIC Interface resource
fic_gw_id string hyph-uuid-or-empty FIC Gateway to which this interface is connected
id string - Unique ID of the FIC Interface resource
name string - Name of the FIC Interface resource
primary object - Primary router uplink ip configuration
bgp_peer_ip string ipv4 Address of the eBGP peer
bgp_router_id string ipv4 Router id used in virtual-router config (defaults to ip_address)
ip_address string cidr Address of the uplink interface
secondary object - Secondary router uplink ip configuration
bgp_peer_ip string ipv4 Address of the eBGP peer
bgp_router_id string ipv4 Router id used in virtual-router config (defaults to ip_address)
ip_address string cidr Address of the uplink interface
status string - The FIC Interface status.
tenant_id string non-hyph-uuid Tenant ID of the owner (UUID)

Examples

Sample Request Body

This operation does not send a request body.

Sample Response Body

{
  "fic_interfaces": [
    {
      "description": "lab3-fic-interface_for_tenant-sdpgui01",
      "fic_gw_id": "b6d96194-f74a-4beb-97cd-727f02b0e070",
      "id": "278dfbe4-f8cc-4ce4-aa17-561401c01661",
      "name": "fic_interface_for_tenant-sdpgui01",
      "primary": {
        "bgp_peer_ip": "10.2.121.1",
        "bgp_router_id": "10.2.121.10",
        "ip_address": "10.2.121.10/25"
      },
      "secondary": {
        "bgp_peer_ip": "10.2.121.129",
        "bgp_router_id": "10.2.121.130",
        "ip_address": "10.2.121.130/25"
      },
      "status": "ACTIVE",
      "tenant_id": "6a156ddf2ecd497ca786ff2da6df5aa8"
    },
    {
      "description": "lab3-fic-interface-for-esi_tenant",
      "fic_gw_id": "07f97269-e616-4dff-a73f-ca80bc5682dc",
      "id": "82098893-b394-4d52-9d24-3df57e63d750",
      "name": "lab3-test-user-fic-interface",
      "primary": {
        "bgp_peer_ip": "10.2.121.1",
        "bgp_router_id": "10.2.121.10",
        "ip_address": "10.2.121.10/25"
      },
      "secondary": {
        "bgp_peer_ip": "10.2.121.129",
        "bgp_router_id": "10.2.121.130",
        "ip_address": "10.2.121.130/25"
      },
      "status": "ACTIVE",
      "tenant_id": "6a156ddf2ecd497ca786ff2da6df5aa8"
    }
  ]
}

Show Fic Interface

Show details for fic_interface.

Synchronous / Asynchronous

  • Synchronous

Request

HTTP Request Method

  • GET

HTTP Request Path

{endpoint}/v2.0/fic_interfaces/{fic_interface_id}

HTTP Request Parameters

Parameter Style Type Format Enumeration Description Required
fic_interface_id URI string hyph-uuid - Unique ID of the FIC Interface resource yes

Response

HTTP Response Code List

Response Code Description
200 OK
400 Bad Request
401 UnAuthorized
404 Not Found
500 Internal Server Error

HTTP Response Parameters

Parameter Type Format Description
fic_interface object datatype_fic_interface -
description string - Description of the FIC Interface resource
fic_gw_id string hyph-uuid-or-empty FIC Gateway to which this interface is connected
id string - Unique ID of the FIC Interface resource
name string - Name of the FIC Interface resource
primary object - Primary router uplink ip configuration
bgp_peer_ip string ipv4 Address of the eBGP peer
bgp_router_id string ipv4 Router id used in virtual-router config (defaults to ip_address)
ip_address string cidr Address of the uplink interface
secondary object - Secondary router uplink ip configuration
bgp_peer_ip string ipv4 Address of the eBGP peer
bgp_router_id string ipv4 Router id used in virtual-router config (defaults to ip_address)
ip_address string cidr Address of the uplink interface
status string - The FIC Interface status.
tenant_id string non-hyph-uuid Tenant ID of the owner (UUID)

Examples

Sample Request Body

This operation does not send a request body.

Sample Response Body

{
  "fic_interface": {
    "description": "lab3-fic-interface_for_tenant-sdpgui01",
    "fic_gw_id": "b6d96194-f74a-4beb-97cd-727f02b0e070",
    "id": "278dfbe4-f8cc-4ce4-aa17-561401c01661",
    "name": "fic_interface_for_tenant-sdpgui01",
    "primary": {
      "bgp_peer_ip": "10.2.121.1",
      "bgp_router_id": "10.2.121.10",
      "ip_address": "10.2.121.10/25"
    },
    "secondary": {
      "bgp_peer_ip": "10.2.121.129",
      "bgp_router_id": "10.2.121.130",
      "ip_address": "10.2.121.130/25"
    },
    "status": "ACTIVE",
    "tenant_id": "6a156ddf2ecd497ca786ff2da6df5aa8"
  }
}