testIamPermissions method

Future<TestIamPermissionsResponse> testIamPermissions(
  1. TestIamPermissionsRequest request,
  2. String resource, {
  3. String? $fields,
})

Returns permissions that the caller has on the specified database or backup resource.

Attempting this RPC on a non-existent Cloud Spanner database will result in a NOT_FOUND error if the user has spanner.databases.list permission on the containing Cloud Spanner instance. Otherwise returns an empty set of permissions. Calling this method on a backup that does not exist will result in a NOT_FOUND error if the user has spanner.backups.list permission on the containing instance.

request - The metadata request object.

Request parameters:

resource - REQUIRED: The Cloud Spanner resource for which permissions are being tested. The format is projects//instances/ for instance resources and projects//instances//databases/ for database resources. Value must have pattern ^projects/\[^/\]+/instances/\[^/\]+/backups/\[^/\]+$.

$fields - Selector specifying which fields to include in a partial response.

Completes with a TestIamPermissionsResponse.

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<TestIamPermissionsResponse> testIamPermissions(
  TestIamPermissionsRequest request,
  core.String resource, {
  core.String? $fields,
}) async {
  final body_ = convert.json.encode(request);
  final queryParams_ = <core.String, core.List<core.String>>{
    if ($fields != null) 'fields': [$fields],
  };

  final url_ =
      'v1/' + core.Uri.encodeFull('$resource') + ':testIamPermissions';

  final response_ = await _requester.request(
    url_,
    'POST',
    body: body_,
    queryParams: queryParams_,
  );
  return TestIamPermissionsResponse.fromJson(
      response_ as core.Map<core.String, core.dynamic>);
}