@nebius/js-sdk - v0.2.54
    Preparing search index...

    Class NebiusGrpcError

    Reports a failed Nebius gRPC request with structured diagnostics.

    SDK unary requests wrap gRPC service errors with this class. Use code for general control flow. Use serviceErrors to inspect Nebius-specific causes such as field violations, quota failures, and resource conflicts. Include requestId and traceId when you contact support.

    import { SDK } from '@nebius/js-sdk';
    import {
      BucketService,
      GetBucketRequest,
    } from '@nebius/js-sdk/api/nebius/storage/v1/index';
    import { NebiusGrpcError } from '@nebius/js-sdk/runtime/error';
    import { EnvBearer } from '@nebius/js-sdk/runtime/token/static';

    const sdk = new SDK({
      credentials: new EnvBearer('NEBIUS_IAM_TOKEN'),
      userAgentPrefix: 'example-application/1.0',
    });
    try {
      const buckets = new BucketService(sdk);
      const request = GetBucketRequest.create({ id: 'bucket-id' });
      await buckets.get(request).result;
    } catch (error) {
      if (error instanceof NebiusGrpcError) {
        console.error('gRPC code', error.code);
        console.error('request ID', error.requestId);
        for (const serviceError of error.serviceErrors) {
          console.error(serviceError.code, serviceError.details);
        }
      }
      throw error;
    } finally {
      await sdk.close();
    }

    Hierarchy

    • Error
      • NebiusGrpcError

    Implements

    • ServiceError
    Index
    constructor
    code details metadata requestId serviceErrors status? traceId
    toString buildMessage

    • Creates a Nebius error from a gRPC error and optional decoded values.

      SDK request handling normally calls this constructor.

      Parameters

      • base: ServiceError
      • Optionalstatus: Status
      • serviceErrors: ServiceError[] = []
      • OptionalrequestId: string
      • OptionaltraceId: string

      Returns NebiusGrpcError

    code: number

    Contains the numeric gRPC status code.

    details: string

    Contains the plain gRPC detail text.

    metadata: Metadata

    Contains response metadata from the failed call.

    requestId: string

    Contains the server request ID, or an empty string when unavailable.

    serviceErrors: ServiceError[]

    Contains decoded Nebius service-error details.

    status?: Status

    Contains the decoded Google RPC status when available.

    traceId: string

    Contains the server trace ID, or an empty string when unavailable.

    • Builds the human-readable error message used by the constructor.

      The message includes status text, correlation IDs, and summaries of known Nebius service errors. Use structured properties when program logic needs these values.

      Parameters

      • base: ServiceError
      • Optionalstatus: Status
      • serviceErrors: ServiceError[] = []
      • OptionalrequestId: string
      • OptionaltraceId: string

      Returns string

    Settings
    Member Visibility

    On This Page
    Constructors
    Properties
    Methods