Skip to main content

Get

Returns the specified rules. To get the list of all available buses, make a List request.

import { cloudApi, serviceClients, Session } from "@yandex-cloud/nodejs-sdk";

const GetRuleRequest =
  cloudApi.serverless.eventrouter_rule_service.GetRuleRequest;

(async () => {
  const authToken = process.env["YC_OAUTH_TOKEN"];
  const session = new Session({ oauthToken: authToken });
  const client = session.client(serviceClients.RuleServiceClient);

  const result = await client.get(
    GetRuleRequest.fromPartial({
      ruleId: "ruleId",
    })
  );
  console.log(result);
})();

GetRuleRequest​

ruleId : string​

ID of the rule to return.

Rule​

Status​

  • STATUS_UNSPECIFIED

  • CREATING

    Rule creation in progress, rule is not enabled yet

  • ENABLED

    Rule is operating

  • UPDATING

    Rule update in progress, rule is disabled during update

  • DISABLED

    Rule is explicitly disabled by the user

id : string​

ID of the rule.

busId : string​

ID of the bus that the rule belongs to.

folderId : string​

ID of the folder that the rule resides in.

cloudId : string​

ID of the cloud that the rule resides in.

createdAt : google.protobuf.Timestamp​

Creation timestamp.

name : string​

Name of the rule.

description : string​

Description of the rule.

labels : string​

Resource labels as key:value pairs.

filter : Filter​

Filter for the rule.

targets : Target​

Targets of the rule.

deletionProtection : bool​

Flag that disallow deletion of the rule.

status : Status​

Rule status

Filter​

One of condition​

  • jqFilter : string​

    JQ filter for matching events.

Target​

Status​

Status of the target.

  • STATUS_UNSPECIFIED

    Status of the target.

  • ENABLED

    Target is enabled.

  • DISABLED

    Target is disabled.

  • RESOURCE_NOT_FOUND

    Target does not exist.

  • PERMISSION_DENIED

    Service account does not have read permission on source.

  • SUBJECT_NOT_FOUND

    Service account not found.

One of target​

  • yds : YdsTarget​
  • ymq : YmqTarget​
  • function : FunctionTarget​
  • container : ContainerTarget​
  • gatewayWsBroadcast : GatewayWebsocketBroadcastTarget​
  • logging : LoggingTarget​
  • workflow : WorkflowTarget​
transformer : Transformer​

Transformer of the target.

retrySettings : RetrySettings​

Retry settings of the target.

One of deadLetter​

Dead letter settings of the target.

  • deadLetterQueue : PutQueueMessage​

    Dead letter queue.

status : Status​

Status of the target.

YdsTarget​

database : string​

Stream database.

streamName : string​

Full stream name, like /ru-central1/aoegtvhtp8ob****/cc8004q4lbo6****/test.

serviceAccountId : string​

Service account, which has write permission on the stream.

YmqTarget​

queueArn : string​

Queue ARN. Example: yrn:yc:ymq:ru-central1:aoe***:test

serviceAccountId : string​

Service account which has write access to the queue.

FunctionTarget​

functionId : string​

Function ID.

functionTag : string​

Function tag, optional.

serviceAccountId : string​

Service account which has call permission on the function, optional.

batchSettings : BatchSettings​

Batch settings.

ContainerTarget​

containerId : string​

Container ID.

containerRevisionId : string​

Container revision ID.

path : string​

Endpoint HTTP path to invoke.

serviceAccountId : string​

Service account which should be used to call a container, optional.

batchSettings : BatchSettings​

Batch settings.

GatewayWebsocketBroadcastTarget​

gatewayId : string​

Gateway ID.

path : string​

Path.

serviceAccountId : string​

Service account which has permission for writing to websockets.

batchSettings : BatchSettings​

Batch settings.

LoggingTarget​

One of destination​

Log group ID or folder ID.

  • logGroupId : string​
  • folderId : string​
serviceAccountId : string​

Service account which has permission for writing logs.

WorkflowTarget​

workflowId : string​

Workflow ID.

serviceAccountId : string​

SA which should be used to start workflow.

batchSettings : BatchSettings​

Batch settings.

Transformer​

One of transformer​

  • jqTransformer : string​

    JQ string inrerpolation expression for changing event format.

RetrySettings​

retryAttempts : int64​

Maximum number of retries (extra calls) before an action fails.

maximumAge : google.protobuf.Duration​

Event goes to dlq when its age exceeds this value. Default is 24h.

PutQueueMessage​

queueArn : string​

ID of the queue.

serviceAccountId : string​

Service account which has write permission on the queue.

BatchSettings​

maxCount : int64​

Maximum batch size: trigger will send a batch if number of events exceeds this value.

maxBytes : int64​

Maximum batch size: trigger will send a batch if total size of events exceeds this value.

cutoff : google.protobuf.Duration​

Maximum batch size: trigger will send a batch if its lifetime exceeds this value.