google-cloud-network_connectivity-v1 1.3.0 → 1.4.0

data/proto_docs/google/cloud/networkconnectivity/v1/hub.rb

@@ -45,7 +45,7 @@ module Google
         #     labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).
         # @!attribute [rw] description
         #   @return [::String]
-        #     An optional description of the hub.
+        #     Optional. An optional description of the hub.
         # @!attribute [r] unique_id
         #   @return [::String]
         #     Output only. The Google-generated UUID for the hub. This value is unique
@@ -89,10 +89,10 @@ module Google
         #     the preset_topology is set to PRESET_TOPOLOGY_UNSPECIFIED.
         # @!attribute [rw] export_psc
         #   @return [::Boolean]
-        #     Optional. Whether Private Service Connect transitivity is enabled for the
-        #     hub. If true, Private Service Connect endpoints in VPC spokes attached to
-        #     the hub are made accessible to other VPC spokes attached to the hub.
-        #     The default value is false.
+        #     Optional. Whether Private Service Connect connection propagation is enabled
+        #     for the hub. If true, Private Service Connect endpoints in VPC spokes
+        #     attached to the hub are made accessible to other VPC spokes attached to the
+        #     hub. The default value is false.
         class Hub
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -152,7 +152,7 @@ module Google
         #     labels](https://cloud.google.com/resource-manager/docs/creating-managing-labels#requirements).
         # @!attribute [rw] description
         #   @return [::String]
-        #     An optional description of the spoke.
+        #     Optional. An optional description of the spoke.
         # @!attribute [rw] hub
         #   @return [::String]
         #     Immutable. The name of the hub that this spoke is attached to.
@@ -161,13 +161,13 @@ module Google
         #     Optional. The name of the group that this spoke is associated with.
         # @!attribute [rw] linked_vpn_tunnels
         #   @return [::Google::Cloud::NetworkConnectivity::V1::LinkedVpnTunnels]
-        #     VPN tunnels that are associated with the spoke.
+        #     Optional. VPN tunnels that are associated with the spoke.
         # @!attribute [rw] linked_interconnect_attachments
         #   @return [::Google::Cloud::NetworkConnectivity::V1::LinkedInterconnectAttachments]
-        #     VLAN attachments that are associated with the spoke.
+        #     Optional. VLAN attachments that are associated with the spoke.
         # @!attribute [rw] linked_router_appliance_instances
         #   @return [::Google::Cloud::NetworkConnectivity::V1::LinkedRouterApplianceInstances]
-        #     Router appliance instances that are associated with the spoke.
+        #     Optional. Router appliance instances that are associated with the spoke.
         # @!attribute [rw] linked_vpc_network
         #   @return [::Google::Cloud::NetworkConnectivity::V1::LinkedVpcNetwork]
         #     Optional. VPC network that is associated with the spoke.
@@ -184,11 +184,18 @@ module Google
         #     Output only. The current lifecycle state of this spoke.
         # @!attribute [r] reasons
         #   @return [::Array<::Google::Cloud::NetworkConnectivity::V1::Spoke::StateReason>]
-        #     Output only. The reasons for current state of the spoke. Only present when
-        #     the spoke is in the `INACTIVE` state.
+        #     Output only. The reasons for current state of the spoke.
         # @!attribute [r] spoke_type
         #   @return [::Google::Cloud::NetworkConnectivity::V1::SpokeType]
         #     Output only. The type of resource associated with the spoke.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Optional. This checksum is computed by the server based on the value of
+        #     other fields, and may be sent on update and delete requests to ensure the
+        #     client has an up-to-date value before proceeding.
+        # @!attribute [rw] field_paths_pending_update
+        #   @return [::Array<::String>]
+        #     Optional. The list of fields waiting for hub administration's approval.
         class Spoke
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -224,6 +231,16 @@ module Google
               # Network Connectivity Center encountered errors while accepting
               # the spoke.
               FAILED = 4
+
+              # The proposed spoke update is pending review.
+              UPDATE_PENDING_REVIEW = 5
+
+              # The proposed spoke update has been rejected by the hub administrator.
+              UPDATE_REJECTED = 6
+
+              # Network Connectivity Center encountered errors while accepting
+              # the spoke update.
+              UPDATE_FAILED = 7
             end
           end
 
@@ -417,7 +434,7 @@ module Google
         # administrator.
         # @!attribute [rw] auto_accept_projects
         #   @return [::Array<::String>]
-        #     A list of project ids or project numbers for which you want
+        #     Optional. A list of project ids or project numbers for which you want
         #     to enable auto-accept. The auto-accept setting is applied to
         #     spokes being created or updated in these projects.
         class AutoAccept
@@ -1014,6 +1031,93 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # The request for
+        # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#accept_spoke_update HubService.AcceptSpokeUpdate}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the hub to accept spoke update.
+        # @!attribute [rw] spoke_uri
+        #   @return [::String]
+        #     Required. The URI of the spoke to accept update.
+        # @!attribute [rw] spoke_etag
+        #   @return [::String]
+        #     Required. The etag of the spoke to accept update.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. A request ID to identify requests. Specify a unique request ID so
+        #     that if you must retry your request, the server knows to ignore the request
+        #     if it has already been completed. The server guarantees that a request
+        #     doesn't result in creation of duplicate commitments for at least 60
+        #     minutes.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check to see whether the original operation
+        #     was received. If it was, the server ignores the second request. This
+        #     behavior prevents clients from mistakenly creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID, with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class AcceptSpokeUpdateRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response for
+        # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#accept_spoke_update HubService.AcceptSpokeUpdate}.
+        # @!attribute [rw] spoke
+        #   @return [::Google::Cloud::NetworkConnectivity::V1::Spoke]
+        #     The spoke that was operated on.
+        class AcceptSpokeUpdateResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request for
+        # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#reject_spoke_update HubService.RejectSpokeUpdate}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the hub to reject spoke update.
+        # @!attribute [rw] spoke_uri
+        #   @return [::String]
+        #     Required. The URI of the spoke to reject update.
+        # @!attribute [rw] spoke_etag
+        #   @return [::String]
+        #     Required. The etag of the spoke to reject update.
+        # @!attribute [rw] details
+        #   @return [::String]
+        #     Optional. Additional information provided by the hub administrator.
+        # @!attribute [rw] request_id
+        #   @return [::String]
+        #     Optional. A request ID to identify requests. Specify a unique request ID so
+        #     that if you must retry your request, the server knows to ignore the request
+        #     if it has already been completed. The server guarantees that a request
+        #     doesn't result in creation of duplicate commitments for at least 60
+        #     minutes.
+        #
+        #     For example, consider a situation where you make an initial request and
+        #     the request times out. If you make the request again with the same request
+        #     ID, the server can check to see whether the original operation
+        #     was received. If it was, the server ignores the second request. This
+        #     behavior prevents clients from mistakenly creating duplicate commitments.
+        #
+        #     The request ID must be a valid UUID, with the exception that zero UUID is
+        #     not supported (00000000-0000-0000-0000-000000000000).
+        class RejectSpokeUpdateRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response for
+        # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#reject_spoke_update HubService.RejectSpokeUpdate}.
+        # @!attribute [rw] spoke
+        #   @return [::Google::Cloud::NetworkConnectivity::V1::Spoke]
+        #     The spoke that was operated on.
+        class RejectSpokeUpdateResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The request for
         # {::Google::Cloud::NetworkConnectivity::V1::HubService::Client#get_route_table HubService.GetRouteTable}.
         # @!attribute [rw] name
@@ -1246,11 +1350,23 @@ module Google
         # @!attribute [rw] include_export_ranges
         #   @return [::Array<::String>]
         #     Optional. IP ranges allowed to be included from peering.
+        # @!attribute [rw] proposed_include_export_ranges
+        #   @return [::Array<::String>]
+        #     Optional. The proposed include export IP ranges waiting for hub
+        #     administration's approval.
+        # @!attribute [r] proposed_exclude_export_ranges
+        #   @return [::Array<::String>]
+        #     Output only. The proposed exclude export IP ranges waiting for hub
+        #     administration's approval.
         # @!attribute [r] producer_vpc_spokes
         #   @return [::Array<::String>]
         #     Output only. The list of Producer VPC spokes that this VPC spoke is a
         #     service consumer VPC spoke for. These producer VPCs are connected through
-        #     VPC peering to this spoke's backing VPC network.
+        #     VPC peering to this spoke's backing VPC network. Because they are directly
+        #     connected throuh VPC peering, NCC export filters do not apply between the
+        #     service consumer VPC spoke and any of its producer VPC spokes. This VPC
+        #     spoke cannot be deleted as long as any of these producer VPC spokes are
+        #     connected to the NCC Hub.
         class LinkedVpcNetwork
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1277,6 +1393,14 @@ module Google
         # @!attribute [rw] include_export_ranges
         #   @return [::Array<::String>]
         #     Optional. IP ranges allowed to be included from peering.
+        # @!attribute [rw] proposed_include_export_ranges
+        #   @return [::Array<::String>]
+        #     Optional. The proposed include export IP ranges waiting for hub
+        #     administration's approval.
+        # @!attribute [r] proposed_exclude_export_ranges
+        #   @return [::Array<::String>]
+        #     Output only. The proposed exclude export IP ranges waiting for hub
+        #     administration's approval.
         class LinkedProducerVpcNetwork
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1535,6 +1659,11 @@ module Google
           # The hub associated with this spoke resource has been deleted.
           # This state applies to spoke resources only.
           OBSOLETE = 10
+
+          # The resource is in an undefined state due to resource creation or deletion
+          # failure. You can try to delete the resource later or contact support for
+          # help.
+          FAILED = 11
         end
 
         # The SpokeType enum represents the type of spoke. The type

data/proto_docs/google/cloud/networkconnectivity/v1/policy_based_routing.rb

@@ -21,26 +21,26 @@ module Google
   module Cloud
     module NetworkConnectivity
       module V1
-        # Policy Based Routes (PBR) are more powerful routes that allows GCP customers
-        # to route their L4 network traffic based on not just destination IP, but also
-        # source IP, protocol and more. A PBR always take precedence when it conflicts
-        # with other types of routes.
-        # Next id: 22
+        # Policy-based routes route L4 network traffic based on not just destination IP
+        # address, but also source IP address, protocol, and more. If a policy-based
+        # route conflicts with other types of routes, the policy-based route always
+        # takes precedence.
         # @!attribute [rw] virtual_machine
         #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::VirtualMachine]
-        #     Optional. VM instances to which this policy based route applies to.
+        #     Optional. VM instances that this policy-based route applies to.
         #
         #     Note: The following fields are mutually exclusive: `virtual_machine`, `interconnect_attachment`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] interconnect_attachment
         #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::InterconnectAttachment]
-        #     Optional. The interconnect attachments to which this route applies to.
+        #     Optional. The interconnect attachments that this policy-based route
+        #     applies to.
         #
         #     Note: The following fields are mutually exclusive: `interconnect_attachment`, `virtual_machine`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] next_hop_ilb_ip
         #   @return [::String]
-        #     Optional. The IP of a global access enabled L4 ILB that should be the
-        #     next hop to handle matching packets. For this version, only
-        #     next_hop_ilb_ip is supported.
+        #     Optional. The IP address of a global-access-enabled L4 ILB that is the
+        #     next hop for matching packets. For this version, only nextHopIlbIp is
+        #     supported.
         #
         #     Note: The following fields are mutually exclusive: `next_hop_ilb_ip`, `next_hop_other_routes`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] next_hop_other_routes
@@ -55,10 +55,10 @@ module Google
         #     `projects/{project_number}/locations/global/PolicyBasedRoutes/{policy_based_route_id}`
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. Time when the PolicyBasedRoute was created.
+        #     Output only. Time when the policy-based route was created.
         # @!attribute [r] update_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. Time when the PolicyBasedRoute was updated.
+        #     Output only. Time when the policy-based route was updated.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     User-defined labels.
@@ -68,16 +68,16 @@ module Google
         #     you create the resource.
         # @!attribute [rw] network
         #   @return [::String]
-        #     Required. Fully-qualified URL of the network that this route applies to.
-        #     e.g. projects/my-project/global/networks/my-network.
+        #     Required. Fully-qualified URL of the network that this route applies to,
+        #     for example: projects/my-project/global/networks/my-network.
         # @!attribute [rw] filter
         #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::Filter]
         #     Required. The filter to match L4 traffic.
         # @!attribute [rw] priority
         #   @return [::Integer]
-        #     Optional. The priority of this policy based route. Priority is used to
-        #     break ties in cases where there are more than one matching policy based
-        #     routes found. In cases where multiple policy based routes are matched, the
+        #     Optional. The priority of this policy-based route. Priority is used to
+        #     break ties in cases where there are more than one matching policy-based
+        #     routes found. In cases where multiple policy-based routes are matched, the
         #     one with the lowest-numbered priority value wins. The default value is
         #     1000. The priority value must be from 1 to 65535, inclusive.
         # @!attribute [r] warnings
@@ -90,26 +90,25 @@ module Google
         # @!attribute [r] kind
         #   @return [::String]
         #     Output only. Type of this resource. Always
-        #     networkconnectivity#policyBasedRoute for Policy Based Route resources.
+        #     networkconnectivity#policyBasedRoute for policy-based Route resources.
         class PolicyBasedRoute
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # VM instances to which this policy based route applies to.
+          # VM instances that this policy-based route applies to.
           # @!attribute [rw] tags
           #   @return [::Array<::String>]
-          #     Optional. A list of VM instance tags to which this policy based route
-          #     applies to. VM instances that have ANY of tags specified here will
-          #     install this PBR.
+          #     Optional. A list of VM instance tags that this policy-based route applies
+          #     to. VM instances that have ANY of tags specified here installs this PBR.
           class VirtualMachine
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # InterconnectAttachment to which this route applies to.
+          # InterconnectAttachment that this route applies to.
           # @!attribute [rw] region
           #   @return [::String]
-          #     Optional. Cloud region to install this policy based route on interconnect
+          #     Optional. Cloud region to install this policy-based route on interconnect
           #     attachment. Use `all` to install it on all interconnect attachments.
           class InterconnectAttachment
             include ::Google::Protobuf::MessageExts
@@ -119,21 +118,21 @@ module Google
           # Filter matches L4 traffic.
           # @!attribute [rw] ip_protocol
           #   @return [::String]
-          #     Optional. The IP protocol that this policy based route applies to. Valid
+          #     Optional. The IP protocol that this policy-based route applies to. Valid
           #     values are 'TCP', 'UDP', and 'ALL'. Default is 'ALL'.
           # @!attribute [rw] src_range
           #   @return [::String]
-          #     Optional. The source IP range of outgoing packets that this policy based
+          #     Optional. The source IP range of outgoing packets that this policy-based
           #     route applies to. Default is "0.0.0.0/0" if protocol version is IPv4.
           # @!attribute [rw] dest_range
           #   @return [::String]
-          #     Optional. The destination IP range of outgoing packets that this policy
-          #     based route applies to. Default is "0.0.0.0/0" if protocol version is
-          #     IPv4.
+          #     Optional. The destination IP range of outgoing packets that this
+          #     policy-based route applies to. Default is "0.0.0.0/0" if protocol version
+          #     is IPv4.
           # @!attribute [rw] protocol_version
           #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute::Filter::ProtocolVersion]
-          #     Required. Internet protocol versions this policy based route applies to.
-          #     For this version, only IPV4 is supported.
+          #     Required. Internet protocol versions this policy-based route applies to.
+          #     For this version, only IPV4 is supported. IPV6 is supported in preview.
           class Filter
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -176,18 +175,18 @@ module Google
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
 
-            # Warning code for Policy Based Routing. Expect to add values in the
+            # Warning code for policy-based routing. Expect to add values in the
             # future.
             module Code
               # Default value.
               WARNING_UNSPECIFIED = 0
 
-              # The policy based route is not active and functioning. Common causes are
-              # the dependent network was deleted or the resource project was turned
-              # off.
+              # The policy-based route is not active and functioning. Common causes are
+              # that the dependent network was deleted or the resource project was
+              # turned off.
               RESOURCE_NOT_ACTIVE = 1
 
-              # The policy based route is being modified (e.g. created/deleted) at this
+              # The policy-based route is being modified (e.g. created/deleted) at this
               # time.
               RESOURCE_BEING_MODIFIED = 2
             end
@@ -208,14 +207,16 @@ module Google
             OTHER_ROUTES_UNSPECIFIED = 0
 
             # Use the routes from the default routing tables (system-generated routes,
-            # custom routes, peering route) to determine the next hop. This will
-            # effectively exclude matching packets being applied on other PBRs with a
-            # lower priority.
+            # custom routes, peering route) to determine the next hop. This effectively
+            # excludes matching packets being applied on other PBRs with a lower
+            # priority.
             DEFAULT_ROUTING = 1
           end
         end
 
-        # Request for [PolicyBasedRouting.ListPolicyBasedRoutes][] method.
+        # Request for
+        # {::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoutingService::Client#list_policy_based_routes PolicyBasedRoutingService.ListPolicyBasedRoutes}
+        # method.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The parent resource's name.
@@ -236,10 +237,12 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Response for [PolicyBasedRouting.ListPolicyBasedRoutes][] method.
+        # Response for
+        # {::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoutingService::Client#list_policy_based_routes PolicyBasedRoutingService.ListPolicyBasedRoutes}
+        # method.
         # @!attribute [rw] policy_based_routes
         #   @return [::Array<::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute>]
-        #     Policy based routes to be returned.
+        #     Policy-based routes to be returned.
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     The next pagination token in the List response. It should be used as
@@ -252,7 +255,9 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request for [PolicyBasedRouting.GetPolicyBasedRoute][] method.
+        # Request for
+        # {::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoutingService::Client#get_policy_based_route PolicyBasedRoutingService.GetPolicyBasedRoute}
+        # method.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. Name of the PolicyBasedRoute resource to get.
@@ -261,28 +266,37 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request for [PolicyBasedRouting.CreatePolicyBasedRoute][] method.
+        # Request for
+        # {::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoutingService::Client#create_policy_based_route PolicyBasedRoutingService.CreatePolicyBasedRoute}
+        # method.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The parent resource's name of the PolicyBasedRoute.
         # @!attribute [rw] policy_based_route_id
         #   @return [::String]
-        #     Required. Unique id for the Policy Based Route to create.
+        #     Required. Unique id for the policy-based route to create. Provided by the
+        #     client when the resource is created. The name must comply with
+        #     https://google.aip.dev/122#resource-id-segments. Specifically, the name
+        #     must be 1-63 characters long and match the regular expression
+        #     [a-z]([a-z0-9-]*[a-z0-9])?. The first character must be a lowercase letter,
+        #     and all following characters (except for the last character) must be a
+        #     dash, lowercase letter, or digit. The last character must be a lowercase
+        #     letter or digit.
         # @!attribute [rw] policy_based_route
         #   @return [::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoute]
-        #     Required. Initial values for a new Policy Based Route.
+        #     Required. Initial values for a new policy-based route.
         # @!attribute [rw] request_id
         #   @return [::String]
         #     Optional. An optional request ID to identify requests. Specify a unique
-        #     request ID so that if you must retry your request, the server will know to
-        #     ignore the request if it has already been completed. The server will
-        #     guarantee that for at least 60 minutes since the first request.
+        #     request ID so that if you must retry your request, the server knows to
+        #     ignore the request if it has already been completed. The server guarantees
+        #     that for at least 60 minutes since the first request.
         #
         #     For example, consider a situation where you make an initial request and
         #     the request times out. If you make the request again with the same request
         #     ID, the server can check if original operation with the same request ID
-        #     was received, and if so, will ignore the second request. This prevents
-        #     clients from accidentally creating duplicate commitments.
+        #     was received, and if so, ignores the second request. This prevents clients
+        #     from accidentally creating duplicate commitments.
         #
         #     The request ID must be a valid UUID with the exception that zero UUID is
         #     not supported (00000000-0000-0000-0000-000000000000).
@@ -291,22 +305,24 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request for [PolicyBasedRouting.DeletePolicyBasedRoute][] method.
+        # Request for
+        # {::Google::Cloud::NetworkConnectivity::V1::PolicyBasedRoutingService::Client#delete_policy_based_route PolicyBasedRoutingService.DeletePolicyBasedRoute}
+        # method.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. Name of the PolicyBasedRoute resource to delete.
+        #     Required. Name of the policy-based route resource to delete.
         # @!attribute [rw] request_id
         #   @return [::String]
         #     Optional. An optional request ID to identify requests. Specify a unique
-        #     request ID so that if you must retry your request, the server will know to
-        #     ignore the request if it has already been completed. The server will
-        #     guarantee that for at least 60 minutes after the first request.
+        #     request ID so that if you must retry your request, the server knows to
+        #     ignore the request if it has already been completed. The server guarantees
+        #     that for at least 60 minutes after the first request.
         #
         #     For example, consider a situation where you make an initial request and
         #     the request times out. If you make the request again with the same request
         #     ID, the server can check if original operation with the same request ID
-        #     was received, and if so, will ignore the second request. This prevents
-        #     clients from accidentally creating duplicate commitments.
+        #     was received, and if so, ignores the second request. This prevents clients
+        #     from accidentally creating duplicate commitments.
         #
         #     The request ID must be a valid UUID with the exception that zero UUID is
         #     not supported (00000000-0000-0000-0000-000000000000).