Workflows v1 API - Class Workflows.WorkflowsClient (2.1.0)

public class Workflows.WorkflowsClient : ClientBase<Workflows.WorkflowsClient>

Reference documentation and code samples for the Workflows v1 API class Workflows.WorkflowsClient.

Client for Workflows

Inheritance

object > ClientBase > ClientBaseWorkflowsWorkflowsClient > Workflows.WorkflowsClient

Namespace

GoogleCloudGoogle.Cloud.WorkflowsV1

Assembly

Google.Cloud.Workflows.V1.dll

Constructors

WorkflowsClient()

protected WorkflowsClient()

Protected parameterless constructor to allow creation of test doubles.

WorkflowsClient(CallInvoker)

public WorkflowsClient(CallInvoker callInvoker)

Creates a new client for Workflows that uses a custom CallInvoker.

Parameter
NameDescription
callInvokerCallInvoker

The callInvoker to use to make remote calls.

WorkflowsClient(ChannelBase)

public WorkflowsClient(ChannelBase channel)

Creates a new client for Workflows

Parameter
NameDescription
channelChannelBase

The channel to use to make remote calls.

WorkflowsClient(ClientBaseConfiguration)

protected WorkflowsClient(ClientBase.ClientBaseConfiguration configuration)

Protected constructor to allow creation of configured clients.

Parameter
NameDescription
configurationClientBaseClientBaseConfiguration

The client configuration.

Methods

CreateOperationsClient()

public virtual Operations.OperationsClient CreateOperationsClient()

Creates a new instance of Operations.OperationsClient using the same call invoker as this client.

Returns
TypeDescription
OperationsOperationsClient

A new Operations client for the same target as this client.

CreateWorkflow(CreateWorkflowRequest, CallOptions)

public virtual Operation CreateWorkflow(CreateWorkflowRequest request, CallOptions options)

Creates a new workflow. If a workflow with the specified name already exists in the specified project and location, the long running operation will return [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS] error.

Parameters
NameDescription
requestCreateWorkflowRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
Operation

The response received from the server.

CreateWorkflow(CreateWorkflowRequest, Metadata, DateTime?, CancellationToken)

public virtual Operation CreateWorkflow(CreateWorkflowRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default)

Creates a new workflow. If a workflow with the specified name already exists in the specified project and location, the long running operation will return [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS] error.

Parameters
NameDescription
requestCreateWorkflowRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineDateTime

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
Operation

The response received from the server.

CreateWorkflowAsync(CreateWorkflowRequest, CallOptions)

public virtual AsyncUnaryCall<Operation> CreateWorkflowAsync(CreateWorkflowRequest request, CallOptions options)

Creates a new workflow. If a workflow with the specified name already exists in the specified project and location, the long running operation will return [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS] error.

Parameters
NameDescription
requestCreateWorkflowRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCallOperation

The call object.

CreateWorkflowAsync(CreateWorkflowRequest, Metadata, DateTime?, CancellationToken)

public virtual AsyncUnaryCall<Operation> CreateWorkflowAsync(CreateWorkflowRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default)

Creates a new workflow. If a workflow with the specified name already exists in the specified project and location, the long running operation will return [ALREADY_EXISTS][google.rpc.Code.ALREADY_EXISTS] error.

Parameters
NameDescription
requestCreateWorkflowRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineDateTime

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
AsyncUnaryCallOperation

The call object.

DeleteWorkflow(DeleteWorkflowRequest, CallOptions)

public virtual Operation DeleteWorkflow(DeleteWorkflowRequest request, CallOptions options)

Deletes a workflow with the specified name. This method also cancels and deletes all running executions of the workflow.

Parameters
NameDescription
requestDeleteWorkflowRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
Operation

The response received from the server.

DeleteWorkflow(DeleteWorkflowRequest, Metadata, DateTime?, CancellationToken)

public virtual Operation DeleteWorkflow(DeleteWorkflowRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default)

Deletes a workflow with the specified name. This method also cancels and deletes all running executions of the workflow.

Parameters
NameDescription
requestDeleteWorkflowRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineDateTime

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
Operation

The response received from the server.

DeleteWorkflowAsync(DeleteWorkflowRequest, CallOptions)

public virtual AsyncUnaryCall<Operation> DeleteWorkflowAsync(DeleteWorkflowRequest request, CallOptions options)

Deletes a workflow with the specified name. This method also cancels and deletes all running executions of the workflow.

Parameters
NameDescription
requestDeleteWorkflowRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCallOperation

The call object.

DeleteWorkflowAsync(DeleteWorkflowRequest, Metadata, DateTime?, CancellationToken)

public virtual AsyncUnaryCall<Operation> DeleteWorkflowAsync(DeleteWorkflowRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default)

Deletes a workflow with the specified name. This method also cancels and deletes all running executions of the workflow.

Parameters
NameDescription
requestDeleteWorkflowRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineDateTime

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
AsyncUnaryCallOperation

The call object.

GetWorkflow(GetWorkflowRequest, CallOptions)

public virtual Workflow GetWorkflow(GetWorkflowRequest request, CallOptions options)

Gets details of a single Workflow.

Parameters
NameDescription
requestGetWorkflowRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
Workflow

The response received from the server.

GetWorkflow(GetWorkflowRequest, Metadata, DateTime?, CancellationToken)

public virtual Workflow GetWorkflow(GetWorkflowRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default)

Gets details of a single Workflow.

Parameters
NameDescription
requestGetWorkflowRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineDateTime

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
Workflow

The response received from the server.

GetWorkflowAsync(GetWorkflowRequest, CallOptions)

public virtual AsyncUnaryCall<Workflow> GetWorkflowAsync(GetWorkflowRequest request, CallOptions options)

Gets details of a single Workflow.

Parameters
NameDescription
requestGetWorkflowRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCallWorkflow

The call object.

GetWorkflowAsync(GetWorkflowRequest, Metadata, DateTime?, CancellationToken)

public virtual AsyncUnaryCall<Workflow> GetWorkflowAsync(GetWorkflowRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default)

Gets details of a single Workflow.

Parameters
NameDescription
requestGetWorkflowRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineDateTime

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
AsyncUnaryCallWorkflow

The call object.

ListWorkflows(ListWorkflowsRequest, CallOptions)

public virtual ListWorkflowsResponse ListWorkflows(ListWorkflowsRequest request, CallOptions options)

Lists Workflows in a given project and location. The default order is not specified.

Parameters
NameDescription
requestListWorkflowsRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
ListWorkflowsResponse

The response received from the server.

ListWorkflows(ListWorkflowsRequest, Metadata, DateTime?, CancellationToken)

public virtual ListWorkflowsResponse ListWorkflows(ListWorkflowsRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default)

Lists Workflows in a given project and location. The default order is not specified.

Parameters
NameDescription
requestListWorkflowsRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineDateTime

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
ListWorkflowsResponse

The response received from the server.

ListWorkflowsAsync(ListWorkflowsRequest, CallOptions)

public virtual AsyncUnaryCall<ListWorkflowsResponse> ListWorkflowsAsync(ListWorkflowsRequest request, CallOptions options)

Lists Workflows in a given project and location. The default order is not specified.

Parameters
NameDescription
requestListWorkflowsRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCallListWorkflowsResponse

The call object.

ListWorkflowsAsync(ListWorkflowsRequest, Metadata, DateTime?, CancellationToken)

public virtual AsyncUnaryCall<ListWorkflowsResponse> ListWorkflowsAsync(ListWorkflowsRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default)

Lists Workflows in a given project and location. The default order is not specified.

Parameters
NameDescription
requestListWorkflowsRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineDateTime

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
AsyncUnaryCallListWorkflowsResponse

The call object.

NewInstance(ClientBaseConfiguration)

protected override Workflows.WorkflowsClient NewInstance(ClientBase.ClientBaseConfiguration configuration)

Creates a new instance of client from given ClientBaseConfiguration.

Parameter
NameDescription
configurationClientBaseClientBaseConfiguration
Returns
TypeDescription
WorkflowsWorkflowsClient
Overrides
Grpc.Core.ClientBase<Google.Cloud.Workflows.V1.Workflows.WorkflowsClient>.NewInstance(Grpc.Core.ClientBase.ClientBaseConfiguration)

UpdateWorkflow(UpdateWorkflowRequest, CallOptions)

public virtual Operation UpdateWorkflow(UpdateWorkflowRequest request, CallOptions options)

Updates an existing workflow. Running this method has no impact on already running executions of the workflow. A new revision of the workflow may be created as a result of a successful update operation. In that case, such revision will be used in new workflow executions.

Parameters
NameDescription
requestUpdateWorkflowRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
Operation

The response received from the server.

UpdateWorkflow(UpdateWorkflowRequest, Metadata, DateTime?, CancellationToken)

public virtual Operation UpdateWorkflow(UpdateWorkflowRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default)

Updates an existing workflow. Running this method has no impact on already running executions of the workflow. A new revision of the workflow may be created as a result of a successful update operation. In that case, such revision will be used in new workflow executions.

Parameters
NameDescription
requestUpdateWorkflowRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineDateTime

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
Operation

The response received from the server.

UpdateWorkflowAsync(UpdateWorkflowRequest, CallOptions)

public virtual AsyncUnaryCall<Operation> UpdateWorkflowAsync(UpdateWorkflowRequest request, CallOptions options)

Updates an existing workflow. Running this method has no impact on already running executions of the workflow. A new revision of the workflow may be created as a result of a successful update operation. In that case, such revision will be used in new workflow executions.

Parameters
NameDescription
requestUpdateWorkflowRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCallOperation

The call object.

UpdateWorkflowAsync(UpdateWorkflowRequest, Metadata, DateTime?, CancellationToken)

public virtual AsyncUnaryCall<Operation> UpdateWorkflowAsync(UpdateWorkflowRequest request, Metadata headers = null, DateTime? deadline = null, CancellationToken cancellationToken = default)

Updates an existing workflow. Running this method has no impact on already running executions of the workflow. A new revision of the workflow may be created as a result of a successful update operation. In that case, such revision will be used in new workflow executions.

Parameters
NameDescription
requestUpdateWorkflowRequest

The request to send to the server.

headersMetadata

The initial metadata to send with the call. This parameter is optional.

deadlineDateTime

An optional deadline for the call. The call will be cancelled if deadline is hit.

cancellationTokenCancellationToken

An optional token for canceling the call.

Returns
TypeDescription
AsyncUnaryCallOperation

The call object.