@googleapis/vmmigration 13.0.1 → 14.1.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/build/v1.d.ts CHANGED
@@ -674,6 +674,10 @@ export declare namespace vmmigration_v1 {
674
674
  * Compute instance scheduling information (if empty default is used).
675
675
  */
676
676
  computeScheduling?: Schema$ComputeScheduling;
677
+ /**
678
+ * 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.
679
+ */
680
+ diskReplicaZones?: string[] | null;
677
681
  /**
678
682
  * The disk type to use in the VM.
679
683
  */
@@ -771,6 +775,10 @@ export declare namespace vmmigration_v1 {
771
775
  * Compute instance scheduling information (if empty default is used).
772
776
  */
773
777
  computeScheduling?: Schema$ComputeScheduling;
778
+ /**
779
+ * 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.
780
+ */
781
+ diskReplicaZones?: string[] | null;
774
782
  /**
775
783
  * The disk type to use in the VM.
776
784
  */
@@ -1231,6 +1239,28 @@ export declare namespace vmmigration_v1 {
1231
1239
  */
1232
1240
  kmsKey?: string | null;
1233
1241
  }
1242
+ /**
1243
+ * Expiration holds information about the expiration of a MigratingVm.
1244
+ */
1245
+ export interface Schema$Expiration {
1246
+ /**
1247
+ * Output only. Timestamp of when this resource is considered expired.
1248
+ */
1249
+ expireTime?: string | null;
1250
+ /**
1251
+ * Output only. Describes whether the expiration can be extended.
1252
+ */
1253
+ extendable?: boolean | null;
1254
+ /**
1255
+ * Output only. The number of times expiration was extended.
1256
+ */
1257
+ extensionCount?: number | null;
1258
+ }
1259
+ /**
1260
+ * Request message for 'ExtendMigrationRequest' request.
1261
+ */
1262
+ export interface Schema$ExtendMigrationRequest {
1263
+ }
1234
1264
  /**
1235
1265
  * Response message for fetchInventory.
1236
1266
  */
@@ -1728,7 +1758,7 @@ export declare namespace vmmigration_v1 {
1728
1758
  */
1729
1759
  description?: string | null;
1730
1760
  /**
1731
- * Immutable. The encryption to apply to the machine image.
1761
+ * 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.
1732
1762
  */
1733
1763
  encryption?: Schema$Encryption;
1734
1764
  /**
@@ -1746,7 +1776,7 @@ export declare namespace vmmigration_v1 {
1746
1776
  */
1747
1777
  machineImageParametersOverrides?: Schema$MachineImageParametersOverrides;
1748
1778
  /**
1749
- * 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.
1779
+ * 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.
1750
1780
  */
1751
1781
  networkInterfaces?: Schema$NetworkInterface[];
1752
1782
  /**
@@ -1822,6 +1852,10 @@ export declare namespace vmmigration_v1 {
1822
1852
  * Output only. Provides details on the state of the Migrating VM in case of an error in replication.
1823
1853
  */
1824
1854
  error?: Schema$Status;
1855
+ /**
1856
+ * Output only. Provides details about the expiration state of the migrating VM.
1857
+ */
1858
+ expiration?: Schema$Expiration;
1825
1859
  /**
1826
1860
  * 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.
1827
1861
  */
@@ -2678,6 +2712,56 @@ export declare namespace vmmigration_v1 {
2678
2712
  constructor(context: APIRequestContext);
2679
2713
  /**
2680
2714
  * Gets information about a location.
2715
+ * @example
2716
+ * ```js
2717
+ * // Before running the sample:
2718
+ * // - Enable the API at:
2719
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
2720
+ * // - Login into gcloud by running:
2721
+ * // ```sh
2722
+ * // $ gcloud auth application-default login
2723
+ * // ```
2724
+ * // - Install the npm module by running:
2725
+ * // ```sh
2726
+ * // $ npm install googleapis
2727
+ * // ```
2728
+ *
2729
+ * const {google} = require('googleapis');
2730
+ * const vmmigration = google.vmmigration('v1');
2731
+ *
2732
+ * async function main() {
2733
+ * const auth = new google.auth.GoogleAuth({
2734
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2735
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2736
+ * });
2737
+ *
2738
+ * // Acquire an auth client, and bind it to all future calls
2739
+ * const authClient = await auth.getClient();
2740
+ * google.options({auth: authClient});
2741
+ *
2742
+ * // Do the magic
2743
+ * const res = await vmmigration.projects.locations.get({
2744
+ * // Resource name for the location.
2745
+ * name: 'projects/my-project/locations/my-location',
2746
+ * });
2747
+ * console.log(res.data);
2748
+ *
2749
+ * // Example response
2750
+ * // {
2751
+ * // "displayName": "my_displayName",
2752
+ * // "labels": {},
2753
+ * // "locationId": "my_locationId",
2754
+ * // "metadata": {},
2755
+ * // "name": "my_name"
2756
+ * // }
2757
+ * }
2758
+ *
2759
+ * main().catch(e => {
2760
+ * console.error(e);
2761
+ * throw e;
2762
+ * });
2763
+ *
2764
+ * ```
2681
2765
  *
2682
2766
  * @param params - Parameters for request
2683
2767
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2692,6 +2776,61 @@ export declare namespace vmmigration_v1 {
2692
2776
  get(callback: BodyResponseCallback<Schema$Location>): void;
2693
2777
  /**
2694
2778
  * Lists information about the supported locations for this service.
2779
+ * @example
2780
+ * ```js
2781
+ * // Before running the sample:
2782
+ * // - Enable the API at:
2783
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
2784
+ * // - Login into gcloud by running:
2785
+ * // ```sh
2786
+ * // $ gcloud auth application-default login
2787
+ * // ```
2788
+ * // - Install the npm module by running:
2789
+ * // ```sh
2790
+ * // $ npm install googleapis
2791
+ * // ```
2792
+ *
2793
+ * const {google} = require('googleapis');
2794
+ * const vmmigration = google.vmmigration('v1');
2795
+ *
2796
+ * async function main() {
2797
+ * const auth = new google.auth.GoogleAuth({
2798
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2799
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2800
+ * });
2801
+ *
2802
+ * // Acquire an auth client, and bind it to all future calls
2803
+ * const authClient = await auth.getClient();
2804
+ * google.options({auth: authClient});
2805
+ *
2806
+ * // Do the magic
2807
+ * const res = await vmmigration.projects.locations.list({
2808
+ * // Optional. A list of extra location types that should be used as conditions for controlling the visibility of the locations.
2809
+ * extraLocationTypes: 'placeholder-value',
2810
+ * // 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).
2811
+ * filter: 'placeholder-value',
2812
+ * // The resource that owns the locations collection, if applicable.
2813
+ * name: 'projects/my-project',
2814
+ * // The maximum number of results to return. If not set, the service selects a default.
2815
+ * pageSize: 'placeholder-value',
2816
+ * // A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.
2817
+ * pageToken: 'placeholder-value',
2818
+ * });
2819
+ * console.log(res.data);
2820
+ *
2821
+ * // Example response
2822
+ * // {
2823
+ * // "locations": [],
2824
+ * // "nextPageToken": "my_nextPageToken"
2825
+ * // }
2826
+ * }
2827
+ *
2828
+ * main().catch(e => {
2829
+ * console.error(e);
2830
+ * throw e;
2831
+ * });
2832
+ *
2833
+ * ```
2695
2834
  *
2696
2835
  * @param params - Parameters for request
2697
2836
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2738,6 +2877,64 @@ export declare namespace vmmigration_v1 {
2738
2877
  constructor(context: APIRequestContext);
2739
2878
  /**
2740
2879
  * Adds a MigratingVm to a Group.
2880
+ * @example
2881
+ * ```js
2882
+ * // Before running the sample:
2883
+ * // - Enable the API at:
2884
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
2885
+ * // - Login into gcloud by running:
2886
+ * // ```sh
2887
+ * // $ gcloud auth application-default login
2888
+ * // ```
2889
+ * // - Install the npm module by running:
2890
+ * // ```sh
2891
+ * // $ npm install googleapis
2892
+ * // ```
2893
+ *
2894
+ * const {google} = require('googleapis');
2895
+ * const vmmigration = google.vmmigration('v1');
2896
+ *
2897
+ * async function main() {
2898
+ * const auth = new google.auth.GoogleAuth({
2899
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2900
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2901
+ * });
2902
+ *
2903
+ * // Acquire an auth client, and bind it to all future calls
2904
+ * const authClient = await auth.getClient();
2905
+ * google.options({auth: authClient});
2906
+ *
2907
+ * // Do the magic
2908
+ * const res = await vmmigration.projects.locations.groups.addGroupMigration({
2909
+ * // Required. The full path name of the Group to add to.
2910
+ * group: 'projects/my-project/locations/my-location/groups/my-group',
2911
+ *
2912
+ * // Request body metadata
2913
+ * requestBody: {
2914
+ * // request body parameters
2915
+ * // {
2916
+ * // "migratingVm": "my_migratingVm"
2917
+ * // }
2918
+ * },
2919
+ * });
2920
+ * console.log(res.data);
2921
+ *
2922
+ * // Example response
2923
+ * // {
2924
+ * // "done": false,
2925
+ * // "error": {},
2926
+ * // "metadata": {},
2927
+ * // "name": "my_name",
2928
+ * // "response": {}
2929
+ * // }
2930
+ * }
2931
+ *
2932
+ * main().catch(e => {
2933
+ * console.error(e);
2934
+ * throw e;
2935
+ * });
2936
+ *
2937
+ * ```
2741
2938
  *
2742
2939
  * @param params - Parameters for request
2743
2940
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2752,6 +2949,73 @@ export declare namespace vmmigration_v1 {
2752
2949
  addGroupMigration(callback: BodyResponseCallback<Schema$Operation>): void;
2753
2950
  /**
2754
2951
  * Creates a new Group in a given project and location.
2952
+ * @example
2953
+ * ```js
2954
+ * // Before running the sample:
2955
+ * // - Enable the API at:
2956
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
2957
+ * // - Login into gcloud by running:
2958
+ * // ```sh
2959
+ * // $ gcloud auth application-default login
2960
+ * // ```
2961
+ * // - Install the npm module by running:
2962
+ * // ```sh
2963
+ * // $ npm install googleapis
2964
+ * // ```
2965
+ *
2966
+ * const {google} = require('googleapis');
2967
+ * const vmmigration = google.vmmigration('v1');
2968
+ *
2969
+ * async function main() {
2970
+ * const auth = new google.auth.GoogleAuth({
2971
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
2972
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
2973
+ * });
2974
+ *
2975
+ * // Acquire an auth client, and bind it to all future calls
2976
+ * const authClient = await auth.getClient();
2977
+ * google.options({auth: authClient});
2978
+ *
2979
+ * // Do the magic
2980
+ * const res = await vmmigration.projects.locations.groups.create({
2981
+ * // Required. The group identifier.
2982
+ * groupId: 'placeholder-value',
2983
+ * // Required. The Group's parent.
2984
+ * parent: 'projects/my-project/locations/my-location',
2985
+ * // 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).
2986
+ * requestId: 'placeholder-value',
2987
+ *
2988
+ * // Request body metadata
2989
+ * requestBody: {
2990
+ * // request body parameters
2991
+ * // {
2992
+ * // "createTime": "my_createTime",
2993
+ * // "description": "my_description",
2994
+ * // "displayName": "my_displayName",
2995
+ * // "migrationTargetType": "my_migrationTargetType",
2996
+ * // "name": "my_name",
2997
+ * // "updateTime": "my_updateTime"
2998
+ * // }
2999
+ * },
3000
+ * });
3001
+ * console.log(res.data);
3002
+ *
3003
+ * // Example response
3004
+ * // {
3005
+ * // "done": false,
3006
+ * // "error": {},
3007
+ * // "metadata": {},
3008
+ * // "name": "my_name",
3009
+ * // "response": {}
3010
+ * // }
3011
+ * }
3012
+ *
3013
+ * main().catch(e => {
3014
+ * console.error(e);
3015
+ * throw e;
3016
+ * });
3017
+ *
3018
+ * ```
2755
3019
  *
2756
3020
  * @param params - Parameters for request
2757
3021
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2766,6 +3030,58 @@ export declare namespace vmmigration_v1 {
2766
3030
  create(callback: BodyResponseCallback<Schema$Operation>): void;
2767
3031
  /**
2768
3032
  * Deletes a single Group.
3033
+ * @example
3034
+ * ```js
3035
+ * // Before running the sample:
3036
+ * // - Enable the API at:
3037
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3038
+ * // - Login into gcloud by running:
3039
+ * // ```sh
3040
+ * // $ gcloud auth application-default login
3041
+ * // ```
3042
+ * // - Install the npm module by running:
3043
+ * // ```sh
3044
+ * // $ npm install googleapis
3045
+ * // ```
3046
+ *
3047
+ * const {google} = require('googleapis');
3048
+ * const vmmigration = google.vmmigration('v1');
3049
+ *
3050
+ * async function main() {
3051
+ * const auth = new google.auth.GoogleAuth({
3052
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3053
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3054
+ * });
3055
+ *
3056
+ * // Acquire an auth client, and bind it to all future calls
3057
+ * const authClient = await auth.getClient();
3058
+ * google.options({auth: authClient});
3059
+ *
3060
+ * // Do the magic
3061
+ * const res = await vmmigration.projects.locations.groups.delete({
3062
+ * // Required. The Group name.
3063
+ * name: 'projects/my-project/locations/my-location/groups/my-group',
3064
+ * // 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).
3065
+ * requestId: 'placeholder-value',
3066
+ * });
3067
+ * console.log(res.data);
3068
+ *
3069
+ * // Example response
3070
+ * // {
3071
+ * // "done": false,
3072
+ * // "error": {},
3073
+ * // "metadata": {},
3074
+ * // "name": "my_name",
3075
+ * // "response": {}
3076
+ * // }
3077
+ * }
3078
+ *
3079
+ * main().catch(e => {
3080
+ * console.error(e);
3081
+ * throw e;
3082
+ * });
3083
+ *
3084
+ * ```
2769
3085
  *
2770
3086
  * @param params - Parameters for request
2771
3087
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2780,6 +3096,57 @@ export declare namespace vmmigration_v1 {
2780
3096
  delete(callback: BodyResponseCallback<Schema$Operation>): void;
2781
3097
  /**
2782
3098
  * Gets details of a single Group.
3099
+ * @example
3100
+ * ```js
3101
+ * // Before running the sample:
3102
+ * // - Enable the API at:
3103
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3104
+ * // - Login into gcloud by running:
3105
+ * // ```sh
3106
+ * // $ gcloud auth application-default login
3107
+ * // ```
3108
+ * // - Install the npm module by running:
3109
+ * // ```sh
3110
+ * // $ npm install googleapis
3111
+ * // ```
3112
+ *
3113
+ * const {google} = require('googleapis');
3114
+ * const vmmigration = google.vmmigration('v1');
3115
+ *
3116
+ * async function main() {
3117
+ * const auth = new google.auth.GoogleAuth({
3118
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3119
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3120
+ * });
3121
+ *
3122
+ * // Acquire an auth client, and bind it to all future calls
3123
+ * const authClient = await auth.getClient();
3124
+ * google.options({auth: authClient});
3125
+ *
3126
+ * // Do the magic
3127
+ * const res = await vmmigration.projects.locations.groups.get({
3128
+ * // Required. The group name.
3129
+ * name: 'projects/my-project/locations/my-location/groups/my-group',
3130
+ * });
3131
+ * console.log(res.data);
3132
+ *
3133
+ * // Example response
3134
+ * // {
3135
+ * // "createTime": "my_createTime",
3136
+ * // "description": "my_description",
3137
+ * // "displayName": "my_displayName",
3138
+ * // "migrationTargetType": "my_migrationTargetType",
3139
+ * // "name": "my_name",
3140
+ * // "updateTime": "my_updateTime"
3141
+ * // }
3142
+ * }
3143
+ *
3144
+ * main().catch(e => {
3145
+ * console.error(e);
3146
+ * throw e;
3147
+ * });
3148
+ *
3149
+ * ```
2783
3150
  *
2784
3151
  * @param params - Parameters for request
2785
3152
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2794,6 +3161,62 @@ export declare namespace vmmigration_v1 {
2794
3161
  get(callback: BodyResponseCallback<Schema$Group>): void;
2795
3162
  /**
2796
3163
  * Lists Groups in a given project and location.
3164
+ * @example
3165
+ * ```js
3166
+ * // Before running the sample:
3167
+ * // - Enable the API at:
3168
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3169
+ * // - Login into gcloud by running:
3170
+ * // ```sh
3171
+ * // $ gcloud auth application-default login
3172
+ * // ```
3173
+ * // - Install the npm module by running:
3174
+ * // ```sh
3175
+ * // $ npm install googleapis
3176
+ * // ```
3177
+ *
3178
+ * const {google} = require('googleapis');
3179
+ * const vmmigration = google.vmmigration('v1');
3180
+ *
3181
+ * async function main() {
3182
+ * const auth = new google.auth.GoogleAuth({
3183
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3184
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3185
+ * });
3186
+ *
3187
+ * // Acquire an auth client, and bind it to all future calls
3188
+ * const authClient = await auth.getClient();
3189
+ * google.options({auth: authClient});
3190
+ *
3191
+ * // Do the magic
3192
+ * const res = await vmmigration.projects.locations.groups.list({
3193
+ * // Optional. The filter request.
3194
+ * filter: 'placeholder-value',
3195
+ * // Optional. the order by fields for the result.
3196
+ * orderBy: 'placeholder-value',
3197
+ * // 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.
3198
+ * pageSize: 'placeholder-value',
3199
+ * // 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.
3200
+ * pageToken: 'placeholder-value',
3201
+ * // Required. The parent, which owns this collection of groups.
3202
+ * parent: 'projects/my-project/locations/my-location',
3203
+ * });
3204
+ * console.log(res.data);
3205
+ *
3206
+ * // Example response
3207
+ * // {
3208
+ * // "groups": [],
3209
+ * // "nextPageToken": "my_nextPageToken",
3210
+ * // "unreachable": []
3211
+ * // }
3212
+ * }
3213
+ *
3214
+ * main().catch(e => {
3215
+ * console.error(e);
3216
+ * throw e;
3217
+ * });
3218
+ *
3219
+ * ```
2797
3220
  *
2798
3221
  * @param params - Parameters for request
2799
3222
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2808,6 +3231,73 @@ export declare namespace vmmigration_v1 {
2808
3231
  list(callback: BodyResponseCallback<Schema$ListGroupsResponse>): void;
2809
3232
  /**
2810
3233
  * Updates the parameters of a single Group.
3234
+ * @example
3235
+ * ```js
3236
+ * // Before running the sample:
3237
+ * // - Enable the API at:
3238
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3239
+ * // - Login into gcloud by running:
3240
+ * // ```sh
3241
+ * // $ gcloud auth application-default login
3242
+ * // ```
3243
+ * // - Install the npm module by running:
3244
+ * // ```sh
3245
+ * // $ npm install googleapis
3246
+ * // ```
3247
+ *
3248
+ * const {google} = require('googleapis');
3249
+ * const vmmigration = google.vmmigration('v1');
3250
+ *
3251
+ * async function main() {
3252
+ * const auth = new google.auth.GoogleAuth({
3253
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3254
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3255
+ * });
3256
+ *
3257
+ * // Acquire an auth client, and bind it to all future calls
3258
+ * const authClient = await auth.getClient();
3259
+ * google.options({auth: authClient});
3260
+ *
3261
+ * // Do the magic
3262
+ * const res = await vmmigration.projects.locations.groups.patch({
3263
+ * // Output only. The Group name.
3264
+ * name: 'projects/my-project/locations/my-location/groups/my-group',
3265
+ * // 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).
3266
+ * requestId: 'placeholder-value',
3267
+ * // 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.
3268
+ * updateMask: 'placeholder-value',
3269
+ *
3270
+ * // Request body metadata
3271
+ * requestBody: {
3272
+ * // request body parameters
3273
+ * // {
3274
+ * // "createTime": "my_createTime",
3275
+ * // "description": "my_description",
3276
+ * // "displayName": "my_displayName",
3277
+ * // "migrationTargetType": "my_migrationTargetType",
3278
+ * // "name": "my_name",
3279
+ * // "updateTime": "my_updateTime"
3280
+ * // }
3281
+ * },
3282
+ * });
3283
+ * console.log(res.data);
3284
+ *
3285
+ * // Example response
3286
+ * // {
3287
+ * // "done": false,
3288
+ * // "error": {},
3289
+ * // "metadata": {},
3290
+ * // "name": "my_name",
3291
+ * // "response": {}
3292
+ * // }
3293
+ * }
3294
+ *
3295
+ * main().catch(e => {
3296
+ * console.error(e);
3297
+ * throw e;
3298
+ * });
3299
+ *
3300
+ * ```
2811
3301
  *
2812
3302
  * @param params - Parameters for request
2813
3303
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2822,6 +3312,64 @@ export declare namespace vmmigration_v1 {
2822
3312
  patch(callback: BodyResponseCallback<Schema$Operation>): void;
2823
3313
  /**
2824
3314
  * Removes a MigratingVm from a Group.
3315
+ * @example
3316
+ * ```js
3317
+ * // Before running the sample:
3318
+ * // - Enable the API at:
3319
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3320
+ * // - Login into gcloud by running:
3321
+ * // ```sh
3322
+ * // $ gcloud auth application-default login
3323
+ * // ```
3324
+ * // - Install the npm module by running:
3325
+ * // ```sh
3326
+ * // $ npm install googleapis
3327
+ * // ```
3328
+ *
3329
+ * const {google} = require('googleapis');
3330
+ * const vmmigration = google.vmmigration('v1');
3331
+ *
3332
+ * async function main() {
3333
+ * const auth = new google.auth.GoogleAuth({
3334
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3335
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3336
+ * });
3337
+ *
3338
+ * // Acquire an auth client, and bind it to all future calls
3339
+ * const authClient = await auth.getClient();
3340
+ * google.options({auth: authClient});
3341
+ *
3342
+ * // Do the magic
3343
+ * const res = await vmmigration.projects.locations.groups.removeGroupMigration({
3344
+ * // Required. The name of the Group.
3345
+ * group: 'projects/my-project/locations/my-location/groups/my-group',
3346
+ *
3347
+ * // Request body metadata
3348
+ * requestBody: {
3349
+ * // request body parameters
3350
+ * // {
3351
+ * // "migratingVm": "my_migratingVm"
3352
+ * // }
3353
+ * },
3354
+ * });
3355
+ * console.log(res.data);
3356
+ *
3357
+ * // Example response
3358
+ * // {
3359
+ * // "done": false,
3360
+ * // "error": {},
3361
+ * // "metadata": {},
3362
+ * // "name": "my_name",
3363
+ * // "response": {}
3364
+ * // }
3365
+ * }
3366
+ *
3367
+ * main().catch(e => {
3368
+ * console.error(e);
3369
+ * throw e;
3370
+ * });
3371
+ *
3372
+ * ```
2825
3373
  *
2826
3374
  * @param params - Parameters for request
2827
3375
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2935,6 +3483,74 @@ export declare namespace vmmigration_v1 {
2935
3483
  constructor(context: APIRequestContext);
2936
3484
  /**
2937
3485
  * Creates a new ImageImport in a given project.
3486
+ * @example
3487
+ * ```js
3488
+ * // Before running the sample:
3489
+ * // - Enable the API at:
3490
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3491
+ * // - Login into gcloud by running:
3492
+ * // ```sh
3493
+ * // $ gcloud auth application-default login
3494
+ * // ```
3495
+ * // - Install the npm module by running:
3496
+ * // ```sh
3497
+ * // $ npm install googleapis
3498
+ * // ```
3499
+ *
3500
+ * const {google} = require('googleapis');
3501
+ * const vmmigration = google.vmmigration('v1');
3502
+ *
3503
+ * async function main() {
3504
+ * const auth = new google.auth.GoogleAuth({
3505
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3506
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3507
+ * });
3508
+ *
3509
+ * // Acquire an auth client, and bind it to all future calls
3510
+ * const authClient = await auth.getClient();
3511
+ * google.options({auth: authClient});
3512
+ *
3513
+ * // Do the magic
3514
+ * const res = await vmmigration.projects.locations.imageImports.create({
3515
+ * // 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.
3516
+ * imageImportId: 'placeholder-value',
3517
+ * // Required. The ImageImport's parent.
3518
+ * parent: 'projects/my-project/locations/my-location',
3519
+ * // 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).
3520
+ * requestId: 'placeholder-value',
3521
+ *
3522
+ * // Request body metadata
3523
+ * requestBody: {
3524
+ * // request body parameters
3525
+ * // {
3526
+ * // "cloudStorageUri": "my_cloudStorageUri",
3527
+ * // "createTime": "my_createTime",
3528
+ * // "diskImageTargetDefaults": {},
3529
+ * // "encryption": {},
3530
+ * // "machineImageTargetDefaults": {},
3531
+ * // "name": "my_name",
3532
+ * // "recentImageImportJobs": []
3533
+ * // }
3534
+ * },
3535
+ * });
3536
+ * console.log(res.data);
3537
+ *
3538
+ * // Example response
3539
+ * // {
3540
+ * // "done": false,
3541
+ * // "error": {},
3542
+ * // "metadata": {},
3543
+ * // "name": "my_name",
3544
+ * // "response": {}
3545
+ * // }
3546
+ * }
3547
+ *
3548
+ * main().catch(e => {
3549
+ * console.error(e);
3550
+ * throw e;
3551
+ * });
3552
+ *
3553
+ * ```
2938
3554
  *
2939
3555
  * @param params - Parameters for request
2940
3556
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2949,6 +3565,58 @@ export declare namespace vmmigration_v1 {
2949
3565
  create(callback: BodyResponseCallback<Schema$Operation>): void;
2950
3566
  /**
2951
3567
  * Deletes a single ImageImport.
3568
+ * @example
3569
+ * ```js
3570
+ * // Before running the sample:
3571
+ * // - Enable the API at:
3572
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3573
+ * // - Login into gcloud by running:
3574
+ * // ```sh
3575
+ * // $ gcloud auth application-default login
3576
+ * // ```
3577
+ * // - Install the npm module by running:
3578
+ * // ```sh
3579
+ * // $ npm install googleapis
3580
+ * // ```
3581
+ *
3582
+ * const {google} = require('googleapis');
3583
+ * const vmmigration = google.vmmigration('v1');
3584
+ *
3585
+ * async function main() {
3586
+ * const auth = new google.auth.GoogleAuth({
3587
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3588
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3589
+ * });
3590
+ *
3591
+ * // Acquire an auth client, and bind it to all future calls
3592
+ * const authClient = await auth.getClient();
3593
+ * google.options({auth: authClient});
3594
+ *
3595
+ * // Do the magic
3596
+ * const res = await vmmigration.projects.locations.imageImports.delete({
3597
+ * // Required. The ImageImport name.
3598
+ * name: 'projects/my-project/locations/my-location/imageImports/my-imageImport',
3599
+ * // 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).
3600
+ * requestId: 'placeholder-value',
3601
+ * });
3602
+ * console.log(res.data);
3603
+ *
3604
+ * // Example response
3605
+ * // {
3606
+ * // "done": false,
3607
+ * // "error": {},
3608
+ * // "metadata": {},
3609
+ * // "name": "my_name",
3610
+ * // "response": {}
3611
+ * // }
3612
+ * }
3613
+ *
3614
+ * main().catch(e => {
3615
+ * console.error(e);
3616
+ * throw e;
3617
+ * });
3618
+ *
3619
+ * ```
2952
3620
  *
2953
3621
  * @param params - Parameters for request
2954
3622
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2963,6 +3631,58 @@ export declare namespace vmmigration_v1 {
2963
3631
  delete(callback: BodyResponseCallback<Schema$Operation>): void;
2964
3632
  /**
2965
3633
  * Gets details of a single ImageImport.
3634
+ * @example
3635
+ * ```js
3636
+ * // Before running the sample:
3637
+ * // - Enable the API at:
3638
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3639
+ * // - Login into gcloud by running:
3640
+ * // ```sh
3641
+ * // $ gcloud auth application-default login
3642
+ * // ```
3643
+ * // - Install the npm module by running:
3644
+ * // ```sh
3645
+ * // $ npm install googleapis
3646
+ * // ```
3647
+ *
3648
+ * const {google} = require('googleapis');
3649
+ * const vmmigration = google.vmmigration('v1');
3650
+ *
3651
+ * async function main() {
3652
+ * const auth = new google.auth.GoogleAuth({
3653
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3654
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3655
+ * });
3656
+ *
3657
+ * // Acquire an auth client, and bind it to all future calls
3658
+ * const authClient = await auth.getClient();
3659
+ * google.options({auth: authClient});
3660
+ *
3661
+ * // Do the magic
3662
+ * const res = await vmmigration.projects.locations.imageImports.get({
3663
+ * // Required. The ImageImport name.
3664
+ * name: 'projects/my-project/locations/my-location/imageImports/my-imageImport',
3665
+ * });
3666
+ * console.log(res.data);
3667
+ *
3668
+ * // Example response
3669
+ * // {
3670
+ * // "cloudStorageUri": "my_cloudStorageUri",
3671
+ * // "createTime": "my_createTime",
3672
+ * // "diskImageTargetDefaults": {},
3673
+ * // "encryption": {},
3674
+ * // "machineImageTargetDefaults": {},
3675
+ * // "name": "my_name",
3676
+ * // "recentImageImportJobs": []
3677
+ * // }
3678
+ * }
3679
+ *
3680
+ * main().catch(e => {
3681
+ * console.error(e);
3682
+ * throw e;
3683
+ * });
3684
+ *
3685
+ * ```
2966
3686
  *
2967
3687
  * @param params - Parameters for request
2968
3688
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -2977,6 +3697,62 @@ export declare namespace vmmigration_v1 {
2977
3697
  get(callback: BodyResponseCallback<Schema$ImageImport>): void;
2978
3698
  /**
2979
3699
  * Lists ImageImports in a given project.
3700
+ * @example
3701
+ * ```js
3702
+ * // Before running the sample:
3703
+ * // - Enable the API at:
3704
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3705
+ * // - Login into gcloud by running:
3706
+ * // ```sh
3707
+ * // $ gcloud auth application-default login
3708
+ * // ```
3709
+ * // - Install the npm module by running:
3710
+ * // ```sh
3711
+ * // $ npm install googleapis
3712
+ * // ```
3713
+ *
3714
+ * const {google} = require('googleapis');
3715
+ * const vmmigration = google.vmmigration('v1');
3716
+ *
3717
+ * async function main() {
3718
+ * const auth = new google.auth.GoogleAuth({
3719
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3720
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3721
+ * });
3722
+ *
3723
+ * // Acquire an auth client, and bind it to all future calls
3724
+ * const authClient = await auth.getClient();
3725
+ * google.options({auth: authClient});
3726
+ *
3727
+ * // Do the magic
3728
+ * const res = await vmmigration.projects.locations.imageImports.list({
3729
+ * // Optional. The filter request (according to AIP-160).
3730
+ * filter: 'placeholder-value',
3731
+ * // Optional. The order by fields for the result (according to AIP-132). Currently ordering is only possible by "name" field.
3732
+ * orderBy: 'placeholder-value',
3733
+ * // 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.
3734
+ * pageSize: 'placeholder-value',
3735
+ * // 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.
3736
+ * pageToken: 'placeholder-value',
3737
+ * // Required. The parent, which owns this collection of targets.
3738
+ * parent: 'projects/my-project/locations/my-location',
3739
+ * });
3740
+ * console.log(res.data);
3741
+ *
3742
+ * // Example response
3743
+ * // {
3744
+ * // "imageImports": [],
3745
+ * // "nextPageToken": "my_nextPageToken",
3746
+ * // "unreachable": []
3747
+ * // }
3748
+ * }
3749
+ *
3750
+ * main().catch(e => {
3751
+ * console.error(e);
3752
+ * throw e;
3753
+ * });
3754
+ *
3755
+ * ```
2980
3756
  *
2981
3757
  * @param params - Parameters for request
2982
3758
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3051,6 +3827,63 @@ export declare namespace vmmigration_v1 {
3051
3827
  constructor(context: APIRequestContext);
3052
3828
  /**
3053
3829
  * Initiates the cancellation of a running clone job.
3830
+ * @example
3831
+ * ```js
3832
+ * // Before running the sample:
3833
+ * // - Enable the API at:
3834
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3835
+ * // - Login into gcloud by running:
3836
+ * // ```sh
3837
+ * // $ gcloud auth application-default login
3838
+ * // ```
3839
+ * // - Install the npm module by running:
3840
+ * // ```sh
3841
+ * // $ npm install googleapis
3842
+ * // ```
3843
+ *
3844
+ * const {google} = require('googleapis');
3845
+ * const vmmigration = google.vmmigration('v1');
3846
+ *
3847
+ * async function main() {
3848
+ * const auth = new google.auth.GoogleAuth({
3849
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3850
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3851
+ * });
3852
+ *
3853
+ * // Acquire an auth client, and bind it to all future calls
3854
+ * const authClient = await auth.getClient();
3855
+ * google.options({auth: authClient});
3856
+ *
3857
+ * // Do the magic
3858
+ * const res =
3859
+ * await vmmigration.projects.locations.imageImports.imageImportJobs.cancel({
3860
+ * // Required. The image import job id.
3861
+ * name: 'projects/my-project/locations/my-location/imageImports/my-imageImport/imageImportJobs/my-imageImportJob',
3862
+ *
3863
+ * // Request body metadata
3864
+ * requestBody: {
3865
+ * // request body parameters
3866
+ * // {}
3867
+ * },
3868
+ * });
3869
+ * console.log(res.data);
3870
+ *
3871
+ * // Example response
3872
+ * // {
3873
+ * // "done": false,
3874
+ * // "error": {},
3875
+ * // "metadata": {},
3876
+ * // "name": "my_name",
3877
+ * // "response": {}
3878
+ * // }
3879
+ * }
3880
+ *
3881
+ * main().catch(e => {
3882
+ * console.error(e);
3883
+ * throw e;
3884
+ * });
3885
+ *
3886
+ * ```
3054
3887
  *
3055
3888
  * @param params - Parameters for request
3056
3889
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3065,6 +3898,63 @@ export declare namespace vmmigration_v1 {
3065
3898
  cancel(callback: BodyResponseCallback<Schema$Operation>): void;
3066
3899
  /**
3067
3900
  * Gets details of a single ImageImportJob.
3901
+ * @example
3902
+ * ```js
3903
+ * // Before running the sample:
3904
+ * // - Enable the API at:
3905
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3906
+ * // - Login into gcloud by running:
3907
+ * // ```sh
3908
+ * // $ gcloud auth application-default login
3909
+ * // ```
3910
+ * // - Install the npm module by running:
3911
+ * // ```sh
3912
+ * // $ npm install googleapis
3913
+ * // ```
3914
+ *
3915
+ * const {google} = require('googleapis');
3916
+ * const vmmigration = google.vmmigration('v1');
3917
+ *
3918
+ * async function main() {
3919
+ * const auth = new google.auth.GoogleAuth({
3920
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3921
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3922
+ * });
3923
+ *
3924
+ * // Acquire an auth client, and bind it to all future calls
3925
+ * const authClient = await auth.getClient();
3926
+ * google.options({auth: authClient});
3927
+ *
3928
+ * // Do the magic
3929
+ * const res =
3930
+ * await vmmigration.projects.locations.imageImports.imageImportJobs.get({
3931
+ * // Required. The ImageImportJob name.
3932
+ * name: 'projects/my-project/locations/my-location/imageImports/my-imageImport/imageImportJobs/my-imageImportJob',
3933
+ * });
3934
+ * console.log(res.data);
3935
+ *
3936
+ * // Example response
3937
+ * // {
3938
+ * // "cloudStorageUri": "my_cloudStorageUri",
3939
+ * // "createTime": "my_createTime",
3940
+ * // "createdResources": [],
3941
+ * // "diskImageTargetDetails": {},
3942
+ * // "endTime": "my_endTime",
3943
+ * // "errors": [],
3944
+ * // "machineImageTargetDetails": {},
3945
+ * // "name": "my_name",
3946
+ * // "state": "my_state",
3947
+ * // "steps": [],
3948
+ * // "warnings": []
3949
+ * // }
3950
+ * }
3951
+ *
3952
+ * main().catch(e => {
3953
+ * console.error(e);
3954
+ * throw e;
3955
+ * });
3956
+ *
3957
+ * ```
3068
3958
  *
3069
3959
  * @param params - Parameters for request
3070
3960
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3079,6 +3969,64 @@ export declare namespace vmmigration_v1 {
3079
3969
  get(callback: BodyResponseCallback<Schema$ImageImportJob>): void;
3080
3970
  /**
3081
3971
  * Lists ImageImportJobs in a given project.
3972
+ * @example
3973
+ * ```js
3974
+ * // Before running the sample:
3975
+ * // - Enable the API at:
3976
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
3977
+ * // - Login into gcloud by running:
3978
+ * // ```sh
3979
+ * // $ gcloud auth application-default login
3980
+ * // ```
3981
+ * // - Install the npm module by running:
3982
+ * // ```sh
3983
+ * // $ npm install googleapis
3984
+ * // ```
3985
+ *
3986
+ * const {google} = require('googleapis');
3987
+ * const vmmigration = google.vmmigration('v1');
3988
+ *
3989
+ * async function main() {
3990
+ * const auth = new google.auth.GoogleAuth({
3991
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
3992
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
3993
+ * });
3994
+ *
3995
+ * // Acquire an auth client, and bind it to all future calls
3996
+ * const authClient = await auth.getClient();
3997
+ * google.options({auth: authClient});
3998
+ *
3999
+ * // Do the magic
4000
+ * const res =
4001
+ * await vmmigration.projects.locations.imageImports.imageImportJobs.list({
4002
+ * // Optional. The filter request (according to AIP-160).
4003
+ * filter: 'placeholder-value',
4004
+ * // Optional. The order by fields for the result (according to AIP-132). Currently ordering is only possible by "name" field.
4005
+ * orderBy: 'placeholder-value',
4006
+ * // 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.
4007
+ * pageSize: 'placeholder-value',
4008
+ * // 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.
4009
+ * pageToken: 'placeholder-value',
4010
+ * // Required. The parent, which owns this collection of targets.
4011
+ * parent:
4012
+ * 'projects/my-project/locations/my-location/imageImports/my-imageImport',
4013
+ * });
4014
+ * console.log(res.data);
4015
+ *
4016
+ * // Example response
4017
+ * // {
4018
+ * // "imageImportJobs": [],
4019
+ * // "nextPageToken": "my_nextPageToken",
4020
+ * // "unreachable": []
4021
+ * // }
4022
+ * }
4023
+ *
4024
+ * main().catch(e => {
4025
+ * console.error(e);
4026
+ * throw e;
4027
+ * });
4028
+ *
4029
+ * ```
3082
4030
  *
3083
4031
  * @param params - Parameters for request
3084
4032
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3135,6 +4083,56 @@ export declare namespace vmmigration_v1 {
3135
4083
  constructor(context: APIRequestContext);
3136
4084
  /**
3137
4085
  * 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`.
4086
+ * @example
4087
+ * ```js
4088
+ * // Before running the sample:
4089
+ * // - Enable the API at:
4090
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4091
+ * // - Login into gcloud by running:
4092
+ * // ```sh
4093
+ * // $ gcloud auth application-default login
4094
+ * // ```
4095
+ * // - Install the npm module by running:
4096
+ * // ```sh
4097
+ * // $ npm install googleapis
4098
+ * // ```
4099
+ *
4100
+ * const {google} = require('googleapis');
4101
+ * const vmmigration = google.vmmigration('v1');
4102
+ *
4103
+ * async function main() {
4104
+ * const auth = new google.auth.GoogleAuth({
4105
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4106
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4107
+ * });
4108
+ *
4109
+ * // Acquire an auth client, and bind it to all future calls
4110
+ * const authClient = await auth.getClient();
4111
+ * google.options({auth: authClient});
4112
+ *
4113
+ * // Do the magic
4114
+ * const res = await vmmigration.projects.locations.operations.cancel({
4115
+ * // The name of the operation resource to be cancelled.
4116
+ * name: 'projects/my-project/locations/my-location/operations/my-operation',
4117
+ *
4118
+ * // Request body metadata
4119
+ * requestBody: {
4120
+ * // request body parameters
4121
+ * // {}
4122
+ * },
4123
+ * });
4124
+ * console.log(res.data);
4125
+ *
4126
+ * // Example response
4127
+ * // {}
4128
+ * }
4129
+ *
4130
+ * main().catch(e => {
4131
+ * console.error(e);
4132
+ * throw e;
4133
+ * });
4134
+ *
4135
+ * ```
3138
4136
  *
3139
4137
  * @param params - Parameters for request
3140
4138
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3149,6 +4147,50 @@ export declare namespace vmmigration_v1 {
3149
4147
  cancel(callback: BodyResponseCallback<Schema$Empty>): void;
3150
4148
  /**
3151
4149
  * 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`.
4150
+ * @example
4151
+ * ```js
4152
+ * // Before running the sample:
4153
+ * // - Enable the API at:
4154
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4155
+ * // - Login into gcloud by running:
4156
+ * // ```sh
4157
+ * // $ gcloud auth application-default login
4158
+ * // ```
4159
+ * // - Install the npm module by running:
4160
+ * // ```sh
4161
+ * // $ npm install googleapis
4162
+ * // ```
4163
+ *
4164
+ * const {google} = require('googleapis');
4165
+ * const vmmigration = google.vmmigration('v1');
4166
+ *
4167
+ * async function main() {
4168
+ * const auth = new google.auth.GoogleAuth({
4169
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4170
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4171
+ * });
4172
+ *
4173
+ * // Acquire an auth client, and bind it to all future calls
4174
+ * const authClient = await auth.getClient();
4175
+ * google.options({auth: authClient});
4176
+ *
4177
+ * // Do the magic
4178
+ * const res = await vmmigration.projects.locations.operations.delete({
4179
+ * // The name of the operation resource to be deleted.
4180
+ * name: 'projects/my-project/locations/my-location/operations/my-operation',
4181
+ * });
4182
+ * console.log(res.data);
4183
+ *
4184
+ * // Example response
4185
+ * // {}
4186
+ * }
4187
+ *
4188
+ * main().catch(e => {
4189
+ * console.error(e);
4190
+ * throw e;
4191
+ * });
4192
+ *
4193
+ * ```
3152
4194
  *
3153
4195
  * @param params - Parameters for request
3154
4196
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3163,6 +4205,56 @@ export declare namespace vmmigration_v1 {
3163
4205
  delete(callback: BodyResponseCallback<Schema$Empty>): void;
3164
4206
  /**
3165
4207
  * 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.
4208
+ * @example
4209
+ * ```js
4210
+ * // Before running the sample:
4211
+ * // - Enable the API at:
4212
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4213
+ * // - Login into gcloud by running:
4214
+ * // ```sh
4215
+ * // $ gcloud auth application-default login
4216
+ * // ```
4217
+ * // - Install the npm module by running:
4218
+ * // ```sh
4219
+ * // $ npm install googleapis
4220
+ * // ```
4221
+ *
4222
+ * const {google} = require('googleapis');
4223
+ * const vmmigration = google.vmmigration('v1');
4224
+ *
4225
+ * async function main() {
4226
+ * const auth = new google.auth.GoogleAuth({
4227
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4228
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4229
+ * });
4230
+ *
4231
+ * // Acquire an auth client, and bind it to all future calls
4232
+ * const authClient = await auth.getClient();
4233
+ * google.options({auth: authClient});
4234
+ *
4235
+ * // Do the magic
4236
+ * const res = await vmmigration.projects.locations.operations.get({
4237
+ * // The name of the operation resource.
4238
+ * name: 'projects/my-project/locations/my-location/operations/my-operation',
4239
+ * });
4240
+ * console.log(res.data);
4241
+ *
4242
+ * // Example response
4243
+ * // {
4244
+ * // "done": false,
4245
+ * // "error": {},
4246
+ * // "metadata": {},
4247
+ * // "name": "my_name",
4248
+ * // "response": {}
4249
+ * // }
4250
+ * }
4251
+ *
4252
+ * main().catch(e => {
4253
+ * console.error(e);
4254
+ * throw e;
4255
+ * });
4256
+ *
4257
+ * ```
3166
4258
  *
3167
4259
  * @param params - Parameters for request
3168
4260
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3177,6 +4269,59 @@ export declare namespace vmmigration_v1 {
3177
4269
  get(callback: BodyResponseCallback<Schema$Operation>): void;
3178
4270
  /**
3179
4271
  * Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.
4272
+ * @example
4273
+ * ```js
4274
+ * // Before running the sample:
4275
+ * // - Enable the API at:
4276
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4277
+ * // - Login into gcloud by running:
4278
+ * // ```sh
4279
+ * // $ gcloud auth application-default login
4280
+ * // ```
4281
+ * // - Install the npm module by running:
4282
+ * // ```sh
4283
+ * // $ npm install googleapis
4284
+ * // ```
4285
+ *
4286
+ * const {google} = require('googleapis');
4287
+ * const vmmigration = google.vmmigration('v1');
4288
+ *
4289
+ * async function main() {
4290
+ * const auth = new google.auth.GoogleAuth({
4291
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4292
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4293
+ * });
4294
+ *
4295
+ * // Acquire an auth client, and bind it to all future calls
4296
+ * const authClient = await auth.getClient();
4297
+ * google.options({auth: authClient});
4298
+ *
4299
+ * // Do the magic
4300
+ * const res = await vmmigration.projects.locations.operations.list({
4301
+ * // The standard list filter.
4302
+ * filter: 'placeholder-value',
4303
+ * // The name of the operation's parent resource.
4304
+ * name: 'projects/my-project/locations/my-location',
4305
+ * // The standard list page size.
4306
+ * pageSize: 'placeholder-value',
4307
+ * // The standard list page token.
4308
+ * pageToken: 'placeholder-value',
4309
+ * });
4310
+ * console.log(res.data);
4311
+ *
4312
+ * // Example response
4313
+ * // {
4314
+ * // "nextPageToken": "my_nextPageToken",
4315
+ * // "operations": []
4316
+ * // }
4317
+ * }
4318
+ *
4319
+ * main().catch(e => {
4320
+ * console.error(e);
4321
+ * throw e;
4322
+ * });
4323
+ *
4324
+ * ```
3180
4325
  *
3181
4326
  * @param params - Parameters for request
3182
4327
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3238,6 +4383,76 @@ export declare namespace vmmigration_v1 {
3238
4383
  constructor(context: APIRequestContext);
3239
4384
  /**
3240
4385
  * Creates a new Source in a given project and location.
4386
+ * @example
4387
+ * ```js
4388
+ * // Before running the sample:
4389
+ * // - Enable the API at:
4390
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4391
+ * // - Login into gcloud by running:
4392
+ * // ```sh
4393
+ * // $ gcloud auth application-default login
4394
+ * // ```
4395
+ * // - Install the npm module by running:
4396
+ * // ```sh
4397
+ * // $ npm install googleapis
4398
+ * // ```
4399
+ *
4400
+ * const {google} = require('googleapis');
4401
+ * const vmmigration = google.vmmigration('v1');
4402
+ *
4403
+ * async function main() {
4404
+ * const auth = new google.auth.GoogleAuth({
4405
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4406
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4407
+ * });
4408
+ *
4409
+ * // Acquire an auth client, and bind it to all future calls
4410
+ * const authClient = await auth.getClient();
4411
+ * google.options({auth: authClient});
4412
+ *
4413
+ * // Do the magic
4414
+ * const res = await vmmigration.projects.locations.sources.create({
4415
+ * // Required. The Source's parent.
4416
+ * parent: 'projects/my-project/locations/my-location',
4417
+ * // 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).
4418
+ * requestId: 'placeholder-value',
4419
+ * // Required. The source identifier.
4420
+ * sourceId: 'placeholder-value',
4421
+ *
4422
+ * // Request body metadata
4423
+ * requestBody: {
4424
+ * // request body parameters
4425
+ * // {
4426
+ * // "aws": {},
4427
+ * // "azure": {},
4428
+ * // "createTime": "my_createTime",
4429
+ * // "description": "my_description",
4430
+ * // "encryption": {},
4431
+ * // "labels": {},
4432
+ * // "name": "my_name",
4433
+ * // "updateTime": "my_updateTime",
4434
+ * // "vmware": {}
4435
+ * // }
4436
+ * },
4437
+ * });
4438
+ * console.log(res.data);
4439
+ *
4440
+ * // Example response
4441
+ * // {
4442
+ * // "done": false,
4443
+ * // "error": {},
4444
+ * // "metadata": {},
4445
+ * // "name": "my_name",
4446
+ * // "response": {}
4447
+ * // }
4448
+ * }
4449
+ *
4450
+ * main().catch(e => {
4451
+ * console.error(e);
4452
+ * throw e;
4453
+ * });
4454
+ *
4455
+ * ```
3241
4456
  *
3242
4457
  * @param params - Parameters for request
3243
4458
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3252,6 +4467,58 @@ export declare namespace vmmigration_v1 {
3252
4467
  create(callback: BodyResponseCallback<Schema$Operation>): void;
3253
4468
  /**
3254
4469
  * Deletes a single Source.
4470
+ * @example
4471
+ * ```js
4472
+ * // Before running the sample:
4473
+ * // - Enable the API at:
4474
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4475
+ * // - Login into gcloud by running:
4476
+ * // ```sh
4477
+ * // $ gcloud auth application-default login
4478
+ * // ```
4479
+ * // - Install the npm module by running:
4480
+ * // ```sh
4481
+ * // $ npm install googleapis
4482
+ * // ```
4483
+ *
4484
+ * const {google} = require('googleapis');
4485
+ * const vmmigration = google.vmmigration('v1');
4486
+ *
4487
+ * async function main() {
4488
+ * const auth = new google.auth.GoogleAuth({
4489
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4490
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4491
+ * });
4492
+ *
4493
+ * // Acquire an auth client, and bind it to all future calls
4494
+ * const authClient = await auth.getClient();
4495
+ * google.options({auth: authClient});
4496
+ *
4497
+ * // Do the magic
4498
+ * const res = await vmmigration.projects.locations.sources.delete({
4499
+ * // Required. The Source name.
4500
+ * name: 'projects/my-project/locations/my-location/sources/my-source',
4501
+ * // 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).
4502
+ * requestId: 'placeholder-value',
4503
+ * });
4504
+ * console.log(res.data);
4505
+ *
4506
+ * // Example response
4507
+ * // {
4508
+ * // "done": false,
4509
+ * // "error": {},
4510
+ * // "metadata": {},
4511
+ * // "name": "my_name",
4512
+ * // "response": {}
4513
+ * // }
4514
+ * }
4515
+ *
4516
+ * main().catch(e => {
4517
+ * console.error(e);
4518
+ * throw e;
4519
+ * });
4520
+ *
4521
+ * ```
3255
4522
  *
3256
4523
  * @param params - Parameters for request
3257
4524
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3266,6 +4533,62 @@ export declare namespace vmmigration_v1 {
3266
4533
  delete(callback: BodyResponseCallback<Schema$Operation>): void;
3267
4534
  /**
3268
4535
  * 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.
4536
+ * @example
4537
+ * ```js
4538
+ * // Before running the sample:
4539
+ * // - Enable the API at:
4540
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4541
+ * // - Login into gcloud by running:
4542
+ * // ```sh
4543
+ * // $ gcloud auth application-default login
4544
+ * // ```
4545
+ * // - Install the npm module by running:
4546
+ * // ```sh
4547
+ * // $ npm install googleapis
4548
+ * // ```
4549
+ *
4550
+ * const {google} = require('googleapis');
4551
+ * const vmmigration = google.vmmigration('v1');
4552
+ *
4553
+ * async function main() {
4554
+ * const auth = new google.auth.GoogleAuth({
4555
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4556
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4557
+ * });
4558
+ *
4559
+ * // Acquire an auth client, and bind it to all future calls
4560
+ * const authClient = await auth.getClient();
4561
+ * google.options({auth: authClient});
4562
+ *
4563
+ * // Do the magic
4564
+ * const res = await vmmigration.projects.locations.sources.fetchInventory({
4565
+ * // 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.
4566
+ * forceRefresh: 'placeholder-value',
4567
+ * // 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.
4568
+ * pageSize: 'placeholder-value',
4569
+ * // 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.
4570
+ * pageToken: 'placeholder-value',
4571
+ * // Required. The name of the Source.
4572
+ * source: 'projects/my-project/locations/my-location/sources/my-source',
4573
+ * });
4574
+ * console.log(res.data);
4575
+ *
4576
+ * // Example response
4577
+ * // {
4578
+ * // "awsVms": {},
4579
+ * // "azureVms": {},
4580
+ * // "nextPageToken": "my_nextPageToken",
4581
+ * // "updateTime": "my_updateTime",
4582
+ * // "vmwareVms": {}
4583
+ * // }
4584
+ * }
4585
+ *
4586
+ * main().catch(e => {
4587
+ * console.error(e);
4588
+ * throw e;
4589
+ * });
4590
+ *
4591
+ * ```
3269
4592
  *
3270
4593
  * @param params - Parameters for request
3271
4594
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3280,6 +4603,60 @@ export declare namespace vmmigration_v1 {
3280
4603
  fetchInventory(callback: BodyResponseCallback<Schema$FetchInventoryResponse>): void;
3281
4604
  /**
3282
4605
  * Gets details of a single Source.
4606
+ * @example
4607
+ * ```js
4608
+ * // Before running the sample:
4609
+ * // - Enable the API at:
4610
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4611
+ * // - Login into gcloud by running:
4612
+ * // ```sh
4613
+ * // $ gcloud auth application-default login
4614
+ * // ```
4615
+ * // - Install the npm module by running:
4616
+ * // ```sh
4617
+ * // $ npm install googleapis
4618
+ * // ```
4619
+ *
4620
+ * const {google} = require('googleapis');
4621
+ * const vmmigration = google.vmmigration('v1');
4622
+ *
4623
+ * async function main() {
4624
+ * const auth = new google.auth.GoogleAuth({
4625
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4626
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4627
+ * });
4628
+ *
4629
+ * // Acquire an auth client, and bind it to all future calls
4630
+ * const authClient = await auth.getClient();
4631
+ * google.options({auth: authClient});
4632
+ *
4633
+ * // Do the magic
4634
+ * const res = await vmmigration.projects.locations.sources.get({
4635
+ * // Required. The Source name.
4636
+ * name: 'projects/my-project/locations/my-location/sources/my-source',
4637
+ * });
4638
+ * console.log(res.data);
4639
+ *
4640
+ * // Example response
4641
+ * // {
4642
+ * // "aws": {},
4643
+ * // "azure": {},
4644
+ * // "createTime": "my_createTime",
4645
+ * // "description": "my_description",
4646
+ * // "encryption": {},
4647
+ * // "labels": {},
4648
+ * // "name": "my_name",
4649
+ * // "updateTime": "my_updateTime",
4650
+ * // "vmware": {}
4651
+ * // }
4652
+ * }
4653
+ *
4654
+ * main().catch(e => {
4655
+ * console.error(e);
4656
+ * throw e;
4657
+ * });
4658
+ *
4659
+ * ```
3283
4660
  *
3284
4661
  * @param params - Parameters for request
3285
4662
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3294,6 +4671,62 @@ export declare namespace vmmigration_v1 {
3294
4671
  get(callback: BodyResponseCallback<Schema$Source>): void;
3295
4672
  /**
3296
4673
  * Lists Sources in a given project and location.
4674
+ * @example
4675
+ * ```js
4676
+ * // Before running the sample:
4677
+ * // - Enable the API at:
4678
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4679
+ * // - Login into gcloud by running:
4680
+ * // ```sh
4681
+ * // $ gcloud auth application-default login
4682
+ * // ```
4683
+ * // - Install the npm module by running:
4684
+ * // ```sh
4685
+ * // $ npm install googleapis
4686
+ * // ```
4687
+ *
4688
+ * const {google} = require('googleapis');
4689
+ * const vmmigration = google.vmmigration('v1');
4690
+ *
4691
+ * async function main() {
4692
+ * const auth = new google.auth.GoogleAuth({
4693
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4694
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4695
+ * });
4696
+ *
4697
+ * // Acquire an auth client, and bind it to all future calls
4698
+ * const authClient = await auth.getClient();
4699
+ * google.options({auth: authClient});
4700
+ *
4701
+ * // Do the magic
4702
+ * const res = await vmmigration.projects.locations.sources.list({
4703
+ * // Optional. The filter request.
4704
+ * filter: 'placeholder-value',
4705
+ * // Optional. the order by fields for the result.
4706
+ * orderBy: 'placeholder-value',
4707
+ * // 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.
4708
+ * pageSize: 'placeholder-value',
4709
+ * // 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.
4710
+ * pageToken: 'placeholder-value',
4711
+ * // Required. The parent, which owns this collection of sources.
4712
+ * parent: 'projects/my-project/locations/my-location',
4713
+ * });
4714
+ * console.log(res.data);
4715
+ *
4716
+ * // Example response
4717
+ * // {
4718
+ * // "nextPageToken": "my_nextPageToken",
4719
+ * // "sources": [],
4720
+ * // "unreachable": []
4721
+ * // }
4722
+ * }
4723
+ *
4724
+ * main().catch(e => {
4725
+ * console.error(e);
4726
+ * throw e;
4727
+ * });
4728
+ *
4729
+ * ```
3297
4730
  *
3298
4731
  * @param params - Parameters for request
3299
4732
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3308,6 +4741,76 @@ export declare namespace vmmigration_v1 {
3308
4741
  list(callback: BodyResponseCallback<Schema$ListSourcesResponse>): void;
3309
4742
  /**
3310
4743
  * Updates the parameters of a single Source.
4744
+ * @example
4745
+ * ```js
4746
+ * // Before running the sample:
4747
+ * // - Enable the API at:
4748
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4749
+ * // - Login into gcloud by running:
4750
+ * // ```sh
4751
+ * // $ gcloud auth application-default login
4752
+ * // ```
4753
+ * // - Install the npm module by running:
4754
+ * // ```sh
4755
+ * // $ npm install googleapis
4756
+ * // ```
4757
+ *
4758
+ * const {google} = require('googleapis');
4759
+ * const vmmigration = google.vmmigration('v1');
4760
+ *
4761
+ * async function main() {
4762
+ * const auth = new google.auth.GoogleAuth({
4763
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4764
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4765
+ * });
4766
+ *
4767
+ * // Acquire an auth client, and bind it to all future calls
4768
+ * const authClient = await auth.getClient();
4769
+ * google.options({auth: authClient});
4770
+ *
4771
+ * // Do the magic
4772
+ * const res = await vmmigration.projects.locations.sources.patch({
4773
+ * // Output only. The Source name.
4774
+ * name: 'projects/my-project/locations/my-location/sources/my-source',
4775
+ * // 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).
4776
+ * requestId: 'placeholder-value',
4777
+ * // 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.
4778
+ * updateMask: 'placeholder-value',
4779
+ *
4780
+ * // Request body metadata
4781
+ * requestBody: {
4782
+ * // request body parameters
4783
+ * // {
4784
+ * // "aws": {},
4785
+ * // "azure": {},
4786
+ * // "createTime": "my_createTime",
4787
+ * // "description": "my_description",
4788
+ * // "encryption": {},
4789
+ * // "labels": {},
4790
+ * // "name": "my_name",
4791
+ * // "updateTime": "my_updateTime",
4792
+ * // "vmware": {}
4793
+ * // }
4794
+ * },
4795
+ * });
4796
+ * console.log(res.data);
4797
+ *
4798
+ * // Example response
4799
+ * // {
4800
+ * // "done": false,
4801
+ * // "error": {},
4802
+ * // "metadata": {},
4803
+ * // "name": "my_name",
4804
+ * // "response": {}
4805
+ * // }
4806
+ * }
4807
+ *
4808
+ * main().catch(e => {
4809
+ * console.error(e);
4810
+ * throw e;
4811
+ * });
4812
+ *
4813
+ * ```
3311
4814
  *
3312
4815
  * @param params - Parameters for request
3313
4816
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3418,6 +4921,82 @@ export declare namespace vmmigration_v1 {
3418
4921
  constructor(context: APIRequestContext);
3419
4922
  /**
3420
4923
  * Creates a new DatacenterConnector in a given Source.
4924
+ * @example
4925
+ * ```js
4926
+ * // Before running the sample:
4927
+ * // - Enable the API at:
4928
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
4929
+ * // - Login into gcloud by running:
4930
+ * // ```sh
4931
+ * // $ gcloud auth application-default login
4932
+ * // ```
4933
+ * // - Install the npm module by running:
4934
+ * // ```sh
4935
+ * // $ npm install googleapis
4936
+ * // ```
4937
+ *
4938
+ * const {google} = require('googleapis');
4939
+ * const vmmigration = google.vmmigration('v1');
4940
+ *
4941
+ * async function main() {
4942
+ * const auth = new google.auth.GoogleAuth({
4943
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
4944
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
4945
+ * });
4946
+ *
4947
+ * // Acquire an auth client, and bind it to all future calls
4948
+ * const authClient = await auth.getClient();
4949
+ * google.options({auth: authClient});
4950
+ *
4951
+ * // Do the magic
4952
+ * const res =
4953
+ * await vmmigration.projects.locations.sources.datacenterConnectors.create({
4954
+ * // Required. The datacenterConnector identifier.
4955
+ * datacenterConnectorId: 'placeholder-value',
4956
+ * // 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`
4957
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
4958
+ * // 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).
4959
+ * requestId: 'placeholder-value',
4960
+ *
4961
+ * // Request body metadata
4962
+ * requestBody: {
4963
+ * // request body parameters
4964
+ * // {
4965
+ * // "applianceInfrastructureVersion": "my_applianceInfrastructureVersion",
4966
+ * // "applianceSoftwareVersion": "my_applianceSoftwareVersion",
4967
+ * // "availableVersions": {},
4968
+ * // "bucket": "my_bucket",
4969
+ * // "createTime": "my_createTime",
4970
+ * // "error": {},
4971
+ * // "name": "my_name",
4972
+ * // "registrationId": "my_registrationId",
4973
+ * // "serviceAccount": "my_serviceAccount",
4974
+ * // "state": "my_state",
4975
+ * // "stateTime": "my_stateTime",
4976
+ * // "updateTime": "my_updateTime",
4977
+ * // "upgradeStatus": {},
4978
+ * // "version": "my_version"
4979
+ * // }
4980
+ * },
4981
+ * });
4982
+ * console.log(res.data);
4983
+ *
4984
+ * // Example response
4985
+ * // {
4986
+ * // "done": false,
4987
+ * // "error": {},
4988
+ * // "metadata": {},
4989
+ * // "name": "my_name",
4990
+ * // "response": {}
4991
+ * // }
4992
+ * }
4993
+ *
4994
+ * main().catch(e => {
4995
+ * console.error(e);
4996
+ * throw e;
4997
+ * });
4998
+ *
4999
+ * ```
3421
5000
  *
3422
5001
  * @param params - Parameters for request
3423
5002
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3432,6 +5011,59 @@ export declare namespace vmmigration_v1 {
3432
5011
  create(callback: BodyResponseCallback<Schema$Operation>): void;
3433
5012
  /**
3434
5013
  * Deletes a single DatacenterConnector.
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.sources.datacenterConnectors.delete({
5044
+ * // Required. The DatacenterConnector name.
5045
+ * name: 'projects/my-project/locations/my-location/sources/my-source/datacenterConnectors/my-datacenterConnector',
5046
+ * // 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).
5047
+ * requestId: 'placeholder-value',
5048
+ * });
5049
+ * console.log(res.data);
5050
+ *
5051
+ * // Example response
5052
+ * // {
5053
+ * // "done": false,
5054
+ * // "error": {},
5055
+ * // "metadata": {},
5056
+ * // "name": "my_name",
5057
+ * // "response": {}
5058
+ * // }
5059
+ * }
5060
+ *
5061
+ * main().catch(e => {
5062
+ * console.error(e);
5063
+ * throw e;
5064
+ * });
5065
+ *
5066
+ * ```
3435
5067
  *
3436
5068
  * @param params - Parameters for request
3437
5069
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3446,6 +5078,66 @@ export declare namespace vmmigration_v1 {
3446
5078
  delete(callback: BodyResponseCallback<Schema$Operation>): void;
3447
5079
  /**
3448
5080
  * Gets details of a single DatacenterConnector.
5081
+ * @example
5082
+ * ```js
5083
+ * // Before running the sample:
5084
+ * // - Enable the API at:
5085
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5086
+ * // - Login into gcloud by running:
5087
+ * // ```sh
5088
+ * // $ gcloud auth application-default login
5089
+ * // ```
5090
+ * // - Install the npm module by running:
5091
+ * // ```sh
5092
+ * // $ npm install googleapis
5093
+ * // ```
5094
+ *
5095
+ * const {google} = require('googleapis');
5096
+ * const vmmigration = google.vmmigration('v1');
5097
+ *
5098
+ * async function main() {
5099
+ * const auth = new google.auth.GoogleAuth({
5100
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5101
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5102
+ * });
5103
+ *
5104
+ * // Acquire an auth client, and bind it to all future calls
5105
+ * const authClient = await auth.getClient();
5106
+ * google.options({auth: authClient});
5107
+ *
5108
+ * // Do the magic
5109
+ * const res =
5110
+ * await vmmigration.projects.locations.sources.datacenterConnectors.get({
5111
+ * // Required. The name of the DatacenterConnector.
5112
+ * name: 'projects/my-project/locations/my-location/sources/my-source/datacenterConnectors/my-datacenterConnector',
5113
+ * });
5114
+ * console.log(res.data);
5115
+ *
5116
+ * // Example response
5117
+ * // {
5118
+ * // "applianceInfrastructureVersion": "my_applianceInfrastructureVersion",
5119
+ * // "applianceSoftwareVersion": "my_applianceSoftwareVersion",
5120
+ * // "availableVersions": {},
5121
+ * // "bucket": "my_bucket",
5122
+ * // "createTime": "my_createTime",
5123
+ * // "error": {},
5124
+ * // "name": "my_name",
5125
+ * // "registrationId": "my_registrationId",
5126
+ * // "serviceAccount": "my_serviceAccount",
5127
+ * // "state": "my_state",
5128
+ * // "stateTime": "my_stateTime",
5129
+ * // "updateTime": "my_updateTime",
5130
+ * // "upgradeStatus": {},
5131
+ * // "version": "my_version"
5132
+ * // }
5133
+ * }
5134
+ *
5135
+ * main().catch(e => {
5136
+ * console.error(e);
5137
+ * throw e;
5138
+ * });
5139
+ *
5140
+ * ```
3449
5141
  *
3450
5142
  * @param params - Parameters for request
3451
5143
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3460,6 +5152,63 @@ export declare namespace vmmigration_v1 {
3460
5152
  get(callback: BodyResponseCallback<Schema$DatacenterConnector>): void;
3461
5153
  /**
3462
5154
  * Lists DatacenterConnectors in a given Source.
5155
+ * @example
5156
+ * ```js
5157
+ * // Before running the sample:
5158
+ * // - Enable the API at:
5159
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5160
+ * // - Login into gcloud by running:
5161
+ * // ```sh
5162
+ * // $ gcloud auth application-default login
5163
+ * // ```
5164
+ * // - Install the npm module by running:
5165
+ * // ```sh
5166
+ * // $ npm install googleapis
5167
+ * // ```
5168
+ *
5169
+ * const {google} = require('googleapis');
5170
+ * const vmmigration = google.vmmigration('v1');
5171
+ *
5172
+ * async function main() {
5173
+ * const auth = new google.auth.GoogleAuth({
5174
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5175
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5176
+ * });
5177
+ *
5178
+ * // Acquire an auth client, and bind it to all future calls
5179
+ * const authClient = await auth.getClient();
5180
+ * google.options({auth: authClient});
5181
+ *
5182
+ * // Do the magic
5183
+ * const res =
5184
+ * await vmmigration.projects.locations.sources.datacenterConnectors.list({
5185
+ * // Optional. The filter request.
5186
+ * filter: 'placeholder-value',
5187
+ * // Optional. the order by fields for the result.
5188
+ * orderBy: 'placeholder-value',
5189
+ * // 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.
5190
+ * pageSize: 'placeholder-value',
5191
+ * // 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.
5192
+ * pageToken: 'placeholder-value',
5193
+ * // Required. The parent, which owns this collection of connectors.
5194
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
5195
+ * });
5196
+ * console.log(res.data);
5197
+ *
5198
+ * // Example response
5199
+ * // {
5200
+ * // "datacenterConnectors": [],
5201
+ * // "nextPageToken": "my_nextPageToken",
5202
+ * // "unreachable": []
5203
+ * // }
5204
+ * }
5205
+ *
5206
+ * main().catch(e => {
5207
+ * console.error(e);
5208
+ * throw e;
5209
+ * });
5210
+ *
5211
+ * ```
3463
5212
  *
3464
5213
  * @param params - Parameters for request
3465
5214
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3474,6 +5223,68 @@ export declare namespace vmmigration_v1 {
3474
5223
  list(callback: BodyResponseCallback<Schema$ListDatacenterConnectorsResponse>): void;
3475
5224
  /**
3476
5225
  * Upgrades the appliance relate to this DatacenterConnector to the in-place updateable version.
5226
+ * @example
5227
+ * ```js
5228
+ * // Before running the sample:
5229
+ * // - Enable the API at:
5230
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5231
+ * // - Login into gcloud by running:
5232
+ * // ```sh
5233
+ * // $ gcloud auth application-default login
5234
+ * // ```
5235
+ * // - Install the npm module by running:
5236
+ * // ```sh
5237
+ * // $ npm install googleapis
5238
+ * // ```
5239
+ *
5240
+ * const {google} = require('googleapis');
5241
+ * const vmmigration = google.vmmigration('v1');
5242
+ *
5243
+ * async function main() {
5244
+ * const auth = new google.auth.GoogleAuth({
5245
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5246
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5247
+ * });
5248
+ *
5249
+ * // Acquire an auth client, and bind it to all future calls
5250
+ * const authClient = await auth.getClient();
5251
+ * google.options({auth: authClient});
5252
+ *
5253
+ * // Do the magic
5254
+ * const res =
5255
+ * await vmmigration.projects.locations.sources.datacenterConnectors.upgradeAppliance(
5256
+ * {
5257
+ * // Required. The DatacenterConnector name.
5258
+ * datacenterConnector:
5259
+ * 'projects/my-project/locations/my-location/sources/my-source/datacenterConnectors/my-datacenterConnector',
5260
+ *
5261
+ * // Request body metadata
5262
+ * requestBody: {
5263
+ * // request body parameters
5264
+ * // {
5265
+ * // "requestId": "my_requestId"
5266
+ * // }
5267
+ * },
5268
+ * },
5269
+ * );
5270
+ * console.log(res.data);
5271
+ *
5272
+ * // Example response
5273
+ * // {
5274
+ * // "done": false,
5275
+ * // "error": {},
5276
+ * // "metadata": {},
5277
+ * // "name": "my_name",
5278
+ * // "response": {}
5279
+ * // }
5280
+ * }
5281
+ *
5282
+ * main().catch(e => {
5283
+ * console.error(e);
5284
+ * throw e;
5285
+ * });
5286
+ *
5287
+ * ```
3477
5288
  *
3478
5289
  * @param params - Parameters for request
3479
5290
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3561,6 +5372,91 @@ export declare namespace vmmigration_v1 {
3561
5372
  constructor(context: APIRequestContext);
3562
5373
  /**
3563
5374
  * Creates a new MigratingVm in a given Source.
5375
+ * @example
5376
+ * ```js
5377
+ * // Before running the sample:
5378
+ * // - Enable the API at:
5379
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5380
+ * // - Login into gcloud by running:
5381
+ * // ```sh
5382
+ * // $ gcloud auth application-default login
5383
+ * // ```
5384
+ * // - Install the npm module by running:
5385
+ * // ```sh
5386
+ * // $ npm install googleapis
5387
+ * // ```
5388
+ *
5389
+ * const {google} = require('googleapis');
5390
+ * const vmmigration = google.vmmigration('v1');
5391
+ *
5392
+ * async function main() {
5393
+ * const auth = new google.auth.GoogleAuth({
5394
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5395
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5396
+ * });
5397
+ *
5398
+ * // Acquire an auth client, and bind it to all future calls
5399
+ * const authClient = await auth.getClient();
5400
+ * google.options({auth: authClient});
5401
+ *
5402
+ * // Do the magic
5403
+ * const res = await vmmigration.projects.locations.sources.migratingVms.create({
5404
+ * // Required. The migratingVm identifier.
5405
+ * migratingVmId: 'placeholder-value',
5406
+ * // Required. The MigratingVm's parent.
5407
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
5408
+ * // 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).
5409
+ * requestId: 'placeholder-value',
5410
+ *
5411
+ * // Request body metadata
5412
+ * requestBody: {
5413
+ * // request body parameters
5414
+ * // {
5415
+ * // "awsSourceVmDetails": {},
5416
+ * // "azureSourceVmDetails": {},
5417
+ * // "computeEngineDisksTargetDefaults": {},
5418
+ * // "computeEngineTargetDefaults": {},
5419
+ * // "createTime": "my_createTime",
5420
+ * // "currentSyncInfo": {},
5421
+ * // "cutoverForecast": {},
5422
+ * // "description": "my_description",
5423
+ * // "displayName": "my_displayName",
5424
+ * // "error": {},
5425
+ * // "expiration": {},
5426
+ * // "group": "my_group",
5427
+ * // "labels": {},
5428
+ * // "lastReplicationCycle": {},
5429
+ * // "lastSync": {},
5430
+ * // "name": "my_name",
5431
+ * // "policy": {},
5432
+ * // "recentCloneJobs": [],
5433
+ * // "recentCutoverJobs": [],
5434
+ * // "sourceVmId": "my_sourceVmId",
5435
+ * // "state": "my_state",
5436
+ * // "stateTime": "my_stateTime",
5437
+ * // "updateTime": "my_updateTime",
5438
+ * // "vmwareSourceVmDetails": {}
5439
+ * // }
5440
+ * },
5441
+ * });
5442
+ * console.log(res.data);
5443
+ *
5444
+ * // Example response
5445
+ * // {
5446
+ * // "done": false,
5447
+ * // "error": {},
5448
+ * // "metadata": {},
5449
+ * // "name": "my_name",
5450
+ * // "response": {}
5451
+ * // }
5452
+ * }
5453
+ *
5454
+ * main().catch(e => {
5455
+ * console.error(e);
5456
+ * throw e;
5457
+ * });
5458
+ *
5459
+ * ```
3564
5460
  *
3565
5461
  * @param params - Parameters for request
3566
5462
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3575,6 +5471,56 @@ export declare namespace vmmigration_v1 {
3575
5471
  create(callback: BodyResponseCallback<Schema$Operation>): void;
3576
5472
  /**
3577
5473
  * Deletes a single MigratingVm.
5474
+ * @example
5475
+ * ```js
5476
+ * // Before running the sample:
5477
+ * // - Enable the API at:
5478
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5479
+ * // - Login into gcloud by running:
5480
+ * // ```sh
5481
+ * // $ gcloud auth application-default login
5482
+ * // ```
5483
+ * // - Install the npm module by running:
5484
+ * // ```sh
5485
+ * // $ npm install googleapis
5486
+ * // ```
5487
+ *
5488
+ * const {google} = require('googleapis');
5489
+ * const vmmigration = google.vmmigration('v1');
5490
+ *
5491
+ * async function main() {
5492
+ * const auth = new google.auth.GoogleAuth({
5493
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5494
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5495
+ * });
5496
+ *
5497
+ * // Acquire an auth client, and bind it to all future calls
5498
+ * const authClient = await auth.getClient();
5499
+ * google.options({auth: authClient});
5500
+ *
5501
+ * // Do the magic
5502
+ * const res = await vmmigration.projects.locations.sources.migratingVms.delete({
5503
+ * // Required. The name of the MigratingVm.
5504
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
5505
+ * });
5506
+ * console.log(res.data);
5507
+ *
5508
+ * // Example response
5509
+ * // {
5510
+ * // "done": false,
5511
+ * // "error": {},
5512
+ * // "metadata": {},
5513
+ * // "name": "my_name",
5514
+ * // "response": {}
5515
+ * // }
5516
+ * }
5517
+ *
5518
+ * main().catch(e => {
5519
+ * console.error(e);
5520
+ * throw e;
5521
+ * });
5522
+ *
5523
+ * ```
3578
5524
  *
3579
5525
  * @param params - Parameters for request
3580
5526
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3587,8 +5533,140 @@ export declare namespace vmmigration_v1 {
3587
5533
  delete(params: Params$Resource$Projects$Locations$Sources$Migratingvms$Delete, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
3588
5534
  delete(params: Params$Resource$Projects$Locations$Sources$Migratingvms$Delete, callback: BodyResponseCallback<Schema$Operation>): void;
3589
5535
  delete(callback: BodyResponseCallback<Schema$Operation>): void;
5536
+ /**
5537
+ * Extend the migrating VM time to live.
5538
+ * @example
5539
+ * ```js
5540
+ * // Before running the sample:
5541
+ * // - Enable the API at:
5542
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5543
+ * // - Login into gcloud by running:
5544
+ * // ```sh
5545
+ * // $ gcloud auth application-default login
5546
+ * // ```
5547
+ * // - Install the npm module by running:
5548
+ * // ```sh
5549
+ * // $ npm install googleapis
5550
+ * // ```
5551
+ *
5552
+ * const {google} = require('googleapis');
5553
+ * const vmmigration = google.vmmigration('v1');
5554
+ *
5555
+ * async function main() {
5556
+ * const auth = new google.auth.GoogleAuth({
5557
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5558
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5559
+ * });
5560
+ *
5561
+ * // Acquire an auth client, and bind it to all future calls
5562
+ * const authClient = await auth.getClient();
5563
+ * google.options({auth: authClient});
5564
+ *
5565
+ * // Do the magic
5566
+ * const res =
5567
+ * await vmmigration.projects.locations.sources.migratingVms.extendMigration({
5568
+ * // Required. The name of the MigratingVm.
5569
+ * migratingVm:
5570
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
5571
+ *
5572
+ * // Request body metadata
5573
+ * requestBody: {
5574
+ * // request body parameters
5575
+ * // {}
5576
+ * },
5577
+ * });
5578
+ * console.log(res.data);
5579
+ *
5580
+ * // Example response
5581
+ * // {
5582
+ * // "done": false,
5583
+ * // "error": {},
5584
+ * // "metadata": {},
5585
+ * // "name": "my_name",
5586
+ * // "response": {}
5587
+ * // }
5588
+ * }
5589
+ *
5590
+ * main().catch(e => {
5591
+ * console.error(e);
5592
+ * throw e;
5593
+ * });
5594
+ *
5595
+ * ```
5596
+ *
5597
+ * @param params - Parameters for request
5598
+ * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5599
+ * @param callback - Optional callback that handles the response.
5600
+ * @returns A promise if used with async/await, or void if used with a callback.
5601
+ */
5602
+ extendMigration(params: Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
5603
+ extendMigration(params?: Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
5604
+ extendMigration(params: Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5605
+ extendMigration(params: Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
5606
+ extendMigration(params: Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration, callback: BodyResponseCallback<Schema$Operation>): void;
5607
+ extendMigration(callback: BodyResponseCallback<Schema$Operation>): void;
3590
5608
  /**
3591
5609
  * Marks a migration as completed, deleting migration resources that are no longer being used. Only applicable after cutover is done.
5610
+ * @example
5611
+ * ```js
5612
+ * // Before running the sample:
5613
+ * // - Enable the API at:
5614
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5615
+ * // - Login into gcloud by running:
5616
+ * // ```sh
5617
+ * // $ gcloud auth application-default login
5618
+ * // ```
5619
+ * // - Install the npm module by running:
5620
+ * // ```sh
5621
+ * // $ npm install googleapis
5622
+ * // ```
5623
+ *
5624
+ * const {google} = require('googleapis');
5625
+ * const vmmigration = google.vmmigration('v1');
5626
+ *
5627
+ * async function main() {
5628
+ * const auth = new google.auth.GoogleAuth({
5629
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5630
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5631
+ * });
5632
+ *
5633
+ * // Acquire an auth client, and bind it to all future calls
5634
+ * const authClient = await auth.getClient();
5635
+ * google.options({auth: authClient});
5636
+ *
5637
+ * // Do the magic
5638
+ * const res =
5639
+ * await vmmigration.projects.locations.sources.migratingVms.finalizeMigration(
5640
+ * {
5641
+ * // Required. The name of the MigratingVm.
5642
+ * migratingVm:
5643
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
5644
+ *
5645
+ * // Request body metadata
5646
+ * requestBody: {
5647
+ * // request body parameters
5648
+ * // {}
5649
+ * },
5650
+ * },
5651
+ * );
5652
+ * console.log(res.data);
5653
+ *
5654
+ * // Example response
5655
+ * // {
5656
+ * // "done": false,
5657
+ * // "error": {},
5658
+ * // "metadata": {},
5659
+ * // "name": "my_name",
5660
+ * // "response": {}
5661
+ * // }
5662
+ * }
5663
+ *
5664
+ * main().catch(e => {
5665
+ * console.error(e);
5666
+ * throw e;
5667
+ * });
5668
+ *
5669
+ * ```
3592
5670
  *
3593
5671
  * @param params - Parameters for request
3594
5672
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3603,6 +5681,77 @@ export declare namespace vmmigration_v1 {
3603
5681
  finalizeMigration(callback: BodyResponseCallback<Schema$Operation>): void;
3604
5682
  /**
3605
5683
  * Gets details of a single MigratingVm.
5684
+ * @example
5685
+ * ```js
5686
+ * // Before running the sample:
5687
+ * // - Enable the API at:
5688
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5689
+ * // - Login into gcloud by running:
5690
+ * // ```sh
5691
+ * // $ gcloud auth application-default login
5692
+ * // ```
5693
+ * // - Install the npm module by running:
5694
+ * // ```sh
5695
+ * // $ npm install googleapis
5696
+ * // ```
5697
+ *
5698
+ * const {google} = require('googleapis');
5699
+ * const vmmigration = google.vmmigration('v1');
5700
+ *
5701
+ * async function main() {
5702
+ * const auth = new google.auth.GoogleAuth({
5703
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5704
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5705
+ * });
5706
+ *
5707
+ * // Acquire an auth client, and bind it to all future calls
5708
+ * const authClient = await auth.getClient();
5709
+ * google.options({auth: authClient});
5710
+ *
5711
+ * // Do the magic
5712
+ * const res = await vmmigration.projects.locations.sources.migratingVms.get({
5713
+ * // Required. The name of the MigratingVm.
5714
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
5715
+ * // Optional. The level of details of the migrating VM.
5716
+ * view: 'placeholder-value',
5717
+ * });
5718
+ * console.log(res.data);
5719
+ *
5720
+ * // Example response
5721
+ * // {
5722
+ * // "awsSourceVmDetails": {},
5723
+ * // "azureSourceVmDetails": {},
5724
+ * // "computeEngineDisksTargetDefaults": {},
5725
+ * // "computeEngineTargetDefaults": {},
5726
+ * // "createTime": "my_createTime",
5727
+ * // "currentSyncInfo": {},
5728
+ * // "cutoverForecast": {},
5729
+ * // "description": "my_description",
5730
+ * // "displayName": "my_displayName",
5731
+ * // "error": {},
5732
+ * // "expiration": {},
5733
+ * // "group": "my_group",
5734
+ * // "labels": {},
5735
+ * // "lastReplicationCycle": {},
5736
+ * // "lastSync": {},
5737
+ * // "name": "my_name",
5738
+ * // "policy": {},
5739
+ * // "recentCloneJobs": [],
5740
+ * // "recentCutoverJobs": [],
5741
+ * // "sourceVmId": "my_sourceVmId",
5742
+ * // "state": "my_state",
5743
+ * // "stateTime": "my_stateTime",
5744
+ * // "updateTime": "my_updateTime",
5745
+ * // "vmwareSourceVmDetails": {}
5746
+ * // }
5747
+ * }
5748
+ *
5749
+ * main().catch(e => {
5750
+ * console.error(e);
5751
+ * throw e;
5752
+ * });
5753
+ *
5754
+ * ```
3606
5755
  *
3607
5756
  * @param params - Parameters for request
3608
5757
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3617,6 +5766,64 @@ export declare namespace vmmigration_v1 {
3617
5766
  get(callback: BodyResponseCallback<Schema$MigratingVm>): void;
3618
5767
  /**
3619
5768
  * Lists MigratingVms in a given Source.
5769
+ * @example
5770
+ * ```js
5771
+ * // Before running the sample:
5772
+ * // - Enable the API at:
5773
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5774
+ * // - Login into gcloud by running:
5775
+ * // ```sh
5776
+ * // $ gcloud auth application-default login
5777
+ * // ```
5778
+ * // - Install the npm module by running:
5779
+ * // ```sh
5780
+ * // $ npm install googleapis
5781
+ * // ```
5782
+ *
5783
+ * const {google} = require('googleapis');
5784
+ * const vmmigration = google.vmmigration('v1');
5785
+ *
5786
+ * async function main() {
5787
+ * const auth = new google.auth.GoogleAuth({
5788
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5789
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5790
+ * });
5791
+ *
5792
+ * // Acquire an auth client, and bind it to all future calls
5793
+ * const authClient = await auth.getClient();
5794
+ * google.options({auth: authClient});
5795
+ *
5796
+ * // Do the magic
5797
+ * const res = await vmmigration.projects.locations.sources.migratingVms.list({
5798
+ * // Optional. The filter request.
5799
+ * filter: 'placeholder-value',
5800
+ * // Optional. the order by fields for the result.
5801
+ * orderBy: 'placeholder-value',
5802
+ * // 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.
5803
+ * pageSize: 'placeholder-value',
5804
+ * // 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.
5805
+ * pageToken: 'placeholder-value',
5806
+ * // Required. The parent, which owns this collection of MigratingVms.
5807
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
5808
+ * // Optional. The level of details of each migrating VM.
5809
+ * view: 'placeholder-value',
5810
+ * });
5811
+ * console.log(res.data);
5812
+ *
5813
+ * // Example response
5814
+ * // {
5815
+ * // "migratingVms": [],
5816
+ * // "nextPageToken": "my_nextPageToken",
5817
+ * // "unreachable": []
5818
+ * // }
5819
+ * }
5820
+ *
5821
+ * main().catch(e => {
5822
+ * console.error(e);
5823
+ * throw e;
5824
+ * });
5825
+ *
5826
+ * ```
3620
5827
  *
3621
5828
  * @param params - Parameters for request
3622
5829
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3631,6 +5838,91 @@ export declare namespace vmmigration_v1 {
3631
5838
  list(callback: BodyResponseCallback<Schema$ListMigratingVmsResponse>): void;
3632
5839
  /**
3633
5840
  * Updates the parameters of a single MigratingVm.
5841
+ * @example
5842
+ * ```js
5843
+ * // Before running the sample:
5844
+ * // - Enable the API at:
5845
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5846
+ * // - Login into gcloud by running:
5847
+ * // ```sh
5848
+ * // $ gcloud auth application-default login
5849
+ * // ```
5850
+ * // - Install the npm module by running:
5851
+ * // ```sh
5852
+ * // $ npm install googleapis
5853
+ * // ```
5854
+ *
5855
+ * const {google} = require('googleapis');
5856
+ * const vmmigration = google.vmmigration('v1');
5857
+ *
5858
+ * async function main() {
5859
+ * const auth = new google.auth.GoogleAuth({
5860
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5861
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5862
+ * });
5863
+ *
5864
+ * // Acquire an auth client, and bind it to all future calls
5865
+ * const authClient = await auth.getClient();
5866
+ * google.options({auth: authClient});
5867
+ *
5868
+ * // Do the magic
5869
+ * const res = await vmmigration.projects.locations.sources.migratingVms.patch({
5870
+ * // Output only. The identifier of the MigratingVm.
5871
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
5872
+ * // 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).
5873
+ * requestId: 'placeholder-value',
5874
+ * // 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.
5875
+ * updateMask: 'placeholder-value',
5876
+ *
5877
+ * // Request body metadata
5878
+ * requestBody: {
5879
+ * // request body parameters
5880
+ * // {
5881
+ * // "awsSourceVmDetails": {},
5882
+ * // "azureSourceVmDetails": {},
5883
+ * // "computeEngineDisksTargetDefaults": {},
5884
+ * // "computeEngineTargetDefaults": {},
5885
+ * // "createTime": "my_createTime",
5886
+ * // "currentSyncInfo": {},
5887
+ * // "cutoverForecast": {},
5888
+ * // "description": "my_description",
5889
+ * // "displayName": "my_displayName",
5890
+ * // "error": {},
5891
+ * // "expiration": {},
5892
+ * // "group": "my_group",
5893
+ * // "labels": {},
5894
+ * // "lastReplicationCycle": {},
5895
+ * // "lastSync": {},
5896
+ * // "name": "my_name",
5897
+ * // "policy": {},
5898
+ * // "recentCloneJobs": [],
5899
+ * // "recentCutoverJobs": [],
5900
+ * // "sourceVmId": "my_sourceVmId",
5901
+ * // "state": "my_state",
5902
+ * // "stateTime": "my_stateTime",
5903
+ * // "updateTime": "my_updateTime",
5904
+ * // "vmwareSourceVmDetails": {}
5905
+ * // }
5906
+ * },
5907
+ * });
5908
+ * console.log(res.data);
5909
+ *
5910
+ * // Example response
5911
+ * // {
5912
+ * // "done": false,
5913
+ * // "error": {},
5914
+ * // "metadata": {},
5915
+ * // "name": "my_name",
5916
+ * // "response": {}
5917
+ * // }
5918
+ * }
5919
+ *
5920
+ * main().catch(e => {
5921
+ * console.error(e);
5922
+ * throw e;
5923
+ * });
5924
+ *
5925
+ * ```
3634
5926
  *
3635
5927
  * @param params - Parameters for request
3636
5928
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3645,6 +5937,64 @@ export declare namespace vmmigration_v1 {
3645
5937
  patch(callback: BodyResponseCallback<Schema$Operation>): void;
3646
5938
  /**
3647
5939
  * 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.
5940
+ * @example
5941
+ * ```js
5942
+ * // Before running the sample:
5943
+ * // - Enable the API at:
5944
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
5945
+ * // - Login into gcloud by running:
5946
+ * // ```sh
5947
+ * // $ gcloud auth application-default login
5948
+ * // ```
5949
+ * // - Install the npm module by running:
5950
+ * // ```sh
5951
+ * // $ npm install googleapis
5952
+ * // ```
5953
+ *
5954
+ * const {google} = require('googleapis');
5955
+ * const vmmigration = google.vmmigration('v1');
5956
+ *
5957
+ * async function main() {
5958
+ * const auth = new google.auth.GoogleAuth({
5959
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5960
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5961
+ * });
5962
+ *
5963
+ * // Acquire an auth client, and bind it to all future calls
5964
+ * const authClient = await auth.getClient();
5965
+ * google.options({auth: authClient});
5966
+ *
5967
+ * // Do the magic
5968
+ * const res =
5969
+ * await vmmigration.projects.locations.sources.migratingVms.pauseMigration({
5970
+ * // Required. The name of the MigratingVm.
5971
+ * migratingVm:
5972
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
5973
+ *
5974
+ * // Request body metadata
5975
+ * requestBody: {
5976
+ * // request body parameters
5977
+ * // {}
5978
+ * },
5979
+ * });
5980
+ * console.log(res.data);
5981
+ *
5982
+ * // Example response
5983
+ * // {
5984
+ * // "done": false,
5985
+ * // "error": {},
5986
+ * // "metadata": {},
5987
+ * // "name": "my_name",
5988
+ * // "response": {}
5989
+ * // }
5990
+ * }
5991
+ *
5992
+ * main().catch(e => {
5993
+ * console.error(e);
5994
+ * throw e;
5995
+ * });
5996
+ *
5997
+ * ```
3648
5998
  *
3649
5999
  * @param params - Parameters for request
3650
6000
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3659,6 +6009,64 @@ export declare namespace vmmigration_v1 {
3659
6009
  pauseMigration(callback: BodyResponseCallback<Schema$Operation>): void;
3660
6010
  /**
3661
6011
  * 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.
6012
+ * @example
6013
+ * ```js
6014
+ * // Before running the sample:
6015
+ * // - Enable the API at:
6016
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6017
+ * // - Login into gcloud by running:
6018
+ * // ```sh
6019
+ * // $ gcloud auth application-default login
6020
+ * // ```
6021
+ * // - Install the npm module by running:
6022
+ * // ```sh
6023
+ * // $ npm install googleapis
6024
+ * // ```
6025
+ *
6026
+ * const {google} = require('googleapis');
6027
+ * const vmmigration = google.vmmigration('v1');
6028
+ *
6029
+ * async function main() {
6030
+ * const auth = new google.auth.GoogleAuth({
6031
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6032
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6033
+ * });
6034
+ *
6035
+ * // Acquire an auth client, and bind it to all future calls
6036
+ * const authClient = await auth.getClient();
6037
+ * google.options({auth: authClient});
6038
+ *
6039
+ * // Do the magic
6040
+ * const res =
6041
+ * await vmmigration.projects.locations.sources.migratingVms.resumeMigration({
6042
+ * // Required. The name of the MigratingVm.
6043
+ * migratingVm:
6044
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
6045
+ *
6046
+ * // Request body metadata
6047
+ * requestBody: {
6048
+ * // request body parameters
6049
+ * // {}
6050
+ * },
6051
+ * });
6052
+ * console.log(res.data);
6053
+ *
6054
+ * // Example response
6055
+ * // {
6056
+ * // "done": false,
6057
+ * // "error": {},
6058
+ * // "metadata": {},
6059
+ * // "name": "my_name",
6060
+ * // "response": {}
6061
+ * // }
6062
+ * }
6063
+ *
6064
+ * main().catch(e => {
6065
+ * console.error(e);
6066
+ * throw e;
6067
+ * });
6068
+ *
6069
+ * ```
3662
6070
  *
3663
6071
  * @param params - Parameters for request
3664
6072
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3673,6 +6081,64 @@ export declare namespace vmmigration_v1 {
3673
6081
  resumeMigration(callback: BodyResponseCallback<Schema$Operation>): void;
3674
6082
  /**
3675
6083
  * Starts migration for a VM. Starts the process of uploading data and creating snapshots, in replication cycles scheduled by the policy.
6084
+ * @example
6085
+ * ```js
6086
+ * // Before running the sample:
6087
+ * // - Enable the API at:
6088
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6089
+ * // - Login into gcloud by running:
6090
+ * // ```sh
6091
+ * // $ gcloud auth application-default login
6092
+ * // ```
6093
+ * // - Install the npm module by running:
6094
+ * // ```sh
6095
+ * // $ npm install googleapis
6096
+ * // ```
6097
+ *
6098
+ * const {google} = require('googleapis');
6099
+ * const vmmigration = google.vmmigration('v1');
6100
+ *
6101
+ * async function main() {
6102
+ * const auth = new google.auth.GoogleAuth({
6103
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6104
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6105
+ * });
6106
+ *
6107
+ * // Acquire an auth client, and bind it to all future calls
6108
+ * const authClient = await auth.getClient();
6109
+ * google.options({auth: authClient});
6110
+ *
6111
+ * // Do the magic
6112
+ * const res =
6113
+ * await vmmigration.projects.locations.sources.migratingVms.startMigration({
6114
+ * // Required. The name of the MigratingVm.
6115
+ * migratingVm:
6116
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
6117
+ *
6118
+ * // Request body metadata
6119
+ * requestBody: {
6120
+ * // request body parameters
6121
+ * // {}
6122
+ * },
6123
+ * });
6124
+ * console.log(res.data);
6125
+ *
6126
+ * // Example response
6127
+ * // {
6128
+ * // "done": false,
6129
+ * // "error": {},
6130
+ * // "metadata": {},
6131
+ * // "name": "my_name",
6132
+ * // "response": {}
6133
+ * // }
6134
+ * }
6135
+ *
6136
+ * main().catch(e => {
6137
+ * console.error(e);
6138
+ * throw e;
6139
+ * });
6140
+ *
6141
+ * ```
3676
6142
  *
3677
6143
  * @param params - Parameters for request
3678
6144
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3710,6 +6176,16 @@ export declare namespace vmmigration_v1 {
3710
6176
  */
3711
6177
  name?: string;
3712
6178
  }
6179
+ export interface Params$Resource$Projects$Locations$Sources$Migratingvms$Extendmigration extends StandardParameters {
6180
+ /**
6181
+ * Required. The name of the MigratingVm.
6182
+ */
6183
+ migratingVm?: string;
6184
+ /**
6185
+ * Request body metadata
6186
+ */
6187
+ requestBody?: Schema$ExtendMigrationRequest;
6188
+ }
3713
6189
  export interface Params$Resource$Projects$Locations$Sources$Migratingvms$Finalizemigration extends StandardParameters {
3714
6190
  /**
3715
6191
  * Required. The name of the MigratingVm.
@@ -3809,6 +6285,63 @@ export declare namespace vmmigration_v1 {
3809
6285
  constructor(context: APIRequestContext);
3810
6286
  /**
3811
6287
  * Initiates the cancellation of a running clone job.
6288
+ * @example
6289
+ * ```js
6290
+ * // Before running the sample:
6291
+ * // - Enable the API at:
6292
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6293
+ * // - Login into gcloud by running:
6294
+ * // ```sh
6295
+ * // $ gcloud auth application-default login
6296
+ * // ```
6297
+ * // - Install the npm module by running:
6298
+ * // ```sh
6299
+ * // $ npm install googleapis
6300
+ * // ```
6301
+ *
6302
+ * const {google} = require('googleapis');
6303
+ * const vmmigration = google.vmmigration('v1');
6304
+ *
6305
+ * async function main() {
6306
+ * const auth = new google.auth.GoogleAuth({
6307
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6308
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6309
+ * });
6310
+ *
6311
+ * // Acquire an auth client, and bind it to all future calls
6312
+ * const authClient = await auth.getClient();
6313
+ * google.options({auth: authClient});
6314
+ *
6315
+ * // Do the magic
6316
+ * const res =
6317
+ * await vmmigration.projects.locations.sources.migratingVms.cloneJobs.cancel({
6318
+ * // Required. The clone job id
6319
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm/cloneJobs/my-cloneJob',
6320
+ *
6321
+ * // Request body metadata
6322
+ * requestBody: {
6323
+ * // request body parameters
6324
+ * // {}
6325
+ * },
6326
+ * });
6327
+ * console.log(res.data);
6328
+ *
6329
+ * // Example response
6330
+ * // {
6331
+ * // "done": false,
6332
+ * // "error": {},
6333
+ * // "metadata": {},
6334
+ * // "name": "my_name",
6335
+ * // "response": {}
6336
+ * // }
6337
+ * }
6338
+ *
6339
+ * main().catch(e => {
6340
+ * console.error(e);
6341
+ * throw e;
6342
+ * });
6343
+ *
6344
+ * ```
3812
6345
  *
3813
6346
  * @param params - Parameters for request
3814
6347
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3823,6 +6356,78 @@ export declare namespace vmmigration_v1 {
3823
6356
  cancel(callback: BodyResponseCallback<Schema$Operation>): void;
3824
6357
  /**
3825
6358
  * Initiates a Clone of a specific migrating VM.
6359
+ * @example
6360
+ * ```js
6361
+ * // Before running the sample:
6362
+ * // - Enable the API at:
6363
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6364
+ * // - Login into gcloud by running:
6365
+ * // ```sh
6366
+ * // $ gcloud auth application-default login
6367
+ * // ```
6368
+ * // - Install the npm module by running:
6369
+ * // ```sh
6370
+ * // $ npm install googleapis
6371
+ * // ```
6372
+ *
6373
+ * const {google} = require('googleapis');
6374
+ * const vmmigration = google.vmmigration('v1');
6375
+ *
6376
+ * async function main() {
6377
+ * const auth = new google.auth.GoogleAuth({
6378
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6379
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6380
+ * });
6381
+ *
6382
+ * // Acquire an auth client, and bind it to all future calls
6383
+ * const authClient = await auth.getClient();
6384
+ * google.options({auth: authClient});
6385
+ *
6386
+ * // Do the magic
6387
+ * const res =
6388
+ * await vmmigration.projects.locations.sources.migratingVms.cloneJobs.create({
6389
+ * // Required. The clone job identifier.
6390
+ * cloneJobId: 'placeholder-value',
6391
+ * // Required. The Clone's parent.
6392
+ * parent:
6393
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
6394
+ * // 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).
6395
+ * requestId: 'placeholder-value',
6396
+ *
6397
+ * // Request body metadata
6398
+ * requestBody: {
6399
+ * // request body parameters
6400
+ * // {
6401
+ * // "computeEngineDisksTargetDetails": {},
6402
+ * // "computeEngineTargetDetails": {},
6403
+ * // "createTime": "my_createTime",
6404
+ * // "endTime": "my_endTime",
6405
+ * // "error": {},
6406
+ * // "name": "my_name",
6407
+ * // "state": "my_state",
6408
+ * // "stateTime": "my_stateTime",
6409
+ * // "steps": []
6410
+ * // }
6411
+ * },
6412
+ * });
6413
+ * console.log(res.data);
6414
+ *
6415
+ * // Example response
6416
+ * // {
6417
+ * // "done": false,
6418
+ * // "error": {},
6419
+ * // "metadata": {},
6420
+ * // "name": "my_name",
6421
+ * // "response": {}
6422
+ * // }
6423
+ * }
6424
+ *
6425
+ * main().catch(e => {
6426
+ * console.error(e);
6427
+ * throw e;
6428
+ * });
6429
+ *
6430
+ * ```
3826
6431
  *
3827
6432
  * @param params - Parameters for request
3828
6433
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3837,6 +6442,61 @@ export declare namespace vmmigration_v1 {
3837
6442
  create(callback: BodyResponseCallback<Schema$Operation>): void;
3838
6443
  /**
3839
6444
  * Gets details of a single CloneJob.
6445
+ * @example
6446
+ * ```js
6447
+ * // Before running the sample:
6448
+ * // - Enable the API at:
6449
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6450
+ * // - Login into gcloud by running:
6451
+ * // ```sh
6452
+ * // $ gcloud auth application-default login
6453
+ * // ```
6454
+ * // - Install the npm module by running:
6455
+ * // ```sh
6456
+ * // $ npm install googleapis
6457
+ * // ```
6458
+ *
6459
+ * const {google} = require('googleapis');
6460
+ * const vmmigration = google.vmmigration('v1');
6461
+ *
6462
+ * async function main() {
6463
+ * const auth = new google.auth.GoogleAuth({
6464
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6465
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6466
+ * });
6467
+ *
6468
+ * // Acquire an auth client, and bind it to all future calls
6469
+ * const authClient = await auth.getClient();
6470
+ * google.options({auth: authClient});
6471
+ *
6472
+ * // Do the magic
6473
+ * const res =
6474
+ * await vmmigration.projects.locations.sources.migratingVms.cloneJobs.get({
6475
+ * // Required. The name of the CloneJob.
6476
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm/cloneJobs/my-cloneJob',
6477
+ * });
6478
+ * console.log(res.data);
6479
+ *
6480
+ * // Example response
6481
+ * // {
6482
+ * // "computeEngineDisksTargetDetails": {},
6483
+ * // "computeEngineTargetDetails": {},
6484
+ * // "createTime": "my_createTime",
6485
+ * // "endTime": "my_endTime",
6486
+ * // "error": {},
6487
+ * // "name": "my_name",
6488
+ * // "state": "my_state",
6489
+ * // "stateTime": "my_stateTime",
6490
+ * // "steps": []
6491
+ * // }
6492
+ * }
6493
+ *
6494
+ * main().catch(e => {
6495
+ * console.error(e);
6496
+ * throw e;
6497
+ * });
6498
+ *
6499
+ * ```
3840
6500
  *
3841
6501
  * @param params - Parameters for request
3842
6502
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3851,6 +6511,64 @@ export declare namespace vmmigration_v1 {
3851
6511
  get(callback: BodyResponseCallback<Schema$CloneJob>): void;
3852
6512
  /**
3853
6513
  * Lists the CloneJobs of a migrating VM. Only 25 most recent CloneJobs are listed.
6514
+ * @example
6515
+ * ```js
6516
+ * // Before running the sample:
6517
+ * // - Enable the API at:
6518
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6519
+ * // - Login into gcloud by running:
6520
+ * // ```sh
6521
+ * // $ gcloud auth application-default login
6522
+ * // ```
6523
+ * // - Install the npm module by running:
6524
+ * // ```sh
6525
+ * // $ npm install googleapis
6526
+ * // ```
6527
+ *
6528
+ * const {google} = require('googleapis');
6529
+ * const vmmigration = google.vmmigration('v1');
6530
+ *
6531
+ * async function main() {
6532
+ * const auth = new google.auth.GoogleAuth({
6533
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6534
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6535
+ * });
6536
+ *
6537
+ * // Acquire an auth client, and bind it to all future calls
6538
+ * const authClient = await auth.getClient();
6539
+ * google.options({auth: authClient});
6540
+ *
6541
+ * // Do the magic
6542
+ * const res =
6543
+ * await vmmigration.projects.locations.sources.migratingVms.cloneJobs.list({
6544
+ * // Optional. The filter request.
6545
+ * filter: 'placeholder-value',
6546
+ * // Optional. the order by fields for the result.
6547
+ * orderBy: 'placeholder-value',
6548
+ * // 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.
6549
+ * pageSize: 'placeholder-value',
6550
+ * // 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.
6551
+ * pageToken: 'placeholder-value',
6552
+ * // Required. The parent, which owns this collection of source VMs.
6553
+ * parent:
6554
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
6555
+ * });
6556
+ * console.log(res.data);
6557
+ *
6558
+ * // Example response
6559
+ * // {
6560
+ * // "cloneJobs": [],
6561
+ * // "nextPageToken": "my_nextPageToken",
6562
+ * // "unreachable": []
6563
+ * // }
6564
+ * }
6565
+ *
6566
+ * main().catch(e => {
6567
+ * console.error(e);
6568
+ * throw e;
6569
+ * });
6570
+ *
6571
+ * ```
3854
6572
  *
3855
6573
  * @param params - Parameters for request
3856
6574
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3925,6 +6643,65 @@ export declare namespace vmmigration_v1 {
3925
6643
  constructor(context: APIRequestContext);
3926
6644
  /**
3927
6645
  * Initiates the cancellation of a running cutover job.
6646
+ * @example
6647
+ * ```js
6648
+ * // Before running the sample:
6649
+ * // - Enable the API at:
6650
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6651
+ * // - Login into gcloud by running:
6652
+ * // ```sh
6653
+ * // $ gcloud auth application-default login
6654
+ * // ```
6655
+ * // - Install the npm module by running:
6656
+ * // ```sh
6657
+ * // $ npm install googleapis
6658
+ * // ```
6659
+ *
6660
+ * const {google} = require('googleapis');
6661
+ * const vmmigration = google.vmmigration('v1');
6662
+ *
6663
+ * async function main() {
6664
+ * const auth = new google.auth.GoogleAuth({
6665
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6666
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6667
+ * });
6668
+ *
6669
+ * // Acquire an auth client, and bind it to all future calls
6670
+ * const authClient = await auth.getClient();
6671
+ * google.options({auth: authClient});
6672
+ *
6673
+ * // Do the magic
6674
+ * const res =
6675
+ * await vmmigration.projects.locations.sources.migratingVms.cutoverJobs.cancel(
6676
+ * {
6677
+ * // Required. The cutover job id
6678
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm/cutoverJobs/my-cutoverJob',
6679
+ *
6680
+ * // Request body metadata
6681
+ * requestBody: {
6682
+ * // request body parameters
6683
+ * // {}
6684
+ * },
6685
+ * },
6686
+ * );
6687
+ * console.log(res.data);
6688
+ *
6689
+ * // Example response
6690
+ * // {
6691
+ * // "done": false,
6692
+ * // "error": {},
6693
+ * // "metadata": {},
6694
+ * // "name": "my_name",
6695
+ * // "response": {}
6696
+ * // }
6697
+ * }
6698
+ *
6699
+ * main().catch(e => {
6700
+ * console.error(e);
6701
+ * throw e;
6702
+ * });
6703
+ *
6704
+ * ```
3928
6705
  *
3929
6706
  * @param params - Parameters for request
3930
6707
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3939,6 +6716,82 @@ export declare namespace vmmigration_v1 {
3939
6716
  cancel(callback: BodyResponseCallback<Schema$Operation>): void;
3940
6717
  /**
3941
6718
  * 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.
6719
+ * @example
6720
+ * ```js
6721
+ * // Before running the sample:
6722
+ * // - Enable the API at:
6723
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6724
+ * // - Login into gcloud by running:
6725
+ * // ```sh
6726
+ * // $ gcloud auth application-default login
6727
+ * // ```
6728
+ * // - Install the npm module by running:
6729
+ * // ```sh
6730
+ * // $ npm install googleapis
6731
+ * // ```
6732
+ *
6733
+ * const {google} = require('googleapis');
6734
+ * const vmmigration = google.vmmigration('v1');
6735
+ *
6736
+ * async function main() {
6737
+ * const auth = new google.auth.GoogleAuth({
6738
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6739
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6740
+ * });
6741
+ *
6742
+ * // Acquire an auth client, and bind it to all future calls
6743
+ * const authClient = await auth.getClient();
6744
+ * google.options({auth: authClient});
6745
+ *
6746
+ * // Do the magic
6747
+ * const res =
6748
+ * await vmmigration.projects.locations.sources.migratingVms.cutoverJobs.create(
6749
+ * {
6750
+ * // Required. The cutover job identifier.
6751
+ * cutoverJobId: 'placeholder-value',
6752
+ * // Required. The Cutover's parent.
6753
+ * parent:
6754
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
6755
+ * // 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).
6756
+ * requestId: 'placeholder-value',
6757
+ *
6758
+ * // Request body metadata
6759
+ * requestBody: {
6760
+ * // request body parameters
6761
+ * // {
6762
+ * // "computeEngineDisksTargetDetails": {},
6763
+ * // "computeEngineTargetDetails": {},
6764
+ * // "createTime": "my_createTime",
6765
+ * // "endTime": "my_endTime",
6766
+ * // "error": {},
6767
+ * // "name": "my_name",
6768
+ * // "progressPercent": 0,
6769
+ * // "state": "my_state",
6770
+ * // "stateMessage": "my_stateMessage",
6771
+ * // "stateTime": "my_stateTime",
6772
+ * // "steps": []
6773
+ * // }
6774
+ * },
6775
+ * },
6776
+ * );
6777
+ * console.log(res.data);
6778
+ *
6779
+ * // Example response
6780
+ * // {
6781
+ * // "done": false,
6782
+ * // "error": {},
6783
+ * // "metadata": {},
6784
+ * // "name": "my_name",
6785
+ * // "response": {}
6786
+ * // }
6787
+ * }
6788
+ *
6789
+ * main().catch(e => {
6790
+ * console.error(e);
6791
+ * throw e;
6792
+ * });
6793
+ *
6794
+ * ```
3942
6795
  *
3943
6796
  * @param params - Parameters for request
3944
6797
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3953,6 +6806,63 @@ export declare namespace vmmigration_v1 {
3953
6806
  create(callback: BodyResponseCallback<Schema$Operation>): void;
3954
6807
  /**
3955
6808
  * Gets details of a single CutoverJob.
6809
+ * @example
6810
+ * ```js
6811
+ * // Before running the sample:
6812
+ * // - Enable the API at:
6813
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6814
+ * // - Login into gcloud by running:
6815
+ * // ```sh
6816
+ * // $ gcloud auth application-default login
6817
+ * // ```
6818
+ * // - Install the npm module by running:
6819
+ * // ```sh
6820
+ * // $ npm install googleapis
6821
+ * // ```
6822
+ *
6823
+ * const {google} = require('googleapis');
6824
+ * const vmmigration = google.vmmigration('v1');
6825
+ *
6826
+ * async function main() {
6827
+ * const auth = new google.auth.GoogleAuth({
6828
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6829
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6830
+ * });
6831
+ *
6832
+ * // Acquire an auth client, and bind it to all future calls
6833
+ * const authClient = await auth.getClient();
6834
+ * google.options({auth: authClient});
6835
+ *
6836
+ * // Do the magic
6837
+ * const res =
6838
+ * await vmmigration.projects.locations.sources.migratingVms.cutoverJobs.get({
6839
+ * // Required. The name of the CutoverJob.
6840
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm/cutoverJobs/my-cutoverJob',
6841
+ * });
6842
+ * console.log(res.data);
6843
+ *
6844
+ * // Example response
6845
+ * // {
6846
+ * // "computeEngineDisksTargetDetails": {},
6847
+ * // "computeEngineTargetDetails": {},
6848
+ * // "createTime": "my_createTime",
6849
+ * // "endTime": "my_endTime",
6850
+ * // "error": {},
6851
+ * // "name": "my_name",
6852
+ * // "progressPercent": 0,
6853
+ * // "state": "my_state",
6854
+ * // "stateMessage": "my_stateMessage",
6855
+ * // "stateTime": "my_stateTime",
6856
+ * // "steps": []
6857
+ * // }
6858
+ * }
6859
+ *
6860
+ * main().catch(e => {
6861
+ * console.error(e);
6862
+ * throw e;
6863
+ * });
6864
+ *
6865
+ * ```
3956
6866
  *
3957
6867
  * @param params - Parameters for request
3958
6868
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -3967,6 +6877,64 @@ export declare namespace vmmigration_v1 {
3967
6877
  get(callback: BodyResponseCallback<Schema$CutoverJob>): void;
3968
6878
  /**
3969
6879
  * Lists the CutoverJobs of a migrating VM. Only 25 most recent CutoverJobs are listed.
6880
+ * @example
6881
+ * ```js
6882
+ * // Before running the sample:
6883
+ * // - Enable the API at:
6884
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
6885
+ * // - Login into gcloud by running:
6886
+ * // ```sh
6887
+ * // $ gcloud auth application-default login
6888
+ * // ```
6889
+ * // - Install the npm module by running:
6890
+ * // ```sh
6891
+ * // $ npm install googleapis
6892
+ * // ```
6893
+ *
6894
+ * const {google} = require('googleapis');
6895
+ * const vmmigration = google.vmmigration('v1');
6896
+ *
6897
+ * async function main() {
6898
+ * const auth = new google.auth.GoogleAuth({
6899
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6900
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6901
+ * });
6902
+ *
6903
+ * // Acquire an auth client, and bind it to all future calls
6904
+ * const authClient = await auth.getClient();
6905
+ * google.options({auth: authClient});
6906
+ *
6907
+ * // Do the magic
6908
+ * const res =
6909
+ * await vmmigration.projects.locations.sources.migratingVms.cutoverJobs.list({
6910
+ * // Optional. The filter request.
6911
+ * filter: 'placeholder-value',
6912
+ * // Optional. the order by fields for the result.
6913
+ * orderBy: 'placeholder-value',
6914
+ * // 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.
6915
+ * pageSize: 'placeholder-value',
6916
+ * // 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.
6917
+ * pageToken: 'placeholder-value',
6918
+ * // Required. The parent, which owns this collection of migrating VMs.
6919
+ * parent:
6920
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
6921
+ * });
6922
+ * console.log(res.data);
6923
+ *
6924
+ * // Example response
6925
+ * // {
6926
+ * // "cutoverJobs": [],
6927
+ * // "nextPageToken": "my_nextPageToken",
6928
+ * // "unreachable": []
6929
+ * // }
6930
+ * }
6931
+ *
6932
+ * main().catch(e => {
6933
+ * console.error(e);
6934
+ * throw e;
6935
+ * });
6936
+ *
6937
+ * ```
3970
6938
  *
3971
6939
  * @param params - Parameters for request
3972
6940
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4041,6 +7009,64 @@ export declare namespace vmmigration_v1 {
4041
7009
  constructor(context: APIRequestContext);
4042
7010
  /**
4043
7011
  * Gets details of a single ReplicationCycle.
7012
+ * @example
7013
+ * ```js
7014
+ * // Before running the sample:
7015
+ * // - Enable the API at:
7016
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7017
+ * // - Login into gcloud by running:
7018
+ * // ```sh
7019
+ * // $ gcloud auth application-default login
7020
+ * // ```
7021
+ * // - Install the npm module by running:
7022
+ * // ```sh
7023
+ * // $ npm install googleapis
7024
+ * // ```
7025
+ *
7026
+ * const {google} = require('googleapis');
7027
+ * const vmmigration = google.vmmigration('v1');
7028
+ *
7029
+ * async function main() {
7030
+ * const auth = new google.auth.GoogleAuth({
7031
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7032
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7033
+ * });
7034
+ *
7035
+ * // Acquire an auth client, and bind it to all future calls
7036
+ * const authClient = await auth.getClient();
7037
+ * google.options({auth: authClient});
7038
+ *
7039
+ * // Do the magic
7040
+ * const res =
7041
+ * await vmmigration.projects.locations.sources.migratingVms.replicationCycles.get(
7042
+ * {
7043
+ * // Required. The name of the ReplicationCycle.
7044
+ * name: 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm/replicationCycles/my-replicationCycle',
7045
+ * },
7046
+ * );
7047
+ * console.log(res.data);
7048
+ *
7049
+ * // Example response
7050
+ * // {
7051
+ * // "cycleNumber": 0,
7052
+ * // "endTime": "my_endTime",
7053
+ * // "error": {},
7054
+ * // "name": "my_name",
7055
+ * // "progressPercent": 0,
7056
+ * // "startTime": "my_startTime",
7057
+ * // "state": "my_state",
7058
+ * // "steps": [],
7059
+ * // "totalPauseDuration": "my_totalPauseDuration",
7060
+ * // "warnings": []
7061
+ * // }
7062
+ * }
7063
+ *
7064
+ * main().catch(e => {
7065
+ * console.error(e);
7066
+ * throw e;
7067
+ * });
7068
+ *
7069
+ * ```
4044
7070
  *
4045
7071
  * @param params - Parameters for request
4046
7072
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4055,6 +7081,66 @@ export declare namespace vmmigration_v1 {
4055
7081
  get(callback: BodyResponseCallback<Schema$ReplicationCycle>): void;
4056
7082
  /**
4057
7083
  * Lists ReplicationCycles in a given MigratingVM.
7084
+ * @example
7085
+ * ```js
7086
+ * // Before running the sample:
7087
+ * // - Enable the API at:
7088
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7089
+ * // - Login into gcloud by running:
7090
+ * // ```sh
7091
+ * // $ gcloud auth application-default login
7092
+ * // ```
7093
+ * // - Install the npm module by running:
7094
+ * // ```sh
7095
+ * // $ npm install googleapis
7096
+ * // ```
7097
+ *
7098
+ * const {google} = require('googleapis');
7099
+ * const vmmigration = google.vmmigration('v1');
7100
+ *
7101
+ * async function main() {
7102
+ * const auth = new google.auth.GoogleAuth({
7103
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7104
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7105
+ * });
7106
+ *
7107
+ * // Acquire an auth client, and bind it to all future calls
7108
+ * const authClient = await auth.getClient();
7109
+ * google.options({auth: authClient});
7110
+ *
7111
+ * // Do the magic
7112
+ * const res =
7113
+ * await vmmigration.projects.locations.sources.migratingVms.replicationCycles.list(
7114
+ * {
7115
+ * // Optional. The filter request.
7116
+ * filter: 'placeholder-value',
7117
+ * // Optional. the order by fields for the result.
7118
+ * orderBy: 'placeholder-value',
7119
+ * // 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.
7120
+ * pageSize: 'placeholder-value',
7121
+ * // 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.
7122
+ * pageToken: 'placeholder-value',
7123
+ * // Required. The parent, which owns this collection of ReplicationCycles.
7124
+ * parent:
7125
+ * 'projects/my-project/locations/my-location/sources/my-source/migratingVms/my-migratingVm',
7126
+ * },
7127
+ * );
7128
+ * console.log(res.data);
7129
+ *
7130
+ * // Example response
7131
+ * // {
7132
+ * // "nextPageToken": "my_nextPageToken",
7133
+ * // "replicationCycles": [],
7134
+ * // "unreachable": []
7135
+ * // }
7136
+ * }
7137
+ *
7138
+ * main().catch(e => {
7139
+ * console.error(e);
7140
+ * throw e;
7141
+ * });
7142
+ *
7143
+ * ```
4058
7144
  *
4059
7145
  * @param params - Parameters for request
4060
7146
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4101,6 +7187,78 @@ export declare namespace vmmigration_v1 {
4101
7187
  constructor(context: APIRequestContext);
4102
7188
  /**
4103
7189
  * Creates a new UtilizationReport.
7190
+ * @example
7191
+ * ```js
7192
+ * // Before running the sample:
7193
+ * // - Enable the API at:
7194
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7195
+ * // - Login into gcloud by running:
7196
+ * // ```sh
7197
+ * // $ gcloud auth application-default login
7198
+ * // ```
7199
+ * // - Install the npm module by running:
7200
+ * // ```sh
7201
+ * // $ npm install googleapis
7202
+ * // ```
7203
+ *
7204
+ * const {google} = require('googleapis');
7205
+ * const vmmigration = google.vmmigration('v1');
7206
+ *
7207
+ * async function main() {
7208
+ * const auth = new google.auth.GoogleAuth({
7209
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7210
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7211
+ * });
7212
+ *
7213
+ * // Acquire an auth client, and bind it to all future calls
7214
+ * const authClient = await auth.getClient();
7215
+ * google.options({auth: authClient});
7216
+ *
7217
+ * // Do the magic
7218
+ * const res =
7219
+ * await vmmigration.projects.locations.sources.utilizationReports.create({
7220
+ * // Required. The Utilization Report's parent.
7221
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
7222
+ * // 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).
7223
+ * requestId: 'placeholder-value',
7224
+ * // 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.
7225
+ * utilizationReportId: 'placeholder-value',
7226
+ *
7227
+ * // Request body metadata
7228
+ * requestBody: {
7229
+ * // request body parameters
7230
+ * // {
7231
+ * // "createTime": "my_createTime",
7232
+ * // "displayName": "my_displayName",
7233
+ * // "error": {},
7234
+ * // "frameEndTime": "my_frameEndTime",
7235
+ * // "name": "my_name",
7236
+ * // "state": "my_state",
7237
+ * // "stateTime": "my_stateTime",
7238
+ * // "timeFrame": "my_timeFrame",
7239
+ * // "vmCount": 0,
7240
+ * // "vms": []
7241
+ * // }
7242
+ * },
7243
+ * });
7244
+ * console.log(res.data);
7245
+ *
7246
+ * // Example response
7247
+ * // {
7248
+ * // "done": false,
7249
+ * // "error": {},
7250
+ * // "metadata": {},
7251
+ * // "name": "my_name",
7252
+ * // "response": {}
7253
+ * // }
7254
+ * }
7255
+ *
7256
+ * main().catch(e => {
7257
+ * console.error(e);
7258
+ * throw e;
7259
+ * });
7260
+ *
7261
+ * ```
4104
7262
  *
4105
7263
  * @param params - Parameters for request
4106
7264
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4115,6 +7273,59 @@ export declare namespace vmmigration_v1 {
4115
7273
  create(callback: BodyResponseCallback<Schema$Operation>): void;
4116
7274
  /**
4117
7275
  * Deletes a single Utilization Report.
7276
+ * @example
7277
+ * ```js
7278
+ * // Before running the sample:
7279
+ * // - Enable the API at:
7280
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7281
+ * // - Login into gcloud by running:
7282
+ * // ```sh
7283
+ * // $ gcloud auth application-default login
7284
+ * // ```
7285
+ * // - Install the npm module by running:
7286
+ * // ```sh
7287
+ * // $ npm install googleapis
7288
+ * // ```
7289
+ *
7290
+ * const {google} = require('googleapis');
7291
+ * const vmmigration = google.vmmigration('v1');
7292
+ *
7293
+ * async function main() {
7294
+ * const auth = new google.auth.GoogleAuth({
7295
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7296
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7297
+ * });
7298
+ *
7299
+ * // Acquire an auth client, and bind it to all future calls
7300
+ * const authClient = await auth.getClient();
7301
+ * google.options({auth: authClient});
7302
+ *
7303
+ * // Do the magic
7304
+ * const res =
7305
+ * await vmmigration.projects.locations.sources.utilizationReports.delete({
7306
+ * // Required. The Utilization Report name.
7307
+ * name: 'projects/my-project/locations/my-location/sources/my-source/utilizationReports/my-utilizationReport',
7308
+ * // 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).
7309
+ * requestId: 'placeholder-value',
7310
+ * });
7311
+ * console.log(res.data);
7312
+ *
7313
+ * // Example response
7314
+ * // {
7315
+ * // "done": false,
7316
+ * // "error": {},
7317
+ * // "metadata": {},
7318
+ * // "name": "my_name",
7319
+ * // "response": {}
7320
+ * // }
7321
+ * }
7322
+ *
7323
+ * main().catch(e => {
7324
+ * console.error(e);
7325
+ * throw e;
7326
+ * });
7327
+ *
7328
+ * ```
4118
7329
  *
4119
7330
  * @param params - Parameters for request
4120
7331
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4129,6 +7340,64 @@ export declare namespace vmmigration_v1 {
4129
7340
  delete(callback: BodyResponseCallback<Schema$Operation>): void;
4130
7341
  /**
4131
7342
  * Gets a single Utilization Report.
7343
+ * @example
7344
+ * ```js
7345
+ * // Before running the sample:
7346
+ * // - Enable the API at:
7347
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7348
+ * // - Login into gcloud by running:
7349
+ * // ```sh
7350
+ * // $ gcloud auth application-default login
7351
+ * // ```
7352
+ * // - Install the npm module by running:
7353
+ * // ```sh
7354
+ * // $ npm install googleapis
7355
+ * // ```
7356
+ *
7357
+ * const {google} = require('googleapis');
7358
+ * const vmmigration = google.vmmigration('v1');
7359
+ *
7360
+ * async function main() {
7361
+ * const auth = new google.auth.GoogleAuth({
7362
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7363
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7364
+ * });
7365
+ *
7366
+ * // Acquire an auth client, and bind it to all future calls
7367
+ * const authClient = await auth.getClient();
7368
+ * google.options({auth: authClient});
7369
+ *
7370
+ * // Do the magic
7371
+ * const res =
7372
+ * await vmmigration.projects.locations.sources.utilizationReports.get({
7373
+ * // Required. The Utilization Report name.
7374
+ * name: 'projects/my-project/locations/my-location/sources/my-source/utilizationReports/my-utilizationReport',
7375
+ * // Optional. The level of details of the report. Defaults to FULL
7376
+ * view: 'placeholder-value',
7377
+ * });
7378
+ * console.log(res.data);
7379
+ *
7380
+ * // Example response
7381
+ * // {
7382
+ * // "createTime": "my_createTime",
7383
+ * // "displayName": "my_displayName",
7384
+ * // "error": {},
7385
+ * // "frameEndTime": "my_frameEndTime",
7386
+ * // "name": "my_name",
7387
+ * // "state": "my_state",
7388
+ * // "stateTime": "my_stateTime",
7389
+ * // "timeFrame": "my_timeFrame",
7390
+ * // "vmCount": 0,
7391
+ * // "vms": []
7392
+ * // }
7393
+ * }
7394
+ *
7395
+ * main().catch(e => {
7396
+ * console.error(e);
7397
+ * throw e;
7398
+ * });
7399
+ *
7400
+ * ```
4132
7401
  *
4133
7402
  * @param params - Parameters for request
4134
7403
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4143,6 +7412,65 @@ export declare namespace vmmigration_v1 {
4143
7412
  get(callback: BodyResponseCallback<Schema$UtilizationReport>): void;
4144
7413
  /**
4145
7414
  * Lists Utilization Reports of the given Source.
7415
+ * @example
7416
+ * ```js
7417
+ * // Before running the sample:
7418
+ * // - Enable the API at:
7419
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7420
+ * // - Login into gcloud by running:
7421
+ * // ```sh
7422
+ * // $ gcloud auth application-default login
7423
+ * // ```
7424
+ * // - Install the npm module by running:
7425
+ * // ```sh
7426
+ * // $ npm install googleapis
7427
+ * // ```
7428
+ *
7429
+ * const {google} = require('googleapis');
7430
+ * const vmmigration = google.vmmigration('v1');
7431
+ *
7432
+ * async function main() {
7433
+ * const auth = new google.auth.GoogleAuth({
7434
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7435
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7436
+ * });
7437
+ *
7438
+ * // Acquire an auth client, and bind it to all future calls
7439
+ * const authClient = await auth.getClient();
7440
+ * google.options({auth: authClient});
7441
+ *
7442
+ * // Do the magic
7443
+ * const res =
7444
+ * await vmmigration.projects.locations.sources.utilizationReports.list({
7445
+ * // Optional. The filter request.
7446
+ * filter: 'placeholder-value',
7447
+ * // Optional. the order by fields for the result.
7448
+ * orderBy: 'placeholder-value',
7449
+ * // 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.
7450
+ * pageSize: 'placeholder-value',
7451
+ * // 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.
7452
+ * pageToken: 'placeholder-value',
7453
+ * // Required. The Utilization Reports parent.
7454
+ * parent: 'projects/my-project/locations/my-location/sources/my-source',
7455
+ * // Optional. The level of details of each report. Defaults to BASIC.
7456
+ * view: 'placeholder-value',
7457
+ * });
7458
+ * console.log(res.data);
7459
+ *
7460
+ * // Example response
7461
+ * // {
7462
+ * // "nextPageToken": "my_nextPageToken",
7463
+ * // "unreachable": [],
7464
+ * // "utilizationReports": []
7465
+ * // }
7466
+ * }
7467
+ *
7468
+ * main().catch(e => {
7469
+ * console.error(e);
7470
+ * throw e;
7471
+ * });
7472
+ *
7473
+ * ```
4146
7474
  *
4147
7475
  * @param params - Parameters for request
4148
7476
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4225,6 +7553,72 @@ export declare namespace vmmigration_v1 {
4225
7553
  constructor(context: APIRequestContext);
4226
7554
  /**
4227
7555
  * Creates a new TargetProject in a given project. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.
7556
+ * @example
7557
+ * ```js
7558
+ * // Before running the sample:
7559
+ * // - Enable the API at:
7560
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7561
+ * // - Login into gcloud by running:
7562
+ * // ```sh
7563
+ * // $ gcloud auth application-default login
7564
+ * // ```
7565
+ * // - Install the npm module by running:
7566
+ * // ```sh
7567
+ * // $ npm install googleapis
7568
+ * // ```
7569
+ *
7570
+ * const {google} = require('googleapis');
7571
+ * const vmmigration = google.vmmigration('v1');
7572
+ *
7573
+ * async function main() {
7574
+ * const auth = new google.auth.GoogleAuth({
7575
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7576
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7577
+ * });
7578
+ *
7579
+ * // Acquire an auth client, and bind it to all future calls
7580
+ * const authClient = await auth.getClient();
7581
+ * google.options({auth: authClient});
7582
+ *
7583
+ * // Do the magic
7584
+ * const res = await vmmigration.projects.locations.targetProjects.create({
7585
+ * // Required. The TargetProject's parent.
7586
+ * parent: 'projects/my-project/locations/my-location',
7587
+ * // 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).
7588
+ * requestId: 'placeholder-value',
7589
+ * // Required. The target_project identifier.
7590
+ * targetProjectId: 'placeholder-value',
7591
+ *
7592
+ * // Request body metadata
7593
+ * requestBody: {
7594
+ * // request body parameters
7595
+ * // {
7596
+ * // "createTime": "my_createTime",
7597
+ * // "description": "my_description",
7598
+ * // "name": "my_name",
7599
+ * // "project": "my_project",
7600
+ * // "updateTime": "my_updateTime"
7601
+ * // }
7602
+ * },
7603
+ * });
7604
+ * console.log(res.data);
7605
+ *
7606
+ * // Example response
7607
+ * // {
7608
+ * // "done": false,
7609
+ * // "error": {},
7610
+ * // "metadata": {},
7611
+ * // "name": "my_name",
7612
+ * // "response": {}
7613
+ * // }
7614
+ * }
7615
+ *
7616
+ * main().catch(e => {
7617
+ * console.error(e);
7618
+ * throw e;
7619
+ * });
7620
+ *
7621
+ * ```
4228
7622
  *
4229
7623
  * @param params - Parameters for request
4230
7624
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4239,6 +7633,58 @@ export declare namespace vmmigration_v1 {
4239
7633
  create(callback: BodyResponseCallback<Schema$Operation>): void;
4240
7634
  /**
4241
7635
  * Deletes a single TargetProject. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.
7636
+ * @example
7637
+ * ```js
7638
+ * // Before running the sample:
7639
+ * // - Enable the API at:
7640
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7641
+ * // - Login into gcloud by running:
7642
+ * // ```sh
7643
+ * // $ gcloud auth application-default login
7644
+ * // ```
7645
+ * // - Install the npm module by running:
7646
+ * // ```sh
7647
+ * // $ npm install googleapis
7648
+ * // ```
7649
+ *
7650
+ * const {google} = require('googleapis');
7651
+ * const vmmigration = google.vmmigration('v1');
7652
+ *
7653
+ * async function main() {
7654
+ * const auth = new google.auth.GoogleAuth({
7655
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7656
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7657
+ * });
7658
+ *
7659
+ * // Acquire an auth client, and bind it to all future calls
7660
+ * const authClient = await auth.getClient();
7661
+ * google.options({auth: authClient});
7662
+ *
7663
+ * // Do the magic
7664
+ * const res = await vmmigration.projects.locations.targetProjects.delete({
7665
+ * // Required. The TargetProject name.
7666
+ * name: 'projects/my-project/locations/my-location/targetProjects/my-targetProject',
7667
+ * // 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).
7668
+ * requestId: 'placeholder-value',
7669
+ * });
7670
+ * console.log(res.data);
7671
+ *
7672
+ * // Example response
7673
+ * // {
7674
+ * // "done": false,
7675
+ * // "error": {},
7676
+ * // "metadata": {},
7677
+ * // "name": "my_name",
7678
+ * // "response": {}
7679
+ * // }
7680
+ * }
7681
+ *
7682
+ * main().catch(e => {
7683
+ * console.error(e);
7684
+ * throw e;
7685
+ * });
7686
+ *
7687
+ * ```
4242
7688
  *
4243
7689
  * @param params - Parameters for request
4244
7690
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4253,6 +7699,56 @@ export declare namespace vmmigration_v1 {
4253
7699
  delete(callback: BodyResponseCallback<Schema$Operation>): void;
4254
7700
  /**
4255
7701
  * Gets details of a single TargetProject. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.
7702
+ * @example
7703
+ * ```js
7704
+ * // Before running the sample:
7705
+ * // - Enable the API at:
7706
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7707
+ * // - Login into gcloud by running:
7708
+ * // ```sh
7709
+ * // $ gcloud auth application-default login
7710
+ * // ```
7711
+ * // - Install the npm module by running:
7712
+ * // ```sh
7713
+ * // $ npm install googleapis
7714
+ * // ```
7715
+ *
7716
+ * const {google} = require('googleapis');
7717
+ * const vmmigration = google.vmmigration('v1');
7718
+ *
7719
+ * async function main() {
7720
+ * const auth = new google.auth.GoogleAuth({
7721
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7722
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7723
+ * });
7724
+ *
7725
+ * // Acquire an auth client, and bind it to all future calls
7726
+ * const authClient = await auth.getClient();
7727
+ * google.options({auth: authClient});
7728
+ *
7729
+ * // Do the magic
7730
+ * const res = await vmmigration.projects.locations.targetProjects.get({
7731
+ * // Required. The TargetProject name.
7732
+ * name: 'projects/my-project/locations/my-location/targetProjects/my-targetProject',
7733
+ * });
7734
+ * console.log(res.data);
7735
+ *
7736
+ * // Example response
7737
+ * // {
7738
+ * // "createTime": "my_createTime",
7739
+ * // "description": "my_description",
7740
+ * // "name": "my_name",
7741
+ * // "project": "my_project",
7742
+ * // "updateTime": "my_updateTime"
7743
+ * // }
7744
+ * }
7745
+ *
7746
+ * main().catch(e => {
7747
+ * console.error(e);
7748
+ * throw e;
7749
+ * });
7750
+ *
7751
+ * ```
4256
7752
  *
4257
7753
  * @param params - Parameters for request
4258
7754
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4267,6 +7763,62 @@ export declare namespace vmmigration_v1 {
4267
7763
  get(callback: BodyResponseCallback<Schema$TargetProject>): void;
4268
7764
  /**
4269
7765
  * Lists TargetProjects in a given project. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.
7766
+ * @example
7767
+ * ```js
7768
+ * // Before running the sample:
7769
+ * // - Enable the API at:
7770
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7771
+ * // - Login into gcloud by running:
7772
+ * // ```sh
7773
+ * // $ gcloud auth application-default login
7774
+ * // ```
7775
+ * // - Install the npm module by running:
7776
+ * // ```sh
7777
+ * // $ npm install googleapis
7778
+ * // ```
7779
+ *
7780
+ * const {google} = require('googleapis');
7781
+ * const vmmigration = google.vmmigration('v1');
7782
+ *
7783
+ * async function main() {
7784
+ * const auth = new google.auth.GoogleAuth({
7785
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7786
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7787
+ * });
7788
+ *
7789
+ * // Acquire an auth client, and bind it to all future calls
7790
+ * const authClient = await auth.getClient();
7791
+ * google.options({auth: authClient});
7792
+ *
7793
+ * // Do the magic
7794
+ * const res = await vmmigration.projects.locations.targetProjects.list({
7795
+ * // Optional. The filter request.
7796
+ * filter: 'placeholder-value',
7797
+ * // Optional. the order by fields for the result.
7798
+ * orderBy: 'placeholder-value',
7799
+ * // 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.
7800
+ * pageSize: 'placeholder-value',
7801
+ * // 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.
7802
+ * pageToken: 'placeholder-value',
7803
+ * // Required. The parent, which owns this collection of targets.
7804
+ * parent: 'projects/my-project/locations/my-location',
7805
+ * });
7806
+ * console.log(res.data);
7807
+ *
7808
+ * // Example response
7809
+ * // {
7810
+ * // "nextPageToken": "my_nextPageToken",
7811
+ * // "targetProjects": [],
7812
+ * // "unreachable": []
7813
+ * // }
7814
+ * }
7815
+ *
7816
+ * main().catch(e => {
7817
+ * console.error(e);
7818
+ * throw e;
7819
+ * });
7820
+ *
7821
+ * ```
4270
7822
  *
4271
7823
  * @param params - Parameters for request
4272
7824
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
@@ -4281,6 +7833,72 @@ export declare namespace vmmigration_v1 {
4281
7833
  list(callback: BodyResponseCallback<Schema$ListTargetProjectsResponse>): void;
4282
7834
  /**
4283
7835
  * Updates the parameters of a single TargetProject. NOTE: TargetProject is a global resource; hence the only supported value for location is `global`.
7836
+ * @example
7837
+ * ```js
7838
+ * // Before running the sample:
7839
+ * // - Enable the API at:
7840
+ * // https://console.developers.google.com/apis/api/vmmigration.googleapis.com
7841
+ * // - Login into gcloud by running:
7842
+ * // ```sh
7843
+ * // $ gcloud auth application-default login
7844
+ * // ```
7845
+ * // - Install the npm module by running:
7846
+ * // ```sh
7847
+ * // $ npm install googleapis
7848
+ * // ```
7849
+ *
7850
+ * const {google} = require('googleapis');
7851
+ * const vmmigration = google.vmmigration('v1');
7852
+ *
7853
+ * async function main() {
7854
+ * const auth = new google.auth.GoogleAuth({
7855
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7856
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7857
+ * });
7858
+ *
7859
+ * // Acquire an auth client, and bind it to all future calls
7860
+ * const authClient = await auth.getClient();
7861
+ * google.options({auth: authClient});
7862
+ *
7863
+ * // Do the magic
7864
+ * const res = await vmmigration.projects.locations.targetProjects.patch({
7865
+ * // Output only. The name of the target project.
7866
+ * name: 'projects/my-project/locations/my-location/targetProjects/my-targetProject',
7867
+ * // 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).
7868
+ * requestId: 'placeholder-value',
7869
+ * // 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.
7870
+ * updateMask: 'placeholder-value',
7871
+ *
7872
+ * // Request body metadata
7873
+ * requestBody: {
7874
+ * // request body parameters
7875
+ * // {
7876
+ * // "createTime": "my_createTime",
7877
+ * // "description": "my_description",
7878
+ * // "name": "my_name",
7879
+ * // "project": "my_project",
7880
+ * // "updateTime": "my_updateTime"
7881
+ * // }
7882
+ * },
7883
+ * });
7884
+ * console.log(res.data);
7885
+ *
7886
+ * // Example response
7887
+ * // {
7888
+ * // "done": false,
7889
+ * // "error": {},
7890
+ * // "metadata": {},
7891
+ * // "name": "my_name",
7892
+ * // "response": {}
7893
+ * // }
7894
+ * }
7895
+ *
7896
+ * main().catch(e => {
7897
+ * console.error(e);
7898
+ * throw e;
7899
+ * });
7900
+ *
7901
+ * ```
4284
7902
  *
4285
7903
  * @param params - Parameters for request
4286
7904
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.