Skip to main content

Class: OperatorService

operatorservice.v1.OperatorService

OperatorService API defines how Temporal SDKs and other clients interact with the Temporal server to perform administrative functions like registering a search attribute or a namespace. APIs in this file could be not compatible with Temporal Cloud, hence it's usage in SDKs should be limited by designated APIs that clearly state that they shouldn't be used by the main Application (Workflows & Activities) framework.

Hierarchy

  • Service

    OperatorService

Constructors

constructor

new OperatorService(rpcImpl, requestDelimited?, responseDelimited?): OperatorService

Constructs a new OperatorService service.

Parameters

NameTypeDescription
rpcImplRPCImplRPC implementation
requestDelimited?booleanWhether requests are length-delimited
responseDelimited?booleanWhether responses are length-delimited

Returns

OperatorService

Overrides

$protobuf.rpc.Service.constructor

Properties

requestDelimited

requestDelimited: boolean

Whether requests are length-delimited.

Inherited from

$protobuf.rpc.Service.requestDelimited


responseDelimited

responseDelimited: boolean

Whether responses are length-delimited.

Inherited from

$protobuf.rpc.Service.responseDelimited


rpcImpl

rpcImpl: null | RPCImpl

RPC implementation. Becomes null once the service is ended.

Inherited from

$protobuf.rpc.Service.rpcImpl

Methods

addOrUpdateRemoteCluster

addOrUpdateRemoteCluster(request, callback): void

AddOrUpdateRemoteCluster adds or updates remote cluster.

Parameters

NameTypeDescription
requestIAddOrUpdateRemoteClusterRequestAddOrUpdateRemoteClusterRequest message or plain object
callbackAddOrUpdateRemoteClusterCallbackNode-style callback called with the error, if any, and AddOrUpdateRemoteClusterResponse

Returns

void

addOrUpdateRemoteCluster(request): Promise<AddOrUpdateRemoteClusterResponse>

AddOrUpdateRemoteCluster adds or updates remote cluster.

Parameters

NameTypeDescription
requestIAddOrUpdateRemoteClusterRequestAddOrUpdateRemoteClusterRequest message or plain object

Returns

Promise<AddOrUpdateRemoteClusterResponse>

Promise


addSearchAttributes

addSearchAttributes(request, callback): void

AddSearchAttributes add custom search attributes.

Returns ALREADY_EXISTS status code if a Search Attribute with any of the specified names already exists Returns INTERNAL status code with temporal.api.errordetails.v1.SystemWorkflowFailure in Error Details if registration process fails,

Parameters

NameTypeDescription
requestIAddSearchAttributesRequestAddSearchAttributesRequest message or plain object
callbackAddSearchAttributesCallbackNode-style callback called with the error, if any, and AddSearchAttributesResponse

Returns

void

addSearchAttributes(request): Promise<AddSearchAttributesResponse>

AddSearchAttributes add custom search attributes.

Returns ALREADY_EXISTS status code if a Search Attribute with any of the specified names already exists Returns INTERNAL status code with temporal.api.errordetails.v1.SystemWorkflowFailure in Error Details if registration process fails,

Parameters

NameTypeDescription
requestIAddSearchAttributesRequestAddSearchAttributesRequest message or plain object

Returns

Promise<AddSearchAttributesResponse>

Promise


deleteNamespace

deleteNamespace(request, callback): void

DeleteNamespace synchronously deletes a namespace and asynchronously reclaims all namespace resources. (-- api-linter: core::0135::method-signature=disabled aip.dev/not-precedent: DeleteNamespace RPC doesn't follow Google API format. --) (-- api-linter: core::0135::response-message-name=disabled aip.dev/not-precedent: DeleteNamespace RPC doesn't follow Google API format. --)

Parameters

NameTypeDescription
requestIDeleteNamespaceRequestDeleteNamespaceRequest message or plain object
callbackDeleteNamespaceCallbackNode-style callback called with the error, if any, and DeleteNamespaceResponse

Returns

void

deleteNamespace(request): Promise<DeleteNamespaceResponse>

DeleteNamespace synchronously deletes a namespace and asynchronously reclaims all namespace resources. (-- api-linter: core::0135::method-signature=disabled aip.dev/not-precedent: DeleteNamespace RPC doesn't follow Google API format. --) (-- api-linter: core::0135::response-message-name=disabled aip.dev/not-precedent: DeleteNamespace RPC doesn't follow Google API format. --)

Parameters

NameTypeDescription
requestIDeleteNamespaceRequestDeleteNamespaceRequest message or plain object

Returns

Promise<DeleteNamespaceResponse>

Promise


emit

emit(evt, ...args): this

Emits an event by calling its listeners with the specified arguments.

Parameters

NameTypeDescription
evtstringEvent name
...argsany[]Arguments

Returns

this

this

Inherited from

$protobuf.rpc.Service.emit


end

end(endedByRPC?): Service

Ends this service and emits the end event.

Parameters

NameTypeDescription
endedByRPC?booleanWhether the service has been ended by the RPC implementation.

Returns

Service

this

Inherited from

$protobuf.rpc.Service.end


listClusters

listClusters(request, callback): void

ListClusters returns information about Temporal clusters.

Parameters

NameTypeDescription
requestIListClustersRequestListClustersRequest message or plain object
callbackListClustersCallbackNode-style callback called with the error, if any, and ListClustersResponse

Returns

void

listClusters(request): Promise<ListClustersResponse>

ListClusters returns information about Temporal clusters.

Parameters

NameTypeDescription
requestIListClustersRequestListClustersRequest message or plain object

Returns

Promise<ListClustersResponse>

Promise


listSearchAttributes

listSearchAttributes(request, callback): void

ListSearchAttributes returns comprehensive information about search attributes.

Parameters

NameTypeDescription
requestIListSearchAttributesRequestListSearchAttributesRequest message or plain object
callbackListSearchAttributesCallbackNode-style callback called with the error, if any, and ListSearchAttributesResponse

Returns

void

listSearchAttributes(request): Promise<ListSearchAttributesResponse>

ListSearchAttributes returns comprehensive information about search attributes.

Parameters

NameTypeDescription
requestIListSearchAttributesRequestListSearchAttributesRequest message or plain object

Returns

Promise<ListSearchAttributesResponse>

Promise


off

off(evt?, fn?): this

Removes an event listener or any matching listeners if arguments are omitted.

Parameters

NameTypeDescription
evt?stringEvent name. Removes all listeners if omitted.
fn?EventEmitterListenerListener to remove. Removes all listeners of evt if omitted.

Returns

this

this

Inherited from

$protobuf.rpc.Service.off


on

on(evt, fn, ctx?): this

Registers an event listener.

Parameters

NameTypeDescription
evtstringEvent name
fnEventEmitterListenerListener
ctx?anyListener context

Returns

this

this

Inherited from

$protobuf.rpc.Service.on


removeRemoteCluster

removeRemoteCluster(request, callback): void

RemoveRemoteCluster removes remote cluster.

Parameters

NameTypeDescription
requestIRemoveRemoteClusterRequestRemoveRemoteClusterRequest message or plain object
callbackRemoveRemoteClusterCallbackNode-style callback called with the error, if any, and RemoveRemoteClusterResponse

Returns

void

removeRemoteCluster(request): Promise<RemoveRemoteClusterResponse>

RemoveRemoteCluster removes remote cluster.

Parameters

NameTypeDescription
requestIRemoveRemoteClusterRequestRemoveRemoteClusterRequest message or plain object

Returns

Promise<RemoveRemoteClusterResponse>

Promise


removeSearchAttributes

removeSearchAttributes(request, callback): void

RemoveSearchAttributes removes custom search attributes.

Returns NOT_FOUND status code if a Search Attribute with any of the specified names is not registered

Parameters

NameTypeDescription
requestIRemoveSearchAttributesRequestRemoveSearchAttributesRequest message or plain object
callbackRemoveSearchAttributesCallbackNode-style callback called with the error, if any, and RemoveSearchAttributesResponse

Returns

void

removeSearchAttributes(request): Promise<RemoveSearchAttributesResponse>

RemoveSearchAttributes removes custom search attributes.

Returns NOT_FOUND status code if a Search Attribute with any of the specified names is not registered

Parameters

NameTypeDescription
requestIRemoveSearchAttributesRequestRemoveSearchAttributesRequest message or plain object

Returns

Promise<RemoveSearchAttributesResponse>

Promise


rpcCall

rpcCall<TReq, TRes>(method, requestCtor, responseCtor, request, callback): void

Calls a service method through rpcImpl.

Type parameters

NameType
TReqextends Message<TReq>
TResextends Message<TRes>

Parameters

NameTypeDescription
methodMethod | ServiceMethod<TReq, TRes>Reflected or static method
requestCtorConstructor<TReq>Request constructor
responseCtorConstructor<TRes>Response constructor
requestTReq | Properties<TReq>Request message or plain object
callbackServiceMethodCallback<TRes>Service callback

Returns

void

Inherited from

$protobuf.rpc.Service.rpcCall


create

create(rpcImpl, requestDelimited?, responseDelimited?): OperatorService

Creates new OperatorService service using the specified rpc implementation.

Parameters

NameTypeDescription
rpcImplRPCImplRPC implementation
requestDelimited?booleanWhether requests are length-delimited
responseDelimited?booleanWhether responses are length-delimited

Returns

OperatorService

RPC service. Useful where requests and/or responses are streamed.