^f S r SSKJr SSKJr SSKJr SSKJr Sr " S S\R 5 r " S S
\R 5 r " S S \R 5 r
" S
S\R 5 r " S S\R 5 r " S S\R 5 r " S S\R 5 r " S S\R 5 r " S S\R 5 r " S S\R 5 r " S S \R 5 r " S S \R 5 r " S S \R 5 r " S! S"\R 5 r " S# S$\R 5 r " S% S&\R 5 r " S' S(\R 5 r " S) S*\R 5 r " S+ S,\R 5 r " S- S.\R 5 r " S/ S0\R 5 r " S1 S2\R 5 r " S3 S4\R 5 r! " S5 S6\R 5 r" " S7 S8\R 5 r# " S9 S:\R 5 r$ " S; S<\R 5 r% " S= S>\R 5 r& " S? S@\R 5 r' " SA SB\R 5 r(\RR " \(SCSD5 \RT " \(RV SESF5 \RT " \(RV SGSH5 gI)Jz@Generated message classes for policytroubleshooter version v3.
)absolute_import)messages)encoding) extra_typespolicytroubleshooterc \ rS rSrSr\R " SS5 r\R " S5 r \R " S5 r
\R " S5 r \R " S5 r S r
g
) /GoogleCloudPolicytroubleshooterIamV3AccessTuple a! Information about the principal, resource, and permission to check.
Fields:
conditionContext: Optional. Additional context for the request, such as
the request time or IP address. This context allows Policy
Troubleshooter to troubleshoot conditional role bindings and deny rules.
fullResourceName: Required. The full resource name that identifies the
resource. For example, `//compute.googleapis.com/projects/my-
project/zones/us-central1-a/instances/my-instance`. For examples of full
resource names for Google Cloud services, see
https://cloud.google.com/iam/help/troubleshooter/full-resource-names.
permission: Required. The IAM permission to check for, either in the `v1`
permission format or the `v2` permission format. For a complete list of
IAM permissions in the `v1` format, see
https://cloud.google.com/iam/help/permissions/reference. For a list of
IAM permissions in the `v2` format, see
https://cloud.google.com/iam/help/deny/supported-permissions. For a
complete list of predefined IAM roles and the permissions in each role,
see https://cloud.google.com/iam/help/roles/reference.
permissionFqdn: Output only. The permission that Policy Troubleshooter
checked for, in the `v2` format.
principal: Required. The email address of the principal whose access you
want to check. For example, `alice@example.com` or `my-service-
account@my-project.iam.gserviceaccount.com`. The principal must be a
Google Account or a service account. Other types of principals are not
supported.
4GoogleCloudPolicytroubleshooterIamV3ConditionContext N)__name__
__module__ __qualname____firstlineno____doc__ _messages MessageFieldconditionContext StringFieldfullResourceName
permissionpermissionFqdn principal__static_attributes__r elib/googlecloudsdk/generated_clients/apis/policytroubleshooter/v3/policytroubleshooter_v3_messages.pyr r s_ 8 ++,bdef **1-$$Q'* ((+.##A&)r r c h \ rS rSrSr " S S\R 5 r " S S\R 5 r " S S\R 5 r " S S
\R 5 r
\ R " S 5 " S S
\R 5 5 r\R " SS5 r\R" " SS5 r\R" " SS5 r\R" " SS5 r\R" " S
S5 r\R " SS5 r\R. " S5 r\R " S
S5 r\R " SS5 rSrg) ;GoogleCloudPolicytroubleshooterIamV3AllowBindingExplanation4 a" Details about how a role binding in an allow policy affects a
principal's ability to use a permission.
Enums:
AllowAccessStateValueValuesEnum: Required. Indicates whether _this role
binding_ gives the specified permission to the specified principal on
the specified resource. This field does _not_ indicate whether the
principal actually has the permission on the resource. There might be
another role binding that overrides this role binding. To determine
whether the principal actually has the permission, use the
`overall_access_state` field in the TroubleshootIamPolicyResponse.
RelevanceValueValuesEnum: The relevance of this role binding to the
overall determination for the entire policy.
RolePermissionValueValuesEnum: Indicates whether the role granted by this
role binding contains the specified permission.
RolePermissionRelevanceValueValuesEnum: The relevance of the permission's
existence, or nonexistence, in the role to the overall determination for
the entire policy.
Messages:
MembershipsValue: Indicates whether each role binding includes the
principal specified in the request, either directly or indirectly. Each
key identifies a principal in the role binding, and each value indicates
whether the principal in the role binding includes the principal in the
request. For example, suppose that a role binding includes the following
principals: * `user:alice@example.com` * `group:product-eng@example.com`
You want to troubleshoot access for `user:bob@example.com`. This user is
a member of the group `group:product-eng@example.com`. For the first
principal in the role binding, the key is `user:alice@example.com`, and
the `membership` field in the value is set to `NOT_INCLUDED`. For the
second principal in the role binding, the key is `group:product-
eng@example.com`, and the `membership` field in the value is set to
`INCLUDED`.
Fields:
allowAccessState: Required. Indicates whether _this role binding_ gives
the specified permission to the specified principal on the specified
resource. This field does _not_ indicate whether the principal actually
has the permission on the resource. There might be another role binding
that overrides this role binding. To determine whether the principal
actually has the permission, use the `overall_access_state` field in the
TroubleshootIamPolicyResponse.
combinedMembership: The combined result of all memberships. Indicates if
the principal is included in any role binding, either directly or
indirectly.
condition: A condition expression that specifies when the role binding
grants access. To learn about IAM Conditions, see
https://cloud.google.com/iam/help/conditions/overview.
conditionExplanation: Condition evaluation state for this role binding.
memberships: Indicates whether each role binding includes the principal
specified in the request, either directly or indirectly. Each key
identifies a principal in the role binding, and each value indicates
whether the principal in the role binding includes the principal in the
request. For example, suppose that a role binding includes the following
principals: * `user:alice@example.com` * `group:product-eng@example.com`
You want to troubleshoot access for `user:bob@example.com`. This user is
a member of the group `group:product-eng@example.com`. For the first
principal in the role binding, the key is `user:alice@example.com`, and
the `membership` field in the value is set to `NOT_INCLUDED`. For the
second principal in the role binding, the key is `group:product-
eng@example.com`, and the `membership` field in the value is set to
`INCLUDED`.
relevance: The relevance of this role binding to the overall determination
for the entire policy.
role: The role that this role binding grants. For example,
`roles/compute.admin`. For a complete list of predefined IAM roles, as
well as the permissions in each role, see
https://cloud.google.com/iam/help/roles/reference.
rolePermission: Indicates whether the role granted by this role binding
contains the specified permission.
rolePermissionRelevance: The relevance of the permission's existence, or
nonexistence, in the role to the overall determination for the entire
policy.
c , \ rS rSrSrSrSrSrSrSr Sr
g )
[GoogleCloudPolicytroubleshooterIamV3AllowBindingExplanation.AllowAccessStateValueValuesEnum a Required. Indicates whether _this role binding_ gives the specified
permission to the specified principal on the specified resource. This
field does _not_ indicate whether the principal actually has the
permission on the resource. There might be another role binding that
overrides this role binding. To determine whether the principal actually
has the permission, use the `overall_access_state` field in the
TroubleshootIamPolicyResponse.
Values:
ALLOW_ACCESS_STATE_UNSPECIFIED: Not specified.
ALLOW_ACCESS_STATE_GRANTED: The allow policy gives the principal the
permission.
ALLOW_ACCESS_STATE_NOT_GRANTED: The allow policy doesn't give the
principal the permission.
ALLOW_ACCESS_STATE_UNKNOWN_CONDITIONAL: The allow policy gives the
principal the permission if a condition expression evaluate to `true`.
However, the sender of the request didn't provide enough context for
Policy Troubleshooter to evaluate the condition expression.
ALLOW_ACCESS_STATE_UNKNOWN_INFO: The sender of the request doesn't have
access to all of the allow policies that Policy Troubleshooter needs
to evaluate the principal's access.
r r r
r r r N r r r r r ALLOW_ACCESS_STATE_UNSPECIFIEDALLOW_ACCESS_STATE_GRANTED ALLOW_ACCESS_STATE_NOT_GRANTED&ALLOW_ACCESS_STATE_UNKNOWN_CONDITIONAL ALLOW_ACCESS_STATE_UNKNOWN_INFOr r r r! AllowAccessStateValueValuesEnumr& ' , &'"!" %&"-.*&'#r r. c $ \ rS rSrSrSrSrSrSrg)TGoogleCloudPolicytroubleshooterIamV3AllowBindingExplanation.RelevanceValueValuesEnum The relevance of this role binding to the overall determination for
the entire policy.
Values:
HEURISTIC_RELEVANCE_UNSPECIFIED: Not specified.
HEURISTIC_RELEVANCE_NORMAL: The data point has a limited effect on the
result. Changing the data point is unlikely to affect the overall
determination.
HEURISTIC_RELEVANCE_HIGH: The data point has a strong effect on the
result. Changing the data point is likely to affect the overall
determination.
r r r
r N r r r r r HEURISTIC_RELEVANCE_UNSPECIFIEDHEURISTIC_RELEVANCE_NORMALHEURISTIC_RELEVANCE_HIGHr r r r! RelevanceValueValuesEnumr1 '(#!" r r8 c $ \ rS rSrSrSrSrSrSrg)bGoogleCloudPolicytroubleshooterIamV3AllowBindingExplanation.RolePermissionRelevanceValueValuesEnum a The relevance of the permission's existence, or nonexistence, in the
role to the overall determination for the entire policy.
Values:
HEURISTIC_RELEVANCE_UNSPECIFIED: Not specified.
HEURISTIC_RELEVANCE_NORMAL: The data point has a limited effect on the
result. Changing the data point is unlikely to affect the overall
determination.
HEURISTIC_RELEVANCE_HIGH: The data point has a strong effect on the
result. Changing the data point is likely to affect the overall
determination.
r r r
r Nr4 r r r! &RolePermissionRelevanceValueValuesEnumr; r9 r r= c ( \ rS rSrSrSrSrSrSrSr g) YGoogleCloudPolicytroubleshooterIamV3AllowBindingExplanation.RolePermissionValueValuesEnum a Indicates whether the role granted by this role binding contains the
specified permission.
Values:
ROLE_PERMISSION_INCLUSION_STATE_UNSPECIFIED: Not specified.
ROLE_PERMISSION_INCLUDED: The permission is included in the role.
ROLE_PERMISSION_NOT_INCLUDED: The permission is not included in the
role.
ROLE_PERMISSION_UNKNOWN_INFO: The sender of the request is not allowed
to access the role definition.
r r r
r r N)
r r r r r +ROLE_PERMISSION_INCLUSION_STATE_UNSPECIFIEDROLE_PERMISSION_INCLUDED ROLE_PERMISSION_NOT_INCLUDED ROLE_PERMISSION_UNKNOWN_INFOr r r r! RolePermissionValueValuesEnumr? s!
34/ #$ #$ r rE additionalPropertiesc f \ rS rSrSr " S S\R 5 r\R " SSSS9r Sr
g )
LGoogleCloudPolicytroubleshooterIamV3AllowBindingExplanation.MembershipsValue a Indicates whether each role binding includes the principal specified
in the request, either directly or indirectly. Each key identifies a
principal in the role binding, and each value indicates whether the
principal in the role binding includes the principal in the request. For
example, suppose that a role binding includes the following principals: *
`user:alice@example.com` * `group:product-eng@example.com` You want to
troubleshoot access for `user:bob@example.com`. This user is a member of
the group `group:product-eng@example.com`. For the first principal in the
role binding, the key is `user:alice@example.com`, and the `membership`
field in the value is set to `NOT_INCLUDED`. For the second principal in
the role binding, the key is `group:product-eng@example.com`, and the
`membership` field in the value is set to `INCLUDED`.
Messages:
AdditionalProperty: An additional property for a MembershipsValue
object.
Fields:
additionalProperties: Additional properties of type MembershipsValue
c b \ rS rSrSr\R " S5 r\R " SS5 r Sr
g)_GoogleCloudPolicytroubleshooterIamV3AllowBindingExplanation.MembershipsValue.AdditionalProperty zAn additional property for a MembershipsValue object.
Fields:
key: Name of the additional property.
value: A GoogleCloudPolicytroubleshooterIamV3AllowBindingExplanationAn
notatedAllowMembership attribute.
r SGoogleCloudPolicytroubleshooterIamV3AllowBindingExplanationAnnotatedAllowMembershipr
r N r r r r r r r keyr valuer r r r! AdditionalPropertyrK s-
! !! $c$$%z|}~er rQ r Trepeatedr N r r r r r r MessagerQ r rF r r r r! MembershipsValuerH s4 *
Y . .
%112FTXYr rV r rM r
GoogleTypeExprr 8GoogleCloudPolicytroubleshooterIamV3ConditionExplanationr r r N) r r r r r r Enumr. r8 r= rE r MapUnrecognizedFieldsrU rV EnumFieldallowAccessStater combinedMembership conditionconditionExplanation memberships relevancer rolerolePermissionrolePermissionRelevancer r r r! r# r# 4 s5 IV( (:! !"!y~~ !"%inn %" !!"89"Z** "Z :"ZH (()JAN -- /D FG H$$%5q9)"//0jlmn&&'91=+!!"B*!!"B*!!" \ rS rSrSr\R " SS5 rSrg)@GoogleCloudPolicytroubleshooterIamV3TroubleshootIamPolicyRequesti zRequest for TroubleshootIamPolicy.
Fields:
accessTuple: The information to use for checking whether a principal has a
permission for a resource.
r r r N) r r r r r r r accessTupler r r r! r r s &&'XZ[\+r r c \ rS rSrSr " S S\R 5 r\R " SS5 r \R " SS5 r
\R " S S
5 r \R " SS 5 r
S rg
)AGoogleCloudPolicytroubleshooterIamV3TroubleshootIamPolicyResponsei a Response for TroubleshootIamPolicy.
Enums:
OverallAccessStateValueValuesEnum: Indicates whether the principal has the
specified permission for the specified resource, based on evaluating all
types of the applicable IAM policies.
Fields:
accessTuple: The access tuple from the request, including any provided
context used to evaluate the condition.
allowPolicyExplanation: An explanation of how the applicable IAM allow
policies affect the final access state.
denyPolicyExplanation: An explanation of how the applicable IAM deny
policies affect the final access state.
overallAccessState: Indicates whether the principal has the specified
permission for the specified resource, based on evaluating all types of
the applicable IAM policies.
c , \ rS rSrSrSrSrSrSrSr Sr
g )
cGoogleCloudPolicytroubleshooterIamV3TroubleshootIamPolicyResponse.OverallAccessStateValueValuesEnumi a Indicates whether the principal has the specified permission for the
specified resource, based on evaluating all types of the applicable IAM
policies.
Values:
OVERALL_ACCESS_STATE_UNSPECIFIED: Not specified.
CAN_ACCESS: The principal has the permission.
CANNOT_ACCESS: The principal doesn't have the permission.
UNKNOWN_INFO: The principal might have the permission, but the sender
can't access all of the information needed to fully evaluate the
principal's access.
UNKNOWN_CONDITIONAL: The principal might have the permission, but Policy
Troubleshooter can't fully evaluate the principal's access because the
sender didn't provide the required context to evaluate the condition.
r r r
r r r N) r r r r r OVERALL_ACCESS_STATE_UNSPECIFIED
CAN_ACCESS
CANNOT_ACCESS UNKNOWN_INFOUNKNOWN_CONDITIONALr r r r! !OverallAccessStateValueValuesEnumr s$ ()$JMLr r r r rz r
r r r r N)r r r r r r r] r r r allowPolicyExplanationdenyPolicyExplanationr_ overallAccessStater r r r! r r sl & ).. , &&'XZ[\+$112npqr#001lnop **+NPQRr r c ` \ rS rSrSr\R " SSSS9r\R " S5 r Sr
g )
GoogleIamV1AuditConfigi< aw Specifies the audit configuration for a service. The configuration
determines which permission types are logged, and what identities, if any,
are exempted from logging. An AuditConfig must have one or more
AuditLogConfigs. If there are AuditConfigs for both `allServices` and a
specific service, the union of the two AuditConfigs is used for that
service: the log_types specified in each AuditConfig are enabled, and the
exempted_members in each AuditLogConfig are exempted. Example Policy with
multiple AuditConfigs: { "audit_configs": [ { "service": "allServices",
"audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [
"user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type":
"ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com",
"audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type":
"DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For
sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
logging. It also exempts `jose@example.com` from DATA_READ logging, and
`aliya@example.com` from DATA_WRITE logging.
Fields:
auditLogConfigs: The configuration for logging of each type of permission.
service: Specifies a service that will be enabled for audit logging. For
example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
`allServices` is a special value that covers all services.
GoogleIamV1AuditLogConfigr TrR r
r N) r r r r r r r auditLogConfigsr r r r r r! r r < s/ 0 **+FTXY/ ! !! $'r r c \ rS rSrSr " S S\R 5 r\R " SSS9r \R " SS5 r S r g
) r iY aR Provides the configuration for logging a type of permissions. Example: {
"audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [
"user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables
'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from
DATA_READ logging.
Enums:
LogTypeValueValuesEnum: The log type that this config enables.
Fields:
exemptedMembers: Specifies the identities that do not cause logging for
this type of permission. Follows the same format of Binding.members.
logType: The log type that this config enables.
c ( \ rS rSrSrSrSrSrSrSr g) 0GoogleIamV1AuditLogConfig.LogTypeValueValuesEnumii a The log type that this config enables.
Values:
LOG_TYPE_UNSPECIFIED: Default case. Should never be this.
ADMIN_READ: Admin reads. Example: CloudIAM getIamPolicy
DATA_WRITE: Data writes. Example: CloudSQL Users create
DATA_READ: Data reads. Example: CloudSQL Users list
r r r
r r N)
r r r r r LOG_TYPE_UNSPECIFIED
ADMIN_READ
DATA_WRITE DATA_READr r r r! LogTypeValueValuesEnumr# i s JJIr r( r TrR r
r N)
r r r r r r r] r( r exemptedMembersr_ logTyper r r r! r r Y s>
y~~ ))!d;/ 8! <'r r c \ rS rSrSr\R " SS5 r\R " SSS9r \R " S5 r
S r g
) GoogleIamV1Bindingi{ a Associates `members`, or principals, with a `role`.
Fields:
condition: The condition that is associated with this binding. If the
condition evaluates to `true`, then this binding applies to the current
request. If the condition evaluates to `false`, then this binding does
not apply to the current request. However, a different role binding
might grant the same role to one or more of the principals in this
binding. To learn which resources support conditions in their IAM
policies, see the [IAM
documentation](https://cloud.google.com/iam/help/conditions/resource-
policies).
members: Specifies the principals requesting access for a Google Cloud
resource. `members` can have the following values: * `allUsers`: A
special identifier that represents anyone who is on the internet; with
or without a Google account. * `allAuthenticatedUsers`: A special
identifier that represents anyone who is authenticated with a Google
account or a service account. Does not include identities that come from
external identity providers (IdPs) through identity federation. *
`user:{emailid}`: An email address that represents a specific Google
account. For example, `alice@example.com` . *
`serviceAccount:{emailid}`: An email address that represents a Google
service account. For example, `my-other-
app@appspot.gserviceaccount.com`. *
`serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`:
An identifier for a [Kubernetes service
account](https://cloud.google.com/kubernetes-engine/docs/how-
to/kubernetes-service-accounts). For example, `my-
project.svc.id.goog[my-namespace/my-kubernetes-sa]`. *
`group:{emailid}`: An email address that represents a Google group. For
example, `admins@example.com`. * `domain:{domain}`: The G Suite domain
(primary) that represents all the users of that domain. For example,
`google.com` or `example.com`. *
`deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
identifier) representing a user that has been recently deleted. For
example, `alice@example.com?uid=123456789012345678901`. If the user is
recovered, this value reverts to `user:{emailid}` and the recovered user
retains the role in the binding. *
`deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address
(plus unique identifier) representing a service account that has been
recently deleted. For example, `my-other-
app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the
service account is undeleted, this value reverts to
`serviceAccount:{emailid}` and the undeleted service account retains the
role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An
email address (plus unique identifier) representing a Google group that
has been recently deleted. For example,
`admins@example.com?uid=123456789012345678901`. If the group is
recovered, this value reverts to `group:{emailid}` and the recovered
group retains the role in the binding.
role: Role that is assigned to the list of `members`, or principals. For
example, `roles/viewer`, `roles/editor`, or `roles/owner`.
rW r r
TrR r r N) r r r r r r r rb r membersrf r r r r! r, r, { s? 4l $$%5q9) ! !!d 3' q !$r r, c \ rS rSrSr\R " SSSS9r\R " SSSS9r\R " S 5 r
\R " S
\R R S 9rS rg
)r i aw An Identity and Access Management (IAM) policy, which specifies access
controls for Google Cloud resources. A `Policy` is a collection of
`bindings`. A `binding` binds one or more `members`, or principals, to a
single `role`. Principals can be user accounts, service accounts, Google
groups, and domains (such as G Suite). A `role` is a named list of
permissions; each `role` can be an IAM predefined role or a user-created
custom role. For some types of Google Cloud resources, a `binding` can also
specify a `condition`, which is a logical expression that allows access to a
resource only if the expression evaluates to `true`. A condition can add
constraints based on attributes of the request, the resource, or both. To
learn which resources support conditions in their IAM policies, see the [IAM
documentation](https://cloud.google.com/iam/help/conditions/resource-
policies). **JSON example:** ``` { "bindings": [ { "role":
"roles/resourcemanager.organizationAdmin", "members": [
"user:mike@example.com", "group:admins@example.com", "domain:google.com",
"serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role":
"roles/resourcemanager.organizationViewer", "members": [
"user:eve@example.com" ], "condition": { "title": "expirable access",
"description": "Does not grant access after Sep 2020", "expression":
"request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag":
"BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: -
members: - user:mike@example.com - group:admins@example.com -
domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com
role: roles/resourcemanager.organizationAdmin - members: -
user:eve@example.com role: roles/resourcemanager.organizationViewer
condition: title: expirable access description: Does not grant access after
Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features,
see the [IAM documentation](https://cloud.google.com/iam/docs/).
Fields:
auditConfigs: Specifies cloud audit logging configuration for this policy.
bindings: Associates a list of `members`, or principals, with a `role`.
Optionally, may specify a `condition` that determines how and when the
`bindings` are applied. Each of the `bindings` must contain at least one
principal. The `bindings` in a `Policy` can refer to up to 1,500
principals; up to 250 of these principals can be Google groups. Each
occurrence of a principal counts towards these limits. For example, if
the `bindings` grant 50 different roles to `user:alice@example.com`, and
not to any other principal, then you can add another 1,450 principals to
the `bindings` in the `Policy`.
etag: `etag` is 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. **Important:** If you use IAM Conditions, you must include the
`etag` field whenever you call `setIamPolicy`. If you omit this field,
then IAM allows you to overwrite a version `3` policy with a version `1`
policy, and all of the conditions in the version `3` policy are lost.
version: Specifies the format of the policy. Valid values are `0`, `1`,
and `3`. Requests that specify an invalid value are rejected. Any
operation that affects conditional role bindings must specify version
`3`. This requirement applies to the following operations: * Getting a
policy that includes a conditional role binding * Adding a conditional
role binding to a policy * Changing a conditional role binding in a
policy * Removing any role binding, with or without a condition, from a
policy that includes conditions **Important:** If you use IAM
Conditions, you must include the `etag` field whenever you call
`setIamPolicy`. If you omit this field, then IAM allows you to overwrite
a version `3` policy with a version `1` policy, and all of the
conditions in the version `3` policy are lost. If a policy does not
include any conditions, operations on that policy may specify any valid
version or leave the field unset. To learn which resources support
conditions in their IAM policies, see the [IAM
documentation](https://cloud.google.com/iam/help/conditions/resource-
policies).
r r TrR r, r
r r r r N)r r r r r r r auditConfigsbindings
BytesFieldetagr r r versionr r r r! r r sc EN ''(@!dS,
#
#$8!d
K( a $ " "1i.?.?.E.E F'r r c \ rS rSrSr\R " SS5 r\R " SSS9r \R " SSS9r
\R " S SS9r \R " S
SS9r S r
g )
GoogleIamV2DenyRulei aU A deny rule in an IAM deny policy.
Fields:
denialCondition: The condition that determines whether this deny rule
applies to a request. If the condition expression evaluates to `true`,
then the deny rule is applied; otherwise, the deny rule is not applied.
Each deny rule is evaluated independently. If this deny rule does not
apply to a request, other deny rules might still apply. The condition
can use CEL functions that evaluate [resource
tags](https://cloud.google.com/iam/help/conditions/resource-tags). Other
functions and operators are not supported.
deniedPermissions: The permissions that are explicitly denied by this
rule. Each permission uses the format
`{service_fqdn}/{resource}.{verb}`, where `{service_fqdn}` is the fully
qualified domain name for the service. For example,
`iam.googleapis.com/roles.list`.
deniedPrincipals: The identities that are prevented from using one or more
permissions on Google Cloud resources. This field can contain the
following values: * `principalSet://goog/public:all`: A special
identifier that represents any principal that is on the internet, even
if they do not have a Google Account or are not logged in. *
`principal://goog/subject/{email_id}`: A specific Google Account.
Includes Gmail, Cloud Identity, and Google Workspace user accounts. For
example, `principal://goog/subject/alice@example.com`. *
`deleted:principal://goog/subject/{email_id}?uid={uid}`: A specific
Google Account that was deleted recently. For example,
`deleted:principal://goog/subject/alice@example.com?uid=1234567890`. If
the Google Account is recovered, this identifier reverts to the standard
identifier for a Google Account. *
`principalSet://goog/group/{group_id}`: A Google group. For example,
`principalSet://goog/group/admins@example.com`. *
`deleted:principalSet://goog/group/{group_id}?uid={uid}`: A Google group
that was deleted recently. For example,
`deleted:principalSet://goog/group/admins@example.com?uid=1234567890`.
If the Google group is restored, this identifier reverts to the standard
identifier for a Google group. * `principal://iam.googleapis.com/project
s/-/serviceAccounts/{service_account_id}`: A Google Cloud service
account. For example,
`principal://iam.googleapis.com/projects/-/serviceAccounts/my-service-
account@iam.gserviceaccount.com`. * `deleted:principal://iam.googleapis.
com/projects/-/serviceAccounts/{service_account_id}?uid={uid}`: A Google
Cloud service account that was deleted recently. For example,
`deleted:principal://iam.googleapis.com/projects/-/serviceAccounts/my-
service-account@iam.gserviceaccount.com?uid=1234567890`. If the service
account is undeleted, this identifier reverts to the standard identifier
for a service account. *
`principalSet://goog/cloudIdentityCustomerId/{customer_id}`: All of the
principals associated with the specified Google Workspace or Cloud
Identity customer ID. For example,
`principalSet://goog/cloudIdentityCustomerId/C01Abc35`.
exceptionPermissions: Specifies the permissions that this rule excludes
from the set of denied permissions given by `denied_permissions`. If a
permission appears in `denied_permissions` _and_ in
`exception_permissions` then it will _not_ be denied. The excluded
permissions can be specified using the same syntax as
`denied_permissions`.
exceptionPrincipals: The identities that are excluded from the deny rule,
even if they are listed in the `denied_principals`. For example, you
could add a Google group to the `denied_principals`, then exclude
specific users who belong to that group. This field can contain the same
values as the `denied_principals` field, excluding
`principalSet://goog/public:all`, which represents all users on the
internet.
rW r r
TrR r r r r N)r r r r r r r denialConditionr r r r r r r r r! r5 r5 si ?B **+;Q?/ ++A= **1t<"..q4@!--a$?r r5 c \ rS rSrSr\R " S5 " S S\R 5 5 r \R " SS5 r \R " S5 r
\R " S5 r\R " S 5 r\R " S
5 r\R " S 5 r\R " S 5 r\R " S
SSS9r\R " S5 r\R " S5 rSrg)r iN a Data for an IAM policy.
Messages:
AnnotationsValue: A key-value map to store arbitrary metadata for the
`Policy`. Keys can be up to 63 characters. Values can be up to 255
characters.
Fields:
annotations: A key-value map to store arbitrary metadata for the `Policy`.
Keys can be up to 63 characters. Values can be up to 255 characters.
createTime: Output only. The time when the `Policy` was created.
deleteTime: Output only. The time when the `Policy` was deleted. Empty if
the policy is not deleted.
displayName: A user-specified description of the `Policy`. This value can
be up to 63 characters.
etag: An opaque tag that identifies the current version of the `Policy`.
IAM uses this value to help manage concurrent updates, so they do not
cause one update to be overwritten by another. If this field is present
in a CreatePolicyRequest, the value is ignored.
kind: Output only. The kind of the `Policy`. Always contains the value
`DenyPolicy`.
name: Immutable. The resource name of the `Policy`, which must be unique.
Format: `policies/{attachment_point}/denypolicies/{policy_id}` The
attachment point is identified by its URL-encoded full resource name,
which means that the forward-slash character, `/`, must be written as
`%2F`. For example,
`policies/cloudresourcemanager.googleapis.com%2Fprojects%2Fmy-
project/denypolicies/my-deny-policy`. For organizations and folders, use
the numeric ID in the full resource name. For projects, requests can use
the alphanumeric or the numeric ID. Responses always contain the numeric
ID.
rules: A list of rules that specify the behavior of the `Policy`. All of
the rules should be of the `kind` specified in the `Policy`.
uid: Immutable. The globally unique ID of the `Policy`. Assigned
automatically when the `Policy` is created.
updateTime: Output only. The time when the `Policy` was last updated.
rF c f \ rS rSrSr " S S\R 5 r\R " SSSS9r Sr
g )
"GoogleIamV2Policy.AnnotationsValueiu a. A key-value map to store arbitrary metadata for the `Policy`. Keys can
be up to 63 characters. Values can be up to 255 characters.
Messages:
AdditionalProperty: An additional property for a AnnotationsValue
object.
Fields:
additionalProperties: Additional properties of type AnnotationsValue
c ` \ rS rSrSr\R " S5 r\R " S5 rSr g)5GoogleIamV2Policy.AnnotationsValue.AdditionalPropertyi zAn additional property for a AnnotationsValue object.
Fields:
key: Name of the additional property.
value: A string attribute.
r r
r N)
r r r r r r r rO rP r r r r! rQ r; s)
! !! $c##A&er rQ r TrR r NrT r r r! AnnotationsValuer9 u s2 'Y . . ' %112FTXYr r< r r
r r r rY rZ GoogleIamV2PolicyRuler[ TrR r\ r r N)r r r r r r r^ r rU r< r annotationsr
createTime
deleteTime displayNamer2 kindr rulesuid
updateTimer r r r! r r N s $L !!"89Z** Z :Z2 &&'91=+$$Q'*$$Q'*%%a(+ q !$ q !$ q !$
!8!d
K% a #$$R(*r r c b \ rS rSrSr\R " SS5 r\R " S5 r Sr
g)r= i zA single rule in a `Policy`.
Fields:
denyRule: A rule for a deny policy.
description: A user-specified description of the rule. This value can be
up to 256 characters.
r5 r r
r N) r r r r r r r denyRuler descriptionr r r r! r= r= s,
#
#$91
=(%%a(+r r= c \ rS rSrSr\R " S5 " S S\R 5 5 r \R " S\R R S9r
\R " SSS S
9r\R " S 5 rS rg
)r i a The `Status` type defines a logical error model that is suitable for
different programming environments, including REST APIs and RPC APIs. It is
used by [gRPC](https://github.com/grpc). Each `Status` message contains
three pieces of data: error code, error message, and error details. You can
find out more about this error model and how to work with it in the [API
Design Guide](https://cloud.google.com/apis/design/errors).
Messages:
DetailsValueListEntry: A DetailsValueListEntry object.
Fields:
code: The status code, which should be an enum value of google.rpc.Code.
details: A list of messages that carry the error details. There is a
common set of message types for APIs to use.
message: A developer-facing error message, which should be in English. Any
user-facing error message should be localized and sent in the
google.rpc.Status.details field, or localized by the client.
rF c f \ rS rSrSr " S S\R 5 r\R " SSSS9r Sr
g )
%GoogleRpcStatus.DetailsValueListEntryi zA DetailsValueListEntry object.
Messages:
AdditionalProperty: An additional property for a DetailsValueListEntry
object.
Fields:
additionalProperties: Properties of the object. Contains field @type
with type URL.
c b \ rS rSrSr\R " S5 r\R " SS5 r Sr
g)8GoogleRpcStatus.DetailsValueListEntry.AdditionalPropertyi zAn additional property for a DetailsValueListEntry object.
Fields:
key: Name of the additional property.
value: A extra_types.JsonValue attribute.
r r r
r NrN r r r! rQ rM s,
! !! $c$$%" to include in api
requests.
uploadType: Legacy upload protocol for media (e.g. "media", "multipart").
upload_protocol: Upload protocol for media (e.g. "raw", "multipart").
c $ \ rS rSrSrSrSrSrSrg)*StandardQueryParameters.AltValueValuesEnumi zData format for response.
Values:
json: Responses with Content-Type of application/json
media: Media download with context-dependent Content-Type
proto: Responses with Content-Type of application/x-protobuf
r r r
r N) r r r r r jsonmediaprotor r r r! AltValueValuesEnumrY s
D
E
Er r] c \ rS rSrSrSrSrSrg)-StandardQueryParameters.FXgafvValueValuesEnumi& zFV1 error format.
Values:
_1: v1 error format
_2: v2 error format
r r r N)r r r r r _1_2r r r r! FXgafvValueValuesEnumr_ & s
B
Br rb r r
r rZ )defaultr r rY rZ r[ Tr\ r r r r N)r r r r r r r] r] rb r_ f__xgafvr access_tokenaltcallbackfieldsrO oauth_tokenr prettyPrint quotaUsertrace
uploadTypeupload_protocolr r r r! rW rW s 4
9>>
inn
!8!
<(&&q), 0!VD#
"
"1
%( #& a #%%a(+&&q$7+##A&)
#%$$R(* ))"-/r rW rd z$.xgafvr` 1ra 2N),r
__future__r apitools.base.protorpcliter r apitools.base.pyr r packagerU r r# rM rz r r r r r rX r r r r r r r r r r r r r, r r5 r r= r rW rW AddCustomJsonFieldMappingAddCustomJsonEnumMappingrb r r r! rw s
' < % ( !!'i6G6G !'HI])BSBS I]X:AZcZkZk :AzEAARAR EAPg9;L;L g,"&yGXGX "&J #y?P?P #
))BSBS
)"9CTCT "6=y?P?P ="=iN_N_ =&KA @Q@Q KA\GBi>O>O GBT@A\e\m\m @AF2AYbYjYj 2Aj]Ay?P?P ]A@Wyi>O>O WytYA @Q@Q YAx]yGXGX ]-S HYHY -S`%Y . . %: = 1 1 =D9"** 9"xKG )) KG\F@)++ F@RJ) )) J)Z
)I - -
)0%i'' 0%f!#Y&& !#H<.i / / <.~ " "Z4 ! !114> ! !114>r