@googleapis/dns 7.0.1 → 8.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/v1beta2.ts CHANGED
@@ -1202,6 +1202,79 @@ export namespace dns_v1beta2 {
1202
1202
 
1203
1203
  /**
1204
1204
  * Atomically updates the ResourceRecordSet collection.
1205
+ * @example
1206
+ * ```js
1207
+ * // Before running the sample:
1208
+ * // - Enable the API at:
1209
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1210
+ * // - Login into gcloud by running:
1211
+ * // ```sh
1212
+ * // $ gcloud auth application-default login
1213
+ * // ```
1214
+ * // - Install the npm module by running:
1215
+ * // ```sh
1216
+ * // $ npm install googleapis
1217
+ * // ```
1218
+ *
1219
+ * const {google} = require('googleapis');
1220
+ * const dns = google.dns('v1beta2');
1221
+ *
1222
+ * async function main() {
1223
+ * const auth = new google.auth.GoogleAuth({
1224
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1225
+ * scopes: [
1226
+ * 'https://www.googleapis.com/auth/cloud-platform',
1227
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1228
+ * ],
1229
+ * });
1230
+ *
1231
+ * // Acquire an auth client, and bind it to all future calls
1232
+ * const authClient = await auth.getClient();
1233
+ * google.options({auth: authClient});
1234
+ *
1235
+ * // Do the magic
1236
+ * const res = await dns.changes.create({
1237
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
1238
+ * clientOperationId: 'placeholder-value',
1239
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1240
+ * managedZone: 'placeholder-value',
1241
+ * // Identifies the project addressed by this request.
1242
+ * project: 'placeholder-value',
1243
+ *
1244
+ * // Request body metadata
1245
+ * requestBody: {
1246
+ * // request body parameters
1247
+ * // {
1248
+ * // "additions": [],
1249
+ * // "deletions": [],
1250
+ * // "id": "my_id",
1251
+ * // "isServing": false,
1252
+ * // "kind": "my_kind",
1253
+ * // "startTime": "my_startTime",
1254
+ * // "status": "my_status"
1255
+ * // }
1256
+ * },
1257
+ * });
1258
+ * console.log(res.data);
1259
+ *
1260
+ * // Example response
1261
+ * // {
1262
+ * // "additions": [],
1263
+ * // "deletions": [],
1264
+ * // "id": "my_id",
1265
+ * // "isServing": false,
1266
+ * // "kind": "my_kind",
1267
+ * // "startTime": "my_startTime",
1268
+ * // "status": "my_status"
1269
+ * // }
1270
+ * }
1271
+ *
1272
+ * main().catch(e => {
1273
+ * console.error(e);
1274
+ * throw e;
1275
+ * });
1276
+ *
1277
+ * ```
1205
1278
  *
1206
1279
  * @param params - Parameters for request
1207
1280
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1292,6 +1365,69 @@ export namespace dns_v1beta2 {
1292
1365
 
1293
1366
  /**
1294
1367
  * Fetches the representation of an existing Change.
1368
+ * @example
1369
+ * ```js
1370
+ * // Before running the sample:
1371
+ * // - Enable the API at:
1372
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1373
+ * // - Login into gcloud by running:
1374
+ * // ```sh
1375
+ * // $ gcloud auth application-default login
1376
+ * // ```
1377
+ * // - Install the npm module by running:
1378
+ * // ```sh
1379
+ * // $ npm install googleapis
1380
+ * // ```
1381
+ *
1382
+ * const {google} = require('googleapis');
1383
+ * const dns = google.dns('v1beta2');
1384
+ *
1385
+ * async function main() {
1386
+ * const auth = new google.auth.GoogleAuth({
1387
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1388
+ * scopes: [
1389
+ * 'https://www.googleapis.com/auth/cloud-platform',
1390
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1391
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
1392
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1393
+ * ],
1394
+ * });
1395
+ *
1396
+ * // Acquire an auth client, and bind it to all future calls
1397
+ * const authClient = await auth.getClient();
1398
+ * google.options({auth: authClient});
1399
+ *
1400
+ * // Do the magic
1401
+ * const res = await dns.changes.get({
1402
+ * // The identifier of the requested change, from a previous ResourceRecordSetsChangeResponse.
1403
+ * changeId: 'placeholder-value',
1404
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
1405
+ * clientOperationId: 'placeholder-value',
1406
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1407
+ * managedZone: 'placeholder-value',
1408
+ * // Identifies the project addressed by this request.
1409
+ * project: 'placeholder-value',
1410
+ * });
1411
+ * console.log(res.data);
1412
+ *
1413
+ * // Example response
1414
+ * // {
1415
+ * // "additions": [],
1416
+ * // "deletions": [],
1417
+ * // "id": "my_id",
1418
+ * // "isServing": false,
1419
+ * // "kind": "my_kind",
1420
+ * // "startTime": "my_startTime",
1421
+ * // "status": "my_status"
1422
+ * // }
1423
+ * }
1424
+ *
1425
+ * main().catch(e => {
1426
+ * console.error(e);
1427
+ * throw e;
1428
+ * });
1429
+ *
1430
+ * ```
1295
1431
  *
1296
1432
  * @param params - Parameters for request
1297
1433
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1382,6 +1518,69 @@ export namespace dns_v1beta2 {
1382
1518
 
1383
1519
  /**
1384
1520
  * Enumerates Changes to a ResourceRecordSet collection.
1521
+ * @example
1522
+ * ```js
1523
+ * // Before running the sample:
1524
+ * // - Enable the API at:
1525
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1526
+ * // - Login into gcloud by running:
1527
+ * // ```sh
1528
+ * // $ gcloud auth application-default login
1529
+ * // ```
1530
+ * // - Install the npm module by running:
1531
+ * // ```sh
1532
+ * // $ npm install googleapis
1533
+ * // ```
1534
+ *
1535
+ * const {google} = require('googleapis');
1536
+ * const dns = google.dns('v1beta2');
1537
+ *
1538
+ * async function main() {
1539
+ * const auth = new google.auth.GoogleAuth({
1540
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1541
+ * scopes: [
1542
+ * 'https://www.googleapis.com/auth/cloud-platform',
1543
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1544
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
1545
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1546
+ * ],
1547
+ * });
1548
+ *
1549
+ * // Acquire an auth client, and bind it to all future calls
1550
+ * const authClient = await auth.getClient();
1551
+ * google.options({auth: authClient});
1552
+ *
1553
+ * // Do the magic
1554
+ * const res = await dns.changes.list({
1555
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1556
+ * managedZone: 'placeholder-value',
1557
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
1558
+ * maxResults: 'placeholder-value',
1559
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
1560
+ * pageToken: 'placeholder-value',
1561
+ * // Identifies the project addressed by this request.
1562
+ * project: 'placeholder-value',
1563
+ * // Sorting criterion. The only supported value is change sequence.
1564
+ * sortBy: 'placeholder-value',
1565
+ * // Sorting order direction: 'ascending' or 'descending'.
1566
+ * sortOrder: 'placeholder-value',
1567
+ * });
1568
+ * console.log(res.data);
1569
+ *
1570
+ * // Example response
1571
+ * // {
1572
+ * // "changes": [],
1573
+ * // "kind": "my_kind",
1574
+ * // "nextPageToken": "my_nextPageToken"
1575
+ * // }
1576
+ * }
1577
+ *
1578
+ * main().catch(e => {
1579
+ * console.error(e);
1580
+ * throw e;
1581
+ * });
1582
+ *
1583
+ * ```
1385
1584
  *
1386
1585
  * @param params - Parameters for request
1387
1586
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1543,6 +1742,75 @@ export namespace dns_v1beta2 {
1543
1742
 
1544
1743
  /**
1545
1744
  * Fetches the representation of an existing DnsKey.
1745
+ * @example
1746
+ * ```js
1747
+ * // Before running the sample:
1748
+ * // - Enable the API at:
1749
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1750
+ * // - Login into gcloud by running:
1751
+ * // ```sh
1752
+ * // $ gcloud auth application-default login
1753
+ * // ```
1754
+ * // - Install the npm module by running:
1755
+ * // ```sh
1756
+ * // $ npm install googleapis
1757
+ * // ```
1758
+ *
1759
+ * const {google} = require('googleapis');
1760
+ * const dns = google.dns('v1beta2');
1761
+ *
1762
+ * async function main() {
1763
+ * const auth = new google.auth.GoogleAuth({
1764
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1765
+ * scopes: [
1766
+ * 'https://www.googleapis.com/auth/cloud-platform',
1767
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1768
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
1769
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1770
+ * ],
1771
+ * });
1772
+ *
1773
+ * // Acquire an auth client, and bind it to all future calls
1774
+ * const authClient = await auth.getClient();
1775
+ * google.options({auth: authClient});
1776
+ *
1777
+ * // Do the magic
1778
+ * const res = await dns.dnsKeys.get({
1779
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
1780
+ * clientOperationId: 'placeholder-value',
1781
+ * // An optional comma-separated list of digest types to compute and display for key signing keys. If omitted, the recommended digest type is computed and displayed.
1782
+ * digestType: 'placeholder-value',
1783
+ * // The identifier of the requested DnsKey.
1784
+ * dnsKeyId: 'placeholder-value',
1785
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1786
+ * managedZone: 'placeholder-value',
1787
+ * // Identifies the project addressed by this request.
1788
+ * project: 'placeholder-value',
1789
+ * });
1790
+ * console.log(res.data);
1791
+ *
1792
+ * // Example response
1793
+ * // {
1794
+ * // "algorithm": "my_algorithm",
1795
+ * // "creationTime": "my_creationTime",
1796
+ * // "description": "my_description",
1797
+ * // "digests": [],
1798
+ * // "id": "my_id",
1799
+ * // "isActive": false,
1800
+ * // "keyLength": 0,
1801
+ * // "keyTag": 0,
1802
+ * // "kind": "my_kind",
1803
+ * // "publicKey": "my_publicKey",
1804
+ * // "type": "my_type"
1805
+ * // }
1806
+ * }
1807
+ *
1808
+ * main().catch(e => {
1809
+ * console.error(e);
1810
+ * throw e;
1811
+ * });
1812
+ *
1813
+ * ```
1546
1814
  *
1547
1815
  * @param params - Parameters for request
1548
1816
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1633,6 +1901,67 @@ export namespace dns_v1beta2 {
1633
1901
 
1634
1902
  /**
1635
1903
  * Enumerates DnsKeys to a ResourceRecordSet collection.
1904
+ * @example
1905
+ * ```js
1906
+ * // Before running the sample:
1907
+ * // - Enable the API at:
1908
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1909
+ * // - Login into gcloud by running:
1910
+ * // ```sh
1911
+ * // $ gcloud auth application-default login
1912
+ * // ```
1913
+ * // - Install the npm module by running:
1914
+ * // ```sh
1915
+ * // $ npm install googleapis
1916
+ * // ```
1917
+ *
1918
+ * const {google} = require('googleapis');
1919
+ * const dns = google.dns('v1beta2');
1920
+ *
1921
+ * async function main() {
1922
+ * const auth = new google.auth.GoogleAuth({
1923
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1924
+ * scopes: [
1925
+ * 'https://www.googleapis.com/auth/cloud-platform',
1926
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1927
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
1928
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1929
+ * ],
1930
+ * });
1931
+ *
1932
+ * // Acquire an auth client, and bind it to all future calls
1933
+ * const authClient = await auth.getClient();
1934
+ * google.options({auth: authClient});
1935
+ *
1936
+ * // Do the magic
1937
+ * const res = await dns.dnsKeys.list({
1938
+ * // An optional comma-separated list of digest types to compute and display for key signing keys. If omitted, the recommended digest type is computed and displayed.
1939
+ * digestType: 'placeholder-value',
1940
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1941
+ * managedZone: 'placeholder-value',
1942
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
1943
+ * maxResults: 'placeholder-value',
1944
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
1945
+ * pageToken: 'placeholder-value',
1946
+ * // Identifies the project addressed by this request.
1947
+ * project: 'placeholder-value',
1948
+ * });
1949
+ * console.log(res.data);
1950
+ *
1951
+ * // Example response
1952
+ * // {
1953
+ * // "dnsKeys": [],
1954
+ * // "kind": "my_kind",
1955
+ * // "nextPageToken": "my_nextPageToken"
1956
+ * // }
1957
+ * }
1958
+ *
1959
+ * main().catch(e => {
1960
+ * console.error(e);
1961
+ * throw e;
1962
+ * });
1963
+ *
1964
+ * ```
1636
1965
  *
1637
1966
  * @param params - Parameters for request
1638
1967
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1775,6 +2104,70 @@ export namespace dns_v1beta2 {
1775
2104
 
1776
2105
  /**
1777
2106
  * Fetches the representation of an existing Operation.
2107
+ * @example
2108
+ * ```js
2109
+ * // Before running the sample:
2110
+ * // - Enable the API at:
2111
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2112
+ * // - Login into gcloud by running:
2113
+ * // ```sh
2114
+ * // $ gcloud auth application-default login
2115
+ * // ```
2116
+ * // - Install the npm module by running:
2117
+ * // ```sh
2118
+ * // $ npm install googleapis
2119
+ * // ```
2120
+ *
2121
+ * const {google} = require('googleapis');
2122
+ * const dns = google.dns('v1beta2');
2123
+ *
2124
+ * async function main() {
2125
+ * const auth = new google.auth.GoogleAuth({
2126
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2127
+ * scopes: [
2128
+ * 'https://www.googleapis.com/auth/cloud-platform',
2129
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
2130
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
2131
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2132
+ * ],
2133
+ * });
2134
+ *
2135
+ * // Acquire an auth client, and bind it to all future calls
2136
+ * const authClient = await auth.getClient();
2137
+ * google.options({auth: authClient});
2138
+ *
2139
+ * // Do the magic
2140
+ * const res = await dns.managedZoneOperations.get({
2141
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
2142
+ * clientOperationId: 'placeholder-value',
2143
+ * // Identifies the managed zone addressed by this request.
2144
+ * managedZone: 'placeholder-value',
2145
+ * // Identifies the operation addressed by this request (ID of the operation).
2146
+ * operation: 'placeholder-value',
2147
+ * // Identifies the project addressed by this request.
2148
+ * project: 'placeholder-value',
2149
+ * });
2150
+ * console.log(res.data);
2151
+ *
2152
+ * // Example response
2153
+ * // {
2154
+ * // "dnsKeyContext": {},
2155
+ * // "id": "my_id",
2156
+ * // "kind": "my_kind",
2157
+ * // "startTime": "my_startTime",
2158
+ * // "status": "my_status",
2159
+ * // "type": "my_type",
2160
+ * // "user": "my_user",
2161
+ * // "zoneContext": {}
2162
+ * // }
2163
+ * }
2164
+ *
2165
+ * main().catch(e => {
2166
+ * console.error(e);
2167
+ * throw e;
2168
+ * });
2169
+ *
2170
+ * ```
1778
2171
  *
1779
2172
  * @param params - Parameters for request
1780
2173
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1866,6 +2259,67 @@ export namespace dns_v1beta2 {
1866
2259
 
1867
2260
  /**
1868
2261
  * Enumerates Operations for the given ManagedZone.
2262
+ * @example
2263
+ * ```js
2264
+ * // Before running the sample:
2265
+ * // - Enable the API at:
2266
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2267
+ * // - Login into gcloud by running:
2268
+ * // ```sh
2269
+ * // $ gcloud auth application-default login
2270
+ * // ```
2271
+ * // - Install the npm module by running:
2272
+ * // ```sh
2273
+ * // $ npm install googleapis
2274
+ * // ```
2275
+ *
2276
+ * const {google} = require('googleapis');
2277
+ * const dns = google.dns('v1beta2');
2278
+ *
2279
+ * async function main() {
2280
+ * const auth = new google.auth.GoogleAuth({
2281
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2282
+ * scopes: [
2283
+ * 'https://www.googleapis.com/auth/cloud-platform',
2284
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
2285
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
2286
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2287
+ * ],
2288
+ * });
2289
+ *
2290
+ * // Acquire an auth client, and bind it to all future calls
2291
+ * const authClient = await auth.getClient();
2292
+ * google.options({auth: authClient});
2293
+ *
2294
+ * // Do the magic
2295
+ * const res = await dns.managedZoneOperations.list({
2296
+ * // Identifies the managed zone addressed by this request.
2297
+ * managedZone: 'placeholder-value',
2298
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
2299
+ * maxResults: 'placeholder-value',
2300
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
2301
+ * pageToken: 'placeholder-value',
2302
+ * // Identifies the project addressed by this request.
2303
+ * project: 'placeholder-value',
2304
+ * // Sorting criterion. The only supported values are START_TIME and ID.
2305
+ * sortBy: 'placeholder-value',
2306
+ * });
2307
+ * console.log(res.data);
2308
+ *
2309
+ * // Example response
2310
+ * // {
2311
+ * // "kind": "my_kind",
2312
+ * // "nextPageToken": "my_nextPageToken",
2313
+ * // "operations": []
2314
+ * // }
2315
+ * }
2316
+ *
2317
+ * main().catch(e => {
2318
+ * console.error(e);
2319
+ * throw e;
2320
+ * });
2321
+ *
2322
+ * ```
1869
2323
  *
1870
2324
  * @param params - Parameters for request
1871
2325
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2017,6 +2471,97 @@ export namespace dns_v1beta2 {
2017
2471
 
2018
2472
  /**
2019
2473
  * Creates a new ManagedZone.
2474
+ * @example
2475
+ * ```js
2476
+ * // Before running the sample:
2477
+ * // - Enable the API at:
2478
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2479
+ * // - Login into gcloud by running:
2480
+ * // ```sh
2481
+ * // $ gcloud auth application-default login
2482
+ * // ```
2483
+ * // - Install the npm module by running:
2484
+ * // ```sh
2485
+ * // $ npm install googleapis
2486
+ * // ```
2487
+ *
2488
+ * const {google} = require('googleapis');
2489
+ * const dns = google.dns('v1beta2');
2490
+ *
2491
+ * async function main() {
2492
+ * const auth = new google.auth.GoogleAuth({
2493
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2494
+ * scopes: [
2495
+ * 'https://www.googleapis.com/auth/cloud-platform',
2496
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2497
+ * ],
2498
+ * });
2499
+ *
2500
+ * // Acquire an auth client, and bind it to all future calls
2501
+ * const authClient = await auth.getClient();
2502
+ * google.options({auth: authClient});
2503
+ *
2504
+ * // Do the magic
2505
+ * const res = await dns.managedZones.create({
2506
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
2507
+ * clientOperationId: 'placeholder-value',
2508
+ * // Identifies the project addressed by this request.
2509
+ * project: 'placeholder-value',
2510
+ *
2511
+ * // Request body metadata
2512
+ * requestBody: {
2513
+ * // request body parameters
2514
+ * // {
2515
+ * // "cloudLoggingConfig": {},
2516
+ * // "creationTime": "my_creationTime",
2517
+ * // "description": "my_description",
2518
+ * // "dnsName": "my_dnsName",
2519
+ * // "dnssecConfig": {},
2520
+ * // "forwardingConfig": {},
2521
+ * // "id": "my_id",
2522
+ * // "kind": "my_kind",
2523
+ * // "labels": {},
2524
+ * // "name": "my_name",
2525
+ * // "nameServerSet": "my_nameServerSet",
2526
+ * // "nameServers": [],
2527
+ * // "peeringConfig": {},
2528
+ * // "privateVisibilityConfig": {},
2529
+ * // "reverseLookupConfig": {},
2530
+ * // "serviceDirectoryConfig": {},
2531
+ * // "visibility": "my_visibility"
2532
+ * // }
2533
+ * },
2534
+ * });
2535
+ * console.log(res.data);
2536
+ *
2537
+ * // Example response
2538
+ * // {
2539
+ * // "cloudLoggingConfig": {},
2540
+ * // "creationTime": "my_creationTime",
2541
+ * // "description": "my_description",
2542
+ * // "dnsName": "my_dnsName",
2543
+ * // "dnssecConfig": {},
2544
+ * // "forwardingConfig": {},
2545
+ * // "id": "my_id",
2546
+ * // "kind": "my_kind",
2547
+ * // "labels": {},
2548
+ * // "name": "my_name",
2549
+ * // "nameServerSet": "my_nameServerSet",
2550
+ * // "nameServers": [],
2551
+ * // "peeringConfig": {},
2552
+ * // "privateVisibilityConfig": {},
2553
+ * // "reverseLookupConfig": {},
2554
+ * // "serviceDirectoryConfig": {},
2555
+ * // "visibility": "my_visibility"
2556
+ * // }
2557
+ * }
2558
+ *
2559
+ * main().catch(e => {
2560
+ * console.error(e);
2561
+ * throw e;
2562
+ * });
2563
+ *
2564
+ * ```
2020
2565
  *
2021
2566
  * @param params - Parameters for request
2022
2567
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2107,6 +2652,54 @@ export namespace dns_v1beta2 {
2107
2652
 
2108
2653
  /**
2109
2654
  * Deletes a previously created ManagedZone.
2655
+ * @example
2656
+ * ```js
2657
+ * // Before running the sample:
2658
+ * // - Enable the API at:
2659
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2660
+ * // - Login into gcloud by running:
2661
+ * // ```sh
2662
+ * // $ gcloud auth application-default login
2663
+ * // ```
2664
+ * // - Install the npm module by running:
2665
+ * // ```sh
2666
+ * // $ npm install googleapis
2667
+ * // ```
2668
+ *
2669
+ * const {google} = require('googleapis');
2670
+ * const dns = google.dns('v1beta2');
2671
+ *
2672
+ * async function main() {
2673
+ * const auth = new google.auth.GoogleAuth({
2674
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2675
+ * scopes: [
2676
+ * 'https://www.googleapis.com/auth/cloud-platform',
2677
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2678
+ * ],
2679
+ * });
2680
+ *
2681
+ * // Acquire an auth client, and bind it to all future calls
2682
+ * const authClient = await auth.getClient();
2683
+ * google.options({auth: authClient});
2684
+ *
2685
+ * // Do the magic
2686
+ * const res = await dns.managedZones.delete({
2687
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
2688
+ * clientOperationId: 'placeholder-value',
2689
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
2690
+ * managedZone: 'placeholder-value',
2691
+ * // Identifies the project addressed by this request.
2692
+ * project: 'placeholder-value',
2693
+ * });
2694
+ * console.log(res.data);
2695
+ * }
2696
+ *
2697
+ * main().catch(e => {
2698
+ * console.error(e);
2699
+ * throw e;
2700
+ * });
2701
+ *
2702
+ * ```
2110
2703
  *
2111
2704
  * @param params - Parameters for request
2112
2705
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2196,6 +2789,77 @@ export namespace dns_v1beta2 {
2196
2789
 
2197
2790
  /**
2198
2791
  * Fetches the representation of an existing ManagedZone.
2792
+ * @example
2793
+ * ```js
2794
+ * // Before running the sample:
2795
+ * // - Enable the API at:
2796
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2797
+ * // - Login into gcloud by running:
2798
+ * // ```sh
2799
+ * // $ gcloud auth application-default login
2800
+ * // ```
2801
+ * // - Install the npm module by running:
2802
+ * // ```sh
2803
+ * // $ npm install googleapis
2804
+ * // ```
2805
+ *
2806
+ * const {google} = require('googleapis');
2807
+ * const dns = google.dns('v1beta2');
2808
+ *
2809
+ * async function main() {
2810
+ * const auth = new google.auth.GoogleAuth({
2811
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2812
+ * scopes: [
2813
+ * 'https://www.googleapis.com/auth/cloud-platform',
2814
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
2815
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
2816
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2817
+ * ],
2818
+ * });
2819
+ *
2820
+ * // Acquire an auth client, and bind it to all future calls
2821
+ * const authClient = await auth.getClient();
2822
+ * google.options({auth: authClient});
2823
+ *
2824
+ * // Do the magic
2825
+ * const res = await dns.managedZones.get({
2826
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
2827
+ * clientOperationId: 'placeholder-value',
2828
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
2829
+ * managedZone: 'placeholder-value',
2830
+ * // Identifies the project addressed by this request.
2831
+ * project: 'placeholder-value',
2832
+ * });
2833
+ * console.log(res.data);
2834
+ *
2835
+ * // Example response
2836
+ * // {
2837
+ * // "cloudLoggingConfig": {},
2838
+ * // "creationTime": "my_creationTime",
2839
+ * // "description": "my_description",
2840
+ * // "dnsName": "my_dnsName",
2841
+ * // "dnssecConfig": {},
2842
+ * // "forwardingConfig": {},
2843
+ * // "id": "my_id",
2844
+ * // "kind": "my_kind",
2845
+ * // "labels": {},
2846
+ * // "name": "my_name",
2847
+ * // "nameServerSet": "my_nameServerSet",
2848
+ * // "nameServers": [],
2849
+ * // "peeringConfig": {},
2850
+ * // "privateVisibilityConfig": {},
2851
+ * // "reverseLookupConfig": {},
2852
+ * // "serviceDirectoryConfig": {},
2853
+ * // "visibility": "my_visibility"
2854
+ * // }
2855
+ * }
2856
+ *
2857
+ * main().catch(e => {
2858
+ * console.error(e);
2859
+ * throw e;
2860
+ * });
2861
+ *
2862
+ * ```
2199
2863
  *
2200
2864
  * @param params - Parameters for request
2201
2865
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2286,6 +2950,68 @@ export namespace dns_v1beta2 {
2286
2950
 
2287
2951
  /**
2288
2952
  * Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
2953
+ * @example
2954
+ * ```js
2955
+ * // Before running the sample:
2956
+ * // - Enable the API at:
2957
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2958
+ * // - Login into gcloud by running:
2959
+ * // ```sh
2960
+ * // $ gcloud auth application-default login
2961
+ * // ```
2962
+ * // - Install the npm module by running:
2963
+ * // ```sh
2964
+ * // $ npm install googleapis
2965
+ * // ```
2966
+ *
2967
+ * const {google} = require('googleapis');
2968
+ * const dns = google.dns('v1beta2');
2969
+ *
2970
+ * async function main() {
2971
+ * const auth = new google.auth.GoogleAuth({
2972
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2973
+ * scopes: [
2974
+ * 'https://www.googleapis.com/auth/cloud-platform',
2975
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
2976
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
2977
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2978
+ * ],
2979
+ * });
2980
+ *
2981
+ * // Acquire an auth client, and bind it to all future calls
2982
+ * const authClient = await auth.getClient();
2983
+ * google.options({auth: authClient});
2984
+ *
2985
+ * // Do the magic
2986
+ * const res = await dns.managedZones.getIamPolicy({
2987
+ * // REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
2988
+ * resource: 'projects/my-project/managedZones/my-managedZone',
2989
+ *
2990
+ * // Request body metadata
2991
+ * requestBody: {
2992
+ * // request body parameters
2993
+ * // {
2994
+ * // "options": {}
2995
+ * // }
2996
+ * },
2997
+ * });
2998
+ * console.log(res.data);
2999
+ *
3000
+ * // Example response
3001
+ * // {
3002
+ * // "auditConfigs": [],
3003
+ * // "bindings": [],
3004
+ * // "etag": "my_etag",
3005
+ * // "version": 0
3006
+ * // }
3007
+ * }
3008
+ *
3009
+ * main().catch(e => {
3010
+ * console.error(e);
3011
+ * throw e;
3012
+ * });
3013
+ *
3014
+ * ```
2289
3015
  *
2290
3016
  * @param params - Parameters for request
2291
3017
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2379,6 +3105,65 @@ export namespace dns_v1beta2 {
2379
3105
 
2380
3106
  /**
2381
3107
  * Enumerates ManagedZones that have been created but not yet deleted.
3108
+ * @example
3109
+ * ```js
3110
+ * // Before running the sample:
3111
+ * // - Enable the API at:
3112
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3113
+ * // - Login into gcloud by running:
3114
+ * // ```sh
3115
+ * // $ gcloud auth application-default login
3116
+ * // ```
3117
+ * // - Install the npm module by running:
3118
+ * // ```sh
3119
+ * // $ npm install googleapis
3120
+ * // ```
3121
+ *
3122
+ * const {google} = require('googleapis');
3123
+ * const dns = google.dns('v1beta2');
3124
+ *
3125
+ * async function main() {
3126
+ * const auth = new google.auth.GoogleAuth({
3127
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3128
+ * scopes: [
3129
+ * 'https://www.googleapis.com/auth/cloud-platform',
3130
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
3131
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
3132
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3133
+ * ],
3134
+ * });
3135
+ *
3136
+ * // Acquire an auth client, and bind it to all future calls
3137
+ * const authClient = await auth.getClient();
3138
+ * google.options({auth: authClient});
3139
+ *
3140
+ * // Do the magic
3141
+ * const res = await dns.managedZones.list({
3142
+ * // Restricts the list to return only zones with this domain name.
3143
+ * dnsName: 'placeholder-value',
3144
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
3145
+ * maxResults: 'placeholder-value',
3146
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
3147
+ * pageToken: 'placeholder-value',
3148
+ * // Identifies the project addressed by this request.
3149
+ * project: 'placeholder-value',
3150
+ * });
3151
+ * console.log(res.data);
3152
+ *
3153
+ * // Example response
3154
+ * // {
3155
+ * // "kind": "my_kind",
3156
+ * // "managedZones": [],
3157
+ * // "nextPageToken": "my_nextPageToken"
3158
+ * // }
3159
+ * }
3160
+ *
3161
+ * main().catch(e => {
3162
+ * console.error(e);
3163
+ * throw e;
3164
+ * });
3165
+ *
3166
+ * ```
2382
3167
  *
2383
3168
  * @param params - Parameters for request
2384
3169
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2471,6 +3256,90 @@ export namespace dns_v1beta2 {
2471
3256
 
2472
3257
  /**
2473
3258
  * Applies a partial update to an existing ManagedZone.
3259
+ * @example
3260
+ * ```js
3261
+ * // Before running the sample:
3262
+ * // - Enable the API at:
3263
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3264
+ * // - Login into gcloud by running:
3265
+ * // ```sh
3266
+ * // $ gcloud auth application-default login
3267
+ * // ```
3268
+ * // - Install the npm module by running:
3269
+ * // ```sh
3270
+ * // $ npm install googleapis
3271
+ * // ```
3272
+ *
3273
+ * const {google} = require('googleapis');
3274
+ * const dns = google.dns('v1beta2');
3275
+ *
3276
+ * async function main() {
3277
+ * const auth = new google.auth.GoogleAuth({
3278
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3279
+ * scopes: [
3280
+ * 'https://www.googleapis.com/auth/cloud-platform',
3281
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3282
+ * ],
3283
+ * });
3284
+ *
3285
+ * // Acquire an auth client, and bind it to all future calls
3286
+ * const authClient = await auth.getClient();
3287
+ * google.options({auth: authClient});
3288
+ *
3289
+ * // Do the magic
3290
+ * const res = await dns.managedZones.patch({
3291
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
3292
+ * clientOperationId: 'placeholder-value',
3293
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
3294
+ * managedZone: 'placeholder-value',
3295
+ * // Identifies the project addressed by this request.
3296
+ * project: 'placeholder-value',
3297
+ *
3298
+ * // Request body metadata
3299
+ * requestBody: {
3300
+ * // request body parameters
3301
+ * // {
3302
+ * // "cloudLoggingConfig": {},
3303
+ * // "creationTime": "my_creationTime",
3304
+ * // "description": "my_description",
3305
+ * // "dnsName": "my_dnsName",
3306
+ * // "dnssecConfig": {},
3307
+ * // "forwardingConfig": {},
3308
+ * // "id": "my_id",
3309
+ * // "kind": "my_kind",
3310
+ * // "labels": {},
3311
+ * // "name": "my_name",
3312
+ * // "nameServerSet": "my_nameServerSet",
3313
+ * // "nameServers": [],
3314
+ * // "peeringConfig": {},
3315
+ * // "privateVisibilityConfig": {},
3316
+ * // "reverseLookupConfig": {},
3317
+ * // "serviceDirectoryConfig": {},
3318
+ * // "visibility": "my_visibility"
3319
+ * // }
3320
+ * },
3321
+ * });
3322
+ * console.log(res.data);
3323
+ *
3324
+ * // Example response
3325
+ * // {
3326
+ * // "dnsKeyContext": {},
3327
+ * // "id": "my_id",
3328
+ * // "kind": "my_kind",
3329
+ * // "startTime": "my_startTime",
3330
+ * // "status": "my_status",
3331
+ * // "type": "my_type",
3332
+ * // "user": "my_user",
3333
+ * // "zoneContext": {}
3334
+ * // }
3335
+ * }
3336
+ *
3337
+ * main().catch(e => {
3338
+ * console.error(e);
3339
+ * throw e;
3340
+ * });
3341
+ *
3342
+ * ```
2474
3343
  *
2475
3344
  * @param params - Parameters for request
2476
3345
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2562,6 +3431,67 @@ export namespace dns_v1beta2 {
2562
3431
 
2563
3432
  /**
2564
3433
  * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
3434
+ * @example
3435
+ * ```js
3436
+ * // Before running the sample:
3437
+ * // - Enable the API at:
3438
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3439
+ * // - Login into gcloud by running:
3440
+ * // ```sh
3441
+ * // $ gcloud auth application-default login
3442
+ * // ```
3443
+ * // - Install the npm module by running:
3444
+ * // ```sh
3445
+ * // $ npm install googleapis
3446
+ * // ```
3447
+ *
3448
+ * const {google} = require('googleapis');
3449
+ * const dns = google.dns('v1beta2');
3450
+ *
3451
+ * async function main() {
3452
+ * const auth = new google.auth.GoogleAuth({
3453
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3454
+ * scopes: [
3455
+ * 'https://www.googleapis.com/auth/cloud-platform',
3456
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3457
+ * ],
3458
+ * });
3459
+ *
3460
+ * // Acquire an auth client, and bind it to all future calls
3461
+ * const authClient = await auth.getClient();
3462
+ * google.options({auth: authClient});
3463
+ *
3464
+ * // Do the magic
3465
+ * const res = await dns.managedZones.setIamPolicy({
3466
+ * // REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
3467
+ * resource: 'projects/my-project/managedZones/my-managedZone',
3468
+ *
3469
+ * // Request body metadata
3470
+ * requestBody: {
3471
+ * // request body parameters
3472
+ * // {
3473
+ * // "policy": {},
3474
+ * // "updateMask": "my_updateMask"
3475
+ * // }
3476
+ * },
3477
+ * });
3478
+ * console.log(res.data);
3479
+ *
3480
+ * // Example response
3481
+ * // {
3482
+ * // "auditConfigs": [],
3483
+ * // "bindings": [],
3484
+ * // "etag": "my_etag",
3485
+ * // "version": 0
3486
+ * // }
3487
+ * }
3488
+ *
3489
+ * main().catch(e => {
3490
+ * console.error(e);
3491
+ * throw e;
3492
+ * });
3493
+ *
3494
+ * ```
2565
3495
  *
2566
3496
  * @param params - Parameters for request
2567
3497
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2655,6 +3585,65 @@ export namespace dns_v1beta2 {
2655
3585
 
2656
3586
  /**
2657
3587
  * Returns permissions that a caller has on the specified resource. If the resource does not exist, this returns an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.
3588
+ * @example
3589
+ * ```js
3590
+ * // Before running the sample:
3591
+ * // - Enable the API at:
3592
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3593
+ * // - Login into gcloud by running:
3594
+ * // ```sh
3595
+ * // $ gcloud auth application-default login
3596
+ * // ```
3597
+ * // - Install the npm module by running:
3598
+ * // ```sh
3599
+ * // $ npm install googleapis
3600
+ * // ```
3601
+ *
3602
+ * const {google} = require('googleapis');
3603
+ * const dns = google.dns('v1beta2');
3604
+ *
3605
+ * async function main() {
3606
+ * const auth = new google.auth.GoogleAuth({
3607
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3608
+ * scopes: [
3609
+ * 'https://www.googleapis.com/auth/cloud-platform',
3610
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
3611
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
3612
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3613
+ * ],
3614
+ * });
3615
+ *
3616
+ * // Acquire an auth client, and bind it to all future calls
3617
+ * const authClient = await auth.getClient();
3618
+ * google.options({auth: authClient});
3619
+ *
3620
+ * // Do the magic
3621
+ * const res = await dns.managedZones.testIamPermissions({
3622
+ * // REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
3623
+ * resource: 'projects/my-project/managedZones/my-managedZone',
3624
+ *
3625
+ * // Request body metadata
3626
+ * requestBody: {
3627
+ * // request body parameters
3628
+ * // {
3629
+ * // "permissions": []
3630
+ * // }
3631
+ * },
3632
+ * });
3633
+ * console.log(res.data);
3634
+ *
3635
+ * // Example response
3636
+ * // {
3637
+ * // "permissions": []
3638
+ * // }
3639
+ * }
3640
+ *
3641
+ * main().catch(e => {
3642
+ * console.error(e);
3643
+ * throw e;
3644
+ * });
3645
+ *
3646
+ * ```
2658
3647
  *
2659
3648
  * @param params - Parameters for request
2660
3649
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2755,6 +3744,90 @@ export namespace dns_v1beta2 {
2755
3744
 
2756
3745
  /**
2757
3746
  * Updates an existing ManagedZone.
3747
+ * @example
3748
+ * ```js
3749
+ * // Before running the sample:
3750
+ * // - Enable the API at:
3751
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3752
+ * // - Login into gcloud by running:
3753
+ * // ```sh
3754
+ * // $ gcloud auth application-default login
3755
+ * // ```
3756
+ * // - Install the npm module by running:
3757
+ * // ```sh
3758
+ * // $ npm install googleapis
3759
+ * // ```
3760
+ *
3761
+ * const {google} = require('googleapis');
3762
+ * const dns = google.dns('v1beta2');
3763
+ *
3764
+ * async function main() {
3765
+ * const auth = new google.auth.GoogleAuth({
3766
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3767
+ * scopes: [
3768
+ * 'https://www.googleapis.com/auth/cloud-platform',
3769
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3770
+ * ],
3771
+ * });
3772
+ *
3773
+ * // Acquire an auth client, and bind it to all future calls
3774
+ * const authClient = await auth.getClient();
3775
+ * google.options({auth: authClient});
3776
+ *
3777
+ * // Do the magic
3778
+ * const res = await dns.managedZones.update({
3779
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
3780
+ * clientOperationId: 'placeholder-value',
3781
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
3782
+ * managedZone: 'placeholder-value',
3783
+ * // Identifies the project addressed by this request.
3784
+ * project: 'placeholder-value',
3785
+ *
3786
+ * // Request body metadata
3787
+ * requestBody: {
3788
+ * // request body parameters
3789
+ * // {
3790
+ * // "cloudLoggingConfig": {},
3791
+ * // "creationTime": "my_creationTime",
3792
+ * // "description": "my_description",
3793
+ * // "dnsName": "my_dnsName",
3794
+ * // "dnssecConfig": {},
3795
+ * // "forwardingConfig": {},
3796
+ * // "id": "my_id",
3797
+ * // "kind": "my_kind",
3798
+ * // "labels": {},
3799
+ * // "name": "my_name",
3800
+ * // "nameServerSet": "my_nameServerSet",
3801
+ * // "nameServers": [],
3802
+ * // "peeringConfig": {},
3803
+ * // "privateVisibilityConfig": {},
3804
+ * // "reverseLookupConfig": {},
3805
+ * // "serviceDirectoryConfig": {},
3806
+ * // "visibility": "my_visibility"
3807
+ * // }
3808
+ * },
3809
+ * });
3810
+ * console.log(res.data);
3811
+ *
3812
+ * // Example response
3813
+ * // {
3814
+ * // "dnsKeyContext": {},
3815
+ * // "id": "my_id",
3816
+ * // "kind": "my_kind",
3817
+ * // "startTime": "my_startTime",
3818
+ * // "status": "my_status",
3819
+ * // "type": "my_type",
3820
+ * // "user": "my_user",
3821
+ * // "zoneContext": {}
3822
+ * // }
3823
+ * }
3824
+ *
3825
+ * main().catch(e => {
3826
+ * console.error(e);
3827
+ * throw e;
3828
+ * });
3829
+ *
3830
+ * ```
2758
3831
  *
2759
3832
  * @param params - Parameters for request
2760
3833
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2994,6 +4067,81 @@ export namespace dns_v1beta2 {
2994
4067
 
2995
4068
  /**
2996
4069
  * Creates a new Policy.
4070
+ * @example
4071
+ * ```js
4072
+ * // Before running the sample:
4073
+ * // - Enable the API at:
4074
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4075
+ * // - Login into gcloud by running:
4076
+ * // ```sh
4077
+ * // $ gcloud auth application-default login
4078
+ * // ```
4079
+ * // - Install the npm module by running:
4080
+ * // ```sh
4081
+ * // $ npm install googleapis
4082
+ * // ```
4083
+ *
4084
+ * const {google} = require('googleapis');
4085
+ * const dns = google.dns('v1beta2');
4086
+ *
4087
+ * async function main() {
4088
+ * const auth = new google.auth.GoogleAuth({
4089
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4090
+ * scopes: [
4091
+ * 'https://www.googleapis.com/auth/cloud-platform',
4092
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4093
+ * ],
4094
+ * });
4095
+ *
4096
+ * // Acquire an auth client, and bind it to all future calls
4097
+ * const authClient = await auth.getClient();
4098
+ * google.options({auth: authClient});
4099
+ *
4100
+ * // Do the magic
4101
+ * const res = await dns.policies.create({
4102
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4103
+ * clientOperationId: 'placeholder-value',
4104
+ * // Identifies the project addressed by this request.
4105
+ * project: 'placeholder-value',
4106
+ *
4107
+ * // Request body metadata
4108
+ * requestBody: {
4109
+ * // request body parameters
4110
+ * // {
4111
+ * // "alternativeNameServerConfig": {},
4112
+ * // "description": "my_description",
4113
+ * // "dns64Config": {},
4114
+ * // "enableInboundForwarding": false,
4115
+ * // "enableLogging": false,
4116
+ * // "id": "my_id",
4117
+ * // "kind": "my_kind",
4118
+ * // "name": "my_name",
4119
+ * // "networks": []
4120
+ * // }
4121
+ * },
4122
+ * });
4123
+ * console.log(res.data);
4124
+ *
4125
+ * // Example response
4126
+ * // {
4127
+ * // "alternativeNameServerConfig": {},
4128
+ * // "description": "my_description",
4129
+ * // "dns64Config": {},
4130
+ * // "enableInboundForwarding": false,
4131
+ * // "enableLogging": false,
4132
+ * // "id": "my_id",
4133
+ * // "kind": "my_kind",
4134
+ * // "name": "my_name",
4135
+ * // "networks": []
4136
+ * // }
4137
+ * }
4138
+ *
4139
+ * main().catch(e => {
4140
+ * console.error(e);
4141
+ * throw e;
4142
+ * });
4143
+ *
4144
+ * ```
2997
4145
  *
2998
4146
  * @param params - Parameters for request
2999
4147
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3084,6 +4232,54 @@ export namespace dns_v1beta2 {
3084
4232
 
3085
4233
  /**
3086
4234
  * Deletes a previously created Policy. Fails if the policy is still being referenced by a network.
4235
+ * @example
4236
+ * ```js
4237
+ * // Before running the sample:
4238
+ * // - Enable the API at:
4239
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4240
+ * // - Login into gcloud by running:
4241
+ * // ```sh
4242
+ * // $ gcloud auth application-default login
4243
+ * // ```
4244
+ * // - Install the npm module by running:
4245
+ * // ```sh
4246
+ * // $ npm install googleapis
4247
+ * // ```
4248
+ *
4249
+ * const {google} = require('googleapis');
4250
+ * const dns = google.dns('v1beta2');
4251
+ *
4252
+ * async function main() {
4253
+ * const auth = new google.auth.GoogleAuth({
4254
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4255
+ * scopes: [
4256
+ * 'https://www.googleapis.com/auth/cloud-platform',
4257
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4258
+ * ],
4259
+ * });
4260
+ *
4261
+ * // Acquire an auth client, and bind it to all future calls
4262
+ * const authClient = await auth.getClient();
4263
+ * google.options({auth: authClient});
4264
+ *
4265
+ * // Do the magic
4266
+ * const res = await dns.policies.delete({
4267
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4268
+ * clientOperationId: 'placeholder-value',
4269
+ * // User given friendly name of the policy addressed by this request.
4270
+ * policy: 'placeholder-value',
4271
+ * // Identifies the project addressed by this request.
4272
+ * project: 'placeholder-value',
4273
+ * });
4274
+ * console.log(res.data);
4275
+ * }
4276
+ *
4277
+ * main().catch(e => {
4278
+ * console.error(e);
4279
+ * throw e;
4280
+ * });
4281
+ *
4282
+ * ```
3087
4283
  *
3088
4284
  * @param params - Parameters for request
3089
4285
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3171,6 +4367,69 @@ export namespace dns_v1beta2 {
3171
4367
 
3172
4368
  /**
3173
4369
  * Fetches the representation of an existing Policy.
4370
+ * @example
4371
+ * ```js
4372
+ * // Before running the sample:
4373
+ * // - Enable the API at:
4374
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4375
+ * // - Login into gcloud by running:
4376
+ * // ```sh
4377
+ * // $ gcloud auth application-default login
4378
+ * // ```
4379
+ * // - Install the npm module by running:
4380
+ * // ```sh
4381
+ * // $ npm install googleapis
4382
+ * // ```
4383
+ *
4384
+ * const {google} = require('googleapis');
4385
+ * const dns = google.dns('v1beta2');
4386
+ *
4387
+ * async function main() {
4388
+ * const auth = new google.auth.GoogleAuth({
4389
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4390
+ * scopes: [
4391
+ * 'https://www.googleapis.com/auth/cloud-platform',
4392
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
4393
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
4394
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4395
+ * ],
4396
+ * });
4397
+ *
4398
+ * // Acquire an auth client, and bind it to all future calls
4399
+ * const authClient = await auth.getClient();
4400
+ * google.options({auth: authClient});
4401
+ *
4402
+ * // Do the magic
4403
+ * const res = await dns.policies.get({
4404
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4405
+ * clientOperationId: 'placeholder-value',
4406
+ * // User given friendly name of the policy addressed by this request.
4407
+ * policy: 'placeholder-value',
4408
+ * // Identifies the project addressed by this request.
4409
+ * project: 'placeholder-value',
4410
+ * });
4411
+ * console.log(res.data);
4412
+ *
4413
+ * // Example response
4414
+ * // {
4415
+ * // "alternativeNameServerConfig": {},
4416
+ * // "description": "my_description",
4417
+ * // "dns64Config": {},
4418
+ * // "enableInboundForwarding": false,
4419
+ * // "enableLogging": false,
4420
+ * // "id": "my_id",
4421
+ * // "kind": "my_kind",
4422
+ * // "name": "my_name",
4423
+ * // "networks": []
4424
+ * // }
4425
+ * }
4426
+ *
4427
+ * main().catch(e => {
4428
+ * console.error(e);
4429
+ * throw e;
4430
+ * });
4431
+ *
4432
+ * ```
3174
4433
  *
3175
4434
  * @param params - Parameters for request
3176
4435
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3260,6 +4519,63 @@ export namespace dns_v1beta2 {
3260
4519
 
3261
4520
  /**
3262
4521
  * Enumerates all Policies associated with a project.
4522
+ * @example
4523
+ * ```js
4524
+ * // Before running the sample:
4525
+ * // - Enable the API at:
4526
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4527
+ * // - Login into gcloud by running:
4528
+ * // ```sh
4529
+ * // $ gcloud auth application-default login
4530
+ * // ```
4531
+ * // - Install the npm module by running:
4532
+ * // ```sh
4533
+ * // $ npm install googleapis
4534
+ * // ```
4535
+ *
4536
+ * const {google} = require('googleapis');
4537
+ * const dns = google.dns('v1beta2');
4538
+ *
4539
+ * async function main() {
4540
+ * const auth = new google.auth.GoogleAuth({
4541
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4542
+ * scopes: [
4543
+ * 'https://www.googleapis.com/auth/cloud-platform',
4544
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
4545
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
4546
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4547
+ * ],
4548
+ * });
4549
+ *
4550
+ * // Acquire an auth client, and bind it to all future calls
4551
+ * const authClient = await auth.getClient();
4552
+ * google.options({auth: authClient});
4553
+ *
4554
+ * // Do the magic
4555
+ * const res = await dns.policies.list({
4556
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
4557
+ * maxResults: 'placeholder-value',
4558
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
4559
+ * pageToken: 'placeholder-value',
4560
+ * // Identifies the project addressed by this request.
4561
+ * project: 'placeholder-value',
4562
+ * });
4563
+ * console.log(res.data);
4564
+ *
4565
+ * // Example response
4566
+ * // {
4567
+ * // "kind": "my_kind",
4568
+ * // "nextPageToken": "my_nextPageToken",
4569
+ * // "policies": []
4570
+ * // }
4571
+ * }
4572
+ *
4573
+ * main().catch(e => {
4574
+ * console.error(e);
4575
+ * throw e;
4576
+ * });
4577
+ *
4578
+ * ```
3263
4579
  *
3264
4580
  * @param params - Parameters for request
3265
4581
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3352,6 +4668,75 @@ export namespace dns_v1beta2 {
3352
4668
 
3353
4669
  /**
3354
4670
  * Applies a partial update to an existing Policy.
4671
+ * @example
4672
+ * ```js
4673
+ * // Before running the sample:
4674
+ * // - Enable the API at:
4675
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4676
+ * // - Login into gcloud by running:
4677
+ * // ```sh
4678
+ * // $ gcloud auth application-default login
4679
+ * // ```
4680
+ * // - Install the npm module by running:
4681
+ * // ```sh
4682
+ * // $ npm install googleapis
4683
+ * // ```
4684
+ *
4685
+ * const {google} = require('googleapis');
4686
+ * const dns = google.dns('v1beta2');
4687
+ *
4688
+ * async function main() {
4689
+ * const auth = new google.auth.GoogleAuth({
4690
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4691
+ * scopes: [
4692
+ * 'https://www.googleapis.com/auth/cloud-platform',
4693
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4694
+ * ],
4695
+ * });
4696
+ *
4697
+ * // Acquire an auth client, and bind it to all future calls
4698
+ * const authClient = await auth.getClient();
4699
+ * google.options({auth: authClient});
4700
+ *
4701
+ * // Do the magic
4702
+ * const res = await dns.policies.patch({
4703
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4704
+ * clientOperationId: 'placeholder-value',
4705
+ * // User given friendly name of the policy addressed by this request.
4706
+ * policy: 'placeholder-value',
4707
+ * // Identifies the project addressed by this request.
4708
+ * project: 'placeholder-value',
4709
+ *
4710
+ * // Request body metadata
4711
+ * requestBody: {
4712
+ * // request body parameters
4713
+ * // {
4714
+ * // "alternativeNameServerConfig": {},
4715
+ * // "description": "my_description",
4716
+ * // "dns64Config": {},
4717
+ * // "enableInboundForwarding": false,
4718
+ * // "enableLogging": false,
4719
+ * // "id": "my_id",
4720
+ * // "kind": "my_kind",
4721
+ * // "name": "my_name",
4722
+ * // "networks": []
4723
+ * // }
4724
+ * },
4725
+ * });
4726
+ * console.log(res.data);
4727
+ *
4728
+ * // Example response
4729
+ * // {
4730
+ * // "policy": {}
4731
+ * // }
4732
+ * }
4733
+ *
4734
+ * main().catch(e => {
4735
+ * console.error(e);
4736
+ * throw e;
4737
+ * });
4738
+ *
4739
+ * ```
3355
4740
  *
3356
4741
  * @param params - Parameters for request
3357
4742
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3443,6 +4828,75 @@ export namespace dns_v1beta2 {
3443
4828
 
3444
4829
  /**
3445
4830
  * Updates an existing Policy.
4831
+ * @example
4832
+ * ```js
4833
+ * // Before running the sample:
4834
+ * // - Enable the API at:
4835
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4836
+ * // - Login into gcloud by running:
4837
+ * // ```sh
4838
+ * // $ gcloud auth application-default login
4839
+ * // ```
4840
+ * // - Install the npm module by running:
4841
+ * // ```sh
4842
+ * // $ npm install googleapis
4843
+ * // ```
4844
+ *
4845
+ * const {google} = require('googleapis');
4846
+ * const dns = google.dns('v1beta2');
4847
+ *
4848
+ * async function main() {
4849
+ * const auth = new google.auth.GoogleAuth({
4850
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4851
+ * scopes: [
4852
+ * 'https://www.googleapis.com/auth/cloud-platform',
4853
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4854
+ * ],
4855
+ * });
4856
+ *
4857
+ * // Acquire an auth client, and bind it to all future calls
4858
+ * const authClient = await auth.getClient();
4859
+ * google.options({auth: authClient});
4860
+ *
4861
+ * // Do the magic
4862
+ * const res = await dns.policies.update({
4863
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4864
+ * clientOperationId: 'placeholder-value',
4865
+ * // User given friendly name of the policy addressed by this request.
4866
+ * policy: 'placeholder-value',
4867
+ * // Identifies the project addressed by this request.
4868
+ * project: 'placeholder-value',
4869
+ *
4870
+ * // Request body metadata
4871
+ * requestBody: {
4872
+ * // request body parameters
4873
+ * // {
4874
+ * // "alternativeNameServerConfig": {},
4875
+ * // "description": "my_description",
4876
+ * // "dns64Config": {},
4877
+ * // "enableInboundForwarding": false,
4878
+ * // "enableLogging": false,
4879
+ * // "id": "my_id",
4880
+ * // "kind": "my_kind",
4881
+ * // "name": "my_name",
4882
+ * // "networks": []
4883
+ * // }
4884
+ * },
4885
+ * });
4886
+ * console.log(res.data);
4887
+ *
4888
+ * // Example response
4889
+ * // {
4890
+ * // "policy": {}
4891
+ * // }
4892
+ * }
4893
+ *
4894
+ * main().catch(e => {
4895
+ * console.error(e);
4896
+ * throw e;
4897
+ * });
4898
+ *
4899
+ * ```
3446
4900
  *
3447
4901
  * @param params - Parameters for request
3448
4902
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3637,6 +5091,62 @@ export namespace dns_v1beta2 {
3637
5091
 
3638
5092
  /**
3639
5093
  * Fetches the representation of an existing Project.
5094
+ * @example
5095
+ * ```js
5096
+ * // Before running the sample:
5097
+ * // - Enable the API at:
5098
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
5099
+ * // - Login into gcloud by running:
5100
+ * // ```sh
5101
+ * // $ gcloud auth application-default login
5102
+ * // ```
5103
+ * // - Install the npm module by running:
5104
+ * // ```sh
5105
+ * // $ npm install googleapis
5106
+ * // ```
5107
+ *
5108
+ * const {google} = require('googleapis');
5109
+ * const dns = google.dns('v1beta2');
5110
+ *
5111
+ * async function main() {
5112
+ * const auth = new google.auth.GoogleAuth({
5113
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5114
+ * scopes: [
5115
+ * 'https://www.googleapis.com/auth/cloud-platform',
5116
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
5117
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
5118
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
5119
+ * ],
5120
+ * });
5121
+ *
5122
+ * // Acquire an auth client, and bind it to all future calls
5123
+ * const authClient = await auth.getClient();
5124
+ * google.options({auth: authClient});
5125
+ *
5126
+ * // Do the magic
5127
+ * const res = await dns.projects.get({
5128
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
5129
+ * clientOperationId: 'placeholder-value',
5130
+ * // Identifies the project addressed by this request.
5131
+ * project: 'placeholder-value',
5132
+ * });
5133
+ * console.log(res.data);
5134
+ *
5135
+ * // Example response
5136
+ * // {
5137
+ * // "id": "my_id",
5138
+ * // "kind": "my_kind",
5139
+ * // "number": "my_number",
5140
+ * // "quota": {}
5141
+ * // }
5142
+ * }
5143
+ *
5144
+ * main().catch(e => {
5145
+ * console.error(e);
5146
+ * throw e;
5147
+ * });
5148
+ *
5149
+ * ```
3640
5150
  *
3641
5151
  * @param params - Parameters for request
3642
5152
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3745,6 +5255,79 @@ export namespace dns_v1beta2 {
3745
5255
 
3746
5256
  /**
3747
5257
  * Creates a new ResourceRecordSet.
5258
+ * @example
5259
+ * ```js
5260
+ * // Before running the sample:
5261
+ * // - Enable the API at:
5262
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
5263
+ * // - Login into gcloud by running:
5264
+ * // ```sh
5265
+ * // $ gcloud auth application-default login
5266
+ * // ```
5267
+ * // - Install the npm module by running:
5268
+ * // ```sh
5269
+ * // $ npm install googleapis
5270
+ * // ```
5271
+ *
5272
+ * const {google} = require('googleapis');
5273
+ * const dns = google.dns('v1beta2');
5274
+ *
5275
+ * async function main() {
5276
+ * const auth = new google.auth.GoogleAuth({
5277
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5278
+ * scopes: [
5279
+ * 'https://www.googleapis.com/auth/cloud-platform',
5280
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
5281
+ * ],
5282
+ * });
5283
+ *
5284
+ * // Acquire an auth client, and bind it to all future calls
5285
+ * const authClient = await auth.getClient();
5286
+ * google.options({auth: authClient});
5287
+ *
5288
+ * // Do the magic
5289
+ * const res = await dns.resourceRecordSets.create({
5290
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
5291
+ * clientOperationId: 'placeholder-value',
5292
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
5293
+ * managedZone: 'placeholder-value',
5294
+ * // Identifies the project addressed by this request.
5295
+ * project: 'placeholder-value',
5296
+ *
5297
+ * // Request body metadata
5298
+ * requestBody: {
5299
+ * // request body parameters
5300
+ * // {
5301
+ * // "kind": "my_kind",
5302
+ * // "name": "my_name",
5303
+ * // "routingPolicy": {},
5304
+ * // "rrdatas": [],
5305
+ * // "signatureRrdatas": [],
5306
+ * // "ttl": 0,
5307
+ * // "type": "my_type"
5308
+ * // }
5309
+ * },
5310
+ * });
5311
+ * console.log(res.data);
5312
+ *
5313
+ * // Example response
5314
+ * // {
5315
+ * // "kind": "my_kind",
5316
+ * // "name": "my_name",
5317
+ * // "routingPolicy": {},
5318
+ * // "rrdatas": [],
5319
+ * // "signatureRrdatas": [],
5320
+ * // "ttl": 0,
5321
+ * // "type": "my_type"
5322
+ * // }
5323
+ * }
5324
+ *
5325
+ * main().catch(e => {
5326
+ * console.error(e);
5327
+ * throw e;
5328
+ * });
5329
+ *
5330
+ * ```
3748
5331
  *
3749
5332
  * @param params - Parameters for request
3750
5333
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3836,6 +5419,58 @@ export namespace dns_v1beta2 {
3836
5419
 
3837
5420
  /**
3838
5421
  * Deletes a previously created ResourceRecordSet.
5422
+ * @example
5423
+ * ```js
5424
+ * // Before running the sample:
5425
+ * // - Enable the API at:
5426
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
5427
+ * // - Login into gcloud by running:
5428
+ * // ```sh
5429
+ * // $ gcloud auth application-default login
5430
+ * // ```
5431
+ * // - Install the npm module by running:
5432
+ * // ```sh
5433
+ * // $ npm install googleapis
5434
+ * // ```
5435
+ *
5436
+ * const {google} = require('googleapis');
5437
+ * const dns = google.dns('v1beta2');
5438
+ *
5439
+ * async function main() {
5440
+ * const auth = new google.auth.GoogleAuth({
5441
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5442
+ * scopes: [
5443
+ * 'https://www.googleapis.com/auth/cloud-platform',
5444
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
5445
+ * ],
5446
+ * });
5447
+ *
5448
+ * // Acquire an auth client, and bind it to all future calls
5449
+ * const authClient = await auth.getClient();
5450
+ * google.options({auth: authClient});
5451
+ *
5452
+ * // Do the magic
5453
+ * const res = await dns.resourceRecordSets.delete({
5454
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
5455
+ * clientOperationId: 'placeholder-value',
5456
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
5457
+ * managedZone: 'placeholder-value',
5458
+ * // Fully qualified domain name.
5459
+ * name: 'placeholder-value',
5460
+ * // Identifies the project addressed by this request.
5461
+ * project: 'placeholder-value',
5462
+ * // RRSet type.
5463
+ * type: 'placeholder-value',
5464
+ * });
5465
+ * console.log(res.data);
5466
+ * }
5467
+ *
5468
+ * main().catch(e => {
5469
+ * console.error(e);
5470
+ * throw e;
5471
+ * });
5472
+ *
5473
+ * ```
3839
5474
  *
3840
5475
  * @param params - Parameters for request
3841
5476
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3925,6 +5560,71 @@ export namespace dns_v1beta2 {
3925
5560
 
3926
5561
  /**
3927
5562
  * Fetches the representation of an existing ResourceRecordSet.
5563
+ * @example
5564
+ * ```js
5565
+ * // Before running the sample:
5566
+ * // - Enable the API at:
5567
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
5568
+ * // - Login into gcloud by running:
5569
+ * // ```sh
5570
+ * // $ gcloud auth application-default login
5571
+ * // ```
5572
+ * // - Install the npm module by running:
5573
+ * // ```sh
5574
+ * // $ npm install googleapis
5575
+ * // ```
5576
+ *
5577
+ * const {google} = require('googleapis');
5578
+ * const dns = google.dns('v1beta2');
5579
+ *
5580
+ * async function main() {
5581
+ * const auth = new google.auth.GoogleAuth({
5582
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5583
+ * scopes: [
5584
+ * 'https://www.googleapis.com/auth/cloud-platform',
5585
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
5586
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
5587
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
5588
+ * ],
5589
+ * });
5590
+ *
5591
+ * // Acquire an auth client, and bind it to all future calls
5592
+ * const authClient = await auth.getClient();
5593
+ * google.options({auth: authClient});
5594
+ *
5595
+ * // Do the magic
5596
+ * const res = await dns.resourceRecordSets.get({
5597
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
5598
+ * clientOperationId: 'placeholder-value',
5599
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
5600
+ * managedZone: 'placeholder-value',
5601
+ * // Fully qualified domain name.
5602
+ * name: 'placeholder-value',
5603
+ * // Identifies the project addressed by this request.
5604
+ * project: 'placeholder-value',
5605
+ * // RRSet type.
5606
+ * type: 'placeholder-value',
5607
+ * });
5608
+ * console.log(res.data);
5609
+ *
5610
+ * // Example response
5611
+ * // {
5612
+ * // "kind": "my_kind",
5613
+ * // "name": "my_name",
5614
+ * // "routingPolicy": {},
5615
+ * // "rrdatas": [],
5616
+ * // "signatureRrdatas": [],
5617
+ * // "ttl": 0,
5618
+ * // "type": "my_type"
5619
+ * // }
5620
+ * }
5621
+ *
5622
+ * main().catch(e => {
5623
+ * console.error(e);
5624
+ * throw e;
5625
+ * });
5626
+ *
5627
+ * ```
3928
5628
  *
3929
5629
  * @param params - Parameters for request
3930
5630
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4016,6 +5716,69 @@ export namespace dns_v1beta2 {
4016
5716
 
4017
5717
  /**
4018
5718
  * Enumerates ResourceRecordSets that you have created but not yet deleted.
5719
+ * @example
5720
+ * ```js
5721
+ * // Before running the sample:
5722
+ * // - Enable the API at:
5723
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
5724
+ * // - Login into gcloud by running:
5725
+ * // ```sh
5726
+ * // $ gcloud auth application-default login
5727
+ * // ```
5728
+ * // - Install the npm module by running:
5729
+ * // ```sh
5730
+ * // $ npm install googleapis
5731
+ * // ```
5732
+ *
5733
+ * const {google} = require('googleapis');
5734
+ * const dns = google.dns('v1beta2');
5735
+ *
5736
+ * async function main() {
5737
+ * const auth = new google.auth.GoogleAuth({
5738
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5739
+ * scopes: [
5740
+ * 'https://www.googleapis.com/auth/cloud-platform',
5741
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
5742
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
5743
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
5744
+ * ],
5745
+ * });
5746
+ *
5747
+ * // Acquire an auth client, and bind it to all future calls
5748
+ * const authClient = await auth.getClient();
5749
+ * google.options({auth: authClient});
5750
+ *
5751
+ * // Do the magic
5752
+ * const res = await dns.resourceRecordSets.list({
5753
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
5754
+ * managedZone: 'placeholder-value',
5755
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
5756
+ * maxResults: 'placeholder-value',
5757
+ * // Restricts the list to return only records with this fully qualified domain name.
5758
+ * name: 'placeholder-value',
5759
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
5760
+ * pageToken: 'placeholder-value',
5761
+ * // Identifies the project addressed by this request.
5762
+ * project: 'placeholder-value',
5763
+ * // Restricts the list to return only records of this type. If present, the "name" parameter must also be present.
5764
+ * type: 'placeholder-value',
5765
+ * });
5766
+ * console.log(res.data);
5767
+ *
5768
+ * // Example response
5769
+ * // {
5770
+ * // "kind": "my_kind",
5771
+ * // "nextPageToken": "my_nextPageToken",
5772
+ * // "rrsets": []
5773
+ * // }
5774
+ * }
5775
+ *
5776
+ * main().catch(e => {
5777
+ * console.error(e);
5778
+ * throw e;
5779
+ * });
5780
+ *
5781
+ * ```
4019
5782
  *
4020
5783
  * @param params - Parameters for request
4021
5784
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4113,6 +5876,83 @@ export namespace dns_v1beta2 {
4113
5876
 
4114
5877
  /**
4115
5878
  * Applies a partial update to an existing ResourceRecordSet.
5879
+ * @example
5880
+ * ```js
5881
+ * // Before running the sample:
5882
+ * // - Enable the API at:
5883
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
5884
+ * // - Login into gcloud by running:
5885
+ * // ```sh
5886
+ * // $ gcloud auth application-default login
5887
+ * // ```
5888
+ * // - Install the npm module by running:
5889
+ * // ```sh
5890
+ * // $ npm install googleapis
5891
+ * // ```
5892
+ *
5893
+ * const {google} = require('googleapis');
5894
+ * const dns = google.dns('v1beta2');
5895
+ *
5896
+ * async function main() {
5897
+ * const auth = new google.auth.GoogleAuth({
5898
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5899
+ * scopes: [
5900
+ * 'https://www.googleapis.com/auth/cloud-platform',
5901
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
5902
+ * ],
5903
+ * });
5904
+ *
5905
+ * // Acquire an auth client, and bind it to all future calls
5906
+ * const authClient = await auth.getClient();
5907
+ * google.options({auth: authClient});
5908
+ *
5909
+ * // Do the magic
5910
+ * const res = await dns.resourceRecordSets.patch({
5911
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
5912
+ * clientOperationId: 'placeholder-value',
5913
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
5914
+ * managedZone: 'placeholder-value',
5915
+ * // Fully qualified domain name.
5916
+ * name: 'placeholder-value',
5917
+ * // Identifies the project addressed by this request.
5918
+ * project: 'placeholder-value',
5919
+ * // RRSet type.
5920
+ * type: 'placeholder-value',
5921
+ *
5922
+ * // Request body metadata
5923
+ * requestBody: {
5924
+ * // request body parameters
5925
+ * // {
5926
+ * // "kind": "my_kind",
5927
+ * // "name": "my_name",
5928
+ * // "routingPolicy": {},
5929
+ * // "rrdatas": [],
5930
+ * // "signatureRrdatas": [],
5931
+ * // "ttl": 0,
5932
+ * // "type": "my_type"
5933
+ * // }
5934
+ * },
5935
+ * });
5936
+ * console.log(res.data);
5937
+ *
5938
+ * // Example response
5939
+ * // {
5940
+ * // "kind": "my_kind",
5941
+ * // "name": "my_name",
5942
+ * // "routingPolicy": {},
5943
+ * // "rrdatas": [],
5944
+ * // "signatureRrdatas": [],
5945
+ * // "ttl": 0,
5946
+ * // "type": "my_type"
5947
+ * // }
5948
+ * }
5949
+ *
5950
+ * main().catch(e => {
5951
+ * console.error(e);
5952
+ * throw e;
5953
+ * });
5954
+ *
5955
+ * ```
4116
5956
  *
4117
5957
  * @param params - Parameters for request
4118
5958
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4333,6 +6173,77 @@ export namespace dns_v1beta2 {
4333
6173
 
4334
6174
  /**
4335
6175
  * Creates a new Response Policy
6176
+ * @example
6177
+ * ```js
6178
+ * // Before running the sample:
6179
+ * // - Enable the API at:
6180
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
6181
+ * // - Login into gcloud by running:
6182
+ * // ```sh
6183
+ * // $ gcloud auth application-default login
6184
+ * // ```
6185
+ * // - Install the npm module by running:
6186
+ * // ```sh
6187
+ * // $ npm install googleapis
6188
+ * // ```
6189
+ *
6190
+ * const {google} = require('googleapis');
6191
+ * const dns = google.dns('v1beta2');
6192
+ *
6193
+ * async function main() {
6194
+ * const auth = new google.auth.GoogleAuth({
6195
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6196
+ * scopes: [
6197
+ * 'https://www.googleapis.com/auth/cloud-platform',
6198
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
6199
+ * ],
6200
+ * });
6201
+ *
6202
+ * // Acquire an auth client, and bind it to all future calls
6203
+ * const authClient = await auth.getClient();
6204
+ * google.options({auth: authClient});
6205
+ *
6206
+ * // Do the magic
6207
+ * const res = await dns.responsePolicies.create({
6208
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
6209
+ * clientOperationId: 'placeholder-value',
6210
+ * // Identifies the project addressed by this request.
6211
+ * project: 'placeholder-value',
6212
+ *
6213
+ * // Request body metadata
6214
+ * requestBody: {
6215
+ * // request body parameters
6216
+ * // {
6217
+ * // "description": "my_description",
6218
+ * // "gkeClusters": [],
6219
+ * // "id": "my_id",
6220
+ * // "kind": "my_kind",
6221
+ * // "labels": {},
6222
+ * // "networks": [],
6223
+ * // "responsePolicyName": "my_responsePolicyName"
6224
+ * // }
6225
+ * },
6226
+ * });
6227
+ * console.log(res.data);
6228
+ *
6229
+ * // Example response
6230
+ * // {
6231
+ * // "description": "my_description",
6232
+ * // "gkeClusters": [],
6233
+ * // "id": "my_id",
6234
+ * // "kind": "my_kind",
6235
+ * // "labels": {},
6236
+ * // "networks": [],
6237
+ * // "responsePolicyName": "my_responsePolicyName"
6238
+ * // }
6239
+ * }
6240
+ *
6241
+ * main().catch(e => {
6242
+ * console.error(e);
6243
+ * throw e;
6244
+ * });
6245
+ *
6246
+ * ```
4336
6247
  *
4337
6248
  * @param params - Parameters for request
4338
6249
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4423,6 +6334,54 @@ export namespace dns_v1beta2 {
4423
6334
 
4424
6335
  /**
4425
6336
  * Deletes a previously created Response Policy. Fails if the response policy is non-empty or still being referenced by a network.
6337
+ * @example
6338
+ * ```js
6339
+ * // Before running the sample:
6340
+ * // - Enable the API at:
6341
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
6342
+ * // - Login into gcloud by running:
6343
+ * // ```sh
6344
+ * // $ gcloud auth application-default login
6345
+ * // ```
6346
+ * // - Install the npm module by running:
6347
+ * // ```sh
6348
+ * // $ npm install googleapis
6349
+ * // ```
6350
+ *
6351
+ * const {google} = require('googleapis');
6352
+ * const dns = google.dns('v1beta2');
6353
+ *
6354
+ * async function main() {
6355
+ * const auth = new google.auth.GoogleAuth({
6356
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6357
+ * scopes: [
6358
+ * 'https://www.googleapis.com/auth/cloud-platform',
6359
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
6360
+ * ],
6361
+ * });
6362
+ *
6363
+ * // Acquire an auth client, and bind it to all future calls
6364
+ * const authClient = await auth.getClient();
6365
+ * google.options({auth: authClient});
6366
+ *
6367
+ * // Do the magic
6368
+ * const res = await dns.responsePolicies.delete({
6369
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
6370
+ * clientOperationId: 'placeholder-value',
6371
+ * // Identifies the project addressed by this request.
6372
+ * project: 'placeholder-value',
6373
+ * // User assigned name of the Response Policy addressed by this request.
6374
+ * responsePolicy: 'placeholder-value',
6375
+ * });
6376
+ * console.log(res.data);
6377
+ * }
6378
+ *
6379
+ * main().catch(e => {
6380
+ * console.error(e);
6381
+ * throw e;
6382
+ * });
6383
+ *
6384
+ * ```
4426
6385
  *
4427
6386
  * @param params - Parameters for request
4428
6387
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4512,6 +6471,67 @@ export namespace dns_v1beta2 {
4512
6471
 
4513
6472
  /**
4514
6473
  * Fetches the representation of an existing Response Policy.
6474
+ * @example
6475
+ * ```js
6476
+ * // Before running the sample:
6477
+ * // - Enable the API at:
6478
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
6479
+ * // - Login into gcloud by running:
6480
+ * // ```sh
6481
+ * // $ gcloud auth application-default login
6482
+ * // ```
6483
+ * // - Install the npm module by running:
6484
+ * // ```sh
6485
+ * // $ npm install googleapis
6486
+ * // ```
6487
+ *
6488
+ * const {google} = require('googleapis');
6489
+ * const dns = google.dns('v1beta2');
6490
+ *
6491
+ * async function main() {
6492
+ * const auth = new google.auth.GoogleAuth({
6493
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6494
+ * scopes: [
6495
+ * 'https://www.googleapis.com/auth/cloud-platform',
6496
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
6497
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
6498
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
6499
+ * ],
6500
+ * });
6501
+ *
6502
+ * // Acquire an auth client, and bind it to all future calls
6503
+ * const authClient = await auth.getClient();
6504
+ * google.options({auth: authClient});
6505
+ *
6506
+ * // Do the magic
6507
+ * const res = await dns.responsePolicies.get({
6508
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
6509
+ * clientOperationId: 'placeholder-value',
6510
+ * // Identifies the project addressed by this request.
6511
+ * project: 'placeholder-value',
6512
+ * // User assigned name of the Response Policy addressed by this request.
6513
+ * responsePolicy: 'placeholder-value',
6514
+ * });
6515
+ * console.log(res.data);
6516
+ *
6517
+ * // Example response
6518
+ * // {
6519
+ * // "description": "my_description",
6520
+ * // "gkeClusters": [],
6521
+ * // "id": "my_id",
6522
+ * // "kind": "my_kind",
6523
+ * // "labels": {},
6524
+ * // "networks": [],
6525
+ * // "responsePolicyName": "my_responsePolicyName"
6526
+ * // }
6527
+ * }
6528
+ *
6529
+ * main().catch(e => {
6530
+ * console.error(e);
6531
+ * throw e;
6532
+ * });
6533
+ *
6534
+ * ```
4515
6535
  *
4516
6536
  * @param params - Parameters for request
4517
6537
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4603,6 +6623,62 @@ export namespace dns_v1beta2 {
4603
6623
 
4604
6624
  /**
4605
6625
  * Enumerates all Response Policies associated with a project.
6626
+ * @example
6627
+ * ```js
6628
+ * // Before running the sample:
6629
+ * // - Enable the API at:
6630
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
6631
+ * // - Login into gcloud by running:
6632
+ * // ```sh
6633
+ * // $ gcloud auth application-default login
6634
+ * // ```
6635
+ * // - Install the npm module by running:
6636
+ * // ```sh
6637
+ * // $ npm install googleapis
6638
+ * // ```
6639
+ *
6640
+ * const {google} = require('googleapis');
6641
+ * const dns = google.dns('v1beta2');
6642
+ *
6643
+ * async function main() {
6644
+ * const auth = new google.auth.GoogleAuth({
6645
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6646
+ * scopes: [
6647
+ * 'https://www.googleapis.com/auth/cloud-platform',
6648
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
6649
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
6650
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
6651
+ * ],
6652
+ * });
6653
+ *
6654
+ * // Acquire an auth client, and bind it to all future calls
6655
+ * const authClient = await auth.getClient();
6656
+ * google.options({auth: authClient});
6657
+ *
6658
+ * // Do the magic
6659
+ * const res = await dns.responsePolicies.list({
6660
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
6661
+ * maxResults: 'placeholder-value',
6662
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
6663
+ * pageToken: 'placeholder-value',
6664
+ * // Identifies the project addressed by this request.
6665
+ * project: 'placeholder-value',
6666
+ * });
6667
+ * console.log(res.data);
6668
+ *
6669
+ * // Example response
6670
+ * // {
6671
+ * // "nextPageToken": "my_nextPageToken",
6672
+ * // "responsePolicies": []
6673
+ * // }
6674
+ * }
6675
+ *
6676
+ * main().catch(e => {
6677
+ * console.error(e);
6678
+ * throw e;
6679
+ * });
6680
+ *
6681
+ * ```
4606
6682
  *
4607
6683
  * @param params - Parameters for request
4608
6684
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4699,6 +6775,73 @@ export namespace dns_v1beta2 {
4699
6775
 
4700
6776
  /**
4701
6777
  * Applies a partial update to an existing Response Policy.
6778
+ * @example
6779
+ * ```js
6780
+ * // Before running the sample:
6781
+ * // - Enable the API at:
6782
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
6783
+ * // - Login into gcloud by running:
6784
+ * // ```sh
6785
+ * // $ gcloud auth application-default login
6786
+ * // ```
6787
+ * // - Install the npm module by running:
6788
+ * // ```sh
6789
+ * // $ npm install googleapis
6790
+ * // ```
6791
+ *
6792
+ * const {google} = require('googleapis');
6793
+ * const dns = google.dns('v1beta2');
6794
+ *
6795
+ * async function main() {
6796
+ * const auth = new google.auth.GoogleAuth({
6797
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6798
+ * scopes: [
6799
+ * 'https://www.googleapis.com/auth/cloud-platform',
6800
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
6801
+ * ],
6802
+ * });
6803
+ *
6804
+ * // Acquire an auth client, and bind it to all future calls
6805
+ * const authClient = await auth.getClient();
6806
+ * google.options({auth: authClient});
6807
+ *
6808
+ * // Do the magic
6809
+ * const res = await dns.responsePolicies.patch({
6810
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
6811
+ * clientOperationId: 'placeholder-value',
6812
+ * // Identifies the project addressed by this request.
6813
+ * project: 'placeholder-value',
6814
+ * // User assigned name of the response policy addressed by this request.
6815
+ * responsePolicy: 'placeholder-value',
6816
+ *
6817
+ * // Request body metadata
6818
+ * requestBody: {
6819
+ * // request body parameters
6820
+ * // {
6821
+ * // "description": "my_description",
6822
+ * // "gkeClusters": [],
6823
+ * // "id": "my_id",
6824
+ * // "kind": "my_kind",
6825
+ * // "labels": {},
6826
+ * // "networks": [],
6827
+ * // "responsePolicyName": "my_responsePolicyName"
6828
+ * // }
6829
+ * },
6830
+ * });
6831
+ * console.log(res.data);
6832
+ *
6833
+ * // Example response
6834
+ * // {
6835
+ * // "responsePolicy": {}
6836
+ * // }
6837
+ * }
6838
+ *
6839
+ * main().catch(e => {
6840
+ * console.error(e);
6841
+ * throw e;
6842
+ * });
6843
+ *
6844
+ * ```
4702
6845
  *
4703
6846
  * @param params - Parameters for request
4704
6847
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4796,6 +6939,73 @@ export namespace dns_v1beta2 {
4796
6939
 
4797
6940
  /**
4798
6941
  * Updates an existing Response Policy.
6942
+ * @example
6943
+ * ```js
6944
+ * // Before running the sample:
6945
+ * // - Enable the API at:
6946
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
6947
+ * // - Login into gcloud by running:
6948
+ * // ```sh
6949
+ * // $ gcloud auth application-default login
6950
+ * // ```
6951
+ * // - Install the npm module by running:
6952
+ * // ```sh
6953
+ * // $ npm install googleapis
6954
+ * // ```
6955
+ *
6956
+ * const {google} = require('googleapis');
6957
+ * const dns = google.dns('v1beta2');
6958
+ *
6959
+ * async function main() {
6960
+ * const auth = new google.auth.GoogleAuth({
6961
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6962
+ * scopes: [
6963
+ * 'https://www.googleapis.com/auth/cloud-platform',
6964
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
6965
+ * ],
6966
+ * });
6967
+ *
6968
+ * // Acquire an auth client, and bind it to all future calls
6969
+ * const authClient = await auth.getClient();
6970
+ * google.options({auth: authClient});
6971
+ *
6972
+ * // Do the magic
6973
+ * const res = await dns.responsePolicies.update({
6974
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
6975
+ * clientOperationId: 'placeholder-value',
6976
+ * // Identifies the project addressed by this request.
6977
+ * project: 'placeholder-value',
6978
+ * // User assigned name of the Response Policy addressed by this request.
6979
+ * responsePolicy: 'placeholder-value',
6980
+ *
6981
+ * // Request body metadata
6982
+ * requestBody: {
6983
+ * // request body parameters
6984
+ * // {
6985
+ * // "description": "my_description",
6986
+ * // "gkeClusters": [],
6987
+ * // "id": "my_id",
6988
+ * // "kind": "my_kind",
6989
+ * // "labels": {},
6990
+ * // "networks": [],
6991
+ * // "responsePolicyName": "my_responsePolicyName"
6992
+ * // }
6993
+ * },
6994
+ * });
6995
+ * console.log(res.data);
6996
+ *
6997
+ * // Example response
6998
+ * // {
6999
+ * // "responsePolicy": {}
7000
+ * // }
7001
+ * }
7002
+ *
7003
+ * main().catch(e => {
7004
+ * console.error(e);
7005
+ * throw e;
7006
+ * });
7007
+ *
7008
+ * ```
4799
7009
  *
4800
7010
  * @param params - Parameters for request
4801
7011
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5002,6 +7212,75 @@ export namespace dns_v1beta2 {
5002
7212
 
5003
7213
  /**
5004
7214
  * Creates a new Response Policy Rule.
7215
+ * @example
7216
+ * ```js
7217
+ * // Before running the sample:
7218
+ * // - Enable the API at:
7219
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
7220
+ * // - Login into gcloud by running:
7221
+ * // ```sh
7222
+ * // $ gcloud auth application-default login
7223
+ * // ```
7224
+ * // - Install the npm module by running:
7225
+ * // ```sh
7226
+ * // $ npm install googleapis
7227
+ * // ```
7228
+ *
7229
+ * const {google} = require('googleapis');
7230
+ * const dns = google.dns('v1beta2');
7231
+ *
7232
+ * async function main() {
7233
+ * const auth = new google.auth.GoogleAuth({
7234
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7235
+ * scopes: [
7236
+ * 'https://www.googleapis.com/auth/cloud-platform',
7237
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
7238
+ * ],
7239
+ * });
7240
+ *
7241
+ * // Acquire an auth client, and bind it to all future calls
7242
+ * const authClient = await auth.getClient();
7243
+ * google.options({auth: authClient});
7244
+ *
7245
+ * // Do the magic
7246
+ * const res = await dns.responsePolicyRules.create({
7247
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
7248
+ * clientOperationId: 'placeholder-value',
7249
+ * // Identifies the project addressed by this request.
7250
+ * project: 'placeholder-value',
7251
+ * // User assigned name of the Response Policy containing the Response Policy Rule.
7252
+ * responsePolicy: 'placeholder-value',
7253
+ *
7254
+ * // Request body metadata
7255
+ * requestBody: {
7256
+ * // request body parameters
7257
+ * // {
7258
+ * // "behavior": "my_behavior",
7259
+ * // "dnsName": "my_dnsName",
7260
+ * // "kind": "my_kind",
7261
+ * // "localData": {},
7262
+ * // "ruleName": "my_ruleName"
7263
+ * // }
7264
+ * },
7265
+ * });
7266
+ * console.log(res.data);
7267
+ *
7268
+ * // Example response
7269
+ * // {
7270
+ * // "behavior": "my_behavior",
7271
+ * // "dnsName": "my_dnsName",
7272
+ * // "kind": "my_kind",
7273
+ * // "localData": {},
7274
+ * // "ruleName": "my_ruleName"
7275
+ * // }
7276
+ * }
7277
+ *
7278
+ * main().catch(e => {
7279
+ * console.error(e);
7280
+ * throw e;
7281
+ * });
7282
+ *
7283
+ * ```
5005
7284
  *
5006
7285
  * @param params - Parameters for request
5007
7286
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5093,6 +7372,56 @@ export namespace dns_v1beta2 {
5093
7372
 
5094
7373
  /**
5095
7374
  * Deletes a previously created Response Policy Rule.
7375
+ * @example
7376
+ * ```js
7377
+ * // Before running the sample:
7378
+ * // - Enable the API at:
7379
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
7380
+ * // - Login into gcloud by running:
7381
+ * // ```sh
7382
+ * // $ gcloud auth application-default login
7383
+ * // ```
7384
+ * // - Install the npm module by running:
7385
+ * // ```sh
7386
+ * // $ npm install googleapis
7387
+ * // ```
7388
+ *
7389
+ * const {google} = require('googleapis');
7390
+ * const dns = google.dns('v1beta2');
7391
+ *
7392
+ * async function main() {
7393
+ * const auth = new google.auth.GoogleAuth({
7394
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7395
+ * scopes: [
7396
+ * 'https://www.googleapis.com/auth/cloud-platform',
7397
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
7398
+ * ],
7399
+ * });
7400
+ *
7401
+ * // Acquire an auth client, and bind it to all future calls
7402
+ * const authClient = await auth.getClient();
7403
+ * google.options({auth: authClient});
7404
+ *
7405
+ * // Do the magic
7406
+ * const res = await dns.responsePolicyRules.delete({
7407
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
7408
+ * clientOperationId: 'placeholder-value',
7409
+ * // Identifies the project addressed by this request.
7410
+ * project: 'placeholder-value',
7411
+ * // User assigned name of the Response Policy containing the Response Policy Rule.
7412
+ * responsePolicy: 'placeholder-value',
7413
+ * // User assigned name of the Response Policy Rule addressed by this request.
7414
+ * responsePolicyRule: 'placeholder-value',
7415
+ * });
7416
+ * console.log(res.data);
7417
+ * }
7418
+ *
7419
+ * main().catch(e => {
7420
+ * console.error(e);
7421
+ * throw e;
7422
+ * });
7423
+ *
7424
+ * ```
5096
7425
  *
5097
7426
  * @param params - Parameters for request
5098
7427
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5182,6 +7511,67 @@ export namespace dns_v1beta2 {
5182
7511
 
5183
7512
  /**
5184
7513
  * Fetches the representation of an existing Response Policy Rule.
7514
+ * @example
7515
+ * ```js
7516
+ * // Before running the sample:
7517
+ * // - Enable the API at:
7518
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
7519
+ * // - Login into gcloud by running:
7520
+ * // ```sh
7521
+ * // $ gcloud auth application-default login
7522
+ * // ```
7523
+ * // - Install the npm module by running:
7524
+ * // ```sh
7525
+ * // $ npm install googleapis
7526
+ * // ```
7527
+ *
7528
+ * const {google} = require('googleapis');
7529
+ * const dns = google.dns('v1beta2');
7530
+ *
7531
+ * async function main() {
7532
+ * const auth = new google.auth.GoogleAuth({
7533
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7534
+ * scopes: [
7535
+ * 'https://www.googleapis.com/auth/cloud-platform',
7536
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
7537
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
7538
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
7539
+ * ],
7540
+ * });
7541
+ *
7542
+ * // Acquire an auth client, and bind it to all future calls
7543
+ * const authClient = await auth.getClient();
7544
+ * google.options({auth: authClient});
7545
+ *
7546
+ * // Do the magic
7547
+ * const res = await dns.responsePolicyRules.get({
7548
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
7549
+ * clientOperationId: 'placeholder-value',
7550
+ * // Identifies the project addressed by this request.
7551
+ * project: 'placeholder-value',
7552
+ * // User assigned name of the Response Policy containing the Response Policy Rule.
7553
+ * responsePolicy: 'placeholder-value',
7554
+ * // User assigned name of the Response Policy Rule addressed by this request.
7555
+ * responsePolicyRule: 'placeholder-value',
7556
+ * });
7557
+ * console.log(res.data);
7558
+ *
7559
+ * // Example response
7560
+ * // {
7561
+ * // "behavior": "my_behavior",
7562
+ * // "dnsName": "my_dnsName",
7563
+ * // "kind": "my_kind",
7564
+ * // "localData": {},
7565
+ * // "ruleName": "my_ruleName"
7566
+ * // }
7567
+ * }
7568
+ *
7569
+ * main().catch(e => {
7570
+ * console.error(e);
7571
+ * throw e;
7572
+ * });
7573
+ *
7574
+ * ```
5185
7575
  *
5186
7576
  * @param params - Parameters for request
5187
7577
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5273,6 +7663,64 @@ export namespace dns_v1beta2 {
5273
7663
 
5274
7664
  /**
5275
7665
  * Enumerates all Response Policy Rules associated with a project.
7666
+ * @example
7667
+ * ```js
7668
+ * // Before running the sample:
7669
+ * // - Enable the API at:
7670
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
7671
+ * // - Login into gcloud by running:
7672
+ * // ```sh
7673
+ * // $ gcloud auth application-default login
7674
+ * // ```
7675
+ * // - Install the npm module by running:
7676
+ * // ```sh
7677
+ * // $ npm install googleapis
7678
+ * // ```
7679
+ *
7680
+ * const {google} = require('googleapis');
7681
+ * const dns = google.dns('v1beta2');
7682
+ *
7683
+ * async function main() {
7684
+ * const auth = new google.auth.GoogleAuth({
7685
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7686
+ * scopes: [
7687
+ * 'https://www.googleapis.com/auth/cloud-platform',
7688
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
7689
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
7690
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
7691
+ * ],
7692
+ * });
7693
+ *
7694
+ * // Acquire an auth client, and bind it to all future calls
7695
+ * const authClient = await auth.getClient();
7696
+ * google.options({auth: authClient});
7697
+ *
7698
+ * // Do the magic
7699
+ * const res = await dns.responsePolicyRules.list({
7700
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
7701
+ * maxResults: 'placeholder-value',
7702
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
7703
+ * pageToken: 'placeholder-value',
7704
+ * // Identifies the project addressed by this request.
7705
+ * project: 'placeholder-value',
7706
+ * // User assigned name of the Response Policy to list.
7707
+ * responsePolicy: 'placeholder-value',
7708
+ * });
7709
+ * console.log(res.data);
7710
+ *
7711
+ * // Example response
7712
+ * // {
7713
+ * // "nextPageToken": "my_nextPageToken",
7714
+ * // "responsePolicyRules": []
7715
+ * // }
7716
+ * }
7717
+ *
7718
+ * main().catch(e => {
7719
+ * console.error(e);
7720
+ * throw e;
7721
+ * });
7722
+ *
7723
+ * ```
5276
7724
  *
5277
7725
  * @param params - Parameters for request
5278
7726
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5370,6 +7818,73 @@ export namespace dns_v1beta2 {
5370
7818
 
5371
7819
  /**
5372
7820
  * Applies a partial update to an existing Response Policy Rule.
7821
+ * @example
7822
+ * ```js
7823
+ * // Before running the sample:
7824
+ * // - Enable the API at:
7825
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
7826
+ * // - Login into gcloud by running:
7827
+ * // ```sh
7828
+ * // $ gcloud auth application-default login
7829
+ * // ```
7830
+ * // - Install the npm module by running:
7831
+ * // ```sh
7832
+ * // $ npm install googleapis
7833
+ * // ```
7834
+ *
7835
+ * const {google} = require('googleapis');
7836
+ * const dns = google.dns('v1beta2');
7837
+ *
7838
+ * async function main() {
7839
+ * const auth = new google.auth.GoogleAuth({
7840
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7841
+ * scopes: [
7842
+ * 'https://www.googleapis.com/auth/cloud-platform',
7843
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
7844
+ * ],
7845
+ * });
7846
+ *
7847
+ * // Acquire an auth client, and bind it to all future calls
7848
+ * const authClient = await auth.getClient();
7849
+ * google.options({auth: authClient});
7850
+ *
7851
+ * // Do the magic
7852
+ * const res = await dns.responsePolicyRules.patch({
7853
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
7854
+ * clientOperationId: 'placeholder-value',
7855
+ * // Identifies the project addressed by this request.
7856
+ * project: 'placeholder-value',
7857
+ * // User assigned name of the Response Policy containing the Response Policy Rule.
7858
+ * responsePolicy: 'placeholder-value',
7859
+ * // User assigned name of the Response Policy Rule addressed by this request.
7860
+ * responsePolicyRule: 'placeholder-value',
7861
+ *
7862
+ * // Request body metadata
7863
+ * requestBody: {
7864
+ * // request body parameters
7865
+ * // {
7866
+ * // "behavior": "my_behavior",
7867
+ * // "dnsName": "my_dnsName",
7868
+ * // "kind": "my_kind",
7869
+ * // "localData": {},
7870
+ * // "ruleName": "my_ruleName"
7871
+ * // }
7872
+ * },
7873
+ * });
7874
+ * console.log(res.data);
7875
+ *
7876
+ * // Example response
7877
+ * // {
7878
+ * // "responsePolicyRule": {}
7879
+ * // }
7880
+ * }
7881
+ *
7882
+ * main().catch(e => {
7883
+ * console.error(e);
7884
+ * throw e;
7885
+ * });
7886
+ *
7887
+ * ```
5373
7888
  *
5374
7889
  * @param params - Parameters for request
5375
7890
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5471,6 +7986,73 @@ export namespace dns_v1beta2 {
5471
7986
 
5472
7987
  /**
5473
7988
  * Updates an existing Response Policy Rule.
7989
+ * @example
7990
+ * ```js
7991
+ * // Before running the sample:
7992
+ * // - Enable the API at:
7993
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
7994
+ * // - Login into gcloud by running:
7995
+ * // ```sh
7996
+ * // $ gcloud auth application-default login
7997
+ * // ```
7998
+ * // - Install the npm module by running:
7999
+ * // ```sh
8000
+ * // $ npm install googleapis
8001
+ * // ```
8002
+ *
8003
+ * const {google} = require('googleapis');
8004
+ * const dns = google.dns('v1beta2');
8005
+ *
8006
+ * async function main() {
8007
+ * const auth = new google.auth.GoogleAuth({
8008
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
8009
+ * scopes: [
8010
+ * 'https://www.googleapis.com/auth/cloud-platform',
8011
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
8012
+ * ],
8013
+ * });
8014
+ *
8015
+ * // Acquire an auth client, and bind it to all future calls
8016
+ * const authClient = await auth.getClient();
8017
+ * google.options({auth: authClient});
8018
+ *
8019
+ * // Do the magic
8020
+ * const res = await dns.responsePolicyRules.update({
8021
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
8022
+ * clientOperationId: 'placeholder-value',
8023
+ * // Identifies the project addressed by this request.
8024
+ * project: 'placeholder-value',
8025
+ * // User assigned name of the Response Policy containing the Response Policy Rule.
8026
+ * responsePolicy: 'placeholder-value',
8027
+ * // User assigned name of the Response Policy Rule addressed by this request.
8028
+ * responsePolicyRule: 'placeholder-value',
8029
+ *
8030
+ * // Request body metadata
8031
+ * requestBody: {
8032
+ * // request body parameters
8033
+ * // {
8034
+ * // "behavior": "my_behavior",
8035
+ * // "dnsName": "my_dnsName",
8036
+ * // "kind": "my_kind",
8037
+ * // "localData": {},
8038
+ * // "ruleName": "my_ruleName"
8039
+ * // }
8040
+ * },
8041
+ * });
8042
+ * console.log(res.data);
8043
+ *
8044
+ * // Example response
8045
+ * // {
8046
+ * // "responsePolicyRule": {}
8047
+ * // }
8048
+ * }
8049
+ *
8050
+ * main().catch(e => {
8051
+ * console.error(e);
8052
+ * throw e;
8053
+ * });
8054
+ *
8055
+ * ```
5474
8056
  *
5475
8057
  * @param params - Parameters for request
5476
8058
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.