gcloud_beta_iam_roles_copy (1)

NAME

gcloud beta iam roles copy - create a role from an existing role

SYNOPSIS

gcloud beta iam roles copy [--dest-organization=DEST_ORGANIZATION] [--dest-project=DEST_PROJECT] [--destination=DESTINATION] [--source=SOURCE] [--source-organization=SOURCE_ORGANIZATION] [--source-project=SOURCE_PROJECT] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(BETA) This command creates a role from an existing role.

FLAGS

--dest-organization=DEST_ORGANIZATION

The organization of the destination role.

--dest-project=DEST_PROJECT

The project of the destination role.

--destination=DESTINATION

The destination role id for the new custom role. For example: viewer.

--source=SOURCE

The source role name or id.For curated roles, for example: roles/viewer.For custom roles, for example: viewer.

--source-organization=SOURCE_ORGANIZATION

The organization of the source role if it is an custom role.

--source-project=SOURCE_PROJECT

The project of the source role if it is an custom role.

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 create a copy of an existing role into an organization with ORGANIZATION_ID.

$gcloud beta iam roles copy --source "roles/viewer" --destination CustomViewer
 --dest-organization ORGANIZATION_ID

To create a copy of an existing role into a project with PROJECT_ID.

$gcloud beta iam roles copy --source "roles/spanner.databaseAdmin"
 --destination CustomSpannerDbAdmin --dest-project PROJECT_ID

To modify the newly created role see the roles update command.

NOTES

This command is currently in BETA and may change without notice. These variants are also available:

$ gcloud iam roles copy $ gcloud alpha iam roles copy