google-cloud-deploy-v1 0.1.1 → 0.2.0

data/lib/google/cloud/deploy/v1/cloud_deploy/operations.rb

@@ -143,6 +143,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::ListOperationsRequest.new
+            #
+            #   # Call the list_operations method.
+            #   result = client.list_operations request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Longrunning::Operation.
+            #     p response
+            #   end
+            #
             def list_operations request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -160,9 +181,11 @@ module Google
                 gapic_version: ::Google::Cloud::Deploy::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -215,6 +238,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::GetOperationRequest.new
+            #
+            #   # Call the get_operation method.
+            #   result = client.get_operation request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def get_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -232,9 +277,11 @@ module Google
                 gapic_version: ::Google::Cloud::Deploy::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -287,6 +334,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::DeleteOperationRequest.new
+            #
+            #   # Call the delete_operation method.
+            #   result = client.delete_operation request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -304,9 +366,11 @@ module Google
                 gapic_version: ::Google::Cloud::Deploy::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -364,6 +428,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::CancelOperationRequest.new
+            #
+            #   # Call the cancel_operation method.
+            #   result = client.cancel_operation request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def cancel_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -381,9 +460,11 @@ module Google
                 gapic_version: ::Google::Cloud::Deploy::V1::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
@@ -444,6 +525,28 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/longrunning"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Longrunning::Operations::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Longrunning::WaitOperationRequest.new
+            #
+            #   # Call the wait_operation method.
+            #   result = client.wait_operation request
+            #
+            #   # The returned object is of type Gapic::Operation. You can use this
+            #   # object to check the status of an operation, cancel it, or wait
+            #   # for results. Here is how to block until completion:
+            #   result.wait_until_done! timeout: 60
+            #   if result.response?
+            #     p result.response
+            #   else
+            #     puts "Error!"
+            #   end
+            #
             def wait_operation request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/deploy/v1/cloud_deploy/paths.rb

@@ -115,6 +115,25 @@ module Google
               "projects/#{project}/locations/#{location}"
             end
 
+            ##
+            # Create a fully-qualified Membership resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `projects/{project}/locations/{location}/memberships/{membership}`
+            #
+            # @param project [String]
+            # @param location [String]
+            # @param membership [String]
+            #
+            # @return [::String]
+            def membership_path project:, location:, membership:
+              raise ::ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+              raise ::ArgumentError, "location cannot contain /" if location.to_s.include? "/"
+
+              "projects/#{project}/locations/#{location}/memberships/#{membership}"
+            end
+
             ##
             # Create a fully-qualified Release resource string.
             #

data/lib/google/cloud/deploy/v1/cloud_deploy_pb.rb

@@ -98,10 +98,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :execution_configs, :message, 16, "google.cloud.deploy.v1.ExecutionConfig"
       oneof :deployment_target do
         optional :gke, :message, 15, "google.cloud.deploy.v1.GkeCluster"
+        optional :anthos_cluster, :message, 17, "google.cloud.deploy.v1.AnthosCluster"
       end
     end
     add_message "google.cloud.deploy.v1.ExecutionConfig" do
       repeated :usages, :enum, 1, "google.cloud.deploy.v1.ExecutionConfig.ExecutionEnvironmentUsage"
+      optional :worker_pool, :string, 4
+      optional :service_account, :string, 5
+      optional :artifact_storage, :string, 6
       oneof :execution_environment do
         optional :default_pool, :message, 2, "google.cloud.deploy.v1.DefaultPool"
         optional :private_pool, :message, 3, "google.cloud.deploy.v1.PrivatePool"
@@ -123,6 +127,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.deploy.v1.GkeCluster" do
       optional :cluster, :string, 1
+      optional :internal_ip, :bool, 2
+    end
+    add_message "google.cloud.deploy.v1.AnthosCluster" do
+      optional :membership, :string, 1
     end
     add_message "google.cloud.deploy.v1.ListTargetsRequest" do
       optional :parent, :string, 1
@@ -183,6 +191,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.deploy.v1.Release.TargetRender" do
       optional :rendering_build, :string, 1
       optional :rendering_state, :enum, 2, "google.cloud.deploy.v1.Release.TargetRender.TargetRenderState"
+      optional :failure_cause, :enum, 4, "google.cloud.deploy.v1.Release.TargetRender.FailureCause"
     end
     add_enum "google.cloud.deploy.v1.Release.TargetRender.TargetRenderState" do
       value :TARGET_RENDER_STATE_UNSPECIFIED, 0
@@ -190,6 +199,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :FAILED, 2
       value :IN_PROGRESS, 3
     end
+    add_enum "google.cloud.deploy.v1.Release.TargetRender.FailureCause" do
+      value :FAILURE_CAUSE_UNSPECIFIED, 0
+      value :CLOUD_BUILD_UNAVAILABLE, 1
+      value :EXECUTION_FAILED, 2
+    end
     add_enum "google.cloud.deploy.v1.Release.RenderState" do
       value :RENDER_STATE_UNSPECIFIED, 0
       value :SUCCEEDED, 1
@@ -246,6 +260,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :failure_reason, :string, 14
       optional :deploying_build, :string, 17
       optional :etag, :string, 16
+      optional :deploy_failure_cause, :enum, 19, "google.cloud.deploy.v1.Rollout.FailureCause"
     end
     add_enum "google.cloud.deploy.v1.Rollout.ApprovalState" do
       value :APPROVAL_STATE_UNSPECIFIED, 0
@@ -264,6 +279,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :PENDING, 6
       value :PENDING_RELEASE, 7
     end
+    add_enum "google.cloud.deploy.v1.Rollout.FailureCause" do
+      value :FAILURE_CAUSE_UNSPECIFIED, 0
+      value :CLOUD_BUILD_UNAVAILABLE, 1
+      value :EXECUTION_FAILED, 2
+      value :DEADLINE_EXCEEDED, 3
+      value :RELEASE_FAILED, 4
+    end
     add_message "google.cloud.deploy.v1.ListRolloutsRequest" do
       optional :parent, :string, 1
       optional :page_size, :int32, 2
@@ -338,6 +360,7 @@ module Google
         DefaultPool = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.DefaultPool").msgclass
         PrivatePool = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.PrivatePool").msgclass
         GkeCluster = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.GkeCluster").msgclass
+        AnthosCluster = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.AnthosCluster").msgclass
         ListTargetsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.ListTargetsRequest").msgclass
         ListTargetsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.ListTargetsResponse").msgclass
         GetTargetRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.GetTargetRequest").msgclass
@@ -347,6 +370,7 @@ module Google
         Release = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.Release").msgclass
         Release::TargetRender = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.Release.TargetRender").msgclass
         Release::TargetRender::TargetRenderState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.Release.TargetRender.TargetRenderState").enummodule
+        Release::TargetRender::FailureCause = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.Release.TargetRender.FailureCause").enummodule
         Release::RenderState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.Release.RenderState").enummodule
         BuildArtifact = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.BuildArtifact").msgclass
         TargetArtifact = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.TargetArtifact").msgclass
@@ -357,6 +381,7 @@ module Google
         Rollout = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.Rollout").msgclass
         Rollout::ApprovalState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.Rollout.ApprovalState").enummodule
         Rollout::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.Rollout.State").enummodule
+        Rollout::FailureCause = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.Rollout.FailureCause").enummodule
         ListRolloutsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.ListRolloutsRequest").msgclass
         ListRolloutsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.ListRolloutsResponse").msgclass
         GetRolloutRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.GetRolloutRequest").msgclass

data/lib/google/cloud/deploy/v1/deliverypipeline_notification_payload_pb.rb

@@ -0,0 +1,25 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/deploy/v1/deliverypipeline_notification_payload.proto
+
+require 'google/cloud/deploy/v1/log_enums_pb'
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/deploy/v1/deliverypipeline_notification_payload.proto", :syntax => :proto3) do
+    add_message "google.cloud.deploy.v1.DeliveryPipelineNotificationEvent" do
+      optional :message, :string, 1
+      optional :delivery_pipeline, :string, 2
+      optional :type, :enum, 3, "google.cloud.deploy.v1.Type"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Deploy
+      module V1
+        DeliveryPipelineNotificationEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.DeliveryPipelineNotificationEvent").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/deploy/v1/log_enums_pb.rb

@@ -0,0 +1,24 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/deploy/v1/log_enums.proto
+
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/deploy/v1/log_enums.proto", :syntax => :proto3) do
+    add_enum "google.cloud.deploy.v1.Type" do
+      value :TYPE_UNSPECIFIED, 0
+      value :TYPE_PUBSUB_NOTIFICATION_FAILURE, 1
+      value :TYPE_RENDER_STATUES_CHANGE, 2
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Deploy
+      module V1
+        Type = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.Type").enummodule
+      end
+    end
+  end
+end

data/lib/google/cloud/deploy/v1/release_notification_payload_pb.rb

@@ -0,0 +1,25 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/deploy/v1/release_notification_payload.proto
+
+require 'google/cloud/deploy/v1/log_enums_pb'
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/deploy/v1/release_notification_payload.proto", :syntax => :proto3) do
+    add_message "google.cloud.deploy.v1.ReleaseNotificationEvent" do
+      optional :message, :string, 1
+      optional :release, :string, 2
+      optional :type, :enum, 3, "google.cloud.deploy.v1.Type"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Deploy
+      module V1
+        ReleaseNotificationEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.ReleaseNotificationEvent").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/deploy/v1/release_render_payload_pb.rb

@@ -0,0 +1,23 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/deploy/v1/release_render_payload.proto
+
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/deploy/v1/release_render_payload.proto", :syntax => :proto3) do
+    add_message "google.cloud.deploy.v1.ReleaseRenderEvent" do
+      optional :message, :string, 1
+      optional :release, :string, 2
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Deploy
+      module V1
+        ReleaseRenderEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.ReleaseRenderEvent").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/deploy/v1/rollout_notification_payload_pb.rb

@@ -0,0 +1,28 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/deploy/v1/rollout_notification_payload.proto
+
+require 'google/cloud/deploy/v1/log_enums_pb'
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/deploy/v1/rollout_notification_payload.proto", :syntax => :proto3) do
+    add_message "google.cloud.deploy.v1.RolloutNotificationEvent" do
+      optional :message, :string, 1
+      optional :pipeline_uid, :string, 2
+      optional :release_uid, :string, 3
+      optional :rollout, :string, 4
+      optional :type, :enum, 5, "google.cloud.deploy.v1.Type"
+      optional :target_id, :string, 6
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Deploy
+      module V1
+        RolloutNotificationEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.RolloutNotificationEvent").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/deploy/v1/target_notification_payload_pb.rb

@@ -0,0 +1,25 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/deploy/v1/target_notification_payload.proto
+
+require 'google/cloud/deploy/v1/log_enums_pb'
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/deploy/v1/target_notification_payload.proto", :syntax => :proto3) do
+    add_message "google.cloud.deploy.v1.TargetNotificationEvent" do
+      optional :message, :string, 1
+      optional :target, :string, 2
+      optional :type, :enum, 3, "google.cloud.deploy.v1.Type"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Deploy
+      module V1
+        TargetNotificationEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.deploy.v1.TargetNotificationEvent").msgclass
+      end
+    end
+  end
+end

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Deploy
       module V1
-        VERSION = "0.1.1"
+        VERSION = "0.2.0"
       end
     end
   end

data/lib/google/cloud/deploy/v1.rb

@@ -25,6 +25,8 @@ module Google
       ##
       # To load this package, including all its services, and instantiate a client:
       #
+      # @example
+      #
       #     require "google/cloud/deploy/v1"
       #     client = ::Google::Cloud::Deploy::V1::CloudDeploy::Client.new
       #

data/proto_docs/google/api/resource.rb

@@ -33,11 +33,7 @@ module Google
     #       // For Kubernetes resources, the format is {api group}/{kind}.
     #       option (google.api.resource) = {
     #         type: "pubsub.googleapis.com/Topic"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
+    #         pattern: "projects/{project}/topics/{topic}"
     #       };
     #     }
     #
@@ -45,10 +41,7 @@ module Google
     #
     #     resources:
     #     - type: "pubsub.googleapis.com/Topic"
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/topics/{topic}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
+    #       pattern: "projects/{project}/topics/{topic}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
     #     message LogEntry {
     #       option (google.api.resource) = {
     #         type: "logging.googleapis.com/LogEntry"
-    #         name_descriptor: {
-    #           pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #         }
+    #         pattern: "projects/{project}/logs/{log}"
+    #         pattern: "folders/{folder}/logs/{log}"
+    #         pattern: "organizations/{organization}/logs/{log}"
+    #         pattern: "billingAccounts/{billing_account}/logs/{log}"
     #       };
     #     }
     #
@@ -85,48 +62,10 @@ module Google
     #
     #     resources:
     #     - type: 'logging.googleapis.com/LogEntry'
-    #       name_descriptor:
-    #         - pattern: "projects/{project}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #           parent_name_extractor: "projects/{project}"
-    #         - pattern: "folders/{folder}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #           parent_name_extractor: "folders/{folder}"
-    #         - pattern: "organizations/{organization}/logs/{log}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Organization"
-    #           parent_name_extractor: "organizations/{organization}"
-    #         - pattern: "billingAccounts/{billing_account}/logs/{log}"
-    #           parent_type: "billing.googleapis.com/BillingAccount"
-    #           parent_name_extractor: "billingAccounts/{billing_account}"
-    #
-    # For flexible resources, the resource name doesn't contain parent names, but
-    # the resource itself has parents for policy evaluation.
-    #
-    # Example:
-    #
-    #     message Shelf {
-    #       option (google.api.resource) = {
-    #         type: "library.googleapis.com/Shelf"
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         }
-    #         name_descriptor: {
-    #           pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
-    #         }
-    #       };
-    #     }
-    #
-    # The ResourceDescriptor Yaml config will look like:
-    #
-    #     resources:
-    #     - type: 'library.googleapis.com/Shelf'
-    #       name_descriptor:
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #         - pattern: "shelves/{shelf}"
-    #           parent_type: "cloudresourcemanager.googleapis.com/Folder"
+    #       pattern: "projects/{project}/logs/{log}"
+    #       pattern: "folders/{folder}/logs/{log}"
+    #       pattern: "organizations/{organization}/logs/{log}"
+    #       pattern: "billingAccounts/{billing_account}/logs/{log}"
     # @!attribute [rw] type
     #   @return [::String]
     #     The resource type. It must be in the format of