deleteRole method

ResponseFuture<Role> deleteRole(
  1. DeleteRoleRequest request, {
  2. CallOptions? options,
})

Deletes a custom google.iam.admin.v1.Role.

When you delete a custom role, the following changes occur immediately:

  • You cannot bind a principal to the custom role in an IAM google.iam.v1.Policy.
  • Existing bindings to the custom role are not changed, but they have no effect.
  • By default, the response from google.iam.admin.v1.IAM.ListRoles does not include the custom role.

You have 7 days to undelete the custom role. After 7 days, the following changes occur:

  • The custom role is permanently deleted and cannot be recovered.
  • If an IAM policy contains a binding to the custom role, the binding is permanently removed.

Implementation

$grpc.ResponseFuture<$0.Role> deleteRole(
  $0.DeleteRoleRequest request, {
  $grpc.CallOptions? options,
}) {
  return $createUnaryCall(_$deleteRole, request, options: options);
}