str
The name of the role.
When Role is used in CreateRole, the role name must not be
set.
When Role is used in output and other input such as
UpdateRole, the role name is the complete path, e.g.,
roles/logging.viewer for predefined roles and
organizations/{ORGANIZATION_ID}/roles/logging.viewer for
custom roles.
title
str
Optional. A human-readable title for the
role. Typically this is limited to 100 UTF-8
bytes.
description
str
Optional. A human-readable description for
the role.
included_permissions
MutableSequence[str]
The names of the permissions this role grants
when bound in an IAM policy.
stage
google.cloud.iam_admin_v1.types.Role.RoleLaunchStage
The current launch stage of the role. If the ALPHA
launch stage has been selected for a role, the stage
field will not be included in the returned definition for
the role.
etag
bytes
Used to perform a consistent
read-modify-write.
deleted
bool
The current deleted state of the role. This
field is read only. It will be ignored in calls
to CreateRole and UpdateRole.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Class Role (2.19.1)\n\nVersion latestkeyboard_arrow_down\n\n- [2.19.1 (latest)](/python/docs/reference/iam/latest/google.cloud.iam_admin_v1.types.Role)\n- [2.19.0](/python/docs/reference/iam/2.19.0/google.cloud.iam_admin_v1.types.Role)\n- [2.18.3](/python/docs/reference/iam/2.18.3/google.cloud.iam_admin_v1.types.Role)\n- [2.17.0](/python/docs/reference/iam/2.17.0/google.cloud.iam_admin_v1.types.Role)\n- [2.16.1](/python/docs/reference/iam/2.16.1/google.cloud.iam_admin_v1.types.Role)\n- [2.15.2](/python/docs/reference/iam/2.15.2/google.cloud.iam_admin_v1.types.Role)\n- [2.14.3](/python/docs/reference/iam/2.14.3/google.cloud.iam_admin_v1.types.Role)\n- [2.13.0](/python/docs/reference/iam/2.13.0/google.cloud.iam_admin_v1.types.Role)\n- [2.12.1](/python/docs/reference/iam/2.12.1/google.cloud.iam_admin_v1.types.Role)\n- [2.11.2](/python/docs/reference/iam/2.11.2/google.cloud.iam_admin_v1.types.Role)\n- [2.10.0](/python/docs/reference/iam/2.10.0/google.cloud.iam_admin_v1.types.Role)\n- [2.9.0](/python/docs/reference/iam/2.9.0/google.cloud.iam_admin_v1.types.Role)\n- [2.8.2](/python/docs/reference/iam/2.8.2/google.cloud.iam_admin_v1.types.Role)\n- [2.7.0](/python/docs/reference/iam/2.7.0/google.cloud.iam_admin_v1.types.Role)\n- [2.6.2](/python/docs/reference/iam/2.6.2/google.cloud.iam_admin_v1.types.Role)\n- [2.5.1](/python/docs/reference/iam/2.5.1/google.cloud.iam_admin_v1.types.Role)\n- [2.4.0](/python/docs/reference/iam/2.4.0/google.cloud.iam_admin_v1.types.Role)\n- [2.3.2](/python/docs/reference/iam/2.3.2/google.cloud.iam_admin_v1.types.Role)\n- [2.2.0](/python/docs/reference/iam/2.2.0/google.cloud.iam_admin_v1.types.Role)\n- [2.1.0](/python/docs/reference/iam/2.1.0/google.cloud.iam_admin_v1.types.Role)\n- [2.0.0](/python/docs/reference/iam/2.0.0/google.cloud.iam_admin_v1.types.Role)\n- [1.0.3](/python/docs/reference/iam/1.0.3/google.cloud.iam_admin_v1.types.Role)\n- [0.3.2](/python/docs/reference/iam/0.3.2/google.cloud.iam_admin_v1.types.Role)\n- [0.2.0](/python/docs/reference/iam/0.2.0/google.cloud.iam_admin_v1.types.Role) \n\n Role(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nA role in the Identity and Access Management API.\n\nClasses\n-------\n\n### RoleLaunchStage\n\n RoleLaunchStage(value)\n\nA stage representing a role's lifecycle phase."]]