list method
List dependencies based on the provided filter and pagination parameters.
Request parameters:
parent
- Required. The parent which owns this collection of dependency
resources. Format: projects/{project}/locations/{location}
Value must have pattern ^projects/\[^/\]+/locations/\[^/\]+$
.
filter
- Optional. An expression that filters the list of Dependencies.
A filter expression consists of a field name, a comparison operator, and a
value for filtering. The value must be a string. Allowed comparison
operator is =
. Filters are not case sensitive. The following fields in
the Dependency
are eligible for filtering: *
consumer.operation_resource_name
- The operation resource name for the
consumer entity involved in a dependency. Allowed comparison operators:
=
. * consumer.external_api_resource_name
- The external api resource
name for the consumer entity involved in a dependency. Allowed comparison
operators: =
. * supplier.operation_resource_name
- The operation
resource name for the supplier entity involved in a dependency. Allowed
comparison operators: =
. * supplier.external_api_resource_name
- The
external api resource name for the supplier entity involved in a
dependency. Allowed comparison operators: =
. Expressions are combined
with either AND
logic operator or OR
logical operator but not both of
them together i.e. only one of the AND
or OR
operator can be used
throughout the filter string and both the operators cannot be used
together. No other logical operators are supported. At most three filter
fields are allowed in the filter string and if provided more than that
then INVALID_ARGUMENT
error is returned by the API. For example,
consumer.operation_resource_name = \"projects/p1/locations/global/apis/a1/versions/v1/operations/o1\" OR supplier.operation_resource_name = \"projects/p1/locations/global/apis/a1/versions/v1/operations/o1\"
- The
dependencies with either consumer or supplier operation resource name as
projects/p1/locations/global/apis/a1/versions/v1/operations/o1.
pageSize
- Optional. The maximum number of dependency resources to
return. The service may return fewer than this value. If unspecified, at
most 50 dependencies will be returned. The maximum value is 1000; values
above 1000 will be coerced to 1000.
pageToken
- Optional. A page token, received from a previous
ListDependencies
call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to ListDependencies
must
match the call that provided the page token.
$fields
- Selector specifying which fields to include in a partial
response.
Completes with a GoogleCloudApihubV1ListDependenciesResponse.
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<GoogleCloudApihubV1ListDependenciesResponse> list(
core.String parent, {
core.String? filter,
core.int? pageSize,
core.String? pageToken,
core.String? $fields,
}) async {
final queryParams_ = <core.String, core.List<core.String>>{
if (filter != null) 'filter': [filter],
if (pageSize != null) 'pageSize': ['${pageSize}'],
if (pageToken != null) 'pageToken': [pageToken],
if ($fields != null) 'fields': [$fields],
};
final url_ = 'v1/' + core.Uri.encodeFull('$parent') + '/dependencies';
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return GoogleCloudApihubV1ListDependenciesResponse.fromJson(
response_ as core.Map<core.String, core.dynamic>,
);
}