Storage Transfer v1 API - Class StorageTransferServiceClientImpl (2.1.0)

public sealed class StorageTransferServiceClientImpl : StorageTransferServiceClient

Reference documentation and code samples for the Storage Transfer v1 API class StorageTransferServiceClientImpl.

StorageTransferService client wrapper implementation, for convenient use.

Inheritance

Object > StorageTransferServiceClient > StorageTransferServiceClientImpl

Inherited Members

StorageTransferServiceClient.DefaultEndpoint

StorageTransferServiceClient.DefaultScopes

StorageTransferServiceClient.ServiceMetadata

StorageTransferServiceClient.CreateAsync(CancellationToken)

StorageTransferServiceClient.Create()

StorageTransferServiceClient.ShutdownDefaultChannelsAsync()

StorageTransferServiceClient.GetGoogleServiceAccountAsync(GetGoogleServiceAccountRequest, CancellationToken)

StorageTransferServiceClient.CreateTransferJobAsync(CreateTransferJobRequest, CancellationToken)

StorageTransferServiceClient.UpdateTransferJobAsync(UpdateTransferJobRequest, CancellationToken)

StorageTransferServiceClient.GetTransferJobAsync(GetTransferJobRequest, CancellationToken)

StorageTransferServiceClient.PauseTransferOperationAsync(PauseTransferOperationRequest, CancellationToken)

StorageTransferServiceClient.ResumeTransferOperationAsync(ResumeTransferOperationRequest, CancellationToken)

StorageTransferServiceClient.RunTransferJobAsync(RunTransferJobRequest, CancellationToken)

StorageTransferServiceClient.PollOnceRunTransferJob(String, CallSettings)

StorageTransferServiceClient.PollOnceRunTransferJobAsync(String, CallSettings)

StorageTransferServiceClient.DeleteTransferJobAsync(DeleteTransferJobRequest, CancellationToken)

StorageTransferServiceClient.CreateAgentPoolAsync(CreateAgentPoolRequest, CancellationToken)

StorageTransferServiceClient.CreateAgentPool(String, AgentPool, String, CallSettings)

StorageTransferServiceClient.CreateAgentPoolAsync(String, AgentPool, String, CallSettings)

StorageTransferServiceClient.CreateAgentPoolAsync(String, AgentPool, String, CancellationToken)

StorageTransferServiceClient.UpdateAgentPoolAsync(UpdateAgentPoolRequest, CancellationToken)

StorageTransferServiceClient.UpdateAgentPool(AgentPool, FieldMask, CallSettings)

StorageTransferServiceClient.UpdateAgentPoolAsync(AgentPool, FieldMask, CallSettings)

StorageTransferServiceClient.UpdateAgentPoolAsync(AgentPool, FieldMask, CancellationToken)

StorageTransferServiceClient.GetAgentPoolAsync(GetAgentPoolRequest, CancellationToken)

StorageTransferServiceClient.GetAgentPool(String, CallSettings)

StorageTransferServiceClient.GetAgentPoolAsync(String, CallSettings)

StorageTransferServiceClient.GetAgentPoolAsync(String, CancellationToken)

StorageTransferServiceClient.ListAgentPools(String, String, Nullable<Int32>, CallSettings)

StorageTransferServiceClient.ListAgentPoolsAsync(String, String, Nullable<Int32>, CallSettings)

StorageTransferServiceClient.DeleteAgentPoolAsync(DeleteAgentPoolRequest, CancellationToken)

StorageTransferServiceClient.DeleteAgentPool(String, CallSettings)

StorageTransferServiceClient.DeleteAgentPoolAsync(String, CallSettings)

StorageTransferServiceClient.DeleteAgentPoolAsync(String, CancellationToken)

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ToString()

Namespace

Google.Cloud.StorageTransfer.V1

Assembly

Google.Cloud.StorageTransfer.V1.dll

Remarks

Storage Transfer Service and its protos. Transfers data between between Google Cloud Storage buckets or from a data source external to Google to a Cloud Storage bucket.

Constructors

StorageTransferServiceClientImpl(StorageTransferService.StorageTransferServiceClient, StorageTransferServiceSettings, ILogger)

public StorageTransferServiceClientImpl(StorageTransferService.StorageTransferServiceClient grpcClient, StorageTransferServiceSettings settings, ILogger logger)

Constructs a client wrapper for the StorageTransferService service, with the specified gRPC client and settings.

Parameters
Name	Description
`grpcClient`	`StorageTransferService.StorageTransferServiceClient` The underlying gRPC client.
`settings`	`StorageTransferServiceSettings` The base StorageTransferServiceSettings used within this client.
`logger`	`ILogger` Optional ILogger to use within this client.

Properties

GrpcClient

public override StorageTransferService.StorageTransferServiceClient GrpcClient { get; }

The underlying gRPC StorageTransferService client

Property Value
Type	Description
`StorageTransferService.StorageTransferServiceClient`

Overrides

StorageTransferServiceClient.GrpcClient

RunTransferJobOperationsClient

public override OperationsClient RunTransferJobOperationsClient { get; }

The long-running operations client for RunTransferJob.

Property Value
Type	Description
`OperationsClient`

Overrides

StorageTransferServiceClient.RunTransferJobOperationsClient

Methods

CreateAgentPool(CreateAgentPoolRequest, CallSettings)

public override AgentPool CreateAgentPool(CreateAgentPoolRequest request, CallSettings callSettings = null)

Creates an agent pool resource.

Parameters
Name	Description
`request`	`CreateAgentPoolRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`AgentPool`	The RPC response.

Overrides

StorageTransferServiceClient.CreateAgentPool(CreateAgentPoolRequest, CallSettings)

CreateAgentPoolAsync(CreateAgentPoolRequest, CallSettings)

public override Task<AgentPool> CreateAgentPoolAsync(CreateAgentPoolRequest request, CallSettings callSettings = null)

Creates an agent pool resource.

Parameters
Name	Description
`request`	`CreateAgentPoolRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task<AgentPool>`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.CreateAgentPoolAsync(CreateAgentPoolRequest, CallSettings)

CreateTransferJob(CreateTransferJobRequest, CallSettings)

public override TransferJob CreateTransferJob(CreateTransferJobRequest request, CallSettings callSettings = null)

Creates a transfer job that runs periodically.

Parameters
Name	Description
`request`	`CreateTransferJobRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TransferJob`	The RPC response.

Overrides

StorageTransferServiceClient.CreateTransferJob(CreateTransferJobRequest, CallSettings)

CreateTransferJobAsync(CreateTransferJobRequest, CallSettings)

public override Task<TransferJob> CreateTransferJobAsync(CreateTransferJobRequest request, CallSettings callSettings = null)

Creates a transfer job that runs periodically.

Parameters
Name	Description
`request`	`CreateTransferJobRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task<TransferJob>`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.CreateTransferJobAsync(CreateTransferJobRequest, CallSettings)

DeleteAgentPool(DeleteAgentPoolRequest, CallSettings)

public override void DeleteAgentPool(DeleteAgentPoolRequest request, CallSettings callSettings = null)

Deletes an agent pool.

Parameters
Name	Description
`request`	`DeleteAgentPoolRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Overrides

StorageTransferServiceClient.DeleteAgentPool(DeleteAgentPoolRequest, CallSettings)

DeleteAgentPoolAsync(DeleteAgentPoolRequest, CallSettings)

public override Task DeleteAgentPoolAsync(DeleteAgentPoolRequest request, CallSettings callSettings = null)

Deletes an agent pool.

Parameters
Name	Description
`request`	`DeleteAgentPoolRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.DeleteAgentPoolAsync(DeleteAgentPoolRequest, CallSettings)

DeleteTransferJob(DeleteTransferJobRequest, CallSettings)

public override void DeleteTransferJob(DeleteTransferJobRequest request, CallSettings callSettings = null)

Deletes a transfer job. Deleting a transfer job sets its status to [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED].

Parameters
Name	Description
`request`	`DeleteTransferJobRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Overrides

StorageTransferServiceClient.DeleteTransferJob(DeleteTransferJobRequest, CallSettings)

DeleteTransferJobAsync(DeleteTransferJobRequest, CallSettings)

public override Task DeleteTransferJobAsync(DeleteTransferJobRequest request, CallSettings callSettings = null)

Deletes a transfer job. Deleting a transfer job sets its status to [DELETED][google.storagetransfer.v1.TransferJob.Status.DELETED].

Parameters
Name	Description
`request`	`DeleteTransferJobRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.DeleteTransferJobAsync(DeleteTransferJobRequest, CallSettings)

GetAgentPool(GetAgentPoolRequest, CallSettings)

public override AgentPool GetAgentPool(GetAgentPoolRequest request, CallSettings callSettings = null)

Gets an agent pool.

Parameters
Name	Description
`request`	`GetAgentPoolRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`AgentPool`	The RPC response.

Overrides

StorageTransferServiceClient.GetAgentPool(GetAgentPoolRequest, CallSettings)

GetAgentPoolAsync(GetAgentPoolRequest, CallSettings)

public override Task<AgentPool> GetAgentPoolAsync(GetAgentPoolRequest request, CallSettings callSettings = null)

Gets an agent pool.

Parameters
Name	Description
`request`	`GetAgentPoolRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task<AgentPool>`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.GetAgentPoolAsync(GetAgentPoolRequest, CallSettings)

GetGoogleServiceAccount(GetGoogleServiceAccountRequest, CallSettings)

public override GoogleServiceAccount GetGoogleServiceAccount(GetGoogleServiceAccountRequest request, CallSettings callSettings = null)

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 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
Name	Description
`request`	`GetGoogleServiceAccountRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`GoogleServiceAccount`	The RPC response.

Overrides

StorageTransferServiceClient.GetGoogleServiceAccount(GetGoogleServiceAccountRequest, CallSettings)

GetGoogleServiceAccountAsync(GetGoogleServiceAccountRequest, CallSettings)

public override Task<GoogleServiceAccount> GetGoogleServiceAccountAsync(GetGoogleServiceAccountRequest request, CallSettings callSettings = null)

Parameters
Name	Description
`request`	`GetGoogleServiceAccountRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task<GoogleServiceAccount>`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.GetGoogleServiceAccountAsync(GetGoogleServiceAccountRequest, CallSettings)

GetTransferJob(GetTransferJobRequest, CallSettings)

public override TransferJob GetTransferJob(GetTransferJobRequest request, CallSettings callSettings = null)

Gets a transfer job.

Parameters
Name	Description
`request`	`GetTransferJobRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TransferJob`	The RPC response.

Overrides

StorageTransferServiceClient.GetTransferJob(GetTransferJobRequest, CallSettings)

GetTransferJobAsync(GetTransferJobRequest, CallSettings)

public override Task<TransferJob> GetTransferJobAsync(GetTransferJobRequest request, CallSettings callSettings = null)

Gets a transfer job.

Parameters
Name	Description
`request`	`GetTransferJobRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task<TransferJob>`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.GetTransferJobAsync(GetTransferJobRequest, CallSettings)

ListAgentPools(ListAgentPoolsRequest, CallSettings)

public override PagedEnumerable<ListAgentPoolsResponse, AgentPool> ListAgentPools(ListAgentPoolsRequest request, CallSettings callSettings = null)

Lists agent pools.

Parameters
Name	Description
`request`	`ListAgentPoolsRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`PagedEnumerable<ListAgentPoolsResponse, AgentPool>`	A pageable sequence of AgentPool resources.

Overrides

StorageTransferServiceClient.ListAgentPools(ListAgentPoolsRequest, CallSettings)

ListAgentPoolsAsync(ListAgentPoolsRequest, CallSettings)

public override PagedAsyncEnumerable<ListAgentPoolsResponse, AgentPool> ListAgentPoolsAsync(ListAgentPoolsRequest request, CallSettings callSettings = null)

Lists agent pools.

Parameters
Name	Description
`request`	`ListAgentPoolsRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`PagedAsyncEnumerable<ListAgentPoolsResponse, AgentPool>`	A pageable asynchronous sequence of AgentPool resources.

Overrides

StorageTransferServiceClient.ListAgentPoolsAsync(ListAgentPoolsRequest, CallSettings)

ListTransferJobs(ListTransferJobsRequest, CallSettings)

public override PagedEnumerable<ListTransferJobsResponse, TransferJob> ListTransferJobs(ListTransferJobsRequest request, CallSettings callSettings = null)

Lists transfer jobs.

Parameters
Name	Description
`request`	`ListTransferJobsRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`PagedEnumerable<ListTransferJobsResponse, TransferJob>`	A pageable sequence of TransferJob resources.

Overrides

StorageTransferServiceClient.ListTransferJobs(ListTransferJobsRequest, CallSettings)

ListTransferJobsAsync(ListTransferJobsRequest, CallSettings)

public override PagedAsyncEnumerable<ListTransferJobsResponse, TransferJob> ListTransferJobsAsync(ListTransferJobsRequest request, CallSettings callSettings = null)

Lists transfer jobs.

Parameters
Name	Description
`request`	`ListTransferJobsRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`PagedAsyncEnumerable<ListTransferJobsResponse, TransferJob>`	A pageable asynchronous sequence of TransferJob resources.

Overrides

StorageTransferServiceClient.ListTransferJobsAsync(ListTransferJobsRequest, CallSettings)

PauseTransferOperation(PauseTransferOperationRequest, CallSettings)

public override void PauseTransferOperation(PauseTransferOperationRequest request, CallSettings callSettings = null)

Pauses a transfer operation.

Parameters
Name	Description
`request`	`PauseTransferOperationRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Overrides

StorageTransferServiceClient.PauseTransferOperation(PauseTransferOperationRequest, CallSettings)

PauseTransferOperationAsync(PauseTransferOperationRequest, CallSettings)

public override Task PauseTransferOperationAsync(PauseTransferOperationRequest request, CallSettings callSettings = null)

Pauses a transfer operation.

Parameters
Name	Description
`request`	`PauseTransferOperationRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.PauseTransferOperationAsync(PauseTransferOperationRequest, CallSettings)

ResumeTransferOperation(ResumeTransferOperationRequest, CallSettings)

public override void ResumeTransferOperation(ResumeTransferOperationRequest request, CallSettings callSettings = null)

Resumes a transfer operation that is paused.

Parameters
Name	Description
`request`	`ResumeTransferOperationRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Overrides

StorageTransferServiceClient.ResumeTransferOperation(ResumeTransferOperationRequest, CallSettings)

ResumeTransferOperationAsync(ResumeTransferOperationRequest, CallSettings)

public override Task ResumeTransferOperationAsync(ResumeTransferOperationRequest request, CallSettings callSettings = null)

Resumes a transfer operation that is paused.

Parameters
Name	Description
`request`	`ResumeTransferOperationRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.ResumeTransferOperationAsync(ResumeTransferOperationRequest, CallSettings)

RunTransferJob(RunTransferJobRequest, CallSettings)

public override Operation<Empty, TransferOperation> RunTransferJob(RunTransferJobRequest request, CallSettings callSettings = null)

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 will be returned.

Parameters
Name	Description
`request`	`RunTransferJobRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Operation<Empty, TransferOperation>`	The RPC response.

Overrides

StorageTransferServiceClient.RunTransferJob(RunTransferJobRequest, CallSettings)

RunTransferJobAsync(RunTransferJobRequest, CallSettings)

public override async Task<Operation<Empty, TransferOperation>> RunTransferJobAsync(RunTransferJobRequest request, CallSettings callSettings = null)

Parameters
Name	Description
`request`	`RunTransferJobRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task<Operation<Empty, TransferOperation>>`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.RunTransferJobAsync(RunTransferJobRequest, CallSettings)

UpdateAgentPool(UpdateAgentPoolRequest, CallSettings)

public override AgentPool UpdateAgentPool(UpdateAgentPoolRequest request, CallSettings callSettings = null)

Updates an existing agent pool resource.

Parameters
Name	Description
`request`	`UpdateAgentPoolRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`AgentPool`	The RPC response.

Overrides

StorageTransferServiceClient.UpdateAgentPool(UpdateAgentPoolRequest, CallSettings)

UpdateAgentPoolAsync(UpdateAgentPoolRequest, CallSettings)

public override Task<AgentPool> UpdateAgentPoolAsync(UpdateAgentPoolRequest request, CallSettings callSettings = null)

Updates an existing agent pool resource.

Parameters
Name	Description
`request`	`UpdateAgentPoolRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task<AgentPool>`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.UpdateAgentPoolAsync(UpdateAgentPoolRequest, CallSettings)

UpdateTransferJob(UpdateTransferJobRequest, CallSettings)

public override TransferJob UpdateTransferJob(UpdateTransferJobRequest request, CallSettings callSettings = null)

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
Name	Description
`request`	`UpdateTransferJobRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`TransferJob`	The RPC response.

Overrides

StorageTransferServiceClient.UpdateTransferJob(UpdateTransferJobRequest, CallSettings)

UpdateTransferJobAsync(UpdateTransferJobRequest, CallSettings)

public override Task<TransferJob> UpdateTransferJobAsync(UpdateTransferJobRequest request, CallSettings callSettings = null)

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

Parameters
Name	Description
`request`	`UpdateTransferJobRequest` The request object containing all of the parameters for the API call.
`callSettings`	`CallSettings` If not null, applies overrides to this RPC call.

Returns
Type	Description
`Task<TransferJob>`	A Task containing the RPC response.

Overrides

StorageTransferServiceClient.UpdateTransferJobAsync(UpdateTransferJobRequest, CallSettings)