gcloud iam roles delete

NAME

gcloud iam roles delete - delete a custom role from an organization or a project

SYNOPSIS

gcloud iam roles delete ROLE_ID (--organization=ORGANIZATION     | --project=PROJECT_ID) [GCLOUD_WIDE_FLAG …]

DESCRIPTION

This command deletes a role.

This command can fail for the following reasons:

• The role specified does not exist.
• The active user does not have permission to access the given role.

EXAMPLES

To delete the role ProjectUpdater of the organization 1234567, run:

gcloud iam roles delete ProjectUpdater --organization=1234567

To delete the role ProjectUpdater of the project myproject, run:

gcloud iam roles delete ProjectUpdater --project=myproject

POSITIONAL ARGUMENTS

ROLE_ID

ID of the custom role to delete. You must also specify the --organization or --project flag.

REQUIRED FLAGS

Exactly one of these must be specified:

--organization=ORGANIZATION

Organization of the role you want to delete.

--project=PROJECT_ID

Project of the role you want to delete.

The Google Cloud project ID to use for this invocation. If omitted, then the current project is assumed; the current project can be listed using gcloud config list --format='text(core.project)' and can be set using gcloud config set project PROJECTID.

--project and its fallback core/project property play two roles in the invocation: they specify both the project of the resource to operate on, and the project for API enablement checks, quota, and billing. To specify a different project for quota and billing, use the --billing-project flag or the billing/quota_project property.

GCLOUD WIDE FLAGS

These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES

These variants are also available:

gcloud alpha iam roles delete

gcloud beta iam roles delete