/*
 * Copyright 2026 Google LLC
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
// Generated by the protocol buffer compiler.  DO NOT EDIT!
// NO CHECKED-IN PROTOBUF GENCODE
// source: google/iam/v3/policy_binding_resources.proto
// Protobuf Java Version: 4.33.2

package com.google.iam.v3;

@com.google.protobuf.Generated
public interface PolicyBindingOrBuilder
    extends
    // @@protoc_insertion_point(interface_extends:google.iam.v3.PolicyBinding)
    com.google.protobuf.MessageOrBuilder {

  /**
   *
   *
   * <pre>
   * Identifier. The name of the policy binding, in the format
   * `{binding_parent/locations/{location}/policyBindings/{policy_binding_id}`.
   * The binding parent is the closest Resource Manager resource (project,
   * folder, or organization) to the binding target.
   *
   * Format:
   *
   * * `projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}`
   * * `projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}`
   * * `folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}`
   * * `organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}`
   * </pre>
   *
   * <code>string name = 1 [(.google.api.field_behavior) = IDENTIFIER];</code>
   *
   * @return The name.
   */
  java.lang.String getName();

  /**
   *
   *
   * <pre>
   * Identifier. The name of the policy binding, in the format
   * `{binding_parent/locations/{location}/policyBindings/{policy_binding_id}`.
   * The binding parent is the closest Resource Manager resource (project,
   * folder, or organization) to the binding target.
   *
   * Format:
   *
   * * `projects/{project_id}/locations/{location}/policyBindings/{policy_binding_id}`
   * * `projects/{project_number}/locations/{location}/policyBindings/{policy_binding_id}`
   * * `folders/{folder_id}/locations/{location}/policyBindings/{policy_binding_id}`
   * * `organizations/{organization_id}/locations/{location}/policyBindings/{policy_binding_id}`
   * </pre>
   *
   * <code>string name = 1 [(.google.api.field_behavior) = IDENTIFIER];</code>
   *
   * @return The bytes for name.
   */
  com.google.protobuf.ByteString getNameBytes();

  /**
   *
   *
   * <pre>
   * Output only. The globally unique ID of the policy binding. Assigned when
   * the policy binding is created.
   * </pre>
   *
   * <code>
   * string uid = 2 [(.google.api.field_behavior) = OUTPUT_ONLY, (.google.api.field_info) = { ... }
   * </code>
   *
   * @return The uid.
   */
  java.lang.String getUid();

  /**
   *
   *
   * <pre>
   * Output only. The globally unique ID of the policy binding. Assigned when
   * the policy binding is created.
   * </pre>
   *
   * <code>
   * string uid = 2 [(.google.api.field_behavior) = OUTPUT_ONLY, (.google.api.field_info) = { ... }
   * </code>
   *
   * @return The bytes for uid.
   */
  com.google.protobuf.ByteString getUidBytes();

  /**
   *
   *
   * <pre>
   * Optional. The etag for the policy binding.
   * If this is provided on update, it must match the server's etag.
   * </pre>
   *
   * <code>string etag = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return The etag.
   */
  java.lang.String getEtag();

  /**
   *
   *
   * <pre>
   * Optional. The etag for the policy binding.
   * If this is provided on update, it must match the server's etag.
   * </pre>
   *
   * <code>string etag = 3 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return The bytes for etag.
   */
  com.google.protobuf.ByteString getEtagBytes();

  /**
   *
   *
   * <pre>
   * Optional. The description of the policy binding. Must be less than or equal
   * to 63 characters.
   * </pre>
   *
   * <code>string display_name = 4 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return The displayName.
   */
  java.lang.String getDisplayName();

  /**
   *
   *
   * <pre>
   * Optional. The description of the policy binding. Must be less than or equal
   * to 63 characters.
   * </pre>
   *
   * <code>string display_name = 4 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return The bytes for displayName.
   */
  com.google.protobuf.ByteString getDisplayNameBytes();

  /**
   *
   *
   * <pre>
   * Optional. User-defined annotations. See
   * https://google.aip.dev/148#annotations for more details such as format and
   * size limitations
   * </pre>
   *
   * <code>map&lt;string, string&gt; annotations = 5 [(.google.api.field_behavior) = OPTIONAL];
   * </code>
   */
  int getAnnotationsCount();

  /**
   *
   *
   * <pre>
   * Optional. User-defined annotations. See
   * https://google.aip.dev/148#annotations for more details such as format and
   * size limitations
   * </pre>
   *
   * <code>map&lt;string, string&gt; annotations = 5 [(.google.api.field_behavior) = OPTIONAL];
   * </code>
   */
  boolean containsAnnotations(java.lang.String key);

  /** Use {@link #getAnnotationsMap()} instead. */
  @java.lang.Deprecated
  java.util.Map<java.lang.String, java.lang.String> getAnnotations();

  /**
   *
   *
   * <pre>
   * Optional. User-defined annotations. See
   * https://google.aip.dev/148#annotations for more details such as format and
   * size limitations
   * </pre>
   *
   * <code>map&lt;string, string&gt; annotations = 5 [(.google.api.field_behavior) = OPTIONAL];
   * </code>
   */
  java.util.Map<java.lang.String, java.lang.String> getAnnotationsMap();

  /**
   *
   *
   * <pre>
   * Optional. User-defined annotations. See
   * https://google.aip.dev/148#annotations for more details such as format and
   * size limitations
   * </pre>
   *
   * <code>map&lt;string, string&gt; annotations = 5 [(.google.api.field_behavior) = OPTIONAL];
   * </code>
   */
  /* nullable */
  java.lang.String getAnnotationsOrDefault(
      java.lang.String key,
      /* nullable */
      java.lang.String defaultValue);

  /**
   *
   *
   * <pre>
   * Optional. User-defined annotations. See
   * https://google.aip.dev/148#annotations for more details such as format and
   * size limitations
   * </pre>
   *
   * <code>map&lt;string, string&gt; annotations = 5 [(.google.api.field_behavior) = OPTIONAL];
   * </code>
   */
  java.lang.String getAnnotationsOrThrow(java.lang.String key);

  /**
   *
   *
   * <pre>
   * Required. Immutable. Target is the full resource name of the resource to
   * which the policy will be bound. Immutable once set.
   * </pre>
   *
   * <code>
   * .google.iam.v3.PolicyBinding.Target target = 6 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED];
   * </code>
   *
   * @return Whether the target field is set.
   */
  boolean hasTarget();

  /**
   *
   *
   * <pre>
   * Required. Immutable. Target is the full resource name of the resource to
   * which the policy will be bound. Immutable once set.
   * </pre>
   *
   * <code>
   * .google.iam.v3.PolicyBinding.Target target = 6 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED];
   * </code>
   *
   * @return The target.
   */
  com.google.iam.v3.PolicyBinding.Target getTarget();

  /**
   *
   *
   * <pre>
   * Required. Immutable. Target is the full resource name of the resource to
   * which the policy will be bound. Immutable once set.
   * </pre>
   *
   * <code>
   * .google.iam.v3.PolicyBinding.Target target = 6 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED];
   * </code>
   */
  com.google.iam.v3.PolicyBinding.TargetOrBuilder getTargetOrBuilder();

  /**
   *
   *
   * <pre>
   * Immutable. The kind of the policy to attach in this binding. This field
   * must be one of the following:
   *
   * - Left empty (will be automatically set to the policy kind)
   * - The input policy kind
   * </pre>
   *
   * <code>
   * .google.iam.v3.PolicyBinding.PolicyKind policy_kind = 11 [(.google.api.field_behavior) = IMMUTABLE];
   * </code>
   *
   * @return The enum numeric value on the wire for policyKind.
   */
  int getPolicyKindValue();

  /**
   *
   *
   * <pre>
   * Immutable. The kind of the policy to attach in this binding. This field
   * must be one of the following:
   *
   * - Left empty (will be automatically set to the policy kind)
   * - The input policy kind
   * </pre>
   *
   * <code>
   * .google.iam.v3.PolicyBinding.PolicyKind policy_kind = 11 [(.google.api.field_behavior) = IMMUTABLE];
   * </code>
   *
   * @return The policyKind.
   */
  com.google.iam.v3.PolicyBinding.PolicyKind getPolicyKind();

  /**
   *
   *
   * <pre>
   * Required. Immutable. The resource name of the policy to be bound. The
   * binding parent and policy must belong to the same organization.
   * </pre>
   *
   * <code>
   * string policy = 7 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED];
   * </code>
   *
   * @return The policy.
   */
  java.lang.String getPolicy();

  /**
   *
   *
   * <pre>
   * Required. Immutable. The resource name of the policy to be bound. The
   * binding parent and policy must belong to the same organization.
   * </pre>
   *
   * <code>
   * string policy = 7 [(.google.api.field_behavior) = IMMUTABLE, (.google.api.field_behavior) = REQUIRED];
   * </code>
   *
   * @return The bytes for policy.
   */
  com.google.protobuf.ByteString getPolicyBytes();

  /**
   *
   *
   * <pre>
   * Output only. The globally unique ID of the policy to be bound.
   * </pre>
   *
   * <code>string policy_uid = 12 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
   *
   * @return The policyUid.
   */
  java.lang.String getPolicyUid();

  /**
   *
   *
   * <pre>
   * Output only. The globally unique ID of the policy to be bound.
   * </pre>
   *
   * <code>string policy_uid = 12 [(.google.api.field_behavior) = OUTPUT_ONLY];</code>
   *
   * @return The bytes for policyUid.
   */
  com.google.protobuf.ByteString getPolicyUidBytes();

  /**
   *
   *
   * <pre>
   * Optional. The condition to apply to the policy binding. When set, the
   * `expression` field in the `Expr` must include from 1 to 10 subexpressions,
   * joined by the
   * "||"(Logical OR), "&amp;&amp;"(Logical AND) or "!"(Logical NOT) operators and
   * cannot contain more than 250 characters.
   *
   * The condition is currently only supported when bound to policies of kind
   * principal access boundary.
   *
   * When the bound policy is a principal access boundary policy, the only
   * supported attributes in any subexpression are `principal.type` and
   * `principal.subject`. An example expression is: "principal.type ==
   * 'iam.googleapis.com/ServiceAccount'" or "principal.subject ==
   * 'bob&#64;example.com'".
   *
   * Allowed operations for `principal.subject`:
   *
   * - `principal.subject == &lt;principal subject string&gt;`
   * - `principal.subject != &lt;principal subject string&gt;`
   * - `principal.subject in [&lt;list of principal subjects&gt;]`
   * - `principal.subject.startsWith(&lt;string&gt;)`
   * - `principal.subject.endsWith(&lt;string&gt;)`
   *
   * Allowed operations for `principal.type`:
   *
   * - `principal.type == &lt;principal type string&gt;`
   * - `principal.type != &lt;principal type string&gt;`
   * - `principal.type in [&lt;list of principal types&gt;]`
   *
   * Supported principal types are Workspace, Workforce Pool, Workload Pool and
   * Service Account. Allowed string must be one of:
   *
   * - iam.googleapis.com/WorkspaceIdentity
   * - iam.googleapis.com/WorkforcePoolIdentity
   * - iam.googleapis.com/WorkloadPoolIdentity
   * - iam.googleapis.com/ServiceAccount
   * </pre>
   *
   * <code>.google.type.Expr condition = 8 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return Whether the condition field is set.
   */
  boolean hasCondition();

  /**
   *
   *
   * <pre>
   * Optional. The condition to apply to the policy binding. When set, the
   * `expression` field in the `Expr` must include from 1 to 10 subexpressions,
   * joined by the
   * "||"(Logical OR), "&amp;&amp;"(Logical AND) or "!"(Logical NOT) operators and
   * cannot contain more than 250 characters.
   *
   * The condition is currently only supported when bound to policies of kind
   * principal access boundary.
   *
   * When the bound policy is a principal access boundary policy, the only
   * supported attributes in any subexpression are `principal.type` and
   * `principal.subject`. An example expression is: "principal.type ==
   * 'iam.googleapis.com/ServiceAccount'" or "principal.subject ==
   * 'bob&#64;example.com'".
   *
   * Allowed operations for `principal.subject`:
   *
   * - `principal.subject == &lt;principal subject string&gt;`
   * - `principal.subject != &lt;principal subject string&gt;`
   * - `principal.subject in [&lt;list of principal subjects&gt;]`
   * - `principal.subject.startsWith(&lt;string&gt;)`
   * - `principal.subject.endsWith(&lt;string&gt;)`
   *
   * Allowed operations for `principal.type`:
   *
   * - `principal.type == &lt;principal type string&gt;`
   * - `principal.type != &lt;principal type string&gt;`
   * - `principal.type in [&lt;list of principal types&gt;]`
   *
   * Supported principal types are Workspace, Workforce Pool, Workload Pool and
   * Service Account. Allowed string must be one of:
   *
   * - iam.googleapis.com/WorkspaceIdentity
   * - iam.googleapis.com/WorkforcePoolIdentity
   * - iam.googleapis.com/WorkloadPoolIdentity
   * - iam.googleapis.com/ServiceAccount
   * </pre>
   *
   * <code>.google.type.Expr condition = 8 [(.google.api.field_behavior) = OPTIONAL];</code>
   *
   * @return The condition.
   */
  com.google.type.Expr getCondition();

  /**
   *
   *
   * <pre>
   * Optional. The condition to apply to the policy binding. When set, the
   * `expression` field in the `Expr` must include from 1 to 10 subexpressions,
   * joined by the
   * "||"(Logical OR), "&amp;&amp;"(Logical AND) or "!"(Logical NOT) operators and
   * cannot contain more than 250 characters.
   *
   * The condition is currently only supported when bound to policies of kind
   * principal access boundary.
   *
   * When the bound policy is a principal access boundary policy, the only
   * supported attributes in any subexpression are `principal.type` and
   * `principal.subject`. An example expression is: "principal.type ==
   * 'iam.googleapis.com/ServiceAccount'" or "principal.subject ==
   * 'bob&#64;example.com'".
   *
   * Allowed operations for `principal.subject`:
   *
   * - `principal.subject == &lt;principal subject string&gt;`
   * - `principal.subject != &lt;principal subject string&gt;`
   * - `principal.subject in [&lt;list of principal subjects&gt;]`
   * - `principal.subject.startsWith(&lt;string&gt;)`
   * - `principal.subject.endsWith(&lt;string&gt;)`
   *
   * Allowed operations for `principal.type`:
   *
   * - `principal.type == &lt;principal type string&gt;`
   * - `principal.type != &lt;principal type string&gt;`
   * - `principal.type in [&lt;list of principal types&gt;]`
   *
   * Supported principal types are Workspace, Workforce Pool, Workload Pool and
   * Service Account. Allowed string must be one of:
   *
   * - iam.googleapis.com/WorkspaceIdentity
   * - iam.googleapis.com/WorkforcePoolIdentity
   * - iam.googleapis.com/WorkloadPoolIdentity
   * - iam.googleapis.com/ServiceAccount
   * </pre>
   *
   * <code>.google.type.Expr condition = 8 [(.google.api.field_behavior) = OPTIONAL];</code>
   */
  com.google.type.ExprOrBuilder getConditionOrBuilder();

  /**
   *
   *
   * <pre>
   * Output only. The time when the policy binding was created.
   * </pre>
   *
   * <code>.google.protobuf.Timestamp create_time = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
   * </code>
   *
   * @return Whether the createTime field is set.
   */
  boolean hasCreateTime();

  /**
   *
   *
   * <pre>
   * Output only. The time when the policy binding was created.
   * </pre>
   *
   * <code>.google.protobuf.Timestamp create_time = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
   * </code>
   *
   * @return The createTime.
   */
  com.google.protobuf.Timestamp getCreateTime();

  /**
   *
   *
   * <pre>
   * Output only. The time when the policy binding was created.
   * </pre>
   *
   * <code>.google.protobuf.Timestamp create_time = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
   * </code>
   */
  com.google.protobuf.TimestampOrBuilder getCreateTimeOrBuilder();

  /**
   *
   *
   * <pre>
   * Output only. The time when the policy binding was most recently updated.
   * </pre>
   *
   * <code>.google.protobuf.Timestamp update_time = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];
   * </code>
   *
   * @return Whether the updateTime field is set.
   */
  boolean hasUpdateTime();

  /**
   *
   *
   * <pre>
   * Output only. The time when the policy binding was most recently updated.
   * </pre>
   *
   * <code>.google.protobuf.Timestamp update_time = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];
   * </code>
   *
   * @return The updateTime.
   */
  com.google.protobuf.Timestamp getUpdateTime();

  /**
   *
   *
   * <pre>
   * Output only. The time when the policy binding was most recently updated.
   * </pre>
   *
   * <code>.google.protobuf.Timestamp update_time = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];
   * </code>
   */
  com.google.protobuf.TimestampOrBuilder getUpdateTimeOrBuilder();
}
