google-api-client 0.39.1 → 0.40.0

data/generated/google/apis/dns_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/cloud-dns
     module DnsV1
       VERSION = 'V1'
-      REVISION = '20191205'
+      REVISION = '20200515'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/dns_v1/classes.rb

@@ -22,32 +22,26 @@ module Google
   module Apis
     module DnsV1
       
-      # A Change represents a set of ResourceRecordSet additions and deletions applied
-      # atomically to a ManagedZone. ResourceRecordSets within a ManagedZone are
-      # modified by creating a new Change element in the Changes collection. In turn
-      # the Changes collection also records the past modifications to the
-      # ResourceRecordSets in a ManagedZone. The current state of the ManagedZone is
-      # the sum effect of applying all Change elements in the Changes collection in
-      # sequence.
+      # 
       class Change
         include Google::Apis::Core::Hashable
       
-        # Which ResourceRecordSets to add?
+        # 
         # Corresponds to the JSON property `additions`
         # @return [Array<Google::Apis::DnsV1::ResourceRecordSet>]
         attr_accessor :additions
       
-        # Which ResourceRecordSets to remove? Must match existing data exactly.
+        # 
         # Corresponds to the JSON property `deletions`
         # @return [Array<Google::Apis::DnsV1::ResourceRecordSet>]
         attr_accessor :deletions
       
-        # Unique identifier for the resource; defined by the server (output only).
+        # 
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # If the DNS queries for the zone will be served.
+        # 
         # Corresponds to the JSON property `isServing`
         # @return [Boolean]
         attr_accessor :is_serving
@@ -58,15 +52,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The time that this operation was started by the server (output only). This is
-        # in RFC3339 text format.
+        # 
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
       
-        # Status of the operation (output only). A status of "done" means that the
-        # request to update the authoritative servers has been sent, but the servers
-        # might not be updated yet.
+        # 
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -87,17 +78,16 @@ module Google
         end
       end
       
-      # The response to a request to enumerate Changes to a ResourceRecordSets
-      # collection.
+      # 
       class ListChangesResponse
         include Google::Apis::Core::Hashable
       
-        # The requested changes.
+        # 
         # Corresponds to the JSON property `changes`
         # @return [Array<Google::Apis::DnsV1::Change>]
         attr_accessor :changes
       
-        # Elements common to every response.
+        # 
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -107,14 +97,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The presence of this field indicates that there exist more results following
-        # your last page of results in pagination order. To fetch them, make another
-        # list request using this value as your pagination token.
-        # In this way you can retrieve the complete contents of even very large
-        # collections one page at a time. However, if the contents of the collection
-        # change between the first and last paginated list request, the set of all
-        # elements returned will be an inconsistent view of the collection. There is no
-        # way to retrieve a "snapshot" of collections larger than the maximum page size.
+        # 
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -132,59 +115,47 @@ module Google
         end
       end
       
-      # A DNSSEC key pair.
+      # 
       class DnsKey
         include Google::Apis::Core::Hashable
       
-        # String mnemonic specifying the DNSSEC algorithm of this key. Immutable after
-        # creation time.
+        # 
         # Corresponds to the JSON property `algorithm`
         # @return [String]
         attr_accessor :algorithm
       
-        # The time that this resource was created in the control plane. This is in
-        # RFC3339 text format. Output only.
+        # 
         # Corresponds to the JSON property `creationTime`
         # @return [String]
         attr_accessor :creation_time
       
-        # A mutable string of at most 1024 characters associated with this resource for
-        # the user's convenience. Has no effect on the resource's function.
+        # 
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Cryptographic hashes of the DNSKEY resource record associated with this DnsKey.
-        # These digests are needed to construct a DS record that points at this DNS key.
-        # Output only.
+        # 
         # Corresponds to the JSON property `digests`
         # @return [Array<Google::Apis::DnsV1::DnsKeyDigest>]
         attr_accessor :digests
       
-        # Unique identifier for the resource; defined by the server (output only).
+        # 
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Active keys will be used to sign subsequent changes to the ManagedZone.
-        # Inactive keys will still be present as DNSKEY Resource Records for the use of
-        # resolvers validating existing signatures.
+        # 
         # Corresponds to the JSON property `isActive`
         # @return [Boolean]
         attr_accessor :is_active
         alias_method :is_active?, :is_active
       
-        # Length of the key in bits. Specified at creation time then immutable.
+        # 
         # Corresponds to the JSON property `keyLength`
         # @return [Fixnum]
         attr_accessor :key_length
       
-        # The key tag is a non-cryptographic hash of the a DNSKEY resource record
-        # associated with this DnsKey. The key tag can be used to identify a DNSKEY more
-        # quickly (but it is not a unique identifier). In particular, the key tag is
-        # used in a parent zone's DS record to point at the DNSKEY in this child
-        # ManagedZone. The key tag is a number in the range [0, 65535] and the algorithm
-        # to calculate it is specified in RFC4034 Appendix B. Output only.
+        # 
         # Corresponds to the JSON property `keyTag`
         # @return [Fixnum]
         attr_accessor :key_tag
@@ -194,16 +165,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Base64 encoded public half of this key. Output only.
+        # 
         # Corresponds to the JSON property `publicKey`
         # @return [String]
         attr_accessor :public_key
       
-        # One of "KEY_SIGNING" or "ZONE_SIGNING". Keys of type KEY_SIGNING have the
-        # Secure Entry Point flag set and, when active, will be used to sign only
-        # resource record sets of type DNSKEY. Otherwise, the Secure Entry Point flag
-        # will be cleared and this key will be used to sign only resource record sets of
-        # other types. Immutable after creation time.
+        # 
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -232,13 +199,12 @@ module Google
       class DnsKeyDigest
         include Google::Apis::Core::Hashable
       
-        # The base-16 encoded bytes of this digest. Suitable for use in a DS resource
-        # record.
+        # 
         # Corresponds to the JSON property `digest`
         # @return [String]
         attr_accessor :digest
       
-        # Specifies the algorithm used to calculate this digest.
+        # 
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -254,26 +220,21 @@ module Google
         end
       end
       
-      # Parameters for DnsKey key generation. Used for generating initial keys for a
-      # new ManagedZone and as default when adding a new DnsKey.
+      # 
       class DnsKeySpec
         include Google::Apis::Core::Hashable
       
-        # String mnemonic specifying the DNSSEC algorithm of this key.
+        # 
         # Corresponds to the JSON property `algorithm`
         # @return [String]
         attr_accessor :algorithm
       
-        # Length of the keys in bits.
+        # 
         # Corresponds to the JSON property `keyLength`
         # @return [Fixnum]
         attr_accessor :key_length
       
-        # Specifies whether this is a key signing key (KSK) or a zone signing key (ZSK).
-        # Key signing keys have the Secure Entry Point flag set and, when active, will
-        # only be used to sign resource record sets of type DNSKEY. Zone signing keys do
-        # not have the Secure Entry Point flag set and will be used to sign all other
-        # types of resource record sets.
+        # 
         # Corresponds to the JSON property `keyType`
         # @return [String]
         attr_accessor :key_type
@@ -297,16 +258,16 @@ module Google
         end
       end
       
-      # The response to a request to enumerate DnsKeys in a ManagedZone.
+      # 
       class DnsKeysListResponse
         include Google::Apis::Core::Hashable
       
-        # The requested resources.
+        # 
         # Corresponds to the JSON property `dnsKeys`
         # @return [Array<Google::Apis::DnsV1::DnsKey>]
         attr_accessor :dns_keys
       
-        # Elements common to every response.
+        # 
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -316,14 +277,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The presence of this field indicates that there exist more results following
-        # your last page of results in pagination order. To fetch them, make another
-        # list request using this value as your pagination token.
-        # In this way you can retrieve the complete contents of even very large
-        # collections one page at a time. However, if the contents of the collection
-        # change between the first and last paginated list request, the set of all
-        # elements returned will be an inconsistent view of the collection. There is no
-        # way to retrieve a "snapshot" of collections larger than the maximum page size.
+        # 
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -341,42 +295,36 @@ module Google
         end
       end
       
-      # A zone is a subtree of the DNS namespace under one administrative
-      # responsibility. A ManagedZone is a resource that represents a DNS zone hosted
-      # by the Cloud DNS service.
+      # 
       class ManagedZone
         include Google::Apis::Core::Hashable
       
-        # The time that this resource was created on the server. This is in RFC3339 text
-        # format. Output only.
+        # 
         # Corresponds to the JSON property `creationTime`
         # @return [String]
         attr_accessor :creation_time
       
-        # A mutable string of at most 1024 characters associated with this resource for
-        # the user's convenience. Has no effect on the managed zone's function.
+        # 
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # The DNS name of this managed zone, for instance "example.com.".
+        # 
         # Corresponds to the JSON property `dnsName`
         # @return [String]
         attr_accessor :dns_name
       
-        # DNSSEC configuration.
+        # 
         # Corresponds to the JSON property `dnssecConfig`
         # @return [Google::Apis::DnsV1::ManagedZoneDnsSecConfig]
         attr_accessor :dnssec_config
       
-        # The presence for this field indicates that outbound forwarding is enabled for
-        # this zone. The value of this field contains the set of destinations to forward
-        # to.
+        # 
         # Corresponds to the JSON property `forwardingConfig`
         # @return [Google::Apis::DnsV1::ManagedZoneForwardingConfig]
         attr_accessor :forwarding_config
       
-        # Unique identifier for the resource; defined by the server (output only)
+        # 
         # Corresponds to the JSON property `id`
         # @return [Fixnum]
         attr_accessor :id
@@ -387,45 +335,42 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # User labels.
+        # 
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # User assigned name for this resource. Must be unique within the project. The
-        # name must be 1-63 characters long, must begin with a letter, end with a letter
-        # or digit, and only contain lowercase letters, digits or dashes.
+        # 
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Optionally specifies the NameServerSet for this ManagedZone. A NameServerSet
-        # is a set of DNS name servers that all host the same ManagedZones. Most users
-        # will leave this field unset.
+        # 
         # Corresponds to the JSON property `nameServerSet`
         # @return [String]
         attr_accessor :name_server_set
       
-        # Delegate your managed_zone to these virtual name servers; defined by the
-        # server (output only)
+        # 
         # Corresponds to the JSON property `nameServers`
         # @return [Array<String>]
         attr_accessor :name_servers
       
-        # The presence of this field indicates that DNS Peering is enabled for this zone.
-        # The value of this field contains the network to peer with.
+        # 
         # Corresponds to the JSON property `peeringConfig`
         # @return [Google::Apis::DnsV1::ManagedZonePeeringConfig]
         attr_accessor :peering_config
       
-        # For privately visible zones, the set of Virtual Private Cloud resources that
-        # the zone is visible from.
+        # 
         # Corresponds to the JSON property `privateVisibilityConfig`
         # @return [Google::Apis::DnsV1::ManagedZonePrivateVisibilityConfig]
         attr_accessor :private_visibility_config
       
-        # The zone's visibility: public zones are exposed to the Internet, while private
-        # zones are visible only to Virtual Private Cloud resources.
+        # 
+        # Corresponds to the JSON property `reverseLookupConfig`
+        # @return [Google::Apis::DnsV1::ManagedZoneReverseLookupConfig]
+        attr_accessor :reverse_lookup_config
+      
+        # 
         # Corresponds to the JSON property `visibility`
         # @return [String]
         attr_accessor :visibility
@@ -449,6 +394,7 @@ module Google
           @name_servers = args[:name_servers] if args.key?(:name_servers)
           @peering_config = args[:peering_config] if args.key?(:peering_config)
           @private_visibility_config = args[:private_visibility_config] if args.key?(:private_visibility_config)
+          @reverse_lookup_config = args[:reverse_lookup_config] if args.key?(:reverse_lookup_config)
           @visibility = args[:visibility] if args.key?(:visibility)
         end
       end
@@ -457,8 +403,7 @@ module Google
       class ManagedZoneDnsSecConfig
         include Google::Apis::Core::Hashable
       
-        # Specifies parameters for generating initial DnsKeys for this ManagedZone. Can
-        # only be changed while the state is OFF.
+        # 
         # Corresponds to the JSON property `defaultKeySpecs`
         # @return [Array<Google::Apis::DnsV1::DnsKeySpec>]
         attr_accessor :default_key_specs
@@ -469,13 +414,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Specifies the mechanism for authenticated denial-of-existence responses. Can
-        # only be changed while the state is OFF.
+        # 
         # Corresponds to the JSON property `nonExistence`
         # @return [String]
         attr_accessor :non_existence
       
-        # Specifies whether DNSSEC is enabled, and what mode it is in.
+        # 
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
@@ -503,8 +447,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # List of target name servers to forward to. Cloud DNS will select the best
-        # available name server if more than one target is given.
+        # 
         # Corresponds to the JSON property `targetNameServers`
         # @return [Array<Google::Apis::DnsV1::ManagedZoneForwardingConfigNameServerTarget>]
         attr_accessor :target_name_servers
@@ -524,7 +467,12 @@ module Google
       class ManagedZoneForwardingConfigNameServerTarget
         include Google::Apis::Core::Hashable
       
-        # IPv4 address of a target name server.
+        # 
+        # Corresponds to the JSON property `forwardingPath`
+        # @return [String]
+        attr_accessor :forwarding_path
+      
+        # 
         # Corresponds to the JSON property `ipv4Address`
         # @return [String]
         attr_accessor :ipv4_address
@@ -541,6 +489,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @forwarding_path = args[:forwarding_path] if args.key?(:forwarding_path)
           @ipv4_address = args[:ipv4_address] if args.key?(:ipv4_address)
           @kind = args[:kind] if args.key?(:kind)
         end
@@ -550,7 +499,7 @@ module Google
       class ManagedZoneOperationsListResponse
         include Google::Apis::Core::Hashable
       
-        # Elements common to every response.
+        # 
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -560,20 +509,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The presence of this field indicates that there exist more results following
-        # your last page of results in pagination order. To fetch them, make another
-        # list request using this value as your page token.
-        # In this way you can retrieve the complete contents of even very large
-        # collections one page at a time. However, if the contents of the collection
-        # change between the first and last paginated list request, the set of all
-        # elements returned will be an inconsistent view of the collection. There is no
-        # way to retrieve a consistent snapshot of a collection larger than the maximum
-        # page size.
+        # 
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # The operation resources.
+        # 
         # Corresponds to the JSON property `operations`
         # @return [Array<Google::Apis::DnsV1::Operation>]
         attr_accessor :operations
@@ -601,7 +542,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The network with which to peer.
+        # 
         # Corresponds to the JSON property `targetNetwork`
         # @return [Google::Apis::DnsV1::ManagedZonePeeringConfigTargetNetwork]
         attr_accessor :target_network
@@ -621,10 +562,7 @@ module Google
       class ManagedZonePeeringConfigTargetNetwork
         include Google::Apis::Core::Hashable
       
-        # The time at which the zone was deactivated, in RFC 3339 date-time format. An
-        # empty string indicates that the peering connection is active. The producer
-        # network can deactivate a zone. The zone is automatically deactivated if the
-        # producer network that the zone targeted is deleted. Output only.
+        # 
         # Corresponds to the JSON property `deactivateTime`
         # @return [String]
         attr_accessor :deactivate_time
@@ -635,9 +573,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The fully qualified URL of the VPC network to forward queries to. This should
-        # be formatted like https://www.googleapis.com/compute/v1/projects/`project`/
-        # global/networks/`network`
+        # 
         # Corresponds to the JSON property `networkUrl`
         # @return [String]
         attr_accessor :network_url
@@ -664,7 +600,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The list of VPC networks that can see this zone.
+        # 
         # Corresponds to the JSON property `networks`
         # @return [Array<Google::Apis::DnsV1::ManagedZonePrivateVisibilityConfigNetwork>]
         attr_accessor :networks
@@ -690,9 +626,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The fully qualified URL of the VPC network to bind to. This should be
-        # formatted like https://www.googleapis.com/compute/v1/projects/`project`/global/
-        # networks/`network`
+        # 
         # Corresponds to the JSON property `networkUrl`
         # @return [String]
         attr_accessor :network_url
@@ -708,11 +642,31 @@ module Google
         end
       end
       
+      # 
+      class ManagedZoneReverseLookupConfig
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "dns#
+        # managedZoneReverseLookupConfig".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+        end
+      end
+      
       # 
       class ListManagedZonesResponse
         include Google::Apis::Core::Hashable
       
-        # Elements common to every response.
+        # 
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -722,20 +676,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The managed zone resources.
+        # 
         # Corresponds to the JSON property `managedZones`
         # @return [Array<Google::Apis::DnsV1::ManagedZone>]
         attr_accessor :managed_zones
       
-        # The presence of this field indicates that there exist more results following
-        # your last page of results in pagination order. To fetch them, make another
-        # list request using this value as your page token.
-        # In this way you can retrieve the complete contents of even very large
-        # collections one page at a time. However, if the contents of the collection
-        # change between the first and last paginated list request, the set of all
-        # elements returned will be an inconsistent view of the collection. There is no
-        # way to retrieve a consistent snapshot of a collection larger than the maximum
-        # page size.
+        # 
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -753,22 +699,16 @@ module Google
         end
       end
       
-      # An operation represents a successful mutation performed on a Cloud DNS
-      # resource. Operations provide: - An audit log of server resource mutations. - A
-      # way to recover/retry API calls in the case where the response is never
-      # received by the caller. Use the caller specified client_operation_id.
+      # 
       class Operation
         include Google::Apis::Core::Hashable
       
-        # Only populated if the operation targeted a DnsKey (output only).
+        # 
         # Corresponds to the JSON property `dnsKeyContext`
         # @return [Google::Apis::DnsV1::OperationDnsKeyContext]
         attr_accessor :dns_key_context
       
-        # Unique identifier for the resource. This is the client_operation_id if the
-        # client specified it when the mutation was initiated, otherwise, it is
-        # generated by the server. The name must be 1-63 characters long and match the
-        # regular expression [-a-z0-9]? (output only)
+        # 
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -779,32 +719,27 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The time that this operation was started by the server. This is in RFC3339
-        # text format (output only).
+        # 
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
       
-        # Status of the operation. Can be one of the following: "PENDING" or "DONE" (
-        # output only). A status of "DONE" means that the request to update the
-        # authoritative servers has been sent, but the servers might not be updated yet.
+        # 
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
       
-        # Type of the operation. Operations include insert, update, and delete (output
-        # only).
+        # 
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
       
-        # User who requested the operation, for example: user@example.com. cloud-dns-
-        # system for operations automatically done by the system. (output only)
+        # 
         # Corresponds to the JSON property `user`
         # @return [String]
         attr_accessor :user
       
-        # Only populated if the operation targeted a ManagedZone (output only).
+        # 
         # Corresponds to the JSON property `zoneContext`
         # @return [Google::Apis::DnsV1::OperationManagedZoneContext]
         attr_accessor :zone_context
@@ -830,12 +765,12 @@ module Google
       class OperationDnsKeyContext
         include Google::Apis::Core::Hashable
       
-        # A DNSSEC key pair.
+        # 
         # Corresponds to the JSON property `newValue`
         # @return [Google::Apis::DnsV1::DnsKey]
         attr_accessor :new_value
       
-        # A DNSSEC key pair.
+        # 
         # Corresponds to the JSON property `oldValue`
         # @return [Google::Apis::DnsV1::DnsKey]
         attr_accessor :old_value
@@ -855,16 +790,12 @@ module Google
       class OperationManagedZoneContext
         include Google::Apis::Core::Hashable
       
-        # A zone is a subtree of the DNS namespace under one administrative
-        # responsibility. A ManagedZone is a resource that represents a DNS zone hosted
-        # by the Cloud DNS service.
+        # 
         # Corresponds to the JSON property `newValue`
         # @return [Google::Apis::DnsV1::ManagedZone]
         attr_accessor :new_value
       
-        # A zone is a subtree of the DNS namespace under one administrative
-        # responsibility. A ManagedZone is a resource that represents a DNS zone hosted
-        # by the Cloud DNS service.
+        # 
         # Corresponds to the JSON property `oldValue`
         # @return [Google::Apis::DnsV1::ManagedZone]
         attr_accessor :old_value
@@ -884,7 +815,7 @@ module Google
       class PoliciesListResponse
         include Google::Apis::Core::Hashable
       
-        # Elements common to every response.
+        # 
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -894,20 +825,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The presence of this field indicates that there exist more results following
-        # your last page of results in pagination order. To fetch them, make another
-        # list request using this value as your page token.
-        # In this way you can retrieve the complete contents of even very large
-        # collections one page at a time. However, if the contents of the collection
-        # change between the first and last paginated list request, the set of all
-        # elements returned will be an inconsistent view of the collection. There is no
-        # way to retrieve a consistent snapshot of a collection larger than the maximum
-        # page size.
+        # 
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # The policy resources.
+        # 
         # Corresponds to the JSON property `policies`
         # @return [Array<Google::Apis::DnsV1::Policy>]
         attr_accessor :policies
@@ -929,13 +852,12 @@ module Google
       class PoliciesPatchResponse
         include Google::Apis::Core::Hashable
       
-        # Elements common to every response.
+        # 
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
       
-        # A policy is a collection of DNS rules applied to one or more Virtual Private
-        # Cloud resources.
+        # 
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::DnsV1::Policy]
         attr_accessor :policy
@@ -955,13 +877,12 @@ module Google
       class PoliciesUpdateResponse
         include Google::Apis::Core::Hashable
       
-        # Elements common to every response.
+        # 
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
       
-        # A policy is a collection of DNS rules applied to one or more Virtual Private
-        # Cloud resources.
+        # 
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::DnsV1::Policy]
         attr_accessor :policy
@@ -977,40 +898,33 @@ module Google
         end
       end
       
-      # A policy is a collection of DNS rules applied to one or more Virtual Private
-      # Cloud resources.
+      # 
       class Policy
         include Google::Apis::Core::Hashable
       
-        # Sets an alternative name server for the associated networks. When specified,
-        # all DNS queries are forwarded to a name server that you choose. Names such as .
-        # internal are not available when an alternative name server is specified.
+        # 
         # Corresponds to the JSON property `alternativeNameServerConfig`
         # @return [Google::Apis::DnsV1::PolicyAlternativeNameServerConfig]
         attr_accessor :alternative_name_server_config
       
-        # A mutable string of at most 1024 characters associated with this resource for
-        # the user's convenience. Has no effect on the policy's function.
+        # 
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Allows networks bound to this policy to receive DNS queries sent by VMs or
-        # applications over VPN connections. When enabled, a virtual IP address will be
-        # allocated from each of the sub-networks that are bound to this policy.
+        # 
         # Corresponds to the JSON property `enableInboundForwarding`
         # @return [Boolean]
         attr_accessor :enable_inbound_forwarding
         alias_method :enable_inbound_forwarding?, :enable_inbound_forwarding
       
-        # Controls whether logging is enabled for the networks bound to this policy.
-        # Defaults to no logging if not set.
+        # 
         # Corresponds to the JSON property `enableLogging`
         # @return [Boolean]
         attr_accessor :enable_logging
         alias_method :enable_logging?, :enable_logging
       
-        # Unique identifier for the resource; defined by the server (output only).
+        # 
         # Corresponds to the JSON property `id`
         # @return [Fixnum]
         attr_accessor :id
@@ -1020,12 +934,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # User assigned name for this policy.
+        # 
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # List of network names specifying networks to which this policy is applied.
+        # 
         # Corresponds to the JSON property `networks`
         # @return [Array<Google::Apis::DnsV1::PolicyNetwork>]
         attr_accessor :networks
@@ -1057,9 +971,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Sets an alternative name server for the associated networks. When specified,
-        # all DNS queries are forwarded to a name server that you choose. Names such as .
-        # internal are not available when an alternative name server is specified.
+        # 
         # Corresponds to the JSON property `targetNameServers`
         # @return [Array<Google::Apis::DnsV1::PolicyAlternativeNameServerConfigTargetNameServer>]
         attr_accessor :target_name_servers
@@ -1079,7 +991,12 @@ module Google
       class PolicyAlternativeNameServerConfigTargetNameServer
         include Google::Apis::Core::Hashable
       
-        # IPv4 address to forward to.
+        # 
+        # Corresponds to the JSON property `forwardingPath`
+        # @return [String]
+        attr_accessor :forwarding_path
+      
+        # 
         # Corresponds to the JSON property `ipv4Address`
         # @return [String]
         attr_accessor :ipv4_address
@@ -1096,6 +1013,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @forwarding_path = args[:forwarding_path] if args.key?(:forwarding_path)
           @ipv4_address = args[:ipv4_address] if args.key?(:ipv4_address)
           @kind = args[:kind] if args.key?(:kind)
         end
@@ -1111,9 +1029,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The fully qualified URL of the VPC network to bind to. This should be
-        # formatted like https://www.googleapis.com/compute/v1/projects/`project`/global/
-        # networks/`network`
+        # 
         # Corresponds to the JSON property `networkUrl`
         # @return [String]
         attr_accessor :network_url
@@ -1129,13 +1045,11 @@ module Google
         end
       end
       
-      # A project resource. The project is a top level container for resources
-      # including Cloud DNS ManagedZones. Projects can be created only in the APIs
-      # console.
+      # 
       class Project
         include Google::Apis::Core::Hashable
       
-        # User assigned unique identifier for the resource (output only).
+        # 
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -1146,13 +1060,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Unique numeric identifier for the resource; defined by the server (output only)
-        # .
+        # 
         # Corresponds to the JSON property `number`
         # @return [Fixnum]
         attr_accessor :number
       
-        # Limits associated with a Project.
+        # 
         # Corresponds to the JSON property `quota`
         # @return [Google::Apis::DnsV1::Quota]
         attr_accessor :quota
@@ -1170,11 +1083,11 @@ module Google
         end
       end
       
-      # Limits associated with a Project.
+      # 
       class Quota
         include Google::Apis::Core::Hashable
       
-        # Maximum allowed number of DnsKeys per ManagedZone.
+        # 
         # Corresponds to the JSON property `dnsKeysPerManagedZone`
         # @return [Fixnum]
         attr_accessor :dns_keys_per_managed_zone
@@ -1184,69 +1097,67 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Maximum allowed number of managed zones in the project.
+        # 
         # Corresponds to the JSON property `managedZones`
         # @return [Fixnum]
         attr_accessor :managed_zones
       
-        # Maximum allowed number of managed zones which can be attached to a network.
+        # 
         # Corresponds to the JSON property `managedZonesPerNetwork`
         # @return [Fixnum]
         attr_accessor :managed_zones_per_network
       
-        # Maximum allowed number of networks to which a privately scoped zone can be
-        # attached.
+        # 
         # Corresponds to the JSON property `networksPerManagedZone`
         # @return [Fixnum]
         attr_accessor :networks_per_managed_zone
       
-        # Maximum allowed number of networks per policy.
+        # 
         # Corresponds to the JSON property `networksPerPolicy`
         # @return [Fixnum]
         attr_accessor :networks_per_policy
       
-        # Maximum allowed number of policies per project.
+        # 
         # Corresponds to the JSON property `policies`
         # @return [Fixnum]
         attr_accessor :policies
       
-        # Maximum allowed number of ResourceRecords per ResourceRecordSet.
+        # 
         # Corresponds to the JSON property `resourceRecordsPerRrset`
         # @return [Fixnum]
         attr_accessor :resource_records_per_rrset
       
-        # Maximum allowed number of ResourceRecordSets to add per ChangesCreateRequest.
+        # 
         # Corresponds to the JSON property `rrsetAdditionsPerChange`
         # @return [Fixnum]
         attr_accessor :rrset_additions_per_change
       
-        # Maximum allowed number of ResourceRecordSets to delete per
-        # ChangesCreateRequest.
+        # 
         # Corresponds to the JSON property `rrsetDeletionsPerChange`
         # @return [Fixnum]
         attr_accessor :rrset_deletions_per_change
       
-        # Maximum allowed number of ResourceRecordSets per zone in the project.
+        # 
         # Corresponds to the JSON property `rrsetsPerManagedZone`
         # @return [Fixnum]
         attr_accessor :rrsets_per_managed_zone
       
-        # Maximum allowed number of target name servers per managed forwarding zone.
+        # 
         # Corresponds to the JSON property `targetNameServersPerManagedZone`
         # @return [Fixnum]
         attr_accessor :target_name_servers_per_managed_zone
       
-        # Maximum allowed number of alternative target name servers per policy.
+        # 
         # Corresponds to the JSON property `targetNameServersPerPolicy`
         # @return [Fixnum]
         attr_accessor :target_name_servers_per_policy
       
-        # Maximum allowed size for total rrdata in one ChangesCreateRequest in bytes.
+        # 
         # Corresponds to the JSON property `totalRrdataSizePerChange`
         # @return [Fixnum]
         attr_accessor :total_rrdata_size_per_change
       
-        # DNSSEC algorithm and key length types that can be used for DnsKeys.
+        # 
         # Corresponds to the JSON property `whitelistedKeySpecs`
         # @return [Array<Google::Apis::DnsV1::DnsKeySpec>]
         attr_accessor :whitelisted_key_specs
@@ -1275,7 +1186,7 @@ module Google
         end
       end
       
-      # A unit of data that will be returned by the DNS servers.
+      # 
       class ResourceRecordSet
         include Google::Apis::Core::Hashable
       
@@ -1285,29 +1196,27 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # For example, www.example.com.
+        # 
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # As defined in RFC 1035 (section 5) and RFC 1034 (section 3.6.1) -- see
-        # examples.
+        # 
         # Corresponds to the JSON property `rrdatas`
         # @return [Array<String>]
         attr_accessor :rrdatas
       
-        # As defined in RFC 4034 (section 3.2).
+        # 
         # Corresponds to the JSON property `signatureRrdatas`
         # @return [Array<String>]
         attr_accessor :signature_rrdatas
       
-        # Number of seconds that this ResourceRecordSet can be cached by resolvers.
+        # 
         # Corresponds to the JSON property `ttl`
         # @return [Fixnum]
         attr_accessor :ttl
       
-        # The identifier of a supported record type. See the list of Supported DNS
-        # record types.
+        # 
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1331,7 +1240,7 @@ module Google
       class ListResourceRecordSetsResponse
         include Google::Apis::Core::Hashable
       
-        # Elements common to every response.
+        # 
         # Corresponds to the JSON property `header`
         # @return [Google::Apis::DnsV1::ResponseHeader]
         attr_accessor :header
@@ -1341,20 +1250,12 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The presence of this field indicates that there exist more results following
-        # your last page of results in pagination order. To fetch them, make another
-        # list request using this value as your pagination token.
-        # In this way you can retrieve the complete contents of even very large
-        # collections one page at a time. However, if the contents of the collection
-        # change between the first and last paginated list request, the set of all
-        # elements returned will be an inconsistent view of the collection. There is no
-        # way to retrieve a consistent snapshot of a collection larger than the maximum
-        # page size.
+        # 
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
       
-        # The resource record set resources.
+        # 
         # Corresponds to the JSON property `rrsets`
         # @return [Array<Google::Apis::DnsV1::ResourceRecordSet>]
         attr_accessor :rrsets
@@ -1372,13 +1273,11 @@ module Google
         end
       end
       
-      # Elements common to every response.
+      # 
       class ResponseHeader
         include Google::Apis::Core::Hashable
       
-        # For mutating operation requests that completed successfully. This is the
-        # client_operation_id if the client specified it, otherwise it is generated by
-        # the server (output only).
+        # 
         # Corresponds to the JSON property `operationId`
         # @return [String]
         attr_accessor :operation_id