- 2.48.0 (latest)
- 2.47.0
- 2.46.0
- 2.45.0
- 2.44.0
- 2.43.0
- 2.42.0
- 2.41.0
- 2.40.0
- 2.39.0
- 2.37.0
- 2.36.0
- 2.35.0
- 2.34.0
- 2.33.0
- 2.32.0
- 2.31.0
- 2.30.0
- 2.29.0
- 2.28.0
- 2.27.0
- 2.24.0
- 2.23.0
- 2.22.0
- 2.21.0
- 2.20.0
- 2.19.0
- 2.18.0
- 2.17.0
- 2.16.0
- 2.15.0
- 2.14.0
- 2.13.0
- 2.12.0
- 2.11.0
- 2.10.0
- 2.9.0
- 2.8.0
- 2.7.0
- 2.6.0
- 2.5.0
- 2.4.0
- 2.3.17
- 2.2.6
- 2.1.23
- 2.0.27
public class DataTransferServiceClient implements BackgroundResource
Service Description: This API allows users to manage their data transfers into BigQuery.
This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
DataSourceName name =
DataSourceName.ofProjectLocationDataSourceName(
"[PROJECT]", "[LOCATION]", "[DATA_SOURCE]");
DataSource response = dataTransferServiceClient.getDataSource(name);
}
Note: close() needs to be called on the DataTransferServiceClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().
The surface of this class includes several types of Java methods for each of the API's methods:
- A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
- A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
- A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.
See the individual methods for example code.
Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.
This class can be customized by passing in a custom instance of DataTransferServiceSettings to create(). For example:
To customize credentials:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
DataTransferServiceSettings dataTransferServiceSettings =
DataTransferServiceSettings.newBuilder()
.setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
.build();
DataTransferServiceClient dataTransferServiceClient =
DataTransferServiceClient.create(dataTransferServiceSettings);
To customize the endpoint:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
DataTransferServiceSettings dataTransferServiceSettings =
DataTransferServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
DataTransferServiceClient dataTransferServiceClient =
DataTransferServiceClient.create(dataTransferServiceSettings);
Please refer to the GitHub repository's samples for more quickstart code snippets.
Implements
BackgroundResourceStatic Methods
create()
public static final DataTransferServiceClient create()
Constructs an instance of DataTransferServiceClient with default settings.
Type | Description |
DataTransferServiceClient |
Type | Description |
IOException |
create(DataTransferServiceSettings settings)
public static final DataTransferServiceClient create(DataTransferServiceSettings settings)
Constructs an instance of DataTransferServiceClient, using the given settings. The channels are created based on the settings passed in, or defaults for any settings that are not set.
Name | Description |
settings | DataTransferServiceSettings |
Type | Description |
DataTransferServiceClient |
Type | Description |
IOException |
create(DataTransferServiceStub stub)
public static final DataTransferServiceClient create(DataTransferServiceStub stub)
Constructs an instance of DataTransferServiceClient, using the given stub for making calls. This is for advanced usage - prefer using create(DataTransferServiceSettings).
Name | Description |
stub | DataTransferServiceStub |
Type | Description |
DataTransferServiceClient |
Constructors
DataTransferServiceClient(DataTransferServiceSettings settings)
protected DataTransferServiceClient(DataTransferServiceSettings settings)
Constructs an instance of DataTransferServiceClient, using the given settings. This is protected so that it is easy to make a subclass, but otherwise, the static factory methods should be preferred.
Name | Description |
settings | DataTransferServiceSettings |
DataTransferServiceClient(DataTransferServiceStub stub)
protected DataTransferServiceClient(DataTransferServiceStub stub)
Name | Description |
stub | DataTransferServiceStub |
Methods
awaitTermination(long duration, TimeUnit unit)
public boolean awaitTermination(long duration, TimeUnit unit)
Name | Description |
duration | long |
unit | TimeUnit |
Type | Description |
boolean |
Type | Description |
InterruptedException |
checkValidCreds(CheckValidCredsRequest request)
public final CheckValidCredsResponse checkValidCreds(CheckValidCredsRequest request)
Returns true if valid credentials exist for the given data source and requesting user.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
CheckValidCredsRequest request =
CheckValidCredsRequest.newBuilder()
.setName(
DataSourceName.ofProjectLocationDataSourceName(
"[PROJECT]", "[LOCATION]", "[DATA_SOURCE]")
.toString())
.build();
CheckValidCredsResponse response = dataTransferServiceClient.checkValidCreds(request);
}
Name | Description |
request | CheckValidCredsRequest The request object containing all of the parameters for the API call. |
Type | Description |
CheckValidCredsResponse |
checkValidCreds(DataSourceName name)
public final CheckValidCredsResponse checkValidCreds(DataSourceName name)
Returns true if valid credentials exist for the given data source and requesting user.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
DataSourceName name =
DataSourceName.ofProjectLocationDataSourceName(
"[PROJECT]", "[LOCATION]", "[DATA_SOURCE]");
CheckValidCredsResponse response = dataTransferServiceClient.checkValidCreds(name);
}
Name | Description |
name | DataSourceName Required. The data source in the form:
|
Type | Description |
CheckValidCredsResponse |
checkValidCreds(String name)
public final CheckValidCredsResponse checkValidCreds(String name)
Returns true if valid credentials exist for the given data source and requesting user.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String name = DataSourceName.ofProjectDataSourceName("[PROJECT]", "[DATA_SOURCE]").toString();
CheckValidCredsResponse response = dataTransferServiceClient.checkValidCreds(name);
}
Name | Description |
name | String Required. The data source in the form:
|
Type | Description |
CheckValidCredsResponse |
checkValidCredsCallable()
public final UnaryCallable<CheckValidCredsRequest,CheckValidCredsResponse> checkValidCredsCallable()
Returns true if valid credentials exist for the given data source and requesting user.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
CheckValidCredsRequest request =
CheckValidCredsRequest.newBuilder()
.setName(
DataSourceName.ofProjectLocationDataSourceName(
"[PROJECT]", "[LOCATION]", "[DATA_SOURCE]")
.toString())
.build();
ApiFuture<CheckValidCredsResponse> future =
dataTransferServiceClient.checkValidCredsCallable().futureCall(request);
// Do something.
CheckValidCredsResponse response = future.get();
}
Type | Description |
UnaryCallable<CheckValidCredsRequest,CheckValidCredsResponse> |
close()
public final void close()
createTransferConfig(CreateTransferConfigRequest request)
public final TransferConfig createTransferConfig(CreateTransferConfigRequest request)
Creates a new data transfer configuration.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
CreateTransferConfigRequest request =
CreateTransferConfigRequest.newBuilder()
.setParent(ProjectName.of("[PROJECT]").toString())
.setTransferConfig(TransferConfig.newBuilder().build())
.setAuthorizationCode("authorizationCode742596102")
.setVersionInfo("versionInfo688769446")
.setServiceAccountName("serviceAccountName2137368675")
.build();
TransferConfig response = dataTransferServiceClient.createTransferConfig(request);
}
Name | Description |
request | CreateTransferConfigRequest The request object containing all of the parameters for the API call. |
Type | Description |
TransferConfig |
createTransferConfig(LocationName parent, TransferConfig transferConfig)
public final TransferConfig createTransferConfig(LocationName parent, TransferConfig transferConfig)
Creates a new data transfer configuration.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
TransferConfig transferConfig = TransferConfig.newBuilder().build();
TransferConfig response =
dataTransferServiceClient.createTransferConfig(parent, transferConfig);
}
Name | Description |
parent | LocationName Required. The BigQuery project id where the transfer configuration should be created. Must be in the format projects/{project_id}/locations/{location_id} or projects/{project_id}. If specified location and location of the destination bigquery dataset do not match - the request will fail. |
transferConfig | TransferConfig Required. Data transfer configuration to create. |
Type | Description |
TransferConfig |
createTransferConfig(ProjectName parent, TransferConfig transferConfig)
public final TransferConfig createTransferConfig(ProjectName parent, TransferConfig transferConfig)
Creates a new data transfer configuration.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ProjectName parent = ProjectName.of("[PROJECT]");
TransferConfig transferConfig = TransferConfig.newBuilder().build();
TransferConfig response =
dataTransferServiceClient.createTransferConfig(parent, transferConfig);
}
Name | Description |
parent | ProjectName Required. The BigQuery project id where the transfer configuration should be created. Must be in the format projects/{project_id}/locations/{location_id} or projects/{project_id}. If specified location and location of the destination bigquery dataset do not match - the request will fail. |
transferConfig | TransferConfig Required. Data transfer configuration to create. |
Type | Description |
TransferConfig |
createTransferConfig(String parent, TransferConfig transferConfig)
public final TransferConfig createTransferConfig(String parent, TransferConfig transferConfig)
Creates a new data transfer configuration.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String parent = ProjectName.of("[PROJECT]").toString();
TransferConfig transferConfig = TransferConfig.newBuilder().build();
TransferConfig response =
dataTransferServiceClient.createTransferConfig(parent, transferConfig);
}
Name | Description |
parent | String Required. The BigQuery project id where the transfer configuration should be created. Must be in the format projects/{project_id}/locations/{location_id} or projects/{project_id}. If specified location and location of the destination bigquery dataset do not match - the request will fail. |
transferConfig | TransferConfig Required. Data transfer configuration to create. |
Type | Description |
TransferConfig |
createTransferConfigCallable()
public final UnaryCallable<CreateTransferConfigRequest,TransferConfig> createTransferConfigCallable()
Creates a new data transfer configuration.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
CreateTransferConfigRequest request =
CreateTransferConfigRequest.newBuilder()
.setParent(ProjectName.of("[PROJECT]").toString())
.setTransferConfig(TransferConfig.newBuilder().build())
.setAuthorizationCode("authorizationCode742596102")
.setVersionInfo("versionInfo688769446")
.setServiceAccountName("serviceAccountName2137368675")
.build();
ApiFuture<TransferConfig> future =
dataTransferServiceClient.createTransferConfigCallable().futureCall(request);
// Do something.
TransferConfig response = future.get();
}
Type | Description |
UnaryCallable<CreateTransferConfigRequest,TransferConfig> |
deleteTransferConfig(DeleteTransferConfigRequest request)
public final void deleteTransferConfig(DeleteTransferConfigRequest request)
Deletes a data transfer configuration, including any associated transfer runs and logs.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
DeleteTransferConfigRequest request =
DeleteTransferConfigRequest.newBuilder()
.setName(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.build();
dataTransferServiceClient.deleteTransferConfig(request);
}
Name | Description |
request | DeleteTransferConfigRequest The request object containing all of the parameters for the API call. |
deleteTransferConfig(TransferConfigName name)
public final void deleteTransferConfig(TransferConfigName name)
Deletes a data transfer configuration, including any associated transfer runs and logs.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
TransferConfigName name =
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]");
dataTransferServiceClient.deleteTransferConfig(name);
}
Name | Description |
name | TransferConfigName Required. The field will contain name of the resource requested, for example:
|
deleteTransferConfig(String name)
public final void deleteTransferConfig(String name)
Deletes a data transfer configuration, including any associated transfer runs and logs.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String name =
TransferConfigName.ofProjectTransferConfigName("[PROJECT]", "[TRANSFER_CONFIG]")
.toString();
dataTransferServiceClient.deleteTransferConfig(name);
}
Name | Description |
name | String Required. The field will contain name of the resource requested, for example:
|
deleteTransferConfigCallable()
public final UnaryCallable<DeleteTransferConfigRequest,Empty> deleteTransferConfigCallable()
Deletes a data transfer configuration, including any associated transfer runs and logs.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
DeleteTransferConfigRequest request =
DeleteTransferConfigRequest.newBuilder()
.setName(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.build();
ApiFuture<Empty> future =
dataTransferServiceClient.deleteTransferConfigCallable().futureCall(request);
// Do something.
future.get();
}
Type | Description |
UnaryCallable<DeleteTransferConfigRequest,Empty> |
deleteTransferRun(DeleteTransferRunRequest request)
public final void deleteTransferRun(DeleteTransferRunRequest request)
Deletes the specified transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
DeleteTransferRunRequest request =
DeleteTransferRunRequest.newBuilder()
.setName(
RunName.ofProjectLocationTransferConfigRunName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]", "[RUN]")
.toString())
.build();
dataTransferServiceClient.deleteTransferRun(request);
}
Name | Description |
request | DeleteTransferRunRequest The request object containing all of the parameters for the API call. |
deleteTransferRun(RunName name)
public final void deleteTransferRun(RunName name)
Deletes the specified transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
RunName name =
RunName.ofProjectLocationTransferConfigRunName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]", "[RUN]");
dataTransferServiceClient.deleteTransferRun(name);
}
Name | Description |
name | RunName Required. The field will contain name of the resource requested, for example:
|
deleteTransferRun(String name)
public final void deleteTransferRun(String name)
Deletes the specified transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String name =
RunName.ofProjectTransferConfigRunName("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
.toString();
dataTransferServiceClient.deleteTransferRun(name);
}
Name | Description |
name | String Required. The field will contain name of the resource requested, for example:
|
deleteTransferRunCallable()
public final UnaryCallable<DeleteTransferRunRequest,Empty> deleteTransferRunCallable()
Deletes the specified transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
DeleteTransferRunRequest request =
DeleteTransferRunRequest.newBuilder()
.setName(
RunName.ofProjectLocationTransferConfigRunName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]", "[RUN]")
.toString())
.build();
ApiFuture<Empty> future =
dataTransferServiceClient.deleteTransferRunCallable().futureCall(request);
// Do something.
future.get();
}
Type | Description |
UnaryCallable<DeleteTransferRunRequest,Empty> |
enrollDataSources(EnrollDataSourcesRequest request)
public final void enrollDataSources(EnrollDataSourcesRequest request)
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 'https://bigquery.cloud.google.com' (and the documents can be found at https://cloud.google.com/bigquery/bigquery-web-ui and https://cloud.google.com/bigquery/docs/working-with-transfers).
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
EnrollDataSourcesRequest request =
EnrollDataSourcesRequest.newBuilder()
.setName("name3373707")
.addAllDataSourceIds(new ArrayList<String>())
.build();
dataTransferServiceClient.enrollDataSources(request);
}
Name | Description |
request | EnrollDataSourcesRequest The request object containing all of the parameters for the API call. |
enrollDataSourcesCallable()
public final UnaryCallable<EnrollDataSourcesRequest,Empty> enrollDataSourcesCallable()
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 'https://bigquery.cloud.google.com' (and the documents can be found at https://cloud.google.com/bigquery/bigquery-web-ui and https://cloud.google.com/bigquery/docs/working-with-transfers).
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
EnrollDataSourcesRequest request =
EnrollDataSourcesRequest.newBuilder()
.setName("name3373707")
.addAllDataSourceIds(new ArrayList<String>())
.build();
ApiFuture<Empty> future =
dataTransferServiceClient.enrollDataSourcesCallable().futureCall(request);
// Do something.
future.get();
}
Type | Description |
UnaryCallable<EnrollDataSourcesRequest,Empty> |
getDataSource(DataSourceName name)
public final DataSource getDataSource(DataSourceName name)
Retrieves a supported data source and returns its settings.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
DataSourceName name =
DataSourceName.ofProjectLocationDataSourceName(
"[PROJECT]", "[LOCATION]", "[DATA_SOURCE]");
DataSource response = dataTransferServiceClient.getDataSource(name);
}
Name | Description |
name | DataSourceName Required. The field will contain name of the resource requested, for example:
|
Type | Description |
DataSource |
getDataSource(GetDataSourceRequest request)
public final DataSource getDataSource(GetDataSourceRequest request)
Retrieves a supported data source and returns its settings.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
GetDataSourceRequest request =
GetDataSourceRequest.newBuilder()
.setName(
DataSourceName.ofProjectLocationDataSourceName(
"[PROJECT]", "[LOCATION]", "[DATA_SOURCE]")
.toString())
.build();
DataSource response = dataTransferServiceClient.getDataSource(request);
}
Name | Description |
request | GetDataSourceRequest The request object containing all of the parameters for the API call. |
Type | Description |
DataSource |
getDataSource(String name)
public final DataSource getDataSource(String name)
Retrieves a supported data source and returns its settings.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String name = DataSourceName.ofProjectDataSourceName("[PROJECT]", "[DATA_SOURCE]").toString();
DataSource response = dataTransferServiceClient.getDataSource(name);
}
Name | Description |
name | String Required. The field will contain name of the resource requested, for example:
|
Type | Description |
DataSource |
getDataSourceCallable()
public final UnaryCallable<GetDataSourceRequest,DataSource> getDataSourceCallable()
Retrieves a supported data source and returns its settings.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
GetDataSourceRequest request =
GetDataSourceRequest.newBuilder()
.setName(
DataSourceName.ofProjectLocationDataSourceName(
"[PROJECT]", "[LOCATION]", "[DATA_SOURCE]")
.toString())
.build();
ApiFuture<DataSource> future =
dataTransferServiceClient.getDataSourceCallable().futureCall(request);
// Do something.
DataSource response = future.get();
}
Type | Description |
UnaryCallable<GetDataSourceRequest,DataSource> |
getSettings()
public final DataTransferServiceSettings getSettings()
Type | Description |
DataTransferServiceSettings |
getStub()
public DataTransferServiceStub getStub()
Type | Description |
DataTransferServiceStub |
getTransferConfig(GetTransferConfigRequest request)
public final TransferConfig getTransferConfig(GetTransferConfigRequest request)
Returns information about a data transfer config.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
GetTransferConfigRequest request =
GetTransferConfigRequest.newBuilder()
.setName(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.build();
TransferConfig response = dataTransferServiceClient.getTransferConfig(request);
}
Name | Description |
request | GetTransferConfigRequest The request object containing all of the parameters for the API call. |
Type | Description |
TransferConfig |
getTransferConfig(TransferConfigName name)
public final TransferConfig getTransferConfig(TransferConfigName name)
Returns information about a data transfer config.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
TransferConfigName name =
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]");
TransferConfig response = dataTransferServiceClient.getTransferConfig(name);
}
Name | Description |
name | TransferConfigName Required. The field will contain name of the resource requested, for example:
|
Type | Description |
TransferConfig |
getTransferConfig(String name)
public final TransferConfig getTransferConfig(String name)
Returns information about a data transfer config.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String name =
TransferConfigName.ofProjectTransferConfigName("[PROJECT]", "[TRANSFER_CONFIG]")
.toString();
TransferConfig response = dataTransferServiceClient.getTransferConfig(name);
}
Name | Description |
name | String Required. The field will contain name of the resource requested, for example:
|
Type | Description |
TransferConfig |
getTransferConfigCallable()
public final UnaryCallable<GetTransferConfigRequest,TransferConfig> getTransferConfigCallable()
Returns information about a data transfer config.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
GetTransferConfigRequest request =
GetTransferConfigRequest.newBuilder()
.setName(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.build();
ApiFuture<TransferConfig> future =
dataTransferServiceClient.getTransferConfigCallable().futureCall(request);
// Do something.
TransferConfig response = future.get();
}
Type | Description |
UnaryCallable<GetTransferConfigRequest,TransferConfig> |
getTransferRun(GetTransferRunRequest request)
public final TransferRun getTransferRun(GetTransferRunRequest request)
Returns information about the particular transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
GetTransferRunRequest request =
GetTransferRunRequest.newBuilder()
.setName(
RunName.ofProjectLocationTransferConfigRunName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]", "[RUN]")
.toString())
.build();
TransferRun response = dataTransferServiceClient.getTransferRun(request);
}
Name | Description |
request | GetTransferRunRequest The request object containing all of the parameters for the API call. |
Type | Description |
TransferRun |
getTransferRun(RunName name)
public final TransferRun getTransferRun(RunName name)
Returns information about the particular transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
RunName name =
RunName.ofProjectLocationTransferConfigRunName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]", "[RUN]");
TransferRun response = dataTransferServiceClient.getTransferRun(name);
}
Name | Description |
name | RunName Required. The field will contain name of the resource requested, for example:
|
Type | Description |
TransferRun |
getTransferRun(String name)
public final TransferRun getTransferRun(String name)
Returns information about the particular transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String name =
RunName.ofProjectTransferConfigRunName("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
.toString();
TransferRun response = dataTransferServiceClient.getTransferRun(name);
}
Name | Description |
name | String Required. The field will contain name of the resource requested, for example:
|
Type | Description |
TransferRun |
getTransferRunCallable()
public final UnaryCallable<GetTransferRunRequest,TransferRun> getTransferRunCallable()
Returns information about the particular transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
GetTransferRunRequest request =
GetTransferRunRequest.newBuilder()
.setName(
RunName.ofProjectLocationTransferConfigRunName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]", "[RUN]")
.toString())
.build();
ApiFuture<TransferRun> future =
dataTransferServiceClient.getTransferRunCallable().futureCall(request);
// Do something.
TransferRun response = future.get();
}
Type | Description |
UnaryCallable<GetTransferRunRequest,TransferRun> |
isShutdown()
public boolean isShutdown()
Type | Description |
boolean |
isTerminated()
public boolean isTerminated()
Type | Description |
boolean |
listDataSources(ListDataSourcesRequest request)
public final DataTransferServiceClient.ListDataSourcesPagedResponse listDataSources(ListDataSourcesRequest request)
Lists supported data sources and returns their settings.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListDataSourcesRequest request =
ListDataSourcesRequest.newBuilder()
.setParent(ProjectName.of("[PROJECT]").toString())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.build();
for (DataSource element : dataTransferServiceClient.listDataSources(request).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
request | ListDataSourcesRequest The request object containing all of the parameters for the API call. |
Type | Description |
DataTransferServiceClient.ListDataSourcesPagedResponse |
listDataSources(LocationName parent)
public final DataTransferServiceClient.ListDataSourcesPagedResponse listDataSources(LocationName parent)
Lists supported data sources and returns their settings.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
for (DataSource element : dataTransferServiceClient.listDataSources(parent).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
parent | LocationName Required. The BigQuery project id for which data sources should be returned. Must
be in the form: |
Type | Description |
DataTransferServiceClient.ListDataSourcesPagedResponse |
listDataSources(ProjectName parent)
public final DataTransferServiceClient.ListDataSourcesPagedResponse listDataSources(ProjectName parent)
Lists supported data sources and returns their settings.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ProjectName parent = ProjectName.of("[PROJECT]");
for (DataSource element : dataTransferServiceClient.listDataSources(parent).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
parent | ProjectName Required. The BigQuery project id for which data sources should be returned. Must
be in the form: |
Type | Description |
DataTransferServiceClient.ListDataSourcesPagedResponse |
listDataSources(String parent)
public final DataTransferServiceClient.ListDataSourcesPagedResponse listDataSources(String parent)
Lists supported data sources and returns their settings.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String parent = ProjectName.of("[PROJECT]").toString();
for (DataSource element : dataTransferServiceClient.listDataSources(parent).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
parent | String Required. The BigQuery project id for which data sources should be returned. Must
be in the form: |
Type | Description |
DataTransferServiceClient.ListDataSourcesPagedResponse |
listDataSourcesCallable()
public final UnaryCallable<ListDataSourcesRequest,ListDataSourcesResponse> listDataSourcesCallable()
Lists supported data sources and returns their settings.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListDataSourcesRequest request =
ListDataSourcesRequest.newBuilder()
.setParent(ProjectName.of("[PROJECT]").toString())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.build();
while (true) {
ListDataSourcesResponse response =
dataTransferServiceClient.listDataSourcesCallable().call(request);
for (DataSource element : response.getDataSourcesList()) {
// doThingsWith(element);
}
String nextPageToken = response.getNextPageToken();
if (!Strings.isNullOrEmpty(nextPageToken)) {
request = request.toBuilder().setPageToken(nextPageToken).build();
} else {
break;
}
}
}
Type | Description |
UnaryCallable<ListDataSourcesRequest,ListDataSourcesResponse> |
listDataSourcesPagedCallable()
public final UnaryCallable<ListDataSourcesRequest,DataTransferServiceClient.ListDataSourcesPagedResponse> listDataSourcesPagedCallable()
Lists supported data sources and returns their settings.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListDataSourcesRequest request =
ListDataSourcesRequest.newBuilder()
.setParent(ProjectName.of("[PROJECT]").toString())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.build();
ApiFuture<DataSource> future =
dataTransferServiceClient.listDataSourcesPagedCallable().futureCall(request);
// Do something.
for (DataSource element : future.get().iterateAll()) {
// doThingsWith(element);
}
}
Type | Description |
UnaryCallable<ListDataSourcesRequest,ListDataSourcesPagedResponse> |
listTransferConfigs(ListTransferConfigsRequest request)
public final DataTransferServiceClient.ListTransferConfigsPagedResponse listTransferConfigs(ListTransferConfigsRequest request)
Returns information about all transfer configs owned by a project in the specified location.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListTransferConfigsRequest request =
ListTransferConfigsRequest.newBuilder()
.setParent(ProjectName.of("[PROJECT]").toString())
.addAllDataSourceIds(new ArrayList<String>())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.build();
for (TransferConfig element :
dataTransferServiceClient.listTransferConfigs(request).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
request | ListTransferConfigsRequest The request object containing all of the parameters for the API call. |
Type | Description |
DataTransferServiceClient.ListTransferConfigsPagedResponse |
listTransferConfigs(LocationName parent)
public final DataTransferServiceClient.ListTransferConfigsPagedResponse listTransferConfigs(LocationName parent)
Returns information about all transfer configs owned by a project in the specified location.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
for (TransferConfig element :
dataTransferServiceClient.listTransferConfigs(parent).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
parent | LocationName Required. The BigQuery project id for which data sources should be returned:
|
Type | Description |
DataTransferServiceClient.ListTransferConfigsPagedResponse |
listTransferConfigs(ProjectName parent)
public final DataTransferServiceClient.ListTransferConfigsPagedResponse listTransferConfigs(ProjectName parent)
Returns information about all transfer configs owned by a project in the specified location.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ProjectName parent = ProjectName.of("[PROJECT]");
for (TransferConfig element :
dataTransferServiceClient.listTransferConfigs(parent).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
parent | ProjectName Required. The BigQuery project id for which data sources should be returned:
|
Type | Description |
DataTransferServiceClient.ListTransferConfigsPagedResponse |
listTransferConfigs(String parent)
public final DataTransferServiceClient.ListTransferConfigsPagedResponse listTransferConfigs(String parent)
Returns information about all transfer configs owned by a project in the specified location.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String parent = ProjectName.of("[PROJECT]").toString();
for (TransferConfig element :
dataTransferServiceClient.listTransferConfigs(parent).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
parent | String Required. The BigQuery project id for which data sources should be returned:
|
Type | Description |
DataTransferServiceClient.ListTransferConfigsPagedResponse |
listTransferConfigsCallable()
public final UnaryCallable<ListTransferConfigsRequest,ListTransferConfigsResponse> listTransferConfigsCallable()
Returns information about all transfer configs owned by a project in the specified location.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListTransferConfigsRequest request =
ListTransferConfigsRequest.newBuilder()
.setParent(ProjectName.of("[PROJECT]").toString())
.addAllDataSourceIds(new ArrayList<String>())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.build();
while (true) {
ListTransferConfigsResponse response =
dataTransferServiceClient.listTransferConfigsCallable().call(request);
for (TransferConfig element : response.getTransferConfigsList()) {
// doThingsWith(element);
}
String nextPageToken = response.getNextPageToken();
if (!Strings.isNullOrEmpty(nextPageToken)) {
request = request.toBuilder().setPageToken(nextPageToken).build();
} else {
break;
}
}
}
Type | Description |
UnaryCallable<ListTransferConfigsRequest,ListTransferConfigsResponse> |
listTransferConfigsPagedCallable()
public final UnaryCallable<ListTransferConfigsRequest,DataTransferServiceClient.ListTransferConfigsPagedResponse> listTransferConfigsPagedCallable()
Returns information about all transfer configs owned by a project in the specified location.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListTransferConfigsRequest request =
ListTransferConfigsRequest.newBuilder()
.setParent(ProjectName.of("[PROJECT]").toString())
.addAllDataSourceIds(new ArrayList<String>())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.build();
ApiFuture<TransferConfig> future =
dataTransferServiceClient.listTransferConfigsPagedCallable().futureCall(request);
// Do something.
for (TransferConfig element : future.get().iterateAll()) {
// doThingsWith(element);
}
}
Type | Description |
UnaryCallable<ListTransferConfigsRequest,ListTransferConfigsPagedResponse> |
listTransferLogs(ListTransferLogsRequest request)
public final DataTransferServiceClient.ListTransferLogsPagedResponse listTransferLogs(ListTransferLogsRequest request)
Returns log messages for the transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListTransferLogsRequest request =
ListTransferLogsRequest.newBuilder()
.setParent(
RunName.ofProjectLocationTransferConfigRunName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]", "[RUN]")
.toString())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.addAllMessageTypes(new ArrayList<TransferMessage.MessageSeverity>())
.build();
for (TransferMessage element :
dataTransferServiceClient.listTransferLogs(request).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
request | ListTransferLogsRequest The request object containing all of the parameters for the API call. |
Type | Description |
DataTransferServiceClient.ListTransferLogsPagedResponse |
listTransferLogs(RunName parent)
public final DataTransferServiceClient.ListTransferLogsPagedResponse listTransferLogs(RunName parent)
Returns log messages for the transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
RunName parent =
RunName.ofProjectLocationTransferConfigRunName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]", "[RUN]");
for (TransferMessage element :
dataTransferServiceClient.listTransferLogs(parent).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
parent | RunName Required. Transfer run name in the form:
|
Type | Description |
DataTransferServiceClient.ListTransferLogsPagedResponse |
listTransferLogs(String parent)
public final DataTransferServiceClient.ListTransferLogsPagedResponse listTransferLogs(String parent)
Returns log messages for the transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String parent =
RunName.ofProjectTransferConfigRunName("[PROJECT]", "[TRANSFER_CONFIG]", "[RUN]")
.toString();
for (TransferMessage element :
dataTransferServiceClient.listTransferLogs(parent).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
parent | String Required. Transfer run name in the form:
|
Type | Description |
DataTransferServiceClient.ListTransferLogsPagedResponse |
listTransferLogsCallable()
public final UnaryCallable<ListTransferLogsRequest,ListTransferLogsResponse> listTransferLogsCallable()
Returns log messages for the transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListTransferLogsRequest request =
ListTransferLogsRequest.newBuilder()
.setParent(
RunName.ofProjectLocationTransferConfigRunName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]", "[RUN]")
.toString())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.addAllMessageTypes(new ArrayList<TransferMessage.MessageSeverity>())
.build();
while (true) {
ListTransferLogsResponse response =
dataTransferServiceClient.listTransferLogsCallable().call(request);
for (TransferMessage element : response.getTransferMessagesList()) {
// doThingsWith(element);
}
String nextPageToken = response.getNextPageToken();
if (!Strings.isNullOrEmpty(nextPageToken)) {
request = request.toBuilder().setPageToken(nextPageToken).build();
} else {
break;
}
}
}
Type | Description |
UnaryCallable<ListTransferLogsRequest,ListTransferLogsResponse> |
listTransferLogsPagedCallable()
public final UnaryCallable<ListTransferLogsRequest,DataTransferServiceClient.ListTransferLogsPagedResponse> listTransferLogsPagedCallable()
Returns log messages for the transfer run.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListTransferLogsRequest request =
ListTransferLogsRequest.newBuilder()
.setParent(
RunName.ofProjectLocationTransferConfigRunName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]", "[RUN]")
.toString())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.addAllMessageTypes(new ArrayList<TransferMessage.MessageSeverity>())
.build();
ApiFuture<TransferMessage> future =
dataTransferServiceClient.listTransferLogsPagedCallable().futureCall(request);
// Do something.
for (TransferMessage element : future.get().iterateAll()) {
// doThingsWith(element);
}
}
Type | Description |
UnaryCallable<ListTransferLogsRequest,ListTransferLogsPagedResponse> |
listTransferRuns(ListTransferRunsRequest request)
public final DataTransferServiceClient.ListTransferRunsPagedResponse listTransferRuns(ListTransferRunsRequest request)
Returns information about running and completed transfer runs.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListTransferRunsRequest request =
ListTransferRunsRequest.newBuilder()
.setParent(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.addAllStates(new ArrayList<TransferState>())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.build();
for (TransferRun element : dataTransferServiceClient.listTransferRuns(request).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
request | ListTransferRunsRequest The request object containing all of the parameters for the API call. |
Type | Description |
DataTransferServiceClient.ListTransferRunsPagedResponse |
listTransferRuns(TransferConfigName parent)
public final DataTransferServiceClient.ListTransferRunsPagedResponse listTransferRuns(TransferConfigName parent)
Returns information about running and completed transfer runs.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
TransferConfigName parent =
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]");
for (TransferRun element : dataTransferServiceClient.listTransferRuns(parent).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
parent | TransferConfigName Required. Name of transfer configuration for which transfer runs should be
retrieved. Format of transfer configuration resource name is:
|
Type | Description |
DataTransferServiceClient.ListTransferRunsPagedResponse |
listTransferRuns(String parent)
public final DataTransferServiceClient.ListTransferRunsPagedResponse listTransferRuns(String parent)
Returns information about running and completed transfer runs.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String parent =
TransferConfigName.ofProjectTransferConfigName("[PROJECT]", "[TRANSFER_CONFIG]")
.toString();
for (TransferRun element : dataTransferServiceClient.listTransferRuns(parent).iterateAll()) {
// doThingsWith(element);
}
}
Name | Description |
parent | String Required. Name of transfer configuration for which transfer runs should be
retrieved. Format of transfer configuration resource name is:
|
Type | Description |
DataTransferServiceClient.ListTransferRunsPagedResponse |
listTransferRunsCallable()
public final UnaryCallable<ListTransferRunsRequest,ListTransferRunsResponse> listTransferRunsCallable()
Returns information about running and completed transfer runs.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListTransferRunsRequest request =
ListTransferRunsRequest.newBuilder()
.setParent(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.addAllStates(new ArrayList<TransferState>())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.build();
while (true) {
ListTransferRunsResponse response =
dataTransferServiceClient.listTransferRunsCallable().call(request);
for (TransferRun element : response.getTransferRunsList()) {
// doThingsWith(element);
}
String nextPageToken = response.getNextPageToken();
if (!Strings.isNullOrEmpty(nextPageToken)) {
request = request.toBuilder().setPageToken(nextPageToken).build();
} else {
break;
}
}
}
Type | Description |
UnaryCallable<ListTransferRunsRequest,ListTransferRunsResponse> |
listTransferRunsPagedCallable()
public final UnaryCallable<ListTransferRunsRequest,DataTransferServiceClient.ListTransferRunsPagedResponse> listTransferRunsPagedCallable()
Returns information about running and completed transfer runs.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ListTransferRunsRequest request =
ListTransferRunsRequest.newBuilder()
.setParent(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.addAllStates(new ArrayList<TransferState>())
.setPageToken("pageToken873572522")
.setPageSize(883849137)
.build();
ApiFuture<TransferRun> future =
dataTransferServiceClient.listTransferRunsPagedCallable().futureCall(request);
// Do something.
for (TransferRun element : future.get().iterateAll()) {
// doThingsWith(element);
}
}
Type | Description |
UnaryCallable<ListTransferRunsRequest,ListTransferRunsPagedResponse> |
scheduleTransferRuns(ScheduleTransferRunsRequest request) (deprecated)
public final ScheduleTransferRunsResponse scheduleTransferRuns(ScheduleTransferRunsRequest request)
Deprecated. This method is deprecated and will be removed in the next major version update.
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.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ScheduleTransferRunsRequest request =
ScheduleTransferRunsRequest.newBuilder()
.setParent(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.setStartTime(Timestamp.newBuilder().build())
.setEndTime(Timestamp.newBuilder().build())
.build();
ScheduleTransferRunsResponse response =
dataTransferServiceClient.scheduleTransferRuns(request);
}
Name | Description |
request | ScheduleTransferRunsRequest The request object containing all of the parameters for the API call. |
Type | Description |
ScheduleTransferRunsResponse |
scheduleTransferRuns(TransferConfigName parent, Timestamp startTime, Timestamp endTime) (deprecated)
public final ScheduleTransferRunsResponse scheduleTransferRuns(TransferConfigName parent, Timestamp startTime, Timestamp endTime)
Deprecated. This method is deprecated and will be removed in the next major version update.
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.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
TransferConfigName parent =
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]");
Timestamp startTime = Timestamp.newBuilder().build();
Timestamp endTime = Timestamp.newBuilder().build();
ScheduleTransferRunsResponse response =
dataTransferServiceClient.scheduleTransferRuns(parent, startTime, endTime);
}
Name | Description |
parent | TransferConfigName Required. Transfer configuration name in the form:
|
startTime | Timestamp Required. Start time of the range of transfer runs. For example,
|
endTime | Timestamp Required. End time of the range of transfer runs. For example,
|
Type | Description |
ScheduleTransferRunsResponse |
scheduleTransferRuns(String parent, Timestamp startTime, Timestamp endTime) (deprecated)
public final ScheduleTransferRunsResponse scheduleTransferRuns(String parent, Timestamp startTime, Timestamp endTime)
Deprecated. This method is deprecated and will be removed in the next major version update.
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.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
String parent =
TransferConfigName.ofProjectTransferConfigName("[PROJECT]", "[TRANSFER_CONFIG]")
.toString();
Timestamp startTime = Timestamp.newBuilder().build();
Timestamp endTime = Timestamp.newBuilder().build();
ScheduleTransferRunsResponse response =
dataTransferServiceClient.scheduleTransferRuns(parent, startTime, endTime);
}
Name | Description |
parent | String Required. Transfer configuration name in the form:
|
startTime | Timestamp Required. Start time of the range of transfer runs. For example,
|
endTime | Timestamp Required. End time of the range of transfer runs. For example,
|
Type | Description |
ScheduleTransferRunsResponse |
scheduleTransferRunsCallable() (deprecated)
public final UnaryCallable<ScheduleTransferRunsRequest,ScheduleTransferRunsResponse> scheduleTransferRunsCallable()
Deprecated. This method is deprecated and will be removed in the next major version update.
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.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
ScheduleTransferRunsRequest request =
ScheduleTransferRunsRequest.newBuilder()
.setParent(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.setStartTime(Timestamp.newBuilder().build())
.setEndTime(Timestamp.newBuilder().build())
.build();
ApiFuture<ScheduleTransferRunsResponse> future =
dataTransferServiceClient.scheduleTransferRunsCallable().futureCall(request);
// Do something.
ScheduleTransferRunsResponse response = future.get();
}
Type | Description |
UnaryCallable<ScheduleTransferRunsRequest,ScheduleTransferRunsResponse> |
shutdown()
public void shutdown()
shutdownNow()
public void shutdownNow()
startManualTransferRuns(StartManualTransferRunsRequest request)
public final StartManualTransferRunsResponse startManualTransferRuns(StartManualTransferRunsRequest request)
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.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
StartManualTransferRunsRequest request =
StartManualTransferRunsRequest.newBuilder()
.setParent(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.build();
StartManualTransferRunsResponse response =
dataTransferServiceClient.startManualTransferRuns(request);
}
Name | Description |
request | StartManualTransferRunsRequest The request object containing all of the parameters for the API call. |
Type | Description |
StartManualTransferRunsResponse |
startManualTransferRunsCallable()
public final UnaryCallable<StartManualTransferRunsRequest,StartManualTransferRunsResponse> startManualTransferRunsCallable()
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.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
StartManualTransferRunsRequest request =
StartManualTransferRunsRequest.newBuilder()
.setParent(
TransferConfigName.ofProjectLocationTransferConfigName(
"[PROJECT]", "[LOCATION]", "[TRANSFER_CONFIG]")
.toString())
.build();
ApiFuture<StartManualTransferRunsResponse> future =
dataTransferServiceClient.startManualTransferRunsCallable().futureCall(request);
// Do something.
StartManualTransferRunsResponse response = future.get();
}
Type | Description |
UnaryCallable<StartManualTransferRunsRequest,StartManualTransferRunsResponse> |
updateTransferConfig(TransferConfig transferConfig, FieldMask updateMask)
public final TransferConfig updateTransferConfig(TransferConfig transferConfig, FieldMask updateMask)
Updates a data transfer configuration. All fields must be set, even if they are not updated.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
TransferConfig transferConfig = TransferConfig.newBuilder().build();
FieldMask updateMask = FieldMask.newBuilder().build();
TransferConfig response =
dataTransferServiceClient.updateTransferConfig(transferConfig, updateMask);
}
Name | Description |
transferConfig | TransferConfig Required. Data transfer configuration to create. |
updateMask | FieldMask Required. Required list of fields to be updated in this request. |
Type | Description |
TransferConfig |
updateTransferConfig(UpdateTransferConfigRequest request)
public final TransferConfig updateTransferConfig(UpdateTransferConfigRequest request)
Updates a data transfer configuration. All fields must be set, even if they are not updated.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
UpdateTransferConfigRequest request =
UpdateTransferConfigRequest.newBuilder()
.setTransferConfig(TransferConfig.newBuilder().build())
.setAuthorizationCode("authorizationCode742596102")
.setUpdateMask(FieldMask.newBuilder().build())
.setVersionInfo("versionInfo688769446")
.setServiceAccountName("serviceAccountName2137368675")
.build();
TransferConfig response = dataTransferServiceClient.updateTransferConfig(request);
}
Name | Description |
request | UpdateTransferConfigRequest The request object containing all of the parameters for the API call. |
Type | Description |
TransferConfig |
updateTransferConfigCallable()
public final UnaryCallable<UpdateTransferConfigRequest,TransferConfig> updateTransferConfigCallable()
Updates a data transfer configuration. All fields must be set, even if they are not updated.
Sample code:
// This snippet has been automatically generated for illustrative purposes only.
// It may require modifications to work in your environment.
try (DataTransferServiceClient dataTransferServiceClient = DataTransferServiceClient.create()) {
UpdateTransferConfigRequest request =
UpdateTransferConfigRequest.newBuilder()
.setTransferConfig(TransferConfig.newBuilder().build())
.setAuthorizationCode("authorizationCode742596102")
.setUpdateMask(FieldMask.newBuilder().build())
.setVersionInfo("versionInfo688769446")
.setServiceAccountName("serviceAccountName2137368675")
.build();
ApiFuture<TransferConfig> future =
dataTransferServiceClient.updateTransferConfigCallable().futureCall(request);
// Do something.
TransferConfig response = future.get();
}
Type | Description |
UnaryCallable<UpdateTransferConfigRequest,TransferConfig> |