listRevisions method
Lists the revisions of the specified Consent in reverse chronological order.
Request parameters:
name
- Required. The resource name of the Consent to retrieve revisions
for.
Value must have pattern
^projects/\[^/\]+/locations/\[^/\]+/datasets/\[^/\]+/consentStores/\[^/\]+/consents/\[^/\]+$
.
filter
- Optional. Restricts the revisions returned to those matching a
filter. The following syntax is available: * A string field value can be
written as text inside quotation marks, for example "query text"
. The
only valid relational operation for text fields is equality (=
), where
text is searched within the field, rather than having the field be equal
to the text. For example, "Comment = great"
returns messages with
great
in the comment field. * A number field value can be written as an
integer, a decimal, or an exponential. The valid relational operators for
number fields are the equality operator (=
), along with the less
than/greater than operators (<
, <=
, >
, >=
). Note that there is no
inequality (!=
) operator. You can prepend the NOT
operator to an
expression to negate it. * A date field value must be written in
yyyy-mm-dd
form. Fields with date and time use the RFC3339 time format.
Leading zeros are required for one-digit months and days. The valid
relational operators for date fields are the equality operator (=
) ,
along with the less than/greater than operators (<
, <=
, >
, >=
).
Note that there is no inequality (!=
) operator. You can prepend the
NOT
operator to an expression to negate it. * Multiple field query
expressions can be combined in one query by adding AND
or OR
operators
between the expressions. If a boolean operator appears within a quoted
string, it is not treated as special, it's just another part of the
character string to be matched. You can prepend the NOT
operator to an
expression to negate it. Fields available for filtering are: - user_id.
For example, filter='user_id="user123"'
. - consent_artifact - state -
revision_create_time - metadata. For example,
filter=Metadata(\"testkey\")=\"value\"
or
filter=HasMetadata(\"testkey\")
.
pageSize
- Optional. Limit on the number of revisions to return in a
single response. If not specified, 100 is used. May not be larger than
1000.
pageToken
- Optional. Token to retrieve the next page of results or
empty if there are no more results in the list.
$fields
- Selector specifying which fields to include in a partial
response.
Completes with a ListConsentRevisionsResponse.
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<ListConsentRevisionsResponse> listRevisions(
core.String name, {
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('$name') + ':listRevisions';
final response_ = await _requester.request(
url_,
'GET',
queryParams: queryParams_,
);
return ListConsentRevisionsResponse.fromJson(
response_ as core.Map<core.String, core.dynamic>);
}