google-cloud-build-v1 0.2.0 → 0.6.0

data/lib/google/cloud/build/v1/cloud_build/paths.rb

@@ -47,7 +47,7 @@ module Google
             # @return [::String]
             def build_path **args
               resources = {
-                "build:project"          => (proc do |project:, build:|
+                "build:project" => (proc do |project:, build:|
                   raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
 
                   "projects/#{project}/builds/#{build}"
@@ -82,6 +82,27 @@ module Google
               "projects/#{project}/triggers/#{trigger}"
             end
 
+            ##
+            # Create a fully-qualified CryptoKey resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/keyRings/{keyring}/cryptoKeys/{key}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param keyring [String]
+            # @param key [String]
+            #
+            # @return [::String]
+            def crypto_key_path project:, location:, keyring:, key:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+              raise ::ArgumentError, "keyring cannot contain /" if keyring.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/keyRings/#{keyring}/cryptoKeys/#{key}"
+            end
+
             ##
             # Create a fully-qualified Location resource string.
             #
@@ -113,6 +134,25 @@ module Google
               "projects/#{project}"
             end
 
+            ##
+            # Create a fully-qualified SecretVersion resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/secrets/{secret}/versions/{version}`
+            #
+            # @param project [String]
+            # @param secret [String]
+            # @param version [String]
+            #
+            # @return [::String]
+            def secret_version_path project:, secret:, version:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "secret cannot contain /" if secret.to_s.include? "/"
+
+              "projects/#{project}/secrets/#{secret}/versions/#{version}"
+            end
+
             ##
             # Create a fully-qualified ServiceAccount resource string.
             #
@@ -130,6 +170,40 @@ module Google
               "projects/#{project}/serviceAccounts/#{service_account}"
             end
 
+            ##
+            # Create a fully-qualified Subscription resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/subscriptions/{subscription}`
+            #
+            # @param project [String]
+            # @param subscription [String]
+            #
+            # @return [::String]
+            def subscription_path project:, subscription:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/subscriptions/#{subscription}"
+            end
+
+            ##
+            # Create a fully-qualified Topic resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/topics/{topic}`
+            #
+            # @param project [String]
+            # @param topic [String]
+            #
+            # @return [::String]
+            def topic_path project:, topic:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+              "projects/#{project}/topics/#{topic}"
+            end
+
             extend self
           end
         end

data/lib/google/cloud/build/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Build
       module V1
-        VERSION = "0.2.0"
+        VERSION = "0.6.0"
       end
     end
   end

data/lib/google/devtools/cloudbuild/v1/cloudbuild_pb.rb

@@ -6,6 +6,7 @@ require 'google/protobuf'
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
+require 'google/api/httpbody_pb'
 require 'google/api/resource_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/duration_pb'
@@ -109,6 +110,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :secrets, :message, 32, "google.devtools.cloudbuild.v1.Secret"
       map :timing, :string, :message, 33, "google.devtools.cloudbuild.v1.TimeSpan"
       optional :service_account, :string, 42
+      optional :available_secrets, :message, 47, "google.devtools.cloudbuild.v1.Secrets"
     end
     add_enum "google.devtools.cloudbuild.v1.Build.Status" do
       value :STATUS_UNKNOWN, 0
@@ -154,6 +156,18 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :SHA256, 1
       value :MD5, 2
     end
+    add_message "google.devtools.cloudbuild.v1.Secrets" do
+      repeated :secret_manager, :message, 1, "google.devtools.cloudbuild.v1.SecretManagerSecret"
+      repeated :inline, :message, 2, "google.devtools.cloudbuild.v1.InlineSecret"
+    end
+    add_message "google.devtools.cloudbuild.v1.InlineSecret" do
+      optional :kms_key_name, :string, 1
+      map :env_map, :string, :bytes, 2
+    end
+    add_message "google.devtools.cloudbuild.v1.SecretManagerSecret" do
+      optional :version_name, :string, 1
+      optional :env, :string, 2
+    end
     add_message "google.devtools.cloudbuild.v1.Secret" do
       optional :kms_key_name, :string, 1
       map :secret_env, :string, :bytes, 3
@@ -191,11 +205,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :tags, :string, 19
       optional :trigger_template, :message, 7, "google.devtools.cloudbuild.v1.RepoSource"
       optional :github, :message, 13, "google.devtools.cloudbuild.v1.GitHubEventsConfig"
+      optional :pubsub_config, :message, 29, "google.devtools.cloudbuild.v1.PubsubConfig"
       optional :create_time, :message, 5, "google.protobuf.Timestamp"
       optional :disabled, :bool, 9
       map :substitutions, :string, :string, 11
       repeated :ignored_files, :string, 15
       repeated :included_files, :string, 16
+      optional :filter, :string, 30
       oneof :build_template do
         optional :build, :message, 4, "google.devtools.cloudbuild.v1.Build"
         optional :filename, :string, 8
@@ -210,6 +226,19 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
         optional :push, :message, 5, "google.devtools.cloudbuild.v1.PushFilter"
       end
     end
+    add_message "google.devtools.cloudbuild.v1.PubsubConfig" do
+      optional :subscription, :string, 1
+      optional :topic, :string, 2
+      optional :service_account_email, :string, 3
+      optional :state, :enum, 4, "google.devtools.cloudbuild.v1.PubsubConfig.State"
+    end
+    add_enum "google.devtools.cloudbuild.v1.PubsubConfig.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :OK, 1
+      value :SUBSCRIPTION_DELETED, 2
+      value :TOPIC_DELETED, 3
+      value :SUBSCRIPTION_MISCONFIGURED, 4
+    end
     add_message "google.devtools.cloudbuild.v1.PullRequestFilter" do
       optional :comment_control, :enum, 5, "google.devtools.cloudbuild.v1.PullRequestFilter.CommentControl"
       optional :invert_regex, :bool, 6
@@ -220,6 +249,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_enum "google.devtools.cloudbuild.v1.PullRequestFilter.CommentControl" do
       value :COMMENTS_DISABLED, 0
       value :COMMENTS_ENABLED, 1
+      value :COMMENTS_ENABLED_FOR_EXTERNAL_CONTRIBUTORS_ONLY, 2
     end
     add_message "google.devtools.cloudbuild.v1.PushFilter" do
       optional :invert_regex, :bool, 4
@@ -276,6 +306,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :UNSPECIFIED, 0
       value :N1_HIGHCPU_8, 1
       value :N1_HIGHCPU_32, 2
+      value :E2_HIGHCPU_8, 5
+      value :E2_HIGHCPU_32, 6
     end
     add_enum "google.devtools.cloudbuild.v1.BuildOptions.SubstitutionOption" do
       value :MUST_MATCH, 0
@@ -294,6 +326,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :CLOUD_LOGGING_ONLY, 5
       value :NONE, 4
     end
+    add_message "google.devtools.cloudbuild.v1.ReceiveTriggerWebhookRequest" do
+      optional :body, :message, 1, "google.api.HttpBody"
+      optional :project_id, :string, 2
+      optional :trigger, :string, 3
+      optional :secret, :string, 4
+    end
+    add_message "google.devtools.cloudbuild.v1.ReceiveTriggerWebhookResponse" do
+    end
     add_message "google.devtools.cloudbuild.v1.WorkerPool" do
       optional :name, :string, 14
       optional :project_id, :string, 2
@@ -378,6 +418,9 @@ module Google
         FileHashes = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.FileHashes").msgclass
         Hash = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Hash").msgclass
         Hash::HashType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Hash.HashType").enummodule
+        Secrets = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Secrets").msgclass
+        InlineSecret = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.InlineSecret").msgclass
+        SecretManagerSecret = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.SecretManagerSecret").msgclass
         Secret = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.Secret").msgclass
         CreateBuildRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.CreateBuildRequest").msgclass
         GetBuildRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.GetBuildRequest").msgclass
@@ -386,6 +429,8 @@ module Google
         CancelBuildRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.CancelBuildRequest").msgclass
         BuildTrigger = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildTrigger").msgclass
         GitHubEventsConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.GitHubEventsConfig").msgclass
+        PubsubConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PubsubConfig").msgclass
+        PubsubConfig::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PubsubConfig.State").enummodule
         PullRequestFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PullRequestFilter").msgclass
         PullRequestFilter::CommentControl = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PullRequestFilter.CommentControl").enummodule
         PushFilter = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.PushFilter").msgclass
@@ -401,6 +446,8 @@ module Google
         BuildOptions::SubstitutionOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions.SubstitutionOption").enummodule
         BuildOptions::LogStreamingOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions.LogStreamingOption").enummodule
         BuildOptions::LoggingMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.BuildOptions.LoggingMode").enummodule
+        ReceiveTriggerWebhookRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.ReceiveTriggerWebhookRequest").msgclass
+        ReceiveTriggerWebhookResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.ReceiveTriggerWebhookResponse").msgclass
         WorkerPool = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerPool").msgclass
         WorkerPool::Region = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerPool.Region").enummodule
         WorkerPool::Status = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.devtools.cloudbuild.v1.WorkerPool.Status").enummodule

data/lib/google/devtools/cloudbuild/v1/cloudbuild_services_pb.rb

@@ -45,19 +45,19 @@ module Google
             # This method returns a long-running `Operation`, which includes the build
             # ID. Pass the build ID to `GetBuild` to determine the build status (such as
             # `SUCCESS` or `FAILURE`).
-            rpc :CreateBuild, Google::Cloud::Build::V1::CreateBuildRequest, Google::Longrunning::Operation
+            rpc :CreateBuild, ::Google::Cloud::Build::V1::CreateBuildRequest, ::Google::Longrunning::Operation
             # Returns information about a previously requested build.
             #
             # The `Build` that is returned includes its status (such as `SUCCESS`,
             # `FAILURE`, or `WORKING`), and timing information.
-            rpc :GetBuild, Google::Cloud::Build::V1::GetBuildRequest, Google::Cloud::Build::V1::Build
+            rpc :GetBuild, ::Google::Cloud::Build::V1::GetBuildRequest, ::Google::Cloud::Build::V1::Build
             # Lists previously requested builds.
             #
             # Previously requested builds may still be in-progress, or may have finished
             # successfully or unsuccessfully.
-            rpc :ListBuilds, Google::Cloud::Build::V1::ListBuildsRequest, Google::Cloud::Build::V1::ListBuildsResponse
+            rpc :ListBuilds, ::Google::Cloud::Build::V1::ListBuildsRequest, ::Google::Cloud::Build::V1::ListBuildsResponse
             # Cancels a build in progress.
-            rpc :CancelBuild, Google::Cloud::Build::V1::CancelBuildRequest, Google::Cloud::Build::V1::Build
+            rpc :CancelBuild, ::Google::Cloud::Build::V1::CancelBuildRequest, ::Google::Cloud::Build::V1::Build
             # Creates a new build based on the specified build.
             #
             # This method creates a new build using the original build request, which may
@@ -85,49 +85,52 @@ module Google
             # generation of the object, the new build will attempt to use the same
             # object, which may or may not be available depending on the bucket's
             # lifecycle management settings.
-            rpc :RetryBuild, Google::Cloud::Build::V1::RetryBuildRequest, Google::Longrunning::Operation
+            rpc :RetryBuild, ::Google::Cloud::Build::V1::RetryBuildRequest, ::Google::Longrunning::Operation
             # Creates a new `BuildTrigger`.
             #
             # This API is experimental.
-            rpc :CreateBuildTrigger, Google::Cloud::Build::V1::CreateBuildTriggerRequest, Google::Cloud::Build::V1::BuildTrigger
+            rpc :CreateBuildTrigger, ::Google::Cloud::Build::V1::CreateBuildTriggerRequest, ::Google::Cloud::Build::V1::BuildTrigger
             # Returns information about a `BuildTrigger`.
             #
             # This API is experimental.
-            rpc :GetBuildTrigger, Google::Cloud::Build::V1::GetBuildTriggerRequest, Google::Cloud::Build::V1::BuildTrigger
+            rpc :GetBuildTrigger, ::Google::Cloud::Build::V1::GetBuildTriggerRequest, ::Google::Cloud::Build::V1::BuildTrigger
             # Lists existing `BuildTrigger`s.
             #
             # This API is experimental.
-            rpc :ListBuildTriggers, Google::Cloud::Build::V1::ListBuildTriggersRequest, Google::Cloud::Build::V1::ListBuildTriggersResponse
+            rpc :ListBuildTriggers, ::Google::Cloud::Build::V1::ListBuildTriggersRequest, ::Google::Cloud::Build::V1::ListBuildTriggersResponse
             # Deletes a `BuildTrigger` by its project ID and trigger ID.
             #
             # This API is experimental.
-            rpc :DeleteBuildTrigger, Google::Cloud::Build::V1::DeleteBuildTriggerRequest, Google::Protobuf::Empty
+            rpc :DeleteBuildTrigger, ::Google::Cloud::Build::V1::DeleteBuildTriggerRequest, ::Google::Protobuf::Empty
             # Updates a `BuildTrigger` by its project ID and trigger ID.
             #
             # This API is experimental.
-            rpc :UpdateBuildTrigger, Google::Cloud::Build::V1::UpdateBuildTriggerRequest, Google::Cloud::Build::V1::BuildTrigger
+            rpc :UpdateBuildTrigger, ::Google::Cloud::Build::V1::UpdateBuildTriggerRequest, ::Google::Cloud::Build::V1::BuildTrigger
             # Runs a `BuildTrigger` at a particular source revision.
-            rpc :RunBuildTrigger, Google::Cloud::Build::V1::RunBuildTriggerRequest, Google::Longrunning::Operation
+            rpc :RunBuildTrigger, ::Google::Cloud::Build::V1::RunBuildTriggerRequest, ::Google::Longrunning::Operation
+            # ReceiveTriggerWebhook [Experimental] is called when the API receives a
+            # webhook request targeted at a specific trigger.
+            rpc :ReceiveTriggerWebhook, ::Google::Cloud::Build::V1::ReceiveTriggerWebhookRequest, ::Google::Cloud::Build::V1::ReceiveTriggerWebhookResponse
             # Creates a `WorkerPool` to run the builds, and returns the new worker pool.
             #
             # This API is experimental.
-            rpc :CreateWorkerPool, Google::Cloud::Build::V1::CreateWorkerPoolRequest, Google::Cloud::Build::V1::WorkerPool
+            rpc :CreateWorkerPool, ::Google::Cloud::Build::V1::CreateWorkerPoolRequest, ::Google::Cloud::Build::V1::WorkerPool
             # Returns information about a `WorkerPool`.
             #
             # This API is experimental.
-            rpc :GetWorkerPool, Google::Cloud::Build::V1::GetWorkerPoolRequest, Google::Cloud::Build::V1::WorkerPool
+            rpc :GetWorkerPool, ::Google::Cloud::Build::V1::GetWorkerPoolRequest, ::Google::Cloud::Build::V1::WorkerPool
             # Deletes a `WorkerPool` by its project ID and WorkerPool name.
             #
             # This API is experimental.
-            rpc :DeleteWorkerPool, Google::Cloud::Build::V1::DeleteWorkerPoolRequest, Google::Protobuf::Empty
+            rpc :DeleteWorkerPool, ::Google::Cloud::Build::V1::DeleteWorkerPoolRequest, ::Google::Protobuf::Empty
             # Update a `WorkerPool`.
             #
             # This API is experimental.
-            rpc :UpdateWorkerPool, Google::Cloud::Build::V1::UpdateWorkerPoolRequest, Google::Cloud::Build::V1::WorkerPool
+            rpc :UpdateWorkerPool, ::Google::Cloud::Build::V1::UpdateWorkerPoolRequest, ::Google::Cloud::Build::V1::WorkerPool
             # List project's `WorkerPools`.
             #
             # This API is experimental.
-            rpc :ListWorkerPools, Google::Cloud::Build::V1::ListWorkerPoolsRequest, Google::Cloud::Build::V1::ListWorkerPoolsResponse
+            rpc :ListWorkerPools, ::Google::Cloud::Build::V1::ListWorkerPoolsRequest, ::Google::Cloud::Build::V1::ListWorkerPoolsResponse
           end
 
           Stub = Service.rpc_stub_class

data/proto_docs/google/api/field_behavior.rb

@@ -54,6 +54,12 @@ module Google
       # This indicates that the field may be set once in a request to create a
       # resource, but may not be changed thereafter.
       IMMUTABLE = 5
+
+      # Denotes that a (repeated) field is an unordered list.
+      # This indicates that the service may provide the elements of the list
+      # in any arbitrary order, rather than the order the user originally
+      # provided. Additionally, the list's order may or may not be stable.
+      UNORDERED_LIST = 6
     end
   end
 end

data/proto_docs/google/api/httpbody.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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 Api
+    # Message that represents an arbitrary HTTP body. It should only be used for
+    # payload formats that can't be represented as JSON, such as raw binary or
+    # an HTML page.
+    #
+    #
+    # This message can be used both in streaming and non-streaming API methods in
+    # the request as well as the response.
+    #
+    # It can be used as a top-level request field, which is convenient if one
+    # wants to extract parameters from either the URL or HTTP template into the
+    # request fields and also want access to the raw HTTP body.
+    #
+    # Example:
+    #
+    #     message GetResourceRequest {
+    #       // A unique request id.
+    #       string request_id = 1;
+    #
+    #       // The raw HTTP body is bound to this field.
+    #       google.api.HttpBody http_body = 2;
+    #     }
+    #
+    #     service ResourceService {
+    #       rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
+    #       rpc UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty);
+    #     }
+    #
+    # Example with streaming methods:
+    #
+    #     service CaldavService {
+    #       rpc GetCalendar(stream google.api.HttpBody)
+    #         returns (stream google.api.HttpBody);
+    #       rpc UpdateCalendar(stream google.api.HttpBody)
+    #         returns (stream google.api.HttpBody);
+    #     }
+    #
+    # Use of this type only changes how the request and response bodies are
+    # handled, all other features will continue to work unchanged.
+    # @!attribute [rw] content_type
+    #   @return [::String]
+    #     The HTTP Content-Type string representing the content type of the body.
+    # @!attribute [rw] data
+    #   @return [::String]
+    #     HTTP body binary data.
+    # @!attribute [rw] extensions
+    #   @return [::Array<::Google::Protobuf::Any>]
+    #     Application specific response metadata. Must be set in the first response
+    #     for streaming APIs.
+    class HttpBody
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/api/resource.rb

@@ -43,12 +43,12 @@ module Google
     #
     # The ResourceDescriptor Yaml config will look like:
     #
-    #    resources:
-    #    - type: "pubsub.googleapis.com/Topic"
-    #      name_descriptor:
-    #        - pattern: "projects/\\{project}/topics/\\{topic}"
-    #          parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #          parent_name_extractor: "projects/\\{project}"
+    #     resources:
+    #     - type: "pubsub.googleapis.com/Topic"
+    #       name_descriptor:
+    #         - pattern: "projects/{project}/topics/{topic}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
     #         }
     # @!attribute [rw] plural
     #   @return [::String]
-    #     The plural name used in the resource name, such as 'projects' for
-    #     the name of 'projects/\\{project}'. It is the same concept of the `plural`
-    #     field in k8s CRD spec
+    #     The plural name used in the resource name and permission names, such as
+    #     'projects' for the resource name of 'projects/\\{project}' and the permission
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
+    #     concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    #
+    #     Note: The plural form is required even for singleton resources. See
+    #     https://aip.dev/156
     # @!attribute [rw] singular
     #   @return [::String]
     #     The same concept of the `singular` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
+    # @!attribute [rw] style
+    #   @return [::Array<::Google::Api::ResourceDescriptor::Style>]
+    #     Style flag(s) for this resource.
+    #     These indicate that a resource is expected to conform to a given
+    #     style. See the specific style flags for additional information.
     class ResourceDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
         # that from being necessary once there are multiple patterns.)
         FUTURE_MULTI_PATTERN = 2
       end
+
+      # A flag representing a specific style that a resource claims to conform to.
+      module Style
+        # The unspecified value. Do not use.
+        STYLE_UNSPECIFIED = 0
+
+        # This resource is intended to be "declarative-friendly".
+        #
+        # Declarative-friendly resources must be more strictly consistent, and
+        # setting this to true communicates to tools that this resource should
+        # adhere to declarative-friendly expectations.
+        #
+        # Note: This is used by the API linter (linter.aip.dev) to enable
+        # additional checks.
+        DECLARATIVE_FRIENDLY = 1
+      end
     end
 
     # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
     #             type: "pubsub.googleapis.com/Topic"
     #           }];
     #         }
+    #
+    #     Occasionally, a field may reference an arbitrary resource. In this case,
+    #     APIs use the special value * in their resource reference.
+    #
+    #     Example:
+    #
+    #         message GetIamPolicyRequest {
+    #           string resource = 2 [(google.api.resource_reference) = {
+    #             type: "*"
+    #           }];
+    #         }
     # @!attribute [rw] child_type
     #   @return [::String]
     #     The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
     #
     #     Example:
     #
-    #       message ListLogEntriesRequest {
-    #         string parent = 1 [(google.api.resource_reference) = {
-    #           child_type: "logging.googleapis.com/LogEntry"
-    #         };
-    #       }
+    #         message ListLogEntriesRequest {
+    #           string parent = 1 [(google.api.resource_reference) = {
+    #             child_type: "logging.googleapis.com/LogEntry"
+    #           };
+    #         }
     class ResourceReference
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods