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_v1.html">Cloud DNS API</a> . <a href="dns_v1.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;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
124      },
125    ],
126  },
127  &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.
128  &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.
129  &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.
130  &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
131  &quot;kind&quot;: &quot;dns#policy&quot;,
132  &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
133  &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
134    {
135      &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
136      &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}
137    },
138  ],
139}
140
141  clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
142  x__xgafv: string, V1 error format.
143    Allowed values
144      1 - v1 error format
145      2 - v2 error format
146
147Returns:
148  An object of the form:
149
150    { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
151  &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.
152    &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
153    &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.
154      {
155        &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.
156        &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
157        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
158      },
159    ],
160  },
161  &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.
162  &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.
163  &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.
164  &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
165  &quot;kind&quot;: &quot;dns#policy&quot;,
166  &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
167  &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
168    {
169      &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
170      &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}
171    },
172  ],
173}</pre>
174</div>
175
176<div class="method">
177    <code class="details" id="delete">delete(project, policy, clientOperationId=None, x__xgafv=None)</code>
178  <pre>Deletes a previously created Policy. Fails if the policy is still being referenced by a network.
179
180Args:
181  project: string, Identifies the project addressed by this request. (required)
182  policy: string, User given friendly name of the policy addressed by this request. (required)
183  clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
184  x__xgafv: string, V1 error format.
185    Allowed values
186      1 - v1 error format
187      2 - v2 error format
188</pre>
189</div>
190
191<div class="method">
192    <code class="details" id="get">get(project, policy, clientOperationId=None, x__xgafv=None)</code>
193  <pre>Fetches the representation of an existing Policy.
194
195Args:
196  project: string, Identifies the project addressed by this request. (required)
197  policy: string, User given friendly name of the policy addressed by this request. (required)
198  clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
199  x__xgafv: string, V1 error format.
200    Allowed values
201      1 - v1 error format
202      2 - v2 error format
203
204Returns:
205  An object of the form:
206
207    { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
208  &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.
209    &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
210    &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.
211      {
212        &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.
213        &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
214        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
215      },
216    ],
217  },
218  &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.
219  &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.
220  &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.
221  &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
222  &quot;kind&quot;: &quot;dns#policy&quot;,
223  &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
224  &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
225    {
226      &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
227      &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}
228    },
229  ],
230}</pre>
231</div>
232
233<div class="method">
234    <code class="details" id="list">list(project, maxResults=None, pageToken=None, x__xgafv=None)</code>
235  <pre>Enumerates all Policies associated with a project.
236
237Args:
238  project: string, Identifies the project addressed by this request. (required)
239  maxResults: integer, Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
240  pageToken: string, Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
241  x__xgafv: string, V1 error format.
242    Allowed values
243      1 - v1 error format
244      2 - v2 error format
245
246Returns:
247  An object of the form:
248
249    {
250  &quot;header&quot;: { # Elements common to every response.
251    &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).
252  },
253  &quot;kind&quot;: &quot;dns#policiesListResponse&quot;, # Type of resource.
254  &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.
255  &quot;policies&quot;: [ # The policy resources.
256    { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
257      &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.
258        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
259        &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.
260          {
261            &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.
262            &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
263            &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
264          },
265        ],
266      },
267      &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.
268      &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.
269      &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.
270      &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
271      &quot;kind&quot;: &quot;dns#policy&quot;,
272      &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
273      &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
274        {
275          &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
276          &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}
277        },
278      ],
279    },
280  ],
281}</pre>
282</div>
283
284<div class="method">
285    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
286  <pre>Retrieves the next page of results.
287
288Args:
289  previous_request: The request for the previous page. (required)
290  previous_response: The response from the request for the previous page. (required)
291
292Returns:
293  A request object that you can call &#x27;execute()&#x27; on to request the next
294  page. Returns None if there are no more items in the collection.
295    </pre>
296</div>
297
298<div class="method">
299    <code class="details" id="patch">patch(project, policy, body=None, clientOperationId=None, x__xgafv=None)</code>
300  <pre>Applies a partial update to an existing Policy.
301
302Args:
303  project: string, Identifies the project addressed by this request. (required)
304  policy: string, User given friendly name of the policy addressed by this request. (required)
305  body: object, The request body.
306    The object takes the form of:
307
308{ # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
309  &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.
310    &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
311    &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.
312      {
313        &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.
314        &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
315        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
316      },
317    ],
318  },
319  &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.
320  &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.
321  &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.
322  &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
323  &quot;kind&quot;: &quot;dns#policy&quot;,
324  &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
325  &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
326    {
327      &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
328      &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}
329    },
330  ],
331}
332
333  clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
334  x__xgafv: string, V1 error format.
335    Allowed values
336      1 - v1 error format
337      2 - v2 error format
338
339Returns:
340  An object of the form:
341
342    {
343  &quot;header&quot;: { # Elements common to every response.
344    &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).
345  },
346  &quot;policy&quot;: { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
347    &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.
348      &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
349      &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.
350        {
351          &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.
352          &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
353          &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
354        },
355      ],
356    },
357    &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.
358    &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.
359    &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.
360    &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
361    &quot;kind&quot;: &quot;dns#policy&quot;,
362    &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
363    &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
364      {
365        &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
366        &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}
367      },
368    ],
369  },
370}</pre>
371</div>
372
373<div class="method">
374    <code class="details" id="update">update(project, policy, body=None, clientOperationId=None, x__xgafv=None)</code>
375  <pre>Updates an existing Policy.
376
377Args:
378  project: string, Identifies the project addressed by this request. (required)
379  policy: string, User given friendly name of the policy addressed by this request. (required)
380  body: object, The request body.
381    The object takes the form of:
382
383{ # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
384  &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.
385    &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
386    &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.
387      {
388        &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.
389        &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
390        &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
391      },
392    ],
393  },
394  &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.
395  &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.
396  &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.
397  &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
398  &quot;kind&quot;: &quot;dns#policy&quot;,
399  &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
400  &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
401    {
402      &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
403      &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}
404    },
405  ],
406}
407
408  clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
409  x__xgafv: string, V1 error format.
410    Allowed values
411      1 - v1 error format
412      2 - v2 error format
413
414Returns:
415  An object of the form:
416
417    {
418  &quot;header&quot;: { # Elements common to every response.
419    &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).
420  },
421  &quot;policy&quot;: { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
422    &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.
423      &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfig&quot;,
424      &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.
425        {
426          &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.
427          &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
428          &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
429        },
430      ],
431    },
432    &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.
433    &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.
434    &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.
435    &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server (output only).
436    &quot;kind&quot;: &quot;dns#policy&quot;,
437    &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
438    &quot;networks&quot;: [ # List of network names specifying networks to which this policy is applied.
439      {
440        &quot;kind&quot;: &quot;dns#policyNetwork&quot;,
441        &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}
442      },
443    ],
444  },
445}</pre>
446</div>
447
448</body></html>