gcloud beta projects remove-iam-policy-binding - remove IAM policy binding for a project

gcloud beta projects remove-iam-policy-bindingPROJECT_ID--member=PRINCIPAL--role=ROLE[--recommend=BOOLEAN_VALUE][--all    |--condition=[KEY=VALUE,…]    |--condition-from-file=PATH_TO_FILE][GCLOUD_WIDE_FLAG …]

gcloudbetaprojectsremove-iam-policy-bindingexample-project-id-1--member='user:test-user@gmail.com'--role='roles/editor'

To remove an IAM policy binding for the role ofroles/editor fromall authenticated users on projectexample-project-id-1, run:

gcloudbetaprojectsremove-iam-policy-bindingexample-project-id-1--member='allAuthenticatedUsers'--role='roles/editor'

gcloudbetaprojectsremove-iam-policy-bindingexample-project-id-1--member='user:test-user@gmail.com'--role='roles/browser'--condition='expression=request.time< timestamp("2019-01-01T00:00:00Z"),title=expires_end_of_2018,descrip\tion=Expires at midnight on 2018-12-31'

To remove all IAM policy bindings regardless of the condition for the role ofroles/browser and for the usertest-user@gmail.com onproject with identifierexample-project-id-1, run:

gcloudbetaprojectsremove-iam-policy-bindingexample-project-id-1--member='user:test-user@gmail.com'--role='roles/browser'--all

Seehttps://cloud.google.com/iam/docs/managing-policiesfor details of policy role and member types.

Project resource - ID for the project you want to remove IAM policy bindingfrom. This represents a Cloud resource.

This must be specified.

PROJECT_ID

ID of the project or fully qualified identifier for the project.

To set theproject_id attribute:

• provide the argumentproject_id on the command line.

--member=PRINCIPAL

The principal to remove the binding for. Should be of the formuser|group|serviceAccount:email ordomain:domain.

Examples:user:test-user@gmail.com,group:admins@example.com,serviceAccount:test123@example.domain.com, ordomain:example.domain.com.

Deleted principals have an additionaldeleted: prefix and a?uid=UID suffix, whereUID isa unique identifier for the principal. Example:deleted:user:test-user@gmail.com?uid=123456789012345678901.

Some resources also accept the following special values:

• allUsers - Special identifier that represents anyone who is on theinternet, with or without a Google account.
• allAuthenticatedUsers - Special identifier that represents anyonewho is authenticated with a Google account or a service account.

--role=ROLE

The role to remove the principal from.

--recommend=BOOLEAN_VALUE

If true, checks Active Assist recommendation for the risk level of IAM policybinding removal, and issues a warning in the prompt. Optional flag is set tofalse by default. For details seehttps://cloud.google.com/recommender/docs/change-risk-recommendations

At most one of these can be specified:

--all

Remove all bindings with this role and principal, irrespective of anyconditions.

--condition=[KEY=VALUE,…]

The condition of the binding that you want to remove. When the condition isexplicitly specified asNone (--condition=None), abinding without a condition is removed. Otherwise, only a binding with acondition that exactly matches the specified condition (including the optionaldescription) is removed. For more on conditions, refer to the conditionsoverview guide:https://cloud.google.com/iam/docs/conditions-overview

When using the--condition flag, include the following key-valuepairs:

expression

(Required) Condition expression that evaluates to True or False. This uses asubset of Common Expression Language syntax.

If the condition expression includes a comma, use a different delimiter toseparate the key-value pairs. Specify the delimiter before listing the key-valuepairs. For example, to specify a colon (:) as the delimiter, do thefollowing:--condition=^:^title=TITLE:expression=EXPRESSION. Formore information, seehttps://cloud.google.com/sdk/gcloud/reference/topic/escaping.

title

(Required) A short string describing the purpose of the expression.

description

(Optional) Additional description for the expression.

--condition-from-file=PATH_TO_FILE

Path to a local JSON or YAML file that defines the condition. To see availablefields, see the help for--condition. Use a full or relative pathto a local file containing the value of condition.

Run$gcloud help for details.