gcloud_iam_roles_update (1)
NAME
- gcloud iam roles update - update an IAM custom role
SYNOPSIS
-
gcloud iam roles update ROLE_ID [--file=FILE] [--organization=ORGANIZATION] [--add-permissions=ADD_PERMISSIONS --description=DESCRIPTION --permissions=PERMISSIONS --remove-permissions=REMOVE_PERMISSIONS --stage=STAGE --title=TITLE] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
POSITIONAL ARGUMENTS
-
- ROLE_ID
-
The id of the custom role to update. For example: CustomRole. You must also
specify the --organization or --project flag.
FLAGS
-
- --file=FILE
-
The Yaml file you want to use to update a role. Can not be specified with other
flags except role-id.
- --organization=ORGANIZATION
-
The organization of the role you want to update.
-
The following flags determine the fields need to be updated. You can update a
role by specifying the following flags, or you can update a role from a Yaml
file by specifying the file flag.
-
- --add-permissions=ADD_PERMISSIONS
-
The permissions you want to add to the role. Use commas to separate them.
- --description=DESCRIPTION
-
The description of the role you want to update.
- --permissions=PERMISSIONS
-
The permissions of the role you want to set. Use commas to separate them.
- --remove-permissions=REMOVE_PERMISSIONS
-
The permissions you want to remove from the role. Use commas to separate them.
- --stage=STAGE
-
The state of the role you want to update.
- --title=TITLE
-
The title of the role you want to update.
-
GCLOUD WIDE FLAGS
These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
EXAMPLES
To update a role from a Yaml file, run:
-
$ gcloud iam roles update viewer --organization 123 \
--file role_file_path
To update a role with flags, run:
-
$ gcloud iam roles update viewer --project myproject \
--permissions permission1,permission2
NOTES
These variants are also available:
- $ gcloud alpha iam roles update $ gcloud beta iam roles update