Upload Snmp Translations

Upload Snmp Translations

API to upload a seed file containing translations. Only files of ".xml" type are accepted

Request
URI
POST
https://{api_host}/tcsa/api/v1/snmp/translations/upload
COPY
Query Parameters
string
snmpIntegration
Optional

The name of the current snmp integration

snmpIntegration example
snmp-integration

Request Body
SnmpFileObject of type(s) multipart/form-data
Required
{
    "file": "string"
}
string As binary As binary
file
Required

The actual file that is uploaded. This can be a csv, txt, or xml file.

Authentication
This operation uses the following authentication methods.
Responses
200

OK Returned translations uploaded

Returns Translation of type(s) application/json
{
    "variableSpecificTranslations": [
        {
            "name": "CtrlAdminStatus",
            "valueMatches": [
                {
                    "rename": "-1",
                    "value": "notReady"
                },
                {
                    "rename": "100",
                    "value": "active"
                },
                {
                    "rename": "0",
                    "value": "notInService"
                }
            ]
        },
        {
            "name": "NewTranslationCheck",
            "valueMatches": [
                {
                    "rename": "-1",
                    "value": "notReady"
                },
                {
                    "rename": "100",
                    "value": "active"
                },
                {
                    "rename": "0",
                    "value": "notInService"
                }
            ]
        },
        {
            "name": "LatestHTTPOperSense",
            "valueMatches": [
                {
                    "rename": "18",
                    "value": "mplsLspUnreachable"
                },
                {
                    "rename": "6",
                    "value": "notConnected"
                },
                {
                    "rename": "8",
                    "value": "sequenceError"
                },
                {
                    "rename": "NaN",
                    "value": "other"
                },
                {
                    "rename": "19",
                    "value": "mplsLspMalformedReq"
                },
                {
                    "rename": "2",
                    "value": "disconnected"
                },
                {
                    "rename": "4",
                    "value": "timeout"
                },
                {
                    "rename": "7",
                    "value": "dropped"
                },
                {
                    "rename": "20",
                    "value": "mplsLspReachButNotFEC"
                },
                {
                    "rename": "1",
                    "value": "ok"
                },
                {
                    "rename": "12",
                    "value": "tcpConnectTimeout"
                },
                {
                    "rename": "15",
                    "value": "httpError"
                },
                {
                    "rename": "16",
                    "value": "error"
                },
                {
                    "rename": "13",
                    "value": "httpTransactionTimeout"
                },
                {
                    "rename": "3",
                    "value": "overThreshold"
                },
                {
                    "rename": "5",
                    "value": "busy"
                },
                {
                    "rename": "11",
                    "value": "dnsServerTimeout"
                },
                {
                    "rename": "9",
                    "value": "verifyError"
                },
                {
                    "rename": "17",
                    "value": "mplsLspEchoTxError"
                },
                {
                    "rename": "10",
                    "value": "applicationSpecific"
                },
                {
                    "rename": "14",
                    "value": "dnsQueryError"
                }
            ]
        },
        {
            "name": "ApplSupportedRTTTypesValid",
            "valueMatches": [
                {
                    "rename": "0",
                    "value": false
                },
                {
                    "rename": "1",
                    "value": true
                }
            ]
        },
        {
            "name": "EchoAdminLSREnable",
            "valueMatches": [
                {
                    "rename": "0",
                    "value": false
                },
                {
                    "rename": "1",
                    "value": true
                }
            ]
        },
        {
            "name": "EchoAdminControlEnable",
            "valueMatches": [
                {
                    "rename": "0",
                    "value": false
                },
                {
                    "rename": "1",
                    "value": true
                }
            ]
        },
        {
            "name": "LatestJitterOperSense",
            "valueMatches": [
                {
                    "rename": "18",
                    "value": "mplsLspUnreachable"
                },
                {
                    "rename": "6",
                    "value": "notConnected"
                },
                {
                    "rename": "8",
                    "value": "sequenceError"
                },
                {
                    "rename": "19",
                    "value": "mplsLspMalformedReq"
                },
                {
                    "rename": "2",
                    "value": "disconnected"
                },
                {
                    "rename": "4",
                    "value": "timeout"
                },
                {
                    "rename": "7",
                    "value": "dropped"
                },
                {
                    "rename": "20",
                    "value": "mplsLspReachButNotFEC"
                },
                {
                    "rename": "1",
                    "value": "ok"
                },
                {
                    "rename": "12",
                    "value": "tcpConnectTimeout"
                },
                {
                    "rename": "15",
                    "value": "httpError"
                },
                {
                    "rename": "16",
                    "value": "error"
                },
                {
                    "rename": "13",
                    "value": "httpTransactionTimeout"
                },
                {
                    "rename": "3",
                    "value": "overThreshold"
                },
                {
                    "rename": "5",
                    "value": "busy"
                },
                {
                    "rename": "11",
                    "value": "dnsServerTimeout"
                },
                {
                    "rename": "9",
                    "value": "verifyError"
                },
                {
                    "rename": "17",
                    "value": "mplsLspEchoTxError"
                },
                {
                    "rename": "10",
                    "value": "applicationSpecific"
                },
                {
                    "rename": "14",
                    "value": "dnsQueryError"
                }
            ]
        },
        {
            "name": "CtrlAdminVerifyData",
            "valueMatches": [
                {
                    "rename": "0",
                    "value": false
                },
                {
                    "rename": "1",
                    "value": true
                }
            ]
        },
        {
            "name": "CtrlAdminNvgen",
            "valueMatches": [
                {
                    "rename": "0",
                    "value": false
                },
                {
                    "rename": "1",
                    "value": true
                }
            ]
        },
        {
            "name": "HistoryCollectionSense",
            "valueMatches": [
                {
                    "rename": "18",
                    "value": "mplsLspUnreachable"
                },
                {
                    "rename": "6",
                    "value": "notConnected"
                },
                {
                    "rename": "8",
                    "value": "sequenceError"
                },
                {
                    "rename": "NaN",
                    "value": "other"
                },
                {
                    "rename": "19",
                    "value": "mplsLspMalformedReq"
                },
                {
                    "rename": "2",
                    "value": "disconnected"
                },
                {
                    "rename": "4",
                    "value": "timeout"
                },
                {
                    "rename": "7",
                    "value": "dropped"
                },
                {
                    "rename": "20",
                    "value": "mplsLspReachButNotFEC"
                },
                {
                    "rename": "1",
                    "value": "ok"
                },
                {
                    "rename": "12",
                    "value": "tcpConnectTimeout"
                },
                {
                    "rename": "15",
                    "value": "httpError"
                },
                {
                    "rename": "16",
                    "value": "error"
                },
                {
                    "rename": "13",
                    "value": "httpTransactionTimeout"
                },
                {
                    "rename": "3",
                    "value": "overThreshold"
                },
                {
                    "rename": "5",
                    "value": "busy"
                },
                {
                    "rename": "11",
                    "value": "dnsServerTimeout"
                },
                {
                    "rename": "9",
                    "value": "verifyError"
                },
                {
                    "rename": "17",
                    "value": "mplsLspEchoTxError"
                },
                {
                    "rename": "10",
                    "value": "applicationSpecific"
                },
                {
                    "rename": "14",
                    "value": "dnsQueryError"
                }
            ]
        },
        {
            "name": "ApplSupportedProtocolsValid",
            "valueMatches": [
                {
                    "rename": "0",
                    "value": false
                },
                {
                    "rename": "1",
                    "value": true
                }
            ]
        }
    ],
    "configVersion": "6.6"
}
array of object
variableSpecificTranslations
Required

Contains: {String variableValueTranslation name, VariableValueTranslation}.

string
configVersion
Optional

Configuration Version of the translation object


400

BAD REQUEST Error in request sent

Returns SnmpError of type(s) application/json
"SnmpError Object"
string
code
Optional

This code refers to the internal error codes used in the code base.

string
reason
Optional

This specifies the reason for failure.

string
status
Optional

This specifies the HTTP status code error


500

INTERNAL SERVER ERROR Error on the server

Returns SnmpError of type(s) application/json
"SnmpError Object"
string
code
Optional

This code refers to the internal error codes used in the code base.

string
reason
Optional

This specifies the reason for failure.

string
status
Optional

This specifies the HTTP status code error


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: multipart/form-data' -d '{"file:"string"}' https://{api_host}/tcsa/api/v1/snmp/translations/upload