testIamPermissions method

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

Returns the IAM permissions that the caller has on the specified Access Context Manager resource.

The resource can be an AccessPolicy, AccessLevel, or ServicePerimeter. This method does not support other resources.

request - The metadata request object.

Request parameters:

resource - REQUIRED: The resource for which the policy detail is being requested. See Resource names for the appropriate value for this field. Value must have pattern ^accessPolicies/\[^/\]+/accessLevels/\[^/\]+$.

$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>);
}