Class Policy (2.39.0)

publicfinalclassPolicyimplementsSerializable

Inheritance

Object >Policy

Implements

Serializable

Static Methods

newBuilder()

publicstaticPolicy.BuildernewBuilder()

Returns a builder forPolicy objects.

Returns
TypeDescription
Policy.Builder

Methods

equals(Object obj)

publicbooleanequals(Objectobj)
Parameter
NameDescription
objObject
Returns
TypeDescription
boolean
Overrides

getBindings()

publicMap<Role,Set<Identity>>getBindings()

Returns the map of bindings that comprises the policy.

Returns
TypeDescription
Map<Role,Set<Identity>>

getBindingsList()

publicImmutableList<Binding>getBindingsList()

Returns the list of bindings that comprises the policy for version 3.

Returns
TypeDescription
com.google.common.collect.ImmutableList<Binding>

getEtag()

publicStringgetEtag()

Returns the policy's etag.

Etags are used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the etag in the read-modify-write cycle to perform policy updates in order to avoid race conditions. An etag is returned in the response to getIamPolicy, and systems are expected to put that etag in the request to setIamPolicy to ensure that their change will be applied to the same version of the policy. If no etag is provided in the call to setIamPolicy, then the existing policy is overwritten blindly.

Returns
TypeDescription
String

getVersion()

publicintgetVersion()

Returns the version of the policy. The default version is 0, meaning only the "owner", "editor", and "viewer" roles are permitted. If the version is 1, you may also use other roles.

Returns
TypeDescription
int

hashCode()

publicinthashCode()
Returns
TypeDescription
int
Overrides

toBuilder()

publicPolicy.BuildertoBuilder()

Returns a builder containing the properties of this IAM Policy.

Returns
TypeDescription
Policy.Builder

toString()

publicStringtoString()
Returns
TypeDescription
String
Overrides

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-31 UTC.