@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.
@@ -1139,6 +1139,79 @@ export declare namespace dns_v1beta2 {
1139
1139
  constructor(context: APIRequestContext);
1140
1140
  /**
1141
1141
  * Atomically updates the ResourceRecordSet collection.
1142
+ * @example
1143
+ * ```js
1144
+ * // Before running the sample:
1145
+ * // - Enable the API at:
1146
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1147
+ * // - Login into gcloud by running:
1148
+ * // ```sh
1149
+ * // $ gcloud auth application-default login
1150
+ * // ```
1151
+ * // - Install the npm module by running:
1152
+ * // ```sh
1153
+ * // $ npm install googleapis
1154
+ * // ```
1155
+ *
1156
+ * const {google} = require('googleapis');
1157
+ * const dns = google.dns('v1beta2');
1158
+ *
1159
+ * async function main() {
1160
+ * const auth = new google.auth.GoogleAuth({
1161
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1162
+ * scopes: [
1163
+ * 'https://www.googleapis.com/auth/cloud-platform',
1164
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1165
+ * ],
1166
+ * });
1167
+ *
1168
+ * // Acquire an auth client, and bind it to all future calls
1169
+ * const authClient = await auth.getClient();
1170
+ * google.options({auth: authClient});
1171
+ *
1172
+ * // Do the magic
1173
+ * const res = await dns.changes.create({
1174
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
1175
+ * clientOperationId: 'placeholder-value',
1176
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1177
+ * managedZone: 'placeholder-value',
1178
+ * // Identifies the project addressed by this request.
1179
+ * project: 'placeholder-value',
1180
+ *
1181
+ * // Request body metadata
1182
+ * requestBody: {
1183
+ * // request body parameters
1184
+ * // {
1185
+ * // "additions": [],
1186
+ * // "deletions": [],
1187
+ * // "id": "my_id",
1188
+ * // "isServing": false,
1189
+ * // "kind": "my_kind",
1190
+ * // "startTime": "my_startTime",
1191
+ * // "status": "my_status"
1192
+ * // }
1193
+ * },
1194
+ * });
1195
+ * console.log(res.data);
1196
+ *
1197
+ * // Example response
1198
+ * // {
1199
+ * // "additions": [],
1200
+ * // "deletions": [],
1201
+ * // "id": "my_id",
1202
+ * // "isServing": false,
1203
+ * // "kind": "my_kind",
1204
+ * // "startTime": "my_startTime",
1205
+ * // "status": "my_status"
1206
+ * // }
1207
+ * }
1208
+ *
1209
+ * main().catch(e => {
1210
+ * console.error(e);
1211
+ * throw e;
1212
+ * });
1213
+ *
1214
+ * ```
1142
1215
  *
1143
1216
  * @param params - Parameters for request
1144
1217
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1153,6 +1226,69 @@ export declare namespace dns_v1beta2 {
1153
1226
  create(callback: BodyResponseCallback<Schema$Change>): void;
1154
1227
  /**
1155
1228
  * Fetches the representation of an existing Change.
1229
+ * @example
1230
+ * ```js
1231
+ * // Before running the sample:
1232
+ * // - Enable the API at:
1233
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1234
+ * // - Login into gcloud by running:
1235
+ * // ```sh
1236
+ * // $ gcloud auth application-default login
1237
+ * // ```
1238
+ * // - Install the npm module by running:
1239
+ * // ```sh
1240
+ * // $ npm install googleapis
1241
+ * // ```
1242
+ *
1243
+ * const {google} = require('googleapis');
1244
+ * const dns = google.dns('v1beta2');
1245
+ *
1246
+ * async function main() {
1247
+ * const auth = new google.auth.GoogleAuth({
1248
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1249
+ * scopes: [
1250
+ * 'https://www.googleapis.com/auth/cloud-platform',
1251
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1252
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
1253
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1254
+ * ],
1255
+ * });
1256
+ *
1257
+ * // Acquire an auth client, and bind it to all future calls
1258
+ * const authClient = await auth.getClient();
1259
+ * google.options({auth: authClient});
1260
+ *
1261
+ * // Do the magic
1262
+ * const res = await dns.changes.get({
1263
+ * // The identifier of the requested change, from a previous ResourceRecordSetsChangeResponse.
1264
+ * changeId: 'placeholder-value',
1265
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
1266
+ * clientOperationId: 'placeholder-value',
1267
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1268
+ * managedZone: 'placeholder-value',
1269
+ * // Identifies the project addressed by this request.
1270
+ * project: 'placeholder-value',
1271
+ * });
1272
+ * console.log(res.data);
1273
+ *
1274
+ * // Example response
1275
+ * // {
1276
+ * // "additions": [],
1277
+ * // "deletions": [],
1278
+ * // "id": "my_id",
1279
+ * // "isServing": false,
1280
+ * // "kind": "my_kind",
1281
+ * // "startTime": "my_startTime",
1282
+ * // "status": "my_status"
1283
+ * // }
1284
+ * }
1285
+ *
1286
+ * main().catch(e => {
1287
+ * console.error(e);
1288
+ * throw e;
1289
+ * });
1290
+ *
1291
+ * ```
1156
1292
  *
1157
1293
  * @param params - Parameters for request
1158
1294
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1167,6 +1303,69 @@ export declare namespace dns_v1beta2 {
1167
1303
  get(callback: BodyResponseCallback<Schema$Change>): void;
1168
1304
  /**
1169
1305
  * Enumerates Changes to a ResourceRecordSet collection.
1306
+ * @example
1307
+ * ```js
1308
+ * // Before running the sample:
1309
+ * // - Enable the API at:
1310
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1311
+ * // - Login into gcloud by running:
1312
+ * // ```sh
1313
+ * // $ gcloud auth application-default login
1314
+ * // ```
1315
+ * // - Install the npm module by running:
1316
+ * // ```sh
1317
+ * // $ npm install googleapis
1318
+ * // ```
1319
+ *
1320
+ * const {google} = require('googleapis');
1321
+ * const dns = google.dns('v1beta2');
1322
+ *
1323
+ * async function main() {
1324
+ * const auth = new google.auth.GoogleAuth({
1325
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1326
+ * scopes: [
1327
+ * 'https://www.googleapis.com/auth/cloud-platform',
1328
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1329
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
1330
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1331
+ * ],
1332
+ * });
1333
+ *
1334
+ * // Acquire an auth client, and bind it to all future calls
1335
+ * const authClient = await auth.getClient();
1336
+ * google.options({auth: authClient});
1337
+ *
1338
+ * // Do the magic
1339
+ * const res = await dns.changes.list({
1340
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1341
+ * managedZone: 'placeholder-value',
1342
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
1343
+ * maxResults: 'placeholder-value',
1344
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
1345
+ * pageToken: 'placeholder-value',
1346
+ * // Identifies the project addressed by this request.
1347
+ * project: 'placeholder-value',
1348
+ * // Sorting criterion. The only supported value is change sequence.
1349
+ * sortBy: 'placeholder-value',
1350
+ * // Sorting order direction: 'ascending' or 'descending'.
1351
+ * sortOrder: 'placeholder-value',
1352
+ * });
1353
+ * console.log(res.data);
1354
+ *
1355
+ * // Example response
1356
+ * // {
1357
+ * // "changes": [],
1358
+ * // "kind": "my_kind",
1359
+ * // "nextPageToken": "my_nextPageToken"
1360
+ * // }
1361
+ * }
1362
+ *
1363
+ * main().catch(e => {
1364
+ * console.error(e);
1365
+ * throw e;
1366
+ * });
1367
+ *
1368
+ * ```
1170
1369
  *
1171
1370
  * @param params - Parameters for request
1172
1371
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1247,6 +1446,75 @@ export declare namespace dns_v1beta2 {
1247
1446
  constructor(context: APIRequestContext);
1248
1447
  /**
1249
1448
  * Fetches the representation of an existing DnsKey.
1449
+ * @example
1450
+ * ```js
1451
+ * // Before running the sample:
1452
+ * // - Enable the API at:
1453
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1454
+ * // - Login into gcloud by running:
1455
+ * // ```sh
1456
+ * // $ gcloud auth application-default login
1457
+ * // ```
1458
+ * // - Install the npm module by running:
1459
+ * // ```sh
1460
+ * // $ npm install googleapis
1461
+ * // ```
1462
+ *
1463
+ * const {google} = require('googleapis');
1464
+ * const dns = google.dns('v1beta2');
1465
+ *
1466
+ * async function main() {
1467
+ * const auth = new google.auth.GoogleAuth({
1468
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1469
+ * scopes: [
1470
+ * 'https://www.googleapis.com/auth/cloud-platform',
1471
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1472
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
1473
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1474
+ * ],
1475
+ * });
1476
+ *
1477
+ * // Acquire an auth client, and bind it to all future calls
1478
+ * const authClient = await auth.getClient();
1479
+ * google.options({auth: authClient});
1480
+ *
1481
+ * // Do the magic
1482
+ * const res = await dns.dnsKeys.get({
1483
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
1484
+ * clientOperationId: 'placeholder-value',
1485
+ * // 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.
1486
+ * digestType: 'placeholder-value',
1487
+ * // The identifier of the requested DnsKey.
1488
+ * dnsKeyId: 'placeholder-value',
1489
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1490
+ * managedZone: 'placeholder-value',
1491
+ * // Identifies the project addressed by this request.
1492
+ * project: 'placeholder-value',
1493
+ * });
1494
+ * console.log(res.data);
1495
+ *
1496
+ * // Example response
1497
+ * // {
1498
+ * // "algorithm": "my_algorithm",
1499
+ * // "creationTime": "my_creationTime",
1500
+ * // "description": "my_description",
1501
+ * // "digests": [],
1502
+ * // "id": "my_id",
1503
+ * // "isActive": false,
1504
+ * // "keyLength": 0,
1505
+ * // "keyTag": 0,
1506
+ * // "kind": "my_kind",
1507
+ * // "publicKey": "my_publicKey",
1508
+ * // "type": "my_type"
1509
+ * // }
1510
+ * }
1511
+ *
1512
+ * main().catch(e => {
1513
+ * console.error(e);
1514
+ * throw e;
1515
+ * });
1516
+ *
1517
+ * ```
1250
1518
  *
1251
1519
  * @param params - Parameters for request
1252
1520
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1261,6 +1529,67 @@ export declare namespace dns_v1beta2 {
1261
1529
  get(callback: BodyResponseCallback<Schema$DnsKey>): void;
1262
1530
  /**
1263
1531
  * Enumerates DnsKeys to a ResourceRecordSet collection.
1532
+ * @example
1533
+ * ```js
1534
+ * // Before running the sample:
1535
+ * // - Enable the API at:
1536
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1537
+ * // - Login into gcloud by running:
1538
+ * // ```sh
1539
+ * // $ gcloud auth application-default login
1540
+ * // ```
1541
+ * // - Install the npm module by running:
1542
+ * // ```sh
1543
+ * // $ npm install googleapis
1544
+ * // ```
1545
+ *
1546
+ * const {google} = require('googleapis');
1547
+ * const dns = google.dns('v1beta2');
1548
+ *
1549
+ * async function main() {
1550
+ * const auth = new google.auth.GoogleAuth({
1551
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1552
+ * scopes: [
1553
+ * 'https://www.googleapis.com/auth/cloud-platform',
1554
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1555
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
1556
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1557
+ * ],
1558
+ * });
1559
+ *
1560
+ * // Acquire an auth client, and bind it to all future calls
1561
+ * const authClient = await auth.getClient();
1562
+ * google.options({auth: authClient});
1563
+ *
1564
+ * // Do the magic
1565
+ * const res = await dns.dnsKeys.list({
1566
+ * // 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.
1567
+ * digestType: 'placeholder-value',
1568
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1569
+ * managedZone: 'placeholder-value',
1570
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
1571
+ * maxResults: 'placeholder-value',
1572
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
1573
+ * pageToken: 'placeholder-value',
1574
+ * // Identifies the project addressed by this request.
1575
+ * project: 'placeholder-value',
1576
+ * });
1577
+ * console.log(res.data);
1578
+ *
1579
+ * // Example response
1580
+ * // {
1581
+ * // "dnsKeys": [],
1582
+ * // "kind": "my_kind",
1583
+ * // "nextPageToken": "my_nextPageToken"
1584
+ * // }
1585
+ * }
1586
+ *
1587
+ * main().catch(e => {
1588
+ * console.error(e);
1589
+ * throw e;
1590
+ * });
1591
+ *
1592
+ * ```
1264
1593
  *
1265
1594
  * @param params - Parameters for request
1266
1595
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1323,6 +1652,70 @@ export declare namespace dns_v1beta2 {
1323
1652
  constructor(context: APIRequestContext);
1324
1653
  /**
1325
1654
  * Fetches the representation of an existing Operation.
1655
+ * @example
1656
+ * ```js
1657
+ * // Before running the sample:
1658
+ * // - Enable the API at:
1659
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1660
+ * // - Login into gcloud by running:
1661
+ * // ```sh
1662
+ * // $ gcloud auth application-default login
1663
+ * // ```
1664
+ * // - Install the npm module by running:
1665
+ * // ```sh
1666
+ * // $ npm install googleapis
1667
+ * // ```
1668
+ *
1669
+ * const {google} = require('googleapis');
1670
+ * const dns = google.dns('v1beta2');
1671
+ *
1672
+ * async function main() {
1673
+ * const auth = new google.auth.GoogleAuth({
1674
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1675
+ * scopes: [
1676
+ * 'https://www.googleapis.com/auth/cloud-platform',
1677
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1678
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
1679
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1680
+ * ],
1681
+ * });
1682
+ *
1683
+ * // Acquire an auth client, and bind it to all future calls
1684
+ * const authClient = await auth.getClient();
1685
+ * google.options({auth: authClient});
1686
+ *
1687
+ * // Do the magic
1688
+ * const res = await dns.managedZoneOperations.get({
1689
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
1690
+ * clientOperationId: 'placeholder-value',
1691
+ * // Identifies the managed zone addressed by this request.
1692
+ * managedZone: 'placeholder-value',
1693
+ * // Identifies the operation addressed by this request (ID of the operation).
1694
+ * operation: 'placeholder-value',
1695
+ * // Identifies the project addressed by this request.
1696
+ * project: 'placeholder-value',
1697
+ * });
1698
+ * console.log(res.data);
1699
+ *
1700
+ * // Example response
1701
+ * // {
1702
+ * // "dnsKeyContext": {},
1703
+ * // "id": "my_id",
1704
+ * // "kind": "my_kind",
1705
+ * // "startTime": "my_startTime",
1706
+ * // "status": "my_status",
1707
+ * // "type": "my_type",
1708
+ * // "user": "my_user",
1709
+ * // "zoneContext": {}
1710
+ * // }
1711
+ * }
1712
+ *
1713
+ * main().catch(e => {
1714
+ * console.error(e);
1715
+ * throw e;
1716
+ * });
1717
+ *
1718
+ * ```
1326
1719
  *
1327
1720
  * @param params - Parameters for request
1328
1721
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1337,6 +1730,67 @@ export declare namespace dns_v1beta2 {
1337
1730
  get(callback: BodyResponseCallback<Schema$Operation>): void;
1338
1731
  /**
1339
1732
  * Enumerates Operations for the given ManagedZone.
1733
+ * @example
1734
+ * ```js
1735
+ * // Before running the sample:
1736
+ * // - Enable the API at:
1737
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1738
+ * // - Login into gcloud by running:
1739
+ * // ```sh
1740
+ * // $ gcloud auth application-default login
1741
+ * // ```
1742
+ * // - Install the npm module by running:
1743
+ * // ```sh
1744
+ * // $ npm install googleapis
1745
+ * // ```
1746
+ *
1747
+ * const {google} = require('googleapis');
1748
+ * const dns = google.dns('v1beta2');
1749
+ *
1750
+ * async function main() {
1751
+ * const auth = new google.auth.GoogleAuth({
1752
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1753
+ * scopes: [
1754
+ * 'https://www.googleapis.com/auth/cloud-platform',
1755
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
1756
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
1757
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1758
+ * ],
1759
+ * });
1760
+ *
1761
+ * // Acquire an auth client, and bind it to all future calls
1762
+ * const authClient = await auth.getClient();
1763
+ * google.options({auth: authClient});
1764
+ *
1765
+ * // Do the magic
1766
+ * const res = await dns.managedZoneOperations.list({
1767
+ * // Identifies the managed zone addressed by this request.
1768
+ * managedZone: 'placeholder-value',
1769
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
1770
+ * maxResults: 'placeholder-value',
1771
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
1772
+ * pageToken: 'placeholder-value',
1773
+ * // Identifies the project addressed by this request.
1774
+ * project: 'placeholder-value',
1775
+ * // Sorting criterion. The only supported values are START_TIME and ID.
1776
+ * sortBy: 'placeholder-value',
1777
+ * });
1778
+ * console.log(res.data);
1779
+ *
1780
+ * // Example response
1781
+ * // {
1782
+ * // "kind": "my_kind",
1783
+ * // "nextPageToken": "my_nextPageToken",
1784
+ * // "operations": []
1785
+ * // }
1786
+ * }
1787
+ *
1788
+ * main().catch(e => {
1789
+ * console.error(e);
1790
+ * throw e;
1791
+ * });
1792
+ *
1793
+ * ```
1340
1794
  *
1341
1795
  * @param params - Parameters for request
1342
1796
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1395,6 +1849,97 @@ export declare namespace dns_v1beta2 {
1395
1849
  constructor(context: APIRequestContext);
1396
1850
  /**
1397
1851
  * Creates a new ManagedZone.
1852
+ * @example
1853
+ * ```js
1854
+ * // Before running the sample:
1855
+ * // - Enable the API at:
1856
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1857
+ * // - Login into gcloud by running:
1858
+ * // ```sh
1859
+ * // $ gcloud auth application-default login
1860
+ * // ```
1861
+ * // - Install the npm module by running:
1862
+ * // ```sh
1863
+ * // $ npm install googleapis
1864
+ * // ```
1865
+ *
1866
+ * const {google} = require('googleapis');
1867
+ * const dns = google.dns('v1beta2');
1868
+ *
1869
+ * async function main() {
1870
+ * const auth = new google.auth.GoogleAuth({
1871
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1872
+ * scopes: [
1873
+ * 'https://www.googleapis.com/auth/cloud-platform',
1874
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1875
+ * ],
1876
+ * });
1877
+ *
1878
+ * // Acquire an auth client, and bind it to all future calls
1879
+ * const authClient = await auth.getClient();
1880
+ * google.options({auth: authClient});
1881
+ *
1882
+ * // Do the magic
1883
+ * const res = await dns.managedZones.create({
1884
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
1885
+ * clientOperationId: 'placeholder-value',
1886
+ * // Identifies the project addressed by this request.
1887
+ * project: 'placeholder-value',
1888
+ *
1889
+ * // Request body metadata
1890
+ * requestBody: {
1891
+ * // request body parameters
1892
+ * // {
1893
+ * // "cloudLoggingConfig": {},
1894
+ * // "creationTime": "my_creationTime",
1895
+ * // "description": "my_description",
1896
+ * // "dnsName": "my_dnsName",
1897
+ * // "dnssecConfig": {},
1898
+ * // "forwardingConfig": {},
1899
+ * // "id": "my_id",
1900
+ * // "kind": "my_kind",
1901
+ * // "labels": {},
1902
+ * // "name": "my_name",
1903
+ * // "nameServerSet": "my_nameServerSet",
1904
+ * // "nameServers": [],
1905
+ * // "peeringConfig": {},
1906
+ * // "privateVisibilityConfig": {},
1907
+ * // "reverseLookupConfig": {},
1908
+ * // "serviceDirectoryConfig": {},
1909
+ * // "visibility": "my_visibility"
1910
+ * // }
1911
+ * },
1912
+ * });
1913
+ * console.log(res.data);
1914
+ *
1915
+ * // Example response
1916
+ * // {
1917
+ * // "cloudLoggingConfig": {},
1918
+ * // "creationTime": "my_creationTime",
1919
+ * // "description": "my_description",
1920
+ * // "dnsName": "my_dnsName",
1921
+ * // "dnssecConfig": {},
1922
+ * // "forwardingConfig": {},
1923
+ * // "id": "my_id",
1924
+ * // "kind": "my_kind",
1925
+ * // "labels": {},
1926
+ * // "name": "my_name",
1927
+ * // "nameServerSet": "my_nameServerSet",
1928
+ * // "nameServers": [],
1929
+ * // "peeringConfig": {},
1930
+ * // "privateVisibilityConfig": {},
1931
+ * // "reverseLookupConfig": {},
1932
+ * // "serviceDirectoryConfig": {},
1933
+ * // "visibility": "my_visibility"
1934
+ * // }
1935
+ * }
1936
+ *
1937
+ * main().catch(e => {
1938
+ * console.error(e);
1939
+ * throw e;
1940
+ * });
1941
+ *
1942
+ * ```
1398
1943
  *
1399
1944
  * @param params - Parameters for request
1400
1945
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1409,6 +1954,54 @@ export declare namespace dns_v1beta2 {
1409
1954
  create(callback: BodyResponseCallback<Schema$ManagedZone>): void;
1410
1955
  /**
1411
1956
  * Deletes a previously created ManagedZone.
1957
+ * @example
1958
+ * ```js
1959
+ * // Before running the sample:
1960
+ * // - Enable the API at:
1961
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
1962
+ * // - Login into gcloud by running:
1963
+ * // ```sh
1964
+ * // $ gcloud auth application-default login
1965
+ * // ```
1966
+ * // - Install the npm module by running:
1967
+ * // ```sh
1968
+ * // $ npm install googleapis
1969
+ * // ```
1970
+ *
1971
+ * const {google} = require('googleapis');
1972
+ * const dns = google.dns('v1beta2');
1973
+ *
1974
+ * async function main() {
1975
+ * const auth = new google.auth.GoogleAuth({
1976
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
1977
+ * scopes: [
1978
+ * 'https://www.googleapis.com/auth/cloud-platform',
1979
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
1980
+ * ],
1981
+ * });
1982
+ *
1983
+ * // Acquire an auth client, and bind it to all future calls
1984
+ * const authClient = await auth.getClient();
1985
+ * google.options({auth: authClient});
1986
+ *
1987
+ * // Do the magic
1988
+ * const res = await dns.managedZones.delete({
1989
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
1990
+ * clientOperationId: 'placeholder-value',
1991
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
1992
+ * managedZone: 'placeholder-value',
1993
+ * // Identifies the project addressed by this request.
1994
+ * project: 'placeholder-value',
1995
+ * });
1996
+ * console.log(res.data);
1997
+ * }
1998
+ *
1999
+ * main().catch(e => {
2000
+ * console.error(e);
2001
+ * throw e;
2002
+ * });
2003
+ *
2004
+ * ```
1412
2005
  *
1413
2006
  * @param params - Parameters for request
1414
2007
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1423,6 +2016,77 @@ export declare namespace dns_v1beta2 {
1423
2016
  delete(callback: BodyResponseCallback<void>): void;
1424
2017
  /**
1425
2018
  * Fetches the representation of an existing ManagedZone.
2019
+ * @example
2020
+ * ```js
2021
+ * // Before running the sample:
2022
+ * // - Enable the API at:
2023
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2024
+ * // - Login into gcloud by running:
2025
+ * // ```sh
2026
+ * // $ gcloud auth application-default login
2027
+ * // ```
2028
+ * // - Install the npm module by running:
2029
+ * // ```sh
2030
+ * // $ npm install googleapis
2031
+ * // ```
2032
+ *
2033
+ * const {google} = require('googleapis');
2034
+ * const dns = google.dns('v1beta2');
2035
+ *
2036
+ * async function main() {
2037
+ * const auth = new google.auth.GoogleAuth({
2038
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2039
+ * scopes: [
2040
+ * 'https://www.googleapis.com/auth/cloud-platform',
2041
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
2042
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
2043
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2044
+ * ],
2045
+ * });
2046
+ *
2047
+ * // Acquire an auth client, and bind it to all future calls
2048
+ * const authClient = await auth.getClient();
2049
+ * google.options({auth: authClient});
2050
+ *
2051
+ * // Do the magic
2052
+ * const res = await dns.managedZones.get({
2053
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
2054
+ * clientOperationId: 'placeholder-value',
2055
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
2056
+ * managedZone: 'placeholder-value',
2057
+ * // Identifies the project addressed by this request.
2058
+ * project: 'placeholder-value',
2059
+ * });
2060
+ * console.log(res.data);
2061
+ *
2062
+ * // Example response
2063
+ * // {
2064
+ * // "cloudLoggingConfig": {},
2065
+ * // "creationTime": "my_creationTime",
2066
+ * // "description": "my_description",
2067
+ * // "dnsName": "my_dnsName",
2068
+ * // "dnssecConfig": {},
2069
+ * // "forwardingConfig": {},
2070
+ * // "id": "my_id",
2071
+ * // "kind": "my_kind",
2072
+ * // "labels": {},
2073
+ * // "name": "my_name",
2074
+ * // "nameServerSet": "my_nameServerSet",
2075
+ * // "nameServers": [],
2076
+ * // "peeringConfig": {},
2077
+ * // "privateVisibilityConfig": {},
2078
+ * // "reverseLookupConfig": {},
2079
+ * // "serviceDirectoryConfig": {},
2080
+ * // "visibility": "my_visibility"
2081
+ * // }
2082
+ * }
2083
+ *
2084
+ * main().catch(e => {
2085
+ * console.error(e);
2086
+ * throw e;
2087
+ * });
2088
+ *
2089
+ * ```
1426
2090
  *
1427
2091
  * @param params - Parameters for request
1428
2092
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1437,6 +2101,68 @@ export declare namespace dns_v1beta2 {
1437
2101
  get(callback: BodyResponseCallback<Schema$ManagedZone>): void;
1438
2102
  /**
1439
2103
  * Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
2104
+ * @example
2105
+ * ```js
2106
+ * // Before running the sample:
2107
+ * // - Enable the API at:
2108
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2109
+ * // - Login into gcloud by running:
2110
+ * // ```sh
2111
+ * // $ gcloud auth application-default login
2112
+ * // ```
2113
+ * // - Install the npm module by running:
2114
+ * // ```sh
2115
+ * // $ npm install googleapis
2116
+ * // ```
2117
+ *
2118
+ * const {google} = require('googleapis');
2119
+ * const dns = google.dns('v1beta2');
2120
+ *
2121
+ * async function main() {
2122
+ * const auth = new google.auth.GoogleAuth({
2123
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2124
+ * scopes: [
2125
+ * 'https://www.googleapis.com/auth/cloud-platform',
2126
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
2127
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
2128
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2129
+ * ],
2130
+ * });
2131
+ *
2132
+ * // Acquire an auth client, and bind it to all future calls
2133
+ * const authClient = await auth.getClient();
2134
+ * google.options({auth: authClient});
2135
+ *
2136
+ * // Do the magic
2137
+ * const res = await dns.managedZones.getIamPolicy({
2138
+ * // 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.
2139
+ * resource: 'projects/my-project/managedZones/my-managedZone',
2140
+ *
2141
+ * // Request body metadata
2142
+ * requestBody: {
2143
+ * // request body parameters
2144
+ * // {
2145
+ * // "options": {}
2146
+ * // }
2147
+ * },
2148
+ * });
2149
+ * console.log(res.data);
2150
+ *
2151
+ * // Example response
2152
+ * // {
2153
+ * // "auditConfigs": [],
2154
+ * // "bindings": [],
2155
+ * // "etag": "my_etag",
2156
+ * // "version": 0
2157
+ * // }
2158
+ * }
2159
+ *
2160
+ * main().catch(e => {
2161
+ * console.error(e);
2162
+ * throw e;
2163
+ * });
2164
+ *
2165
+ * ```
1440
2166
  *
1441
2167
  * @param params - Parameters for request
1442
2168
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1451,6 +2177,65 @@ export declare namespace dns_v1beta2 {
1451
2177
  getIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
1452
2178
  /**
1453
2179
  * Enumerates ManagedZones that have been created but not yet deleted.
2180
+ * @example
2181
+ * ```js
2182
+ * // Before running the sample:
2183
+ * // - Enable the API at:
2184
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2185
+ * // - Login into gcloud by running:
2186
+ * // ```sh
2187
+ * // $ gcloud auth application-default login
2188
+ * // ```
2189
+ * // - Install the npm module by running:
2190
+ * // ```sh
2191
+ * // $ npm install googleapis
2192
+ * // ```
2193
+ *
2194
+ * const {google} = require('googleapis');
2195
+ * const dns = google.dns('v1beta2');
2196
+ *
2197
+ * async function main() {
2198
+ * const auth = new google.auth.GoogleAuth({
2199
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2200
+ * scopes: [
2201
+ * 'https://www.googleapis.com/auth/cloud-platform',
2202
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
2203
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
2204
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2205
+ * ],
2206
+ * });
2207
+ *
2208
+ * // Acquire an auth client, and bind it to all future calls
2209
+ * const authClient = await auth.getClient();
2210
+ * google.options({auth: authClient});
2211
+ *
2212
+ * // Do the magic
2213
+ * const res = await dns.managedZones.list({
2214
+ * // Restricts the list to return only zones with this domain name.
2215
+ * dnsName: 'placeholder-value',
2216
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
2217
+ * maxResults: 'placeholder-value',
2218
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
2219
+ * pageToken: 'placeholder-value',
2220
+ * // Identifies the project addressed by this request.
2221
+ * project: 'placeholder-value',
2222
+ * });
2223
+ * console.log(res.data);
2224
+ *
2225
+ * // Example response
2226
+ * // {
2227
+ * // "kind": "my_kind",
2228
+ * // "managedZones": [],
2229
+ * // "nextPageToken": "my_nextPageToken"
2230
+ * // }
2231
+ * }
2232
+ *
2233
+ * main().catch(e => {
2234
+ * console.error(e);
2235
+ * throw e;
2236
+ * });
2237
+ *
2238
+ * ```
1454
2239
  *
1455
2240
  * @param params - Parameters for request
1456
2241
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1465,6 +2250,90 @@ export declare namespace dns_v1beta2 {
1465
2250
  list(callback: BodyResponseCallback<Schema$ManagedZonesListResponse>): void;
1466
2251
  /**
1467
2252
  * Applies a partial update to an existing ManagedZone.
2253
+ * @example
2254
+ * ```js
2255
+ * // Before running the sample:
2256
+ * // - Enable the API at:
2257
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2258
+ * // - Login into gcloud by running:
2259
+ * // ```sh
2260
+ * // $ gcloud auth application-default login
2261
+ * // ```
2262
+ * // - Install the npm module by running:
2263
+ * // ```sh
2264
+ * // $ npm install googleapis
2265
+ * // ```
2266
+ *
2267
+ * const {google} = require('googleapis');
2268
+ * const dns = google.dns('v1beta2');
2269
+ *
2270
+ * async function main() {
2271
+ * const auth = new google.auth.GoogleAuth({
2272
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2273
+ * scopes: [
2274
+ * 'https://www.googleapis.com/auth/cloud-platform',
2275
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2276
+ * ],
2277
+ * });
2278
+ *
2279
+ * // Acquire an auth client, and bind it to all future calls
2280
+ * const authClient = await auth.getClient();
2281
+ * google.options({auth: authClient});
2282
+ *
2283
+ * // Do the magic
2284
+ * const res = await dns.managedZones.patch({
2285
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
2286
+ * clientOperationId: 'placeholder-value',
2287
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
2288
+ * managedZone: 'placeholder-value',
2289
+ * // Identifies the project addressed by this request.
2290
+ * project: 'placeholder-value',
2291
+ *
2292
+ * // Request body metadata
2293
+ * requestBody: {
2294
+ * // request body parameters
2295
+ * // {
2296
+ * // "cloudLoggingConfig": {},
2297
+ * // "creationTime": "my_creationTime",
2298
+ * // "description": "my_description",
2299
+ * // "dnsName": "my_dnsName",
2300
+ * // "dnssecConfig": {},
2301
+ * // "forwardingConfig": {},
2302
+ * // "id": "my_id",
2303
+ * // "kind": "my_kind",
2304
+ * // "labels": {},
2305
+ * // "name": "my_name",
2306
+ * // "nameServerSet": "my_nameServerSet",
2307
+ * // "nameServers": [],
2308
+ * // "peeringConfig": {},
2309
+ * // "privateVisibilityConfig": {},
2310
+ * // "reverseLookupConfig": {},
2311
+ * // "serviceDirectoryConfig": {},
2312
+ * // "visibility": "my_visibility"
2313
+ * // }
2314
+ * },
2315
+ * });
2316
+ * console.log(res.data);
2317
+ *
2318
+ * // Example response
2319
+ * // {
2320
+ * // "dnsKeyContext": {},
2321
+ * // "id": "my_id",
2322
+ * // "kind": "my_kind",
2323
+ * // "startTime": "my_startTime",
2324
+ * // "status": "my_status",
2325
+ * // "type": "my_type",
2326
+ * // "user": "my_user",
2327
+ * // "zoneContext": {}
2328
+ * // }
2329
+ * }
2330
+ *
2331
+ * main().catch(e => {
2332
+ * console.error(e);
2333
+ * throw e;
2334
+ * });
2335
+ *
2336
+ * ```
1468
2337
  *
1469
2338
  * @param params - Parameters for request
1470
2339
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1479,6 +2348,67 @@ export declare namespace dns_v1beta2 {
1479
2348
  patch(callback: BodyResponseCallback<Schema$Operation>): void;
1480
2349
  /**
1481
2350
  * Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
2351
+ * @example
2352
+ * ```js
2353
+ * // Before running the sample:
2354
+ * // - Enable the API at:
2355
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2356
+ * // - Login into gcloud by running:
2357
+ * // ```sh
2358
+ * // $ gcloud auth application-default login
2359
+ * // ```
2360
+ * // - Install the npm module by running:
2361
+ * // ```sh
2362
+ * // $ npm install googleapis
2363
+ * // ```
2364
+ *
2365
+ * const {google} = require('googleapis');
2366
+ * const dns = google.dns('v1beta2');
2367
+ *
2368
+ * async function main() {
2369
+ * const auth = new google.auth.GoogleAuth({
2370
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2371
+ * scopes: [
2372
+ * 'https://www.googleapis.com/auth/cloud-platform',
2373
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2374
+ * ],
2375
+ * });
2376
+ *
2377
+ * // Acquire an auth client, and bind it to all future calls
2378
+ * const authClient = await auth.getClient();
2379
+ * google.options({auth: authClient});
2380
+ *
2381
+ * // Do the magic
2382
+ * const res = await dns.managedZones.setIamPolicy({
2383
+ * // 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.
2384
+ * resource: 'projects/my-project/managedZones/my-managedZone',
2385
+ *
2386
+ * // Request body metadata
2387
+ * requestBody: {
2388
+ * // request body parameters
2389
+ * // {
2390
+ * // "policy": {},
2391
+ * // "updateMask": "my_updateMask"
2392
+ * // }
2393
+ * },
2394
+ * });
2395
+ * console.log(res.data);
2396
+ *
2397
+ * // Example response
2398
+ * // {
2399
+ * // "auditConfigs": [],
2400
+ * // "bindings": [],
2401
+ * // "etag": "my_etag",
2402
+ * // "version": 0
2403
+ * // }
2404
+ * }
2405
+ *
2406
+ * main().catch(e => {
2407
+ * console.error(e);
2408
+ * throw e;
2409
+ * });
2410
+ *
2411
+ * ```
1482
2412
  *
1483
2413
  * @param params - Parameters for request
1484
2414
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1493,6 +2423,65 @@ export declare namespace dns_v1beta2 {
1493
2423
  setIamPolicy(callback: BodyResponseCallback<Schema$GoogleIamV1Policy>): void;
1494
2424
  /**
1495
2425
  * 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.
2426
+ * @example
2427
+ * ```js
2428
+ * // Before running the sample:
2429
+ * // - Enable the API at:
2430
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2431
+ * // - Login into gcloud by running:
2432
+ * // ```sh
2433
+ * // $ gcloud auth application-default login
2434
+ * // ```
2435
+ * // - Install the npm module by running:
2436
+ * // ```sh
2437
+ * // $ npm install googleapis
2438
+ * // ```
2439
+ *
2440
+ * const {google} = require('googleapis');
2441
+ * const dns = google.dns('v1beta2');
2442
+ *
2443
+ * async function main() {
2444
+ * const auth = new google.auth.GoogleAuth({
2445
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2446
+ * scopes: [
2447
+ * 'https://www.googleapis.com/auth/cloud-platform',
2448
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
2449
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
2450
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2451
+ * ],
2452
+ * });
2453
+ *
2454
+ * // Acquire an auth client, and bind it to all future calls
2455
+ * const authClient = await auth.getClient();
2456
+ * google.options({auth: authClient});
2457
+ *
2458
+ * // Do the magic
2459
+ * const res = await dns.managedZones.testIamPermissions({
2460
+ * // 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.
2461
+ * resource: 'projects/my-project/managedZones/my-managedZone',
2462
+ *
2463
+ * // Request body metadata
2464
+ * requestBody: {
2465
+ * // request body parameters
2466
+ * // {
2467
+ * // "permissions": []
2468
+ * // }
2469
+ * },
2470
+ * });
2471
+ * console.log(res.data);
2472
+ *
2473
+ * // Example response
2474
+ * // {
2475
+ * // "permissions": []
2476
+ * // }
2477
+ * }
2478
+ *
2479
+ * main().catch(e => {
2480
+ * console.error(e);
2481
+ * throw e;
2482
+ * });
2483
+ *
2484
+ * ```
1496
2485
  *
1497
2486
  * @param params - Parameters for request
1498
2487
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1507,6 +2496,90 @@ export declare namespace dns_v1beta2 {
1507
2496
  testIamPermissions(callback: BodyResponseCallback<Schema$GoogleIamV1TestIamPermissionsResponse>): void;
1508
2497
  /**
1509
2498
  * Updates an existing ManagedZone.
2499
+ * @example
2500
+ * ```js
2501
+ * // Before running the sample:
2502
+ * // - Enable the API at:
2503
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2504
+ * // - Login into gcloud by running:
2505
+ * // ```sh
2506
+ * // $ gcloud auth application-default login
2507
+ * // ```
2508
+ * // - Install the npm module by running:
2509
+ * // ```sh
2510
+ * // $ npm install googleapis
2511
+ * // ```
2512
+ *
2513
+ * const {google} = require('googleapis');
2514
+ * const dns = google.dns('v1beta2');
2515
+ *
2516
+ * async function main() {
2517
+ * const auth = new google.auth.GoogleAuth({
2518
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2519
+ * scopes: [
2520
+ * 'https://www.googleapis.com/auth/cloud-platform',
2521
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2522
+ * ],
2523
+ * });
2524
+ *
2525
+ * // Acquire an auth client, and bind it to all future calls
2526
+ * const authClient = await auth.getClient();
2527
+ * google.options({auth: authClient});
2528
+ *
2529
+ * // Do the magic
2530
+ * const res = await dns.managedZones.update({
2531
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
2532
+ * clientOperationId: 'placeholder-value',
2533
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
2534
+ * managedZone: 'placeholder-value',
2535
+ * // Identifies the project addressed by this request.
2536
+ * project: 'placeholder-value',
2537
+ *
2538
+ * // Request body metadata
2539
+ * requestBody: {
2540
+ * // request body parameters
2541
+ * // {
2542
+ * // "cloudLoggingConfig": {},
2543
+ * // "creationTime": "my_creationTime",
2544
+ * // "description": "my_description",
2545
+ * // "dnsName": "my_dnsName",
2546
+ * // "dnssecConfig": {},
2547
+ * // "forwardingConfig": {},
2548
+ * // "id": "my_id",
2549
+ * // "kind": "my_kind",
2550
+ * // "labels": {},
2551
+ * // "name": "my_name",
2552
+ * // "nameServerSet": "my_nameServerSet",
2553
+ * // "nameServers": [],
2554
+ * // "peeringConfig": {},
2555
+ * // "privateVisibilityConfig": {},
2556
+ * // "reverseLookupConfig": {},
2557
+ * // "serviceDirectoryConfig": {},
2558
+ * // "visibility": "my_visibility"
2559
+ * // }
2560
+ * },
2561
+ * });
2562
+ * console.log(res.data);
2563
+ *
2564
+ * // Example response
2565
+ * // {
2566
+ * // "dnsKeyContext": {},
2567
+ * // "id": "my_id",
2568
+ * // "kind": "my_kind",
2569
+ * // "startTime": "my_startTime",
2570
+ * // "status": "my_status",
2571
+ * // "type": "my_type",
2572
+ * // "user": "my_user",
2573
+ * // "zoneContext": {}
2574
+ * // }
2575
+ * }
2576
+ *
2577
+ * main().catch(e => {
2578
+ * console.error(e);
2579
+ * throw e;
2580
+ * });
2581
+ *
2582
+ * ```
1510
2583
  *
1511
2584
  * @param params - Parameters for request
1512
2585
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1651,6 +2724,81 @@ export declare namespace dns_v1beta2 {
1651
2724
  constructor(context: APIRequestContext);
1652
2725
  /**
1653
2726
  * Creates a new Policy.
2727
+ * @example
2728
+ * ```js
2729
+ * // Before running the sample:
2730
+ * // - Enable the API at:
2731
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2732
+ * // - Login into gcloud by running:
2733
+ * // ```sh
2734
+ * // $ gcloud auth application-default login
2735
+ * // ```
2736
+ * // - Install the npm module by running:
2737
+ * // ```sh
2738
+ * // $ npm install googleapis
2739
+ * // ```
2740
+ *
2741
+ * const {google} = require('googleapis');
2742
+ * const dns = google.dns('v1beta2');
2743
+ *
2744
+ * async function main() {
2745
+ * const auth = new google.auth.GoogleAuth({
2746
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2747
+ * scopes: [
2748
+ * 'https://www.googleapis.com/auth/cloud-platform',
2749
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2750
+ * ],
2751
+ * });
2752
+ *
2753
+ * // Acquire an auth client, and bind it to all future calls
2754
+ * const authClient = await auth.getClient();
2755
+ * google.options({auth: authClient});
2756
+ *
2757
+ * // Do the magic
2758
+ * const res = await dns.policies.create({
2759
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
2760
+ * clientOperationId: 'placeholder-value',
2761
+ * // Identifies the project addressed by this request.
2762
+ * project: 'placeholder-value',
2763
+ *
2764
+ * // Request body metadata
2765
+ * requestBody: {
2766
+ * // request body parameters
2767
+ * // {
2768
+ * // "alternativeNameServerConfig": {},
2769
+ * // "description": "my_description",
2770
+ * // "dns64Config": {},
2771
+ * // "enableInboundForwarding": false,
2772
+ * // "enableLogging": false,
2773
+ * // "id": "my_id",
2774
+ * // "kind": "my_kind",
2775
+ * // "name": "my_name",
2776
+ * // "networks": []
2777
+ * // }
2778
+ * },
2779
+ * });
2780
+ * console.log(res.data);
2781
+ *
2782
+ * // Example response
2783
+ * // {
2784
+ * // "alternativeNameServerConfig": {},
2785
+ * // "description": "my_description",
2786
+ * // "dns64Config": {},
2787
+ * // "enableInboundForwarding": false,
2788
+ * // "enableLogging": false,
2789
+ * // "id": "my_id",
2790
+ * // "kind": "my_kind",
2791
+ * // "name": "my_name",
2792
+ * // "networks": []
2793
+ * // }
2794
+ * }
2795
+ *
2796
+ * main().catch(e => {
2797
+ * console.error(e);
2798
+ * throw e;
2799
+ * });
2800
+ *
2801
+ * ```
1654
2802
  *
1655
2803
  * @param params - Parameters for request
1656
2804
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1665,6 +2813,54 @@ export declare namespace dns_v1beta2 {
1665
2813
  create(callback: BodyResponseCallback<Schema$Policy>): void;
1666
2814
  /**
1667
2815
  * Deletes a previously created Policy. Fails if the policy is still being referenced by a network.
2816
+ * @example
2817
+ * ```js
2818
+ * // Before running the sample:
2819
+ * // - Enable the API at:
2820
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2821
+ * // - Login into gcloud by running:
2822
+ * // ```sh
2823
+ * // $ gcloud auth application-default login
2824
+ * // ```
2825
+ * // - Install the npm module by running:
2826
+ * // ```sh
2827
+ * // $ npm install googleapis
2828
+ * // ```
2829
+ *
2830
+ * const {google} = require('googleapis');
2831
+ * const dns = google.dns('v1beta2');
2832
+ *
2833
+ * async function main() {
2834
+ * const auth = new google.auth.GoogleAuth({
2835
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2836
+ * scopes: [
2837
+ * 'https://www.googleapis.com/auth/cloud-platform',
2838
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2839
+ * ],
2840
+ * });
2841
+ *
2842
+ * // Acquire an auth client, and bind it to all future calls
2843
+ * const authClient = await auth.getClient();
2844
+ * google.options({auth: authClient});
2845
+ *
2846
+ * // Do the magic
2847
+ * const res = await dns.policies.delete({
2848
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
2849
+ * clientOperationId: 'placeholder-value',
2850
+ * // User given friendly name of the policy addressed by this request.
2851
+ * policy: 'placeholder-value',
2852
+ * // Identifies the project addressed by this request.
2853
+ * project: 'placeholder-value',
2854
+ * });
2855
+ * console.log(res.data);
2856
+ * }
2857
+ *
2858
+ * main().catch(e => {
2859
+ * console.error(e);
2860
+ * throw e;
2861
+ * });
2862
+ *
2863
+ * ```
1668
2864
  *
1669
2865
  * @param params - Parameters for request
1670
2866
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1679,6 +2875,69 @@ export declare namespace dns_v1beta2 {
1679
2875
  delete(callback: BodyResponseCallback<void>): void;
1680
2876
  /**
1681
2877
  * Fetches the representation of an existing Policy.
2878
+ * @example
2879
+ * ```js
2880
+ * // Before running the sample:
2881
+ * // - Enable the API at:
2882
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2883
+ * // - Login into gcloud by running:
2884
+ * // ```sh
2885
+ * // $ gcloud auth application-default login
2886
+ * // ```
2887
+ * // - Install the npm module by running:
2888
+ * // ```sh
2889
+ * // $ npm install googleapis
2890
+ * // ```
2891
+ *
2892
+ * const {google} = require('googleapis');
2893
+ * const dns = google.dns('v1beta2');
2894
+ *
2895
+ * async function main() {
2896
+ * const auth = new google.auth.GoogleAuth({
2897
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2898
+ * scopes: [
2899
+ * 'https://www.googleapis.com/auth/cloud-platform',
2900
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
2901
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
2902
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2903
+ * ],
2904
+ * });
2905
+ *
2906
+ * // Acquire an auth client, and bind it to all future calls
2907
+ * const authClient = await auth.getClient();
2908
+ * google.options({auth: authClient});
2909
+ *
2910
+ * // Do the magic
2911
+ * const res = await dns.policies.get({
2912
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
2913
+ * clientOperationId: 'placeholder-value',
2914
+ * // User given friendly name of the policy addressed by this request.
2915
+ * policy: 'placeholder-value',
2916
+ * // Identifies the project addressed by this request.
2917
+ * project: 'placeholder-value',
2918
+ * });
2919
+ * console.log(res.data);
2920
+ *
2921
+ * // Example response
2922
+ * // {
2923
+ * // "alternativeNameServerConfig": {},
2924
+ * // "description": "my_description",
2925
+ * // "dns64Config": {},
2926
+ * // "enableInboundForwarding": false,
2927
+ * // "enableLogging": false,
2928
+ * // "id": "my_id",
2929
+ * // "kind": "my_kind",
2930
+ * // "name": "my_name",
2931
+ * // "networks": []
2932
+ * // }
2933
+ * }
2934
+ *
2935
+ * main().catch(e => {
2936
+ * console.error(e);
2937
+ * throw e;
2938
+ * });
2939
+ *
2940
+ * ```
1682
2941
  *
1683
2942
  * @param params - Parameters for request
1684
2943
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1693,6 +2952,63 @@ export declare namespace dns_v1beta2 {
1693
2952
  get(callback: BodyResponseCallback<Schema$Policy>): void;
1694
2953
  /**
1695
2954
  * Enumerates all Policies associated with a project.
2955
+ * @example
2956
+ * ```js
2957
+ * // Before running the sample:
2958
+ * // - Enable the API at:
2959
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
2960
+ * // - Login into gcloud by running:
2961
+ * // ```sh
2962
+ * // $ gcloud auth application-default login
2963
+ * // ```
2964
+ * // - Install the npm module by running:
2965
+ * // ```sh
2966
+ * // $ npm install googleapis
2967
+ * // ```
2968
+ *
2969
+ * const {google} = require('googleapis');
2970
+ * const dns = google.dns('v1beta2');
2971
+ *
2972
+ * async function main() {
2973
+ * const auth = new google.auth.GoogleAuth({
2974
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2975
+ * scopes: [
2976
+ * 'https://www.googleapis.com/auth/cloud-platform',
2977
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
2978
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
2979
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
2980
+ * ],
2981
+ * });
2982
+ *
2983
+ * // Acquire an auth client, and bind it to all future calls
2984
+ * const authClient = await auth.getClient();
2985
+ * google.options({auth: authClient});
2986
+ *
2987
+ * // Do the magic
2988
+ * const res = await dns.policies.list({
2989
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
2990
+ * maxResults: 'placeholder-value',
2991
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
2992
+ * pageToken: 'placeholder-value',
2993
+ * // Identifies the project addressed by this request.
2994
+ * project: 'placeholder-value',
2995
+ * });
2996
+ * console.log(res.data);
2997
+ *
2998
+ * // Example response
2999
+ * // {
3000
+ * // "kind": "my_kind",
3001
+ * // "nextPageToken": "my_nextPageToken",
3002
+ * // "policies": []
3003
+ * // }
3004
+ * }
3005
+ *
3006
+ * main().catch(e => {
3007
+ * console.error(e);
3008
+ * throw e;
3009
+ * });
3010
+ *
3011
+ * ```
1696
3012
  *
1697
3013
  * @param params - Parameters for request
1698
3014
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1707,6 +3023,75 @@ export declare namespace dns_v1beta2 {
1707
3023
  list(callback: BodyResponseCallback<Schema$PoliciesListResponse>): void;
1708
3024
  /**
1709
3025
  * Applies a partial update to an existing Policy.
3026
+ * @example
3027
+ * ```js
3028
+ * // Before running the sample:
3029
+ * // - Enable the API at:
3030
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3031
+ * // - Login into gcloud by running:
3032
+ * // ```sh
3033
+ * // $ gcloud auth application-default login
3034
+ * // ```
3035
+ * // - Install the npm module by running:
3036
+ * // ```sh
3037
+ * // $ npm install googleapis
3038
+ * // ```
3039
+ *
3040
+ * const {google} = require('googleapis');
3041
+ * const dns = google.dns('v1beta2');
3042
+ *
3043
+ * async function main() {
3044
+ * const auth = new google.auth.GoogleAuth({
3045
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3046
+ * scopes: [
3047
+ * 'https://www.googleapis.com/auth/cloud-platform',
3048
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3049
+ * ],
3050
+ * });
3051
+ *
3052
+ * // Acquire an auth client, and bind it to all future calls
3053
+ * const authClient = await auth.getClient();
3054
+ * google.options({auth: authClient});
3055
+ *
3056
+ * // Do the magic
3057
+ * const res = await dns.policies.patch({
3058
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
3059
+ * clientOperationId: 'placeholder-value',
3060
+ * // User given friendly name of the policy addressed by this request.
3061
+ * policy: 'placeholder-value',
3062
+ * // Identifies the project addressed by this request.
3063
+ * project: 'placeholder-value',
3064
+ *
3065
+ * // Request body metadata
3066
+ * requestBody: {
3067
+ * // request body parameters
3068
+ * // {
3069
+ * // "alternativeNameServerConfig": {},
3070
+ * // "description": "my_description",
3071
+ * // "dns64Config": {},
3072
+ * // "enableInboundForwarding": false,
3073
+ * // "enableLogging": false,
3074
+ * // "id": "my_id",
3075
+ * // "kind": "my_kind",
3076
+ * // "name": "my_name",
3077
+ * // "networks": []
3078
+ * // }
3079
+ * },
3080
+ * });
3081
+ * console.log(res.data);
3082
+ *
3083
+ * // Example response
3084
+ * // {
3085
+ * // "policy": {}
3086
+ * // }
3087
+ * }
3088
+ *
3089
+ * main().catch(e => {
3090
+ * console.error(e);
3091
+ * throw e;
3092
+ * });
3093
+ *
3094
+ * ```
1710
3095
  *
1711
3096
  * @param params - Parameters for request
1712
3097
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1721,6 +3106,75 @@ export declare namespace dns_v1beta2 {
1721
3106
  patch(callback: BodyResponseCallback<Schema$PoliciesPatchResponse>): void;
1722
3107
  /**
1723
3108
  * Updates an existing Policy.
3109
+ * @example
3110
+ * ```js
3111
+ * // Before running the sample:
3112
+ * // - Enable the API at:
3113
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3114
+ * // - Login into gcloud by running:
3115
+ * // ```sh
3116
+ * // $ gcloud auth application-default login
3117
+ * // ```
3118
+ * // - Install the npm module by running:
3119
+ * // ```sh
3120
+ * // $ npm install googleapis
3121
+ * // ```
3122
+ *
3123
+ * const {google} = require('googleapis');
3124
+ * const dns = google.dns('v1beta2');
3125
+ *
3126
+ * async function main() {
3127
+ * const auth = new google.auth.GoogleAuth({
3128
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3129
+ * scopes: [
3130
+ * 'https://www.googleapis.com/auth/cloud-platform',
3131
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3132
+ * ],
3133
+ * });
3134
+ *
3135
+ * // Acquire an auth client, and bind it to all future calls
3136
+ * const authClient = await auth.getClient();
3137
+ * google.options({auth: authClient});
3138
+ *
3139
+ * // Do the magic
3140
+ * const res = await dns.policies.update({
3141
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
3142
+ * clientOperationId: 'placeholder-value',
3143
+ * // User given friendly name of the policy addressed by this request.
3144
+ * policy: 'placeholder-value',
3145
+ * // Identifies the project addressed by this request.
3146
+ * project: 'placeholder-value',
3147
+ *
3148
+ * // Request body metadata
3149
+ * requestBody: {
3150
+ * // request body parameters
3151
+ * // {
3152
+ * // "alternativeNameServerConfig": {},
3153
+ * // "description": "my_description",
3154
+ * // "dns64Config": {},
3155
+ * // "enableInboundForwarding": false,
3156
+ * // "enableLogging": false,
3157
+ * // "id": "my_id",
3158
+ * // "kind": "my_kind",
3159
+ * // "name": "my_name",
3160
+ * // "networks": []
3161
+ * // }
3162
+ * },
3163
+ * });
3164
+ * console.log(res.data);
3165
+ *
3166
+ * // Example response
3167
+ * // {
3168
+ * // "policy": {}
3169
+ * // }
3170
+ * }
3171
+ *
3172
+ * main().catch(e => {
3173
+ * console.error(e);
3174
+ * throw e;
3175
+ * });
3176
+ *
3177
+ * ```
1724
3178
  *
1725
3179
  * @param params - Parameters for request
1726
3180
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1831,6 +3285,62 @@ export declare namespace dns_v1beta2 {
1831
3285
  constructor(context: APIRequestContext);
1832
3286
  /**
1833
3287
  * Fetches the representation of an existing Project.
3288
+ * @example
3289
+ * ```js
3290
+ * // Before running the sample:
3291
+ * // - Enable the API at:
3292
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3293
+ * // - Login into gcloud by running:
3294
+ * // ```sh
3295
+ * // $ gcloud auth application-default login
3296
+ * // ```
3297
+ * // - Install the npm module by running:
3298
+ * // ```sh
3299
+ * // $ npm install googleapis
3300
+ * // ```
3301
+ *
3302
+ * const {google} = require('googleapis');
3303
+ * const dns = google.dns('v1beta2');
3304
+ *
3305
+ * async function main() {
3306
+ * const auth = new google.auth.GoogleAuth({
3307
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3308
+ * scopes: [
3309
+ * 'https://www.googleapis.com/auth/cloud-platform',
3310
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
3311
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
3312
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3313
+ * ],
3314
+ * });
3315
+ *
3316
+ * // Acquire an auth client, and bind it to all future calls
3317
+ * const authClient = await auth.getClient();
3318
+ * google.options({auth: authClient});
3319
+ *
3320
+ * // Do the magic
3321
+ * const res = await dns.projects.get({
3322
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
3323
+ * clientOperationId: 'placeholder-value',
3324
+ * // Identifies the project addressed by this request.
3325
+ * project: 'placeholder-value',
3326
+ * });
3327
+ * console.log(res.data);
3328
+ *
3329
+ * // Example response
3330
+ * // {
3331
+ * // "id": "my_id",
3332
+ * // "kind": "my_kind",
3333
+ * // "number": "my_number",
3334
+ * // "quota": {}
3335
+ * // }
3336
+ * }
3337
+ *
3338
+ * main().catch(e => {
3339
+ * console.error(e);
3340
+ * throw e;
3341
+ * });
3342
+ *
3343
+ * ```
1834
3344
  *
1835
3345
  * @param params - Parameters for request
1836
3346
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1859,6 +3369,79 @@ export declare namespace dns_v1beta2 {
1859
3369
  constructor(context: APIRequestContext);
1860
3370
  /**
1861
3371
  * Creates a new ResourceRecordSet.
3372
+ * @example
3373
+ * ```js
3374
+ * // Before running the sample:
3375
+ * // - Enable the API at:
3376
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3377
+ * // - Login into gcloud by running:
3378
+ * // ```sh
3379
+ * // $ gcloud auth application-default login
3380
+ * // ```
3381
+ * // - Install the npm module by running:
3382
+ * // ```sh
3383
+ * // $ npm install googleapis
3384
+ * // ```
3385
+ *
3386
+ * const {google} = require('googleapis');
3387
+ * const dns = google.dns('v1beta2');
3388
+ *
3389
+ * async function main() {
3390
+ * const auth = new google.auth.GoogleAuth({
3391
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3392
+ * scopes: [
3393
+ * 'https://www.googleapis.com/auth/cloud-platform',
3394
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3395
+ * ],
3396
+ * });
3397
+ *
3398
+ * // Acquire an auth client, and bind it to all future calls
3399
+ * const authClient = await auth.getClient();
3400
+ * google.options({auth: authClient});
3401
+ *
3402
+ * // Do the magic
3403
+ * const res = await dns.resourceRecordSets.create({
3404
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
3405
+ * clientOperationId: 'placeholder-value',
3406
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
3407
+ * managedZone: 'placeholder-value',
3408
+ * // Identifies the project addressed by this request.
3409
+ * project: 'placeholder-value',
3410
+ *
3411
+ * // Request body metadata
3412
+ * requestBody: {
3413
+ * // request body parameters
3414
+ * // {
3415
+ * // "kind": "my_kind",
3416
+ * // "name": "my_name",
3417
+ * // "routingPolicy": {},
3418
+ * // "rrdatas": [],
3419
+ * // "signatureRrdatas": [],
3420
+ * // "ttl": 0,
3421
+ * // "type": "my_type"
3422
+ * // }
3423
+ * },
3424
+ * });
3425
+ * console.log(res.data);
3426
+ *
3427
+ * // Example response
3428
+ * // {
3429
+ * // "kind": "my_kind",
3430
+ * // "name": "my_name",
3431
+ * // "routingPolicy": {},
3432
+ * // "rrdatas": [],
3433
+ * // "signatureRrdatas": [],
3434
+ * // "ttl": 0,
3435
+ * // "type": "my_type"
3436
+ * // }
3437
+ * }
3438
+ *
3439
+ * main().catch(e => {
3440
+ * console.error(e);
3441
+ * throw e;
3442
+ * });
3443
+ *
3444
+ * ```
1862
3445
  *
1863
3446
  * @param params - Parameters for request
1864
3447
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1873,6 +3456,58 @@ export declare namespace dns_v1beta2 {
1873
3456
  create(callback: BodyResponseCallback<Schema$ResourceRecordSet>): void;
1874
3457
  /**
1875
3458
  * Deletes a previously created ResourceRecordSet.
3459
+ * @example
3460
+ * ```js
3461
+ * // Before running the sample:
3462
+ * // - Enable the API at:
3463
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3464
+ * // - Login into gcloud by running:
3465
+ * // ```sh
3466
+ * // $ gcloud auth application-default login
3467
+ * // ```
3468
+ * // - Install the npm module by running:
3469
+ * // ```sh
3470
+ * // $ npm install googleapis
3471
+ * // ```
3472
+ *
3473
+ * const {google} = require('googleapis');
3474
+ * const dns = google.dns('v1beta2');
3475
+ *
3476
+ * async function main() {
3477
+ * const auth = new google.auth.GoogleAuth({
3478
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3479
+ * scopes: [
3480
+ * 'https://www.googleapis.com/auth/cloud-platform',
3481
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3482
+ * ],
3483
+ * });
3484
+ *
3485
+ * // Acquire an auth client, and bind it to all future calls
3486
+ * const authClient = await auth.getClient();
3487
+ * google.options({auth: authClient});
3488
+ *
3489
+ * // Do the magic
3490
+ * const res = await dns.resourceRecordSets.delete({
3491
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
3492
+ * clientOperationId: 'placeholder-value',
3493
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
3494
+ * managedZone: 'placeholder-value',
3495
+ * // Fully qualified domain name.
3496
+ * name: 'placeholder-value',
3497
+ * // Identifies the project addressed by this request.
3498
+ * project: 'placeholder-value',
3499
+ * // RRSet type.
3500
+ * type: 'placeholder-value',
3501
+ * });
3502
+ * console.log(res.data);
3503
+ * }
3504
+ *
3505
+ * main().catch(e => {
3506
+ * console.error(e);
3507
+ * throw e;
3508
+ * });
3509
+ *
3510
+ * ```
1876
3511
  *
1877
3512
  * @param params - Parameters for request
1878
3513
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1887,6 +3522,71 @@ export declare namespace dns_v1beta2 {
1887
3522
  delete(callback: BodyResponseCallback<void>): void;
1888
3523
  /**
1889
3524
  * Fetches the representation of an existing ResourceRecordSet.
3525
+ * @example
3526
+ * ```js
3527
+ * // Before running the sample:
3528
+ * // - Enable the API at:
3529
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3530
+ * // - Login into gcloud by running:
3531
+ * // ```sh
3532
+ * // $ gcloud auth application-default login
3533
+ * // ```
3534
+ * // - Install the npm module by running:
3535
+ * // ```sh
3536
+ * // $ npm install googleapis
3537
+ * // ```
3538
+ *
3539
+ * const {google} = require('googleapis');
3540
+ * const dns = google.dns('v1beta2');
3541
+ *
3542
+ * async function main() {
3543
+ * const auth = new google.auth.GoogleAuth({
3544
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3545
+ * scopes: [
3546
+ * 'https://www.googleapis.com/auth/cloud-platform',
3547
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
3548
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
3549
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3550
+ * ],
3551
+ * });
3552
+ *
3553
+ * // Acquire an auth client, and bind it to all future calls
3554
+ * const authClient = await auth.getClient();
3555
+ * google.options({auth: authClient});
3556
+ *
3557
+ * // Do the magic
3558
+ * const res = await dns.resourceRecordSets.get({
3559
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
3560
+ * clientOperationId: 'placeholder-value',
3561
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
3562
+ * managedZone: 'placeholder-value',
3563
+ * // Fully qualified domain name.
3564
+ * name: 'placeholder-value',
3565
+ * // Identifies the project addressed by this request.
3566
+ * project: 'placeholder-value',
3567
+ * // RRSet type.
3568
+ * type: 'placeholder-value',
3569
+ * });
3570
+ * console.log(res.data);
3571
+ *
3572
+ * // Example response
3573
+ * // {
3574
+ * // "kind": "my_kind",
3575
+ * // "name": "my_name",
3576
+ * // "routingPolicy": {},
3577
+ * // "rrdatas": [],
3578
+ * // "signatureRrdatas": [],
3579
+ * // "ttl": 0,
3580
+ * // "type": "my_type"
3581
+ * // }
3582
+ * }
3583
+ *
3584
+ * main().catch(e => {
3585
+ * console.error(e);
3586
+ * throw e;
3587
+ * });
3588
+ *
3589
+ * ```
1890
3590
  *
1891
3591
  * @param params - Parameters for request
1892
3592
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1901,6 +3601,69 @@ export declare namespace dns_v1beta2 {
1901
3601
  get(callback: BodyResponseCallback<Schema$ResourceRecordSet>): void;
1902
3602
  /**
1903
3603
  * Enumerates ResourceRecordSets that you have created but not yet deleted.
3604
+ * @example
3605
+ * ```js
3606
+ * // Before running the sample:
3607
+ * // - Enable the API at:
3608
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3609
+ * // - Login into gcloud by running:
3610
+ * // ```sh
3611
+ * // $ gcloud auth application-default login
3612
+ * // ```
3613
+ * // - Install the npm module by running:
3614
+ * // ```sh
3615
+ * // $ npm install googleapis
3616
+ * // ```
3617
+ *
3618
+ * const {google} = require('googleapis');
3619
+ * const dns = google.dns('v1beta2');
3620
+ *
3621
+ * async function main() {
3622
+ * const auth = new google.auth.GoogleAuth({
3623
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3624
+ * scopes: [
3625
+ * 'https://www.googleapis.com/auth/cloud-platform',
3626
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
3627
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
3628
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3629
+ * ],
3630
+ * });
3631
+ *
3632
+ * // Acquire an auth client, and bind it to all future calls
3633
+ * const authClient = await auth.getClient();
3634
+ * google.options({auth: authClient});
3635
+ *
3636
+ * // Do the magic
3637
+ * const res = await dns.resourceRecordSets.list({
3638
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
3639
+ * managedZone: 'placeholder-value',
3640
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
3641
+ * maxResults: 'placeholder-value',
3642
+ * // Restricts the list to return only records with this fully qualified domain name.
3643
+ * name: 'placeholder-value',
3644
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
3645
+ * pageToken: 'placeholder-value',
3646
+ * // Identifies the project addressed by this request.
3647
+ * project: 'placeholder-value',
3648
+ * // Restricts the list to return only records of this type. If present, the "name" parameter must also be present.
3649
+ * type: 'placeholder-value',
3650
+ * });
3651
+ * console.log(res.data);
3652
+ *
3653
+ * // Example response
3654
+ * // {
3655
+ * // "kind": "my_kind",
3656
+ * // "nextPageToken": "my_nextPageToken",
3657
+ * // "rrsets": []
3658
+ * // }
3659
+ * }
3660
+ *
3661
+ * main().catch(e => {
3662
+ * console.error(e);
3663
+ * throw e;
3664
+ * });
3665
+ *
3666
+ * ```
1904
3667
  *
1905
3668
  * @param params - Parameters for request
1906
3669
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -1915,6 +3678,83 @@ export declare namespace dns_v1beta2 {
1915
3678
  list(callback: BodyResponseCallback<Schema$ResourceRecordSetsListResponse>): void;
1916
3679
  /**
1917
3680
  * Applies a partial update to an existing ResourceRecordSet.
3681
+ * @example
3682
+ * ```js
3683
+ * // Before running the sample:
3684
+ * // - Enable the API at:
3685
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3686
+ * // - Login into gcloud by running:
3687
+ * // ```sh
3688
+ * // $ gcloud auth application-default login
3689
+ * // ```
3690
+ * // - Install the npm module by running:
3691
+ * // ```sh
3692
+ * // $ npm install googleapis
3693
+ * // ```
3694
+ *
3695
+ * const {google} = require('googleapis');
3696
+ * const dns = google.dns('v1beta2');
3697
+ *
3698
+ * async function main() {
3699
+ * const auth = new google.auth.GoogleAuth({
3700
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3701
+ * scopes: [
3702
+ * 'https://www.googleapis.com/auth/cloud-platform',
3703
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3704
+ * ],
3705
+ * });
3706
+ *
3707
+ * // Acquire an auth client, and bind it to all future calls
3708
+ * const authClient = await auth.getClient();
3709
+ * google.options({auth: authClient});
3710
+ *
3711
+ * // Do the magic
3712
+ * const res = await dns.resourceRecordSets.patch({
3713
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
3714
+ * clientOperationId: 'placeholder-value',
3715
+ * // Identifies the managed zone addressed by this request. Can be the managed zone name or ID.
3716
+ * managedZone: 'placeholder-value',
3717
+ * // Fully qualified domain name.
3718
+ * name: 'placeholder-value',
3719
+ * // Identifies the project addressed by this request.
3720
+ * project: 'placeholder-value',
3721
+ * // RRSet type.
3722
+ * type: 'placeholder-value',
3723
+ *
3724
+ * // Request body metadata
3725
+ * requestBody: {
3726
+ * // request body parameters
3727
+ * // {
3728
+ * // "kind": "my_kind",
3729
+ * // "name": "my_name",
3730
+ * // "routingPolicy": {},
3731
+ * // "rrdatas": [],
3732
+ * // "signatureRrdatas": [],
3733
+ * // "ttl": 0,
3734
+ * // "type": "my_type"
3735
+ * // }
3736
+ * },
3737
+ * });
3738
+ * console.log(res.data);
3739
+ *
3740
+ * // Example response
3741
+ * // {
3742
+ * // "kind": "my_kind",
3743
+ * // "name": "my_name",
3744
+ * // "routingPolicy": {},
3745
+ * // "rrdatas": [],
3746
+ * // "signatureRrdatas": [],
3747
+ * // "ttl": 0,
3748
+ * // "type": "my_type"
3749
+ * // }
3750
+ * }
3751
+ *
3752
+ * main().catch(e => {
3753
+ * console.error(e);
3754
+ * throw e;
3755
+ * });
3756
+ *
3757
+ * ```
1918
3758
  *
1919
3759
  * @param params - Parameters for request
1920
3760
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2047,6 +3887,77 @@ export declare namespace dns_v1beta2 {
2047
3887
  constructor(context: APIRequestContext);
2048
3888
  /**
2049
3889
  * Creates a new Response Policy
3890
+ * @example
3891
+ * ```js
3892
+ * // Before running the sample:
3893
+ * // - Enable the API at:
3894
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3895
+ * // - Login into gcloud by running:
3896
+ * // ```sh
3897
+ * // $ gcloud auth application-default login
3898
+ * // ```
3899
+ * // - Install the npm module by running:
3900
+ * // ```sh
3901
+ * // $ npm install googleapis
3902
+ * // ```
3903
+ *
3904
+ * const {google} = require('googleapis');
3905
+ * const dns = google.dns('v1beta2');
3906
+ *
3907
+ * async function main() {
3908
+ * const auth = new google.auth.GoogleAuth({
3909
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3910
+ * scopes: [
3911
+ * 'https://www.googleapis.com/auth/cloud-platform',
3912
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3913
+ * ],
3914
+ * });
3915
+ *
3916
+ * // Acquire an auth client, and bind it to all future calls
3917
+ * const authClient = await auth.getClient();
3918
+ * google.options({auth: authClient});
3919
+ *
3920
+ * // Do the magic
3921
+ * const res = await dns.responsePolicies.create({
3922
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
3923
+ * clientOperationId: 'placeholder-value',
3924
+ * // Identifies the project addressed by this request.
3925
+ * project: 'placeholder-value',
3926
+ *
3927
+ * // Request body metadata
3928
+ * requestBody: {
3929
+ * // request body parameters
3930
+ * // {
3931
+ * // "description": "my_description",
3932
+ * // "gkeClusters": [],
3933
+ * // "id": "my_id",
3934
+ * // "kind": "my_kind",
3935
+ * // "labels": {},
3936
+ * // "networks": [],
3937
+ * // "responsePolicyName": "my_responsePolicyName"
3938
+ * // }
3939
+ * },
3940
+ * });
3941
+ * console.log(res.data);
3942
+ *
3943
+ * // Example response
3944
+ * // {
3945
+ * // "description": "my_description",
3946
+ * // "gkeClusters": [],
3947
+ * // "id": "my_id",
3948
+ * // "kind": "my_kind",
3949
+ * // "labels": {},
3950
+ * // "networks": [],
3951
+ * // "responsePolicyName": "my_responsePolicyName"
3952
+ * // }
3953
+ * }
3954
+ *
3955
+ * main().catch(e => {
3956
+ * console.error(e);
3957
+ * throw e;
3958
+ * });
3959
+ *
3960
+ * ```
2050
3961
  *
2051
3962
  * @param params - Parameters for request
2052
3963
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2061,6 +3972,54 @@ export declare namespace dns_v1beta2 {
2061
3972
  create(callback: BodyResponseCallback<Schema$ResponsePolicy>): void;
2062
3973
  /**
2063
3974
  * Deletes a previously created Response Policy. Fails if the response policy is non-empty or still being referenced by a network.
3975
+ * @example
3976
+ * ```js
3977
+ * // Before running the sample:
3978
+ * // - Enable the API at:
3979
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
3980
+ * // - Login into gcloud by running:
3981
+ * // ```sh
3982
+ * // $ gcloud auth application-default login
3983
+ * // ```
3984
+ * // - Install the npm module by running:
3985
+ * // ```sh
3986
+ * // $ npm install googleapis
3987
+ * // ```
3988
+ *
3989
+ * const {google} = require('googleapis');
3990
+ * const dns = google.dns('v1beta2');
3991
+ *
3992
+ * async function main() {
3993
+ * const auth = new google.auth.GoogleAuth({
3994
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3995
+ * scopes: [
3996
+ * 'https://www.googleapis.com/auth/cloud-platform',
3997
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
3998
+ * ],
3999
+ * });
4000
+ *
4001
+ * // Acquire an auth client, and bind it to all future calls
4002
+ * const authClient = await auth.getClient();
4003
+ * google.options({auth: authClient});
4004
+ *
4005
+ * // Do the magic
4006
+ * const res = await dns.responsePolicies.delete({
4007
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4008
+ * clientOperationId: 'placeholder-value',
4009
+ * // Identifies the project addressed by this request.
4010
+ * project: 'placeholder-value',
4011
+ * // User assigned name of the Response Policy addressed by this request.
4012
+ * responsePolicy: 'placeholder-value',
4013
+ * });
4014
+ * console.log(res.data);
4015
+ * }
4016
+ *
4017
+ * main().catch(e => {
4018
+ * console.error(e);
4019
+ * throw e;
4020
+ * });
4021
+ *
4022
+ * ```
2064
4023
  *
2065
4024
  * @param params - Parameters for request
2066
4025
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2075,6 +4034,67 @@ export declare namespace dns_v1beta2 {
2075
4034
  delete(callback: BodyResponseCallback<void>): void;
2076
4035
  /**
2077
4036
  * Fetches the representation of an existing Response Policy.
4037
+ * @example
4038
+ * ```js
4039
+ * // Before running the sample:
4040
+ * // - Enable the API at:
4041
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4042
+ * // - Login into gcloud by running:
4043
+ * // ```sh
4044
+ * // $ gcloud auth application-default login
4045
+ * // ```
4046
+ * // - Install the npm module by running:
4047
+ * // ```sh
4048
+ * // $ npm install googleapis
4049
+ * // ```
4050
+ *
4051
+ * const {google} = require('googleapis');
4052
+ * const dns = google.dns('v1beta2');
4053
+ *
4054
+ * async function main() {
4055
+ * const auth = new google.auth.GoogleAuth({
4056
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4057
+ * scopes: [
4058
+ * 'https://www.googleapis.com/auth/cloud-platform',
4059
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
4060
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
4061
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4062
+ * ],
4063
+ * });
4064
+ *
4065
+ * // Acquire an auth client, and bind it to all future calls
4066
+ * const authClient = await auth.getClient();
4067
+ * google.options({auth: authClient});
4068
+ *
4069
+ * // Do the magic
4070
+ * const res = await dns.responsePolicies.get({
4071
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4072
+ * clientOperationId: 'placeholder-value',
4073
+ * // Identifies the project addressed by this request.
4074
+ * project: 'placeholder-value',
4075
+ * // User assigned name of the Response Policy addressed by this request.
4076
+ * responsePolicy: 'placeholder-value',
4077
+ * });
4078
+ * console.log(res.data);
4079
+ *
4080
+ * // Example response
4081
+ * // {
4082
+ * // "description": "my_description",
4083
+ * // "gkeClusters": [],
4084
+ * // "id": "my_id",
4085
+ * // "kind": "my_kind",
4086
+ * // "labels": {},
4087
+ * // "networks": [],
4088
+ * // "responsePolicyName": "my_responsePolicyName"
4089
+ * // }
4090
+ * }
4091
+ *
4092
+ * main().catch(e => {
4093
+ * console.error(e);
4094
+ * throw e;
4095
+ * });
4096
+ *
4097
+ * ```
2078
4098
  *
2079
4099
  * @param params - Parameters for request
2080
4100
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2089,6 +4109,62 @@ export declare namespace dns_v1beta2 {
2089
4109
  get(callback: BodyResponseCallback<Schema$ResponsePolicy>): void;
2090
4110
  /**
2091
4111
  * Enumerates all Response Policies associated with a project.
4112
+ * @example
4113
+ * ```js
4114
+ * // Before running the sample:
4115
+ * // - Enable the API at:
4116
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4117
+ * // - Login into gcloud by running:
4118
+ * // ```sh
4119
+ * // $ gcloud auth application-default login
4120
+ * // ```
4121
+ * // - Install the npm module by running:
4122
+ * // ```sh
4123
+ * // $ npm install googleapis
4124
+ * // ```
4125
+ *
4126
+ * const {google} = require('googleapis');
4127
+ * const dns = google.dns('v1beta2');
4128
+ *
4129
+ * async function main() {
4130
+ * const auth = new google.auth.GoogleAuth({
4131
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4132
+ * scopes: [
4133
+ * 'https://www.googleapis.com/auth/cloud-platform',
4134
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
4135
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
4136
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4137
+ * ],
4138
+ * });
4139
+ *
4140
+ * // Acquire an auth client, and bind it to all future calls
4141
+ * const authClient = await auth.getClient();
4142
+ * google.options({auth: authClient});
4143
+ *
4144
+ * // Do the magic
4145
+ * const res = await dns.responsePolicies.list({
4146
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
4147
+ * maxResults: 'placeholder-value',
4148
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
4149
+ * pageToken: 'placeholder-value',
4150
+ * // Identifies the project addressed by this request.
4151
+ * project: 'placeholder-value',
4152
+ * });
4153
+ * console.log(res.data);
4154
+ *
4155
+ * // Example response
4156
+ * // {
4157
+ * // "nextPageToken": "my_nextPageToken",
4158
+ * // "responsePolicies": []
4159
+ * // }
4160
+ * }
4161
+ *
4162
+ * main().catch(e => {
4163
+ * console.error(e);
4164
+ * throw e;
4165
+ * });
4166
+ *
4167
+ * ```
2092
4168
  *
2093
4169
  * @param params - Parameters for request
2094
4170
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2103,6 +4179,73 @@ export declare namespace dns_v1beta2 {
2103
4179
  list(callback: BodyResponseCallback<Schema$ResponsePoliciesListResponse>): void;
2104
4180
  /**
2105
4181
  * Applies a partial update to an existing Response Policy.
4182
+ * @example
4183
+ * ```js
4184
+ * // Before running the sample:
4185
+ * // - Enable the API at:
4186
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4187
+ * // - Login into gcloud by running:
4188
+ * // ```sh
4189
+ * // $ gcloud auth application-default login
4190
+ * // ```
4191
+ * // - Install the npm module by running:
4192
+ * // ```sh
4193
+ * // $ npm install googleapis
4194
+ * // ```
4195
+ *
4196
+ * const {google} = require('googleapis');
4197
+ * const dns = google.dns('v1beta2');
4198
+ *
4199
+ * async function main() {
4200
+ * const auth = new google.auth.GoogleAuth({
4201
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4202
+ * scopes: [
4203
+ * 'https://www.googleapis.com/auth/cloud-platform',
4204
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4205
+ * ],
4206
+ * });
4207
+ *
4208
+ * // Acquire an auth client, and bind it to all future calls
4209
+ * const authClient = await auth.getClient();
4210
+ * google.options({auth: authClient});
4211
+ *
4212
+ * // Do the magic
4213
+ * const res = await dns.responsePolicies.patch({
4214
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4215
+ * clientOperationId: 'placeholder-value',
4216
+ * // Identifies the project addressed by this request.
4217
+ * project: 'placeholder-value',
4218
+ * // User assigned name of the response policy addressed by this request.
4219
+ * responsePolicy: 'placeholder-value',
4220
+ *
4221
+ * // Request body metadata
4222
+ * requestBody: {
4223
+ * // request body parameters
4224
+ * // {
4225
+ * // "description": "my_description",
4226
+ * // "gkeClusters": [],
4227
+ * // "id": "my_id",
4228
+ * // "kind": "my_kind",
4229
+ * // "labels": {},
4230
+ * // "networks": [],
4231
+ * // "responsePolicyName": "my_responsePolicyName"
4232
+ * // }
4233
+ * },
4234
+ * });
4235
+ * console.log(res.data);
4236
+ *
4237
+ * // Example response
4238
+ * // {
4239
+ * // "responsePolicy": {}
4240
+ * // }
4241
+ * }
4242
+ *
4243
+ * main().catch(e => {
4244
+ * console.error(e);
4245
+ * throw e;
4246
+ * });
4247
+ *
4248
+ * ```
2106
4249
  *
2107
4250
  * @param params - Parameters for request
2108
4251
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2117,6 +4260,73 @@ export declare namespace dns_v1beta2 {
2117
4260
  patch(callback: BodyResponseCallback<Schema$ResponsePoliciesPatchResponse>): void;
2118
4261
  /**
2119
4262
  * Updates an existing Response Policy.
4263
+ * @example
4264
+ * ```js
4265
+ * // Before running the sample:
4266
+ * // - Enable the API at:
4267
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4268
+ * // - Login into gcloud by running:
4269
+ * // ```sh
4270
+ * // $ gcloud auth application-default login
4271
+ * // ```
4272
+ * // - Install the npm module by running:
4273
+ * // ```sh
4274
+ * // $ npm install googleapis
4275
+ * // ```
4276
+ *
4277
+ * const {google} = require('googleapis');
4278
+ * const dns = google.dns('v1beta2');
4279
+ *
4280
+ * async function main() {
4281
+ * const auth = new google.auth.GoogleAuth({
4282
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4283
+ * scopes: [
4284
+ * 'https://www.googleapis.com/auth/cloud-platform',
4285
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4286
+ * ],
4287
+ * });
4288
+ *
4289
+ * // Acquire an auth client, and bind it to all future calls
4290
+ * const authClient = await auth.getClient();
4291
+ * google.options({auth: authClient});
4292
+ *
4293
+ * // Do the magic
4294
+ * const res = await dns.responsePolicies.update({
4295
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4296
+ * clientOperationId: 'placeholder-value',
4297
+ * // Identifies the project addressed by this request.
4298
+ * project: 'placeholder-value',
4299
+ * // User assigned name of the Response Policy addressed by this request.
4300
+ * responsePolicy: 'placeholder-value',
4301
+ *
4302
+ * // Request body metadata
4303
+ * requestBody: {
4304
+ * // request body parameters
4305
+ * // {
4306
+ * // "description": "my_description",
4307
+ * // "gkeClusters": [],
4308
+ * // "id": "my_id",
4309
+ * // "kind": "my_kind",
4310
+ * // "labels": {},
4311
+ * // "networks": [],
4312
+ * // "responsePolicyName": "my_responsePolicyName"
4313
+ * // }
4314
+ * },
4315
+ * });
4316
+ * console.log(res.data);
4317
+ *
4318
+ * // Example response
4319
+ * // {
4320
+ * // "responsePolicy": {}
4321
+ * // }
4322
+ * }
4323
+ *
4324
+ * main().catch(e => {
4325
+ * console.error(e);
4326
+ * throw e;
4327
+ * });
4328
+ *
4329
+ * ```
2120
4330
  *
2121
4331
  * @param params - Parameters for request
2122
4332
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2227,6 +4437,75 @@ export declare namespace dns_v1beta2 {
2227
4437
  constructor(context: APIRequestContext);
2228
4438
  /**
2229
4439
  * Creates a new Response Policy Rule.
4440
+ * @example
4441
+ * ```js
4442
+ * // Before running the sample:
4443
+ * // - Enable the API at:
4444
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4445
+ * // - Login into gcloud by running:
4446
+ * // ```sh
4447
+ * // $ gcloud auth application-default login
4448
+ * // ```
4449
+ * // - Install the npm module by running:
4450
+ * // ```sh
4451
+ * // $ npm install googleapis
4452
+ * // ```
4453
+ *
4454
+ * const {google} = require('googleapis');
4455
+ * const dns = google.dns('v1beta2');
4456
+ *
4457
+ * async function main() {
4458
+ * const auth = new google.auth.GoogleAuth({
4459
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4460
+ * scopes: [
4461
+ * 'https://www.googleapis.com/auth/cloud-platform',
4462
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4463
+ * ],
4464
+ * });
4465
+ *
4466
+ * // Acquire an auth client, and bind it to all future calls
4467
+ * const authClient = await auth.getClient();
4468
+ * google.options({auth: authClient});
4469
+ *
4470
+ * // Do the magic
4471
+ * const res = await dns.responsePolicyRules.create({
4472
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4473
+ * clientOperationId: 'placeholder-value',
4474
+ * // Identifies the project addressed by this request.
4475
+ * project: 'placeholder-value',
4476
+ * // User assigned name of the Response Policy containing the Response Policy Rule.
4477
+ * responsePolicy: 'placeholder-value',
4478
+ *
4479
+ * // Request body metadata
4480
+ * requestBody: {
4481
+ * // request body parameters
4482
+ * // {
4483
+ * // "behavior": "my_behavior",
4484
+ * // "dnsName": "my_dnsName",
4485
+ * // "kind": "my_kind",
4486
+ * // "localData": {},
4487
+ * // "ruleName": "my_ruleName"
4488
+ * // }
4489
+ * },
4490
+ * });
4491
+ * console.log(res.data);
4492
+ *
4493
+ * // Example response
4494
+ * // {
4495
+ * // "behavior": "my_behavior",
4496
+ * // "dnsName": "my_dnsName",
4497
+ * // "kind": "my_kind",
4498
+ * // "localData": {},
4499
+ * // "ruleName": "my_ruleName"
4500
+ * // }
4501
+ * }
4502
+ *
4503
+ * main().catch(e => {
4504
+ * console.error(e);
4505
+ * throw e;
4506
+ * });
4507
+ *
4508
+ * ```
2230
4509
  *
2231
4510
  * @param params - Parameters for request
2232
4511
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2241,6 +4520,56 @@ export declare namespace dns_v1beta2 {
2241
4520
  create(callback: BodyResponseCallback<Schema$ResponsePolicyRule>): void;
2242
4521
  /**
2243
4522
  * Deletes a previously created Response Policy Rule.
4523
+ * @example
4524
+ * ```js
4525
+ * // Before running the sample:
4526
+ * // - Enable the API at:
4527
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4528
+ * // - Login into gcloud by running:
4529
+ * // ```sh
4530
+ * // $ gcloud auth application-default login
4531
+ * // ```
4532
+ * // - Install the npm module by running:
4533
+ * // ```sh
4534
+ * // $ npm install googleapis
4535
+ * // ```
4536
+ *
4537
+ * const {google} = require('googleapis');
4538
+ * const dns = google.dns('v1beta2');
4539
+ *
4540
+ * async function main() {
4541
+ * const auth = new google.auth.GoogleAuth({
4542
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4543
+ * scopes: [
4544
+ * 'https://www.googleapis.com/auth/cloud-platform',
4545
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4546
+ * ],
4547
+ * });
4548
+ *
4549
+ * // Acquire an auth client, and bind it to all future calls
4550
+ * const authClient = await auth.getClient();
4551
+ * google.options({auth: authClient});
4552
+ *
4553
+ * // Do the magic
4554
+ * const res = await dns.responsePolicyRules.delete({
4555
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4556
+ * clientOperationId: 'placeholder-value',
4557
+ * // Identifies the project addressed by this request.
4558
+ * project: 'placeholder-value',
4559
+ * // User assigned name of the Response Policy containing the Response Policy Rule.
4560
+ * responsePolicy: 'placeholder-value',
4561
+ * // User assigned name of the Response Policy Rule addressed by this request.
4562
+ * responsePolicyRule: 'placeholder-value',
4563
+ * });
4564
+ * console.log(res.data);
4565
+ * }
4566
+ *
4567
+ * main().catch(e => {
4568
+ * console.error(e);
4569
+ * throw e;
4570
+ * });
4571
+ *
4572
+ * ```
2244
4573
  *
2245
4574
  * @param params - Parameters for request
2246
4575
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2255,6 +4584,67 @@ export declare namespace dns_v1beta2 {
2255
4584
  delete(callback: BodyResponseCallback<void>): void;
2256
4585
  /**
2257
4586
  * Fetches the representation of an existing Response Policy Rule.
4587
+ * @example
4588
+ * ```js
4589
+ * // Before running the sample:
4590
+ * // - Enable the API at:
4591
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4592
+ * // - Login into gcloud by running:
4593
+ * // ```sh
4594
+ * // $ gcloud auth application-default login
4595
+ * // ```
4596
+ * // - Install the npm module by running:
4597
+ * // ```sh
4598
+ * // $ npm install googleapis
4599
+ * // ```
4600
+ *
4601
+ * const {google} = require('googleapis');
4602
+ * const dns = google.dns('v1beta2');
4603
+ *
4604
+ * async function main() {
4605
+ * const auth = new google.auth.GoogleAuth({
4606
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4607
+ * scopes: [
4608
+ * 'https://www.googleapis.com/auth/cloud-platform',
4609
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
4610
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
4611
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4612
+ * ],
4613
+ * });
4614
+ *
4615
+ * // Acquire an auth client, and bind it to all future calls
4616
+ * const authClient = await auth.getClient();
4617
+ * google.options({auth: authClient});
4618
+ *
4619
+ * // Do the magic
4620
+ * const res = await dns.responsePolicyRules.get({
4621
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4622
+ * clientOperationId: 'placeholder-value',
4623
+ * // Identifies the project addressed by this request.
4624
+ * project: 'placeholder-value',
4625
+ * // User assigned name of the Response Policy containing the Response Policy Rule.
4626
+ * responsePolicy: 'placeholder-value',
4627
+ * // User assigned name of the Response Policy Rule addressed by this request.
4628
+ * responsePolicyRule: 'placeholder-value',
4629
+ * });
4630
+ * console.log(res.data);
4631
+ *
4632
+ * // Example response
4633
+ * // {
4634
+ * // "behavior": "my_behavior",
4635
+ * // "dnsName": "my_dnsName",
4636
+ * // "kind": "my_kind",
4637
+ * // "localData": {},
4638
+ * // "ruleName": "my_ruleName"
4639
+ * // }
4640
+ * }
4641
+ *
4642
+ * main().catch(e => {
4643
+ * console.error(e);
4644
+ * throw e;
4645
+ * });
4646
+ *
4647
+ * ```
2258
4648
  *
2259
4649
  * @param params - Parameters for request
2260
4650
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2269,6 +4659,64 @@ export declare namespace dns_v1beta2 {
2269
4659
  get(callback: BodyResponseCallback<Schema$ResponsePolicyRule>): void;
2270
4660
  /**
2271
4661
  * Enumerates all Response Policy Rules associated with a project.
4662
+ * @example
4663
+ * ```js
4664
+ * // Before running the sample:
4665
+ * // - Enable the API at:
4666
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4667
+ * // - Login into gcloud by running:
4668
+ * // ```sh
4669
+ * // $ gcloud auth application-default login
4670
+ * // ```
4671
+ * // - Install the npm module by running:
4672
+ * // ```sh
4673
+ * // $ npm install googleapis
4674
+ * // ```
4675
+ *
4676
+ * const {google} = require('googleapis');
4677
+ * const dns = google.dns('v1beta2');
4678
+ *
4679
+ * async function main() {
4680
+ * const auth = new google.auth.GoogleAuth({
4681
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4682
+ * scopes: [
4683
+ * 'https://www.googleapis.com/auth/cloud-platform',
4684
+ * 'https://www.googleapis.com/auth/cloud-platform.read-only',
4685
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readonly',
4686
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4687
+ * ],
4688
+ * });
4689
+ *
4690
+ * // Acquire an auth client, and bind it to all future calls
4691
+ * const authClient = await auth.getClient();
4692
+ * google.options({auth: authClient});
4693
+ *
4694
+ * // Do the magic
4695
+ * const res = await dns.responsePolicyRules.list({
4696
+ * // Optional. Maximum number of results to be returned. If unspecified, the server decides how many results to return.
4697
+ * maxResults: 'placeholder-value',
4698
+ * // Optional. A tag returned by a previous list request that was truncated. Use this parameter to continue a previous list request.
4699
+ * pageToken: 'placeholder-value',
4700
+ * // Identifies the project addressed by this request.
4701
+ * project: 'placeholder-value',
4702
+ * // User assigned name of the Response Policy to list.
4703
+ * responsePolicy: 'placeholder-value',
4704
+ * });
4705
+ * console.log(res.data);
4706
+ *
4707
+ * // Example response
4708
+ * // {
4709
+ * // "nextPageToken": "my_nextPageToken",
4710
+ * // "responsePolicyRules": []
4711
+ * // }
4712
+ * }
4713
+ *
4714
+ * main().catch(e => {
4715
+ * console.error(e);
4716
+ * throw e;
4717
+ * });
4718
+ *
4719
+ * ```
2272
4720
  *
2273
4721
  * @param params - Parameters for request
2274
4722
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2283,6 +4731,73 @@ export declare namespace dns_v1beta2 {
2283
4731
  list(callback: BodyResponseCallback<Schema$ResponsePolicyRulesListResponse>): void;
2284
4732
  /**
2285
4733
  * Applies a partial update to an existing Response Policy Rule.
4734
+ * @example
4735
+ * ```js
4736
+ * // Before running the sample:
4737
+ * // - Enable the API at:
4738
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4739
+ * // - Login into gcloud by running:
4740
+ * // ```sh
4741
+ * // $ gcloud auth application-default login
4742
+ * // ```
4743
+ * // - Install the npm module by running:
4744
+ * // ```sh
4745
+ * // $ npm install googleapis
4746
+ * // ```
4747
+ *
4748
+ * const {google} = require('googleapis');
4749
+ * const dns = google.dns('v1beta2');
4750
+ *
4751
+ * async function main() {
4752
+ * const auth = new google.auth.GoogleAuth({
4753
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4754
+ * scopes: [
4755
+ * 'https://www.googleapis.com/auth/cloud-platform',
4756
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4757
+ * ],
4758
+ * });
4759
+ *
4760
+ * // Acquire an auth client, and bind it to all future calls
4761
+ * const authClient = await auth.getClient();
4762
+ * google.options({auth: authClient});
4763
+ *
4764
+ * // Do the magic
4765
+ * const res = await dns.responsePolicyRules.patch({
4766
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4767
+ * clientOperationId: 'placeholder-value',
4768
+ * // Identifies the project addressed by this request.
4769
+ * project: 'placeholder-value',
4770
+ * // User assigned name of the Response Policy containing the Response Policy Rule.
4771
+ * responsePolicy: 'placeholder-value',
4772
+ * // User assigned name of the Response Policy Rule addressed by this request.
4773
+ * responsePolicyRule: 'placeholder-value',
4774
+ *
4775
+ * // Request body metadata
4776
+ * requestBody: {
4777
+ * // request body parameters
4778
+ * // {
4779
+ * // "behavior": "my_behavior",
4780
+ * // "dnsName": "my_dnsName",
4781
+ * // "kind": "my_kind",
4782
+ * // "localData": {},
4783
+ * // "ruleName": "my_ruleName"
4784
+ * // }
4785
+ * },
4786
+ * });
4787
+ * console.log(res.data);
4788
+ *
4789
+ * // Example response
4790
+ * // {
4791
+ * // "responsePolicyRule": {}
4792
+ * // }
4793
+ * }
4794
+ *
4795
+ * main().catch(e => {
4796
+ * console.error(e);
4797
+ * throw e;
4798
+ * });
4799
+ *
4800
+ * ```
2286
4801
  *
2287
4802
  * @param params - Parameters for request
2288
4803
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2297,6 +4812,73 @@ export declare namespace dns_v1beta2 {
2297
4812
  patch(callback: BodyResponseCallback<Schema$ResponsePolicyRulesPatchResponse>): void;
2298
4813
  /**
2299
4814
  * Updates an existing Response Policy Rule.
4815
+ * @example
4816
+ * ```js
4817
+ * // Before running the sample:
4818
+ * // - Enable the API at:
4819
+ * // https://console.developers.google.com/apis/api/dns.googleapis.com
4820
+ * // - Login into gcloud by running:
4821
+ * // ```sh
4822
+ * // $ gcloud auth application-default login
4823
+ * // ```
4824
+ * // - Install the npm module by running:
4825
+ * // ```sh
4826
+ * // $ npm install googleapis
4827
+ * // ```
4828
+ *
4829
+ * const {google} = require('googleapis');
4830
+ * const dns = google.dns('v1beta2');
4831
+ *
4832
+ * async function main() {
4833
+ * const auth = new google.auth.GoogleAuth({
4834
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4835
+ * scopes: [
4836
+ * 'https://www.googleapis.com/auth/cloud-platform',
4837
+ * 'https://www.googleapis.com/auth/ndev.clouddns.readwrite',
4838
+ * ],
4839
+ * });
4840
+ *
4841
+ * // Acquire an auth client, and bind it to all future calls
4842
+ * const authClient = await auth.getClient();
4843
+ * google.options({auth: authClient});
4844
+ *
4845
+ * // Do the magic
4846
+ * const res = await dns.responsePolicyRules.update({
4847
+ * // For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.
4848
+ * clientOperationId: 'placeholder-value',
4849
+ * // Identifies the project addressed by this request.
4850
+ * project: 'placeholder-value',
4851
+ * // User assigned name of the Response Policy containing the Response Policy Rule.
4852
+ * responsePolicy: 'placeholder-value',
4853
+ * // User assigned name of the Response Policy Rule addressed by this request.
4854
+ * responsePolicyRule: 'placeholder-value',
4855
+ *
4856
+ * // Request body metadata
4857
+ * requestBody: {
4858
+ * // request body parameters
4859
+ * // {
4860
+ * // "behavior": "my_behavior",
4861
+ * // "dnsName": "my_dnsName",
4862
+ * // "kind": "my_kind",
4863
+ * // "localData": {},
4864
+ * // "ruleName": "my_ruleName"
4865
+ * // }
4866
+ * },
4867
+ * });
4868
+ * console.log(res.data);
4869
+ *
4870
+ * // Example response
4871
+ * // {
4872
+ * // "responsePolicyRule": {}
4873
+ * // }
4874
+ * }
4875
+ *
4876
+ * main().catch(e => {
4877
+ * console.error(e);
4878
+ * throw e;
4879
+ * });
4880
+ *
4881
+ * ```
2300
4882
  *
2301
4883
  * @param params - Parameters for request
2302
4884
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.