# Analytics Hub V1beta1 API - Class Google::Iam::V1::Binding (v0.12.0)

0.12.0 (latest) 0.11.1 0.10.0 0.9.1 0.8.0 0.7.1 0.6.2 0.5.0 0.4.1 0.3.0 0.2.0 0.1.0 Reference documentation and code samples for the Analytics Hub V1beta1 API class Google::Iam::V1::Binding.

Associates `members`, or principals, with a `role`.

## Inherits

- Object

## Extended By

- Google::Protobuf::MessageExts::ClassMethods

## Includes

- Google::Protobuf::MessageExts

## Methods

### #condition

    def condition() -> ::Google::Type::Expr

**Returns**

- ([::Google::Type::Expr](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-bigquery-data_exchange-v1beta1/latest/Google-Type-Expr)) --- 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).

### #condition=

    def condition=(value) -> ::Google::Type::Expr

**Parameter**

- **value** ([::Google::Type::Expr](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-bigquery-data_exchange-v1beta1/latest/Google-Type-Expr)) --- 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).
**Returns**

- ([::Google::Type::Expr](https://docs.cloud.google.com/ruby/docs/reference/google-cloud-bigquery-data_exchange-v1beta1/latest/Google-Type-Expr)) --- 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

    def members() -> ::Array<::String>

**Returns**

- (::Array\<::String\>) --- 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.

  - `user:{emailid}`: An email address that represents a specific Google
    account. For example, `alice@example.com` .

  - `serviceAccount:{emailid}`: An email address that represents a service
    account. For example, `my-other-app@appspot.gserviceaccount.com`.

  - `group:{emailid}`: An email address that represents a Google group.
    For example, `admins@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.

  - `domain:{domain}`: The G Suite domain (primary) that represents all the
    users of that domain. For example, `google.com` or `example.com`.

### #members=

    def members=(value) -> ::Array<::String>

**Parameter**

- **value** (::Array\<::String\>) ---

  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.

  - `user:{emailid}`: An email address that represents a specific Google
    account. For example, `alice@example.com` .

  - `serviceAccount:{emailid}`: An email address that represents a service
    account. For example, `my-other-app@appspot.gserviceaccount.com`.

  - `group:{emailid}`: An email address that represents a Google group.
    For example, `admins@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.

  - `domain:{domain}`: The G Suite domain (primary) that represents all the
    users of that domain. For example, `google.com` or `example.com`.

**Returns**

- (::Array\<::String\>) --- 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.

  - `user:{emailid}`: An email address that represents a specific Google
    account. For example, `alice@example.com` .

  - `serviceAccount:{emailid}`: An email address that represents a service
    account. For example, `my-other-app@appspot.gserviceaccount.com`.

  - `group:{emailid}`: An email address that represents a Google group.
    For example, `admins@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.

  - `domain:{domain}`: The G Suite domain (primary) that represents all the
    users of that domain. For example, `google.com` or `example.com`.

### #role

    def role() -> ::String

**Returns**

- (::String) --- Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.

### #role=

    def role=(value) -> ::String

**Parameter**

- **value** (::String) --- Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
**Returns**

- (::String) --- Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`.