google-cloud-dataproc 0.5.1 → 0.6.0

data/lib/google/cloud/dataproc/v1/doc/google/cloud/dataproc/v1/jobs.rb

@@ -305,7 +305,7 @@ module Google
         #     Output only. A state message specifying the overall job state.
         # @!attribute [rw] details
         #   @return [String]
-        #     Output only. Optional job state details, such as an error
+        #     Optional. Output only. Job state details, such as an error
         #     description if the state is <code>ERROR</code>.
         # @!attribute [rw] state_start_time
         #   @return [Google::Protobuf::Timestamp]

data/lib/google/cloud/dataproc/v1/doc/google/cloud/dataproc/v1/workflow_templates.rb

@@ -20,16 +20,18 @@ module Google
         # A Cloud Dataproc workflow template resource.
         # @!attribute [rw] id
         #   @return [String]
-        #     Required. The template id.
-        #
-        #     The id must contain only letters (a-z, A-Z), numbers (0-9),
-        #     underscores (_), and hyphens (-). Cannot begin or end with underscore
-        #     or hyphen. Must consist of between 3 and 50 characters.
         # @!attribute [rw] name
         #   @return [String]
-        #     Output only. The "resource name" of the template, as described
-        #     in https://cloud.google.com/apis/design/resource_names of the form
-        #     `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+        #     Output only. The resource name of the workflow template, as described
+        #     in https://cloud.google.com/apis/design/resource_names.
+        #
+        #     * For `projects.regions.workflowTemplates`, the resource name of the
+        #       template has the following format:
+        #       `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+        #
+        #     * For `projects.locations.workflowTemplates`, the resource name of the
+        #       template has the following format:
+        #       `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
         # @!attribute [rw] version
         #   @return [Integer]
         #     Optional. Used to perform a consistent read-modify-write.
@@ -69,7 +71,7 @@ module Google
         #     Required. The Directed Acyclic Graph of Jobs to submit.
         # @!attribute [rw] parameters
         #   @return [Array<Google::Cloud::Dataproc::V1::TemplateParameter>]
-        #     Optional. Template parameters whose values are substituted into the
+        #     Optional. emplate parameters whose values are substituted into the
         #     template. Values for parameters must be provided when the template is
         #     instantiated.
         class WorkflowTemplate; end
@@ -79,7 +81,7 @@ module Google
         # Either `managed_cluster` or `cluster_selector` is required.
         # @!attribute [rw] managed_cluster
         #   @return [Google::Cloud::Dataproc::V1::ManagedCluster]
-        #     Optional. A cluster that is managed by the workflow.
+        #     A cluster that is managed by the workflow.
         # @!attribute [rw] cluster_selector
         #   @return [Google::Cloud::Dataproc::V1::ClusterSelector]
         #     Optional. A selector that chooses target cluster for jobs based
@@ -192,7 +194,7 @@ module Google
         # * Zone (in ClusterSelector)
         # @!attribute [rw] name
         #   @return [String]
-        #     Required.  Parameter name.
+        #     Required. Parameter name.
         #     The parameter name is used as the key, and paired with the
         #     parameter value, which are passed to the template when the template
         #     is instantiated.
@@ -280,7 +282,16 @@ module Google
         # A Cloud Dataproc workflow template resource.
         # @!attribute [rw] template
         #   @return [String]
-        #     Output only. The "resource name" of the template.
+        #     Output only. The resource name of the workflow template as described
+        #     in https://cloud.google.com/apis/design/resource_names.
+        #
+        #     * For `projects.regions.workflowTemplates`, the resource name of the
+        #       template has the following format:
+        #       `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+        #
+        #     * For `projects.locations.workflowTemplates`, the resource name of the
+        #       template has the following format:
+        #       `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
         # @!attribute [rw] version
         #   @return [Integer]
         #     Output only. The version of template at the time of
@@ -390,9 +401,16 @@ module Google
         # A request to create a workflow template.
         # @!attribute [rw] parent
         #   @return [String]
-        #     Required. The "resource name" of the region, as described
-        #     in https://cloud.google.com/apis/design/resource_names of the form
-        #     `projects/{project_id}/regions/{region}`
+        #     Required. The resource name of the region or location, as described
+        #     in https://cloud.google.com/apis/design/resource_names.
+        #
+        #     * For `projects.regions.workflowTemplates,create`, the resource name of the
+        #       region has the following format:
+        #       `projects/{project_id}/regions/{region}`
+        #
+        #     * For `projects.locations.workflowTemplates.create`, the resource name of
+        #       the location has the following format:
+        #       `projects/{project_id}/locations/{location}`
         # @!attribute [rw] template
         #   @return [Google::Cloud::Dataproc::V1::WorkflowTemplate]
         #     Required. The Dataproc workflow template to create.
@@ -401,13 +419,20 @@ module Google
         # A request to fetch a workflow template.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required. The "resource name" of the workflow template, as described
-        #     in https://cloud.google.com/apis/design/resource_names of the form
-        #     `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+        #     Required. The resource name of the workflow template, as described
+        #     in https://cloud.google.com/apis/design/resource_names.
+        #
+        #     * For `projects.regions.workflowTemplates.get`, the resource name of the
+        #       template has the following format:
+        #       `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+        #
+        #     * For `projects.locations.workflowTemplates.get`, the resource name of the
+        #       template has the following format:
+        #       `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
         # @!attribute [rw] version
         #   @return [Integer]
         #     Optional. The version of workflow template to retrieve. Only previously
-        #     instatiated versions can be retrieved.
+        #     instantiated versions can be retrieved.
         #
         #     If unspecified, retrieves the current version.
         class GetWorkflowTemplateRequest; end
@@ -415,9 +440,16 @@ module Google
         # A request to instantiate a workflow template.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required. The "resource name" of the workflow template, as described
-        #     in https://cloud.google.com/apis/design/resource_names of the form
-        #     `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+        #     Required. The resource name of the workflow template, as described
+        #     in https://cloud.google.com/apis/design/resource_names.
+        #
+        #     * For `projects.regions.workflowTemplates.instantiate`, the resource name
+        #       of the template has the following format:
+        #       `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+        #
+        #     * For `projects.locations.workflowTemplates.instantiate`, the resource name
+        #       of the template has the following format:
+        #       `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
         # @!attribute [rw] version
         #   @return [Integer]
         #     Optional. The version of workflow template to instantiate. If specified,
@@ -446,9 +478,16 @@ module Google
         # A request to instantiate an inline workflow template.
         # @!attribute [rw] parent
         #   @return [String]
-        #     Required. The "resource name" of the workflow template region, as described
-        #     in https://cloud.google.com/apis/design/resource_names of the form
-        #     `projects/{project_id}/regions/{region}`
+        #     Required. The resource name of the region or location, as described
+        #     in https://cloud.google.com/apis/design/resource_names.
+        #
+        #     * For `projects.regions.workflowTemplates,instantiateinline`, the resource
+        #       name of the region has the following format:
+        #       `projects/{project_id}/regions/{region}`
+        #
+        #     * For `projects.locations.workflowTemplates.instantiateinline`, the
+        #       resource name of the location has the following format:
+        #       `projects/{project_id}/locations/{location}`
         # @!attribute [rw] template
         #   @return [Google::Cloud::Dataproc::V1::WorkflowTemplate]
         #     Required. The workflow template to instantiate.
@@ -476,9 +515,16 @@ module Google
         # A request to list workflow templates in a project.
         # @!attribute [rw] parent
         #   @return [String]
-        #     Required. The "resource name" of the region, as described
-        #     in https://cloud.google.com/apis/design/resource_names of the form
-        #     `projects/{project_id}/regions/{region}`
+        #     Required. The resource name of the region or location, as described
+        #     in https://cloud.google.com/apis/design/resource_names.
+        #
+        #     * For `projects.regions.workflowTemplates,list`, the resource
+        #       name of the region has the following format:
+        #       `projects/{project_id}/regions/{region}`
+        #
+        #     * For `projects.locations.workflowTemplates.list`, the
+        #       resource name of the location has the following format:
+        #       `projects/{project_id}/locations/{location}`
         # @!attribute [rw] page_size
         #   @return [Integer]
         #     Optional. The maximum number of results to return in each response.
@@ -504,9 +550,16 @@ module Google
         # Currently started workflows will remain running.
         # @!attribute [rw] name
         #   @return [String]
-        #     Required. The "resource name" of the workflow template, as described
-        #     in https://cloud.google.com/apis/design/resource_names of the form
-        #     `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+        #     Required. The resource name of the workflow template, as described
+        #     in https://cloud.google.com/apis/design/resource_names.
+        #
+        #     * For `projects.regions.workflowTemplates.delete`, the resource name
+        #       of the template has the following format:
+        #       `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+        #
+        #     * For `projects.locations.workflowTemplates.instantiate`, the resource name
+        #       of the template has the following format:
+        #       `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
         # @!attribute [rw] version
         #   @return [Integer]
         #     Optional. The version of workflow template to delete. If specified,

data/lib/google/cloud/dataproc/v1/doc/google/protobuf/timestamp.rb

@@ -88,11 +88,13 @@ module Google
     # 01:30 UTC on January 15, 2017.
     #
     # In JavaScript, one can convert a Date object to this format using the
-    # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
+    # standard
+    # [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
     # method. In Python, a standard `datetime.datetime` object can be converted
-    # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
-    # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
-    # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
+    # to this format using
+    # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
+    # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
+    # the Joda Time's [`ISODateTimeFormat.dateTime()`](
     # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds

data/lib/google/cloud/dataproc/v1/jobs_pb.rb

@@ -5,6 +5,8 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'

data/lib/google/cloud/dataproc/v1/operations_pb.rb

@@ -4,8 +4,9 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
+require 'google/api/field_behavior_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.dataproc.v1.ClusterOperationStatus" do
     optional :state, :enum, 1, "google.cloud.dataproc.v1.ClusterOperationStatus.State"

data/lib/google/cloud/dataproc/v1/workflow_template_service_client.rb

@@ -295,9 +295,16 @@ module Google
           # Creates new workflow template.
           #
           # @param parent [String]
-          #   Required. The "resource name" of the region, as described
-          #   in https://cloud.google.com/apis/design/resource_names of the form
-          #   `projects/{project_id}/regions/{region}`
+          #   Required. The resource name of the region or location, as described
+          #   in https://cloud.google.com/apis/design/resource_names.
+          #
+          #   * For `projects.regions.workflowTemplates,create`, the resource name of the
+          #     region has the following format:
+          #     `projects/{project_id}/regions/{region}`
+          #
+          #   * For `projects.locations.workflowTemplates.create`, the resource name of
+          #     the location has the following format:
+          #     `projects/{project_id}/locations/{location}`
           # @param template [Google::Cloud::Dataproc::V1::WorkflowTemplate | Hash]
           #   Required. The Dataproc workflow template to create.
           #   A hash of the same form as `Google::Cloud::Dataproc::V1::WorkflowTemplate`
@@ -339,12 +346,19 @@ module Google
           # version parameter.
           #
           # @param name [String]
-          #   Required. The "resource name" of the workflow template, as described
-          #   in https://cloud.google.com/apis/design/resource_names of the form
-          #   `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+          #   Required. The resource name of the workflow template, as described
+          #   in https://cloud.google.com/apis/design/resource_names.
+          #
+          #   * For `projects.regions.workflowTemplates.get`, the resource name of the
+          #     template has the following format:
+          #     `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+          #
+          #   * For `projects.locations.workflowTemplates.get`, the resource name of the
+          #     template has the following format:
+          #     `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
           # @param version [Integer]
           #   Optional. The version of workflow template to retrieve. Only previously
-          #   instatiated versions can be retrieved.
+          #   instantiated versions can be retrieved.
           #
           #   If unspecified, retrieves the current version.
           # @param options [Google::Gax::CallOptions]
@@ -388,16 +402,25 @@ module Google
           # clusters to be deleted.
           #
           # The {Google::Longrunning::Operation#metadata Operation#metadata} will be
-          # {Google::Cloud::Dataproc::V1::WorkflowMetadata WorkflowMetadata}.
+          # [WorkflowMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata).
+          # Also see [Using
+          # WorkflowMetadata](/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).
           #
           # On successful completion,
           # {Google::Longrunning::Operation#response Operation#response} will be
           # {Google::Protobuf::Empty Empty}.
           #
           # @param name [String]
-          #   Required. The "resource name" of the workflow template, as described
-          #   in https://cloud.google.com/apis/design/resource_names of the form
-          #   `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+          #   Required. The resource name of the workflow template, as described
+          #   in https://cloud.google.com/apis/design/resource_names.
+          #
+          #   * For `projects.regions.workflowTemplates.instantiate`, the resource name
+          #     of the template has the following format:
+          #     `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+          #
+          #   * For `projects.locations.workflowTemplates.instantiate`, the resource name
+          #     of the template has the following format:
+          #     `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
           # @param version [Integer]
           #   Optional. The version of workflow template to instantiate. If specified,
           #   the workflow will be instantiated only if the current version of
@@ -497,16 +520,25 @@ module Google
           # clusters to be deleted.
           #
           # The {Google::Longrunning::Operation#metadata Operation#metadata} will be
-          # {Google::Cloud::Dataproc::V1::WorkflowMetadata WorkflowMetadata}.
+          # [WorkflowMetadata](https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata).
+          # Also see [Using
+          # WorkflowMetadata](/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).
           #
           # On successful completion,
           # {Google::Longrunning::Operation#response Operation#response} will be
           # {Google::Protobuf::Empty Empty}.
           #
           # @param parent [String]
-          #   Required. The "resource name" of the workflow template region, as described
-          #   in https://cloud.google.com/apis/design/resource_names of the form
-          #   `projects/{project_id}/regions/{region}`
+          #   Required. The resource name of the region or location, as described
+          #   in https://cloud.google.com/apis/design/resource_names.
+          #
+          #   * For `projects.regions.workflowTemplates,instantiateinline`, the resource
+          #     name of the region has the following format:
+          #     `projects/{project_id}/regions/{region}`
+          #
+          #   * For `projects.locations.workflowTemplates.instantiateinline`, the
+          #     resource name of the location has the following format:
+          #     `projects/{project_id}/locations/{location}`
           # @param template [Google::Cloud::Dataproc::V1::WorkflowTemplate | Hash]
           #   Required. The workflow template to instantiate.
           #   A hash of the same form as `Google::Cloud::Dataproc::V1::WorkflowTemplate`
@@ -624,9 +656,16 @@ module Google
           # Lists workflows that match the specified filter in the request.
           #
           # @param parent [String]
-          #   Required. The "resource name" of the region, as described
-          #   in https://cloud.google.com/apis/design/resource_names of the form
-          #   `projects/{project_id}/regions/{region}`
+          #   Required. The resource name of the region or location, as described
+          #   in https://cloud.google.com/apis/design/resource_names.
+          #
+          #   * For `projects.regions.workflowTemplates,list`, the resource
+          #     name of the region has the following format:
+          #     `projects/{project_id}/regions/{region}`
+          #
+          #   * For `projects.locations.workflowTemplates.list`, the
+          #     resource name of the location has the following format:
+          #     `projects/{project_id}/locations/{location}`
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -680,9 +719,16 @@ module Google
           # Deletes a workflow template. It does not cancel in-progress workflows.
           #
           # @param name [String]
-          #   Required. The "resource name" of the workflow template, as described
-          #   in https://cloud.google.com/apis/design/resource_names of the form
-          #   `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+          #   Required. The resource name of the workflow template, as described
+          #   in https://cloud.google.com/apis/design/resource_names.
+          #
+          #   * For `projects.regions.workflowTemplates.delete`, the resource name
+          #     of the template has the following format:
+          #     `projects/{project_id}/regions/{region}/workflowTemplates/{template_id}`
+          #
+          #   * For `projects.locations.workflowTemplates.instantiate`, the resource name
+          #     of the template has the following format:
+          #     `projects/{project_id}/locations/{location}/workflowTemplates/{template_id}`
           # @param version [Integer]
           #   Optional. The version of workflow template to delete. If specified,
           #   will only delete the template if the current server version matches

data/lib/google/cloud/dataproc/v1/workflow_templates_pb.rb

@@ -5,6 +5,9 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
 require 'google/cloud/dataproc/v1/clusters_pb'
 require 'google/cloud/dataproc/v1/jobs_pb'
 require 'google/longrunning/operations_pb'

data/lib/google/cloud/dataproc/v1/workflow_templates_services_pb.rb

@@ -56,7 +56,9 @@ module Google
             # clusters to be deleted.
             #
             # The [Operation.metadata][google.longrunning.Operation.metadata] will be
-            # [WorkflowMetadata][google.cloud.dataproc.v1.WorkflowMetadata].
+            # [WorkflowMetadata](/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata).
+            # Also see [Using
+            # WorkflowMetadata](/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).
             #
             # On successful completion,
             # [Operation.response][google.longrunning.Operation.response] will be
@@ -79,7 +81,9 @@ module Google
             # clusters to be deleted.
             #
             # The [Operation.metadata][google.longrunning.Operation.metadata] will be
-            # [WorkflowMetadata][google.cloud.dataproc.v1.WorkflowMetadata].
+            # [WorkflowMetadata](/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#workflowmetadata).
+            # Also see [Using
+            # WorkflowMetadata](/dataproc/docs/concepts/workflows/debugging#using_workflowmetadata).
             #
             # On successful completion,
             # [Operation.response][google.longrunning.Operation.response] will be

data/lib/google/cloud/dataproc/v1beta2/autoscaling_policies_pb.rb

@@ -5,12 +5,11 @@
 require 'google/protobuf'
 
 require 'google/api/annotations_pb'
-require 'google/cloud/dataproc/v1beta2/clusters_pb'
-require 'google/cloud/dataproc/v1beta2/jobs_pb'
-require 'google/longrunning/operations_pb'
+require 'google/api/client_pb'
+require 'google/api/field_behavior_pb'
+require 'google/api/resource_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
-require 'google/protobuf/timestamp_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.dataproc.v1beta2.AutoscalingPolicy" do
     optional :id, :string, 1

data/lib/google/cloud/dataproc/v1beta2/autoscaling_policy_service_client.rb

@@ -261,11 +261,18 @@ module Google
           # Creates new autoscaling policy.
           #
           # @param parent [String]
-          #   Required. The "resource name" of the region, as described
-          #   in https://cloud.google.com/apis/design/resource_names of the form
-          #   `projects/{project_id}/regions/{region}`.
+          #   Required. The "resource name" of the region or location, as described
+          #   in https://cloud.google.com/apis/design/resource_names.
+          #
+          #   * For `projects.regions.autoscalingPolicies.create`, the resource name
+          #     has the following format:
+          #     `projects/{project_id}/regions/{region}`
+          #
+          #   * For `projects.locations.autoscalingPolicies.create`, the resource name
+          #     has the following format:
+          #     `projects/{project_id}/locations/{location}`
           # @param policy [Google::Cloud::Dataproc::V1beta2::AutoscalingPolicy | Hash]
-          #   The autoscaling policy to create.
+          #   Required. The autoscaling policy to create.
           #   A hash of the same form as `Google::Cloud::Dataproc::V1beta2::AutoscalingPolicy`
           #   can also be provided.
           # @param options [Google::Gax::CallOptions]
@@ -340,8 +347,15 @@ module Google
           #
           # @param name [String]
           #   Required. The "resource name" of the autoscaling policy, as described
-          #   in https://cloud.google.com/apis/design/resource_names of the form
-          #   `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`.
+          #   in https://cloud.google.com/apis/design/resource_names.
+          #
+          #   * For `projects.regions.autoscalingPolicies.get`, the resource name
+          #     of the policy has the following format:
+          #     `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`
+          #
+          #   * For `projects.locations.autoscalingPolicies.get`, the resource name
+          #     of the policy has the following format:
+          #     `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.
@@ -371,9 +385,16 @@ module Google
           # Lists autoscaling policies in the project.
           #
           # @param parent [String]
-          #   Required. The "resource name" of the region, as described
-          #   in https://cloud.google.com/apis/design/resource_names of the form
-          #   `projects/{project_id}/regions/{region}`
+          #   Required. The "resource name" of the region or location, as described
+          #   in https://cloud.google.com/apis/design/resource_names.
+          #
+          #   * For `projects.regions.autoscalingPolicies.list`, the resource name
+          #     of the region has the following format:
+          #     `projects/{project_id}/regions/{region}`
+          #
+          #   * For `projects.locations.autoscalingPolicies.list`, the resource name
+          #     of the location has the following format:
+          #     `projects/{project_id}/locations/{location}`
           # @param page_size [Integer]
           #   The maximum number of resources contained in the underlying API
           #   response. If page streaming is performed per-resource, this
@@ -429,8 +450,15 @@ module Google
           #
           # @param name [String]
           #   Required. The "resource name" of the autoscaling policy, as described
-          #   in https://cloud.google.com/apis/design/resource_names of the form
-          #   `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`.
+          #   in https://cloud.google.com/apis/design/resource_names.
+          #
+          #   * For `projects.regions.autoscalingPolicies.delete`, the resource name
+          #     of the policy has the following format:
+          #     `projects/{project_id}/regions/{region}/autoscalingPolicies/{policy_id}`
+          #
+          #   * For `projects.locations.autoscalingPolicies.delete`, the resource name
+          #     of the policy has the following format:
+          #     `projects/{project_id}/locations/{location}/autoscalingPolicies/{policy_id}`
           # @param options [Google::Gax::CallOptions]
           #   Overrides the default settings for this call, e.g, timeout,
           #   retries, etc.