Protocol Documentation

appid_service.proto

AppIdentData

Represents appid data.

Table 1. AppIdentData
FieldTypeLabelDescription

name

string

Application name

author

string

Author name

is_connected

bool

Connected to IDB or not

version

string

Version string

AppIdentKey

Represents appid key.

Table 2. AppIdentKey
FieldTypeLabelDescription

id

uint32

Application id

AppIdentNotification

Represents appid notification.

Table 3. AppIdentNotification
FieldTypeLabelDescription

op

SdkMgrOperation

Operation such as create, delete, or update

key

AppIdentKey

AppIdent key

data

AppIdentData

AppIdent data

AppIdentSubscriptionRequest

Represents appid subscription request.

Table 4. AppIdentSubscriptionRequest
FieldTypeLabelDescription

key

AppIdentKey

Optional, to filter on name

bfd_service.proto

BfdmgrGeneralSessionDataPb.BfdmgrSessionSubType

Represents BFD session subtype.

Table 5. BfdmgrGeneralSessionDataPb.BfdmgrSessionSubType
NameNumberDescription

SESSION_SUB_TYPE_UNKNOWN

0

Session subtype unknown

SESSION_SUB_TYPE_SINGLE_HOP

1

Single-hop session

SESSION_SUB_TYPE_MULTI_HOP

2

Multi-hop session

SESSION_SUB_TYPE_MICROBFD

3

microbfd session

SESSION_SUB_TYPE_SBFD_ECHO

4

microbfd session

BfdmgrSessionStatus

Represents BFD session status.

Table 6. BfdmgrSessionStatus
NameNumberDescription

INVALID

0

Session invalid

ADMIN_DOWN

1

Admin down

DOWN

2

Status down

INIT

3

Status initializing

UP

4

Status up and running

BfdmgrSessionType

Represents BFD session type.

Table 7. BfdmgrSessionType
NameNumberDescription

SESSION_TYPE_UNKNOWN

0

Unknown session type

SESSION_TYPE_P2P

1

Peer-to-peer session type

SESSION_TYPE_MICROBFD

2

microbfd session type

SESSION_TYPE_SBFD_ECHO

3

seamless BFD session type, echo initiator

BfdSessionSubscriptionRequest

Represents BFD session subscription request.

Table 9. BfdSessionSubscriptionRequest
FieldTypeLabelDescription

key

BfdmgrGeneralSessionKeyPb

Optional, to filter on name

BfdmgrGeneralSessionDataPb

Represents BFD session data.

Table 10. BfdmgrGeneralSessionDataPb
FieldTypeLabelDescription

status

BfdmgrSessionStatus

Status of the session

sub_type

BfdmgrSessionSubType

Subtype of the session

src_if_id

uint32

src_if_id is only populated for P2P type Source interface ID

BfdmgrGeneralSessionKeyPb

Represents BFD session key.

Table 11. BfdmgrGeneralSessionKeyPb
FieldTypeLabelDescription

type

BfdmgrSessionType

type is always present, other key field presence is determined by type Session type

p2p

P2pKey

microbfd

MicrobfdKey

sbfdecho

SbfdechoKey

BfdmgrGeneralSessionKeyPb.MicrobfdKey

Table 12. BfdmgrGeneralSessionKeyPb.MicrobfdKey
FieldTypeLabelDescription

interface_name

string

BfdmgrGeneralSessionKeyPb.P2pKey

Table 13. BfdmgrGeneralSessionKeyPb.P2pKey
FieldTypeLabelDescription

src_ip_addr

IpAddressPb

Source IP address of the session

dst_ip_addr

IpAddressPb

Destination IP address of the session

instance_id

uint32

Network instance identifier

ipv4_unnum_or_ipv6_ll_if_id

uint32

Global if id for ipv4 unnumbered or ipv6 link local session, otherwise 0

specified_discr

bool

True if discriminators are specified

BfdmgrGeneralSessionKeyPb.SbfdechoKey

Table 14. BfdmgrGeneralSessionKeyPb.SbfdechoKey
FieldTypeLabelDescription

instance_id

uint32

Network instance identifier

sr_policy_segment_list_id

uint32

sr_policy_color

uint32

sr_policy_endpoint

IpAddressPb

config_service.proto

AcknowledgeConfigRequest

Represents configuration acknowledgment request; Each config notification requires its own acknowledgement.

Table 15. AcknowledgeConfigRequest
FieldTypeLabelDescription

infos

AcknowledgeConfigRequestInfo

repeated

AcknowledgeConfigRequestInfo

Represents configuration acknowledgment request information.

Table 16. AcknowledgeConfigRequestInfo
FieldTypeLabelDescription

js_path_with_keys

string

JSON path formatted string from YANG; for example, interface{.name==ethernet1/1}.my_field

error

string

warning

string

output

string

AcknowledgeConfigResponse

Represents configuration acknowledgement response.

Table 17. AcknowledgeConfigResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Status of acknowledge config request operation

error_str

string

Detailed error string

ConfigData

Represents configuration data.

Table 18. ConfigData
FieldTypeLabelDescription

json

string

Entire configuration fragment as JSON string

data

bytes

Entire configuration fragment as binary data

ConfigKey

Represents configuration key.

Table 19. ConfigKey
FieldTypeLabelDescription

js_path

string

JSON path formatted string from YANG; for example, interface.my_field

keys

string

repeated

Value for keys

js_path_with_keys

string

JSON path formatted string from YANG; for example, interface{.name==ethernet1/1}.my_field

ConfigNotification

Represents configuration notification message to subscribe to configuration events

Table 20. ConfigNotification
FieldTypeLabelDescription

op

SdkMgrOperation

Operation indicating create, delete, or update

key

ConfigKey

Configuration key

data

ConfigData

Configuration data

ConfigSubscriptionRequest

Represents configuration subscription request.

Table 21. ConfigSubscriptionRequest
FieldTypeLabelDescription

key

ConfigKey

Optional, to filter on name

SdkMgrConfigService

Represents service for config operations.

Table 22. SdkMgrConfigService
Method NameRequest TypeResponse TypeDescription

AcknowledgeConfig

AcknowledgeConfigRequestAcknowledgeConfigResponse

Acknowledge received configuration. When agent is registered with `wait_config_ack` flag set to true, it needs to acknowledge received configuration.

interface_service.proto

InterfaceData

Represents interface data.

Table 23. InterfaceData
FieldTypeLabelDescription

admin_is_up

uint32

Admin state

mtu

uint32

Maximum transmission unit

if_type

IfMgrIfType

Interface type; for example, loopback, physical, or LAG

port_id

PortIdPb

Port identifier

description

string

Interface description

mac_addr

MacAddressPb

MAC address

aggregate_id

string

associated aggregate id

oper_is_up

uint32

Operational state

InterfaceKey

Represents interface key.

Table 24. InterfaceKey
FieldTypeLabelDescription

if_name

string

Interface name; for example, ethernet 1/1

InterfaceNotification

Represents interface notification.

Table 25. InterfaceNotification
FieldTypeLabelDescription

op

SdkMgrOperation

Operation such as create, delete, or update

key

InterfaceKey

Interface key

data

InterfaceData

Interface data

InterfaceSubscriptionRequest

Represents interface subscription request.

Table 26. InterfaceSubscriptionRequest
FieldTypeLabelDescription

key

InterfaceKey

Optional, to filter on name

lldp_service.proto

LldpNeighborDataPb.PortSubType

Represents port subtype.

Table 27. LldpNeighborDataPb.PortSubType
NameNumberDescription

RESERVED

0

Reserved for future use

INTERFACE_ALIAS

1

Alias of the interface

PORT_COMPONENT

2

Port identifier based on a locally defined port component

MAC_ADDRESS

3

MAC address

NETWORK_ADDRESS

4

Network address

INTERFACE_NAME

5

Name of the interface

AGENT_CIRCUIT_ID

6

Port identifier based on the circuit ID in the DHCP relay agent information option

LOCALLY_ASSIGNED

7

Port identifier based on a locally defined alphanumeric string

LldpNeighborKeyPb.ChassisIdType

Represents chassis type.

Table 28. LldpNeighborKeyPb.ChassisIdType
NameNumberDescription

RESERVED

0

Reserved for future use

CHASSIS_COMPONENT

1

Chassis identifier based on a locally defined chassis component

INTERFACE_ALIAS

2

Alias of the interface

PORT_COMPONENT

3

Chassis identifier based on a locally defined port component

MAC_ADDRESS

4

MAC address

NETWORK_ADDRESS

5

Network address

INTERFACE_NAME

6

Name of the interface

LOCALLY_ASSIGNED

7

Chassis identifier based on a locally defined value

LldpNeighborDataPb

Represents LLDP neighbor data.

Table 29. LldpNeighborDataPb
FieldTypeLabelDescription

port_id

string

Port identifier

port_type

PortSubType

Port type

source_mac

MacAddressPb

Port MAC address

bgp_peer_address

IpAddressPb

repeated

LLDP BGP autodiscovered addresses

bgp_group_id

uint32

BGP group identifier

system_name

string

System name

system_description

string

System description

LldpNeighborKeyPb

Represents LLDP neighbor key.

Table 30. LldpNeighborKeyPb
FieldTypeLabelDescription

interface_name

string

Local interface name

chassis_id

string

Chassis identifier

chassis_type

ChassisIdType

Chassis type

LldpNeighborNotification

Represents LLDP neighbor notification.

Table 31. LldpNeighborNotification
FieldTypeLabelDescription

op

SdkMgrOperation

Operation such as create, delete, or update

key

LldpNeighborKeyPb

LLDP neighbor key

data

LldpNeighborDataPb

LLDP neighbor data

LldpNeighborSubscriptionRequest

Represents LLDP neighbor subscription request.

Table 32. LldpNeighborSubscriptionRequest
Field Type Label Description

key

LldpNeighborKeyPb

Optional, to filter on name

networkinstance_service.proto

NetworkInstanceData.NetInstType

Represents network instance type.

Table 33. NetworkInstanceData.NetInstType
Name Number Description

DEFAULT

0

Default network instance type

L3VRF

1

L3VRF network instance type

NetworkInstanceData

Represents network instance data.

Table 34. NetworkInstanceData
Field Type Label Description

net_inst_id

uint32

Network instance identifier

base_name

string

Base name

oper_is_up

bool

Operation status

router_id

string

Router identifier

inst_type

NetInstType

Network instance type

NetworkInstanceKey

Represents network instance key.

Table 35. NetworkInstanceKey
Field Type Label Description

inst_name

string

Network instance name

NetworkInstanceNotification

Represents network instance notification.

Table 36. NetworkInstanceNotification
Field Type Label Description

op

SdkMgrOperation

Operation such as create, delete, or update

key

NetworkInstanceKey

Network key

data

NetworkInstanceData

Network data

NetworkInstanceSubscriptionRequest

Represents network instance subscription request.

nexthop_group_service.proto

NextHop.ResolutionType

Represents resolution type.

Table 37. NextHop.ResolutionType
NameNumberDescription

INVALID

0

Invalid resolution

REGULAR

1

Regular resolution

MPLS

2

MPLS resolution

NextHop.ResolveToType

Represents resolve-to type.

Table 38. NextHop.ResolveToType
NameNumberDescription

LOCAL

0

Resolve to local routes

DIRECT

1

Resolve to direct routes

INDIRECT

2

Resolve to indirect routes

MplsNextHop

Represents MPLS next hop.

Table 39. MplsNextHop
FieldTypeLabelDescription

ip_nexthop

IpAddressPb

Next-hop IP address

label_stack

MplsLabel

repeated

MPLS label stack

NextHopGroup

Represents next-hop group.

Table 41. NextHopGroup
FieldTypeLabelDescription

next_hop

NextHop

repeated

Next-hops

NextHopGroupDeleteRequest

Represents next-hop group delete request.

Table 42. NextHopGroupDeleteRequest
FieldTypeLabelDescription

group_key

NextHopGroupKey

repeated

Next-hop group key details

NextHopGroupDeleteResponse

Represents next-hop group delete response.

Table 43. NextHopGroupDeleteResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Response for next-hop group request

error_str

string

Detailed error string

NextHopGroupInfo

Represents next-hop group information.

Table 44. NextHopGroupInfo
FieldTypeLabelDescription

key

NextHopGroupKey

Next-hop group key

data

NextHopGroup

Next-hop group data

NextHopGroupKey

Represents next-hop group key.

Table 45. NextHopGroupKey
FieldTypeLabelDescription

name

string

Next-hop group name

network_instance_name

string

Next-hop group network instance name

NextHopGroupNotification

Represents next-hop group notification.

Table 46. NextHopGroupNotification
FieldTypeLabelDescription

op

SdkMgrOperation

Operation such as create, delete, or update

key

uint64

Next-hop group key

data

NextHopGroup

Next-hop group data

NextHopGroupRequest

Represents next-hop group request.

Table 47. NextHopGroupRequest
FieldTypeLabelDescription

group_info

NextHopGroupInfo

repeated

Next-hop group details

NextHopGroupResponse

Represents next-hop group response.

Table 48. NextHopGroupResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Response for next-hop group request

error_str

string

Detailed error string

NextHopGroupSubscriptionRequest

Represents next-hop group subscription request.

Table 49. NextHopGroupSubscriptionRequest
FieldTypeLabelDescription

key

NextHopGroupKey

Optional, to filter on name

SdkMgrNextHopGroupService

Represents service for next-hop group operations.

Table 50. SdkMgrNextHopGroupService
Method NameRequest TypeResponse TypeDescription

NextHopGroupAddOrUpdate

NextHopGroupRequestNextHopGroupResponse

Add or update one or more next-hop groups.

NextHopGroupDelete

NextHopGroupDeleteRequestNextHopGroupDeleteResponse

Delete next-hop group.

SyncStart

SyncRequestSyncResponse

Synchronization start to open synchronization operation.

SyncEnd

SyncRequestSyncResponse

Synchronization end to close synchronization operation.

route_service.proto

IpRouteNotification

Represents IP route notification.

Table 51. IpRouteNotification
FieldTypeLabelDescription

op

SdkMgrOperation

Operation such as create, delete, or update

key

RouteKeyPb

IP route key

data

RoutePb

IP route data

IpRouteSubscriptionRequest

Represents IP route subscription request.

Table 52. IpRouteSubscriptionRequest
FieldTypeLabelDescription

key

RouteKeyPb

Optional, to filter on name

RouteAddRequest

Represents route add request; can contain more than one route.

Table 53. RouteAddRequest
FieldTypeLabelDescription

routes

RouteInfo

repeated

IP routes

RouteAddResponse

Represents route add response.

Table 54. RouteAddResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Status of route add operation

error_str

string

Detailed error string

RouteDeleteRequest

Represents route delete request; can contain more than one route.

Table 55. RouteDeleteRequest
FieldTypeLabelDescription

routes

RouteKeyPb

repeated

IP routes

RouteDeleteResponse

Represents route delete response.

Table 56. RouteDeleteResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Status of route delete operation

error_str

string

Detailed error string

RouteInfo

Represents route information.

Table 57. RouteInfo
FieldTypeLabelDescription

key

RouteKeyPb

Route key

data

RoutePb

Route data

RouteKeyPb

Represents route key.

Table 58. RouteKeyPb
FieldTypeLabelDescription

net_inst_name

string

Network instance name

ip_prefix

IpAddrPrefLenPb

IP prefix

RoutePb

Represents route data.

Table 59. RoutePb
FieldTypeLabelDescription

nexthop_group_name

string

Next hop group name

preference

uint32

Preference

metric

uint32

Metric

nexthop

NextHop

repeated

List of next hops

owner_id

uint32

Next hop owner identifier returned only on notification.

nhg_id

uint64

Next-hop group identifier returned only on notification.

sdk_common.proto

IfEthernetDuplexModeType

Represents interface ethernet duplex mode. Corresponds to yang values

Table 61. IfEthernetDuplexModeType
NameNumberDescription

IF_ETH_DUPLEX_MODE_UNSET

0

duplex mode not supported

IF_ETH_DUPLEX_MODE_FULL

1

IF_ETH_DUPLEX_MODE_HALF

2

IfEthernetPortSpeedType

Represents interface ethernet port speed. Corresponds to yang values

Table 62. IfEthernetPortSpeedType
NameNumberDescription

IF_ETH_PORT_SPEED_UNSET

0

Speed unknown

IF_ETH_PORT_SPEED_10M

1

IF_ETH_PORT_SPEED_100M

2

IF_ETH_PORT_SPEED_1G

3

IF_ETH_PORT_SPEED_10G

4

IF_ETH_PORT_SPEED_25G

5

IF_ETH_PORT_SPEED_40G

6

IF_ETH_PORT_SPEED_50G

7

IF_ETH_PORT_SPEED_100G

8

IF_ETH_PORT_SPEED_200G

9

IF_ETH_PORT_SPEED_400G

10

IF_ETH_PORT_SPEED_1T

11

IF_ETH_PORT_SPEED_800G

12

IfLoopbackModeType

Represents interface loopback mode. Corresponds to yang values

Table 63. IfLoopbackModeType
NameNumberDescription

IF_LOOPBACK_MODE_UNSET

0

loopback mode not supported

IF_LOOPBACK_MODE_NONE

1

IF_LOOPBACK_MODE_FACILITY

2

IF_LOOPBACK_MODE_TERMINAL

3

IfMgrIfType

Represents interface type.

Table 64. IfMgrIfType
NameNumberDescription

ETHERNET

0

Ethernet interface

LOOPBACK

1

Loopback interface

MANAGEMENT

2

Management interface

AGGREGATE

3

Aggregate(LAG) interface

IRB

4

Integrated Routing and Bridging (IRB) interface

SYSTEM

5

System interface

LIF

6

linux interface

NIC

7

linux nic interface (bus/dev/fn)

VHOST

8

vhost-net interface, vhn-<name> name for sock-path

KKLIF

9

temp name for new style of lif interface

KKVHOST

10

temp name for new style of vhost interface

SYNC

11

1588 sync interface

IF_TYPE_MAX

12

IfOperDownReason

Table 65. IfOperDownReason
NameNumberDescription

IF_OPER_DOWN_NONE

0

IF_OPER_DOWN_PORT_ADMIN_DISABLED

1

IF_OPER_DOWN_MDA_ADMIN_DISABLED

2

IF_OPER_DOWN_TRANS_LASER_DISABLED

3

IF_OPER_DOWN_MDA_NOT_PRESENT

4

IF_OPER_DOWN_TRANS_NOT_PRESENT

5

IF_OPER_DOWN_PHY_INIT

6

IF_OPER_DOWN_LOWER_LAYER_DOWN

7

IF_OPER_DOWN_MTU_RESOURCES

8

IF_OPER_DOWN_UNSUPPORTED_SPEED

9

IF_OPER_DOWN_UNSUPPORTED_TRANS_FEC

10

IF_OPER_DOWN_OTHER

11

IF_OPER_DOWN_PORT_NOT_PRESENT

12

used internally by chassis mgr only - xdp never publish to IDB!

IF_OPER_DOWN_FABRIC_AVAILABILITY

13

used internally by chassis mgr only - xdp never publish to IDB!

IF_OPER_DOWN_NO_ACTIVE_LINKS

14

lag interface only

IF_OPER_DOWN_MIN_LINK_THRESHOLD

15

lag interface only

IF_OPER_DOWN_9_12_SPEED_MISMATCH

16

Vodka port 9-12 must all be same speed as port 9

IF_OPER_DOWN_LAG_RESOURCES

17

lag interface only

IF_OPER_DOWN_LAG_MEMBER_RESOURCES

18

lag member interface only

IF_OPER_DOWN_STANDBY_SIGNALING

19

ESM multihoming

IF_OPER_DOWN_HOLD_TIME_UP_ACTIVE

20

interface hold-time up is actively holding the interface down

IF_OPER_DOWN_RELOAD_TIME_ACTIVE

21

interface reload time is actively holding the interface down

IF_OPER_DOWN_CONNECTOR_DOWN

22

parent connector oper down forces breakout port oper down

IF_OPER_DOWN_AUTO_NEG_MISMATCH

23

IF_OPER_DOWN_EVENT_HANDLER

24

used internally by chassis mgr only - xdp never publish to IDB!

IF_OPER_DOWN_UNSUPPORTED_BREAKOUT

25

interface doesn't support breakout config

IF_OPER_DOWN_CFM_CCM_DEFECT

26

IF_OPER_DOWN_CRC_MON_FAIL_THRESH

27

crc-monitor signal failure threshold exceeded

IF_OPER_DOWN_SYMBOL_MON_FAIL_THRESH

28

symbol-monitor signal failure threshold exceeded

IfOperStateType

Represents interface operational state.

Table 66. IfOperStateType
NameNumberDescription

IF_OPER_STATE_UP

0

Interface operational state up

IF_OPER_STATE_DOWN

1

Interface operational state down

IF_OPER_STATE_TESTING

2

Interface operational state testing

IF_OPER_STATE_UNKNOWN

3

Interface operational state unknown

IF_OPER_STATE_DORMANT

4

Interface operational state dormant

IF_OPER_STATE_NOT_PRESENT

5

Interface operational state not present

IF_OPER_STATE_LOWER_LAYER_DOWN

6

Interface operational state lower layer down

IfTransceiverFecType

Represents interface transceiver fec. Corresponds to yang values

Table 67. IfTransceiverFecType
NameNumberDescription

IF_TRANS_FEC_UNSET

0

Fec unknown

IF_TRANS_FEC_DISABLED

1

IF_TRANS_FEC_RS528

2

IF_TRANS_FEC_RS544

3

IF_TRANS_FEC_BASER

4

IF_TRANS_FEC_RS108

5

IpAddressState

Represents IP address state.

Table 68. IpAddressState
NameNumberDescription

IPADDR_STATE_UNKNOWN

0

IP address state unknown

IPADDR_STATE_TENTATIVE

1

IP address state tentative

IPADDR_STATE_DUPLICATED

2

IP address state duplicated

IPADDR_STATE_INACCESSIBLE

3

IP address state inaccessible

IPADDR_STATE_DEPRECATED

4

IP address state deprecated

IPADDR_STATE_PREFERRED

5

IP address state preferred

SdkMgrOperation

Represents enumeration value for operation in subscription.

Table 69. SdkMgrOperation
NameNumberDescription

Create

0

Create operation

Update

1

Update operation

Delete

2

Delete operation

SdkMgrStatus

Represents status of network programming service calls.

Table 70. SdkMgrStatus
NameNumberDescription

kSdkMgrSuccess

0

Successful service call

kSdkMgrFailed

1

Failed service call

AgentReply

Empty message from agent.

EvpnEthSegIdPb

Table 71. EvpnEthSegIdPb
FieldTypeLabelDescription

es_id

bytes

Type 0 for now. hard-coded id

GlobalIfId

Represents global interface identifier.

Table 72. GlobalIfId
FieldTypeLabelDescription

global_if_id

uint32

Global interface identifier

IpAddrPrefLenPb

Represents IP prefix.

Table 73. IpAddrPrefLenPb
FieldTypeLabelDescription

ip_addr

IpAddressPb

IP address

prefix_length

uint32

IP address prefix length

IpAddressPb

Represents IP address.

Table 74. IpAddressPb
FieldTypeLabelDescription

addr

bytes

IP address

IpInterfaceAddrPrefixPb

Represents IP prefix state.

Table 75. IpInterfaceAddrPrefixPb
FieldTypeLabelDescription

prefix

IpAddrPrefLenPb

IP prefix

state

IpAddressState

IP prefix state

MacAddressPb

Represents MAC address.

Table 76. MacAddressPb
FieldTypeLabelDescription

mac_address

bytes

MAC address

MplsLabel

Represents MPLS label.

Table 77. MplsLabel
FieldTypeLabelDescription

mpls_label

uint32

MPLS label

NetInstanceId

Represents network instance identifier.

Table 78. NetInstanceId
FieldTypeLabelDescription

instance_id

uint32

Network instance identifier

PortIdPb

Represents port identifier.

Table 79. PortIdPb
FieldTypeLabelDescription

port_id

uint64

Port identifier

SyncRequest

Empty message for synchronization request.

SyncResponse

Empty message for synchronization end.

Table 80. SyncResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Error code

error_str

string

Detailed error string

sdk_service.proto

NotificationRegisterRequest.Operation

Represents notification stream subscription request operation.

Table 81. NotificationRegisterRequest.Operation
NameNumberDescription

Create

0

Create a subscription

Delete

1

Delete all subscriptions

AddSubscription

2

Add subscription to existing subscriptions

DeleteSubscription

3

Delete one subscription from existing subscriptions

AgentRegistrationRequest

Represents registration request message used in agent register and unregister.

Table 82. AgentRegistrationRequest
FieldTypeLabelDescription

js_path

string

repeated

Optional, JSON path formatted strings, which are used in telemetry. Format of js_path follows hierarchical YANG. for example: .interface{.name==*}.my_app. .my_app.tunnel{.name==*} '*'' needs to be replaced with a specific key.

agent_liveliness

uint32

Kill this agent unless a keepalive is received within this many seconds. Value of 0 means do not monitor this agent for liveliness.

wait_config_ack

bool

Indicate if SRLinux should wait for explicit ack from app after delivering configuration.

AgentRegistrationResponse

Represents registration response in reply to registration request.

Table 83. AgentRegistrationResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Status of the register; for example: kOk, kFailed

error_str

string

Detailed error text

app_id

uint32

Application ID assigned by SDK manager.

AppIdRequest

Represents application identifier request from agent. All applications are assigned an identifier by IDB.

Table 84. AppIdRequest
FieldTypeLabelDescription

name

string

Application name

AppIdResponse

Represents application identifier response to agent.

Table 85. AppIdResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Status of the call; for example, kOk, kFailed

id

uint32

Identifier for the given application name

KeepAliveRequest

Represents keep alive request from agent to refresh liveliness of the agent.

KeepAliveResponse

Represents keepalive response.

Table 86. KeepAliveResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Status of keepalive; for example, kOk or kFailed

Notification

Represents notification stream response.

Table 87. Notification
FieldTypeLabelDescription

sub_id

uint64

Subscription identifier

intf

InterfaceNotification

Interface details

nw_inst

NetworkInstanceNotification

Network instance details

lldp_neighbor

LldpNeighborNotification

LLDP neighbor details

config

ConfigNotification

Configuration notification

bfd_session

BfdSessionNotification

BFD session details

route

IpRouteNotification

IP route details

appid

AppIdentNotification

App identification details

nhg

NextHopGroupNotification

Next-hop group details

NotificationQueryRequest

Represents notification query to return specific subscription details.

Table 88. NotificationQueryRequest
FieldTypeLabelDescription

stream_id

uint64

Stream identifier, in NotificationRegisterResponse

NotificationQueryResponse

Represents notification query response.

Table 89. NotificationQueryResponse
FieldTypeLabelDescription

subscriptions

NotificationQuerySubscription

repeated

List of subscription details

status

SdkMgrStatus

Status of the query

NotificationQuerySubscription

Represents notification subscription.

Table 90. NotificationQuerySubscription
FieldTypeLabelDescription

sub_id

uint64

Subscription identifier

description

string

Subscription description

NotificationRegisterRequest

Represents notification request from agent. Agent uses this message to subscribe to router events such as interface create, delete, or update, as well as LLDP neighbor create, delete, or update, and so on.

Table 91. NotificationRegisterRequest
FieldTypeLabelDescription

stream_id

uint64

Unset on create, set otherwise

op

Operation

Specific operation in the notification register request

sub_id

uint64

Set for delete subscription, unset otherwise

intf

InterfaceSubscriptionRequest

Interface subscription request

nw_inst

NetworkInstanceSubscriptionRequest

Network instance subscription request

lldp_neighbor

LldpNeighborSubscriptionRequest

LLDP neighbor subscription request

config

ConfigSubscriptionRequest

Configuration subscription request

bfd_session

BfdSessionSubscriptionRequest

BFD session subscription request

route

IpRouteSubscriptionRequest

IP route subscription request

appid

AppIdentSubscriptionRequest

App identification subscription request

nhg

NextHopGroupSubscriptionRequest

Nexthop Group subscription request

NotificationRegisterResponse

Represents notification response.

Table 92. NotificationRegisterResponse
FieldTypeLabelDescription

stream_id

uint64

Stream identifier. This needs to be passed to the SDK manager for further notification subscription changes specific to the current subscription

sub_id

uint64

Subscription identifier. Each subscription gets an identifier, which can be used to delete a subscription

status

SdkMgrStatus

Status of subscription

NotificationStreamRequest

Represents notification stream request.

Table 93. NotificationStreamRequest
FieldTypeLabelDescription

stream_id

uint64

Stream identifier

NotificationStreamResponse

Represents notification stream response that contains one or more notification.

Table 94. NotificationStreamResponse
FieldTypeLabelDescription

notification

Notification

repeated

Notification details

SdkMgrService

Represents base service that defines agent registration, unregistration, notification subscriptions, and keepalive messages.

Table 95. SdkMgrService
Method NameRequest TypeResponse TypeDescription

AgentRegister

AgentRegistrationRequestAgentRegistrationResponse

Register agent

AgentUnRegister

AgentRegistrationRequestAgentRegistrationResponse

Unregister agent

NotificationRegister

NotificationRegisterRequestNotificationRegisterResponse

Register for event notifications

NotificationQuery

NotificationQueryRequestNotificationQueryResponse

Returns current or specific notification subscription details

KeepAlive

KeepAliveRequestKeepAliveResponse

Send periodic keepalive message

GetAppId

AppIdRequestAppIdResponse

Get application name from application identifier

SdkNotificationService

Represents service for handling notifications.

Table 96. SdkNotificationService
Method NameRequest TypeResponse TypeDescription

NotificationStream

NotificationStreamRequestNotificationStreamResponse

Send stream of event notifications based on the agent subscriptions

telemetry_service.proto

TelemetryData

Represents telemetry data.

Table 97. TelemetryData
FieldTypeLabelDescription

json_content

string

Structured JSON telemetry data

TelemetryDeleteRequest

Represents telemetry delete request.

Table 98. TelemetryDeleteRequest
FieldTypeLabelDescription

key

TelemetryKey

repeated

Telemetry key

TelemetryDeleteResponse

Represents telemetry delete response.

Table 99. TelemetryDeleteResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Status of delete request

error_str

string

Detailed error message

TelemetryInfo

Represents telemetry information.

Table 100. TelemetryInfo
FieldTypeLabelDescription

key

TelemetryKey

Telemetry key

data

TelemetryData

Telemetry data

TelemetryKey

Represents telemetry key.

Table 101. TelemetryKey
FieldTypeLabelDescription

js_path

string

JSON path referencing the key for telemetry data

TelemetryUpdateRequest

Represents telemetry update request.

Table 102. TelemetryUpdateRequest
FieldTypeLabelDescription

state

TelemetryInfo

repeated

State of application

TelemetryUpdateResponse

Represents telemetry update response.

Table 103. TelemetryUpdateResponse
FieldTypeLabelDescription

status

SdkMgrStatus

Status of telemetry update request

error_str

string

Detailed error message

Scalar Value Types

Scalar

Scalar description

Table 105. Scalar
.proto TypeNotesC++C#GoJavaPHPPythonRuby

double

double

double

float64

double

float

float

Float

float

float

float

float32

float

float

float

Float

int32

Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead.

int32

int

int32

int

integer

int

Bignum or Fixnum (as required)

int64

Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead.

int64

long

int64

long

integer/string

int/long

Bignum

uint32

Uses variable-length encoding.

uint32

uint

uint32

int

integer

int/long

Bignum or Fixnum (as required)

uint64

Uses variable-length encoding.

uint64

ulong

uint64

long

integer/string

int/long

Bignum or Fixnum (as required)

sint32

Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s.

int32

int

int32

int

integer

int

Bignum or Fixnum (as required)

sint64

Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s.

int64

long

int64

long

integer/string

int/long

Bignum

fixed32

Always four bytes. More efficient than uint32 if values are often greater than 2^28.

uint32

uint

uint32

int

integer

int

Bignum or Fixnum (as required)

fixed64

Always eight bytes. More efficient than uint64 if values are often greater than 2^56.

uint64

ulong

uint64

long

integer/string

int/long

Bignum

sfixed32

Always four bytes.

int32

int

int32

int

integer

int

Bignum or Fixnum (as required)

sfixed64

Always eight bytes.

int64

long

int64

long

integer/string

int/long

Bignum

bool

bool

bool

bool

boolean

boolean

boolean

TrueClass/FalseClass

string

A string must always contain UTF-8 encoded or 7-bit ASCII text.

string

string

string

String

string

str/unicode

String (UTF-8)

bytes

May contain any arbitrary sequence of bytes.

string

ByteString

[]byte

ByteString

string

str

String (ASCII-8BIT)