Class StorageTransferService.StorageTransferServiceClient (1.0.0)

public class StorageTransferServiceClient : ClientBase<StorageTransferService.StorageTransferServiceClient>

Client for StorageTransferService

Inheritance

Object > ClientBase > ClientBase<StorageTransferService.StorageTransferServiceClient> > StorageTransferService.StorageTransferServiceClient

Namespace

Google.Cloud.StorageTransfer.V1

Assembly

Google.Cloud.StorageTransfer.V1.dll

Constructors

StorageTransferServiceClient()

protected StorageTransferServiceClient()

Protected parameterless constructor to allow creation of test doubles.

StorageTransferServiceClient(CallInvoker)

public StorageTransferServiceClient(CallInvoker callInvoker)

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

Parameter
NameDescription
callInvokerCallInvoker

The callInvoker to use to make remote calls.

StorageTransferServiceClient(ChannelBase)

public StorageTransferServiceClient(ChannelBase channel)

Creates a new client for StorageTransferService

Parameter
NameDescription
channelChannelBase

The channel to use to make remote calls.

StorageTransferServiceClient(ClientBase.ClientBaseConfiguration)

protected StorageTransferServiceClient(ClientBase.ClientBaseConfiguration configuration)

Protected constructor to allow creation of configured clients.

Parameter
NameDescription
configurationClientBase.ClientBaseConfiguration

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
Operations.OperationsClient

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

CreateTransferJob(CreateTransferJobRequest, CallOptions)

public virtual TransferJob CreateTransferJob(CreateTransferJobRequest request, CallOptions options)

Creates a transfer job that runs periodically.

Parameters
NameDescription
requestCreateTransferJobRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
TransferJob

The response received from the server.

CreateTransferJob(CreateTransferJobRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual TransferJob CreateTransferJob(CreateTransferJobRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Creates a transfer job that runs periodically.

Parameters
NameDescription
requestCreateTransferJobRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
TransferJob

The response received from the server.

CreateTransferJobAsync(CreateTransferJobRequest, CallOptions)

public virtual AsyncUnaryCall<TransferJob> CreateTransferJobAsync(CreateTransferJobRequest request, CallOptions options)

Creates a transfer job that runs periodically.

Parameters
NameDescription
requestCreateTransferJobRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<TransferJob>

The call object.

CreateTransferJobAsync(CreateTransferJobRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual AsyncUnaryCall<TransferJob> CreateTransferJobAsync(CreateTransferJobRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Creates a transfer job that runs periodically.

Parameters
NameDescription
requestCreateTransferJobRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
AsyncUnaryCall<TransferJob>

The call object.

GetGoogleServiceAccount(GetGoogleServiceAccountRequest, CallOptions)

public virtual GoogleServiceAccount GetGoogleServiceAccount(GetGoogleServiceAccountRequest request, CallOptions options)

Returns the Google service account that is used by Storage Transfer Service to access buckets in the project where transfers run or in other projects. Each Google service account is associated with one Google Cloud Platform Console project. Users should add this service account to the Google Cloud Storage bucket ACLs to grant access to Storage Transfer Service. This service account is created and owned by Storage Transfer Service and can only be used by Storage Transfer Service.

Parameters
NameDescription
requestGetGoogleServiceAccountRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
GoogleServiceAccount

The response received from the server.

GetGoogleServiceAccount(GetGoogleServiceAccountRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual GoogleServiceAccount GetGoogleServiceAccount(GetGoogleServiceAccountRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Returns the Google service account that is used by Storage Transfer Service to access buckets in the project where transfers run or in other projects. Each Google service account is associated with one Google Cloud Platform Console project. Users should add this service account to the Google Cloud Storage bucket ACLs to grant access to Storage Transfer Service. This service account is created and owned by Storage Transfer Service and can only be used by Storage Transfer Service.

Parameters
NameDescription
requestGetGoogleServiceAccountRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
GoogleServiceAccount

The response received from the server.

GetGoogleServiceAccountAsync(GetGoogleServiceAccountRequest, CallOptions)

public virtual AsyncUnaryCall<GoogleServiceAccount> GetGoogleServiceAccountAsync(GetGoogleServiceAccountRequest request, CallOptions options)

Returns the Google service account that is used by Storage Transfer Service to access buckets in the project where transfers run or in other projects. Each Google service account is associated with one Google Cloud Platform Console project. Users should add this service account to the Google Cloud Storage bucket ACLs to grant access to Storage Transfer Service. This service account is created and owned by Storage Transfer Service and can only be used by Storage Transfer Service.

Parameters
NameDescription
requestGetGoogleServiceAccountRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<GoogleServiceAccount>

The call object.

GetGoogleServiceAccountAsync(GetGoogleServiceAccountRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual AsyncUnaryCall<GoogleServiceAccount> GetGoogleServiceAccountAsync(GetGoogleServiceAccountRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Returns the Google service account that is used by Storage Transfer Service to access buckets in the project where transfers run or in other projects. Each Google service account is associated with one Google Cloud Platform Console project. Users should add this service account to the Google Cloud Storage bucket ACLs to grant access to Storage Transfer Service. This service account is created and owned by Storage Transfer Service and can only be used by Storage Transfer Service.

Parameters
NameDescription
requestGetGoogleServiceAccountRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
AsyncUnaryCall<GoogleServiceAccount>

The call object.

GetTransferJob(GetTransferJobRequest, CallOptions)

public virtual TransferJob GetTransferJob(GetTransferJobRequest request, CallOptions options)

Gets a transfer job.

Parameters
NameDescription
requestGetTransferJobRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
TransferJob

The response received from the server.

GetTransferJob(GetTransferJobRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual TransferJob GetTransferJob(GetTransferJobRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Gets a transfer job.

Parameters
NameDescription
requestGetTransferJobRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
TransferJob

The response received from the server.

GetTransferJobAsync(GetTransferJobRequest, CallOptions)

public virtual AsyncUnaryCall<TransferJob> GetTransferJobAsync(GetTransferJobRequest request, CallOptions options)

Gets a transfer job.

Parameters
NameDescription
requestGetTransferJobRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<TransferJob>

The call object.

GetTransferJobAsync(GetTransferJobRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual AsyncUnaryCall<TransferJob> GetTransferJobAsync(GetTransferJobRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Gets a transfer job.

Parameters
NameDescription
requestGetTransferJobRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
AsyncUnaryCall<TransferJob>

The call object.

ListTransferJobs(ListTransferJobsRequest, CallOptions)

public virtual ListTransferJobsResponse ListTransferJobs(ListTransferJobsRequest request, CallOptions options)

Lists transfer jobs.

Parameters
NameDescription
requestListTransferJobsRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
ListTransferJobsResponse

The response received from the server.

ListTransferJobs(ListTransferJobsRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual ListTransferJobsResponse ListTransferJobs(ListTransferJobsRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Lists transfer jobs.

Parameters
NameDescription
requestListTransferJobsRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
ListTransferJobsResponse

The response received from the server.

ListTransferJobsAsync(ListTransferJobsRequest, CallOptions)

public virtual AsyncUnaryCall<ListTransferJobsResponse> ListTransferJobsAsync(ListTransferJobsRequest request, CallOptions options)

Lists transfer jobs.

Parameters
NameDescription
requestListTransferJobsRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<ListTransferJobsResponse>

The call object.

ListTransferJobsAsync(ListTransferJobsRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual AsyncUnaryCall<ListTransferJobsResponse> ListTransferJobsAsync(ListTransferJobsRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Lists transfer jobs.

Parameters
NameDescription
requestListTransferJobsRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
AsyncUnaryCall<ListTransferJobsResponse>

The call object.

NewInstance(ClientBase.ClientBaseConfiguration)

protected override StorageTransferService.StorageTransferServiceClient NewInstance(ClientBase.ClientBaseConfiguration configuration)

Creates a new instance of client from given ClientBaseConfiguration.

Parameter
NameDescription
configurationClientBase.ClientBaseConfiguration
Returns
TypeDescription
StorageTransferService.StorageTransferServiceClient
Overrides
Grpc.Core.ClientBase<Google.Cloud.StorageTransfer.V1.StorageTransferService.StorageTransferServiceClient>.NewInstance(Grpc.Core.ClientBase.ClientBaseConfiguration)

PauseTransferOperation(PauseTransferOperationRequest, CallOptions)

public virtual Empty PauseTransferOperation(PauseTransferOperationRequest request, CallOptions options)

Pauses a transfer operation.

Parameters
NameDescription
requestPauseTransferOperationRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
Empty

The response received from the server.

PauseTransferOperation(PauseTransferOperationRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual Empty PauseTransferOperation(PauseTransferOperationRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Pauses a transfer operation.

Parameters
NameDescription
requestPauseTransferOperationRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
Empty

The response received from the server.

PauseTransferOperationAsync(PauseTransferOperationRequest, CallOptions)

public virtual AsyncUnaryCall<Empty> PauseTransferOperationAsync(PauseTransferOperationRequest request, CallOptions options)

Pauses a transfer operation.

Parameters
NameDescription
requestPauseTransferOperationRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<Empty>

The call object.

PauseTransferOperationAsync(PauseTransferOperationRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual AsyncUnaryCall<Empty> PauseTransferOperationAsync(PauseTransferOperationRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Pauses a transfer operation.

Parameters
NameDescription
requestPauseTransferOperationRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
AsyncUnaryCall<Empty>

The call object.

ResumeTransferOperation(ResumeTransferOperationRequest, CallOptions)

public virtual Empty ResumeTransferOperation(ResumeTransferOperationRequest request, CallOptions options)

Resumes a transfer operation that is paused.

Parameters
NameDescription
requestResumeTransferOperationRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
Empty

The response received from the server.

ResumeTransferOperation(ResumeTransferOperationRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual Empty ResumeTransferOperation(ResumeTransferOperationRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Resumes a transfer operation that is paused.

Parameters
NameDescription
requestResumeTransferOperationRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
Empty

The response received from the server.

ResumeTransferOperationAsync(ResumeTransferOperationRequest, CallOptions)

public virtual AsyncUnaryCall<Empty> ResumeTransferOperationAsync(ResumeTransferOperationRequest request, CallOptions options)

Resumes a transfer operation that is paused.

Parameters
NameDescription
requestResumeTransferOperationRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<Empty>

The call object.

ResumeTransferOperationAsync(ResumeTransferOperationRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual AsyncUnaryCall<Empty> ResumeTransferOperationAsync(ResumeTransferOperationRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Resumes a transfer operation that is paused.

Parameters
NameDescription
requestResumeTransferOperationRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
AsyncUnaryCall<Empty>

The call object.

RunTransferJob(RunTransferJobRequest, CallOptions)

public virtual Operation RunTransferJob(RunTransferJobRequest request, CallOptions options)

Attempts to start a new TransferOperation for the current TransferJob. A TransferJob has a maximum of one active TransferOperation. If this method is called while a TransferOperation is active, an error wil be returned.

Parameters
NameDescription
requestRunTransferJobRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
Operation

The response received from the server.

RunTransferJob(RunTransferJobRequest, Metadata, Nullable<DateTime>, CancellationToken)

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

Attempts to start a new TransferOperation for the current TransferJob. A TransferJob has a maximum of one active TransferOperation. If this method is called while a TransferOperation is active, an error wil be returned.

Parameters
NameDescription
requestRunTransferJobRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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.

RunTransferJobAsync(RunTransferJobRequest, CallOptions)

public virtual AsyncUnaryCall<Operation> RunTransferJobAsync(RunTransferJobRequest request, CallOptions options)

Attempts to start a new TransferOperation for the current TransferJob. A TransferJob has a maximum of one active TransferOperation. If this method is called while a TransferOperation is active, an error wil be returned.

Parameters
NameDescription
requestRunTransferJobRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<Operation>

The call object.

RunTransferJobAsync(RunTransferJobRequest, Metadata, Nullable<DateTime>, CancellationToken)

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

Attempts to start a new TransferOperation for the current TransferJob. A TransferJob has a maximum of one active TransferOperation. If this method is called while a TransferOperation is active, an error wil be returned.

Parameters
NameDescription
requestRunTransferJobRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
AsyncUnaryCall<Operation>

The call object.

UpdateTransferJob(UpdateTransferJobRequest, CallOptions)

public virtual TransferJob UpdateTransferJob(UpdateTransferJobRequest request, CallOptions options)

Updates a transfer job. Updating a job's transfer spec does not affect transfer operations that are running already.

Note: The job's [status][google.storagetransfer.v1.TransferJob.status] field can be modified using this RPC (for example, to set a job's status to [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED], [DISABLED][google.storagetransfer.v1.TransferJob.Status.DISABLED], or [ENABLED][google.storagetransfer.v1.TransferJob.Status.ENABLED]).

Parameters
NameDescription
requestUpdateTransferJobRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
TransferJob

The response received from the server.

UpdateTransferJob(UpdateTransferJobRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual TransferJob UpdateTransferJob(UpdateTransferJobRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Updates a transfer job. Updating a job's transfer spec does not affect transfer operations that are running already.

Note: The job's [status][google.storagetransfer.v1.TransferJob.status] field can be modified using this RPC (for example, to set a job's status to [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED], [DISABLED][google.storagetransfer.v1.TransferJob.Status.DISABLED], or [ENABLED][google.storagetransfer.v1.TransferJob.Status.ENABLED]).

Parameters
NameDescription
requestUpdateTransferJobRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
TransferJob

The response received from the server.

UpdateTransferJobAsync(UpdateTransferJobRequest, CallOptions)

public virtual AsyncUnaryCall<TransferJob> UpdateTransferJobAsync(UpdateTransferJobRequest request, CallOptions options)

Updates a transfer job. Updating a job's transfer spec does not affect transfer operations that are running already.

Note: The job's [status][google.storagetransfer.v1.TransferJob.status] field can be modified using this RPC (for example, to set a job's status to [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED], [DISABLED][google.storagetransfer.v1.TransferJob.Status.DISABLED], or [ENABLED][google.storagetransfer.v1.TransferJob.Status.ENABLED]).

Parameters
NameDescription
requestUpdateTransferJobRequest

The request to send to the server.

optionsCallOptions

The options for the call.

Returns
TypeDescription
AsyncUnaryCall<TransferJob>

The call object.

UpdateTransferJobAsync(UpdateTransferJobRequest, Metadata, Nullable<DateTime>, CancellationToken)

public virtual AsyncUnaryCall<TransferJob> UpdateTransferJobAsync(UpdateTransferJobRequest request, Metadata headers = null, DateTime? deadline = default(DateTime? ), CancellationToken cancellationToken = default(CancellationToken))

Updates a transfer job. Updating a job's transfer spec does not affect transfer operations that are running already.

Note: The job's [status][google.storagetransfer.v1.TransferJob.status] field can be modified using this RPC (for example, to set a job's status to [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED], [DISABLED][google.storagetransfer.v1.TransferJob.Status.DISABLED], or [ENABLED][google.storagetransfer.v1.TransferJob.Status.ENABLED]).

Parameters
NameDescription
requestUpdateTransferJobRequest

The request to send to the server.

headersMetadata

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

deadlineNullable<DateTime>

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
AsyncUnaryCall<TransferJob>

The call object.