blob: f3a34bbac101510cf0a9225bc1031ecefb2bd546 [file] [log] [blame]
Bu Sun Kim65020912020-05-20 12:08:20 -07001<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
Bu Sun Kimd059ad82020-07-22 17:02:09 -070075<h1><a href="dns_v1.html">Cloud DNS API</a> . <a href="dns_v1.policies.html">policies</a></h1>
Bu Sun Kim65020912020-05-20 12:08:20 -070076<h2>Instance Methods</h2>
77<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070078 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070081 <code><a href="#create">create(project, body=None, clientOperationId=None, x__xgafv=None)</a></code></p>
yoshi-code-bota8b35b92021-03-31 13:33:30 -070082<p class="firstline">Creates a new Policy.</p>
Bu Sun Kim65020912020-05-20 12:08:20 -070083<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070084 <code><a href="#delete">delete(project, policy, clientOperationId=None, x__xgafv=None)</a></code></p>
yoshi-code-bota8b35b92021-03-31 13:33:30 -070085<p class="firstline">Deletes a previously created Policy. Fails if the policy is still being referenced by a network.</p>
Bu Sun Kim65020912020-05-20 12:08:20 -070086<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070087 <code><a href="#get">get(project, policy, clientOperationId=None, x__xgafv=None)</a></code></p>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080088<p class="firstline">Fetches the representation of an existing Policy.</p>
Bu Sun Kim65020912020-05-20 12:08:20 -070089<p class="toc_element">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080090 <code><a href="#list">list(project, maxResults=None, pageToken=None, x__xgafv=None)</a></code></p>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -080091<p class="firstline">Enumerates all Policies associated with a project.</p>
Bu Sun Kim65020912020-05-20 12:08:20 -070092<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">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070096 <code><a href="#patch">patch(project, policy, body=None, clientOperationId=None, x__xgafv=None)</a></code></p>
yoshi-code-bota8b35b92021-03-31 13:33:30 -070097<p class="firstline">Applies a partial update to an existing Policy.</p>
Bu Sun Kim65020912020-05-20 12:08:20 -070098<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070099 <code><a href="#update">update(project, policy, body=None, clientOperationId=None, x__xgafv=None)</a></code></p>
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700100<p class="firstline">Updates an existing Policy.</p>
Bu Sun Kim65020912020-05-20 12:08:20 -0700101<h3>Method Details</h3>
102<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700103 <code class="details" id="close">close()</code>
104 <pre>Close httplib2 connections.</pre>
105</div>
106
107<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700108 <code class="details" id="create">create(project, body=None, clientOperationId=None, x__xgafv=None)</code>
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700109 <pre>Creates a new Policy.
Bu Sun Kim65020912020-05-20 12:08:20 -0700110
111Args:
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700112 project: string, Identifies the project addressed by this request. (required)
Bu Sun Kim65020912020-05-20 12:08:20 -0700113 body: object, The request body.
114 The object takes the form of:
115
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700116{ # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800117 &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.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700120 {
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700121 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800122 &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
123 &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700124 },
125 ],
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800126 },
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.
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700128 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800129 &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;,
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800132 &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800133 &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}
Bu Sun Kim65020912020-05-20 12:08:20 -0700140
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700141 clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700142 x__xgafv: string, V1 error format.
143 Allowed values
144 1 - v1 error format
145 2 - v2 error format
Bu Sun Kim65020912020-05-20 12:08:20 -0700146
147Returns:
148 An object of the form:
149
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700150 { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800151 &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 {
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700155 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800156 &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
157 &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800158 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800159 ],
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.
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700162 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800163 &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;,
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800166 &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800167 &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>
Bu Sun Kim65020912020-05-20 12:08:20 -0700174</div>
175
176<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700177 <code class="details" id="delete">delete(project, policy, clientOperationId=None, x__xgafv=None)</code>
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700178 <pre>Deletes a previously created Policy. Fails if the policy is still being referenced by a network.
Bu Sun Kim65020912020-05-20 12:08:20 -0700179
180Args:
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700181 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)
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700183 clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700184 x__xgafv: string, V1 error format.
185 Allowed values
186 1 - v1 error format
187 2 - v2 error format
Bu Sun Kim65020912020-05-20 12:08:20 -0700188</pre>
189</div>
190
191<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700192 <code class="details" id="get">get(project, policy, clientOperationId=None, x__xgafv=None)</code>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800193 <pre>Fetches the representation of an existing Policy.
Bu Sun Kim65020912020-05-20 12:08:20 -0700194
195Args:
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700196 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)
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700198 clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700199 x__xgafv: string, V1 error format.
200 Allowed values
201 1 - v1 error format
202 2 - v2 error format
Bu Sun Kim65020912020-05-20 12:08:20 -0700203
204Returns:
205 An object of the form:
206
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700207 { # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800208 &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 {
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700212 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800213 &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
214 &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800215 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800216 ],
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.
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700219 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800220 &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;,
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800223 &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800224 &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>
Bu Sun Kim65020912020-05-20 12:08:20 -0700231</div>
232
233<div class="method">
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800234 <code class="details" id="list">list(project, maxResults=None, pageToken=None, x__xgafv=None)</code>
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800235 <pre>Enumerates all Policies associated with a project.
Bu Sun Kim65020912020-05-20 12:08:20 -0700236
237Args:
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700238 project: string, Identifies the project addressed by this request. (required)
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800239 maxResults: integer, Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800240 pageToken: string, Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700241 x__xgafv: string, V1 error format.
242 Allowed values
243 1 - v1 error format
244 2 - v2 error format
Bu Sun Kim65020912020-05-20 12:08:20 -0700245
246Returns:
247 An object of the form:
248
249 {
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800250 &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.
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700254 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800255 &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 {
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700261 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800262 &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
263 &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800264 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800265 ],
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.
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700268 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800269 &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;,
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800272 &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800273 &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}
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800277 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800278 ],
279 },
280 ],
281}</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700282</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">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700299 <code class="details" id="patch">patch(project, policy, body=None, clientOperationId=None, x__xgafv=None)</code>
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700300 <pre>Applies a partial update to an existing Policy.
Bu Sun Kim65020912020-05-20 12:08:20 -0700301
302Args:
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700303 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)
Bu Sun Kim65020912020-05-20 12:08:20 -0700305 body: object, The request body.
306 The object takes the form of:
307
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700308{ # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800309 &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.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700312 {
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700313 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800314 &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
315 &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700316 },
317 ],
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800318 },
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.
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700320 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800321 &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;,
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800324 &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800325 &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}
Bu Sun Kim65020912020-05-20 12:08:20 -0700332
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700333 clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700334 x__xgafv: string, V1 error format.
335 Allowed values
336 1 - v1 error format
337 2 - v2 error format
Bu Sun Kim65020912020-05-20 12:08:20 -0700338
339Returns:
340 An object of the form:
341
342 {
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800343 &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 {
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700351 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800352 &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
353 &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800354 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800355 ],
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.
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700358 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800359 &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;,
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800362 &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800363 &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}
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800367 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800368 ],
369 },
370}</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700371</div>
372
373<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700374 <code class="details" id="update">update(project, policy, body=None, clientOperationId=None, x__xgafv=None)</code>
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700375 <pre>Updates an existing Policy.
Bu Sun Kim65020912020-05-20 12:08:20 -0700376
377Args:
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700378 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)
Bu Sun Kim65020912020-05-20 12:08:20 -0700380 body: object, The request body.
381 The object takes the form of:
382
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700383{ # A policy is a collection of DNS rules applied to one or more Virtual Private Cloud resources.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800384 &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.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700387 {
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700388 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800389 &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
390 &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700391 },
392 ],
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800393 },
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.
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700395 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800396 &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;,
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800399 &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800400 &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}
Bu Sun Kim65020912020-05-20 12:08:20 -0700407
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700408 clientOperationId: string, For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700409 x__xgafv: string, V1 error format.
410 Allowed values
411 1 - v1 error format
412 2 - v2 error format
Bu Sun Kim65020912020-05-20 12:08:20 -0700413
414Returns:
415 An object of the form:
416
417 {
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800418 &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 {
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700426 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800427 &quot;ipv4Address&quot;: &quot;A String&quot;, # IPv4 address to forward to.
428 &quot;kind&quot;: &quot;dns#policyAlternativeNameServerConfigTargetNameServer&quot;,
Yoshi Automation Botb6971b02020-11-26 17:16:03 -0800429 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800430 ],
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.
yoshi-code-bota8b35b92021-03-31 13:33:30 -0700433 &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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800434 &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;,
yoshi-code-botb6dc1b92021-03-02 11:49:08 -0800437 &quot;name&quot;: &quot;A String&quot;, # User-assigned name for this policy.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800438 &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}
Bu Sun Kim65020912020-05-20 12:08:20 -0700442 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800443 ],
444 },
445}</pre>
Bu Sun Kim65020912020-05-20 12:08:20 -0700446</div>
447
448</body></html>