Skip to main content

​
core.grpc.request

Call a gRPC method using a runtime-compiled protobuf definition.

​
Secrets

Optional secrets:
  • grpc_mtls: required values TLS_CERTIFICATE, TLS_PRIVATE_KEY.
  • grpc_ca_cert: required values CA_CERTIFICATE.

​
Inputs

​
method_name
string
required
gRPC method name (e.g., ‘Query’).
​
proto
string
required
Inline .proto definition.
​
service_name
string
required
gRPC service name (e.g., ‘API’).
​
target
string
required
gRPC server address in host:port format.
​
insecure
boolean
Use an insecure plaintext channel. Defaults to False (TLS channel).Default: false.
​
payload
object | null
Request payload as a dict matching the protobuf schema.Default: null.
​
timeout_seconds
number | null
Timeout in seconds for the RPC. Defaults to no timeout.Default: null.

​
Examples

Call a gRPC service 
- ref: grpc_query
  action: core.grpc.request
  args:
    target: grpc.example.com:443
    service_name: Alerts
    method_name: GetAlert
    proto: |
      syntax = "proto3";

      package alerts;

      service Alerts {
        rpc GetAlert (GetAlertRequest) returns (AlertResponse);
      }

      message GetAlertRequest {
        string id = 1;
      }

      message AlertResponse {
        string id = 1;
        string severity = 2;
      }
    payload:
      id: ${{ TRIGGER.alert_id }}