• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5  margin: 0;
6  padding: 0;
7  border: 0;
8  font-weight: inherit;
9  font-style: inherit;
10  font-size: 100%;
11  font-family: inherit;
12  vertical-align: baseline;
13}
14
15body {
16  font-size: 13px;
17  padding: 1em;
18}
19
20h1 {
21  font-size: 26px;
22  margin-bottom: 1em;
23}
24
25h2 {
26  font-size: 24px;
27  margin-bottom: 1em;
28}
29
30h3 {
31  font-size: 20px;
32  margin-bottom: 1em;
33  margin-top: 1em;
34}
35
36pre, code {
37  line-height: 1.5;
38  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42  margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46  font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50  border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54  margin-top: 0.5em;
55}
56
57.firstline {
58  margin-left: 2 em;
59}
60
61.method  {
62  margin-top: 1em;
63  border: solid 1px #CCC;
64  padding: 1em;
65  background: #EEE;
66}
67
68.details {
69  font-weight: bold;
70  font-size: 14px;
71}
72
73</style>
74
75<h1><a href="dns_v1beta2.html">Cloud DNS API</a> . <a href="dns_v1beta2.policies.html">policies</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
81  <code><a href="#create">create(project, body=None, clientOperationId=None, x__xgafv=None)</a></code></p>
82<p class="firstline">Creates a new Policy.</p>
83<p class="toc_element">
84  <code><a href="#delete">delete(project, policy, clientOperationId=None, x__xgafv=None)</a></code></p>
85<p class="firstline">Deletes a previously created Policy. Fails if the policy is still being referenced by a network.</p>
86<p class="toc_element">
87  <code><a href="#get">get(project, policy, clientOperationId=None, x__xgafv=None)</a></code></p>
88<p class="firstline">Fetches the representation of an existing Policy.</p>
89<p class="toc_element">
90  <code><a href="#list">list(project, maxResults=None, pageToken=None, x__xgafv=None)</a></code></p>
91<p class="firstline">Enumerates all Policies associated with a project.</p>
92<p class="toc_element">
93  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
94<p class="firstline">Retrieves the next page of results.</p>
95<p class="toc_element">
96  <code><a href="#patch">patch(project, policy, body=None, clientOperationId=None, x__xgafv=None)</a></code></p>
97<p class="firstline">Applies a partial update to an existing Policy.</p>
98<p class="toc_element">
99  <code><a href="#update">update(project, policy, body=None, clientOperationId=None, x__xgafv=None)</a></code></p>
100<p class="firstline">Updates an existing Policy.</p>
101<h3>Method Details</h3>
102<div class="method">
103    <code class="details" id="close">close()</code>
104  <pre>Close httplib2 connections.</pre>
105</div>
106
107<div class="method">
108    <code class="details" id="create">create(project, body=None, clientOperationId=None, x__xgafv=None)</code>
109  <pre>Creates a new Policy.
110
111Args:
112  project: string, Identifies the project addressed by this request. (required)
113  body: object, The request body.
114    The object takes the form of:
115
116{ # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
117  &quot;alternativeNameServerConfig&quot;: { # 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.
118    &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
119    &quot;targetNameServers&quot;: [ # 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.
120      {
121        &quot;forwardingPath&quot;: &quot;A String&quot;, # Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.
122        &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
123        &quot;ipv6Address&quot;: &quot;A String&quot;, # IPv6 address to forward to. Does not accept both fields (ipv4 &amp; ipv6) being populated.
124        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
125      },
126    ],
127  },
128  &quot;description&quot;: &quot;A String&quot;, # A mutable string of at most 1024 characters associated with this resource for the user&#x27;s convenience. Has no effect on the policy&#x27;s function.
129  &quot;enableInboundForwarding&quot;: True or False, # Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.
130  &quot;enableLogging&quot;: True or False, # Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.
131  &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
132  &quot;kind&quot;: &quot;dns#policy&quot;,
133  &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
134  &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
135    {
136      &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
137      &quot;networkUrl&quot;: &quot;A String&quot;, # 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}
138    },
139  ],
140}
141
142  clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
143  x__xgafv: string, V1 error format.
144    Allowed values
145      1 - v1 error format
146      2 - v2 error format
147
148Returns:
149  An object of the form:
150
151    { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
152  &quot;alternativeNameServerConfig&quot;: { # 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.
153    &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
154    &quot;targetNameServers&quot;: [ # 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.
155      {
156        &quot;forwardingPath&quot;: &quot;A String&quot;, # Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.
157        &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
158        &quot;ipv6Address&quot;: &quot;A String&quot;, # IPv6 address to forward to. Does not accept both fields (ipv4 &amp; ipv6) being populated.
159        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
160      },
161    ],
162  },
163  &quot;description&quot;: &quot;A String&quot;, # A mutable string of at most 1024 characters associated with this resource for the user&#x27;s convenience. Has no effect on the policy&#x27;s function.
164  &quot;enableInboundForwarding&quot;: True or False, # Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.
165  &quot;enableLogging&quot;: True or False, # Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.
166  &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
167  &quot;kind&quot;: &quot;dns#policy&quot;,
168  &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
169  &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
170    {
171      &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
172      &quot;networkUrl&quot;: &quot;A String&quot;, # 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}
173    },
174  ],
175}</pre>
176</div>
177
178<div class="method">
179    <code class="details" id="delete">delete(project, policy, clientOperationId=None, x__xgafv=None)</code>
180  <pre>Deletes a previously created Policy. Fails if the policy is still being referenced by a network.
181
182Args:
183  project: string, Identifies the project addressed by this request. (required)
184  policy: string, User given friendly name of the policy addressed by this request. (required)
185  clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
186  x__xgafv: string, V1 error format.
187    Allowed values
188      1 - v1 error format
189      2 - v2 error format
190</pre>
191</div>
192
193<div class="method">
194    <code class="details" id="get">get(project, policy, clientOperationId=None, x__xgafv=None)</code>
195  <pre>Fetches the representation of an existing Policy.
196
197Args:
198  project: string, Identifies the project addressed by this request. (required)
199  policy: string, User given friendly name of the policy addressed by this request. (required)
200  clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
201  x__xgafv: string, V1 error format.
202    Allowed values
203      1 - v1 error format
204      2 - v2 error format
205
206Returns:
207  An object of the form:
208
209    { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
210  &quot;alternativeNameServerConfig&quot;: { # 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.
211    &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
212    &quot;targetNameServers&quot;: [ # 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.
213      {
214        &quot;forwardingPath&quot;: &quot;A String&quot;, # Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.
215        &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
216        &quot;ipv6Address&quot;: &quot;A String&quot;, # IPv6 address to forward to. Does not accept both fields (ipv4 &amp; ipv6) being populated.
217        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
218      },
219    ],
220  },
221  &quot;description&quot;: &quot;A String&quot;, # A mutable string of at most 1024 characters associated with this resource for the user&#x27;s convenience. Has no effect on the policy&#x27;s function.
222  &quot;enableInboundForwarding&quot;: True or False, # Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.
223  &quot;enableLogging&quot;: True or False, # Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.
224  &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
225  &quot;kind&quot;: &quot;dns#policy&quot;,
226  &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
227  &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
228    {
229      &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
230      &quot;networkUrl&quot;: &quot;A String&quot;, # 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}
231    },
232  ],
233}</pre>
234</div>
235
236<div class="method">
237    <code class="details" id="list">list(project, maxResults=None, pageToken=None, x__xgafv=None)</code>
238  <pre>Enumerates all Policies associated with a project.
239
240Args:
241  project: string, Identifies the project addressed by this request. (required)
242  maxResults: integer, Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
243  pageToken: string, Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
244  x__xgafv: string, V1 error format.
245    Allowed values
246      1 - v1 error format
247      2 - v2 error format
248
249Returns:
250  An object of the form:
251
252    {
253  &quot;header&quot;: { # Elements common to every response.
254    &quot;operationId&quot;: &quot;A String&quot;, # 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).
255  },
256  &quot;kind&quot;: &quot;dns#policiesListResponse&quot;, # Type of resource.
257  &quot;nextPageToken&quot;: &quot;A String&quot;, # 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. This lets you 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 are an inconsistent view of the collection. You cannot retrieve a consistent snapshot of a collection larger than the maximum page size.
258  &quot;policies&quot;: [ # The policy resources.
259    { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
260      &quot;alternativeNameServerConfig&quot;: { # 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.
261        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
262        &quot;targetNameServers&quot;: [ # 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.
263          {
264            &quot;forwardingPath&quot;: &quot;A String&quot;, # Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.
265            &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
266            &quot;ipv6Address&quot;: &quot;A String&quot;, # IPv6 address to forward to. Does not accept both fields (ipv4 &amp; ipv6) being populated.
267            &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
268          },
269        ],
270      },
271      &quot;description&quot;: &quot;A String&quot;, # A mutable string of at most 1024 characters associated with this resource for the user&#x27;s convenience. Has no effect on the policy&#x27;s function.
272      &quot;enableInboundForwarding&quot;: True or False, # Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.
273      &quot;enableLogging&quot;: True or False, # Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.
274      &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
275      &quot;kind&quot;: &quot;dns#policy&quot;,
276      &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
277      &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
278        {
279          &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
280          &quot;networkUrl&quot;: &quot;A String&quot;, # 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}
281        },
282      ],
283    },
284  ],
285}</pre>
286</div>
287
288<div class="method">
289    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
290  <pre>Retrieves the next page of results.
291
292Args:
293  previous_request: The request for the previous page. (required)
294  previous_response: The response from the request for the previous page. (required)
295
296Returns:
297  A request object that you can call &#x27;execute()&#x27; on to request the next
298  page. Returns None if there are no more items in the collection.
299    </pre>
300</div>
301
302<div class="method">
303    <code class="details" id="patch">patch(project, policy, body=None, clientOperationId=None, x__xgafv=None)</code>
304  <pre>Applies a partial update to an existing Policy.
305
306Args:
307  project: string, Identifies the project addressed by this request. (required)
308  policy: string, User given friendly name of the policy addressed by this request. (required)
309  body: object, The request body.
310    The object takes the form of:
311
312{ # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
313  &quot;alternativeNameServerConfig&quot;: { # 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.
314    &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
315    &quot;targetNameServers&quot;: [ # 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.
316      {
317        &quot;forwardingPath&quot;: &quot;A String&quot;, # Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.
318        &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
319        &quot;ipv6Address&quot;: &quot;A String&quot;, # IPv6 address to forward to. Does not accept both fields (ipv4 &amp; ipv6) being populated.
320        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
321      },
322    ],
323  },
324  &quot;description&quot;: &quot;A String&quot;, # A mutable string of at most 1024 characters associated with this resource for the user&#x27;s convenience. Has no effect on the policy&#x27;s function.
325  &quot;enableInboundForwarding&quot;: True or False, # Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.
326  &quot;enableLogging&quot;: True or False, # Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.
327  &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
328  &quot;kind&quot;: &quot;dns#policy&quot;,
329  &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
330  &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
331    {
332      &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
333      &quot;networkUrl&quot;: &quot;A String&quot;, # 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}
334    },
335  ],
336}
337
338  clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
339  x__xgafv: string, V1 error format.
340    Allowed values
341      1 - v1 error format
342      2 - v2 error format
343
344Returns:
345  An object of the form:
346
347    {
348  &quot;header&quot;: { # Elements common to every response.
349    &quot;operationId&quot;: &quot;A String&quot;, # 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).
350  },
351  &quot;policy&quot;: { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
352    &quot;alternativeNameServerConfig&quot;: { # 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.
353      &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
354      &quot;targetNameServers&quot;: [ # 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.
355        {
356          &quot;forwardingPath&quot;: &quot;A String&quot;, # Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.
357          &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
358          &quot;ipv6Address&quot;: &quot;A String&quot;, # IPv6 address to forward to. Does not accept both fields (ipv4 &amp; ipv6) being populated.
359          &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
360        },
361      ],
362    },
363    &quot;description&quot;: &quot;A String&quot;, # A mutable string of at most 1024 characters associated with this resource for the user&#x27;s convenience. Has no effect on the policy&#x27;s function.
364    &quot;enableInboundForwarding&quot;: True or False, # Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.
365    &quot;enableLogging&quot;: True or False, # Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.
366    &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
367    &quot;kind&quot;: &quot;dns#policy&quot;,
368    &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
369    &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
370      {
371        &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
372        &quot;networkUrl&quot;: &quot;A String&quot;, # 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}
373      },
374    ],
375  },
376}</pre>
377</div>
378
379<div class="method">
380    <code class="details" id="update">update(project, policy, body=None, clientOperationId=None, x__xgafv=None)</code>
381  <pre>Updates an existing Policy.
382
383Args:
384  project: string, Identifies the project addressed by this request. (required)
385  policy: string, User given friendly name of the policy addressed by this request. (required)
386  body: object, The request body.
387    The object takes the form of:
388
389{ # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
390  &quot;alternativeNameServerConfig&quot;: { # 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.
391    &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
392    &quot;targetNameServers&quot;: [ # 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.
393      {
394        &quot;forwardingPath&quot;: &quot;A String&quot;, # Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.
395        &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
396        &quot;ipv6Address&quot;: &quot;A String&quot;, # IPv6 address to forward to. Does not accept both fields (ipv4 &amp; ipv6) being populated.
397        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
398      },
399    ],
400  },
401  &quot;description&quot;: &quot;A String&quot;, # A mutable string of at most 1024 characters associated with this resource for the user&#x27;s convenience. Has no effect on the policy&#x27;s function.
402  &quot;enableInboundForwarding&quot;: True or False, # Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.
403  &quot;enableLogging&quot;: True or False, # Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.
404  &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
405  &quot;kind&quot;: &quot;dns#policy&quot;,
406  &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
407  &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
408    {
409      &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
410      &quot;networkUrl&quot;: &quot;A String&quot;, # 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}
411    },
412  ],
413}
414
415  clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
416  x__xgafv: string, V1 error format.
417    Allowed values
418      1 - v1 error format
419      2 - v2 error format
420
421Returns:
422  An object of the form:
423
424    {
425  &quot;header&quot;: { # Elements common to every response.
426    &quot;operationId&quot;: &quot;A String&quot;, # 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).
427  },
428  &quot;policy&quot;: { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
429    &quot;alternativeNameServerConfig&quot;: { # 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.
430      &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
431      &quot;targetNameServers&quot;: [ # 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.
432        {
433          &quot;forwardingPath&quot;: &quot;A String&quot;, # Forwarding path for this TargetNameServer. If unset or set to DEFAULT, Cloud DNS makes forwarding decisions based on address ranges; that is, RFC1918 addresses go to the VPC network, non-RFC1918 addresses go to the internet. When set to PRIVATE, Cloud DNS always sends queries through the VPC network for this target.
434          &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
435          &quot;ipv6Address&quot;: &quot;A String&quot;, # IPv6 address to forward to. Does not accept both fields (ipv4 &amp; ipv6) being populated.
436          &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
437        },
438      ],
439    },
440    &quot;description&quot;: &quot;A String&quot;, # A mutable string of at most 1024 characters associated with this resource for the user&#x27;s convenience. Has no effect on the policy&#x27;s function.
441    &quot;enableInboundForwarding&quot;: True or False, # Allows networks bound to this policy to receive DNS queries sent by VMs or applications over VPN connections. When enabled, a virtual IP address is allocated from each of the subnetworks that are bound to this policy.
442    &quot;enableLogging&quot;: True or False, # Controls whether logging is enabled for the networks bound to this policy. Defaults to no logging if not set.
443    &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
444    &quot;kind&quot;: &quot;dns#policy&quot;,
445    &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
446    &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
447      {
448        &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
449        &quot;networkUrl&quot;: &quot;A String&quot;, # 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}
450      },
451    ],
452  },
453}</pre>
454</div>
455
456</body></html>