Google BigQuery Data Transfer v1 API - Class DataTransferServiceClientImpl (4.4.0)

public sealed class DataTransferServiceClientImpl : DataTransferServiceClient

Reference documentation and code samples for the Google BigQuery Data Transfer v1 API class DataTransferServiceClientImpl.

DataTransferService client wrapper implementation, for convenient use.

Inheritance

object > DataTransferServiceClient > DataTransferServiceClientImpl

Namespace

Google.Cloud.BigQuery.DataTransfer.V1

Assembly

Google.Cloud.BigQuery.DataTransfer.V1.dll

Remarks

This API allows users to manage their data transfers into BigQuery.

Constructors

DataTransferServiceClientImpl(DataTransferServiceClient, DataTransferServiceSettings, ILogger)

public DataTransferServiceClientImpl(DataTransferService.DataTransferServiceClient grpcClient, DataTransferServiceSettings settings, ILogger logger)

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

Parameters
NameDescription
grpcClientDataTransferServiceDataTransferServiceClient

The underlying gRPC client.

settingsDataTransferServiceSettings

The base DataTransferServiceSettings used within this client.

loggerILogger

Optional ILogger to use within this client.

Properties

GrpcClient

public override DataTransferService.DataTransferServiceClient GrpcClient { get; }

The underlying gRPC DataTransferService client

Property Value
TypeDescription
DataTransferServiceDataTransferServiceClient
Overrides

LocationsClient

public override LocationsClient LocationsClient { get; }

The LocationsClient associated with this client.

Property Value
TypeDescription
LocationsClient
Overrides

Methods

CheckValidCreds(CheckValidCredsRequest, CallSettings)

public override CheckValidCredsResponse CheckValidCreds(CheckValidCredsRequest request, CallSettings callSettings = null)

Returns true if valid credentials exist for the given data source and requesting user.

Parameters
NameDescription
requestCheckValidCredsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
CheckValidCredsResponse

The RPC response.

Overrides

CheckValidCredsAsync(CheckValidCredsRequest, CallSettings)

public override Task<CheckValidCredsResponse> CheckValidCredsAsync(CheckValidCredsRequest request, CallSettings callSettings = null)

Returns true if valid credentials exist for the given data source and requesting user.

Parameters
NameDescription
requestCheckValidCredsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskCheckValidCredsResponse

A Task containing the RPC response.

Overrides

CreateTransferConfig(CreateTransferConfigRequest, CallSettings)

public override TransferConfig CreateTransferConfig(CreateTransferConfigRequest request, CallSettings callSettings = null)

Creates a new data transfer configuration.

Parameters
NameDescription
requestCreateTransferConfigRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TransferConfig

The RPC response.

Overrides

CreateTransferConfigAsync(CreateTransferConfigRequest, CallSettings)

public override Task<TransferConfig> CreateTransferConfigAsync(CreateTransferConfigRequest request, CallSettings callSettings = null)

Creates a new data transfer configuration.

Parameters
NameDescription
requestCreateTransferConfigRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTransferConfig

A Task containing the RPC response.

Overrides

DeleteTransferConfig(DeleteTransferConfigRequest, CallSettings)

public override void DeleteTransferConfig(DeleteTransferConfigRequest request, CallSettings callSettings = null)

Deletes a data transfer configuration, including any associated transfer runs and logs.

Parameters
NameDescription
requestDeleteTransferConfigRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Overrides

DeleteTransferConfigAsync(DeleteTransferConfigRequest, CallSettings)

public override Task DeleteTransferConfigAsync(DeleteTransferConfigRequest request, CallSettings callSettings = null)

Deletes a data transfer configuration, including any associated transfer runs and logs.

Parameters
NameDescription
requestDeleteTransferConfigRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Task

A Task containing the RPC response.

Overrides

DeleteTransferRun(DeleteTransferRunRequest, CallSettings)

public override void DeleteTransferRun(DeleteTransferRunRequest request, CallSettings callSettings = null)

Deletes the specified transfer run.

Parameters
NameDescription
requestDeleteTransferRunRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Overrides

DeleteTransferRunAsync(DeleteTransferRunRequest, CallSettings)

public override Task DeleteTransferRunAsync(DeleteTransferRunRequest request, CallSettings callSettings = null)

Deletes the specified transfer run.

Parameters
NameDescription
requestDeleteTransferRunRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Task

A Task containing the RPC response.

Overrides

EnrollDataSources(EnrollDataSourcesRequest, CallSettings)

public override void EnrollDataSources(EnrollDataSourcesRequest request, CallSettings callSettings = null)

Enroll data sources in a user project. This allows users to create transfer configurations for these data sources. They will also appear in the ListDataSources RPC and as such, will appear in the BigQuery UI, and the documents can be found in the public guide for BigQuery Web UI and Data Transfer Service.

Parameters
NameDescription
requestEnrollDataSourcesRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Overrides

EnrollDataSourcesAsync(EnrollDataSourcesRequest, CallSettings)

public override Task EnrollDataSourcesAsync(EnrollDataSourcesRequest request, CallSettings callSettings = null)

Enroll data sources in a user project. This allows users to create transfer configurations for these data sources. They will also appear in the ListDataSources RPC and as such, will appear in the BigQuery UI, and the documents can be found in the public guide for BigQuery Web UI and Data Transfer Service.

Parameters
NameDescription
requestEnrollDataSourcesRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Task

A Task containing the RPC response.

Overrides

GetDataSource(GetDataSourceRequest, CallSettings)

public override DataSource GetDataSource(GetDataSourceRequest request, CallSettings callSettings = null)

Retrieves a supported data source and returns its settings.

Parameters
NameDescription
requestGetDataSourceRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
DataSource

The RPC response.

Overrides

GetDataSourceAsync(GetDataSourceRequest, CallSettings)

public override Task<DataSource> GetDataSourceAsync(GetDataSourceRequest request, CallSettings callSettings = null)

Retrieves a supported data source and returns its settings.

Parameters
NameDescription
requestGetDataSourceRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskDataSource

A Task containing the RPC response.

Overrides

GetTransferConfig(GetTransferConfigRequest, CallSettings)

public override TransferConfig GetTransferConfig(GetTransferConfigRequest request, CallSettings callSettings = null)

Returns information about a data transfer config.

Parameters
NameDescription
requestGetTransferConfigRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TransferConfig

The RPC response.

Overrides

GetTransferConfigAsync(GetTransferConfigRequest, CallSettings)

public override Task<TransferConfig> GetTransferConfigAsync(GetTransferConfigRequest request, CallSettings callSettings = null)

Returns information about a data transfer config.

Parameters
NameDescription
requestGetTransferConfigRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTransferConfig

A Task containing the RPC response.

Overrides

GetTransferRun(GetTransferRunRequest, CallSettings)

public override TransferRun GetTransferRun(GetTransferRunRequest request, CallSettings callSettings = null)

Returns information about the particular transfer run.

Parameters
NameDescription
requestGetTransferRunRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TransferRun

The RPC response.

Overrides

GetTransferRunAsync(GetTransferRunRequest, CallSettings)

public override Task<TransferRun> GetTransferRunAsync(GetTransferRunRequest request, CallSettings callSettings = null)

Returns information about the particular transfer run.

Parameters
NameDescription
requestGetTransferRunRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTransferRun

A Task containing the RPC response.

Overrides

ListDataSources(ListDataSourcesRequest, CallSettings)

public override PagedEnumerable<ListDataSourcesResponse, DataSource> ListDataSources(ListDataSourcesRequest request, CallSettings callSettings = null)

Lists supported data sources and returns their settings.

Parameters
NameDescription
requestListDataSourcesRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListDataSourcesResponseDataSource

A pageable sequence of DataSource resources.

Overrides

ListDataSourcesAsync(ListDataSourcesRequest, CallSettings)

public override PagedAsyncEnumerable<ListDataSourcesResponse, DataSource> ListDataSourcesAsync(ListDataSourcesRequest request, CallSettings callSettings = null)

Lists supported data sources and returns their settings.

Parameters
NameDescription
requestListDataSourcesRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListDataSourcesResponseDataSource

A pageable asynchronous sequence of DataSource resources.

Overrides

ListTransferConfigs(ListTransferConfigsRequest, CallSettings)

public override PagedEnumerable<ListTransferConfigsResponse, TransferConfig> ListTransferConfigs(ListTransferConfigsRequest request, CallSettings callSettings = null)

Returns information about all transfer configs owned by a project in the specified location.

Parameters
NameDescription
requestListTransferConfigsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListTransferConfigsResponseTransferConfig

A pageable sequence of TransferConfig resources.

Overrides

ListTransferConfigsAsync(ListTransferConfigsRequest, CallSettings)

public override PagedAsyncEnumerable<ListTransferConfigsResponse, TransferConfig> ListTransferConfigsAsync(ListTransferConfigsRequest request, CallSettings callSettings = null)

Returns information about all transfer configs owned by a project in the specified location.

Parameters
NameDescription
requestListTransferConfigsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListTransferConfigsResponseTransferConfig

A pageable asynchronous sequence of TransferConfig resources.

Overrides

ListTransferLogs(ListTransferLogsRequest, CallSettings)

public override PagedEnumerable<ListTransferLogsResponse, TransferMessage> ListTransferLogs(ListTransferLogsRequest request, CallSettings callSettings = null)

Returns log messages for the transfer run.

Parameters
NameDescription
requestListTransferLogsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListTransferLogsResponseTransferMessage

A pageable sequence of TransferMessage resources.

Overrides

ListTransferLogsAsync(ListTransferLogsRequest, CallSettings)

public override PagedAsyncEnumerable<ListTransferLogsResponse, TransferMessage> ListTransferLogsAsync(ListTransferLogsRequest request, CallSettings callSettings = null)

Returns log messages for the transfer run.

Parameters
NameDescription
requestListTransferLogsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListTransferLogsResponseTransferMessage

A pageable asynchronous sequence of TransferMessage resources.

Overrides

ListTransferRuns(ListTransferRunsRequest, CallSettings)

public override PagedEnumerable<ListTransferRunsResponse, TransferRun> ListTransferRuns(ListTransferRunsRequest request, CallSettings callSettings = null)

Returns information about running and completed transfer runs.

Parameters
NameDescription
requestListTransferRunsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListTransferRunsResponseTransferRun

A pageable sequence of TransferRun resources.

Overrides

ListTransferRunsAsync(ListTransferRunsRequest, CallSettings)

public override PagedAsyncEnumerable<ListTransferRunsResponse, TransferRun> ListTransferRunsAsync(ListTransferRunsRequest request, CallSettings callSettings = null)

Returns information about running and completed transfer runs.

Parameters
NameDescription
requestListTransferRunsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListTransferRunsResponseTransferRun

A pageable asynchronous sequence of TransferRun resources.

Overrides

ScheduleTransferRuns(ScheduleTransferRunsRequest, CallSettings)

[Obsolete]
public override ScheduleTransferRunsResponse ScheduleTransferRuns(ScheduleTransferRunsRequest request, CallSettings callSettings = null)

Creates transfer runs for a time range [start_time, end_time]. For each date - or whatever granularity the data source supports - in the range, one transfer run is created. Note that runs are created per UTC time in the time range. DEPRECATED: use StartManualTransferRuns instead.

Parameters
NameDescription
requestScheduleTransferRunsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
ScheduleTransferRunsResponse

The RPC response.

Overrides

ScheduleTransferRunsAsync(ScheduleTransferRunsRequest, CallSettings)

[Obsolete]
public override Task<ScheduleTransferRunsResponse> ScheduleTransferRunsAsync(ScheduleTransferRunsRequest request, CallSettings callSettings = null)

Creates transfer runs for a time range [start_time, end_time]. For each date - or whatever granularity the data source supports - in the range, one transfer run is created. Note that runs are created per UTC time in the time range. DEPRECATED: use StartManualTransferRuns instead.

Parameters
NameDescription
requestScheduleTransferRunsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskScheduleTransferRunsResponse

A Task containing the RPC response.

Overrides

StartManualTransferRuns(StartManualTransferRunsRequest, CallSettings)

public override StartManualTransferRunsResponse StartManualTransferRuns(StartManualTransferRunsRequest request, CallSettings callSettings = null)

Start manual transfer runs to be executed now with schedule_time equal to current time. The transfer runs can be created for a time range where the run_time is between start_time (inclusive) and end_time (exclusive), or for a specific run_time.

Parameters
NameDescription
requestStartManualTransferRunsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
StartManualTransferRunsResponse

The RPC response.

Overrides

StartManualTransferRunsAsync(StartManualTransferRunsRequest, CallSettings)

public override Task<StartManualTransferRunsResponse> StartManualTransferRunsAsync(StartManualTransferRunsRequest request, CallSettings callSettings = null)

Start manual transfer runs to be executed now with schedule_time equal to current time. The transfer runs can be created for a time range where the run_time is between start_time (inclusive) and end_time (exclusive), or for a specific run_time.

Parameters
NameDescription
requestStartManualTransferRunsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskStartManualTransferRunsResponse

A Task containing the RPC response.

Overrides

UpdateTransferConfig(UpdateTransferConfigRequest, CallSettings)

public override TransferConfig UpdateTransferConfig(UpdateTransferConfigRequest request, CallSettings callSettings = null)

Updates a data transfer configuration. All fields must be set, even if they are not updated.

Parameters
NameDescription
requestUpdateTransferConfigRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TransferConfig

The RPC response.

Overrides

UpdateTransferConfigAsync(UpdateTransferConfigRequest, CallSettings)

public override Task<TransferConfig> UpdateTransferConfigAsync(UpdateTransferConfigRequest request, CallSettings callSettings = null)

Updates a data transfer configuration. All fields must be set, even if they are not updated.

Parameters
NameDescription
requestUpdateTransferConfigRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskTransferConfig

A Task containing the RPC response.

Overrides