@googleapis/vmmigration 13.0.1 → 14.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/v1.ts CHANGED
@@ -310,7 +310,7 @@ export namespace vmmigration_v1 {
310
310
  */
311
311
  committedStorageMb?: string | null;
312
312
  /**
313
- * The number of cpus the VM has.
313
+ * The number of CPU cores the VM has.
314
314
  */
315
315
  cpuCount?: number | null;
316
316
  /**
@@ -353,6 +353,10 @@ export namespace vmmigration_v1 {
353
353
  * The tags of the VM.
354
354
  */
355
355
  tags?: {[key: string]: string} | null;
356
+ /**
357
+ * The number of vCPUs the VM has. It is calculated as the number of CPU cores * threads per CPU the VM has.
358
+ */
359
+ vcpuCount?: number | null;
356
360
  /**
357
361
  * The virtualization type.
358
362
  */
@@ -714,6 +718,10 @@ export namespace vmmigration_v1 {
714
718
  * Compute instance scheduling information (if empty default is used).
715
719
  */
716
720
  computeScheduling?: Schema$ComputeScheduling;
721
+ /**
722
+ * Optional. Additional replica zones of the target regional disks. If this list is not empty a regional disk will be created. The first supported zone would be the one stated in the zone field. The rest are taken from this list. Please refer to the [regional disk creation API](https://cloud.google.com/compute/docs/regions-zones/global-regional-zonal-resources) for further details about regional vs zonal disks. If not specified, a zonal disk will be created in the same zone the VM is created.
723
+ */
724
+ diskReplicaZones?: string[] | null;
717
725
  /**
718
726
  * The disk type to use in the VM.
719
727
  */
@@ -807,6 +815,10 @@ export namespace vmmigration_v1 {
807
815
  * Compute instance scheduling information (if empty default is used).
808
816
  */
809
817
  computeScheduling?: Schema$ComputeScheduling;
818
+ /**
819
+ * Optional. Additional replica zones of the target regional disks. If this list is not empty a regional disk will be created. The first supported zone would be the one stated in the zone field. The rest are taken from this list. Please refer to the [regional disk creation API](https://cloud.google.com/compute/docs/regions-zones/global-regional-zonal-resources) for further details about regional vs zonal disks. If not specified, a zonal disk will be created in the same zone the VM is created.
820
+ */
821
+ diskReplicaZones?: string[] | null;
810
822
  /**
811
823
  * The disk type to use in the VM.
812
824
  */
@@ -1252,6 +1264,27 @@ export namespace vmmigration_v1 {
1252
1264
  */
1253
1265
  kmsKey?: string | null;
1254
1266
  }
1267
+ /**
1268
+ * Expiration holds information about the expiration of a MigratingVm.
1269
+ */
1270
+ export interface Schema$Expiration {
1271
+ /**
1272
+ * Output only. Timestamp of when this resource is considered expired.
1273
+ */
1274
+ expireTime?: string | null;
1275
+ /**
1276
+ * Output only. Describes whether the expiration can be extended.
1277
+ */
1278
+ extendable?: boolean | null;
1279
+ /**
1280
+ * Output only. The number of times expiration was extended.
1281
+ */
1282
+ extensionCount?: number | null;
1283
+ }
1284
+ /**
1285
+ * Request message for 'ExtendMigrationRequest' request.
1286
+ */
1287
+ export interface Schema$ExtendMigrationRequest {}
1255
1288
  /**
1256
1289
  * Response message for fetchInventory.
1257
1290
  */
@@ -1740,7 +1773,7 @@ export namespace vmmigration_v1 {
1740
1773
  */
1741
1774
  description?: string | null;
1742
1775
  /**
1743
- * Immutable. The encryption to apply to the machine image.
1776
+ * Immutable. The encryption to apply to the machine image. If the Image Import resource has an encryption, this field must be set to the same encryption key.
1744
1777
  */
1745
1778
  encryption?: Schema$Encryption;
1746
1779
  /**
@@ -1756,7 +1789,7 @@ export namespace vmmigration_v1 {
1756
1789
  */
1757
1790
  machineImageParametersOverrides?: Schema$MachineImageParametersOverrides;
1758
1791
  /**
1759
- * Optional. The network interfaces to create with the instance created by the machine image. Internal and external IP addresses are ignored for machine image import.
1792
+ * Optional. The network interfaces to create with the instance created by the machine image. Internal and external IP addresses, and network tiers are ignored for machine image import.
1760
1793
  */
1761
1794
  networkInterfaces?: Schema$NetworkInterface[];
1762
1795
  /**
@@ -1832,6 +1865,10 @@ export namespace vmmigration_v1 {
1832
1865
  * Output only. Provides details on the state of the Migrating VM in case of an error in replication.
1833
1866
  */
1834
1867
  error?: Schema$Status;
1868
+ /**
1869
+ * Output only. Provides details about the expiration state of the migrating VM.
1870
+ */
1871
+ expiration?: Schema$Expiration;
1835
1872
  /**
1836
1873
  * Output only. The group this migrating vm is included in, if any. The group is represented by the full path of the appropriate Group resource.
1837
1874
  */
@@ -2688,6 +2725,56 @@ export namespace vmmigration_v1 {
2688
2725
 
2689
2726
  /**
2690
2727
  * Gets information about a location.
2728
+ * @example
2729
+ * ```js
2730
+ * // Before running the sample:
2731
+ * // - Enable the API at:
2732
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
2733
+ * // - Login into gcloud by running:
2734
+ * // ```sh
2735
+ * // $ gcloud auth application-default login
2736
+ * // ```
2737
+ * // - Install the npm module by running:
2738
+ * // ```sh
2739
+ * // $ npm install googleapis
2740
+ * // ```
2741
+ *
2742
+ * const {google} = require('googleapis');
2743
+ * const vmmigration = google.vmmigration('v1');
2744
+ *
2745
+ * async function main() {
2746
+ * const auth = new google.auth.GoogleAuth({
2747
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2748
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2749
+ * });
2750
+ *
2751
+ * // Acquire an auth client, and bind it to all future calls
2752
+ * const authClient = await auth.getClient();
2753
+ * google.options({auth: authClient});
2754
+ *
2755
+ * // Do the magic
2756
+ * const res = await vmmigration.projects.locations.get({
2757
+ * // Resource name for the location.
2758
+ * name: 'projects/my-project/locations/my-location',
2759
+ * });
2760
+ * console.log(res.data);
2761
+ *
2762
+ * // Example response
2763
+ * // {
2764
+ * // "displayName": "my_displayName",
2765
+ * // "labels": {},
2766
+ * // "locationId": "my_locationId",
2767
+ * // "metadata": {},
2768
+ * // "name": "my_name"
2769
+ * // }
2770
+ * }
2771
+ *
2772
+ * main().catch(e => {
2773
+ * console.error(e);
2774
+ * throw e;
2775
+ * });
2776
+ *
2777
+ * ```
2691
2778
  *
2692
2779
  * @param params - Parameters for request
2693
2780
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2776,6 +2863,61 @@ export namespace vmmigration_v1 {
2776
2863
 
2777
2864
  /**
2778
2865
  * Lists information about the supported locations for this service.
2866
+ * @example
2867
+ * ```js
2868
+ * // Before running the sample:
2869
+ * // - Enable the API at:
2870
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
2871
+ * // - Login into gcloud by running:
2872
+ * // ```sh
2873
+ * // $ gcloud auth application-default login
2874
+ * // ```
2875
+ * // - Install the npm module by running:
2876
+ * // ```sh
2877
+ * // $ npm install googleapis
2878
+ * // ```
2879
+ *
2880
+ * const {google} = require('googleapis');
2881
+ * const vmmigration = google.vmmigration('v1');
2882
+ *
2883
+ * async function main() {
2884
+ * const auth = new google.auth.GoogleAuth({
2885
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2886
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2887
+ * });
2888
+ *
2889
+ * // Acquire an auth client, and bind it to all future calls
2890
+ * const authClient = await auth.getClient();
2891
+ * google.options({auth: authClient});
2892
+ *
2893
+ * // Do the magic
2894
+ * const res = await vmmigration.projects.locations.list({
2895
+ * // Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.
2896
+ * extraLocationTypes: 'placeholder-value',
2897
+ * // A filter to narrow down results to a preferred subset. The filtering language accepts strings like `"displayName=tokyo"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).
2898
+ * filter: 'placeholder-value',
2899
+ * // The resource that owns the locations collection, if applicable.
2900
+ * name: 'projects/my-project',
2901
+ * // The maximum number of results to return. If not set, the service selects a default.
2902
+ * pageSize: 'placeholder-value',
2903
+ * // A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.
2904
+ * pageToken: 'placeholder-value',
2905
+ * });
2906
+ * console.log(res.data);
2907
+ *
2908
+ * // Example response
2909
+ * // {
2910
+ * // "locations": [],
2911
+ * // "nextPageToken": "my_nextPageToken"
2912
+ * // }
2913
+ * }
2914
+ *
2915
+ * main().catch(e => {
2916
+ * console.error(e);
2917
+ * throw e;
2918
+ * });
2919
+ *
2920
+ * ```
2779
2921
  *
2780
2922
  * @param params - Parameters for request
2781
2923
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2907,6 +3049,64 @@ export namespace vmmigration_v1 {
2907
3049
 
2908
3050
  /**
2909
3051
  * Adds a MigratingVm to a Group.
3052
+ * @example
3053
+ * ```js
3054
+ * // Before running the sample:
3055
+ * // - Enable the API at:
3056
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3057
+ * // - Login into gcloud by running:
3058
+ * // ```sh
3059
+ * // $ gcloud auth application-default login
3060
+ * // ```
3061
+ * // - Install the npm module by running:
3062
+ * // ```sh
3063
+ * // $ npm install googleapis
3064
+ * // ```
3065
+ *
3066
+ * const {google} = require('googleapis');
3067
+ * const vmmigration = google.vmmigration('v1');
3068
+ *
3069
+ * async function main() {
3070
+ * const auth = new google.auth.GoogleAuth({
3071
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3072
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3073
+ * });
3074
+ *
3075
+ * // Acquire an auth client, and bind it to all future calls
3076
+ * const authClient = await auth.getClient();
3077
+ * google.options({auth: authClient});
3078
+ *
3079
+ * // Do the magic
3080
+ * const res = await vmmigration.projects.locations.groups.addGroupMigration({
3081
+ * // Required. The full path name of the Group to add to.
3082
+ * group: 'projects/my-project/locations/my-location/groups/my-group',
3083
+ *
3084
+ * // Request body metadata
3085
+ * requestBody: {
3086
+ * // request body parameters
3087
+ * // {
3088
+ * // "migratingVm": "my_migratingVm"
3089
+ * // }
3090
+ * },
3091
+ * });
3092
+ * console.log(res.data);
3093
+ *
3094
+ * // Example response
3095
+ * // {
3096
+ * // "done": false,
3097
+ * // "error": {},
3098
+ * // "metadata": {},
3099
+ * // "name": "my_name",
3100
+ * // "response": {}
3101
+ * // }
3102
+ * }
3103
+ *
3104
+ * main().catch(e => {
3105
+ * console.error(e);
3106
+ * throw e;
3107
+ * });
3108
+ *
3109
+ * ```
2910
3110
  *
2911
3111
  * @param params - Parameters for request
2912
3112
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2999,6 +3199,73 @@ export namespace vmmigration_v1 {
2999
3199
 
3000
3200
  /**
3001
3201
  * Creates a new Group in a given project and location.
3202
+ * @example
3203
+ * ```js
3204
+ * // Before running the sample:
3205
+ * // - Enable the API at:
3206
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3207
+ * // - Login into gcloud by running:
3208
+ * // ```sh
3209
+ * // $ gcloud auth application-default login
3210
+ * // ```
3211
+ * // - Install the npm module by running:
3212
+ * // ```sh
3213
+ * // $ npm install googleapis
3214
+ * // ```
3215
+ *
3216
+ * const {google} = require('googleapis');
3217
+ * const vmmigration = google.vmmigration('v1');
3218
+ *
3219
+ * async function main() {
3220
+ * const auth = new google.auth.GoogleAuth({
3221
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3222
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3223
+ * });
3224
+ *
3225
+ * // Acquire an auth client, and bind it to all future calls
3226
+ * const authClient = await auth.getClient();
3227
+ * google.options({auth: authClient});
3228
+ *
3229
+ * // Do the magic
3230
+ * const res = await vmmigration.projects.locations.groups.create({
3231
+ * // Required. The group identifier.
3232
+ * groupId: 'placeholder-value',
3233
+ * // Required. The Group's parent.
3234
+ * parent: 'projects/my-project/locations/my-location',
3235
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
3236
+ * requestId: 'placeholder-value',
3237
+ *
3238
+ * // Request body metadata
3239
+ * requestBody: {
3240
+ * // request body parameters
3241
+ * // {
3242
+ * // "createTime": "my_createTime",
3243
+ * // "description": "my_description",
3244
+ * // "displayName": "my_displayName",
3245
+ * // "migrationTargetType": "my_migrationTargetType",
3246
+ * // "name": "my_name",
3247
+ * // "updateTime": "my_updateTime"
3248
+ * // }
3249
+ * },
3250
+ * });
3251
+ * console.log(res.data);
3252
+ *
3253
+ * // Example response
3254
+ * // {
3255
+ * // "done": false,
3256
+ * // "error": {},
3257
+ * // "metadata": {},
3258
+ * // "name": "my_name",
3259
+ * // "response": {}
3260
+ * // }
3261
+ * }
3262
+ *
3263
+ * main().catch(e => {
3264
+ * console.error(e);
3265
+ * throw e;
3266
+ * });
3267
+ *
3268
+ * ```
3002
3269
  *
3003
3270
  * @param params - Parameters for request
3004
3271
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3090,6 +3357,58 @@ export namespace vmmigration_v1 {
3090
3357
 
3091
3358
  /**
3092
3359
  * Deletes a single Group.
3360
+ * @example
3361
+ * ```js
3362
+ * // Before running the sample:
3363
+ * // - Enable the API at:
3364
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3365
+ * // - Login into gcloud by running:
3366
+ * // ```sh
3367
+ * // $ gcloud auth application-default login
3368
+ * // ```
3369
+ * // - Install the npm module by running:
3370
+ * // ```sh
3371
+ * // $ npm install googleapis
3372
+ * // ```
3373
+ *
3374
+ * const {google} = require('googleapis');
3375
+ * const vmmigration = google.vmmigration('v1');
3376
+ *
3377
+ * async function main() {
3378
+ * const auth = new google.auth.GoogleAuth({
3379
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3380
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3381
+ * });
3382
+ *
3383
+ * // Acquire an auth client, and bind it to all future calls
3384
+ * const authClient = await auth.getClient();
3385
+ * google.options({auth: authClient});
3386
+ *
3387
+ * // Do the magic
3388
+ * const res = await vmmigration.projects.locations.groups.delete({
3389
+ * // Required. The Group name.
3390
+ * name: 'projects/my-project/locations/my-location/groups/my-group',
3391
+ * // Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
3392
+ * requestId: 'placeholder-value',
3393
+ * });
3394
+ * console.log(res.data);
3395
+ *
3396
+ * // Example response
3397
+ * // {
3398
+ * // "done": false,
3399
+ * // "error": {},
3400
+ * // "metadata": {},
3401
+ * // "name": "my_name",
3402
+ * // "response": {}
3403
+ * // }
3404
+ * }
3405
+ *
3406
+ * main().catch(e => {
3407
+ * console.error(e);
3408
+ * throw e;
3409
+ * });
3410
+ *
3411
+ * ```
3093
3412
  *
3094
3413
  * @param params - Parameters for request
3095
3414
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3178,6 +3497,57 @@ export namespace vmmigration_v1 {
3178
3497
 
3179
3498
  /**
3180
3499
  * Gets details of a single Group.
3500
+ * @example
3501
+ * ```js
3502
+ * // Before running the sample:
3503
+ * // - Enable the API at:
3504
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3505
+ * // - Login into gcloud by running:
3506
+ * // ```sh
3507
+ * // $ gcloud auth application-default login
3508
+ * // ```
3509
+ * // - Install the npm module by running:
3510
+ * // ```sh
3511
+ * // $ npm install googleapis
3512
+ * // ```
3513
+ *
3514
+ * const {google} = require('googleapis');
3515
+ * const vmmigration = google.vmmigration('v1');
3516
+ *
3517
+ * async function main() {
3518
+ * const auth = new google.auth.GoogleAuth({
3519
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3520
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3521
+ * });
3522
+ *
3523
+ * // Acquire an auth client, and bind it to all future calls
3524
+ * const authClient = await auth.getClient();
3525
+ * google.options({auth: authClient});
3526
+ *
3527
+ * // Do the magic
3528
+ * const res = await vmmigration.projects.locations.groups.get({
3529
+ * // Required. The group name.
3530
+ * name: 'projects/my-project/locations/my-location/groups/my-group',
3531
+ * });
3532
+ * console.log(res.data);
3533
+ *
3534
+ * // Example response
3535
+ * // {
3536
+ * // "createTime": "my_createTime",
3537
+ * // "description": "my_description",
3538
+ * // "displayName": "my_displayName",
3539
+ * // "migrationTargetType": "my_migrationTargetType",
3540
+ * // "name": "my_name",
3541
+ * // "updateTime": "my_updateTime"
3542
+ * // }
3543
+ * }
3544
+ *
3545
+ * main().catch(e => {
3546
+ * console.error(e);
3547
+ * throw e;
3548
+ * });
3549
+ *
3550
+ * ```
3181
3551
  *
3182
3552
  * @param params - Parameters for request
3183
3553
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3266,6 +3636,62 @@ export namespace vmmigration_v1 {
3266
3636
 
3267
3637
  /**
3268
3638
  * Lists Groups in a given project and location.
3639
+ * @example
3640
+ * ```js
3641
+ * // Before running the sample:
3642
+ * // - Enable the API at:
3643
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3644
+ * // - Login into gcloud by running:
3645
+ * // ```sh
3646
+ * // $ gcloud auth application-default login
3647
+ * // ```
3648
+ * // - Install the npm module by running:
3649
+ * // ```sh
3650
+ * // $ npm install googleapis
3651
+ * // ```
3652
+ *
3653
+ * const {google} = require('googleapis');
3654
+ * const vmmigration = google.vmmigration('v1');
3655
+ *
3656
+ * async function main() {
3657
+ * const auth = new google.auth.GoogleAuth({
3658
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3659
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3660
+ * });
3661
+ *
3662
+ * // Acquire an auth client, and bind it to all future calls
3663
+ * const authClient = await auth.getClient();
3664
+ * google.options({auth: authClient});
3665
+ *
3666
+ * // Do the magic
3667
+ * const res = await vmmigration.projects.locations.groups.list({
3668
+ * // Optional. The filter request.
3669
+ * filter: 'placeholder-value',
3670
+ * // Optional. the order by fields for the result.
3671
+ * orderBy: 'placeholder-value',
3672
+ * // Optional. The maximum number of groups to return. The service may return fewer than this value. If unspecified, at most 500 groups will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
3673
+ * pageSize: 'placeholder-value',
3674
+ * // Required. A page token, received from a previous `ListGroups` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListGroups` must match the call that provided the page token.
3675
+ * pageToken: 'placeholder-value',
3676
+ * // Required. The parent, which owns this collection of groups.
3677
+ * parent: 'projects/my-project/locations/my-location',
3678
+ * });
3679
+ * console.log(res.data);
3680
+ *
3681
+ * // Example response
3682
+ * // {
3683
+ * // "groups": [],
3684
+ * // "nextPageToken": "my_nextPageToken",
3685
+ * // "unreachable": []
3686
+ * // }
3687
+ * }
3688
+ *
3689
+ * main().catch(e => {
3690
+ * console.error(e);
3691
+ * throw e;
3692
+ * });
3693
+ *
3694
+ * ```
3269
3695
  *
3270
3696
  * @param params - Parameters for request
3271
3697
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3357,6 +3783,73 @@ export namespace vmmigration_v1 {
3357
3783
 
3358
3784
  /**
3359
3785
  * Updates the parameters of a single Group.
3786
+ * @example
3787
+ * ```js
3788
+ * // Before running the sample:
3789
+ * // - Enable the API at:
3790
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3791
+ * // - Login into gcloud by running:
3792
+ * // ```sh
3793
+ * // $ gcloud auth application-default login
3794
+ * // ```
3795
+ * // - Install the npm module by running:
3796
+ * // ```sh
3797
+ * // $ npm install googleapis
3798
+ * // ```
3799
+ *
3800
+ * const {google} = require('googleapis');
3801
+ * const vmmigration = google.vmmigration('v1');
3802
+ *
3803
+ * async function main() {
3804
+ * const auth = new google.auth.GoogleAuth({
3805
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3806
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3807
+ * });
3808
+ *
3809
+ * // Acquire an auth client, and bind it to all future calls
3810
+ * const authClient = await auth.getClient();
3811
+ * google.options({auth: authClient});
3812
+ *
3813
+ * // Do the magic
3814
+ * const res = await vmmigration.projects.locations.groups.patch({
3815
+ * // Output only. The Group name.
3816
+ * name: 'projects/my-project/locations/my-location/groups/my-group',
3817
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
3818
+ * requestId: 'placeholder-value',
3819
+ * // Field mask is used to specify the fields to be overwritten in the Group resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
3820
+ * updateMask: 'placeholder-value',
3821
+ *
3822
+ * // Request body metadata
3823
+ * requestBody: {
3824
+ * // request body parameters
3825
+ * // {
3826
+ * // "createTime": "my_createTime",
3827
+ * // "description": "my_description",
3828
+ * // "displayName": "my_displayName",
3829
+ * // "migrationTargetType": "my_migrationTargetType",
3830
+ * // "name": "my_name",
3831
+ * // "updateTime": "my_updateTime"
3832
+ * // }
3833
+ * },
3834
+ * });
3835
+ * console.log(res.data);
3836
+ *
3837
+ * // Example response
3838
+ * // {
3839
+ * // "done": false,
3840
+ * // "error": {},
3841
+ * // "metadata": {},
3842
+ * // "name": "my_name",
3843
+ * // "response": {}
3844
+ * // }
3845
+ * }
3846
+ *
3847
+ * main().catch(e => {
3848
+ * console.error(e);
3849
+ * throw e;
3850
+ * });
3851
+ *
3852
+ * ```
3360
3853
  *
3361
3854
  * @param params - Parameters for request
3362
3855
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3445,6 +3938,64 @@ export namespace vmmigration_v1 {
3445
3938
 
3446
3939
  /**
3447
3940
  * Removes a MigratingVm from a Group.
3941
+ * @example
3942
+ * ```js
3943
+ * // Before running the sample:
3944
+ * // - Enable the API at:
3945
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3946
+ * // - Login into gcloud by running:
3947
+ * // ```sh
3948
+ * // $ gcloud auth application-default login
3949
+ * // ```
3950
+ * // - Install the npm module by running:
3951
+ * // ```sh
3952
+ * // $ npm install googleapis
3953
+ * // ```
3954
+ *
3955
+ * const {google} = require('googleapis');
3956
+ * const vmmigration = google.vmmigration('v1');
3957
+ *
3958
+ * async function main() {
3959
+ * const auth = new google.auth.GoogleAuth({
3960
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3961
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3962
+ * });
3963
+ *
3964
+ * // Acquire an auth client, and bind it to all future calls
3965
+ * const authClient = await auth.getClient();
3966
+ * google.options({auth: authClient});
3967
+ *
3968
+ * // Do the magic
3969
+ * const res = await vmmigration.projects.locations.groups.removeGroupMigration({
3970
+ * // Required. The name of the Group.
3971
+ * group: 'projects/my-project/locations/my-location/groups/my-group',
3972
+ *
3973
+ * // Request body metadata
3974
+ * requestBody: {
3975
+ * // request body parameters
3976
+ * // {
3977
+ * // "migratingVm": "my_migratingVm"
3978
+ * // }
3979
+ * },
3980
+ * });
3981
+ * console.log(res.data);
3982
+ *
3983
+ * // Example response
3984
+ * // {
3985
+ * // "done": false,
3986
+ * // "error": {},
3987
+ * // "metadata": {},
3988
+ * // "name": "my_name",
3989
+ * // "response": {}
3990
+ * // }
3991
+ * }
3992
+ *
3993
+ * main().catch(e => {
3994
+ * console.error(e);
3995
+ * throw e;
3996
+ * });
3997
+ *
3998
+ * ```
3448
3999
  *
3449
4000
  * @param params - Parameters for request
3450
4001
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3657,6 +4208,74 @@ export namespace vmmigration_v1 {
3657
4208
 
3658
4209
  /**
3659
4210
  * Creates a new ImageImport in a given project.
4211
+ * @example
4212
+ * ```js
4213
+ * // Before running the sample:
4214
+ * // - Enable the API at:
4215
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4216
+ * // - Login into gcloud by running:
4217
+ * // ```sh
4218
+ * // $ gcloud auth application-default login
4219
+ * // ```
4220
+ * // - Install the npm module by running:
4221
+ * // ```sh
4222
+ * // $ npm install googleapis
4223
+ * // ```
4224
+ *
4225
+ * const {google} = require('googleapis');
4226
+ * const vmmigration = google.vmmigration('v1');
4227
+ *
4228
+ * async function main() {
4229
+ * const auth = new google.auth.GoogleAuth({
4230
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4231
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4232
+ * });
4233
+ *
4234
+ * // Acquire an auth client, and bind it to all future calls
4235
+ * const authClient = await auth.getClient();
4236
+ * google.options({auth: authClient});
4237
+ *
4238
+ * // Do the magic
4239
+ * const res = await vmmigration.projects.locations.imageImports.create({
4240
+ * // Required. The image import identifier. This value maximum length is 63 characters, and valid characters are /a-z-/. It must start with an english letter and must not end with a hyphen.
4241
+ * imageImportId: 'placeholder-value',
4242
+ * // Required. The ImageImport's parent.
4243
+ * parent: 'projects/my-project/locations/my-location',
4244
+ * // Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
4245
+ * requestId: 'placeholder-value',
4246
+ *
4247
+ * // Request body metadata
4248
+ * requestBody: {
4249
+ * // request body parameters
4250
+ * // {
4251
+ * // "cloudStorageUri": "my_cloudStorageUri",
4252
+ * // "createTime": "my_createTime",
4253
+ * // "diskImageTargetDefaults": {},
4254
+ * // "encryption": {},
4255
+ * // "machineImageTargetDefaults": {},
4256
+ * // "name": "my_name",
4257
+ * // "recentImageImportJobs": []
4258
+ * // }
4259
+ * },
4260
+ * });
4261
+ * console.log(res.data);
4262
+ *
4263
+ * // Example response
4264
+ * // {
4265
+ * // "done": false,
4266
+ * // "error": {},
4267
+ * // "metadata": {},
4268
+ * // "name": "my_name",
4269
+ * // "response": {}
4270
+ * // }
4271
+ * }
4272
+ *
4273
+ * main().catch(e => {
4274
+ * console.error(e);
4275
+ * throw e;
4276
+ * });
4277
+ *
4278
+ * ```
3660
4279
  *
3661
4280
  * @param params - Parameters for request
3662
4281
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3748,6 +4367,58 @@ export namespace vmmigration_v1 {
3748
4367
 
3749
4368
  /**
3750
4369
  * Deletes a single ImageImport.
4370
+ * @example
4371
+ * ```js
4372
+ * // Before running the sample:
4373
+ * // - Enable the API at:
4374
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4375
+ * // - Login into gcloud by running:
4376
+ * // ```sh
4377
+ * // $ gcloud auth application-default login
4378
+ * // ```
4379
+ * // - Install the npm module by running:
4380
+ * // ```sh
4381
+ * // $ npm install googleapis
4382
+ * // ```
4383
+ *
4384
+ * const {google} = require('googleapis');
4385
+ * const vmmigration = google.vmmigration('v1');
4386
+ *
4387
+ * async function main() {
4388
+ * const auth = new google.auth.GoogleAuth({
4389
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4390
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4391
+ * });
4392
+ *
4393
+ * // Acquire an auth client, and bind it to all future calls
4394
+ * const authClient = await auth.getClient();
4395
+ * google.options({auth: authClient});
4396
+ *
4397
+ * // Do the magic
4398
+ * const res = await vmmigration.projects.locations.imageImports.delete({
4399
+ * // Required. The ImageImport name.
4400
+ * name: 'projects/my-project/locations/my-location/imageImports/my-imageImport',
4401
+ * // Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
4402
+ * requestId: 'placeholder-value',
4403
+ * });
4404
+ * console.log(res.data);
4405
+ *
4406
+ * // Example response
4407
+ * // {
4408
+ * // "done": false,
4409
+ * // "error": {},
4410
+ * // "metadata": {},
4411
+ * // "name": "my_name",
4412
+ * // "response": {}
4413
+ * // }
4414
+ * }
4415
+ *
4416
+ * main().catch(e => {
4417
+ * console.error(e);
4418
+ * throw e;
4419
+ * });
4420
+ *
4421
+ * ```
3751
4422
  *
3752
4423
  * @param params - Parameters for request
3753
4424
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3836,6 +4507,58 @@ export namespace vmmigration_v1 {
3836
4507
 
3837
4508
  /**
3838
4509
  * Gets details of a single ImageImport.
4510
+ * @example
4511
+ * ```js
4512
+ * // Before running the sample:
4513
+ * // - Enable the API at:
4514
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4515
+ * // - Login into gcloud by running:
4516
+ * // ```sh
4517
+ * // $ gcloud auth application-default login
4518
+ * // ```
4519
+ * // - Install the npm module by running:
4520
+ * // ```sh
4521
+ * // $ npm install googleapis
4522
+ * // ```
4523
+ *
4524
+ * const {google} = require('googleapis');
4525
+ * const vmmigration = google.vmmigration('v1');
4526
+ *
4527
+ * async function main() {
4528
+ * const auth = new google.auth.GoogleAuth({
4529
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4530
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4531
+ * });
4532
+ *
4533
+ * // Acquire an auth client, and bind it to all future calls
4534
+ * const authClient = await auth.getClient();
4535
+ * google.options({auth: authClient});
4536
+ *
4537
+ * // Do the magic
4538
+ * const res = await vmmigration.projects.locations.imageImports.get({
4539
+ * // Required. The ImageImport name.
4540
+ * name: 'projects/my-project/locations/my-location/imageImports/my-imageImport',
4541
+ * });
4542
+ * console.log(res.data);
4543
+ *
4544
+ * // Example response
4545
+ * // {
4546
+ * // "cloudStorageUri": "my_cloudStorageUri",
4547
+ * // "createTime": "my_createTime",
4548
+ * // "diskImageTargetDefaults": {},
4549
+ * // "encryption": {},
4550
+ * // "machineImageTargetDefaults": {},
4551
+ * // "name": "my_name",
4552
+ * // "recentImageImportJobs": []
4553
+ * // }
4554
+ * }
4555
+ *
4556
+ * main().catch(e => {
4557
+ * console.error(e);
4558
+ * throw e;
4559
+ * });
4560
+ *
4561
+ * ```
3839
4562
  *
3840
4563
  * @param params - Parameters for request
3841
4564
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3924,6 +4647,62 @@ export namespace vmmigration_v1 {
3924
4647
 
3925
4648
  /**
3926
4649
  * Lists ImageImports in a given project.
4650
+ * @example
4651
+ * ```js
4652
+ * // Before running the sample:
4653
+ * // - Enable the API at:
4654
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4655
+ * // - Login into gcloud by running:
4656
+ * // ```sh
4657
+ * // $ gcloud auth application-default login
4658
+ * // ```
4659
+ * // - Install the npm module by running:
4660
+ * // ```sh
4661
+ * // $ npm install googleapis
4662
+ * // ```
4663
+ *
4664
+ * const {google} = require('googleapis');
4665
+ * const vmmigration = google.vmmigration('v1');
4666
+ *
4667
+ * async function main() {
4668
+ * const auth = new google.auth.GoogleAuth({
4669
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4670
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4671
+ * });
4672
+ *
4673
+ * // Acquire an auth client, and bind it to all future calls
4674
+ * const authClient = await auth.getClient();
4675
+ * google.options({auth: authClient});
4676
+ *
4677
+ * // Do the magic
4678
+ * const res = await vmmigration.projects.locations.imageImports.list({
4679
+ * // Optional. The filter request (according to AIP-160).
4680
+ * filter: 'placeholder-value',
4681
+ * // Optional. The order by fields for the result (according to AIP-132). Currently ordering is only possible by "name" field.
4682
+ * orderBy: 'placeholder-value',
4683
+ * // Optional. The maximum number of targets to return. The service may return fewer than this value. If unspecified, at most 500 targets will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
4684
+ * pageSize: 'placeholder-value',
4685
+ * // Optional. A page token, received from a previous `ListImageImports` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListImageImports` must match the call that provided the page token.
4686
+ * pageToken: 'placeholder-value',
4687
+ * // Required. The parent, which owns this collection of targets.
4688
+ * parent: 'projects/my-project/locations/my-location',
4689
+ * });
4690
+ * console.log(res.data);
4691
+ *
4692
+ * // Example response
4693
+ * // {
4694
+ * // "imageImports": [],
4695
+ * // "nextPageToken": "my_nextPageToken",
4696
+ * // "unreachable": []
4697
+ * // }
4698
+ * }
4699
+ *
4700
+ * main().catch(e => {
4701
+ * console.error(e);
4702
+ * throw e;
4703
+ * });
4704
+ *
4705
+ * ```
3927
4706
  *
3928
4707
  * @param params - Parameters for request
3929
4708
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4086,6 +4865,63 @@ export namespace vmmigration_v1 {
4086
4865
 
4087
4866
  /**
4088
4867
  * Initiates the cancellation of a running clone job.
4868
+ * @example
4869
+ * ```js
4870
+ * // Before running the sample:
4871
+ * // - Enable the API at:
4872
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4873
+ * // - Login into gcloud by running:
4874
+ * // ```sh
4875
+ * // $ gcloud auth application-default login
4876
+ * // ```
4877
+ * // - Install the npm module by running:
4878
+ * // ```sh
4879
+ * // $ npm install googleapis
4880
+ * // ```
4881
+ *
4882
+ * const {google} = require('googleapis');
4883
+ * const vmmigration = google.vmmigration('v1');
4884
+ *
4885
+ * async function main() {
4886
+ * const auth = new google.auth.GoogleAuth({
4887
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4888
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4889
+ * });
4890
+ *
4891
+ * // Acquire an auth client, and bind it to all future calls
4892
+ * const authClient = await auth.getClient();
4893
+ * google.options({auth: authClient});
4894
+ *
4895
+ * // Do the magic
4896
+ * const res =
4897
+ * await vmmigration.projects.locations.imageImports.imageImportJobs.cancel({
4898
+ * // Required. The image import job id.
4899
+ * name: 'projects/my-project/locations/my-location/imageImports/my-imageImport/imageImportJobs/my-imageImportJob',
4900
+ *
4901
+ * // Request body metadata
4902
+ * requestBody: {
4903
+ * // request body parameters
4904
+ * // {}
4905
+ * },
4906
+ * });
4907
+ * console.log(res.data);
4908
+ *
4909
+ * // Example response
4910
+ * // {
4911
+ * // "done": false,
4912
+ * // "error": {},
4913
+ * // "metadata": {},
4914
+ * // "name": "my_name",
4915
+ * // "response": {}
4916
+ * // }
4917
+ * }
4918
+ *
4919
+ * main().catch(e => {
4920
+ * console.error(e);
4921
+ * throw e;
4922
+ * });
4923
+ *
4924
+ * ```
4089
4925
  *
4090
4926
  * @param params - Parameters for request
4091
4927
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4175,6 +5011,63 @@ export namespace vmmigration_v1 {
4175
5011
 
4176
5012
  /**
4177
5013
  * Gets details of a single ImageImportJob.
5014
+ * @example
5015
+ * ```js
5016
+ * // Before running the sample:
5017
+ * // - Enable the API at:
5018
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5019
+ * // - Login into gcloud by running:
5020
+ * // ```sh
5021
+ * // $ gcloud auth application-default login
5022
+ * // ```
5023
+ * // - Install the npm module by running:
5024
+ * // ```sh
5025
+ * // $ npm install googleapis
5026
+ * // ```
5027
+ *
5028
+ * const {google} = require('googleapis');
5029
+ * const vmmigration = google.vmmigration('v1');
5030
+ *
5031
+ * async function main() {
5032
+ * const auth = new google.auth.GoogleAuth({
5033
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5034
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5035
+ * });
5036
+ *
5037
+ * // Acquire an auth client, and bind it to all future calls
5038
+ * const authClient = await auth.getClient();
5039
+ * google.options({auth: authClient});
5040
+ *
5041
+ * // Do the magic
5042
+ * const res =
5043
+ * await vmmigration.projects.locations.imageImports.imageImportJobs.get({
5044
+ * // Required. The ImageImportJob name.
5045
+ * name: 'projects/my-project/locations/my-location/imageImports/my-imageImport/imageImportJobs/my-imageImportJob',
5046
+ * });
5047
+ * console.log(res.data);
5048
+ *
5049
+ * // Example response
5050
+ * // {
5051
+ * // "cloudStorageUri": "my_cloudStorageUri",
5052
+ * // "createTime": "my_createTime",
5053
+ * // "createdResources": [],
5054
+ * // "diskImageTargetDetails": {},
5055
+ * // "endTime": "my_endTime",
5056
+ * // "errors": [],
5057
+ * // "machineImageTargetDetails": {},
5058
+ * // "name": "my_name",
5059
+ * // "state": "my_state",
5060
+ * // "steps": [],
5061
+ * // "warnings": []
5062
+ * // }
5063
+ * }
5064
+ *
5065
+ * main().catch(e => {
5066
+ * console.error(e);
5067
+ * throw e;
5068
+ * });
5069
+ *
5070
+ * ```
4178
5071
  *
4179
5072
  * @param params - Parameters for request
4180
5073
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4264,6 +5157,64 @@ export namespace vmmigration_v1 {
4264
5157
 
4265
5158
  /**
4266
5159
  * Lists ImageImportJobs in a given project.
5160
+ * @example
5161
+ * ```js
5162
+ * // Before running the sample:
5163
+ * // - Enable the API at:
5164
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5165
+ * // - Login into gcloud by running:
5166
+ * // ```sh
5167
+ * // $ gcloud auth application-default login
5168
+ * // ```
5169
+ * // - Install the npm module by running:
5170
+ * // ```sh
5171
+ * // $ npm install googleapis
5172
+ * // ```
5173
+ *
5174
+ * const {google} = require('googleapis');
5175
+ * const vmmigration = google.vmmigration('v1');
5176
+ *
5177
+ * async function main() {
5178
+ * const auth = new google.auth.GoogleAuth({
5179
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5180
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5181
+ * });
5182
+ *
5183
+ * // Acquire an auth client, and bind it to all future calls
5184
+ * const authClient = await auth.getClient();
5185
+ * google.options({auth: authClient});
5186
+ *
5187
+ * // Do the magic
5188
+ * const res =
5189
+ * await vmmigration.projects.locations.imageImports.imageImportJobs.list({
5190
+ * // Optional. The filter request (according to AIP-160).
5191
+ * filter: 'placeholder-value',
5192
+ * // Optional. The order by fields for the result (according to AIP-132). Currently ordering is only possible by "name" field.
5193
+ * orderBy: 'placeholder-value',
5194
+ * // Optional. The maximum number of targets to return. The service may return fewer than this value. If unspecified, at most 500 targets will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
5195
+ * pageSize: 'placeholder-value',
5196
+ * // Optional. A page token, received from a previous `ListImageImportJobs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListImageImportJobs` must match the call that provided the page token.
5197
+ * pageToken: 'placeholder-value',
5198
+ * // Required. The parent, which owns this collection of targets.
5199
+ * parent:
5200
+ * 'projects/my-project/locations/my-location/imageImports/my-imageImport',
5201
+ * });
5202
+ * console.log(res.data);
5203
+ *
5204
+ * // Example response
5205
+ * // {
5206
+ * // "imageImportJobs": [],
5207
+ * // "nextPageToken": "my_nextPageToken",
5208
+ * // "unreachable": []
5209
+ * // }
5210
+ * }
5211
+ *
5212
+ * main().catch(e => {
5213
+ * console.error(e);
5214
+ * throw e;
5215
+ * });
5216
+ *
5217
+ * ```
4267
5218
  *
4268
5219
  * @param params - Parameters for request
4269
5220
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4410,6 +5361,56 @@ export namespace vmmigration_v1 {
4410
5361
 
4411
5362
  /**
4412
5363
  * Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
5364
+ * @example
5365
+ * ```js
5366
+ * // Before running the sample:
5367
+ * // - Enable the API at:
5368
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5369
+ * // - Login into gcloud by running:
5370
+ * // ```sh
5371
+ * // $ gcloud auth application-default login
5372
+ * // ```
5373
+ * // - Install the npm module by running:
5374
+ * // ```sh
5375
+ * // $ npm install googleapis
5376
+ * // ```
5377
+ *
5378
+ * const {google} = require('googleapis');
5379
+ * const vmmigration = google.vmmigration('v1');
5380
+ *
5381
+ * async function main() {
5382
+ * const auth = new google.auth.GoogleAuth({
5383
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5384
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5385
+ * });
5386
+ *
5387
+ * // Acquire an auth client, and bind it to all future calls
5388
+ * const authClient = await auth.getClient();
5389
+ * google.options({auth: authClient});
5390
+ *
5391
+ * // Do the magic
5392
+ * const res = await vmmigration.projects.locations.operations.cancel({
5393
+ * // The name of the operation resource to be cancelled.
5394
+ * name: 'projects/my-project/locations/my-location/operations/my-operation',
5395
+ *
5396
+ * // Request body metadata
5397
+ * requestBody: {
5398
+ * // request body parameters
5399
+ * // {}
5400
+ * },
5401
+ * });
5402
+ * console.log(res.data);
5403
+ *
5404
+ * // Example response
5405
+ * // {}
5406
+ * }
5407
+ *
5408
+ * main().catch(e => {
5409
+ * console.error(e);
5410
+ * throw e;
5411
+ * });
5412
+ *
5413
+ * ```
4413
5414
  *
4414
5415
  * @param params - Parameters for request
4415
5416
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4498,6 +5499,50 @@ export namespace vmmigration_v1 {
4498
5499
 
4499
5500
  /**
4500
5501
  * Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
5502
+ * @example
5503
+ * ```js
5504
+ * // Before running the sample:
5505
+ * // - Enable the API at:
5506
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5507
+ * // - Login into gcloud by running:
5508
+ * // ```sh
5509
+ * // $ gcloud auth application-default login
5510
+ * // ```
5511
+ * // - Install the npm module by running:
5512
+ * // ```sh
5513
+ * // $ npm install googleapis
5514
+ * // ```
5515
+ *
5516
+ * const {google} = require('googleapis');
5517
+ * const vmmigration = google.vmmigration('v1');
5518
+ *
5519
+ * async function main() {
5520
+ * const auth = new google.auth.GoogleAuth({
5521
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5522
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5523
+ * });
5524
+ *
5525
+ * // Acquire an auth client, and bind it to all future calls
5526
+ * const authClient = await auth.getClient();
5527
+ * google.options({auth: authClient});
5528
+ *
5529
+ * // Do the magic
5530
+ * const res = await vmmigration.projects.locations.operations.delete({
5531
+ * // The name of the operation resource to be deleted.
5532
+ * name: 'projects/my-project/locations/my-location/operations/my-operation',
5533
+ * });
5534
+ * console.log(res.data);
5535
+ *
5536
+ * // Example response
5537
+ * // {}
5538
+ * }
5539
+ *
5540
+ * main().catch(e => {
5541
+ * console.error(e);
5542
+ * throw e;
5543
+ * });
5544
+ *
5545
+ * ```
4501
5546
  *
4502
5547
  * @param params - Parameters for request
4503
5548
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4586,6 +5631,56 @@ export namespace vmmigration_v1 {
4586
5631
 
4587
5632
  /**
4588
5633
  * Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
5634
+ * @example
5635
+ * ```js
5636
+ * // Before running the sample:
5637
+ * // - Enable the API at:
5638
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5639
+ * // - Login into gcloud by running:
5640
+ * // ```sh
5641
+ * // $ gcloud auth application-default login
5642
+ * // ```
5643
+ * // - Install the npm module by running:
5644
+ * // ```sh
5645
+ * // $ npm install googleapis
5646
+ * // ```
5647
+ *
5648
+ * const {google} = require('googleapis');
5649
+ * const vmmigration = google.vmmigration('v1');
5650
+ *
5651
+ * async function main() {
5652
+ * const auth = new google.auth.GoogleAuth({
5653
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5654
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5655
+ * });
5656
+ *
5657
+ * // Acquire an auth client, and bind it to all future calls
5658
+ * const authClient = await auth.getClient();
5659
+ * google.options({auth: authClient});
5660
+ *
5661
+ * // Do the magic
5662
+ * const res = await vmmigration.projects.locations.operations.get({
5663
+ * // The name of the operation resource.
5664
+ * name: 'projects/my-project/locations/my-location/operations/my-operation',
5665
+ * });
5666
+ * console.log(res.data);
5667
+ *
5668
+ * // Example response
5669
+ * // {
5670
+ * // "done": false,
5671
+ * // "error": {},
5672
+ * // "metadata": {},
5673
+ * // "name": "my_name",
5674
+ * // "response": {}
5675
+ * // }
5676
+ * }
5677
+ *
5678
+ * main().catch(e => {
5679
+ * console.error(e);
5680
+ * throw e;
5681
+ * });
5682
+ *
5683
+ * ```
4589
5684
  *
4590
5685
  * @param params - Parameters for request
4591
5686
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4674,6 +5769,59 @@ export namespace vmmigration_v1 {
4674
5769
 
4675
5770
  /**
4676
5771
  * Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.
5772
+ * @example
5773
+ * ```js
5774
+ * // Before running the sample:
5775
+ * // - Enable the API at:
5776
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5777
+ * // - Login into gcloud by running:
5778
+ * // ```sh
5779
+ * // $ gcloud auth application-default login
5780
+ * // ```
5781
+ * // - Install the npm module by running:
5782
+ * // ```sh
5783
+ * // $ npm install googleapis
5784
+ * // ```
5785
+ *
5786
+ * const {google} = require('googleapis');
5787
+ * const vmmigration = google.vmmigration('v1');
5788
+ *
5789
+ * async function main() {
5790
+ * const auth = new google.auth.GoogleAuth({
5791
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5792
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5793
+ * });
5794
+ *
5795
+ * // Acquire an auth client, and bind it to all future calls
5796
+ * const authClient = await auth.getClient();
5797
+ * google.options({auth: authClient});
5798
+ *
5799
+ * // Do the magic
5800
+ * const res = await vmmigration.projects.locations.operations.list({
5801
+ * // The standard list filter.
5802
+ * filter: 'placeholder-value',
5803
+ * // The name of the operation's parent resource.
5804
+ * name: 'projects/my-project/locations/my-location',
5805
+ * // The standard list page size.
5806
+ * pageSize: 'placeholder-value',
5807
+ * // The standard list page token.
5808
+ * pageToken: 'placeholder-value',
5809
+ * });
5810
+ * console.log(res.data);
5811
+ *
5812
+ * // Example response
5813
+ * // {
5814
+ * // "nextPageToken": "my_nextPageToken",
5815
+ * // "operations": []
5816
+ * // }
5817
+ * }
5818
+ *
5819
+ * main().catch(e => {
5820
+ * console.error(e);
5821
+ * throw e;
5822
+ * });
5823
+ *
5824
+ * ```
4677
5825
  *
4678
5826
  * @param params - Parameters for request
4679
5827
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4834,6 +5982,76 @@ export namespace vmmigration_v1 {
4834
5982
 
4835
5983
  /**
4836
5984
  * Creates a new Source in a given project and location.
5985
+ * @example
5986
+ * ```js
5987
+ * // Before running the sample:
5988
+ * // - Enable the API at:
5989
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5990
+ * // - Login into gcloud by running:
5991
+ * // ```sh
5992
+ * // $ gcloud auth application-default login
5993
+ * // ```
5994
+ * // - Install the npm module by running:
5995
+ * // ```sh
5996
+ * // $ npm install googleapis
5997
+ * // ```
5998
+ *
5999
+ * const {google} = require('googleapis');
6000
+ * const vmmigration = google.vmmigration('v1');
6001
+ *
6002
+ * async function main() {
6003
+ * const auth = new google.auth.GoogleAuth({
6004
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6005
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6006
+ * });
6007
+ *
6008
+ * // Acquire an auth client, and bind it to all future calls
6009
+ * const authClient = await auth.getClient();
6010
+ * google.options({auth: authClient});
6011
+ *
6012
+ * // Do the magic
6013
+ * const res = await vmmigration.projects.locations.sources.create({
6014
+ * // Required. The Source's parent.
6015
+ * parent: 'projects/my-project/locations/my-location',
6016
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
6017
+ * requestId: 'placeholder-value',
6018
+ * // Required. The source identifier.
6019
+ * sourceId: 'placeholder-value',
6020
+ *
6021
+ * // Request body metadata
6022
+ * requestBody: {
6023
+ * // request body parameters
6024
+ * // {
6025
+ * // "aws": {},
6026
+ * // "azure": {},
6027
+ * // "createTime": "my_createTime",
6028
+ * // "description": "my_description",
6029
+ * // "encryption": {},
6030
+ * // "labels": {},
6031
+ * // "name": "my_name",
6032
+ * // "updateTime": "my_updateTime",
6033
+ * // "vmware": {}
6034
+ * // }
6035
+ * },
6036
+ * });
6037
+ * console.log(res.data);
6038
+ *
6039
+ * // Example response
6040
+ * // {
6041
+ * // "done": false,
6042
+ * // "error": {},
6043
+ * // "metadata": {},
6044
+ * // "name": "my_name",
6045
+ * // "response": {}
6046
+ * // }
6047
+ * }
6048
+ *
6049
+ * main().catch(e => {
6050
+ * console.error(e);
6051
+ * throw e;
6052
+ * });
6053
+ *
6054
+ * ```
4837
6055
  *
4838
6056
  * @param params - Parameters for request
4839
6057
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4925,6 +6143,58 @@ export namespace vmmigration_v1 {
4925
6143
 
4926
6144
  /**
4927
6145
  * Deletes a single Source.
6146
+ * @example
6147
+ * ```js
6148
+ * // Before running the sample:
6149
+ * // - Enable the API at:
6150
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6151
+ * // - Login into gcloud by running:
6152
+ * // ```sh
6153
+ * // $ gcloud auth application-default login
6154
+ * // ```
6155
+ * // - Install the npm module by running:
6156
+ * // ```sh
6157
+ * // $ npm install googleapis
6158
+ * // ```
6159
+ *
6160
+ * const {google} = require('googleapis');
6161
+ * const vmmigration = google.vmmigration('v1');
6162
+ *
6163
+ * async function main() {
6164
+ * const auth = new google.auth.GoogleAuth({
6165
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6166
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6167
+ * });
6168
+ *
6169
+ * // Acquire an auth client, and bind it to all future calls
6170
+ * const authClient = await auth.getClient();
6171
+ * google.options({auth: authClient});
6172
+ *
6173
+ * // Do the magic
6174
+ * const res = await vmmigration.projects.locations.sources.delete({
6175
+ * // Required. The Source name.
6176
+ * name: 'projects/my-project/locations/my-location/sources/my-source',
6177
+ * // Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
6178
+ * requestId: 'placeholder-value',
6179
+ * });
6180
+ * console.log(res.data);
6181
+ *
6182
+ * // Example response
6183
+ * // {
6184
+ * // "done": false,
6185
+ * // "error": {},
6186
+ * // "metadata": {},
6187
+ * // "name": "my_name",
6188
+ * // "response": {}
6189
+ * // }
6190
+ * }
6191
+ *
6192
+ * main().catch(e => {
6193
+ * console.error(e);
6194
+ * throw e;
6195
+ * });
6196
+ *
6197
+ * ```
4928
6198
  *
4929
6199
  * @param params - Parameters for request
4930
6200
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5013,6 +6283,62 @@ export namespace vmmigration_v1 {
5013
6283
 
5014
6284
  /**
5015
6285
  * List remote source's inventory of VMs. The remote source is the onprem vCenter (remote in the sense it's not in Compute Engine). The inventory describes the list of existing VMs in that source. Note that this operation lists the VMs on the remote source, as opposed to listing the MigratingVms resources in the vmmigration service.
6286
+ * @example
6287
+ * ```js
6288
+ * // Before running the sample:
6289
+ * // - Enable the API at:
6290
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6291
+ * // - Login into gcloud by running:
6292
+ * // ```sh
6293
+ * // $ gcloud auth application-default login
6294
+ * // ```
6295
+ * // - Install the npm module by running:
6296
+ * // ```sh
6297
+ * // $ npm install googleapis
6298
+ * // ```
6299
+ *
6300
+ * const {google} = require('googleapis');
6301
+ * const vmmigration = google.vmmigration('v1');
6302
+ *
6303
+ * async function main() {
6304
+ * const auth = new google.auth.GoogleAuth({
6305
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6306
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6307
+ * });
6308
+ *
6309
+ * // Acquire an auth client, and bind it to all future calls
6310
+ * const authClient = await auth.getClient();
6311
+ * google.options({auth: authClient});
6312
+ *
6313
+ * // Do the magic
6314
+ * const res = await vmmigration.projects.locations.sources.fetchInventory({
6315
+ * // If this flag is set to true, the source will be queried instead of using cached results. Using this flag will make the call slower.
6316
+ * forceRefresh: 'placeholder-value',
6317
+ * // The maximum number of VMs to return. The service may return fewer than this value. For AWS source: If unspecified, at most 500 VMs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. For VMWare source: If unspecified, all VMs will be returned. There is no limit for maximum value.
6318
+ * pageSize: 'placeholder-value',
6319
+ * // A page token, received from a previous `FetchInventory` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `FetchInventory` must match the call that provided the page token.
6320
+ * pageToken: 'placeholder-value',
6321
+ * // Required. The name of the Source.
6322
+ * source: 'projects/my-project/locations/my-location/sources/my-source',
6323
+ * });
6324
+ * console.log(res.data);
6325
+ *
6326
+ * // Example response
6327
+ * // {
6328
+ * // "awsVms": {},
6329
+ * // "azureVms": {},
6330
+ * // "nextPageToken": "my_nextPageToken",
6331
+ * // "updateTime": "my_updateTime",
6332
+ * // "vmwareVms": {}
6333
+ * // }
6334
+ * }
6335
+ *
6336
+ * main().catch(e => {
6337
+ * console.error(e);
6338
+ * throw e;
6339
+ * });
6340
+ *
6341
+ * ```
5016
6342
  *
5017
6343
  * @param params - Parameters for request
5018
6344
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5109,6 +6435,60 @@ export namespace vmmigration_v1 {
5109
6435
 
5110
6436
  /**
5111
6437
  * Gets details of a single Source.
6438
+ * @example
6439
+ * ```js
6440
+ * // Before running the sample:
6441
+ * // - Enable the API at:
6442
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6443
+ * // - Login into gcloud by running:
6444
+ * // ```sh
6445
+ * // $ gcloud auth application-default login
6446
+ * // ```
6447
+ * // - Install the npm module by running:
6448
+ * // ```sh
6449
+ * // $ npm install googleapis
6450
+ * // ```
6451
+ *
6452
+ * const {google} = require('googleapis');
6453
+ * const vmmigration = google.vmmigration('v1');
6454
+ *
6455
+ * async function main() {
6456
+ * const auth = new google.auth.GoogleAuth({
6457
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6458
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6459
+ * });
6460
+ *
6461
+ * // Acquire an auth client, and bind it to all future calls
6462
+ * const authClient = await auth.getClient();
6463
+ * google.options({auth: authClient});
6464
+ *
6465
+ * // Do the magic
6466
+ * const res = await vmmigration.projects.locations.sources.get({
6467
+ * // Required. The Source name.
6468
+ * name: 'projects/my-project/locations/my-location/sources/my-source',
6469
+ * });
6470
+ * console.log(res.data);
6471
+ *
6472
+ * // Example response
6473
+ * // {
6474
+ * // "aws": {},
6475
+ * // "azure": {},
6476
+ * // "createTime": "my_createTime",
6477
+ * // "description": "my_description",
6478
+ * // "encryption": {},
6479
+ * // "labels": {},
6480
+ * // "name": "my_name",
6481
+ * // "updateTime": "my_updateTime",
6482
+ * // "vmware": {}
6483
+ * // }
6484
+ * }
6485
+ *
6486
+ * main().catch(e => {
6487
+ * console.error(e);
6488
+ * throw e;
6489
+ * });
6490
+ *
6491
+ * ```
5112
6492
  *
5113
6493
  * @param params - Parameters for request
5114
6494
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5197,6 +6577,62 @@ export namespace vmmigration_v1 {
5197
6577
 
5198
6578
  /**
5199
6579
  * Lists Sources in a given project and location.
6580
+ * @example
6581
+ * ```js
6582
+ * // Before running the sample:
6583
+ * // - Enable the API at:
6584
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6585
+ * // - Login into gcloud by running:
6586
+ * // ```sh
6587
+ * // $ gcloud auth application-default login
6588
+ * // ```
6589
+ * // - Install the npm module by running:
6590
+ * // ```sh
6591
+ * // $ npm install googleapis
6592
+ * // ```
6593
+ *
6594
+ * const {google} = require('googleapis');
6595
+ * const vmmigration = google.vmmigration('v1');
6596
+ *
6597
+ * async function main() {
6598
+ * const auth = new google.auth.GoogleAuth({
6599
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6600
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6601
+ * });
6602
+ *
6603
+ * // Acquire an auth client, and bind it to all future calls
6604
+ * const authClient = await auth.getClient();
6605
+ * google.options({auth: authClient});
6606
+ *
6607
+ * // Do the magic
6608
+ * const res = await vmmigration.projects.locations.sources.list({
6609
+ * // Optional. The filter request.
6610
+ * filter: 'placeholder-value',
6611
+ * // Optional. the order by fields for the result.
6612
+ * orderBy: 'placeholder-value',
6613
+ * // Optional. The maximum number of sources to return. The service may return fewer than this value. If unspecified, at most 500 sources will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
6614
+ * pageSize: 'placeholder-value',
6615
+ * // Required. A page token, received from a previous `ListSources` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSources` must match the call that provided the page token.
6616
+ * pageToken: 'placeholder-value',
6617
+ * // Required. The parent, which owns this collection of sources.
6618
+ * parent: 'projects/my-project/locations/my-location',
6619
+ * });
6620
+ * console.log(res.data);
6621
+ *
6622
+ * // Example response
6623
+ * // {
6624
+ * // "nextPageToken": "my_nextPageToken",
6625
+ * // "sources": [],
6626
+ * // "unreachable": []
6627
+ * // }
6628
+ * }
6629
+ *
6630
+ * main().catch(e => {
6631
+ * console.error(e);
6632
+ * throw e;
6633
+ * });
6634
+ *
6635
+ * ```
5200
6636
  *
5201
6637
  * @param params - Parameters for request
5202
6638
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5288,6 +6724,76 @@ export namespace vmmigration_v1 {
5288
6724
 
5289
6725
  /**
5290
6726
  * Updates the parameters of a single Source.
6727
+ * @example
6728
+ * ```js
6729
+ * // Before running the sample:
6730
+ * // - Enable the API at:
6731
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6732
+ * // - Login into gcloud by running:
6733
+ * // ```sh
6734
+ * // $ gcloud auth application-default login
6735
+ * // ```
6736
+ * // - Install the npm module by running:
6737
+ * // ```sh
6738
+ * // $ npm install googleapis
6739
+ * // ```
6740
+ *
6741
+ * const {google} = require('googleapis');
6742
+ * const vmmigration = google.vmmigration('v1');
6743
+ *
6744
+ * async function main() {
6745
+ * const auth = new google.auth.GoogleAuth({
6746
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6747
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6748
+ * });
6749
+ *
6750
+ * // Acquire an auth client, and bind it to all future calls
6751
+ * const authClient = await auth.getClient();
6752
+ * google.options({auth: authClient});
6753
+ *
6754
+ * // Do the magic
6755
+ * const res = await vmmigration.projects.locations.sources.patch({
6756
+ * // Output only. The Source name.
6757
+ * name: 'projects/my-project/locations/my-location/sources/my-source',
6758
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
6759
+ * requestId: 'placeholder-value',
6760
+ * // Field mask is used to specify the fields to be overwritten in the Source resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
6761
+ * updateMask: 'placeholder-value',
6762
+ *
6763
+ * // Request body metadata
6764
+ * requestBody: {
6765
+ * // request body parameters
6766
+ * // {
6767
+ * // "aws": {},
6768
+ * // "azure": {},
6769
+ * // "createTime": "my_createTime",
6770
+ * // "description": "my_description",
6771
+ * // "encryption": {},
6772
+ * // "labels": {},
6773
+ * // "name": "my_name",
6774
+ * // "updateTime": "my_updateTime",
6775
+ * // "vmware": {}
6776
+ * // }
6777
+ * },
6778
+ * });
6779
+ * console.log(res.data);
6780
+ *
6781
+ * // Example response
6782
+ * // {
6783
+ * // "done": false,
6784
+ * // "error": {},
6785
+ * // "metadata": {},
6786
+ * // "name": "my_name",
6787
+ * // "response": {}
6788
+ * // }
6789
+ * }
6790
+ *
6791
+ * main().catch(e => {
6792
+ * console.error(e);
6793
+ * throw e;
6794
+ * });
6795
+ *
6796
+ * ```
5291
6797
  *
5292
6798
  * @param params - Parameters for request
5293
6799
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5484,6 +6990,82 @@ export namespace vmmigration_v1 {
5484
6990
 
5485
6991
  /**
5486
6992
  * Creates a new DatacenterConnector in a given Source.
6993
+ * @example
6994
+ * ```js
6995
+ * // Before running the sample:
6996
+ * // - Enable the API at:
6997
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6998
+ * // - Login into gcloud by running:
6999
+ * // ```sh
7000
+ * // $ gcloud auth application-default login
7001
+ * // ```
7002
+ * // - Install the npm module by running:
7003
+ * // ```sh
7004
+ * // $ npm install googleapis
7005
+ * // ```
7006
+ *
7007
+ * const {google} = require('googleapis');
7008
+ * const vmmigration = google.vmmigration('v1');
7009
+ *
7010
+ * async function main() {
7011
+ * const auth = new google.auth.GoogleAuth({
7012
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7013
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7014
+ * });
7015
+ *
7016
+ * // Acquire an auth client, and bind it to all future calls
7017
+ * const authClient = await auth.getClient();
7018
+ * google.options({auth: authClient});
7019
+ *
7020
+ * // Do the magic
7021
+ * const res =
7022
+ * await vmmigration.projects.locations.sources.datacenterConnectors.create({
7023
+ * // Required. The datacenterConnector identifier.
7024
+ * datacenterConnectorId: 'placeholder-value',
7025
+ * // Required. The DatacenterConnector's parent. Required. The Source in where the new DatacenterConnector will be created. For example: `projects/my-project/locations/us-central1/sources/my-source`
7026
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
7027
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
7028
+ * requestId: 'placeholder-value',
7029
+ *
7030
+ * // Request body metadata
7031
+ * requestBody: {
7032
+ * // request body parameters
7033
+ * // {
7034
+ * // "applianceInfrastructureVersion": "my_applianceInfrastructureVersion",
7035
+ * // "applianceSoftwareVersion": "my_applianceSoftwareVersion",
7036
+ * // "availableVersions": {},
7037
+ * // "bucket": "my_bucket",
7038
+ * // "createTime": "my_createTime",
7039
+ * // "error": {},
7040
+ * // "name": "my_name",
7041
+ * // "registrationId": "my_registrationId",
7042
+ * // "serviceAccount": "my_serviceAccount",
7043
+ * // "state": "my_state",
7044
+ * // "stateTime": "my_stateTime",
7045
+ * // "updateTime": "my_updateTime",
7046
+ * // "upgradeStatus": {},
7047
+ * // "version": "my_version"
7048
+ * // }
7049
+ * },
7050
+ * });
7051
+ * console.log(res.data);
7052
+ *
7053
+ * // Example response
7054
+ * // {
7055
+ * // "done": false,
7056
+ * // "error": {},
7057
+ * // "metadata": {},
7058
+ * // "name": "my_name",
7059
+ * // "response": {}
7060
+ * // }
7061
+ * }
7062
+ *
7063
+ * main().catch(e => {
7064
+ * console.error(e);
7065
+ * throw e;
7066
+ * });
7067
+ *
7068
+ * ```
5487
7069
  *
5488
7070
  * @param params - Parameters for request
5489
7071
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5576,6 +7158,59 @@ export namespace vmmigration_v1 {
5576
7158
 
5577
7159
  /**
5578
7160
  * Deletes a single DatacenterConnector.
7161
+ * @example
7162
+ * ```js
7163
+ * // Before running the sample:
7164
+ * // - Enable the API at:
7165
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7166
+ * // - Login into gcloud by running:
7167
+ * // ```sh
7168
+ * // $ gcloud auth application-default login
7169
+ * // ```
7170
+ * // - Install the npm module by running:
7171
+ * // ```sh
7172
+ * // $ npm install googleapis
7173
+ * // ```
7174
+ *
7175
+ * const {google} = require('googleapis');
7176
+ * const vmmigration = google.vmmigration('v1');
7177
+ *
7178
+ * async function main() {
7179
+ * const auth = new google.auth.GoogleAuth({
7180
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7181
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7182
+ * });
7183
+ *
7184
+ * // Acquire an auth client, and bind it to all future calls
7185
+ * const authClient = await auth.getClient();
7186
+ * google.options({auth: authClient});
7187
+ *
7188
+ * // Do the magic
7189
+ * const res =
7190
+ * await vmmigration.projects.locations.sources.datacenterConnectors.delete({
7191
+ * // Required. The DatacenterConnector name.
7192
+ * name: 'projects/my-project/locations/my-location/sources/my-source/datacenterConnectors/my-datacenterConnector',
7193
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
7194
+ * requestId: 'placeholder-value',
7195
+ * });
7196
+ * console.log(res.data);
7197
+ *
7198
+ * // Example response
7199
+ * // {
7200
+ * // "done": false,
7201
+ * // "error": {},
7202
+ * // "metadata": {},
7203
+ * // "name": "my_name",
7204
+ * // "response": {}
7205
+ * // }
7206
+ * }
7207
+ *
7208
+ * main().catch(e => {
7209
+ * console.error(e);
7210
+ * throw e;
7211
+ * });
7212
+ *
7213
+ * ```
5579
7214
  *
5580
7215
  * @param params - Parameters for request
5581
7216
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5665,6 +7300,66 @@ export namespace vmmigration_v1 {
5665
7300
 
5666
7301
  /**
5667
7302
  * Gets details of a single DatacenterConnector.
7303
+ * @example
7304
+ * ```js
7305
+ * // Before running the sample:
7306
+ * // - Enable the API at:
7307
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7308
+ * // - Login into gcloud by running:
7309
+ * // ```sh
7310
+ * // $ gcloud auth application-default login
7311
+ * // ```
7312
+ * // - Install the npm module by running:
7313
+ * // ```sh
7314
+ * // $ npm install googleapis
7315
+ * // ```
7316
+ *
7317
+ * const {google} = require('googleapis');
7318
+ * const vmmigration = google.vmmigration('v1');
7319
+ *
7320
+ * async function main() {
7321
+ * const auth = new google.auth.GoogleAuth({
7322
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7323
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7324
+ * });
7325
+ *
7326
+ * // Acquire an auth client, and bind it to all future calls
7327
+ * const authClient = await auth.getClient();
7328
+ * google.options({auth: authClient});
7329
+ *
7330
+ * // Do the magic
7331
+ * const res =
7332
+ * await vmmigration.projects.locations.sources.datacenterConnectors.get({
7333
+ * // Required. The name of the DatacenterConnector.
7334
+ * name: 'projects/my-project/locations/my-location/sources/my-source/datacenterConnectors/my-datacenterConnector',
7335
+ * });
7336
+ * console.log(res.data);
7337
+ *
7338
+ * // Example response
7339
+ * // {
7340
+ * // "applianceInfrastructureVersion": "my_applianceInfrastructureVersion",
7341
+ * // "applianceSoftwareVersion": "my_applianceSoftwareVersion",
7342
+ * // "availableVersions": {},
7343
+ * // "bucket": "my_bucket",
7344
+ * // "createTime": "my_createTime",
7345
+ * // "error": {},
7346
+ * // "name": "my_name",
7347
+ * // "registrationId": "my_registrationId",
7348
+ * // "serviceAccount": "my_serviceAccount",
7349
+ * // "state": "my_state",
7350
+ * // "stateTime": "my_stateTime",
7351
+ * // "updateTime": "my_updateTime",
7352
+ * // "upgradeStatus": {},
7353
+ * // "version": "my_version"
7354
+ * // }
7355
+ * }
7356
+ *
7357
+ * main().catch(e => {
7358
+ * console.error(e);
7359
+ * throw e;
7360
+ * });
7361
+ *
7362
+ * ```
5668
7363
  *
5669
7364
  * @param params - Parameters for request
5670
7365
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5754,6 +7449,63 @@ export namespace vmmigration_v1 {
5754
7449
 
5755
7450
  /**
5756
7451
  * Lists DatacenterConnectors in a given Source.
7452
+ * @example
7453
+ * ```js
7454
+ * // Before running the sample:
7455
+ * // - Enable the API at:
7456
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7457
+ * // - Login into gcloud by running:
7458
+ * // ```sh
7459
+ * // $ gcloud auth application-default login
7460
+ * // ```
7461
+ * // - Install the npm module by running:
7462
+ * // ```sh
7463
+ * // $ npm install googleapis
7464
+ * // ```
7465
+ *
7466
+ * const {google} = require('googleapis');
7467
+ * const vmmigration = google.vmmigration('v1');
7468
+ *
7469
+ * async function main() {
7470
+ * const auth = new google.auth.GoogleAuth({
7471
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7472
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7473
+ * });
7474
+ *
7475
+ * // Acquire an auth client, and bind it to all future calls
7476
+ * const authClient = await auth.getClient();
7477
+ * google.options({auth: authClient});
7478
+ *
7479
+ * // Do the magic
7480
+ * const res =
7481
+ * await vmmigration.projects.locations.sources.datacenterConnectors.list({
7482
+ * // Optional. The filter request.
7483
+ * filter: 'placeholder-value',
7484
+ * // Optional. the order by fields for the result.
7485
+ * orderBy: 'placeholder-value',
7486
+ * // Optional. The maximum number of connectors to return. The service may return fewer than this value. If unspecified, at most 500 sources will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
7487
+ * pageSize: 'placeholder-value',
7488
+ * // Required. A page token, received from a previous `ListDatacenterConnectors` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListDatacenterConnectors` must match the call that provided the page token.
7489
+ * pageToken: 'placeholder-value',
7490
+ * // Required. The parent, which owns this collection of connectors.
7491
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
7492
+ * });
7493
+ * console.log(res.data);
7494
+ *
7495
+ * // Example response
7496
+ * // {
7497
+ * // "datacenterConnectors": [],
7498
+ * // "nextPageToken": "my_nextPageToken",
7499
+ * // "unreachable": []
7500
+ * // }
7501
+ * }
7502
+ *
7503
+ * main().catch(e => {
7504
+ * console.error(e);
7505
+ * throw e;
7506
+ * });
7507
+ *
7508
+ * ```
5757
7509
  *
5758
7510
  * @param params - Parameters for request
5759
7511
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -5856,6 +7608,68 @@ export namespace vmmigration_v1 {
5856
7608
 
5857
7609
  /**
5858
7610
  * Upgrades the appliance relate to this DatacenterConnector to the in-place updateable version.
7611
+ * @example
7612
+ * ```js
7613
+ * // Before running the sample:
7614
+ * // - Enable the API at:
7615
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7616
+ * // - Login into gcloud by running:
7617
+ * // ```sh
7618
+ * // $ gcloud auth application-default login
7619
+ * // ```
7620
+ * // - Install the npm module by running:
7621
+ * // ```sh
7622
+ * // $ npm install googleapis
7623
+ * // ```
7624
+ *
7625
+ * const {google} = require('googleapis');
7626
+ * const vmmigration = google.vmmigration('v1');
7627
+ *
7628
+ * async function main() {
7629
+ * const auth = new google.auth.GoogleAuth({
7630
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7631
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7632
+ * });
7633
+ *
7634
+ * // Acquire an auth client, and bind it to all future calls
7635
+ * const authClient = await auth.getClient();
7636
+ * google.options({auth: authClient});
7637
+ *
7638
+ * // Do the magic
7639
+ * const res =
7640
+ * await vmmigration.projects.locations.sources.datacenterConnectors.upgradeAppliance(
7641
+ * {
7642
+ * // Required. The DatacenterConnector name.
7643
+ * datacenterConnector:
7644
+ * 'projects/my-project/locations/my-location/sources/my-source/datacenterConnectors/my-datacenterConnector',
7645
+ *
7646
+ * // Request body metadata
7647
+ * requestBody: {
7648
+ * // request body parameters
7649
+ * // {
7650
+ * // "requestId": "my_requestId"
7651
+ * // }
7652
+ * },
7653
+ * },
7654
+ * );
7655
+ * console.log(res.data);
7656
+ *
7657
+ * // Example response
7658
+ * // {
7659
+ * // "done": false,
7660
+ * // "error": {},
7661
+ * // "metadata": {},
7662
+ * // "name": "my_name",
7663
+ * // "response": {}
7664
+ * // }
7665
+ * }
7666
+ *
7667
+ * main().catch(e => {
7668
+ * console.error(e);
7669
+ * throw e;
7670
+ * });
7671
+ *
7672
+ * ```
5859
7673
  *
5860
7674
  * @param params - Parameters for request
5861
7675
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6043,6 +7857,91 @@ export namespace vmmigration_v1 {
6043
7857
 
6044
7858
  /**
6045
7859
  * Creates a new MigratingVm in a given Source.
7860
+ * @example
7861
+ * ```js
7862
+ * // Before running the sample:
7863
+ * // - Enable the API at:
7864
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7865
+ * // - Login into gcloud by running:
7866
+ * // ```sh
7867
+ * // $ gcloud auth application-default login
7868
+ * // ```
7869
+ * // - Install the npm module by running:
7870
+ * // ```sh
7871
+ * // $ npm install googleapis
7872
+ * // ```
7873
+ *
7874
+ * const {google} = require('googleapis');
7875
+ * const vmmigration = google.vmmigration('v1');
7876
+ *
7877
+ * async function main() {
7878
+ * const auth = new google.auth.GoogleAuth({
7879
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7880
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7881
+ * });
7882
+ *
7883
+ * // Acquire an auth client, and bind it to all future calls
7884
+ * const authClient = await auth.getClient();
7885
+ * google.options({auth: authClient});
7886
+ *
7887
+ * // Do the magic
7888
+ * const res = await vmmigration.projects.locations.sources.migratingVms.create({
7889
+ * // Required. The migratingVm identifier.
7890
+ * migratingVmId: 'placeholder-value',
7891
+ * // Required. The MigratingVm's parent.
7892
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
7893
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
7894
+ * requestId: 'placeholder-value',
7895
+ *
7896
+ * // Request body metadata
7897
+ * requestBody: {
7898
+ * // request body parameters
7899
+ * // {
7900
+ * // "awsSourceVmDetails": {},
7901
+ * // "azureSourceVmDetails": {},
7902
+ * // "computeEngineDisksTargetDefaults": {},
7903
+ * // "computeEngineTargetDefaults": {},
7904
+ * // "createTime": "my_createTime",
7905
+ * // "currentSyncInfo": {},
7906
+ * // "cutoverForecast": {},
7907
+ * // "description": "my_description",
7908
+ * // "displayName": "my_displayName",
7909
+ * // "error": {},
7910
+ * // "expiration": {},
7911
+ * // "group": "my_group",
7912
+ * // "labels": {},
7913
+ * // "lastReplicationCycle": {},
7914
+ * // "lastSync": {},
7915
+ * // "name": "my_name",
7916
+ * // "policy": {},
7917
+ * // "recentCloneJobs": [],
7918
+ * // "recentCutoverJobs": [],
7919
+ * // "sourceVmId": "my_sourceVmId",
7920
+ * // "state": "my_state",
7921
+ * // "stateTime": "my_stateTime",
7922
+ * // "updateTime": "my_updateTime",
7923
+ * // "vmwareSourceVmDetails": {}
7924
+ * // }
7925
+ * },
7926
+ * });
7927
+ * console.log(res.data);
7928
+ *
7929
+ * // Example response
7930
+ * // {
7931
+ * // "done": false,
7932
+ * // "error": {},
7933
+ * // "metadata": {},
7934
+ * // "name": "my_name",
7935
+ * // "response": {}
7936
+ * // }
7937
+ * }
7938
+ *
7939
+ * main().catch(e => {
7940
+ * console.error(e);
7941
+ * throw e;
7942
+ * });
7943
+ *
7944
+ * ```
6046
7945
  *
6047
7946
  * @param params - Parameters for request
6048
7947
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6135,6 +8034,56 @@ export namespace vmmigration_v1 {
6135
8034
 
6136
8035
  /**
6137
8036
  * Deletes a single MigratingVm.
8037
+ * @example
8038
+ * ```js
8039
+ * // Before running the sample:
8040
+ * // - Enable the API at:
8041
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
8042
+ * // - Login into gcloud by running:
8043
+ * // ```sh
8044
+ * // $ gcloud auth application-default login
8045
+ * // ```
8046
+ * // - Install the npm module by running:
8047
+ * // ```sh
8048
+ * // $ npm install googleapis
8049
+ * // ```
8050
+ *
8051
+ * const {google} = require('googleapis');
8052
+ * const vmmigration = google.vmmigration('v1');
8053
+ *
8054
+ * async function main() {
8055
+ * const auth = new google.auth.GoogleAuth({
8056
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
8057
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
8058
+ * });
8059
+ *
8060
+ * // Acquire an auth client, and bind it to all future calls
8061
+ * const authClient = await auth.getClient();
8062
+ * google.options({auth: authClient});
8063
+ *
8064
+ * // Do the magic
8065
+ * const res = await vmmigration.projects.locations.sources.migratingVms.delete({
8066
+ * // Required. The name of the MigratingVm.
8067
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
8068
+ * });
8069
+ * console.log(res.data);
8070
+ *
8071
+ * // Example response
8072
+ * // {
8073
+ * // "done": false,
8074
+ * // "error": {},
8075
+ * // "metadata": {},
8076
+ * // "name": "my_name",
8077
+ * // "response": {}
8078
+ * // }
8079
+ * }
8080
+ *
8081
+ * main().catch(e => {
8082
+ * console.error(e);
8083
+ * throw e;
8084
+ * });
8085
+ *
8086
+ * ```
6138
8087
  *
6139
8088
  * @param params - Parameters for request
6140
8089
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6222,8 +8171,218 @@ export namespace vmmigration_v1 {
6222
8171
  }
6223
8172
  }
6224
8173
 
8174
+ /**
8175
+ * Extend the migrating VM time to live.
8176
+ * @example
8177
+ * ```js
8178
+ * // Before running the sample:
8179
+ * // - Enable the API at:
8180
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
8181
+ * // - Login into gcloud by running:
8182
+ * // ```sh
8183
+ * // $ gcloud auth application-default login
8184
+ * // ```
8185
+ * // - Install the npm module by running:
8186
+ * // ```sh
8187
+ * // $ npm install googleapis
8188
+ * // ```
8189
+ *
8190
+ * const {google} = require('googleapis');
8191
+ * const vmmigration = google.vmmigration('v1');
8192
+ *
8193
+ * async function main() {
8194
+ * const auth = new google.auth.GoogleAuth({
8195
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
8196
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
8197
+ * });
8198
+ *
8199
+ * // Acquire an auth client, and bind it to all future calls
8200
+ * const authClient = await auth.getClient();
8201
+ * google.options({auth: authClient});
8202
+ *
8203
+ * // Do the magic
8204
+ * const res =
8205
+ * await vmmigration.projects.locations.sources.migratingVms.extendMigration({
8206
+ * // Required. The name of the MigratingVm.
8207
+ * migratingVm:
8208
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
8209
+ *
8210
+ * // Request body metadata
8211
+ * requestBody: {
8212
+ * // request body parameters
8213
+ * // {}
8214
+ * },
8215
+ * });
8216
+ * console.log(res.data);
8217
+ *
8218
+ * // Example response
8219
+ * // {
8220
+ * // "done": false,
8221
+ * // "error": {},
8222
+ * // "metadata": {},
8223
+ * // "name": "my_name",
8224
+ * // "response": {}
8225
+ * // }
8226
+ * }
8227
+ *
8228
+ * main().catch(e => {
8229
+ * console.error(e);
8230
+ * throw e;
8231
+ * });
8232
+ *
8233
+ * ```
8234
+ *
8235
+ * @param params - Parameters for request
8236
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
8237
+ * @param callback - Optional callback that handles the response.
8238
+ * @returns A promise if used with async/await, or void if used with a callback.
8239
+ */
8240
+ extendMigration(
8241
+ params: Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration,
8242
+ options: StreamMethodOptions
8243
+ ): Promise<GaxiosResponseWithHTTP2<Readable>>;
8244
+ extendMigration(
8245
+ params?: Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration,
8246
+ options?: MethodOptions
8247
+ ): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
8248
+ extendMigration(
8249
+ params: Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration,
8250
+ options: StreamMethodOptions | BodyResponseCallback<Readable>,
8251
+ callback: BodyResponseCallback<Readable>
8252
+ ): void;
8253
+ extendMigration(
8254
+ params: Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration,
8255
+ options: MethodOptions | BodyResponseCallback<Schema$Operation>,
8256
+ callback: BodyResponseCallback<Schema$Operation>
8257
+ ): void;
8258
+ extendMigration(
8259
+ params: Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration,
8260
+ callback: BodyResponseCallback<Schema$Operation>
8261
+ ): void;
8262
+ extendMigration(callback: BodyResponseCallback<Schema$Operation>): void;
8263
+ extendMigration(
8264
+ paramsOrCallback?:
8265
+ | Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration
8266
+ | BodyResponseCallback<Schema$Operation>
8267
+ | BodyResponseCallback<Readable>,
8268
+ optionsOrCallback?:
8269
+ | MethodOptions
8270
+ | StreamMethodOptions
8271
+ | BodyResponseCallback<Schema$Operation>
8272
+ | BodyResponseCallback<Readable>,
8273
+ callback?:
8274
+ | BodyResponseCallback<Schema$Operation>
8275
+ | BodyResponseCallback<Readable>
8276
+ ):
8277
+ | void
8278
+ | Promise<GaxiosResponseWithHTTP2<Schema$Operation>>
8279
+ | Promise<GaxiosResponseWithHTTP2<Readable>> {
8280
+ let params = (paramsOrCallback ||
8281
+ {}) as Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration;
8282
+ let options = (optionsOrCallback || {}) as MethodOptions;
8283
+
8284
+ if (typeof paramsOrCallback === 'function') {
8285
+ callback = paramsOrCallback;
8286
+ params =
8287
+ {} as Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration;
8288
+ options = {};
8289
+ }
8290
+
8291
+ if (typeof optionsOrCallback === 'function') {
8292
+ callback = optionsOrCallback;
8293
+ options = {};
8294
+ }
8295
+
8296
+ const rootUrl = options.rootUrl || 'https://vmmigration.googleapis.com/';
8297
+ const parameters = {
8298
+ options: Object.assign(
8299
+ {
8300
+ url: (rootUrl + '/v1/{+migratingVm}:extendMigration').replace(
8301
+ /([^:]\/)\/+/g,
8302
+ '$1'
8303
+ ),
8304
+ method: 'POST',
8305
+ apiVersion: '',
8306
+ },
8307
+ options
8308
+ ),
8309
+ params,
8310
+ requiredParams: ['migratingVm'],
8311
+ pathParams: ['migratingVm'],
8312
+ context: this.context,
8313
+ };
8314
+ if (callback) {
8315
+ createAPIRequest<Schema$Operation>(
8316
+ parameters,
8317
+ callback as BodyResponseCallback<unknown>
8318
+ );
8319
+ } else {
8320
+ return createAPIRequest<Schema$Operation>(parameters);
8321
+ }
8322
+ }
8323
+
6225
8324
  /**
6226
8325
  * Marks a migration as completed, deleting migration resources that are no longer being used. Only applicable after cutover is done.
8326
+ * @example
8327
+ * ```js
8328
+ * // Before running the sample:
8329
+ * // - Enable the API at:
8330
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
8331
+ * // - Login into gcloud by running:
8332
+ * // ```sh
8333
+ * // $ gcloud auth application-default login
8334
+ * // ```
8335
+ * // - Install the npm module by running:
8336
+ * // ```sh
8337
+ * // $ npm install googleapis
8338
+ * // ```
8339
+ *
8340
+ * const {google} = require('googleapis');
8341
+ * const vmmigration = google.vmmigration('v1');
8342
+ *
8343
+ * async function main() {
8344
+ * const auth = new google.auth.GoogleAuth({
8345
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
8346
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
8347
+ * });
8348
+ *
8349
+ * // Acquire an auth client, and bind it to all future calls
8350
+ * const authClient = await auth.getClient();
8351
+ * google.options({auth: authClient});
8352
+ *
8353
+ * // Do the magic
8354
+ * const res =
8355
+ * await vmmigration.projects.locations.sources.migratingVms.finalizeMigration(
8356
+ * {
8357
+ * // Required. The name of the MigratingVm.
8358
+ * migratingVm:
8359
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
8360
+ *
8361
+ * // Request body metadata
8362
+ * requestBody: {
8363
+ * // request body parameters
8364
+ * // {}
8365
+ * },
8366
+ * },
8367
+ * );
8368
+ * console.log(res.data);
8369
+ *
8370
+ * // Example response
8371
+ * // {
8372
+ * // "done": false,
8373
+ * // "error": {},
8374
+ * // "metadata": {},
8375
+ * // "name": "my_name",
8376
+ * // "response": {}
8377
+ * // }
8378
+ * }
8379
+ *
8380
+ * main().catch(e => {
8381
+ * console.error(e);
8382
+ * throw e;
8383
+ * });
8384
+ *
8385
+ * ```
6227
8386
  *
6228
8387
  * @param params - Parameters for request
6229
8388
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6316,6 +8475,77 @@ export namespace vmmigration_v1 {
6316
8475
 
6317
8476
  /**
6318
8477
  * Gets details of a single MigratingVm.
8478
+ * @example
8479
+ * ```js
8480
+ * // Before running the sample:
8481
+ * // - Enable the API at:
8482
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
8483
+ * // - Login into gcloud by running:
8484
+ * // ```sh
8485
+ * // $ gcloud auth application-default login
8486
+ * // ```
8487
+ * // - Install the npm module by running:
8488
+ * // ```sh
8489
+ * // $ npm install googleapis
8490
+ * // ```
8491
+ *
8492
+ * const {google} = require('googleapis');
8493
+ * const vmmigration = google.vmmigration('v1');
8494
+ *
8495
+ * async function main() {
8496
+ * const auth = new google.auth.GoogleAuth({
8497
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
8498
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
8499
+ * });
8500
+ *
8501
+ * // Acquire an auth client, and bind it to all future calls
8502
+ * const authClient = await auth.getClient();
8503
+ * google.options({auth: authClient});
8504
+ *
8505
+ * // Do the magic
8506
+ * const res = await vmmigration.projects.locations.sources.migratingVms.get({
8507
+ * // Required. The name of the MigratingVm.
8508
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
8509
+ * // Optional. The level of details of the migrating VM.
8510
+ * view: 'placeholder-value',
8511
+ * });
8512
+ * console.log(res.data);
8513
+ *
8514
+ * // Example response
8515
+ * // {
8516
+ * // "awsSourceVmDetails": {},
8517
+ * // "azureSourceVmDetails": {},
8518
+ * // "computeEngineDisksTargetDefaults": {},
8519
+ * // "computeEngineTargetDefaults": {},
8520
+ * // "createTime": "my_createTime",
8521
+ * // "currentSyncInfo": {},
8522
+ * // "cutoverForecast": {},
8523
+ * // "description": "my_description",
8524
+ * // "displayName": "my_displayName",
8525
+ * // "error": {},
8526
+ * // "expiration": {},
8527
+ * // "group": "my_group",
8528
+ * // "labels": {},
8529
+ * // "lastReplicationCycle": {},
8530
+ * // "lastSync": {},
8531
+ * // "name": "my_name",
8532
+ * // "policy": {},
8533
+ * // "recentCloneJobs": [],
8534
+ * // "recentCutoverJobs": [],
8535
+ * // "sourceVmId": "my_sourceVmId",
8536
+ * // "state": "my_state",
8537
+ * // "stateTime": "my_stateTime",
8538
+ * // "updateTime": "my_updateTime",
8539
+ * // "vmwareSourceVmDetails": {}
8540
+ * // }
8541
+ * }
8542
+ *
8543
+ * main().catch(e => {
8544
+ * console.error(e);
8545
+ * throw e;
8546
+ * });
8547
+ *
8548
+ * ```
6319
8549
  *
6320
8550
  * @param params - Parameters for request
6321
8551
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6405,6 +8635,64 @@ export namespace vmmigration_v1 {
6405
8635
 
6406
8636
  /**
6407
8637
  * Lists MigratingVms in a given Source.
8638
+ * @example
8639
+ * ```js
8640
+ * // Before running the sample:
8641
+ * // - Enable the API at:
8642
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
8643
+ * // - Login into gcloud by running:
8644
+ * // ```sh
8645
+ * // $ gcloud auth application-default login
8646
+ * // ```
8647
+ * // - Install the npm module by running:
8648
+ * // ```sh
8649
+ * // $ npm install googleapis
8650
+ * // ```
8651
+ *
8652
+ * const {google} = require('googleapis');
8653
+ * const vmmigration = google.vmmigration('v1');
8654
+ *
8655
+ * async function main() {
8656
+ * const auth = new google.auth.GoogleAuth({
8657
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
8658
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
8659
+ * });
8660
+ *
8661
+ * // Acquire an auth client, and bind it to all future calls
8662
+ * const authClient = await auth.getClient();
8663
+ * google.options({auth: authClient});
8664
+ *
8665
+ * // Do the magic
8666
+ * const res = await vmmigration.projects.locations.sources.migratingVms.list({
8667
+ * // Optional. The filter request.
8668
+ * filter: 'placeholder-value',
8669
+ * // Optional. the order by fields for the result.
8670
+ * orderBy: 'placeholder-value',
8671
+ * // Optional. The maximum number of migrating VMs to return. The service may return fewer than this value. If unspecified, at most 500 migrating VMs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
8672
+ * pageSize: 'placeholder-value',
8673
+ * // Required. A page token, received from a previous `ListMigratingVms` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListMigratingVms` must match the call that provided the page token.
8674
+ * pageToken: 'placeholder-value',
8675
+ * // Required. The parent, which owns this collection of MigratingVms.
8676
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
8677
+ * // Optional. The level of details of each migrating VM.
8678
+ * view: 'placeholder-value',
8679
+ * });
8680
+ * console.log(res.data);
8681
+ *
8682
+ * // Example response
8683
+ * // {
8684
+ * // "migratingVms": [],
8685
+ * // "nextPageToken": "my_nextPageToken",
8686
+ * // "unreachable": []
8687
+ * // }
8688
+ * }
8689
+ *
8690
+ * main().catch(e => {
8691
+ * console.error(e);
8692
+ * throw e;
8693
+ * });
8694
+ *
8695
+ * ```
6408
8696
  *
6409
8697
  * @param params - Parameters for request
6410
8698
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6499,6 +8787,91 @@ export namespace vmmigration_v1 {
6499
8787
 
6500
8788
  /**
6501
8789
  * Updates the parameters of a single MigratingVm.
8790
+ * @example
8791
+ * ```js
8792
+ * // Before running the sample:
8793
+ * // - Enable the API at:
8794
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
8795
+ * // - Login into gcloud by running:
8796
+ * // ```sh
8797
+ * // $ gcloud auth application-default login
8798
+ * // ```
8799
+ * // - Install the npm module by running:
8800
+ * // ```sh
8801
+ * // $ npm install googleapis
8802
+ * // ```
8803
+ *
8804
+ * const {google} = require('googleapis');
8805
+ * const vmmigration = google.vmmigration('v1');
8806
+ *
8807
+ * async function main() {
8808
+ * const auth = new google.auth.GoogleAuth({
8809
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
8810
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
8811
+ * });
8812
+ *
8813
+ * // Acquire an auth client, and bind it to all future calls
8814
+ * const authClient = await auth.getClient();
8815
+ * google.options({auth: authClient});
8816
+ *
8817
+ * // Do the magic
8818
+ * const res = await vmmigration.projects.locations.sources.migratingVms.patch({
8819
+ * // Output only. The identifier of the MigratingVm.
8820
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
8821
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
8822
+ * requestId: 'placeholder-value',
8823
+ * // Field mask is used to specify the fields to be overwritten in the MigratingVm resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
8824
+ * updateMask: 'placeholder-value',
8825
+ *
8826
+ * // Request body metadata
8827
+ * requestBody: {
8828
+ * // request body parameters
8829
+ * // {
8830
+ * // "awsSourceVmDetails": {},
8831
+ * // "azureSourceVmDetails": {},
8832
+ * // "computeEngineDisksTargetDefaults": {},
8833
+ * // "computeEngineTargetDefaults": {},
8834
+ * // "createTime": "my_createTime",
8835
+ * // "currentSyncInfo": {},
8836
+ * // "cutoverForecast": {},
8837
+ * // "description": "my_description",
8838
+ * // "displayName": "my_displayName",
8839
+ * // "error": {},
8840
+ * // "expiration": {},
8841
+ * // "group": "my_group",
8842
+ * // "labels": {},
8843
+ * // "lastReplicationCycle": {},
8844
+ * // "lastSync": {},
8845
+ * // "name": "my_name",
8846
+ * // "policy": {},
8847
+ * // "recentCloneJobs": [],
8848
+ * // "recentCutoverJobs": [],
8849
+ * // "sourceVmId": "my_sourceVmId",
8850
+ * // "state": "my_state",
8851
+ * // "stateTime": "my_stateTime",
8852
+ * // "updateTime": "my_updateTime",
8853
+ * // "vmwareSourceVmDetails": {}
8854
+ * // }
8855
+ * },
8856
+ * });
8857
+ * console.log(res.data);
8858
+ *
8859
+ * // Example response
8860
+ * // {
8861
+ * // "done": false,
8862
+ * // "error": {},
8863
+ * // "metadata": {},
8864
+ * // "name": "my_name",
8865
+ * // "response": {}
8866
+ * // }
8867
+ * }
8868
+ *
8869
+ * main().catch(e => {
8870
+ * console.error(e);
8871
+ * throw e;
8872
+ * });
8873
+ *
8874
+ * ```
6502
8875
  *
6503
8876
  * @param params - Parameters for request
6504
8877
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6588,6 +8961,64 @@ export namespace vmmigration_v1 {
6588
8961
 
6589
8962
  /**
6590
8963
  * Pauses a migration for a VM. If cycle tasks are running they will be cancelled, preserving source task data. Further replication cycles will not be triggered while the VM is paused.
8964
+ * @example
8965
+ * ```js
8966
+ * // Before running the sample:
8967
+ * // - Enable the API at:
8968
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
8969
+ * // - Login into gcloud by running:
8970
+ * // ```sh
8971
+ * // $ gcloud auth application-default login
8972
+ * // ```
8973
+ * // - Install the npm module by running:
8974
+ * // ```sh
8975
+ * // $ npm install googleapis
8976
+ * // ```
8977
+ *
8978
+ * const {google} = require('googleapis');
8979
+ * const vmmigration = google.vmmigration('v1');
8980
+ *
8981
+ * async function main() {
8982
+ * const auth = new google.auth.GoogleAuth({
8983
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
8984
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
8985
+ * });
8986
+ *
8987
+ * // Acquire an auth client, and bind it to all future calls
8988
+ * const authClient = await auth.getClient();
8989
+ * google.options({auth: authClient});
8990
+ *
8991
+ * // Do the magic
8992
+ * const res =
8993
+ * await vmmigration.projects.locations.sources.migratingVms.pauseMigration({
8994
+ * // Required. The name of the MigratingVm.
8995
+ * migratingVm:
8996
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
8997
+ *
8998
+ * // Request body metadata
8999
+ * requestBody: {
9000
+ * // request body parameters
9001
+ * // {}
9002
+ * },
9003
+ * });
9004
+ * console.log(res.data);
9005
+ *
9006
+ * // Example response
9007
+ * // {
9008
+ * // "done": false,
9009
+ * // "error": {},
9010
+ * // "metadata": {},
9011
+ * // "name": "my_name",
9012
+ * // "response": {}
9013
+ * // }
9014
+ * }
9015
+ *
9016
+ * main().catch(e => {
9017
+ * console.error(e);
9018
+ * throw e;
9019
+ * });
9020
+ *
9021
+ * ```
6591
9022
  *
6592
9023
  * @param params - Parameters for request
6593
9024
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6680,6 +9111,64 @@ export namespace vmmigration_v1 {
6680
9111
 
6681
9112
  /**
6682
9113
  * Resumes a migration for a VM. When called on a paused migration, will start the process of uploading data and creating snapshots; when called on a completed cut-over migration, will update the migration to active state and start the process of uploading data and creating snapshots.
9114
+ * @example
9115
+ * ```js
9116
+ * // Before running the sample:
9117
+ * // - Enable the API at:
9118
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
9119
+ * // - Login into gcloud by running:
9120
+ * // ```sh
9121
+ * // $ gcloud auth application-default login
9122
+ * // ```
9123
+ * // - Install the npm module by running:
9124
+ * // ```sh
9125
+ * // $ npm install googleapis
9126
+ * // ```
9127
+ *
9128
+ * const {google} = require('googleapis');
9129
+ * const vmmigration = google.vmmigration('v1');
9130
+ *
9131
+ * async function main() {
9132
+ * const auth = new google.auth.GoogleAuth({
9133
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
9134
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
9135
+ * });
9136
+ *
9137
+ * // Acquire an auth client, and bind it to all future calls
9138
+ * const authClient = await auth.getClient();
9139
+ * google.options({auth: authClient});
9140
+ *
9141
+ * // Do the magic
9142
+ * const res =
9143
+ * await vmmigration.projects.locations.sources.migratingVms.resumeMigration({
9144
+ * // Required. The name of the MigratingVm.
9145
+ * migratingVm:
9146
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
9147
+ *
9148
+ * // Request body metadata
9149
+ * requestBody: {
9150
+ * // request body parameters
9151
+ * // {}
9152
+ * },
9153
+ * });
9154
+ * console.log(res.data);
9155
+ *
9156
+ * // Example response
9157
+ * // {
9158
+ * // "done": false,
9159
+ * // "error": {},
9160
+ * // "metadata": {},
9161
+ * // "name": "my_name",
9162
+ * // "response": {}
9163
+ * // }
9164
+ * }
9165
+ *
9166
+ * main().catch(e => {
9167
+ * console.error(e);
9168
+ * throw e;
9169
+ * });
9170
+ *
9171
+ * ```
6683
9172
  *
6684
9173
  * @param params - Parameters for request
6685
9174
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6772,6 +9261,64 @@ export namespace vmmigration_v1 {
6772
9261
 
6773
9262
  /**
6774
9263
  * Starts migration for a VM. Starts the process of uploading data and creating snapshots, in replication cycles scheduled by the policy.
9264
+ * @example
9265
+ * ```js
9266
+ * // Before running the sample:
9267
+ * // - Enable the API at:
9268
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
9269
+ * // - Login into gcloud by running:
9270
+ * // ```sh
9271
+ * // $ gcloud auth application-default login
9272
+ * // ```
9273
+ * // - Install the npm module by running:
9274
+ * // ```sh
9275
+ * // $ npm install googleapis
9276
+ * // ```
9277
+ *
9278
+ * const {google} = require('googleapis');
9279
+ * const vmmigration = google.vmmigration('v1');
9280
+ *
9281
+ * async function main() {
9282
+ * const auth = new google.auth.GoogleAuth({
9283
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
9284
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
9285
+ * });
9286
+ *
9287
+ * // Acquire an auth client, and bind it to all future calls
9288
+ * const authClient = await auth.getClient();
9289
+ * google.options({auth: authClient});
9290
+ *
9291
+ * // Do the magic
9292
+ * const res =
9293
+ * await vmmigration.projects.locations.sources.migratingVms.startMigration({
9294
+ * // Required. The name of the MigratingVm.
9295
+ * migratingVm:
9296
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
9297
+ *
9298
+ * // Request body metadata
9299
+ * requestBody: {
9300
+ * // request body parameters
9301
+ * // {}
9302
+ * },
9303
+ * });
9304
+ * console.log(res.data);
9305
+ *
9306
+ * // Example response
9307
+ * // {
9308
+ * // "done": false,
9309
+ * // "error": {},
9310
+ * // "metadata": {},
9311
+ * // "name": "my_name",
9312
+ * // "response": {}
9313
+ * // }
9314
+ * }
9315
+ *
9316
+ * main().catch(e => {
9317
+ * console.error(e);
9318
+ * throw e;
9319
+ * });
9320
+ *
9321
+ * ```
6775
9322
  *
6776
9323
  * @param params - Parameters for request
6777
9324
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -6890,6 +9437,18 @@ export namespace vmmigration_v1 {
6890
9437
  */
6891
9438
  name?: string;
6892
9439
  }
9440
+ export interface Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration
9441
+ extends StandardParameters {
9442
+ /**
9443
+ * Required. The name of the MigratingVm.
9444
+ */
9445
+ migratingVm?: string;
9446
+
9447
+ /**
9448
+ * Request body metadata
9449
+ */
9450
+ requestBody?: Schema$ExtendMigrationRequest;
9451
+ }
6893
9452
  export interface Params$Resource$Projects$Locations$Sources$Migratingvms$Finalizemigration
6894
9453
  extends StandardParameters {
6895
9454
  /**
@@ -7005,6 +9564,63 @@ export namespace vmmigration_v1 {
7005
9564
 
7006
9565
  /**
7007
9566
  * Initiates the cancellation of a running clone job.
9567
+ * @example
9568
+ * ```js
9569
+ * // Before running the sample:
9570
+ * // - Enable the API at:
9571
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
9572
+ * // - Login into gcloud by running:
9573
+ * // ```sh
9574
+ * // $ gcloud auth application-default login
9575
+ * // ```
9576
+ * // - Install the npm module by running:
9577
+ * // ```sh
9578
+ * // $ npm install googleapis
9579
+ * // ```
9580
+ *
9581
+ * const {google} = require('googleapis');
9582
+ * const vmmigration = google.vmmigration('v1');
9583
+ *
9584
+ * async function main() {
9585
+ * const auth = new google.auth.GoogleAuth({
9586
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
9587
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
9588
+ * });
9589
+ *
9590
+ * // Acquire an auth client, and bind it to all future calls
9591
+ * const authClient = await auth.getClient();
9592
+ * google.options({auth: authClient});
9593
+ *
9594
+ * // Do the magic
9595
+ * const res =
9596
+ * await vmmigration.projects.locations.sources.migratingVms.cloneJobs.cancel({
9597
+ * // Required. The clone job id
9598
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm/cloneJobs/my-cloneJob',
9599
+ *
9600
+ * // Request body metadata
9601
+ * requestBody: {
9602
+ * // request body parameters
9603
+ * // {}
9604
+ * },
9605
+ * });
9606
+ * console.log(res.data);
9607
+ *
9608
+ * // Example response
9609
+ * // {
9610
+ * // "done": false,
9611
+ * // "error": {},
9612
+ * // "metadata": {},
9613
+ * // "name": "my_name",
9614
+ * // "response": {}
9615
+ * // }
9616
+ * }
9617
+ *
9618
+ * main().catch(e => {
9619
+ * console.error(e);
9620
+ * throw e;
9621
+ * });
9622
+ *
9623
+ * ```
7008
9624
  *
7009
9625
  * @param params - Parameters for request
7010
9626
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -7094,6 +9710,78 @@ export namespace vmmigration_v1 {
7094
9710
 
7095
9711
  /**
7096
9712
  * Initiates a Clone of a specific migrating VM.
9713
+ * @example
9714
+ * ```js
9715
+ * // Before running the sample:
9716
+ * // - Enable the API at:
9717
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
9718
+ * // - Login into gcloud by running:
9719
+ * // ```sh
9720
+ * // $ gcloud auth application-default login
9721
+ * // ```
9722
+ * // - Install the npm module by running:
9723
+ * // ```sh
9724
+ * // $ npm install googleapis
9725
+ * // ```
9726
+ *
9727
+ * const {google} = require('googleapis');
9728
+ * const vmmigration = google.vmmigration('v1');
9729
+ *
9730
+ * async function main() {
9731
+ * const auth = new google.auth.GoogleAuth({
9732
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
9733
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
9734
+ * });
9735
+ *
9736
+ * // Acquire an auth client, and bind it to all future calls
9737
+ * const authClient = await auth.getClient();
9738
+ * google.options({auth: authClient});
9739
+ *
9740
+ * // Do the magic
9741
+ * const res =
9742
+ * await vmmigration.projects.locations.sources.migratingVms.cloneJobs.create({
9743
+ * // Required. The clone job identifier.
9744
+ * cloneJobId: 'placeholder-value',
9745
+ * // Required. The Clone's parent.
9746
+ * parent:
9747
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
9748
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
9749
+ * requestId: 'placeholder-value',
9750
+ *
9751
+ * // Request body metadata
9752
+ * requestBody: {
9753
+ * // request body parameters
9754
+ * // {
9755
+ * // "computeEngineDisksTargetDetails": {},
9756
+ * // "computeEngineTargetDetails": {},
9757
+ * // "createTime": "my_createTime",
9758
+ * // "endTime": "my_endTime",
9759
+ * // "error": {},
9760
+ * // "name": "my_name",
9761
+ * // "state": "my_state",
9762
+ * // "stateTime": "my_stateTime",
9763
+ * // "steps": []
9764
+ * // }
9765
+ * },
9766
+ * });
9767
+ * console.log(res.data);
9768
+ *
9769
+ * // Example response
9770
+ * // {
9771
+ * // "done": false,
9772
+ * // "error": {},
9773
+ * // "metadata": {},
9774
+ * // "name": "my_name",
9775
+ * // "response": {}
9776
+ * // }
9777
+ * }
9778
+ *
9779
+ * main().catch(e => {
9780
+ * console.error(e);
9781
+ * throw e;
9782
+ * });
9783
+ *
9784
+ * ```
7097
9785
  *
7098
9786
  * @param params - Parameters for request
7099
9787
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -7186,6 +9874,61 @@ export namespace vmmigration_v1 {
7186
9874
 
7187
9875
  /**
7188
9876
  * Gets details of a single CloneJob.
9877
+ * @example
9878
+ * ```js
9879
+ * // Before running the sample:
9880
+ * // - Enable the API at:
9881
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
9882
+ * // - Login into gcloud by running:
9883
+ * // ```sh
9884
+ * // $ gcloud auth application-default login
9885
+ * // ```
9886
+ * // - Install the npm module by running:
9887
+ * // ```sh
9888
+ * // $ npm install googleapis
9889
+ * // ```
9890
+ *
9891
+ * const {google} = require('googleapis');
9892
+ * const vmmigration = google.vmmigration('v1');
9893
+ *
9894
+ * async function main() {
9895
+ * const auth = new google.auth.GoogleAuth({
9896
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
9897
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
9898
+ * });
9899
+ *
9900
+ * // Acquire an auth client, and bind it to all future calls
9901
+ * const authClient = await auth.getClient();
9902
+ * google.options({auth: authClient});
9903
+ *
9904
+ * // Do the magic
9905
+ * const res =
9906
+ * await vmmigration.projects.locations.sources.migratingVms.cloneJobs.get({
9907
+ * // Required. The name of the CloneJob.
9908
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm/cloneJobs/my-cloneJob',
9909
+ * });
9910
+ * console.log(res.data);
9911
+ *
9912
+ * // Example response
9913
+ * // {
9914
+ * // "computeEngineDisksTargetDetails": {},
9915
+ * // "computeEngineTargetDetails": {},
9916
+ * // "createTime": "my_createTime",
9917
+ * // "endTime": "my_endTime",
9918
+ * // "error": {},
9919
+ * // "name": "my_name",
9920
+ * // "state": "my_state",
9921
+ * // "stateTime": "my_stateTime",
9922
+ * // "steps": []
9923
+ * // }
9924
+ * }
9925
+ *
9926
+ * main().catch(e => {
9927
+ * console.error(e);
9928
+ * throw e;
9929
+ * });
9930
+ *
9931
+ * ```
7189
9932
  *
7190
9933
  * @param params - Parameters for request
7191
9934
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -7275,6 +10018,64 @@ export namespace vmmigration_v1 {
7275
10018
 
7276
10019
  /**
7277
10020
  * Lists the CloneJobs of a migrating VM. Only 25 most recent CloneJobs are listed.
10021
+ * @example
10022
+ * ```js
10023
+ * // Before running the sample:
10024
+ * // - Enable the API at:
10025
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
10026
+ * // - Login into gcloud by running:
10027
+ * // ```sh
10028
+ * // $ gcloud auth application-default login
10029
+ * // ```
10030
+ * // - Install the npm module by running:
10031
+ * // ```sh
10032
+ * // $ npm install googleapis
10033
+ * // ```
10034
+ *
10035
+ * const {google} = require('googleapis');
10036
+ * const vmmigration = google.vmmigration('v1');
10037
+ *
10038
+ * async function main() {
10039
+ * const auth = new google.auth.GoogleAuth({
10040
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
10041
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
10042
+ * });
10043
+ *
10044
+ * // Acquire an auth client, and bind it to all future calls
10045
+ * const authClient = await auth.getClient();
10046
+ * google.options({auth: authClient});
10047
+ *
10048
+ * // Do the magic
10049
+ * const res =
10050
+ * await vmmigration.projects.locations.sources.migratingVms.cloneJobs.list({
10051
+ * // Optional. The filter request.
10052
+ * filter: 'placeholder-value',
10053
+ * // Optional. the order by fields for the result.
10054
+ * orderBy: 'placeholder-value',
10055
+ * // Optional. The maximum number of clone jobs to return. The service may return fewer than this value. If unspecified, at most 500 clone jobs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
10056
+ * pageSize: 'placeholder-value',
10057
+ * // Required. A page token, received from a previous `ListCloneJobs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCloneJobs` must match the call that provided the page token.
10058
+ * pageToken: 'placeholder-value',
10059
+ * // Required. The parent, which owns this collection of source VMs.
10060
+ * parent:
10061
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
10062
+ * });
10063
+ * console.log(res.data);
10064
+ *
10065
+ * // Example response
10066
+ * // {
10067
+ * // "cloneJobs": [],
10068
+ * // "nextPageToken": "my_nextPageToken",
10069
+ * // "unreachable": []
10070
+ * // }
10071
+ * }
10072
+ *
10073
+ * main().catch(e => {
10074
+ * console.error(e);
10075
+ * throw e;
10076
+ * });
10077
+ *
10078
+ * ```
7278
10079
  *
7279
10080
  * @param params - Parameters for request
7280
10081
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -7439,6 +10240,65 @@ export namespace vmmigration_v1 {
7439
10240
 
7440
10241
  /**
7441
10242
  * Initiates the cancellation of a running cutover job.
10243
+ * @example
10244
+ * ```js
10245
+ * // Before running the sample:
10246
+ * // - Enable the API at:
10247
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
10248
+ * // - Login into gcloud by running:
10249
+ * // ```sh
10250
+ * // $ gcloud auth application-default login
10251
+ * // ```
10252
+ * // - Install the npm module by running:
10253
+ * // ```sh
10254
+ * // $ npm install googleapis
10255
+ * // ```
10256
+ *
10257
+ * const {google} = require('googleapis');
10258
+ * const vmmigration = google.vmmigration('v1');
10259
+ *
10260
+ * async function main() {
10261
+ * const auth = new google.auth.GoogleAuth({
10262
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
10263
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
10264
+ * });
10265
+ *
10266
+ * // Acquire an auth client, and bind it to all future calls
10267
+ * const authClient = await auth.getClient();
10268
+ * google.options({auth: authClient});
10269
+ *
10270
+ * // Do the magic
10271
+ * const res =
10272
+ * await vmmigration.projects.locations.sources.migratingVms.cutoverJobs.cancel(
10273
+ * {
10274
+ * // Required. The cutover job id
10275
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm/cutoverJobs/my-cutoverJob',
10276
+ *
10277
+ * // Request body metadata
10278
+ * requestBody: {
10279
+ * // request body parameters
10280
+ * // {}
10281
+ * },
10282
+ * },
10283
+ * );
10284
+ * console.log(res.data);
10285
+ *
10286
+ * // Example response
10287
+ * // {
10288
+ * // "done": false,
10289
+ * // "error": {},
10290
+ * // "metadata": {},
10291
+ * // "name": "my_name",
10292
+ * // "response": {}
10293
+ * // }
10294
+ * }
10295
+ *
10296
+ * main().catch(e => {
10297
+ * console.error(e);
10298
+ * throw e;
10299
+ * });
10300
+ *
10301
+ * ```
7442
10302
  *
7443
10303
  * @param params - Parameters for request
7444
10304
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -7528,6 +10388,82 @@ export namespace vmmigration_v1 {
7528
10388
 
7529
10389
  /**
7530
10390
  * Initiates a Cutover of a specific migrating VM. The returned LRO is completed when the cutover job resource is created and the job is initiated.
10391
+ * @example
10392
+ * ```js
10393
+ * // Before running the sample:
10394
+ * // - Enable the API at:
10395
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
10396
+ * // - Login into gcloud by running:
10397
+ * // ```sh
10398
+ * // $ gcloud auth application-default login
10399
+ * // ```
10400
+ * // - Install the npm module by running:
10401
+ * // ```sh
10402
+ * // $ npm install googleapis
10403
+ * // ```
10404
+ *
10405
+ * const {google} = require('googleapis');
10406
+ * const vmmigration = google.vmmigration('v1');
10407
+ *
10408
+ * async function main() {
10409
+ * const auth = new google.auth.GoogleAuth({
10410
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
10411
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
10412
+ * });
10413
+ *
10414
+ * // Acquire an auth client, and bind it to all future calls
10415
+ * const authClient = await auth.getClient();
10416
+ * google.options({auth: authClient});
10417
+ *
10418
+ * // Do the magic
10419
+ * const res =
10420
+ * await vmmigration.projects.locations.sources.migratingVms.cutoverJobs.create(
10421
+ * {
10422
+ * // Required. The cutover job identifier.
10423
+ * cutoverJobId: 'placeholder-value',
10424
+ * // Required. The Cutover's parent.
10425
+ * parent:
10426
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
10427
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
10428
+ * requestId: 'placeholder-value',
10429
+ *
10430
+ * // Request body metadata
10431
+ * requestBody: {
10432
+ * // request body parameters
10433
+ * // {
10434
+ * // "computeEngineDisksTargetDetails": {},
10435
+ * // "computeEngineTargetDetails": {},
10436
+ * // "createTime": "my_createTime",
10437
+ * // "endTime": "my_endTime",
10438
+ * // "error": {},
10439
+ * // "name": "my_name",
10440
+ * // "progressPercent": 0,
10441
+ * // "state": "my_state",
10442
+ * // "stateMessage": "my_stateMessage",
10443
+ * // "stateTime": "my_stateTime",
10444
+ * // "steps": []
10445
+ * // }
10446
+ * },
10447
+ * },
10448
+ * );
10449
+ * console.log(res.data);
10450
+ *
10451
+ * // Example response
10452
+ * // {
10453
+ * // "done": false,
10454
+ * // "error": {},
10455
+ * // "metadata": {},
10456
+ * // "name": "my_name",
10457
+ * // "response": {}
10458
+ * // }
10459
+ * }
10460
+ *
10461
+ * main().catch(e => {
10462
+ * console.error(e);
10463
+ * throw e;
10464
+ * });
10465
+ *
10466
+ * ```
7531
10467
  *
7532
10468
  * @param params - Parameters for request
7533
10469
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -7620,6 +10556,63 @@ export namespace vmmigration_v1 {
7620
10556
 
7621
10557
  /**
7622
10558
  * Gets details of a single CutoverJob.
10559
+ * @example
10560
+ * ```js
10561
+ * // Before running the sample:
10562
+ * // - Enable the API at:
10563
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
10564
+ * // - Login into gcloud by running:
10565
+ * // ```sh
10566
+ * // $ gcloud auth application-default login
10567
+ * // ```
10568
+ * // - Install the npm module by running:
10569
+ * // ```sh
10570
+ * // $ npm install googleapis
10571
+ * // ```
10572
+ *
10573
+ * const {google} = require('googleapis');
10574
+ * const vmmigration = google.vmmigration('v1');
10575
+ *
10576
+ * async function main() {
10577
+ * const auth = new google.auth.GoogleAuth({
10578
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
10579
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
10580
+ * });
10581
+ *
10582
+ * // Acquire an auth client, and bind it to all future calls
10583
+ * const authClient = await auth.getClient();
10584
+ * google.options({auth: authClient});
10585
+ *
10586
+ * // Do the magic
10587
+ * const res =
10588
+ * await vmmigration.projects.locations.sources.migratingVms.cutoverJobs.get({
10589
+ * // Required. The name of the CutoverJob.
10590
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm/cutoverJobs/my-cutoverJob',
10591
+ * });
10592
+ * console.log(res.data);
10593
+ *
10594
+ * // Example response
10595
+ * // {
10596
+ * // "computeEngineDisksTargetDetails": {},
10597
+ * // "computeEngineTargetDetails": {},
10598
+ * // "createTime": "my_createTime",
10599
+ * // "endTime": "my_endTime",
10600
+ * // "error": {},
10601
+ * // "name": "my_name",
10602
+ * // "progressPercent": 0,
10603
+ * // "state": "my_state",
10604
+ * // "stateMessage": "my_stateMessage",
10605
+ * // "stateTime": "my_stateTime",
10606
+ * // "steps": []
10607
+ * // }
10608
+ * }
10609
+ *
10610
+ * main().catch(e => {
10611
+ * console.error(e);
10612
+ * throw e;
10613
+ * });
10614
+ *
10615
+ * ```
7623
10616
  *
7624
10617
  * @param params - Parameters for request
7625
10618
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -7709,6 +10702,64 @@ export namespace vmmigration_v1 {
7709
10702
 
7710
10703
  /**
7711
10704
  * Lists the CutoverJobs of a migrating VM. Only 25 most recent CutoverJobs are listed.
10705
+ * @example
10706
+ * ```js
10707
+ * // Before running the sample:
10708
+ * // - Enable the API at:
10709
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
10710
+ * // - Login into gcloud by running:
10711
+ * // ```sh
10712
+ * // $ gcloud auth application-default login
10713
+ * // ```
10714
+ * // - Install the npm module by running:
10715
+ * // ```sh
10716
+ * // $ npm install googleapis
10717
+ * // ```
10718
+ *
10719
+ * const {google} = require('googleapis');
10720
+ * const vmmigration = google.vmmigration('v1');
10721
+ *
10722
+ * async function main() {
10723
+ * const auth = new google.auth.GoogleAuth({
10724
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
10725
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
10726
+ * });
10727
+ *
10728
+ * // Acquire an auth client, and bind it to all future calls
10729
+ * const authClient = await auth.getClient();
10730
+ * google.options({auth: authClient});
10731
+ *
10732
+ * // Do the magic
10733
+ * const res =
10734
+ * await vmmigration.projects.locations.sources.migratingVms.cutoverJobs.list({
10735
+ * // Optional. The filter request.
10736
+ * filter: 'placeholder-value',
10737
+ * // Optional. the order by fields for the result.
10738
+ * orderBy: 'placeholder-value',
10739
+ * // Optional. The maximum number of cutover jobs to return. The service may return fewer than this value. If unspecified, at most 500 cutover jobs will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
10740
+ * pageSize: 'placeholder-value',
10741
+ * // Required. A page token, received from a previous `ListCutoverJobs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCutoverJobs` must match the call that provided the page token.
10742
+ * pageToken: 'placeholder-value',
10743
+ * // Required. The parent, which owns this collection of migrating VMs.
10744
+ * parent:
10745
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
10746
+ * });
10747
+ * console.log(res.data);
10748
+ *
10749
+ * // Example response
10750
+ * // {
10751
+ * // "cutoverJobs": [],
10752
+ * // "nextPageToken": "my_nextPageToken",
10753
+ * // "unreachable": []
10754
+ * // }
10755
+ * }
10756
+ *
10757
+ * main().catch(e => {
10758
+ * console.error(e);
10759
+ * throw e;
10760
+ * });
10761
+ *
10762
+ * ```
7712
10763
  *
7713
10764
  * @param params - Parameters for request
7714
10765
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -7873,6 +10924,64 @@ export namespace vmmigration_v1 {
7873
10924
 
7874
10925
  /**
7875
10926
  * Gets details of a single ReplicationCycle.
10927
+ * @example
10928
+ * ```js
10929
+ * // Before running the sample:
10930
+ * // - Enable the API at:
10931
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
10932
+ * // - Login into gcloud by running:
10933
+ * // ```sh
10934
+ * // $ gcloud auth application-default login
10935
+ * // ```
10936
+ * // - Install the npm module by running:
10937
+ * // ```sh
10938
+ * // $ npm install googleapis
10939
+ * // ```
10940
+ *
10941
+ * const {google} = require('googleapis');
10942
+ * const vmmigration = google.vmmigration('v1');
10943
+ *
10944
+ * async function main() {
10945
+ * const auth = new google.auth.GoogleAuth({
10946
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
10947
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
10948
+ * });
10949
+ *
10950
+ * // Acquire an auth client, and bind it to all future calls
10951
+ * const authClient = await auth.getClient();
10952
+ * google.options({auth: authClient});
10953
+ *
10954
+ * // Do the magic
10955
+ * const res =
10956
+ * await vmmigration.projects.locations.sources.migratingVms.replicationCycles.get(
10957
+ * {
10958
+ * // Required. The name of the ReplicationCycle.
10959
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm/replicationCycles/my-replicationCycle',
10960
+ * },
10961
+ * );
10962
+ * console.log(res.data);
10963
+ *
10964
+ * // Example response
10965
+ * // {
10966
+ * // "cycleNumber": 0,
10967
+ * // "endTime": "my_endTime",
10968
+ * // "error": {},
10969
+ * // "name": "my_name",
10970
+ * // "progressPercent": 0,
10971
+ * // "startTime": "my_startTime",
10972
+ * // "state": "my_state",
10973
+ * // "steps": [],
10974
+ * // "totalPauseDuration": "my_totalPauseDuration",
10975
+ * // "warnings": []
10976
+ * // }
10977
+ * }
10978
+ *
10979
+ * main().catch(e => {
10980
+ * console.error(e);
10981
+ * throw e;
10982
+ * });
10983
+ *
10984
+ * ```
7876
10985
  *
7877
10986
  * @param params - Parameters for request
7878
10987
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -7962,6 +11071,66 @@ export namespace vmmigration_v1 {
7962
11071
 
7963
11072
  /**
7964
11073
  * Lists ReplicationCycles in a given MigratingVM.
11074
+ * @example
11075
+ * ```js
11076
+ * // Before running the sample:
11077
+ * // - Enable the API at:
11078
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
11079
+ * // - Login into gcloud by running:
11080
+ * // ```sh
11081
+ * // $ gcloud auth application-default login
11082
+ * // ```
11083
+ * // - Install the npm module by running:
11084
+ * // ```sh
11085
+ * // $ npm install googleapis
11086
+ * // ```
11087
+ *
11088
+ * const {google} = require('googleapis');
11089
+ * const vmmigration = google.vmmigration('v1');
11090
+ *
11091
+ * async function main() {
11092
+ * const auth = new google.auth.GoogleAuth({
11093
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
11094
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
11095
+ * });
11096
+ *
11097
+ * // Acquire an auth client, and bind it to all future calls
11098
+ * const authClient = await auth.getClient();
11099
+ * google.options({auth: authClient});
11100
+ *
11101
+ * // Do the magic
11102
+ * const res =
11103
+ * await vmmigration.projects.locations.sources.migratingVms.replicationCycles.list(
11104
+ * {
11105
+ * // Optional. The filter request.
11106
+ * filter: 'placeholder-value',
11107
+ * // Optional. the order by fields for the result.
11108
+ * orderBy: 'placeholder-value',
11109
+ * // Optional. The maximum number of replication cycles to return. The service may return fewer than this value. If unspecified, at most 100 migrating VMs will be returned. The maximum value is 100; values above 100 will be coerced to 100.
11110
+ * pageSize: 'placeholder-value',
11111
+ * // Required. A page token, received from a previous `ListReplicationCycles` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReplicationCycles` must match the call that provided the page token.
11112
+ * pageToken: 'placeholder-value',
11113
+ * // Required. The parent, which owns this collection of ReplicationCycles.
11114
+ * parent:
11115
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
11116
+ * },
11117
+ * );
11118
+ * console.log(res.data);
11119
+ *
11120
+ * // Example response
11121
+ * // {
11122
+ * // "nextPageToken": "my_nextPageToken",
11123
+ * // "replicationCycles": [],
11124
+ * // "unreachable": []
11125
+ * // }
11126
+ * }
11127
+ *
11128
+ * main().catch(e => {
11129
+ * console.error(e);
11130
+ * throw e;
11131
+ * });
11132
+ *
11133
+ * ```
7965
11134
  *
7966
11135
  * @param params - Parameters for request
7967
11136
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8098,6 +11267,78 @@ export namespace vmmigration_v1 {
8098
11267
 
8099
11268
  /**
8100
11269
  * Creates a new UtilizationReport.
11270
+ * @example
11271
+ * ```js
11272
+ * // Before running the sample:
11273
+ * // - Enable the API at:
11274
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
11275
+ * // - Login into gcloud by running:
11276
+ * // ```sh
11277
+ * // $ gcloud auth application-default login
11278
+ * // ```
11279
+ * // - Install the npm module by running:
11280
+ * // ```sh
11281
+ * // $ npm install googleapis
11282
+ * // ```
11283
+ *
11284
+ * const {google} = require('googleapis');
11285
+ * const vmmigration = google.vmmigration('v1');
11286
+ *
11287
+ * async function main() {
11288
+ * const auth = new google.auth.GoogleAuth({
11289
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
11290
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
11291
+ * });
11292
+ *
11293
+ * // Acquire an auth client, and bind it to all future calls
11294
+ * const authClient = await auth.getClient();
11295
+ * google.options({auth: authClient});
11296
+ *
11297
+ * // Do the magic
11298
+ * const res =
11299
+ * await vmmigration.projects.locations.sources.utilizationReports.create({
11300
+ * // Required. The Utilization Report's parent.
11301
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
11302
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
11303
+ * requestId: 'placeholder-value',
11304
+ * // Required. The ID to use for the report, which will become the final component of the reports's resource name. This value maximum length is 63 characters, and valid characters are /a-z-/. It must start with an english letter and must not end with a hyphen.
11305
+ * utilizationReportId: 'placeholder-value',
11306
+ *
11307
+ * // Request body metadata
11308
+ * requestBody: {
11309
+ * // request body parameters
11310
+ * // {
11311
+ * // "createTime": "my_createTime",
11312
+ * // "displayName": "my_displayName",
11313
+ * // "error": {},
11314
+ * // "frameEndTime": "my_frameEndTime",
11315
+ * // "name": "my_name",
11316
+ * // "state": "my_state",
11317
+ * // "stateTime": "my_stateTime",
11318
+ * // "timeFrame": "my_timeFrame",
11319
+ * // "vmCount": 0,
11320
+ * // "vms": []
11321
+ * // }
11322
+ * },
11323
+ * });
11324
+ * console.log(res.data);
11325
+ *
11326
+ * // Example response
11327
+ * // {
11328
+ * // "done": false,
11329
+ * // "error": {},
11330
+ * // "metadata": {},
11331
+ * // "name": "my_name",
11332
+ * // "response": {}
11333
+ * // }
11334
+ * }
11335
+ *
11336
+ * main().catch(e => {
11337
+ * console.error(e);
11338
+ * throw e;
11339
+ * });
11340
+ *
11341
+ * ```
8101
11342
  *
8102
11343
  * @param params - Parameters for request
8103
11344
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8190,6 +11431,59 @@ export namespace vmmigration_v1 {
8190
11431
 
8191
11432
  /**
8192
11433
  * Deletes a single Utilization Report.
11434
+ * @example
11435
+ * ```js
11436
+ * // Before running the sample:
11437
+ * // - Enable the API at:
11438
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
11439
+ * // - Login into gcloud by running:
11440
+ * // ```sh
11441
+ * // $ gcloud auth application-default login
11442
+ * // ```
11443
+ * // - Install the npm module by running:
11444
+ * // ```sh
11445
+ * // $ npm install googleapis
11446
+ * // ```
11447
+ *
11448
+ * const {google} = require('googleapis');
11449
+ * const vmmigration = google.vmmigration('v1');
11450
+ *
11451
+ * async function main() {
11452
+ * const auth = new google.auth.GoogleAuth({
11453
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
11454
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
11455
+ * });
11456
+ *
11457
+ * // Acquire an auth client, and bind it to all future calls
11458
+ * const authClient = await auth.getClient();
11459
+ * google.options({auth: authClient});
11460
+ *
11461
+ * // Do the magic
11462
+ * const res =
11463
+ * await vmmigration.projects.locations.sources.utilizationReports.delete({
11464
+ * // Required. The Utilization Report name.
11465
+ * name: 'projects/my-project/locations/my-location/sources/my-source/utilizationReports/my-utilizationReport',
11466
+ * // Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
11467
+ * requestId: 'placeholder-value',
11468
+ * });
11469
+ * console.log(res.data);
11470
+ *
11471
+ * // Example response
11472
+ * // {
11473
+ * // "done": false,
11474
+ * // "error": {},
11475
+ * // "metadata": {},
11476
+ * // "name": "my_name",
11477
+ * // "response": {}
11478
+ * // }
11479
+ * }
11480
+ *
11481
+ * main().catch(e => {
11482
+ * console.error(e);
11483
+ * throw e;
11484
+ * });
11485
+ *
11486
+ * ```
8193
11487
  *
8194
11488
  * @param params - Parameters for request
8195
11489
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8279,6 +11573,64 @@ export namespace vmmigration_v1 {
8279
11573
 
8280
11574
  /**
8281
11575
  * Gets a single Utilization Report.
11576
+ * @example
11577
+ * ```js
11578
+ * // Before running the sample:
11579
+ * // - Enable the API at:
11580
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
11581
+ * // - Login into gcloud by running:
11582
+ * // ```sh
11583
+ * // $ gcloud auth application-default login
11584
+ * // ```
11585
+ * // - Install the npm module by running:
11586
+ * // ```sh
11587
+ * // $ npm install googleapis
11588
+ * // ```
11589
+ *
11590
+ * const {google} = require('googleapis');
11591
+ * const vmmigration = google.vmmigration('v1');
11592
+ *
11593
+ * async function main() {
11594
+ * const auth = new google.auth.GoogleAuth({
11595
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
11596
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
11597
+ * });
11598
+ *
11599
+ * // Acquire an auth client, and bind it to all future calls
11600
+ * const authClient = await auth.getClient();
11601
+ * google.options({auth: authClient});
11602
+ *
11603
+ * // Do the magic
11604
+ * const res =
11605
+ * await vmmigration.projects.locations.sources.utilizationReports.get({
11606
+ * // Required. The Utilization Report name.
11607
+ * name: 'projects/my-project/locations/my-location/sources/my-source/utilizationReports/my-utilizationReport',
11608
+ * // Optional. The level of details of the report. Defaults to FULL
11609
+ * view: 'placeholder-value',
11610
+ * });
11611
+ * console.log(res.data);
11612
+ *
11613
+ * // Example response
11614
+ * // {
11615
+ * // "createTime": "my_createTime",
11616
+ * // "displayName": "my_displayName",
11617
+ * // "error": {},
11618
+ * // "frameEndTime": "my_frameEndTime",
11619
+ * // "name": "my_name",
11620
+ * // "state": "my_state",
11621
+ * // "stateTime": "my_stateTime",
11622
+ * // "timeFrame": "my_timeFrame",
11623
+ * // "vmCount": 0,
11624
+ * // "vms": []
11625
+ * // }
11626
+ * }
11627
+ *
11628
+ * main().catch(e => {
11629
+ * console.error(e);
11630
+ * throw e;
11631
+ * });
11632
+ *
11633
+ * ```
8282
11634
  *
8283
11635
  * @param params - Parameters for request
8284
11636
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8368,6 +11720,65 @@ export namespace vmmigration_v1 {
8368
11720
 
8369
11721
  /**
8370
11722
  * Lists Utilization Reports of the given Source.
11723
+ * @example
11724
+ * ```js
11725
+ * // Before running the sample:
11726
+ * // - Enable the API at:
11727
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
11728
+ * // - Login into gcloud by running:
11729
+ * // ```sh
11730
+ * // $ gcloud auth application-default login
11731
+ * // ```
11732
+ * // - Install the npm module by running:
11733
+ * // ```sh
11734
+ * // $ npm install googleapis
11735
+ * // ```
11736
+ *
11737
+ * const {google} = require('googleapis');
11738
+ * const vmmigration = google.vmmigration('v1');
11739
+ *
11740
+ * async function main() {
11741
+ * const auth = new google.auth.GoogleAuth({
11742
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
11743
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
11744
+ * });
11745
+ *
11746
+ * // Acquire an auth client, and bind it to all future calls
11747
+ * const authClient = await auth.getClient();
11748
+ * google.options({auth: authClient});
11749
+ *
11750
+ * // Do the magic
11751
+ * const res =
11752
+ * await vmmigration.projects.locations.sources.utilizationReports.list({
11753
+ * // Optional. The filter request.
11754
+ * filter: 'placeholder-value',
11755
+ * // Optional. the order by fields for the result.
11756
+ * orderBy: 'placeholder-value',
11757
+ * // Optional. The maximum number of reports to return. The service may return fewer than this value. If unspecified, at most 500 reports will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
11758
+ * pageSize: 'placeholder-value',
11759
+ * // Required. A page token, received from a previous `ListUtilizationReports` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUtilizationReports` must match the call that provided the page token.
11760
+ * pageToken: 'placeholder-value',
11761
+ * // Required. The Utilization Reports parent.
11762
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
11763
+ * // Optional. The level of details of each report. Defaults to BASIC.
11764
+ * view: 'placeholder-value',
11765
+ * });
11766
+ * console.log(res.data);
11767
+ *
11768
+ * // Example response
11769
+ * // {
11770
+ * // "nextPageToken": "my_nextPageToken",
11771
+ * // "unreachable": [],
11772
+ * // "utilizationReports": []
11773
+ * // }
11774
+ * }
11775
+ *
11776
+ * main().catch(e => {
11777
+ * console.error(e);
11778
+ * throw e;
11779
+ * });
11780
+ *
11781
+ * ```
8371
11782
  *
8372
11783
  * @param params - Parameters for request
8373
11784
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8543,6 +11954,72 @@ export namespace vmmigration_v1 {
8543
11954
 
8544
11955
  /**
8545
11956
  * Creates a new TargetProject in a given project. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.
11957
+ * @example
11958
+ * ```js
11959
+ * // Before running the sample:
11960
+ * // - Enable the API at:
11961
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
11962
+ * // - Login into gcloud by running:
11963
+ * // ```sh
11964
+ * // $ gcloud auth application-default login
11965
+ * // ```
11966
+ * // - Install the npm module by running:
11967
+ * // ```sh
11968
+ * // $ npm install googleapis
11969
+ * // ```
11970
+ *
11971
+ * const {google} = require('googleapis');
11972
+ * const vmmigration = google.vmmigration('v1');
11973
+ *
11974
+ * async function main() {
11975
+ * const auth = new google.auth.GoogleAuth({
11976
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
11977
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
11978
+ * });
11979
+ *
11980
+ * // Acquire an auth client, and bind it to all future calls
11981
+ * const authClient = await auth.getClient();
11982
+ * google.options({auth: authClient});
11983
+ *
11984
+ * // Do the magic
11985
+ * const res = await vmmigration.projects.locations.targetProjects.create({
11986
+ * // Required. The TargetProject's parent.
11987
+ * parent: 'projects/my-project/locations/my-location',
11988
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
11989
+ * requestId: 'placeholder-value',
11990
+ * // Required. The target_project identifier.
11991
+ * targetProjectId: 'placeholder-value',
11992
+ *
11993
+ * // Request body metadata
11994
+ * requestBody: {
11995
+ * // request body parameters
11996
+ * // {
11997
+ * // "createTime": "my_createTime",
11998
+ * // "description": "my_description",
11999
+ * // "name": "my_name",
12000
+ * // "project": "my_project",
12001
+ * // "updateTime": "my_updateTime"
12002
+ * // }
12003
+ * },
12004
+ * });
12005
+ * console.log(res.data);
12006
+ *
12007
+ * // Example response
12008
+ * // {
12009
+ * // "done": false,
12010
+ * // "error": {},
12011
+ * // "metadata": {},
12012
+ * // "name": "my_name",
12013
+ * // "response": {}
12014
+ * // }
12015
+ * }
12016
+ *
12017
+ * main().catch(e => {
12018
+ * console.error(e);
12019
+ * throw e;
12020
+ * });
12021
+ *
12022
+ * ```
8546
12023
  *
8547
12024
  * @param params - Parameters for request
8548
12025
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8634,6 +12111,58 @@ export namespace vmmigration_v1 {
8634
12111
 
8635
12112
  /**
8636
12113
  * Deletes a single TargetProject. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.
12114
+ * @example
12115
+ * ```js
12116
+ * // Before running the sample:
12117
+ * // - Enable the API at:
12118
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
12119
+ * // - Login into gcloud by running:
12120
+ * // ```sh
12121
+ * // $ gcloud auth application-default login
12122
+ * // ```
12123
+ * // - Install the npm module by running:
12124
+ * // ```sh
12125
+ * // $ npm install googleapis
12126
+ * // ```
12127
+ *
12128
+ * const {google} = require('googleapis');
12129
+ * const vmmigration = google.vmmigration('v1');
12130
+ *
12131
+ * async function main() {
12132
+ * const auth = new google.auth.GoogleAuth({
12133
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
12134
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
12135
+ * });
12136
+ *
12137
+ * // Acquire an auth client, and bind it to all future calls
12138
+ * const authClient = await auth.getClient();
12139
+ * google.options({auth: authClient});
12140
+ *
12141
+ * // Do the magic
12142
+ * const res = await vmmigration.projects.locations.targetProjects.delete({
12143
+ * // Required. The TargetProject name.
12144
+ * name: 'projects/my-project/locations/my-location/targetProjects/my-targetProject',
12145
+ * // Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
12146
+ * requestId: 'placeholder-value',
12147
+ * });
12148
+ * console.log(res.data);
12149
+ *
12150
+ * // Example response
12151
+ * // {
12152
+ * // "done": false,
12153
+ * // "error": {},
12154
+ * // "metadata": {},
12155
+ * // "name": "my_name",
12156
+ * // "response": {}
12157
+ * // }
12158
+ * }
12159
+ *
12160
+ * main().catch(e => {
12161
+ * console.error(e);
12162
+ * throw e;
12163
+ * });
12164
+ *
12165
+ * ```
8637
12166
  *
8638
12167
  * @param params - Parameters for request
8639
12168
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8722,6 +12251,56 @@ export namespace vmmigration_v1 {
8722
12251
 
8723
12252
  /**
8724
12253
  * Gets details of a single TargetProject. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.
12254
+ * @example
12255
+ * ```js
12256
+ * // Before running the sample:
12257
+ * // - Enable the API at:
12258
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
12259
+ * // - Login into gcloud by running:
12260
+ * // ```sh
12261
+ * // $ gcloud auth application-default login
12262
+ * // ```
12263
+ * // - Install the npm module by running:
12264
+ * // ```sh
12265
+ * // $ npm install googleapis
12266
+ * // ```
12267
+ *
12268
+ * const {google} = require('googleapis');
12269
+ * const vmmigration = google.vmmigration('v1');
12270
+ *
12271
+ * async function main() {
12272
+ * const auth = new google.auth.GoogleAuth({
12273
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
12274
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
12275
+ * });
12276
+ *
12277
+ * // Acquire an auth client, and bind it to all future calls
12278
+ * const authClient = await auth.getClient();
12279
+ * google.options({auth: authClient});
12280
+ *
12281
+ * // Do the magic
12282
+ * const res = await vmmigration.projects.locations.targetProjects.get({
12283
+ * // Required. The TargetProject name.
12284
+ * name: 'projects/my-project/locations/my-location/targetProjects/my-targetProject',
12285
+ * });
12286
+ * console.log(res.data);
12287
+ *
12288
+ * // Example response
12289
+ * // {
12290
+ * // "createTime": "my_createTime",
12291
+ * // "description": "my_description",
12292
+ * // "name": "my_name",
12293
+ * // "project": "my_project",
12294
+ * // "updateTime": "my_updateTime"
12295
+ * // }
12296
+ * }
12297
+ *
12298
+ * main().catch(e => {
12299
+ * console.error(e);
12300
+ * throw e;
12301
+ * });
12302
+ *
12303
+ * ```
8725
12304
  *
8726
12305
  * @param params - Parameters for request
8727
12306
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8810,6 +12389,62 @@ export namespace vmmigration_v1 {
8810
12389
 
8811
12390
  /**
8812
12391
  * Lists TargetProjects in a given project. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.
12392
+ * @example
12393
+ * ```js
12394
+ * // Before running the sample:
12395
+ * // - Enable the API at:
12396
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
12397
+ * // - Login into gcloud by running:
12398
+ * // ```sh
12399
+ * // $ gcloud auth application-default login
12400
+ * // ```
12401
+ * // - Install the npm module by running:
12402
+ * // ```sh
12403
+ * // $ npm install googleapis
12404
+ * // ```
12405
+ *
12406
+ * const {google} = require('googleapis');
12407
+ * const vmmigration = google.vmmigration('v1');
12408
+ *
12409
+ * async function main() {
12410
+ * const auth = new google.auth.GoogleAuth({
12411
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
12412
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
12413
+ * });
12414
+ *
12415
+ * // Acquire an auth client, and bind it to all future calls
12416
+ * const authClient = await auth.getClient();
12417
+ * google.options({auth: authClient});
12418
+ *
12419
+ * // Do the magic
12420
+ * const res = await vmmigration.projects.locations.targetProjects.list({
12421
+ * // Optional. The filter request.
12422
+ * filter: 'placeholder-value',
12423
+ * // Optional. the order by fields for the result.
12424
+ * orderBy: 'placeholder-value',
12425
+ * // Optional. The maximum number of targets to return. The service may return fewer than this value. If unspecified, at most 500 targets will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
12426
+ * pageSize: 'placeholder-value',
12427
+ * // Required. A page token, received from a previous `ListTargets` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListTargets` must match the call that provided the page token.
12428
+ * pageToken: 'placeholder-value',
12429
+ * // Required. The parent, which owns this collection of targets.
12430
+ * parent: 'projects/my-project/locations/my-location',
12431
+ * });
12432
+ * console.log(res.data);
12433
+ *
12434
+ * // Example response
12435
+ * // {
12436
+ * // "nextPageToken": "my_nextPageToken",
12437
+ * // "targetProjects": [],
12438
+ * // "unreachable": []
12439
+ * // }
12440
+ * }
12441
+ *
12442
+ * main().catch(e => {
12443
+ * console.error(e);
12444
+ * throw e;
12445
+ * });
12446
+ *
12447
+ * ```
8813
12448
  *
8814
12449
  * @param params - Parameters for request
8815
12450
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -8905,6 +12540,72 @@ export namespace vmmigration_v1 {
8905
12540
 
8906
12541
  /**
8907
12542
  * Updates the parameters of a single TargetProject. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.
12543
+ * @example
12544
+ * ```js
12545
+ * // Before running the sample:
12546
+ * // - Enable the API at:
12547
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
12548
+ * // - Login into gcloud by running:
12549
+ * // ```sh
12550
+ * // $ gcloud auth application-default login
12551
+ * // ```
12552
+ * // - Install the npm module by running:
12553
+ * // ```sh
12554
+ * // $ npm install googleapis
12555
+ * // ```
12556
+ *
12557
+ * const {google} = require('googleapis');
12558
+ * const vmmigration = google.vmmigration('v1');
12559
+ *
12560
+ * async function main() {
12561
+ * const auth = new google.auth.GoogleAuth({
12562
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
12563
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
12564
+ * });
12565
+ *
12566
+ * // Acquire an auth client, and bind it to all future calls
12567
+ * const authClient = await auth.getClient();
12568
+ * google.options({auth: authClient});
12569
+ *
12570
+ * // Do the magic
12571
+ * const res = await vmmigration.projects.locations.targetProjects.patch({
12572
+ * // Output only. The name of the target project.
12573
+ * name: 'projects/my-project/locations/my-location/targetProjects/my-targetProject',
12574
+ * // A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
12575
+ * requestId: 'placeholder-value',
12576
+ * // Field mask is used to specify the fields to be overwritten in the TargetProject resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the user does not provide a mask then all fields will be overwritten.
12577
+ * updateMask: 'placeholder-value',
12578
+ *
12579
+ * // Request body metadata
12580
+ * requestBody: {
12581
+ * // request body parameters
12582
+ * // {
12583
+ * // "createTime": "my_createTime",
12584
+ * // "description": "my_description",
12585
+ * // "name": "my_name",
12586
+ * // "project": "my_project",
12587
+ * // "updateTime": "my_updateTime"
12588
+ * // }
12589
+ * },
12590
+ * });
12591
+ * console.log(res.data);
12592
+ *
12593
+ * // Example response
12594
+ * // {
12595
+ * // "done": false,
12596
+ * // "error": {},
12597
+ * // "metadata": {},
12598
+ * // "name": "my_name",
12599
+ * // "response": {}
12600
+ * // }
12601
+ * }
12602
+ *
12603
+ * main().catch(e => {
12604
+ * console.error(e);
12605
+ * throw e;
12606
+ * });
12607
+ *
12608
+ * ```
8908
12609
  *
8909
12610
  * @param params - Parameters for request
8910
12611
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.