Skip to main content

Get Interface Status (v3.5)

GET 
/v3.5/api/tenants/:tenant_id/sites/:site_id/elements/:element_id/interfaces/:interface_id/status

Get interface status.

Request​

Path Parameters

    tenant_id stringrequired

    The tenant ID.

    site_id stringrequired

    The site ID.

    element_id stringrequired

    The element ID.

    interface_id stringrequired

    The interface ID.

Responses​

Successful Operation

Schema
    cellular_state CellularState

    The cellular state details.

    active boolean

    Indicates if the cellular state is active. Values = True/False.

    apn_info APNInfo

    Lists the APN and authentication information.

    apn string

    The APN.

    authentication string

    The APN authentication.

    device string

    The ION device.

    dns_v4_config DNS

    The DNS v4 config details.

    name_servers string[]

    The DNS name servers

    search string[]

    The search parameters.

    dns_v6_config IPv6DNS

    The DNS v6 config details.

    name_servers string[]

    The IPv6 configured DNS name servers.

    search string[]

    The search parameters.

    effective_vlans integer[]

    Effective Vlans

    element_id string

    The element ID.

    extended_state string

    The extended state.

    id string

    The interface ID.

    ipv4_addresses string[]

    The IPv4 addresses configured for the interface.

    ipv6_addresses string[]

    The IPv6 addresses configured for the interface.

    last_state_change int64

    The last state change of the device.

    link_local_address string

    The link local address.

    lldp_enabled boolean

    Lldp Enabled

    mac_address string

    The interface configuration MAC address.

    name string

    The name of the interface state. Max size = 128.

    negotiated_mtu int32

    The negotiated IP MTU value.

    operational_state string

    The operational state.

    poe_state PoeStateS

    Poe State

    detection_status string

    The PoE detection status.

    device_type string

    The ION device type.

    operational_state string

    The PoE operational state.

    poe_enabled boolean

    Indicates if PoE is enabled. By default, PoE is disabled.

    power_classification string

    The power classification.

    power_consumed float

    The power consumed.

    power_pairs_control_ability boolean

    Values = True or False.

    power_pairs_state string

    The power pair state.

    power_priority string

    The power priority.

    power_usage_threshold int32

    The Port Power Usage Alarm Threshold value is between 50 - 100%.The default threshold is 100% (60W).

    port Port

    The start and end port details.

    end string

    The end port range must be between 1 and 65535.

    start string

    The start port range must be between 1 and 65535.

    remote_host_name string

    The remote host name.

    remote_v4_addr string

    The remote IPv4 address.

    routes Route[]

    The routing details.

  • Array [
    • destination string

    The route destination.

    via string

    The via IP address.

  • ]
    • routes_v6 Ipv6Route[]

    The route v6 details.

  • Array [
    • destination string

    The route destination.

    via string

    The via IPv6 address.

  • ]
    • secondary_ipv4_addresses string[]

    The secondary IPv4 addresses.

    service_link ServiceLink

    The service link details ServiceLink.

    anti_replay boolean

    The anti replay value. True or False.

    anti_replay_window integer

    The anti replay window count.

    classic_site_id string

    The site ID.

    copy_tos boolean

    Copy Tos

    enable_gre_encapsulation boolean

    Is GRE encapsulation enabled. True or False.

    geneve_config GeneveConfig

    Lists all the geneve configurations.

    keepalive_enable boolean

    Is keepalive enabled. True or False.

    keepalive_fail_count int32

    Value between 3 and 10. Indicates the number of consecutive missed keep-alive packets before a link is declared as down. The default value is 3.

    keepalive_interval int32

    Value between 100 ms and 600000 ms. Indicates the time interval in milliseconds between two VPN keepalive packets. The default value is 1000 ms.

    keepalive_local_ipv4 string

    The keepalive local ipv4 address.

    keepalive_remote_ipv4 string

    The keepalive remote ipv4 address.

    gre_config GREConfig

    The GRE config details.

    csum boolean

    The CSUM.

    keepalive_enable boolean

    Is keepalive enabled. True or False.

    keepalive_fail_count int32

    Value between 3 and 10. Indicates the number of consecutive missed keep-alive packets before a link is declared as down. The default value is 3.

    keepalive_interval int32

    Value between 100 ms and 600000 ms. Indicates the time interval in milliseconds between two VPN keepalive packets. The default value is 1000 ms.

    ipsec_config IPSECConfig

    The IPSec config details.

    authentication IPSECAuthentication

    The IPSec authentication details.

    certificate string

    The certificate authentication for the IPsec Profile.

    certificate_profile_id string

    Certificate Profile Id

    comment string

    Comment

    ikev1_params IKEV1Params

    Ikev1 Params: Valid

    xauth_id string

    The xauth ID.

    xauth_secret string

    The authentication secret. Length must be between 4-128.

    xauth_secret_encrypted string

    The xauth secret. Value = True.

    xauth_secret_hash string

    The xauth hash. Value = True.

    xauth_type stringrequired

    Possible values: [NONE, SECRET]

    The xauth type.

    local_ca_certificate string

    The local CA certificate uploaded for certificate authentication.

    local_id stringrequired

    Possible values: [LOCAL_IP, DN, HOSTNAME, CUSTOM, NONE]

    The local ID type.

    local_id_custom string

    The custom local ID.

    local_pa_certificate_id string

    Local Pa Certificate Id

    pa_master_key_id string

    Pa Master Key Id

    passphrase string

    Passphrase

    passphrase_encrypted string

    Passphrase Encrypted: JsonIgnore(value = true)

    peer_id_check string

    Possible values: [EXACT, WILDCARD]

    Peer Id Check

    permit_peer_id_mismatch boolean

    Permit Peer Id Mismatch

    private_key string

    The private key file uploaded for certificate authentication.

    private_key_encrypted string

    Private Key Encrypted: JsonIgnore(value = true)

    remote_ca_certificate string

    The standard VPN endpoint CA certificate uploaded.

    remote_id string

    The ID for the standard VPN endpoint in the Remote ID field.

    secret string

    The password for PSK authentication.

    secret_encrypted string

    Secret Encrypted: JsonIgnore(value = true)

    secret_hash string

    Secret Hash: JsonIgnore(value = true)

    strict_validation_peer_extended_key_use boolean

    Strict Validation Peer Extended Key Use

    type stringrequired

    Possible values: [NONE, PSK, X509]

    The authentication type = PSK or Certificates.

    x509Objects X509Objects

    X509Objects: JsonIgnore(value = true)

    certHolder object
    certificate string

    Certificate

    is_local_ca_cert_set boolean

    Is Local Ca Cert Set

    is_remote_ca_cert_set boolean

    Is Remote Ca Cert Set

    keyPair object
    local_ca_certificate string

    Local Ca Certificate

    local_ca_certs_set object[]

    Local Ca Certs Set

    passphrase string

    Passphrase

    private_key string

    Private Key

    remote_ca_certificate string

    Remote Ca Certificate

    remote_ca_certs_set object[]

    Remote Ca Certs Set

    ipsec_profile_id stringrequired

    The IPSec profile ID.

    last_parent string

    The last parent value = true.

    liveliness_probe LivelinessProbe

    Lists the livliness probe details.

    failure_count int32

    The liveliness probe failure count interval.

    interval int32

    The probe interval. Must be between 1 to 30 seconds.

    ip_address string

    The probe address.

    local_ip_address string

    The local probe address.

    proxy_id string

    The proxy ID.

    nat_traversal boolean

    Nat traversal value. True or False.

    pa_location_oid string

    Pa Location Oid

    pa_tunnel_oid string

    Pa Tunnel Oid

    parent string

    The parent value = true.

    passive_mode PassiveMode

    Passive mode enabled on the device. True or False

    enable boolean

    Passive mode enabled for the device. True or False.

    peer_ip_dynamic boolean

    Peer IP dynamic enabled. True or False.

    peer PeerInfo

    The peer information.

    hostname string

    The peer hostname.

    ip_addresses string[]

    The peer IP addresses. Max size = 4.

    proxy_ids Proxy[]

    The proxy details.

  • Array [
    • local string

    Local

    local_port integer

    Local Port

    protocol string

    Protocol

    protocol_number integer

    Protocol Number

    proxy_id string

    Proxy Id

    remote string

    Remote

    remote_port integer

    Remote Port

  • ]
    • sase_ike_gw_config SaseIkeGWConfig

    The SASE IKE GW configurations.

    ike_gw_name string

    Ike Gw Name

    ikev1_dpd_delay integer

    Ikev1 Dpd Delay

    ikev1_dpd_enable boolean

    Ikev1 Dpd Enable

    ikev1_dpd_timeout integer

    Ikev1 Dpd Timeout

    ikev1_enable_fragmentation boolean

    Ikev1 Enable Fragmentation

    ikev1_exchange_mode string

    Ikev1 Exchange Mode

    ikev2_liveness_check_enable boolean

    Ikev2 Liveness Check Enable

    ikev2_liveness_interval integer

    Ikev2 Liveness Interval

    ikev2_require_cookie boolean

    Ikev2 Require Cookie

    security_service_endpoint_id string

    The security service endpoint ID.

    service_endpoint_id string

    The service endpoint ID.

    tunnel_role string

    The tunnel role.

    type stringrequired

    Possible values: [IPSEC, GRE, GENEVE]

    The service link type.

    stp_state STPStateS

    The STP state details.

    bpdu_guard_enabled boolean

    BPDU Guard enabled on ports do not receive a BPDU from its connected devices. When a BPDU Guard enabled port receives BPDU from a connected device, BPDU Guard disables the port.

    forward_fast_enabled boolean

    The speed.

    mstp_instance_id int32

    The MSTP instance ID.

    port_cost int32

    The STP port cost is between 1-65535. The STP port cost depends on the speed of the port.

    port_priority int32

    The STP Port priority is between 0-240. The default value is 128, STP port priority is in multiples of 16.

    port_state string

    The port state.

    root_guard_enabled boolean

    Root Guard is enabled on a port-by-port basis, it prevents a configured port from becoming a root port. Root Guard prevents a downstream switch from becoming a root bridge in a topology.

    stp_enabled boolean

    Spanning Tree Protocol (STP) is enabled by default. By default, the STP type is RSTP.

    svi_state SVIStateS

    The svi details.

    stp_designated_cost integer

    The STP designated cost between 1-65535.

    stp_designated_mac_address string

    The STP designated MAC address.

    stp_designated_port integer

    The STP designated port.

    stp_designated_root_mac_address string

    The STP designated root MAC address.

Loading...