google-cloud-run-v2 0.1.0

data/proto_docs/google/cloud/run/v2/service.rb

@@ -0,0 +1,307 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Run
+      module V2
+        # Request message for creating a Service.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The location and project in which this service should be created.
+        #     Format: projects/\\{projectnumber}/locations/\\{location}
+        # @!attribute [rw] service
+        #   @return [::Google::Cloud::Run::V2::Service]
+        #     Required. The Service instance to create.
+        # @!attribute [rw] service_id
+        #   @return [::String]
+        #     Required. The unique identifier for the Service. The name of the service becomes
+        #     \\{parent}/services/\\{service_id}.
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Indicates that the request should be validated and default values
+        #     populated, without persisting the request or creating any resources.
+        class CreateServiceRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for updating a service.
+        # @!attribute [rw] service
+        #   @return [::Google::Cloud::Run::V2::Service]
+        #     Required. The Service to be updated.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The list of fields to be updated.
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Indicates that the request should be validated and default values
+        #     populated, without persisting the request or updating any resources.
+        # @!attribute [rw] allow_missing
+        #   @return [::Boolean]
+        #     If set to true, and if the Service does not exist, it will create a new
+        #     one. Caller must have both create and update permissions for this call if
+        #     this is set to true.
+        class UpdateServiceRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for retrieving a list of Services.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The location and project to list resources on.
+        #     Location must be a valid GCP region, and may not be the "-" wildcard.
+        #     Format: projects/\\{projectnumber}/locations/\\{location}
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Maximum number of Services to return in this call.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     A page token received from a previous call to ListServices.
+        #     All other parameters must match.
+        # @!attribute [rw] show_deleted
+        #   @return [::Boolean]
+        #     If true, returns deleted (but unexpired) resources along with active ones.
+        class ListServicesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message containing a list of Services.
+        # @!attribute [rw] services
+        #   @return [::Array<::Google::Cloud::Run::V2::Service>]
+        #     The resulting list of Services.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token indicating there are more items than page_size. Use it in the next
+        #     ListServices request to continue.
+        class ListServicesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for obtaining a Service by its full name.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The full name of the Service.
+        #     Format: projects/\\{projectnumber}/locations/\\{location}/services/\\{service}
+        class GetServiceRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message to delete a Service by its full name.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The full name of the Service.
+        #     Format: projects/\\{projectnumber}/locations/\\{location}/services/\\{service}
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Indicates that the request should be validated without actually
+        #     deleting any resources.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     A system-generated fingerprint for this version of the
+        #     resource. May be used to detect modification conflict during updates.
+        class DeleteServiceRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Service acts as a top-level container that manages a set of
+        # configurations and revision templates which implement a network service.
+        # Service exists to provide a singular abstraction which can be access
+        # controlled, reasoned about, and which encapsulates software lifecycle
+        # decisions such as rollout policy and team resource ownership.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The fully qualified name of this Service. In CreateServiceRequest, this
+        #     field is ignored, and instead composed from CreateServiceRequest.parent and
+        #     CreateServiceRequest.service_id.
+        #
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}/services/\\{service_id}
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     User-provided description of the Service. This field currently has a
+        #     512-character limit.
+        # @!attribute [r] uid
+        #   @return [::String]
+        #     Output only. Server assigned unique identifier for the trigger. The value is a UUID4
+        #     string and guaranteed to remain unchanged until the resource is deleted.
+        # @!attribute [r] generation
+        #   @return [::Integer]
+        #     Output only. A number that monotonically increases every time the user
+        #     modifies the desired state.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Map of string keys and values that can be used to organize and categorize
+        #     objects.
+        #     User-provided labels are shared with Google's billing system, so they can
+        #     be used to filter, or break down billing charges by team, component,
+        #     environment, state, etc. For more information, visit
+        #     https://cloud.google.com/resource-manager/docs/creating-managing-labels or
+        #     https://cloud.google.com/run/docs/configuring/labels
+        #     Cloud Run will populate some labels with 'run.googleapis.com' or
+        #     'serving.knative.dev' namespaces. Those labels are read-only, and user
+        #     changes will not be preserved.
+        # @!attribute [rw] annotations
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Unstructured key value map that may be set by external tools to store and
+        #     arbitrary metadata. They are not queryable and should be preserved
+        #     when modifying objects. Cloud Run will populate some annotations using
+        #     'run.googleapis.com' or 'serving.knative.dev' namespaces. This field
+        #     follows Kubernetes annotations' namespacing, limits, and rules. More info:
+        #     https://kubernetes.io/docs/user-guide/annotations
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The creation time.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The last-modified time.
+        # @!attribute [r] delete_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The deletion time.
+        # @!attribute [r] expire_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. For a deleted resource, the time after which it will be
+        #     permamently deleted.
+        # @!attribute [r] creator
+        #   @return [::String]
+        #     Output only. Email address of the authenticated creator.
+        # @!attribute [r] last_modifier
+        #   @return [::String]
+        #     Output only. Email address of the last authenticated modifier.
+        # @!attribute [rw] client
+        #   @return [::String]
+        #     Arbitrary identifier for the API client.
+        # @!attribute [rw] client_version
+        #   @return [::String]
+        #     Arbitrary version identifier for the API client.
+        # @!attribute [rw] ingress
+        #   @return [::Google::Cloud::Run::V2::IngressTraffic]
+        #     Provides the ingress settings for this Service. On output, returns the
+        #     currently observed ingress settings, or INGRESS_TRAFFIC_UNSPECIFIED if no
+        #     revision is active.
+        # @!attribute [rw] launch_stage
+        #   @return [::Google::Api::LaunchStage]
+        #     The launch stage as defined by [Google Cloud Platform
+        #     Launch Stages](https://cloud.google.com/terms/launch-stages).
+        #     Cloud Run supports `ALPHA`, `BETA`, and `GA`. If no value is specified, GA
+        #     is assumed.
+        # @!attribute [rw] binary_authorization
+        #   @return [::Google::Cloud::Run::V2::BinaryAuthorization]
+        #     Settings for the Binary Authorization feature.
+        # @!attribute [rw] template
+        #   @return [::Google::Cloud::Run::V2::RevisionTemplate]
+        #     Required. The template used to create revisions for this Service.
+        # @!attribute [rw] traffic
+        #   @return [::Array<::Google::Cloud::Run::V2::TrafficTarget>]
+        #     Specifies how to distribute traffic over a collection of Revisions
+        #     belonging to the Service. If traffic is empty or not provided, defaults to
+        #     100% traffic to the latest `Ready` Revision.
+        # @!attribute [r] observed_generation
+        #   @return [::Integer]
+        #     Output only. The generation of this Service currently serving traffic. See comments in
+        #     `reconciling` for additional information on reconciliation process in Cloud
+        #     Run.
+        # @!attribute [r] terminal_condition
+        #   @return [::Google::Cloud::Run::V2::Condition]
+        #     Output only. The Condition of this Service, containing its readiness status, and
+        #     detailed error information in case it did not reach a serving state. See
+        #     comments in `reconciling` for additional information on reconciliation
+        #     process in Cloud Run.
+        # @!attribute [r] conditions
+        #   @return [::Array<::Google::Cloud::Run::V2::Condition>]
+        #     Output only. The Conditions of all other associated sub-resources. They contain
+        #     additional diagnostics information in case the Service does not reach its
+        #     Serving state. See comments in `reconciling` for additional information on
+        #     reconciliation process in Cloud Run.
+        # @!attribute [r] latest_ready_revision
+        #   @return [::String]
+        #     Output only. Name of the latest revision that is serving traffic. See comments in
+        #     `reconciling` for additional information on reconciliation process in Cloud
+        #     Run.
+        # @!attribute [r] latest_created_revision
+        #   @return [::String]
+        #     Output only. Name of the last created revision. See comments in `reconciling` for
+        #     additional information on reconciliation process in Cloud Run.
+        # @!attribute [r] traffic_statuses
+        #   @return [::Array<::Google::Cloud::Run::V2::TrafficTargetStatus>]
+        #     Output only. Detailed status information for corresponding traffic targets. See comments
+        #     in `reconciling` for additional information on reconciliation process in
+        #     Cloud Run.
+        # @!attribute [r] uri
+        #   @return [::String]
+        #     Output only. The main URI in which this Service is serving traffic.
+        # @!attribute [r] reconciling
+        #   @return [::Boolean]
+        #     Output only. Returns true if the Service is currently being acted upon by the system to
+        #     bring it into the desired state.
+        #
+        #     When a new Service is created, or an existing one is updated, Cloud Run
+        #     will asynchronously perform all necessary steps to bring the Service to the
+        #     desired serving state. This process is called reconciliation.
+        #     While reconciliation is in process, `observed_generation`,
+        #     `latest_ready_revison`, `traffic_statuses`, and `uri` will have transient
+        #     values that might mismatch the intended state: Once reconciliation is over
+        #     (and this field is false), there are two possible outcomes: reconciliation
+        #     succeeded and the serving state matches the Service, or there was an error,
+        #     and reconciliation failed. This state can be found in
+        #     `terminal_condition.state`.
+        #
+        #     If reconciliation succeeded, the following fields will match: `traffic` and
+        #     `traffic_statuses`, `observed_generation` and `generation`,
+        #     `latest_ready_revision` and `latest_created_revision`.
+        #
+        #     If reconciliation failed, `traffic_statuses`, `observed_generation`, and
+        #     `latest_ready_revision` will have the state of the last serving revision,
+        #     or empty for newly created Services. Additional information on the failure
+        #     can be found in `terminal_condition` and `conditions`.
+        # @!attribute [r] etag
+        #   @return [::String]
+        #     Output only. A system-generated fingerprint for this version of the
+        #     resource. May be used to detect modification conflict during updates.
+        class Service
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class AnnotationsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/run/v2/traffic_target.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Run
+      module V2
+        # Holds a single traffic routing entry for the Service. Allocations can be done
+        # to a specific Revision name, or pointing to the latest Ready Revision.
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::Run::V2::TrafficTargetAllocationType]
+        #     The allocation type for this traffic target.
+        # @!attribute [rw] revision
+        #   @return [::String]
+        #     Revision to which to send this portion of traffic, if traffic allocation is
+        #     by revision.
+        # @!attribute [rw] percent
+        #   @return [::Integer]
+        #     Specifies percent of the traffic to this Revision.
+        #     This defaults to zero if unspecified.
+        # @!attribute [rw] tag
+        #   @return [::String]
+        #     Indicates a string to be part of the URI to exclusively reference this
+        #     target.
+        class TrafficTarget
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Represents the observed state of a single `TrafficTarget` entry.
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::Run::V2::TrafficTargetAllocationType]
+        #     The allocation type for this traffic target.
+        # @!attribute [rw] revision
+        #   @return [::String]
+        #     Revision to which this traffic is sent.
+        # @!attribute [rw] percent
+        #   @return [::Integer]
+        #     Specifies percent of the traffic to this Revision.
+        # @!attribute [rw] tag
+        #   @return [::String]
+        #     Indicates the string used in the URI to exclusively reference this target.
+        # @!attribute [rw] uri
+        #   @return [::String]
+        #     Displays the target URI.
+        class TrafficTargetStatus
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The type of instance allocation.
+        module TrafficTargetAllocationType
+          # Unspecified instance allocation type.
+          TRAFFIC_TARGET_ALLOCATION_TYPE_UNSPECIFIED = 0
+
+          # Allocates instances to the Service's latest ready Revision.
+          TRAFFIC_TARGET_ALLOCATION_TYPE_LATEST = 1
+
+          # Allocates instances to a Revision by name.
+          TRAFFIC_TARGET_ALLOCATION_TYPE_REVISION = 2
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/run/v2/vendor_settings.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Run
+      module V2
+        # VPC Access settings. For more information on creating a VPC Connector, visit
+        # https://cloud.google.com/vpc/docs/configure-serverless-vpc-access For
+        # information on how to configure Cloud Run with an existing VPC Connector,
+        # visit https://cloud.google.com/run/docs/configuring/connecting-vpc
+        # @!attribute [rw] connector
+        #   @return [::String]
+        #     VPC Access connector name.
+        #     Format: projects/\\{project}/locations/\\{location}/connectors/\\{connector}
+        # @!attribute [rw] egress
+        #   @return [::Google::Cloud::Run::V2::VpcAccess::VpcEgress]
+        #     Traffic VPC egress settings.
+        class VpcAccess
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Egress options for VPC access.
+          module VpcEgress
+            # Unspecified
+            VPC_EGRESS_UNSPECIFIED = 0
+
+            # All outbound traffic is routed through the VPC connector.
+            ALL_TRAFFIC = 1
+
+            # Only private IP ranges are routed through the VPC connector.
+            PRIVATE_RANGES_ONLY = 2
+          end
+        end
+
+        # Settings for Binary Authorization feature.
+        # @!attribute [rw] use_default
+        #   @return [::Boolean]
+        #     If True, indicates to use the default project's binary authorization
+        #     policy. If False, binary authorization will be disabled.
+        # @!attribute [rw] breakglass_justification
+        #   @return [::String]
+        #     If present, indicates to use Breakglass using this justification.
+        #     If use_default is False, then it must be empty.
+        #     For more information on breakglass, see
+        #     https://cloud.google.com/binary-authorization/docs/using-breakglass
+        class BinaryAuthorization
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Settings for revision-level scaling settings.
+        # @!attribute [rw] min_instance_count
+        #   @return [::Integer]
+        #     Minimum number of serving instances that this resource should have.
+        # @!attribute [rw] max_instance_count
+        #   @return [::Integer]
+        #     Maximum number of serving instances that this resource should have.
+        class RevisionScaling
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Allowed ingress traffic for the Container.
+        module IngressTraffic
+          # Unspecified
+          INGRESS_TRAFFIC_UNSPECIFIED = 0
+
+          # All inbound traffic is allowed.
+          INGRESS_TRAFFIC_ALL = 1
+
+          # Only internal traffic is allowed.
+          INGRESS_TRAFFIC_INTERNAL_ONLY = 2
+
+          # Both internal and Google Cloud Load Balancer traffic is allowed.
+          INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER = 3
+        end
+
+        # Alternatives for execution environments.
+        module ExecutionEnvironment
+          # Unspecified
+          EXECUTION_ENVIRONMENT_UNSPECIFIED = 0
+
+          # Uses the Google-default environment.
+          EXECUTION_ENVIRONMENT_DEFAULT = 1
+
+          # Uses Second Generation environment.
+          EXECUTION_ENVIRONMENT_GEN2 = 2
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/iam/v1/iam_policy.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Iam
+    module V1
+      # Request message for `SetIamPolicy` method.
+      # @!attribute [rw] resource
+      #   @return [::String]
+      #     REQUIRED: The resource for which the policy is being specified.
+      #     See the operation documentation for the appropriate value for this field.
+      # @!attribute [rw] policy
+      #   @return [::Google::Iam::V1::Policy]
+      #     REQUIRED: The complete policy to be applied to the `resource`. The size of
+      #     the policy is limited to a few 10s of KB. An empty policy is a
+      #     valid policy but certain Cloud Platform services (such as Projects)
+      #     might reject them.
+      # @!attribute [rw] update_mask
+      #   @return [::Google::Protobuf::FieldMask]
+      #     OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
+      #     the fields in the mask will be modified. If no mask is provided, the
+      #     following default mask is used:
+      #
+      #     `paths: "bindings, etag"`
+      class SetIamPolicyRequest
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # Request message for `GetIamPolicy` method.
+      # @!attribute [rw] resource
+      #   @return [::String]
+      #     REQUIRED: The resource for which the policy is being requested.
+      #     See the operation documentation for the appropriate value for this field.
+      # @!attribute [rw] options
+      #   @return [::Google::Iam::V1::GetPolicyOptions]
+      #     OPTIONAL: A `GetPolicyOptions` object for specifying options to
+      #     `GetIamPolicy`.
+      class GetIamPolicyRequest
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # Request message for `TestIamPermissions` method.
+      # @!attribute [rw] resource
+      #   @return [::String]
+      #     REQUIRED: The resource for which the policy detail is being requested.
+      #     See the operation documentation for the appropriate value for this field.
+      # @!attribute [rw] permissions
+      #   @return [::Array<::String>]
+      #     The set of permissions to check for the `resource`. Permissions with
+      #     wildcards (such as '*' or 'storage.*') are not allowed. For more
+      #     information see
+      #     [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+      class TestIamPermissionsRequest
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # Response message for `TestIamPermissions` method.
+      # @!attribute [rw] permissions
+      #   @return [::Array<::String>]
+      #     A subset of `TestPermissionsRequest.permissions` that the caller is
+      #     allowed.
+      class TestIamPermissionsResponse
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+    end
+  end
+end

data/proto_docs/google/iam/v1/options.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# Copyright 2022 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Iam
+    module V1
+      # Encapsulates settings provided to GetIamPolicy.
+      # @!attribute [rw] requested_policy_version
+      #   @return [::Integer]
+      #     Optional. The maximum policy version that will be used to format the
+      #     policy.
+      #
+      #     Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+      #     rejected.
+      #
+      #     Requests for policies with any conditional role bindings must specify
+      #     version 3. Policies with no conditional role bindings may specify any valid
+      #     value or leave the field unset.
+      #
+      #     The policy in the response might use the policy version that you specified,
+      #     or it might use a lower policy version. For example, if you specify version
+      #     3, but the policy has no conditional role bindings, the response uses
+      #     version 1.
+      #
+      #     To learn which resources support conditions in their IAM policies, see the
+      #     [IAM
+      #     documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+      class GetPolicyOptions
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+    end
+  end
+end