list method
Lists transfer jobs.
Request parameters:
filter
- Required. A list of query parameters specified as JSON text in
the form of: ``` { "projectId":"my_project_id",
"jobNames":"jobid1","jobid2",...
,
"jobStatuses":"status1","status2",...
,
"dataBackend":"QUERY_REPLICATION_CONFIGS",
"sourceBucket":"source-bucket-name", "sinkBucket":"sink-bucket-name", }
query parameters without spaces or line breaks. * `projectId` is required.
* Since `jobNames` and `jobStatuses` support multiple values, their values
must be specified with array notation. `jobNames` and `jobStatuses` are
optional. Valid values are case-insensitive: * ENABLED * DISABLED *
DELETED * Specify `"dataBackend":"QUERY_REPLICATION_CONFIGS"` to return a
list of cross-bucket replication jobs. * Limit the results to jobs from a
particular bucket with `sourceBucket` and/or to a particular bucket with
`sinkBucket`.
[pageSize] - The list page size. The max allowed value is 256.
[pageToken] - The list page token.
[$fields] - Selector specifying which fields to include in a partial
response.
Completes with a [ListTransferJobsResponse].
Completes with a [commons.ApiRequestError] if the API endpoint returned an
error.
If the used [http.Client] completes with an error when making a REST call,
this method will complete with the same error.
Implementation
async.Future<ListTransferJobsResponse> list(
core.String filter, {
core.int? pageSize,
core.String? pageToken,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
'filter': [filter],
if (pageSize != null) 'pageSize': ['${pageSize}'],
if (pageToken != null) 'pageToken': [pageToken],
if ($fields != null) 'fields': [$fields],
};
const url_ = 'v1/transferJobs';
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return ListTransferJobsResponse.fromJson(
response_ as core.Map<core.String, core.dynamic>);
}