google_api_cloud_run v0.15.0 GoogleApi.CloudRun.V1alpha1.Model.Policy View Source
Defines an Identity and Access Management (IAM) policy. It is used to specify access control policies for Cloud Platform resources.
A Policy
consists of a list of bindings
. A binding
binds a list of
members
to a role
, where the members can be user accounts, Google groups,
Google domains, and service accounts. A role
is a named list of permissions
defined by IAM.
JSON Example
{
"bindings": [
{
"role": "roles/owner",
"members": [
"user:mike@example.com",
"group:admins@example.com",
"domain:google.com",
"serviceAccount:my-other-app@appspot.gserviceaccount.com"
]
},
{
"role": "roles/viewer",
"members": ["user:sean@example.com"]
}
]
}
YAML Example
bindings:
- members:
- user:mike@example.com
- group:admins@example.com
- domain:google.com
- serviceAccount:my-other-app@appspot.gserviceaccount.com
role: roles/owner
- members:
- user:sean@example.com
role: roles/viewer
For a description of IAM and its features, see the IAM developer's guide.
Attributes
auditConfigs
(type:list(GoogleApi.CloudRun.V1alpha1.Model.AuditConfig.t)
, default:nil
) - Specifies cloud audit logging configuration for this policy.bindings
(type:list(GoogleApi.CloudRun.V1alpha1.Model.Binding.t)
, default:nil
) - Associates a list ofmembers
to arole
.bindings
with no members will result in an error.etag
(type:String.t
, default:nil
) -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 theetag
in the read-modify-write cycle to perform policy updates in order to avoid race conditions: Anetag
is returned in the response togetIamPolicy
, and systems are expected to put that etag in the request tosetIamPolicy
to ensure that their change will be applied to the same version of the policy.If no
etag
is provided in the call tosetIamPolicy
, then the existing policy is overwritten.version
(type:integer()
, default:nil
) - Specifies the format of the policy.Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected.
Policies with any conditional bindings must specify version 3. Policies without any conditional bindings may specify any valid value or leave the field unset.
Link to this section Summary
Functions
Unwrap a decoded JSON object into its complex fields.
Link to this section Types
t()
View Sourcet() :: %GoogleApi.CloudRun.V1alpha1.Model.Policy{ auditConfigs: [GoogleApi.CloudRun.V1alpha1.Model.AuditConfig.t()], bindings: [GoogleApi.CloudRun.V1alpha1.Model.Binding.t()], etag: String.t(), version: integer() }
Link to this section Functions
Unwrap a decoded JSON object into its complex fields.