{
    "@Redfish.Copyright": "Copyright 2019-2025 DMTF. All rights reserved.",
    "@odata.type": "#MessageRegistry.v1_7_0.MessageRegistry",
    "Id": "NetworkDevice.1.2.0",
    "Name": "Network Device Message Registry",
    "Language": "en",
    "Description": "This registry defines the messages for networking devices.",
    "RegistryPrefix": "NetworkDevice",
    "RegistryVersion": "1.2.0",
    "OwningEntity": "DMTF",
    "Release": "2026.1",
    "Messages": {
        "CableInserted": {
            "Description": "Indicates that a network cable was inserted.",
            "LongDescription": "This message shall indicate that a network cable was inserted.  This message shall not be sent for a backplane connection.",
            "Message": "A network cable was inserted into network adapter '%1' port '%2'.",
            "Example": "A network cable was inserted into network adapter 'NIC1' port 'Port1'.",
            "Severity": "OK",
            "MessageSeverity": "OK",
            "NumberOfArgs": 2,
            "ParamTypes": [
                "string",
                "string"
            ],
            "ArgDescriptions": [
                "The name or identifier of the network adapter.",
                "The name or identifier of the network port."
            ],
            "ArgLongDescriptions": [
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network adapter into which a cable was plugged.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network port into which a cable was plugged."
            ],
            "Resolution": "None.",
            "ClearingLogic": {
                "ClearsIf": "SameOriginOfCondition",
                "ClearsMessage": [
                    "CableRemoved"
                ]
            }
        },
        "CableRemoved": {
            "Description": "Indicates that a network cable was removed.",
            "LongDescription": "This message shall indicate that a network cable was removed.  This message shall not be sent for a backplane connection.",
            "Message": "A cable was removed from network adapter '%1' port '%2'.",
            "Example": "A cable was removed from network adapter 'NIC1' port 'Port1'.",
            "Severity": "OK",
            "MessageSeverity": "OK",
            "NumberOfArgs": 2,
            "ParamTypes": [
                "string",
                "string"
            ],
            "ArgDescriptions": [
                "The name or identifier of the network adapter.",
                "The name or identifier of the network port."
            ],
            "ArgLongDescriptions": [
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network adapter from which a cable was unplugged.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network port from which a cable was unplugged."
            ],
            "Resolution": "None."
        },
        "ConnectionDropped": {
            "Description": "Indicates that a network connection was dropped.",
            "LongDescription": "This message shall indicate that the link for a network connection is no longer intact.",
            "Message": "The connection is no longer active for network adapter '%1' port '%2' function '%3'.",
            "Example": "The connection is no longer active for network adapter 'NIC1' port 'Port1' function 'Function1'.",
            "Severity": "OK",
            "MessageSeverity": "OK",
            "NumberOfArgs": 3,
            "ParamTypes": [
                "string",
                "string",
                "string"
            ],
            "ArgDescriptions": [
                "The name or identifier of the network adapter.",
                "The name or identifier of the network port.",
                "The name or identifier of the network function."
            ],
            "ArgLongDescriptions": [
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network adapter from which a connection was dropped.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network port from which a connection was dropped.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network device function from which a connection was dropped."
            ],
            "Resolution": "None."
        },
        "ConnectionEstablished": {
            "Description": "Indicates that a network connection was established.",
            "LongDescription": "This message shall indicate that the link for a network connection is newly established.",
            "Message": "A network connection was established for network adapter '%1' port '%2' function '%3'.",
            "Example": "A network connection was established for network adapter 'NIC1' port 'Port1' function 'Function1'.",
            "Severity": "OK",
            "MessageSeverity": "OK",
            "NumberOfArgs": 3,
            "ParamTypes": [
                "string",
                "string",
                "string"
            ],
            "ArgDescriptions": [
                "The name or identifier of the network adapter.",
                "The name or identifier of the network port.",
                "The name or identifier of the network function."
            ],
            "ArgLongDescriptions": [
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network adapter to which a connection was established.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network port to which a connection was established.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network device function to which a connection was established."
            ],
            "Resolution": "None.",
            "ClearingLogic": {
                "ClearsIf": "SameOriginOfCondition",
                "ClearsMessage": [
                    "ConnectionDropped"
                ]
            }
        },
        "DegradedConnectionEstablished": {
            "Description": "Indicates that a network connection was established, but at an unexpectedly low link speed.",
            "LongDescription": "This message shall indicate that a network connection is newly established but that the link speed is lower than provisioned for the channel.",
            "Message": "A degraded network connection was established for network adapter '%1' port '%2' function '%3'.",
            "Example": "A degraded network connection was established for network adapter 'NIC1' port 'Port1' function 'Function1'.",
            "Severity": "Warning",
            "MessageSeverity": "Warning",
            "NumberOfArgs": 3,
            "ParamTypes": [
                "string",
                "string",
                "string"
            ],
            "ArgDescriptions": [
                "The name or identifier of the network adapter.",
                "The name or identifier of the network port.",
                "The name or identifier of the network function."
            ],
            "ArgLongDescriptions": [
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network adapter to which a connection was established.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network port to which a connection was established.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the network device function to which a connection was established."
            ],
            "Resolution": "None.",
            "ClearingLogic": {
                "ClearsIf": "SameOriginOfCondition",
                "ClearsMessage": [
                    "ConnectionDropped"
                ]
            }
        },
        "ConnectionSpeedLow": {
            "Description": "Indicates that a network connection is operating at a speed below the specified threshold.",
            "LongDescription": "This message shall indicate that a network connection is operating at a link speed lower than the specified threshold.",
            "Message": "The network adapter '%1' port '%2' function '%3' is operating at a link speed of %4 Gbps which is below the specified threshold of %5 Gbps.",
            "Example": "The network adapter 'NIC1' port 'Port1' function 'Function1' is operating at a link speed of 1 Gbps which is below the specified threshold of 10 Gbps.",
            "Severity": "Warning",
            "MessageSeverity": "Warning",
            "VersionAdded": "1.1.0",
            "NumberOfArgs": 5,
            "ParamTypes": [
                "string",
                "string",
                "string",
                "number",
                "number"
            ],
            "ArgDescriptions": [
                "The name or identifier of the network adapter.",
                "The name or identifier of the network port.",
                "The name or identifier of the network function.",
                "The current link speed (Gbps).",
                "The alert threshold (Gbps)."
            ],
            "ArgLongDescriptions": [
                "This argument shall contain contain a string that identifies or describes the location or physical context of the associated network adapter.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the associated network port.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the associated network device function.",
                "This argument shall contain the current connection speed (Gbps).",
                "This argument shall contain the value of the threshold that triggered this message."
            ],
            "Resolution": "Check the network equipment and cabling for this connection."
        },
        "LinkFlapDetected": {
            "Description": "Indicates that a network connection is highly unstable.",
            "LongDescription": "This message shall indicate that a network connection was repeatedly established and dropped.  This message shall not be repeated more than once in any 24-hour period.",
            "Message": "The network connection for network adapter '%1' port '%2' function '%3' was established and dropped '%4' times in the last '%5' minutes.",
            "Example": "The network connection for network adapter 'NIC1' port 'Port1' function 'Function1' was established and dropped 10 times in the last 5 minutes.",
            "Severity": "Warning",
            "MessageSeverity": "Warning",
            "NumberOfArgs": 5,
            "ParamTypes": [
                "string",
                "string",
                "string",
                "number",
                "number"
            ],
            "ArgDescriptions": [
                "The name or identifier of the network adapter.",
                "The name or identifier of the network port.",
                "The name or identifier of the network function.",
                "The number of times the link has flapped.",
                "The number of minutes over which the link has flapped."
            ],
            "ArgLongDescriptions": [
                "This argument shall contain contain a string that identifies or describes the location or physical context of the associated network adapter.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the associated network port.",
                "This argument shall contain contain a string that identifies or describes the location or physical context of the associated network device function.",
                "This argument shall contain be a number representing the count of link establishment/disconnection cycles.",
                "This argument shall contain be a number representing the number of minutes over which link flapping activity was detected."
            ],
            "Resolution": "Contact the network administrator for problem resolution."
        }
    }
}