CCPEDIAby Unity Nodes
Documentation/Canton Network Docs/Admin API › gRPC API › Packages › com.digitalasset.canton.admin.participant.v30 › Services › PingServiceView on Canton Network Docs ↗

Ping

Participant Administration›Protobuf›com.digitalasset.canton.admin.participant.v30›Ping

com.digitalasset.canton.admin.participant.v30

​
Ping

gRPC
RPC/com.digitalasset.canton.admin.participant.v30.PingService/Ping

​
Protocol Details

ProtocolgRPC
ServicePingService
RPCPing
Client streamNo
Server streamNo

​
Inputs

​
PingRequest

Messagecom.digitalasset.canton.admin.participant.v30.PingRequest
Client streamNo
target_partiesrepeated string
validatorsrepeated string
timeoutDuration
levelsuint32
synchronizer_idstring
workflow_idstring
idstring

​
Outputs

​
PingResponse

Messagecom.digitalasset.canton.admin.participant.v30.PingResponse
Server streamNo
successPingSuccess
failurePingFailure

com.digitalasset.canton.admin.participant.v30.PingRequest

target_partiesrepeated string
validatorsrepeated string
timeoutDuration
levelsuint32
synchronizer_idstring
workflow_idstring
idstring

com.digitalasset.canton.admin.participant.v30.PingResponse

successPingSuccess
failurePingFailure

com.digitalasset.canton.admin.participant.v30.PingSuccess

ping_timeuint64
responderstring

com.digitalasset.canton.admin.participant.v30.PingFailure

reasonstring
grpcurl
grpcurl
# Add -plaintext if the server is not using TLS.
grpcurl \
  -d @ \
  <HOST:PORT> \
  com.digitalasset.canton.admin.participant.v30.PingService/Ping <<'EOF'
{
  "targetParties": [
    "string"
  ],
  "validators": [
    "string"
  ],
  "timeout": "string",
  "levels": 0,
  "synchronizerId": "string",
  "workflowId": "string",
  "id": "string"
}
EOF
OKapplication/json
OK
{
  "success": {
    "pingTime": "0",
    "responder": "string"
  }
}