@googleapis/securitycenter 12.0.0 → 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.
@@ -1,5 +1,5 @@
1
1
  /// <reference types="node" />
2
- import { OAuth2Client, JWT, Compute, UserRefreshClient, BaseExternalAccountClient, GaxiosPromise, GoogleConfigurable, MethodOptions, StreamMethodOptions, GlobalOptions, GoogleAuth, BodyResponseCallback, APIRequestContext } from 'googleapis-common';
2
+ import { OAuth2Client, JWT, Compute, UserRefreshClient, BaseExternalAccountClient, GaxiosResponseWithHTTP2, GoogleConfigurable, MethodOptions, StreamMethodOptions, GlobalOptions, GoogleAuth, BodyResponseCallback, APIRequestContext } from 'googleapis-common';
3
3
  import { Readable } from 'stream';
4
4
  export declare namespace securitycenter_v1beta1 {
5
5
  export interface Options extends GlobalOptions {
@@ -171,6 +171,39 @@ export declare namespace securitycenter_v1beta1 {
171
171
  */
172
172
  count?: string | null;
173
173
  }
174
+ /**
175
+ * Contains information about the AI model associated with the finding.
176
+ */
177
+ export interface Schema$AiModel {
178
+ /**
179
+ * The platform on which the model is deployed.
180
+ */
181
+ deploymentPlatform?: string | null;
182
+ /**
183
+ * The user defined display name of model. Ex. baseline-classification-model
184
+ */
185
+ displayName?: string | null;
186
+ /**
187
+ * The domain of the model, for example, “image-classification”.
188
+ */
189
+ domain?: string | null;
190
+ /**
191
+ * The name of the model library, for example, “transformers”.
192
+ */
193
+ library?: string | null;
194
+ /**
195
+ * The region in which the model is used, for example, “us-central1”.
196
+ */
197
+ location?: string | null;
198
+ /**
199
+ * The name of the AI model, for example, "gemini:1.0.0".
200
+ */
201
+ name?: string | null;
202
+ /**
203
+ * The publisher of the model, for example, “google” or “nvidia”.
204
+ */
205
+ publisher?: string | null;
206
+ }
174
207
  /**
175
208
  * Allowed IP rule.
176
209
  */
@@ -491,6 +524,15 @@ export declare namespace securitycenter_v1beta1 {
491
524
  */
492
525
  storagePool?: string | null;
493
526
  }
527
+ /**
528
+ * The destination big query dataset to export findings to.
529
+ */
530
+ export interface Schema$BigQueryDestination {
531
+ /**
532
+ * Required. The relative resource name of the destination dataset, in the form projects/{projectId\}/datasets/{datasetId\}.
533
+ */
534
+ dataset?: string | null;
535
+ }
494
536
  /**
495
537
  * Associates `members`, or principals, with a `role`.
496
538
  */
@@ -886,6 +928,23 @@ export declare namespace securitycenter_v1beta1 {
886
928
  */
887
929
  maxRetentionAllowed?: string | null;
888
930
  }
931
+ /**
932
+ * Vertex AI dataset associated with the finding.
933
+ */
934
+ export interface Schema$Dataset {
935
+ /**
936
+ * The user defined display name of dataset, e.g. plants-dataset
937
+ */
938
+ displayName?: string | null;
939
+ /**
940
+ * Resource name of the dataset, e.g. projects/{project\}/locations/{location\}/datasets/2094040236064505856
941
+ */
942
+ name?: string | null;
943
+ /**
944
+ * Data source, such as BigQuery source URI, e.g. bq://scc-nexus-test.AIPPtest.gsod
945
+ */
946
+ source?: string | null;
947
+ }
889
948
  /**
890
949
  * Denied IP rule.
891
950
  */
@@ -991,6 +1050,24 @@ export declare namespace securitycenter_v1beta1 {
991
1050
  */
992
1051
  totalExfiltratedBytes?: string | null;
993
1052
  }
1053
+ /**
1054
+ * The LRO metadata for a ExportFindings request.
1055
+ */
1056
+ export interface Schema$ExportFindingsMetadata {
1057
+ /**
1058
+ * Required. The destination big query dataset to export findings to.
1059
+ */
1060
+ bigQueryDestination?: Schema$BigQueryDestination;
1061
+ /**
1062
+ * Optional. Timestamp at which export was started
1063
+ */
1064
+ exportStartTime?: string | null;
1065
+ }
1066
+ /**
1067
+ * The response to a ExportFindings request. Contains the LRO information.
1068
+ */
1069
+ export interface Schema$ExportFindingsResponse {
1070
+ }
994
1071
  /**
995
1072
  * Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information.
996
1073
  */
@@ -1028,6 +1105,10 @@ export declare namespace securitycenter_v1beta1 {
1028
1105
  * The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
1029
1106
  */
1030
1107
  hashedSize?: string | null;
1108
+ /**
1109
+ * Operation(s) performed on a file.
1110
+ */
1111
+ operations?: Schema$FileOperation[];
1031
1112
  /**
1032
1113
  * True when the hash covers only a prefix of the file.
1033
1114
  */
@@ -1045,6 +1126,15 @@ export declare namespace securitycenter_v1beta1 {
1045
1126
  */
1046
1127
  size?: string | null;
1047
1128
  }
1129
+ /**
1130
+ * Operation(s) performed on a file.
1131
+ */
1132
+ export interface Schema$FileOperation {
1133
+ /**
1134
+ * The type of the operation
1135
+ */
1136
+ type?: string | null;
1137
+ }
1048
1138
  /**
1049
1139
  * Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
1050
1140
  */
@@ -1057,6 +1147,10 @@ export declare namespace securitycenter_v1beta1 {
1057
1147
  * AffectedResources associated with the finding.
1058
1148
  */
1059
1149
  affectedResources?: Schema$AffectedResources;
1150
+ /**
1151
+ * The AI model associated with the finding.
1152
+ */
1153
+ aiModel?: Schema$AiModel;
1060
1154
  /**
1061
1155
  * Represents an application associated with the finding.
1062
1156
  */
@@ -1287,6 +1381,10 @@ export declare namespace securitycenter_v1beta1 {
1287
1381
  * Contains details about a group of security issues that, when the issues occur together, represent a greater risk than when the issues occur independently. A group of such issues is referred to as a toxic combination. This field cannot be updated. Its value is ignored in all update requests.
1288
1382
  */
1289
1383
  toxicCombination?: Schema$ToxicCombination;
1384
+ /**
1385
+ * VertexAi associated with the finding.
1386
+ */
1387
+ vertexAi?: Schema$VertexAi;
1290
1388
  /**
1291
1389
  * Represents vulnerability-specific fields like CVE and CVSS scores. CVE stands for Common Vulnerabilities and Exposures (https://cve.mitre.org/about/)
1292
1390
  */
@@ -2120,6 +2218,39 @@ export declare namespace securitycenter_v1beta1 {
2120
2218
  */
2121
2219
  count?: string | null;
2122
2220
  }
2221
+ /**
2222
+ * Contains information about the AI model associated with the finding.
2223
+ */
2224
+ export interface Schema$GoogleCloudSecuritycenterV2AiModel {
2225
+ /**
2226
+ * The platform on which the model is deployed.
2227
+ */
2228
+ deploymentPlatform?: string | null;
2229
+ /**
2230
+ * The user defined display name of model. Ex. baseline-classification-model
2231
+ */
2232
+ displayName?: string | null;
2233
+ /**
2234
+ * The domain of the model, for example, “image-classification”.
2235
+ */
2236
+ domain?: string | null;
2237
+ /**
2238
+ * The name of the model library, for example, “transformers”.
2239
+ */
2240
+ library?: string | null;
2241
+ /**
2242
+ * The region in which the model is used, for example, “us-central1”.
2243
+ */
2244
+ location?: string | null;
2245
+ /**
2246
+ * The name of the AI model, for example, "gemini:1.0.0".
2247
+ */
2248
+ name?: string | null;
2249
+ /**
2250
+ * The publisher of the model, for example, “google” or “nvidia”.
2251
+ */
2252
+ publisher?: string | null;
2253
+ }
2123
2254
  /**
2124
2255
  * Allowed IP rule.
2125
2256
  */
@@ -2806,6 +2937,23 @@ export declare namespace securitycenter_v1beta1 {
2806
2937
  */
2807
2938
  maxRetentionAllowed?: string | null;
2808
2939
  }
2940
+ /**
2941
+ * Vertex AI dataset associated with the finding.
2942
+ */
2943
+ export interface Schema$GoogleCloudSecuritycenterV2Dataset {
2944
+ /**
2945
+ * The user defined display name of dataset, e.g. plants-dataset
2946
+ */
2947
+ displayName?: string | null;
2948
+ /**
2949
+ * Resource name of the dataset, e.g. projects/{project\}/locations/{location\}/datasets/2094040236064505856
2950
+ */
2951
+ name?: string | null;
2952
+ /**
2953
+ * Data source, such as a BigQuery source URI, e.g. bq://scc-nexus-test.AIPPtest.gsod
2954
+ */
2955
+ source?: string | null;
2956
+ }
2809
2957
  /**
2810
2958
  * Denied IP rule.
2811
2959
  */
@@ -2971,6 +3119,10 @@ export declare namespace securitycenter_v1beta1 {
2971
3119
  * The length in bytes of the file prefix that was hashed. If hashed_size == size, any hashes reported represent the entire file.
2972
3120
  */
2973
3121
  hashedSize?: string | null;
3122
+ /**
3123
+ * Operation(s) performed on a file.
3124
+ */
3125
+ operations?: Schema$GoogleCloudSecuritycenterV2FileOperation[];
2974
3126
  /**
2975
3127
  * True when the hash covers only a prefix of the file.
2976
3128
  */
@@ -2988,6 +3140,15 @@ export declare namespace securitycenter_v1beta1 {
2988
3140
  */
2989
3141
  size?: string | null;
2990
3142
  }
3143
+ /**
3144
+ * Operation(s) performed on a file.
3145
+ */
3146
+ export interface Schema$GoogleCloudSecuritycenterV2FileOperation {
3147
+ /**
3148
+ * The type of the operation
3149
+ */
3150
+ type?: string | null;
3151
+ }
2991
3152
  /**
2992
3153
  * Security Command Center finding. A finding is a record of assessment data like security, risk, health, or privacy, that is ingested into Security Command Center for presentation, notification, analysis, policy testing, and enforcement. For example, a cross-site scripting (XSS) vulnerability in an App Engine application is a finding.
2993
3154
  */
@@ -3000,6 +3161,10 @@ export declare namespace securitycenter_v1beta1 {
3000
3161
  * AffectedResources associated with the finding.
3001
3162
  */
3002
3163
  affectedResources?: Schema$GoogleCloudSecuritycenterV2AffectedResources;
3164
+ /**
3165
+ * The AI model associated with the finding.
3166
+ */
3167
+ aiModel?: Schema$GoogleCloudSecuritycenterV2AiModel;
3003
3168
  /**
3004
3169
  * Represents an application associated with the finding.
3005
3170
  */
@@ -3169,7 +3334,7 @@ export declare namespace securitycenter_v1beta1 {
3169
3334
  */
3170
3335
  muteUpdateTime?: string | null;
3171
3336
  /**
3172
- * The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. The following list shows some examples: + `organizations/{organization_id\}/sources/{source_id\}/findings/{finding_id\}` + `organizations/{organization_id\}/sources/{source_id\}/locations/{location_id\}/findings/{finding_id\}` + `folders/{folder_id\}/sources/{source_id\}/findings/{finding_id\}` + `folders/{folder_id\}/sources/{source_id\}/locations/{location_id\}/findings/{finding_id\}` + `projects/{project_id\}/sources/{source_id\}/findings/{finding_id\}` + `projects/{project_id\}/sources/{source_id\}/locations/{location_id\}/findings/{finding_id\}`
3337
+ * Identifier. The [relative resource name](https://cloud.google.com/apis/design/resource_names#relative_resource_name) of the finding. The following list shows some examples: + `organizations/{organization_id\}/sources/{source_id\}/findings/{finding_id\}` + `organizations/{organization_id\}/sources/{source_id\}/locations/{location_id\}/findings/{finding_id\}` + `folders/{folder_id\}/sources/{source_id\}/findings/{finding_id\}` + `folders/{folder_id\}/sources/{source_id\}/locations/{location_id\}/findings/{finding_id\}` + `projects/{project_id\}/sources/{source_id\}/findings/{finding_id\}` + `projects/{project_id\}/sources/{source_id\}/locations/{location_id\}/findings/{finding_id\}`
3173
3338
  */
3174
3339
  name?: string | null;
3175
3340
  /**
@@ -3230,6 +3395,10 @@ export declare namespace securitycenter_v1beta1 {
3230
3395
  * Contains details about a group of security issues that, when the issues occur together, represent a greater risk than when the issues occur independently. A group of such issues is referred to as a toxic combination. This field cannot be updated. Its value is ignored in all update requests.
3231
3396
  */
3232
3397
  toxicCombination?: Schema$GoogleCloudSecuritycenterV2ToxicCombination;
3398
+ /**
3399
+ * VertexAi associated with the finding.
3400
+ */
3401
+ vertexAi?: Schema$GoogleCloudSecuritycenterV2VertexAi;
3233
3402
  /**
3234
3403
  * Represents vulnerability-specific fields like CVE and CVSS scores. CVE stands for Common Vulnerabilities and Exposures (https://cve.mitre.org/about/)
3235
3404
  */
@@ -3951,6 +4120,19 @@ export declare namespace securitycenter_v1beta1 {
3951
4120
  */
3952
4121
  packageVersion?: string | null;
3953
4122
  }
4123
+ /**
4124
+ * Vertex AI training pipeline associated with the finding.
4125
+ */
4126
+ export interface Schema$GoogleCloudSecuritycenterV2Pipeline {
4127
+ /**
4128
+ * The user-defined display name of pipeline, e.g. plants-classification
4129
+ */
4130
+ displayName?: string | null;
4131
+ /**
4132
+ * Resource name of the pipeline, e.g. projects/{project\}/locations/{location\}/trainingPipelines/5253428229225578496
4133
+ */
4134
+ name?: string | null;
4135
+ }
3954
4136
  /**
3955
4137
  * A Kubernetes Pod.
3956
4138
  */
@@ -4046,6 +4228,10 @@ export declare namespace securitycenter_v1beta1 {
4046
4228
  * When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
4047
4229
  */
4048
4230
  script?: Schema$GoogleCloudSecuritycenterV2File;
4231
+ /**
4232
+ * The ID of the user that executed the process. E.g. If this is the root user this will always be 0.
4233
+ */
4234
+ userId?: string | null;
4049
4235
  }
4050
4236
  /**
4051
4237
  * Indicates what signature matched this process.
@@ -4429,6 +4615,19 @@ export declare namespace securitycenter_v1beta1 {
4429
4615
  */
4430
4616
  relatedFindings?: string[] | null;
4431
4617
  }
4618
+ /**
4619
+ * Vertex AI-related information associated with the finding.
4620
+ */
4621
+ export interface Schema$GoogleCloudSecuritycenterV2VertexAi {
4622
+ /**
4623
+ * Datasets associated with the finding.
4624
+ */
4625
+ datasets?: Schema$GoogleCloudSecuritycenterV2Dataset[];
4626
+ /**
4627
+ * Pipelines associated with the finding.
4628
+ */
4629
+ pipelines?: Schema$GoogleCloudSecuritycenterV2Pipeline[];
4630
+ }
4432
4631
  /**
4433
4632
  * Refers to common vulnerability fields e.g. cve, cvss, cwe etc.
4434
4633
  */
@@ -5078,6 +5277,19 @@ export declare namespace securitycenter_v1beta1 {
5078
5277
  */
5079
5278
  packageVersion?: string | null;
5080
5279
  }
5280
+ /**
5281
+ * Vertex AI training pipeline associated with the finding.
5282
+ */
5283
+ export interface Schema$Pipeline {
5284
+ /**
5285
+ * The user defined display name of pipeline, e.g. plants-classification
5286
+ */
5287
+ displayName?: string | null;
5288
+ /**
5289
+ * Resource name of the pipeline, e.g. projects/{project\}/locations/{location\}/trainingPipelines/5253428229225578496
5290
+ */
5291
+ name?: string | null;
5292
+ }
5081
5293
  /**
5082
5294
  * A Kubernetes Pod.
5083
5295
  */
@@ -5194,6 +5406,10 @@ export declare namespace securitycenter_v1beta1 {
5194
5406
  * When the process represents the invocation of a script, `binary` provides information about the interpreter, while `script` provides information about the script file provided to the interpreter.
5195
5407
  */
5196
5408
  script?: Schema$File;
5409
+ /**
5410
+ * The ID of the user that executed the process. E.g. If this is the root user this will always be 0.
5411
+ */
5412
+ userId?: string | null;
5197
5413
  }
5198
5414
  /**
5199
5415
  * Indicates what signature matched this process.
@@ -5574,6 +5790,19 @@ export declare namespace securitycenter_v1beta1 {
5574
5790
  */
5575
5791
  relatedFindings?: string[] | null;
5576
5792
  }
5793
+ /**
5794
+ * Vertex AI-related information associated with the finding.
5795
+ */
5796
+ export interface Schema$VertexAi {
5797
+ /**
5798
+ * Datasets associated with the finding.
5799
+ */
5800
+ datasets?: Schema$Dataset[];
5801
+ /**
5802
+ * Pipelines associated with the finding.
5803
+ */
5804
+ pipelines?: Schema$Pipeline[];
5805
+ }
5577
5806
  /**
5578
5807
  * Refers to common vulnerability fields e.g. cve, cvss, cwe etc.
5579
5808
  */
@@ -5656,28 +5885,136 @@ export declare namespace securitycenter_v1beta1 {
5656
5885
  constructor(context: APIRequestContext);
5657
5886
  /**
5658
5887
  * Gets the settings for an organization.
5888
+ * @example
5889
+ * ```js
5890
+ * // Before running the sample:
5891
+ * // - Enable the API at:
5892
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
5893
+ * // - Login into gcloud by running:
5894
+ * // ```sh
5895
+ * // $ gcloud auth application-default login
5896
+ * // ```
5897
+ * // - Install the npm module by running:
5898
+ * // ```sh
5899
+ * // $ npm install googleapis
5900
+ * // ```
5901
+ *
5902
+ * const {google} = require('googleapis');
5903
+ * const securitycenter = google.securitycenter('v1beta1');
5904
+ *
5905
+ * async function main() {
5906
+ * const auth = new google.auth.GoogleAuth({
5907
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5908
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5909
+ * });
5910
+ *
5911
+ * // Acquire an auth client, and bind it to all future calls
5912
+ * const authClient = await auth.getClient();
5913
+ * google.options({auth: authClient});
5914
+ *
5915
+ * // Do the magic
5916
+ * const res = await securitycenter.organizations.getOrganizationSettings({
5917
+ * // Required. Name of the organization to get organization settings for. Its format is "organizations/[organization_id]/organizationSettings".
5918
+ * name: 'organizations/my-organization/organizationSettings',
5919
+ * });
5920
+ * console.log(res.data);
5921
+ *
5922
+ * // Example response
5923
+ * // {
5924
+ * // "assetDiscoveryConfig": {},
5925
+ * // "enableAssetDiscovery": false,
5926
+ * // "name": "my_name"
5927
+ * // }
5928
+ * }
5929
+ *
5930
+ * main().catch(e => {
5931
+ * console.error(e);
5932
+ * throw e;
5933
+ * });
5934
+ *
5935
+ * ```
5659
5936
  *
5660
5937
  * @param params - Parameters for request
5661
5938
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5662
5939
  * @param callback - Optional callback that handles the response.
5663
5940
  * @returns A promise if used with async/await, or void if used with a callback.
5664
5941
  */
5665
- getOrganizationSettings(params: Params$Resource$Organizations$Getorganizationsettings, options: StreamMethodOptions): GaxiosPromise<Readable>;
5666
- getOrganizationSettings(params?: Params$Resource$Organizations$Getorganizationsettings, options?: MethodOptions): GaxiosPromise<Schema$OrganizationSettings>;
5942
+ getOrganizationSettings(params: Params$Resource$Organizations$Getorganizationsettings, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
5943
+ getOrganizationSettings(params?: Params$Resource$Organizations$Getorganizationsettings, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$OrganizationSettings>>;
5667
5944
  getOrganizationSettings(params: Params$Resource$Organizations$Getorganizationsettings, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5668
5945
  getOrganizationSettings(params: Params$Resource$Organizations$Getorganizationsettings, options: MethodOptions | BodyResponseCallback<Schema$OrganizationSettings>, callback: BodyResponseCallback<Schema$OrganizationSettings>): void;
5669
5946
  getOrganizationSettings(params: Params$Resource$Organizations$Getorganizationsettings, callback: BodyResponseCallback<Schema$OrganizationSettings>): void;
5670
5947
  getOrganizationSettings(callback: BodyResponseCallback<Schema$OrganizationSettings>): void;
5671
5948
  /**
5672
5949
  * Updates an organization's settings.
5950
+ * @example
5951
+ * ```js
5952
+ * // Before running the sample:
5953
+ * // - Enable the API at:
5954
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
5955
+ * // - Login into gcloud by running:
5956
+ * // ```sh
5957
+ * // $ gcloud auth application-default login
5958
+ * // ```
5959
+ * // - Install the npm module by running:
5960
+ * // ```sh
5961
+ * // $ npm install googleapis
5962
+ * // ```
5963
+ *
5964
+ * const {google} = require('googleapis');
5965
+ * const securitycenter = google.securitycenter('v1beta1');
5966
+ *
5967
+ * async function main() {
5968
+ * const auth = new google.auth.GoogleAuth({
5969
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
5970
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
5971
+ * });
5972
+ *
5973
+ * // Acquire an auth client, and bind it to all future calls
5974
+ * const authClient = await auth.getClient();
5975
+ * google.options({auth: authClient});
5976
+ *
5977
+ * // Do the magic
5978
+ * const res = await securitycenter.organizations.updateOrganizationSettings({
5979
+ * // The relative resource name of the settings. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id\}/organizationSettings".
5980
+ * name: 'organizations/my-organization/organizationSettings',
5981
+ * // The FieldMask to use when updating the settings resource.
5982
+ * updateMask: 'placeholder-value',
5983
+ *
5984
+ * // Request body metadata
5985
+ * requestBody: {
5986
+ * // request body parameters
5987
+ * // {
5988
+ * // "assetDiscoveryConfig": {},
5989
+ * // "enableAssetDiscovery": false,
5990
+ * // "name": "my_name"
5991
+ * // }
5992
+ * },
5993
+ * });
5994
+ * console.log(res.data);
5995
+ *
5996
+ * // Example response
5997
+ * // {
5998
+ * // "assetDiscoveryConfig": {},
5999
+ * // "enableAssetDiscovery": false,
6000
+ * // "name": "my_name"
6001
+ * // }
6002
+ * }
6003
+ *
6004
+ * main().catch(e => {
6005
+ * console.error(e);
6006
+ * throw e;
6007
+ * });
6008
+ *
6009
+ * ```
5673
6010
  *
5674
6011
  * @param params - Parameters for request
5675
6012
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5676
6013
  * @param callback - Optional callback that handles the response.
5677
6014
  * @returns A promise if used with async/await, or void if used with a callback.
5678
6015
  */
5679
- updateOrganizationSettings(params: Params$Resource$Organizations$Updateorganizationsettings, options: StreamMethodOptions): GaxiosPromise<Readable>;
5680
- updateOrganizationSettings(params?: Params$Resource$Organizations$Updateorganizationsettings, options?: MethodOptions): GaxiosPromise<Schema$OrganizationSettings>;
6016
+ updateOrganizationSettings(params: Params$Resource$Organizations$Updateorganizationsettings, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6017
+ updateOrganizationSettings(params?: Params$Resource$Organizations$Updateorganizationsettings, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$OrganizationSettings>>;
5681
6018
  updateOrganizationSettings(params: Params$Resource$Organizations$Updateorganizationsettings, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5682
6019
  updateOrganizationSettings(params: Params$Resource$Organizations$Updateorganizationsettings, options: MethodOptions | BodyResponseCallback<Schema$OrganizationSettings>, callback: BodyResponseCallback<Schema$OrganizationSettings>): void;
5683
6020
  updateOrganizationSettings(params: Params$Resource$Organizations$Updateorganizationsettings, callback: BodyResponseCallback<Schema$OrganizationSettings>): void;
@@ -5708,56 +6045,296 @@ export declare namespace securitycenter_v1beta1 {
5708
6045
  constructor(context: APIRequestContext);
5709
6046
  /**
5710
6047
  * Filters an organization's assets and groups them by their specified properties.
6048
+ * @example
6049
+ * ```js
6050
+ * // Before running the sample:
6051
+ * // - Enable the API at:
6052
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6053
+ * // - Login into gcloud by running:
6054
+ * // ```sh
6055
+ * // $ gcloud auth application-default login
6056
+ * // ```
6057
+ * // - Install the npm module by running:
6058
+ * // ```sh
6059
+ * // $ npm install googleapis
6060
+ * // ```
6061
+ *
6062
+ * const {google} = require('googleapis');
6063
+ * const securitycenter = google.securitycenter('v1beta1');
6064
+ *
6065
+ * async function main() {
6066
+ * const auth = new google.auth.GoogleAuth({
6067
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6068
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6069
+ * });
6070
+ *
6071
+ * // Acquire an auth client, and bind it to all future calls
6072
+ * const authClient = await auth.getClient();
6073
+ * google.options({auth: authClient});
6074
+ *
6075
+ * // Do the magic
6076
+ * const res = await securitycenter.organizations.assets.group({
6077
+ * // Required. Name of the organization to groupBy. Its format is "organizations/[organization_id]".
6078
+ * parent: 'organizations/my-organization',
6079
+ *
6080
+ * // Request body metadata
6081
+ * requestBody: {
6082
+ * // request body parameters
6083
+ * // {
6084
+ * // "compareDuration": "my_compareDuration",
6085
+ * // "filter": "my_filter",
6086
+ * // "groupBy": "my_groupBy",
6087
+ * // "pageSize": 0,
6088
+ * // "pageToken": "my_pageToken",
6089
+ * // "readTime": "my_readTime"
6090
+ * // }
6091
+ * },
6092
+ * });
6093
+ * console.log(res.data);
6094
+ *
6095
+ * // Example response
6096
+ * // {
6097
+ * // "groupByResults": [],
6098
+ * // "nextPageToken": "my_nextPageToken",
6099
+ * // "readTime": "my_readTime"
6100
+ * // }
6101
+ * }
6102
+ *
6103
+ * main().catch(e => {
6104
+ * console.error(e);
6105
+ * throw e;
6106
+ * });
6107
+ *
6108
+ * ```
5711
6109
  *
5712
6110
  * @param params - Parameters for request
5713
6111
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5714
6112
  * @param callback - Optional callback that handles the response.
5715
6113
  * @returns A promise if used with async/await, or void if used with a callback.
5716
6114
  */
5717
- group(params: Params$Resource$Organizations$Assets$Group, options: StreamMethodOptions): GaxiosPromise<Readable>;
5718
- group(params?: Params$Resource$Organizations$Assets$Group, options?: MethodOptions): GaxiosPromise<Schema$GroupAssetsResponse>;
6115
+ group(params: Params$Resource$Organizations$Assets$Group, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6116
+ group(params?: Params$Resource$Organizations$Assets$Group, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GroupAssetsResponse>>;
5719
6117
  group(params: Params$Resource$Organizations$Assets$Group, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5720
6118
  group(params: Params$Resource$Organizations$Assets$Group, options: MethodOptions | BodyResponseCallback<Schema$GroupAssetsResponse>, callback: BodyResponseCallback<Schema$GroupAssetsResponse>): void;
5721
6119
  group(params: Params$Resource$Organizations$Assets$Group, callback: BodyResponseCallback<Schema$GroupAssetsResponse>): void;
5722
6120
  group(callback: BodyResponseCallback<Schema$GroupAssetsResponse>): void;
5723
6121
  /**
5724
6122
  * Lists an organization's assets.
6123
+ * @example
6124
+ * ```js
6125
+ * // Before running the sample:
6126
+ * // - Enable the API at:
6127
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6128
+ * // - Login into gcloud by running:
6129
+ * // ```sh
6130
+ * // $ gcloud auth application-default login
6131
+ * // ```
6132
+ * // - Install the npm module by running:
6133
+ * // ```sh
6134
+ * // $ npm install googleapis
6135
+ * // ```
6136
+ *
6137
+ * const {google} = require('googleapis');
6138
+ * const securitycenter = google.securitycenter('v1beta1');
6139
+ *
6140
+ * async function main() {
6141
+ * const auth = new google.auth.GoogleAuth({
6142
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6143
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6144
+ * });
6145
+ *
6146
+ * // Acquire an auth client, and bind it to all future calls
6147
+ * const authClient = await auth.getClient();
6148
+ * google.options({auth: authClient});
6149
+ *
6150
+ * // Do the magic
6151
+ * const res = await securitycenter.organizations.assets.list({
6152
+ * // When compare_duration is set, the ListAssetResult's "state" attribute is updated to indicate whether the asset was added, removed, or remained present during the compare_duration period of time that precedes the read_time. This is the time between (read_time - compare_duration) and read_time. The state value is derived based on the presence of the asset at the two points in time. Intermediate state changes between the two times don't affect the result. For example, the results aren't affected if the asset is removed and re-created again. Possible "state" values when compare_duration is specified: * "ADDED": indicates that the asset was not present before compare_duration, but present at read_time. * "REMOVED": indicates that the asset was present at the start of compare_duration, but not present at read_time. * "ACTIVE": indicates that the asset was present at both the start and the end of the time period defined by compare_duration and read_time. If compare_duration is not specified, then the only possible state is "UNUSED", which indicates that the asset is present at read_time.
6153
+ * compareDuration: 'placeholder-value',
6154
+ * // Optional. A field mask to specify the ListAssetsResult fields to be listed in the response. An empty field mask will list all fields.
6155
+ * fieldMask: 'placeholder-value',
6156
+ * // Expression that defines the filter to apply across assets. The expression is a list of zero or more restrictions combined via logical operators `AND` and `OR`. Parentheses are not supported, and `OR` has higher precedence than `AND`. Restrictions have the form ` ` and may have a `-` character in front of them to indicate negation. The fields map to those defined in the Asset resource. Examples include: * name * security_center_properties.resource_name * resource_properties.a_property * security_marks.marks.marka The supported operators are: * `=` for all value types. * `\>`, `<`, `\>=`, `<=` for integer values. * `:`, meaning substring matching, for strings. The supported value types are: * string literals in quotes. * integer literals without quotes. * boolean literals `true` and `false` without quotes. For example, `resource_properties.size = 100` is a valid filter string.
6157
+ * filter: 'placeholder-value',
6158
+ * // Expression that defines what fields and order to use for sorting. The string value should follow SQL syntax: comma separated list of fields. For example: "name,resource_properties.a_property". The default sorting order is ascending. To specify descending order for a field, a suffix " desc" should be appended to the field name. For example: "name desc,resource_properties.a_property". Redundant space characters in the syntax are insignificant. "name desc,resource_properties.a_property" and " name desc , resource_properties.a_property " are equivalent.
6159
+ * orderBy: 'placeholder-value',
6160
+ * // The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.
6161
+ * pageSize: 'placeholder-value',
6162
+ * // The value returned by the last `ListAssetsResponse`; indicates that this is a continuation of a prior `ListAssets` call, and that the system should return the next page of data.
6163
+ * pageToken: 'placeholder-value',
6164
+ * // Required. Name of the organization assets should belong to. Its format is "organizations/[organization_id]".
6165
+ * parent: 'organizations/my-organization',
6166
+ * // Time used as a reference point when filtering assets. The filter is limited to assets existing at the supplied time and their values are those at that specific time. Absence of this field will default to the API's version of NOW.
6167
+ * readTime: 'placeholder-value',
6168
+ * });
6169
+ * console.log(res.data);
6170
+ *
6171
+ * // Example response
6172
+ * // {
6173
+ * // "listAssetsResults": [],
6174
+ * // "nextPageToken": "my_nextPageToken",
6175
+ * // "readTime": "my_readTime",
6176
+ * // "totalSize": 0
6177
+ * // }
6178
+ * }
6179
+ *
6180
+ * main().catch(e => {
6181
+ * console.error(e);
6182
+ * throw e;
6183
+ * });
6184
+ *
6185
+ * ```
5725
6186
  *
5726
6187
  * @param params - Parameters for request
5727
6188
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5728
6189
  * @param callback - Optional callback that handles the response.
5729
6190
  * @returns A promise if used with async/await, or void if used with a callback.
5730
6191
  */
5731
- list(params: Params$Resource$Organizations$Assets$List, options: StreamMethodOptions): GaxiosPromise<Readable>;
5732
- list(params?: Params$Resource$Organizations$Assets$List, options?: MethodOptions): GaxiosPromise<Schema$ListAssetsResponse>;
6192
+ list(params: Params$Resource$Organizations$Assets$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6193
+ list(params?: Params$Resource$Organizations$Assets$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListAssetsResponse>>;
5733
6194
  list(params: Params$Resource$Organizations$Assets$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5734
6195
  list(params: Params$Resource$Organizations$Assets$List, options: MethodOptions | BodyResponseCallback<Schema$ListAssetsResponse>, callback: BodyResponseCallback<Schema$ListAssetsResponse>): void;
5735
6196
  list(params: Params$Resource$Organizations$Assets$List, callback: BodyResponseCallback<Schema$ListAssetsResponse>): void;
5736
6197
  list(callback: BodyResponseCallback<Schema$ListAssetsResponse>): void;
5737
6198
  /**
5738
6199
  * Runs asset discovery. The discovery is tracked with a long-running operation. This API can only be called with limited frequency for an organization. If it is called too frequently the caller will receive a TOO_MANY_REQUESTS error.
6200
+ * @example
6201
+ * ```js
6202
+ * // Before running the sample:
6203
+ * // - Enable the API at:
6204
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6205
+ * // - Login into gcloud by running:
6206
+ * // ```sh
6207
+ * // $ gcloud auth application-default login
6208
+ * // ```
6209
+ * // - Install the npm module by running:
6210
+ * // ```sh
6211
+ * // $ npm install googleapis
6212
+ * // ```
6213
+ *
6214
+ * const {google} = require('googleapis');
6215
+ * const securitycenter = google.securitycenter('v1beta1');
6216
+ *
6217
+ * async function main() {
6218
+ * const auth = new google.auth.GoogleAuth({
6219
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6220
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6221
+ * });
6222
+ *
6223
+ * // Acquire an auth client, and bind it to all future calls
6224
+ * const authClient = await auth.getClient();
6225
+ * google.options({auth: authClient});
6226
+ *
6227
+ * // Do the magic
6228
+ * const res = await securitycenter.organizations.assets.runDiscovery({
6229
+ * // Required. Name of the organization to run asset discovery for. Its format is "organizations/[organization_id]".
6230
+ * parent: 'organizations/my-organization',
6231
+ *
6232
+ * // Request body metadata
6233
+ * requestBody: {
6234
+ * // request body parameters
6235
+ * // {}
6236
+ * },
6237
+ * });
6238
+ * console.log(res.data);
6239
+ *
6240
+ * // Example response
6241
+ * // {
6242
+ * // "done": false,
6243
+ * // "error": {},
6244
+ * // "metadata": {},
6245
+ * // "name": "my_name",
6246
+ * // "response": {}
6247
+ * // }
6248
+ * }
6249
+ *
6250
+ * main().catch(e => {
6251
+ * console.error(e);
6252
+ * throw e;
6253
+ * });
6254
+ *
6255
+ * ```
5739
6256
  *
5740
6257
  * @param params - Parameters for request
5741
6258
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5742
6259
  * @param callback - Optional callback that handles the response.
5743
6260
  * @returns A promise if used with async/await, or void if used with a callback.
5744
6261
  */
5745
- runDiscovery(params: Params$Resource$Organizations$Assets$Rundiscovery, options: StreamMethodOptions): GaxiosPromise<Readable>;
5746
- runDiscovery(params?: Params$Resource$Organizations$Assets$Rundiscovery, options?: MethodOptions): GaxiosPromise<Schema$Operation>;
6262
+ runDiscovery(params: Params$Resource$Organizations$Assets$Rundiscovery, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6263
+ runDiscovery(params?: Params$Resource$Organizations$Assets$Rundiscovery, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
5747
6264
  runDiscovery(params: Params$Resource$Organizations$Assets$Rundiscovery, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5748
6265
  runDiscovery(params: Params$Resource$Organizations$Assets$Rundiscovery, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
5749
6266
  runDiscovery(params: Params$Resource$Organizations$Assets$Rundiscovery, callback: BodyResponseCallback<Schema$Operation>): void;
5750
6267
  runDiscovery(callback: BodyResponseCallback<Schema$Operation>): void;
5751
6268
  /**
5752
6269
  * Updates security marks.
6270
+ * @example
6271
+ * ```js
6272
+ * // Before running the sample:
6273
+ * // - Enable the API at:
6274
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6275
+ * // - Login into gcloud by running:
6276
+ * // ```sh
6277
+ * // $ gcloud auth application-default login
6278
+ * // ```
6279
+ * // - Install the npm module by running:
6280
+ * // ```sh
6281
+ * // $ npm install googleapis
6282
+ * // ```
6283
+ *
6284
+ * const {google} = require('googleapis');
6285
+ * const securitycenter = google.securitycenter('v1beta1');
6286
+ *
6287
+ * async function main() {
6288
+ * const auth = new google.auth.GoogleAuth({
6289
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6290
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6291
+ * });
6292
+ *
6293
+ * // Acquire an auth client, and bind it to all future calls
6294
+ * const authClient = await auth.getClient();
6295
+ * google.options({auth: authClient});
6296
+ *
6297
+ * // Do the magic
6298
+ * const res = await securitycenter.organizations.assets.updateSecurityMarks({
6299
+ * // The relative resource name of the SecurityMarks. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id\}/assets/{asset_id\}/securityMarks" "organizations/{organization_id\}/sources/{source_id\}/findings/{finding_id\}/securityMarks".
6300
+ * name: 'organizations/my-organization/assets/my-asset/securityMarks',
6301
+ * // The time at which the updated SecurityMarks take effect.
6302
+ * startTime: 'placeholder-value',
6303
+ * // The FieldMask to use when updating the security marks resource.
6304
+ * updateMask: 'placeholder-value',
6305
+ *
6306
+ * // Request body metadata
6307
+ * requestBody: {
6308
+ * // request body parameters
6309
+ * // {
6310
+ * // "marks": {},
6311
+ * // "name": "my_name"
6312
+ * // }
6313
+ * },
6314
+ * });
6315
+ * console.log(res.data);
6316
+ *
6317
+ * // Example response
6318
+ * // {
6319
+ * // "marks": {},
6320
+ * // "name": "my_name"
6321
+ * // }
6322
+ * }
6323
+ *
6324
+ * main().catch(e => {
6325
+ * console.error(e);
6326
+ * throw e;
6327
+ * });
6328
+ *
6329
+ * ```
5753
6330
  *
5754
6331
  * @param params - Parameters for request
5755
6332
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5756
6333
  * @param callback - Optional callback that handles the response.
5757
6334
  * @returns A promise if used with async/await, or void if used with a callback.
5758
6335
  */
5759
- updateSecurityMarks(params: Params$Resource$Organizations$Assets$Updatesecuritymarks, options: StreamMethodOptions): GaxiosPromise<Readable>;
5760
- updateSecurityMarks(params?: Params$Resource$Organizations$Assets$Updatesecuritymarks, options?: MethodOptions): GaxiosPromise<Schema$GoogleCloudSecuritycenterV1beta1SecurityMarks>;
6336
+ updateSecurityMarks(params: Params$Resource$Organizations$Assets$Updatesecuritymarks, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6337
+ updateSecurityMarks(params?: Params$Resource$Organizations$Assets$Updatesecuritymarks, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudSecuritycenterV1beta1SecurityMarks>>;
5761
6338
  updateSecurityMarks(params: Params$Resource$Organizations$Assets$Updatesecuritymarks, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5762
6339
  updateSecurityMarks(params: Params$Resource$Organizations$Assets$Updatesecuritymarks, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1SecurityMarks>, callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1SecurityMarks>): void;
5763
6340
  updateSecurityMarks(params: Params$Resource$Organizations$Assets$Updatesecuritymarks, callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1SecurityMarks>): void;
@@ -5840,56 +6417,253 @@ export declare namespace securitycenter_v1beta1 {
5840
6417
  constructor(context: APIRequestContext);
5841
6418
  /**
5842
6419
  * 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`.
6420
+ * @example
6421
+ * ```js
6422
+ * // Before running the sample:
6423
+ * // - Enable the API at:
6424
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6425
+ * // - Login into gcloud by running:
6426
+ * // ```sh
6427
+ * // $ gcloud auth application-default login
6428
+ * // ```
6429
+ * // - Install the npm module by running:
6430
+ * // ```sh
6431
+ * // $ npm install googleapis
6432
+ * // ```
6433
+ *
6434
+ * const {google} = require('googleapis');
6435
+ * const securitycenter = google.securitycenter('v1beta1');
6436
+ *
6437
+ * async function main() {
6438
+ * const auth = new google.auth.GoogleAuth({
6439
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6440
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6441
+ * });
6442
+ *
6443
+ * // Acquire an auth client, and bind it to all future calls
6444
+ * const authClient = await auth.getClient();
6445
+ * google.options({auth: authClient});
6446
+ *
6447
+ * // Do the magic
6448
+ * const res = await securitycenter.organizations.operations.cancel({
6449
+ * // The name of the operation resource to be cancelled.
6450
+ * name: 'organizations/my-organization/operations/my-operation',
6451
+ *
6452
+ * // Request body metadata
6453
+ * requestBody: {
6454
+ * // request body parameters
6455
+ * // {}
6456
+ * },
6457
+ * });
6458
+ * console.log(res.data);
6459
+ *
6460
+ * // Example response
6461
+ * // {}
6462
+ * }
6463
+ *
6464
+ * main().catch(e => {
6465
+ * console.error(e);
6466
+ * throw e;
6467
+ * });
6468
+ *
6469
+ * ```
5843
6470
  *
5844
6471
  * @param params - Parameters for request
5845
6472
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5846
6473
  * @param callback - Optional callback that handles the response.
5847
6474
  * @returns A promise if used with async/await, or void if used with a callback.
5848
6475
  */
5849
- cancel(params: Params$Resource$Organizations$Operations$Cancel, options: StreamMethodOptions): GaxiosPromise<Readable>;
5850
- cancel(params?: Params$Resource$Organizations$Operations$Cancel, options?: MethodOptions): GaxiosPromise<Schema$Empty>;
6476
+ cancel(params: Params$Resource$Organizations$Operations$Cancel, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6477
+ cancel(params?: Params$Resource$Organizations$Operations$Cancel, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Empty>>;
5851
6478
  cancel(params: Params$Resource$Organizations$Operations$Cancel, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5852
6479
  cancel(params: Params$Resource$Organizations$Operations$Cancel, options: MethodOptions | BodyResponseCallback<Schema$Empty>, callback: BodyResponseCallback<Schema$Empty>): void;
5853
6480
  cancel(params: Params$Resource$Organizations$Operations$Cancel, callback: BodyResponseCallback<Schema$Empty>): void;
5854
6481
  cancel(callback: BodyResponseCallback<Schema$Empty>): void;
5855
6482
  /**
5856
6483
  * 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`.
6484
+ * @example
6485
+ * ```js
6486
+ * // Before running the sample:
6487
+ * // - Enable the API at:
6488
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6489
+ * // - Login into gcloud by running:
6490
+ * // ```sh
6491
+ * // $ gcloud auth application-default login
6492
+ * // ```
6493
+ * // - Install the npm module by running:
6494
+ * // ```sh
6495
+ * // $ npm install googleapis
6496
+ * // ```
6497
+ *
6498
+ * const {google} = require('googleapis');
6499
+ * const securitycenter = google.securitycenter('v1beta1');
6500
+ *
6501
+ * async function main() {
6502
+ * const auth = new google.auth.GoogleAuth({
6503
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6504
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6505
+ * });
6506
+ *
6507
+ * // Acquire an auth client, and bind it to all future calls
6508
+ * const authClient = await auth.getClient();
6509
+ * google.options({auth: authClient});
6510
+ *
6511
+ * // Do the magic
6512
+ * const res = await securitycenter.organizations.operations.delete({
6513
+ * // The name of the operation resource to be deleted.
6514
+ * name: 'organizations/my-organization/operations/my-operation',
6515
+ * });
6516
+ * console.log(res.data);
6517
+ *
6518
+ * // Example response
6519
+ * // {}
6520
+ * }
6521
+ *
6522
+ * main().catch(e => {
6523
+ * console.error(e);
6524
+ * throw e;
6525
+ * });
6526
+ *
6527
+ * ```
5857
6528
  *
5858
6529
  * @param params - Parameters for request
5859
6530
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5860
6531
  * @param callback - Optional callback that handles the response.
5861
6532
  * @returns A promise if used with async/await, or void if used with a callback.
5862
6533
  */
5863
- delete(params: Params$Resource$Organizations$Operations$Delete, options: StreamMethodOptions): GaxiosPromise<Readable>;
5864
- delete(params?: Params$Resource$Organizations$Operations$Delete, options?: MethodOptions): GaxiosPromise<Schema$Empty>;
6534
+ delete(params: Params$Resource$Organizations$Operations$Delete, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6535
+ delete(params?: Params$Resource$Organizations$Operations$Delete, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Empty>>;
5865
6536
  delete(params: Params$Resource$Organizations$Operations$Delete, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5866
6537
  delete(params: Params$Resource$Organizations$Operations$Delete, options: MethodOptions | BodyResponseCallback<Schema$Empty>, callback: BodyResponseCallback<Schema$Empty>): void;
5867
6538
  delete(params: Params$Resource$Organizations$Operations$Delete, callback: BodyResponseCallback<Schema$Empty>): void;
5868
6539
  delete(callback: BodyResponseCallback<Schema$Empty>): void;
5869
6540
  /**
5870
6541
  * 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.
6542
+ * @example
6543
+ * ```js
6544
+ * // Before running the sample:
6545
+ * // - Enable the API at:
6546
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6547
+ * // - Login into gcloud by running:
6548
+ * // ```sh
6549
+ * // $ gcloud auth application-default login
6550
+ * // ```
6551
+ * // - Install the npm module by running:
6552
+ * // ```sh
6553
+ * // $ npm install googleapis
6554
+ * // ```
6555
+ *
6556
+ * const {google} = require('googleapis');
6557
+ * const securitycenter = google.securitycenter('v1beta1');
6558
+ *
6559
+ * async function main() {
6560
+ * const auth = new google.auth.GoogleAuth({
6561
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6562
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6563
+ * });
6564
+ *
6565
+ * // Acquire an auth client, and bind it to all future calls
6566
+ * const authClient = await auth.getClient();
6567
+ * google.options({auth: authClient});
6568
+ *
6569
+ * // Do the magic
6570
+ * const res = await securitycenter.organizations.operations.get({
6571
+ * // The name of the operation resource.
6572
+ * name: 'organizations/my-organization/operations/my-operation',
6573
+ * });
6574
+ * console.log(res.data);
6575
+ *
6576
+ * // Example response
6577
+ * // {
6578
+ * // "done": false,
6579
+ * // "error": {},
6580
+ * // "metadata": {},
6581
+ * // "name": "my_name",
6582
+ * // "response": {}
6583
+ * // }
6584
+ * }
6585
+ *
6586
+ * main().catch(e => {
6587
+ * console.error(e);
6588
+ * throw e;
6589
+ * });
6590
+ *
6591
+ * ```
5871
6592
  *
5872
6593
  * @param params - Parameters for request
5873
6594
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5874
6595
  * @param callback - Optional callback that handles the response.
5875
6596
  * @returns A promise if used with async/await, or void if used with a callback.
5876
6597
  */
5877
- get(params: Params$Resource$Organizations$Operations$Get, options: StreamMethodOptions): GaxiosPromise<Readable>;
5878
- get(params?: Params$Resource$Organizations$Operations$Get, options?: MethodOptions): GaxiosPromise<Schema$Operation>;
6598
+ get(params: Params$Resource$Organizations$Operations$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6599
+ get(params?: Params$Resource$Organizations$Operations$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Operation>>;
5879
6600
  get(params: Params$Resource$Organizations$Operations$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5880
6601
  get(params: Params$Resource$Organizations$Operations$Get, options: MethodOptions | BodyResponseCallback<Schema$Operation>, callback: BodyResponseCallback<Schema$Operation>): void;
5881
6602
  get(params: Params$Resource$Organizations$Operations$Get, callback: BodyResponseCallback<Schema$Operation>): void;
5882
6603
  get(callback: BodyResponseCallback<Schema$Operation>): void;
5883
6604
  /**
5884
6605
  * Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.
6606
+ * @example
6607
+ * ```js
6608
+ * // Before running the sample:
6609
+ * // - Enable the API at:
6610
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6611
+ * // - Login into gcloud by running:
6612
+ * // ```sh
6613
+ * // $ gcloud auth application-default login
6614
+ * // ```
6615
+ * // - Install the npm module by running:
6616
+ * // ```sh
6617
+ * // $ npm install googleapis
6618
+ * // ```
6619
+ *
6620
+ * const {google} = require('googleapis');
6621
+ * const securitycenter = google.securitycenter('v1beta1');
6622
+ *
6623
+ * async function main() {
6624
+ * const auth = new google.auth.GoogleAuth({
6625
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6626
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6627
+ * });
6628
+ *
6629
+ * // Acquire an auth client, and bind it to all future calls
6630
+ * const authClient = await auth.getClient();
6631
+ * google.options({auth: authClient});
6632
+ *
6633
+ * // Do the magic
6634
+ * const res = await securitycenter.organizations.operations.list({
6635
+ * // The standard list filter.
6636
+ * filter: 'placeholder-value',
6637
+ * // The name of the operation's parent resource.
6638
+ * name: 'organizations/my-organization/operations',
6639
+ * // The standard list page size.
6640
+ * pageSize: 'placeholder-value',
6641
+ * // The standard list page token.
6642
+ * pageToken: 'placeholder-value',
6643
+ * });
6644
+ * console.log(res.data);
6645
+ *
6646
+ * // Example response
6647
+ * // {
6648
+ * // "nextPageToken": "my_nextPageToken",
6649
+ * // "operations": []
6650
+ * // }
6651
+ * }
6652
+ *
6653
+ * main().catch(e => {
6654
+ * console.error(e);
6655
+ * throw e;
6656
+ * });
6657
+ *
6658
+ * ```
5885
6659
  *
5886
6660
  * @param params - Parameters for request
5887
6661
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5888
6662
  * @param callback - Optional callback that handles the response.
5889
6663
  * @returns A promise if used with async/await, or void if used with a callback.
5890
6664
  */
5891
- list(params: Params$Resource$Organizations$Operations$List, options: StreamMethodOptions): GaxiosPromise<Readable>;
5892
- list(params?: Params$Resource$Organizations$Operations$List, options?: MethodOptions): GaxiosPromise<Schema$ListOperationsResponse>;
6665
+ list(params: Params$Resource$Organizations$Operations$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6666
+ list(params?: Params$Resource$Organizations$Operations$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListOperationsResponse>>;
5893
6667
  list(params: Params$Resource$Organizations$Operations$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5894
6668
  list(params: Params$Resource$Organizations$Operations$List, options: MethodOptions | BodyResponseCallback<Schema$ListOperationsResponse>, callback: BodyResponseCallback<Schema$ListOperationsResponse>): void;
5895
6669
  list(params: Params$Resource$Organizations$Operations$List, callback: BodyResponseCallback<Schema$ListOperationsResponse>): void;
@@ -5941,98 +6715,484 @@ export declare namespace securitycenter_v1beta1 {
5941
6715
  constructor(context: APIRequestContext);
5942
6716
  /**
5943
6717
  * Creates a source.
6718
+ * @example
6719
+ * ```js
6720
+ * // Before running the sample:
6721
+ * // - Enable the API at:
6722
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6723
+ * // - Login into gcloud by running:
6724
+ * // ```sh
6725
+ * // $ gcloud auth application-default login
6726
+ * // ```
6727
+ * // - Install the npm module by running:
6728
+ * // ```sh
6729
+ * // $ npm install googleapis
6730
+ * // ```
6731
+ *
6732
+ * const {google} = require('googleapis');
6733
+ * const securitycenter = google.securitycenter('v1beta1');
6734
+ *
6735
+ * async function main() {
6736
+ * const auth = new google.auth.GoogleAuth({
6737
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6738
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6739
+ * });
6740
+ *
6741
+ * // Acquire an auth client, and bind it to all future calls
6742
+ * const authClient = await auth.getClient();
6743
+ * google.options({auth: authClient});
6744
+ *
6745
+ * // Do the magic
6746
+ * const res = await securitycenter.organizations.sources.create({
6747
+ * // Required. Resource name of the new source's parent. Its format should be "organizations/[organization_id]".
6748
+ * parent: 'organizations/my-organization',
6749
+ *
6750
+ * // Request body metadata
6751
+ * requestBody: {
6752
+ * // request body parameters
6753
+ * // {
6754
+ * // "description": "my_description",
6755
+ * // "displayName": "my_displayName",
6756
+ * // "name": "my_name"
6757
+ * // }
6758
+ * },
6759
+ * });
6760
+ * console.log(res.data);
6761
+ *
6762
+ * // Example response
6763
+ * // {
6764
+ * // "description": "my_description",
6765
+ * // "displayName": "my_displayName",
6766
+ * // "name": "my_name"
6767
+ * // }
6768
+ * }
6769
+ *
6770
+ * main().catch(e => {
6771
+ * console.error(e);
6772
+ * throw e;
6773
+ * });
6774
+ *
6775
+ * ```
5944
6776
  *
5945
6777
  * @param params - Parameters for request
5946
6778
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5947
6779
  * @param callback - Optional callback that handles the response.
5948
6780
  * @returns A promise if used with async/await, or void if used with a callback.
5949
6781
  */
5950
- create(params: Params$Resource$Organizations$Sources$Create, options: StreamMethodOptions): GaxiosPromise<Readable>;
5951
- create(params?: Params$Resource$Organizations$Sources$Create, options?: MethodOptions): GaxiosPromise<Schema$Source>;
6782
+ create(params: Params$Resource$Organizations$Sources$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6783
+ create(params?: Params$Resource$Organizations$Sources$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Source>>;
5952
6784
  create(params: Params$Resource$Organizations$Sources$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5953
6785
  create(params: Params$Resource$Organizations$Sources$Create, options: MethodOptions | BodyResponseCallback<Schema$Source>, callback: BodyResponseCallback<Schema$Source>): void;
5954
6786
  create(params: Params$Resource$Organizations$Sources$Create, callback: BodyResponseCallback<Schema$Source>): void;
5955
6787
  create(callback: BodyResponseCallback<Schema$Source>): void;
5956
6788
  /**
5957
6789
  * Gets a source.
6790
+ * @example
6791
+ * ```js
6792
+ * // Before running the sample:
6793
+ * // - Enable the API at:
6794
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6795
+ * // - Login into gcloud by running:
6796
+ * // ```sh
6797
+ * // $ gcloud auth application-default login
6798
+ * // ```
6799
+ * // - Install the npm module by running:
6800
+ * // ```sh
6801
+ * // $ npm install googleapis
6802
+ * // ```
6803
+ *
6804
+ * const {google} = require('googleapis');
6805
+ * const securitycenter = google.securitycenter('v1beta1');
6806
+ *
6807
+ * async function main() {
6808
+ * const auth = new google.auth.GoogleAuth({
6809
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6810
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6811
+ * });
6812
+ *
6813
+ * // Acquire an auth client, and bind it to all future calls
6814
+ * const authClient = await auth.getClient();
6815
+ * google.options({auth: authClient});
6816
+ *
6817
+ * // Do the magic
6818
+ * const res = await securitycenter.organizations.sources.get({
6819
+ * // Required. Relative resource name of the source. Its format is "organizations/[organization_id]/source/[source_id]".
6820
+ * name: 'organizations/my-organization/sources/my-source',
6821
+ * });
6822
+ * console.log(res.data);
6823
+ *
6824
+ * // Example response
6825
+ * // {
6826
+ * // "description": "my_description",
6827
+ * // "displayName": "my_displayName",
6828
+ * // "name": "my_name"
6829
+ * // }
6830
+ * }
6831
+ *
6832
+ * main().catch(e => {
6833
+ * console.error(e);
6834
+ * throw e;
6835
+ * });
6836
+ *
6837
+ * ```
5958
6838
  *
5959
6839
  * @param params - Parameters for request
5960
6840
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5961
6841
  * @param callback - Optional callback that handles the response.
5962
6842
  * @returns A promise if used with async/await, or void if used with a callback.
5963
6843
  */
5964
- get(params: Params$Resource$Organizations$Sources$Get, options: StreamMethodOptions): GaxiosPromise<Readable>;
5965
- get(params?: Params$Resource$Organizations$Sources$Get, options?: MethodOptions): GaxiosPromise<Schema$Source>;
6844
+ get(params: Params$Resource$Organizations$Sources$Get, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6845
+ get(params?: Params$Resource$Organizations$Sources$Get, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Source>>;
5966
6846
  get(params: Params$Resource$Organizations$Sources$Get, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5967
6847
  get(params: Params$Resource$Organizations$Sources$Get, options: MethodOptions | BodyResponseCallback<Schema$Source>, callback: BodyResponseCallback<Schema$Source>): void;
5968
6848
  get(params: Params$Resource$Organizations$Sources$Get, callback: BodyResponseCallback<Schema$Source>): void;
5969
6849
  get(callback: BodyResponseCallback<Schema$Source>): void;
5970
6850
  /**
5971
6851
  * Gets the access control policy on the specified Source.
6852
+ * @example
6853
+ * ```js
6854
+ * // Before running the sample:
6855
+ * // - Enable the API at:
6856
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6857
+ * // - Login into gcloud by running:
6858
+ * // ```sh
6859
+ * // $ gcloud auth application-default login
6860
+ * // ```
6861
+ * // - Install the npm module by running:
6862
+ * // ```sh
6863
+ * // $ npm install googleapis
6864
+ * // ```
6865
+ *
6866
+ * const {google} = require('googleapis');
6867
+ * const securitycenter = google.securitycenter('v1beta1');
6868
+ *
6869
+ * async function main() {
6870
+ * const auth = new google.auth.GoogleAuth({
6871
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6872
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6873
+ * });
6874
+ *
6875
+ * // Acquire an auth client, and bind it to all future calls
6876
+ * const authClient = await auth.getClient();
6877
+ * google.options({auth: authClient});
6878
+ *
6879
+ * // Do the magic
6880
+ * const res = await securitycenter.organizations.sources.getIamPolicy({
6881
+ * // REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
6882
+ * resource: 'organizations/my-organization/sources/my-source',
6883
+ *
6884
+ * // Request body metadata
6885
+ * requestBody: {
6886
+ * // request body parameters
6887
+ * // {
6888
+ * // "options": {}
6889
+ * // }
6890
+ * },
6891
+ * });
6892
+ * console.log(res.data);
6893
+ *
6894
+ * // Example response
6895
+ * // {
6896
+ * // "auditConfigs": [],
6897
+ * // "bindings": [],
6898
+ * // "etag": "my_etag",
6899
+ * // "version": 0
6900
+ * // }
6901
+ * }
6902
+ *
6903
+ * main().catch(e => {
6904
+ * console.error(e);
6905
+ * throw e;
6906
+ * });
6907
+ *
6908
+ * ```
5972
6909
  *
5973
6910
  * @param params - Parameters for request
5974
6911
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5975
6912
  * @param callback - Optional callback that handles the response.
5976
6913
  * @returns A promise if used with async/await, or void if used with a callback.
5977
6914
  */
5978
- getIamPolicy(params: Params$Resource$Organizations$Sources$Getiampolicy, options: StreamMethodOptions): GaxiosPromise<Readable>;
5979
- getIamPolicy(params?: Params$Resource$Organizations$Sources$Getiampolicy, options?: MethodOptions): GaxiosPromise<Schema$Policy>;
6915
+ getIamPolicy(params: Params$Resource$Organizations$Sources$Getiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6916
+ getIamPolicy(params?: Params$Resource$Organizations$Sources$Getiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Policy>>;
5980
6917
  getIamPolicy(params: Params$Resource$Organizations$Sources$Getiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5981
6918
  getIamPolicy(params: Params$Resource$Organizations$Sources$Getiampolicy, options: MethodOptions | BodyResponseCallback<Schema$Policy>, callback: BodyResponseCallback<Schema$Policy>): void;
5982
6919
  getIamPolicy(params: Params$Resource$Organizations$Sources$Getiampolicy, callback: BodyResponseCallback<Schema$Policy>): void;
5983
6920
  getIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
5984
6921
  /**
5985
6922
  * Lists all sources belonging to an organization.
6923
+ * @example
6924
+ * ```js
6925
+ * // Before running the sample:
6926
+ * // - Enable the API at:
6927
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6928
+ * // - Login into gcloud by running:
6929
+ * // ```sh
6930
+ * // $ gcloud auth application-default login
6931
+ * // ```
6932
+ * // - Install the npm module by running:
6933
+ * // ```sh
6934
+ * // $ npm install googleapis
6935
+ * // ```
6936
+ *
6937
+ * const {google} = require('googleapis');
6938
+ * const securitycenter = google.securitycenter('v1beta1');
6939
+ *
6940
+ * async function main() {
6941
+ * const auth = new google.auth.GoogleAuth({
6942
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
6943
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
6944
+ * });
6945
+ *
6946
+ * // Acquire an auth client, and bind it to all future calls
6947
+ * const authClient = await auth.getClient();
6948
+ * google.options({auth: authClient});
6949
+ *
6950
+ * // Do the magic
6951
+ * const res = await securitycenter.organizations.sources.list({
6952
+ * // The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.
6953
+ * pageSize: 'placeholder-value',
6954
+ * // The value returned by the last `ListSourcesResponse`; indicates that this is a continuation of a prior `ListSources` call, and that the system should return the next page of data.
6955
+ * pageToken: 'placeholder-value',
6956
+ * // Required. Resource name of the parent of sources to list. Its format should be "organizations/[organization_id]".
6957
+ * parent: 'organizations/my-organization',
6958
+ * });
6959
+ * console.log(res.data);
6960
+ *
6961
+ * // Example response
6962
+ * // {
6963
+ * // "nextPageToken": "my_nextPageToken",
6964
+ * // "sources": []
6965
+ * // }
6966
+ * }
6967
+ *
6968
+ * main().catch(e => {
6969
+ * console.error(e);
6970
+ * throw e;
6971
+ * });
6972
+ *
6973
+ * ```
5986
6974
  *
5987
6975
  * @param params - Parameters for request
5988
6976
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
5989
6977
  * @param callback - Optional callback that handles the response.
5990
6978
  * @returns A promise if used with async/await, or void if used with a callback.
5991
6979
  */
5992
- list(params: Params$Resource$Organizations$Sources$List, options: StreamMethodOptions): GaxiosPromise<Readable>;
5993
- list(params?: Params$Resource$Organizations$Sources$List, options?: MethodOptions): GaxiosPromise<Schema$ListSourcesResponse>;
6980
+ list(params: Params$Resource$Organizations$Sources$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
6981
+ list(params?: Params$Resource$Organizations$Sources$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListSourcesResponse>>;
5994
6982
  list(params: Params$Resource$Organizations$Sources$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
5995
6983
  list(params: Params$Resource$Organizations$Sources$List, options: MethodOptions | BodyResponseCallback<Schema$ListSourcesResponse>, callback: BodyResponseCallback<Schema$ListSourcesResponse>): void;
5996
6984
  list(params: Params$Resource$Organizations$Sources$List, callback: BodyResponseCallback<Schema$ListSourcesResponse>): void;
5997
6985
  list(callback: BodyResponseCallback<Schema$ListSourcesResponse>): void;
5998
6986
  /**
5999
6987
  * Updates a source.
6988
+ * @example
6989
+ * ```js
6990
+ * // Before running the sample:
6991
+ * // - Enable the API at:
6992
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
6993
+ * // - Login into gcloud by running:
6994
+ * // ```sh
6995
+ * // $ gcloud auth application-default login
6996
+ * // ```
6997
+ * // - Install the npm module by running:
6998
+ * // ```sh
6999
+ * // $ npm install googleapis
7000
+ * // ```
7001
+ *
7002
+ * const {google} = require('googleapis');
7003
+ * const securitycenter = google.securitycenter('v1beta1');
7004
+ *
7005
+ * async function main() {
7006
+ * const auth = new google.auth.GoogleAuth({
7007
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7008
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7009
+ * });
7010
+ *
7011
+ * // Acquire an auth client, and bind it to all future calls
7012
+ * const authClient = await auth.getClient();
7013
+ * google.options({auth: authClient});
7014
+ *
7015
+ * // Do the magic
7016
+ * const res = await securitycenter.organizations.sources.patch({
7017
+ * // The relative resource name of this source. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id\}/sources/{source_id\}"
7018
+ * name: 'organizations/my-organization/sources/my-source',
7019
+ * // The FieldMask to use when updating the source resource.
7020
+ * updateMask: 'placeholder-value',
7021
+ *
7022
+ * // Request body metadata
7023
+ * requestBody: {
7024
+ * // request body parameters
7025
+ * // {
7026
+ * // "description": "my_description",
7027
+ * // "displayName": "my_displayName",
7028
+ * // "name": "my_name"
7029
+ * // }
7030
+ * },
7031
+ * });
7032
+ * console.log(res.data);
7033
+ *
7034
+ * // Example response
7035
+ * // {
7036
+ * // "description": "my_description",
7037
+ * // "displayName": "my_displayName",
7038
+ * // "name": "my_name"
7039
+ * // }
7040
+ * }
7041
+ *
7042
+ * main().catch(e => {
7043
+ * console.error(e);
7044
+ * throw e;
7045
+ * });
7046
+ *
7047
+ * ```
6000
7048
  *
6001
7049
  * @param params - Parameters for request
6002
7050
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
6003
7051
  * @param callback - Optional callback that handles the response.
6004
7052
  * @returns A promise if used with async/await, or void if used with a callback.
6005
7053
  */
6006
- patch(params: Params$Resource$Organizations$Sources$Patch, options: StreamMethodOptions): GaxiosPromise<Readable>;
6007
- patch(params?: Params$Resource$Organizations$Sources$Patch, options?: MethodOptions): GaxiosPromise<Schema$Source>;
7054
+ patch(params: Params$Resource$Organizations$Sources$Patch, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
7055
+ patch(params?: Params$Resource$Organizations$Sources$Patch, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Source>>;
6008
7056
  patch(params: Params$Resource$Organizations$Sources$Patch, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
6009
7057
  patch(params: Params$Resource$Organizations$Sources$Patch, options: MethodOptions | BodyResponseCallback<Schema$Source>, callback: BodyResponseCallback<Schema$Source>): void;
6010
7058
  patch(params: Params$Resource$Organizations$Sources$Patch, callback: BodyResponseCallback<Schema$Source>): void;
6011
7059
  patch(callback: BodyResponseCallback<Schema$Source>): void;
6012
7060
  /**
6013
7061
  * Sets the access control policy on the specified Source.
7062
+ * @example
7063
+ * ```js
7064
+ * // Before running the sample:
7065
+ * // - Enable the API at:
7066
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
7067
+ * // - Login into gcloud by running:
7068
+ * // ```sh
7069
+ * // $ gcloud auth application-default login
7070
+ * // ```
7071
+ * // - Install the npm module by running:
7072
+ * // ```sh
7073
+ * // $ npm install googleapis
7074
+ * // ```
7075
+ *
7076
+ * const {google} = require('googleapis');
7077
+ * const securitycenter = google.securitycenter('v1beta1');
7078
+ *
7079
+ * async function main() {
7080
+ * const auth = new google.auth.GoogleAuth({
7081
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7082
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7083
+ * });
7084
+ *
7085
+ * // Acquire an auth client, and bind it to all future calls
7086
+ * const authClient = await auth.getClient();
7087
+ * google.options({auth: authClient});
7088
+ *
7089
+ * // Do the magic
7090
+ * const res = await securitycenter.organizations.sources.setIamPolicy({
7091
+ * // REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
7092
+ * resource: 'organizations/my-organization/sources/my-source',
7093
+ *
7094
+ * // Request body metadata
7095
+ * requestBody: {
7096
+ * // request body parameters
7097
+ * // {
7098
+ * // "policy": {},
7099
+ * // "updateMask": "my_updateMask"
7100
+ * // }
7101
+ * },
7102
+ * });
7103
+ * console.log(res.data);
7104
+ *
7105
+ * // Example response
7106
+ * // {
7107
+ * // "auditConfigs": [],
7108
+ * // "bindings": [],
7109
+ * // "etag": "my_etag",
7110
+ * // "version": 0
7111
+ * // }
7112
+ * }
7113
+ *
7114
+ * main().catch(e => {
7115
+ * console.error(e);
7116
+ * throw e;
7117
+ * });
7118
+ *
7119
+ * ```
6014
7120
  *
6015
7121
  * @param params - Parameters for request
6016
7122
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
6017
7123
  * @param callback - Optional callback that handles the response.
6018
7124
  * @returns A promise if used with async/await, or void if used with a callback.
6019
7125
  */
6020
- setIamPolicy(params: Params$Resource$Organizations$Sources$Setiampolicy, options: StreamMethodOptions): GaxiosPromise<Readable>;
6021
- setIamPolicy(params?: Params$Resource$Organizations$Sources$Setiampolicy, options?: MethodOptions): GaxiosPromise<Schema$Policy>;
7126
+ setIamPolicy(params: Params$Resource$Organizations$Sources$Setiampolicy, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
7127
+ setIamPolicy(params?: Params$Resource$Organizations$Sources$Setiampolicy, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$Policy>>;
6022
7128
  setIamPolicy(params: Params$Resource$Organizations$Sources$Setiampolicy, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
6023
7129
  setIamPolicy(params: Params$Resource$Organizations$Sources$Setiampolicy, options: MethodOptions | BodyResponseCallback<Schema$Policy>, callback: BodyResponseCallback<Schema$Policy>): void;
6024
7130
  setIamPolicy(params: Params$Resource$Organizations$Sources$Setiampolicy, callback: BodyResponseCallback<Schema$Policy>): void;
6025
7131
  setIamPolicy(callback: BodyResponseCallback<Schema$Policy>): void;
6026
7132
  /**
6027
7133
  * Returns the permissions that a caller has on the specified source.
7134
+ * @example
7135
+ * ```js
7136
+ * // Before running the sample:
7137
+ * // - Enable the API at:
7138
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
7139
+ * // - Login into gcloud by running:
7140
+ * // ```sh
7141
+ * // $ gcloud auth application-default login
7142
+ * // ```
7143
+ * // - Install the npm module by running:
7144
+ * // ```sh
7145
+ * // $ npm install googleapis
7146
+ * // ```
7147
+ *
7148
+ * const {google} = require('googleapis');
7149
+ * const securitycenter = google.securitycenter('v1beta1');
7150
+ *
7151
+ * async function main() {
7152
+ * const auth = new google.auth.GoogleAuth({
7153
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7154
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7155
+ * });
7156
+ *
7157
+ * // Acquire an auth client, and bind it to all future calls
7158
+ * const authClient = await auth.getClient();
7159
+ * google.options({auth: authClient});
7160
+ *
7161
+ * // Do the magic
7162
+ * const res = await securitycenter.organizations.sources.testIamPermissions({
7163
+ * // REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
7164
+ * resource: 'organizations/my-organization/sources/my-source',
7165
+ *
7166
+ * // Request body metadata
7167
+ * requestBody: {
7168
+ * // request body parameters
7169
+ * // {
7170
+ * // "permissions": []
7171
+ * // }
7172
+ * },
7173
+ * });
7174
+ * console.log(res.data);
7175
+ *
7176
+ * // Example response
7177
+ * // {
7178
+ * // "permissions": []
7179
+ * // }
7180
+ * }
7181
+ *
7182
+ * main().catch(e => {
7183
+ * console.error(e);
7184
+ * throw e;
7185
+ * });
7186
+ *
7187
+ * ```
6028
7188
  *
6029
7189
  * @param params - Parameters for request
6030
7190
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
6031
7191
  * @param callback - Optional callback that handles the response.
6032
7192
  * @returns A promise if used with async/await, or void if used with a callback.
6033
7193
  */
6034
- testIamPermissions(params: Params$Resource$Organizations$Sources$Testiampermissions, options: StreamMethodOptions): GaxiosPromise<Readable>;
6035
- testIamPermissions(params?: Params$Resource$Organizations$Sources$Testiampermissions, options?: MethodOptions): GaxiosPromise<Schema$TestIamPermissionsResponse>;
7194
+ testIamPermissions(params: Params$Resource$Organizations$Sources$Testiampermissions, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
7195
+ testIamPermissions(params?: Params$Resource$Organizations$Sources$Testiampermissions, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$TestIamPermissionsResponse>>;
6036
7196
  testIamPermissions(params: Params$Resource$Organizations$Sources$Testiampermissions, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
6037
7197
  testIamPermissions(params: Params$Resource$Organizations$Sources$Testiampermissions, options: MethodOptions | BodyResponseCallback<Schema$TestIamPermissionsResponse>, callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
6038
7198
  testIamPermissions(params: Params$Resource$Organizations$Sources$Testiampermissions, callback: BodyResponseCallback<Schema$TestIamPermissionsResponse>): void;
@@ -6117,84 +7277,478 @@ export declare namespace securitycenter_v1beta1 {
6117
7277
  constructor(context: APIRequestContext);
6118
7278
  /**
6119
7279
  * Creates a finding. The corresponding source must exist for finding creation to succeed.
7280
+ * @example
7281
+ * ```js
7282
+ * // Before running the sample:
7283
+ * // - Enable the API at:
7284
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
7285
+ * // - Login into gcloud by running:
7286
+ * // ```sh
7287
+ * // $ gcloud auth application-default login
7288
+ * // ```
7289
+ * // - Install the npm module by running:
7290
+ * // ```sh
7291
+ * // $ npm install googleapis
7292
+ * // ```
7293
+ *
7294
+ * const {google} = require('googleapis');
7295
+ * const securitycenter = google.securitycenter('v1beta1');
7296
+ *
7297
+ * async function main() {
7298
+ * const auth = new google.auth.GoogleAuth({
7299
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7300
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7301
+ * });
7302
+ *
7303
+ * // Acquire an auth client, and bind it to all future calls
7304
+ * const authClient = await auth.getClient();
7305
+ * google.options({auth: authClient});
7306
+ *
7307
+ * // Do the magic
7308
+ * const res = await securitycenter.organizations.sources.findings.create({
7309
+ * // Required. Unique identifier provided by the client within the parent scope. It must be alphanumeric and less than or equal to 32 characters and greater than 0 characters in length.
7310
+ * findingId: 'placeholder-value',
7311
+ * // Required. Resource name of the new finding's parent. Its format should be "organizations/[organization_id]/sources/[source_id]".
7312
+ * parent: 'organizations/my-organization/sources/my-source',
7313
+ *
7314
+ * // Request body metadata
7315
+ * requestBody: {
7316
+ * // request body parameters
7317
+ * // {
7318
+ * // "category": "my_category",
7319
+ * // "createTime": "my_createTime",
7320
+ * // "eventTime": "my_eventTime",
7321
+ * // "externalUri": "my_externalUri",
7322
+ * // "name": "my_name",
7323
+ * // "parent": "my_parent",
7324
+ * // "resourceName": "my_resourceName",
7325
+ * // "securityMarks": {},
7326
+ * // "sourceProperties": {},
7327
+ * // "state": "my_state"
7328
+ * // }
7329
+ * },
7330
+ * });
7331
+ * console.log(res.data);
7332
+ *
7333
+ * // Example response
7334
+ * // {
7335
+ * // "category": "my_category",
7336
+ * // "createTime": "my_createTime",
7337
+ * // "eventTime": "my_eventTime",
7338
+ * // "externalUri": "my_externalUri",
7339
+ * // "name": "my_name",
7340
+ * // "parent": "my_parent",
7341
+ * // "resourceName": "my_resourceName",
7342
+ * // "securityMarks": {},
7343
+ * // "sourceProperties": {},
7344
+ * // "state": "my_state"
7345
+ * // }
7346
+ * }
7347
+ *
7348
+ * main().catch(e => {
7349
+ * console.error(e);
7350
+ * throw e;
7351
+ * });
7352
+ *
7353
+ * ```
6120
7354
  *
6121
7355
  * @param params - Parameters for request
6122
7356
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
6123
7357
  * @param callback - Optional callback that handles the response.
6124
7358
  * @returns A promise if used with async/await, or void if used with a callback.
6125
7359
  */
6126
- create(params: Params$Resource$Organizations$Sources$Findings$Create, options: StreamMethodOptions): GaxiosPromise<Readable>;
6127
- create(params?: Params$Resource$Organizations$Sources$Findings$Create, options?: MethodOptions): GaxiosPromise<Schema$GoogleCloudSecuritycenterV1beta1Finding>;
7360
+ create(params: Params$Resource$Organizations$Sources$Findings$Create, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
7361
+ create(params?: Params$Resource$Organizations$Sources$Findings$Create, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudSecuritycenterV1beta1Finding>>;
6128
7362
  create(params: Params$Resource$Organizations$Sources$Findings$Create, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
6129
7363
  create(params: Params$Resource$Organizations$Sources$Findings$Create, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>, callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>): void;
6130
7364
  create(params: Params$Resource$Organizations$Sources$Findings$Create, callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>): void;
6131
7365
  create(callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>): void;
6132
7366
  /**
6133
7367
  * Filters an organization or source's findings and groups them by their specified properties. To group across all sources provide a `-` as the source id. Example: /v1beta1/organizations/{organization_id\}/sources/-/findings
7368
+ * @example
7369
+ * ```js
7370
+ * // Before running the sample:
7371
+ * // - Enable the API at:
7372
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
7373
+ * // - Login into gcloud by running:
7374
+ * // ```sh
7375
+ * // $ gcloud auth application-default login
7376
+ * // ```
7377
+ * // - Install the npm module by running:
7378
+ * // ```sh
7379
+ * // $ npm install googleapis
7380
+ * // ```
7381
+ *
7382
+ * const {google} = require('googleapis');
7383
+ * const securitycenter = google.securitycenter('v1beta1');
7384
+ *
7385
+ * async function main() {
7386
+ * const auth = new google.auth.GoogleAuth({
7387
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7388
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7389
+ * });
7390
+ *
7391
+ * // Acquire an auth client, and bind it to all future calls
7392
+ * const authClient = await auth.getClient();
7393
+ * google.options({auth: authClient});
7394
+ *
7395
+ * // Do the magic
7396
+ * const res = await securitycenter.organizations.sources.findings.group({
7397
+ * // Required. Name of the source to groupBy. Its format is "organizations/[organization_id]/sources/[source_id]". To groupBy across all sources provide a source_id of `-`. For example: organizations/{organization_id\}/sources/-
7398
+ * parent: 'organizations/my-organization/sources/my-source',
7399
+ *
7400
+ * // Request body metadata
7401
+ * requestBody: {
7402
+ * // request body parameters
7403
+ * // {
7404
+ * // "filter": "my_filter",
7405
+ * // "groupBy": "my_groupBy",
7406
+ * // "pageSize": 0,
7407
+ * // "pageToken": "my_pageToken",
7408
+ * // "readTime": "my_readTime"
7409
+ * // }
7410
+ * },
7411
+ * });
7412
+ * console.log(res.data);
7413
+ *
7414
+ * // Example response
7415
+ * // {
7416
+ * // "groupByResults": [],
7417
+ * // "nextPageToken": "my_nextPageToken",
7418
+ * // "readTime": "my_readTime"
7419
+ * // }
7420
+ * }
7421
+ *
7422
+ * main().catch(e => {
7423
+ * console.error(e);
7424
+ * throw e;
7425
+ * });
7426
+ *
7427
+ * ```
6134
7428
  *
6135
7429
  * @param params - Parameters for request
6136
7430
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
6137
7431
  * @param callback - Optional callback that handles the response.
6138
7432
  * @returns A promise if used with async/await, or void if used with a callback.
6139
7433
  */
6140
- group(params: Params$Resource$Organizations$Sources$Findings$Group, options: StreamMethodOptions): GaxiosPromise<Readable>;
6141
- group(params?: Params$Resource$Organizations$Sources$Findings$Group, options?: MethodOptions): GaxiosPromise<Schema$GroupFindingsResponse>;
7434
+ group(params: Params$Resource$Organizations$Sources$Findings$Group, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
7435
+ group(params?: Params$Resource$Organizations$Sources$Findings$Group, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GroupFindingsResponse>>;
6142
7436
  group(params: Params$Resource$Organizations$Sources$Findings$Group, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
6143
7437
  group(params: Params$Resource$Organizations$Sources$Findings$Group, options: MethodOptions | BodyResponseCallback<Schema$GroupFindingsResponse>, callback: BodyResponseCallback<Schema$GroupFindingsResponse>): void;
6144
7438
  group(params: Params$Resource$Organizations$Sources$Findings$Group, callback: BodyResponseCallback<Schema$GroupFindingsResponse>): void;
6145
7439
  group(callback: BodyResponseCallback<Schema$GroupFindingsResponse>): void;
6146
7440
  /**
6147
7441
  * Lists an organization or source's findings. To list across all sources provide a `-` as the source id. Example: /v1beta1/organizations/{organization_id\}/sources/-/findings
7442
+ * @example
7443
+ * ```js
7444
+ * // Before running the sample:
7445
+ * // - Enable the API at:
7446
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
7447
+ * // - Login into gcloud by running:
7448
+ * // ```sh
7449
+ * // $ gcloud auth application-default login
7450
+ * // ```
7451
+ * // - Install the npm module by running:
7452
+ * // ```sh
7453
+ * // $ npm install googleapis
7454
+ * // ```
7455
+ *
7456
+ * const {google} = require('googleapis');
7457
+ * const securitycenter = google.securitycenter('v1beta1');
7458
+ *
7459
+ * async function main() {
7460
+ * const auth = new google.auth.GoogleAuth({
7461
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7462
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7463
+ * });
7464
+ *
7465
+ * // Acquire an auth client, and bind it to all future calls
7466
+ * const authClient = await auth.getClient();
7467
+ * google.options({auth: authClient});
7468
+ *
7469
+ * // Do the magic
7470
+ * const res = await securitycenter.organizations.sources.findings.list({
7471
+ * // Optional. A field mask to specify the Finding fields to be listed in the response. An empty field mask will list all fields.
7472
+ * fieldMask: 'placeholder-value',
7473
+ * // Expression that defines the filter to apply across findings. The expression is a list of one or more restrictions combined via logical operators `AND` and `OR`. Parentheses are not supported, and `OR` has higher precedence than `AND`. Restrictions have the form ` ` and may have a `-` character in front of them to indicate negation. Examples include: * name * source_properties.a_property * security_marks.marks.marka The supported operators are: * `=` for all value types. * `\>`, `<`, `\>=`, `<=` for integer values. * `:`, meaning substring matching, for strings. The supported value types are: * string literals in quotes. * integer literals without quotes. * boolean literals `true` and `false` without quotes. For example, `source_properties.size = 100` is a valid filter string.
7474
+ * filter: 'placeholder-value',
7475
+ * // Expression that defines what fields and order to use for sorting. The string value should follow SQL syntax: comma separated list of fields. For example: "name,resource_properties.a_property". The default sorting order is ascending. To specify descending order for a field, a suffix " desc" should be appended to the field name. For example: "name desc,source_properties.a_property". Redundant space characters in the syntax are insignificant. "name desc,source_properties.a_property" and " name desc , source_properties.a_property " are equivalent.
7476
+ * orderBy: 'placeholder-value',
7477
+ * // The maximum number of results to return in a single response. Default is 10, minimum is 1, maximum is 1000.
7478
+ * pageSize: 'placeholder-value',
7479
+ * // The value returned by the last `ListFindingsResponse`; indicates that this is a continuation of a prior `ListFindings` call, and that the system should return the next page of data.
7480
+ * pageToken: 'placeholder-value',
7481
+ * // Required. Name of the source the findings belong to. Its format is "organizations/[organization_id]/sources/[source_id]". To list across all sources provide a source_id of `-`. For example: organizations/{organization_id\}/sources/-
7482
+ * parent: 'organizations/my-organization/sources/my-source',
7483
+ * // Time used as a reference point when filtering findings. The filter is limited to findings existing at the supplied time and their values are those at that specific time. Absence of this field will default to the API's version of NOW.
7484
+ * readTime: 'placeholder-value',
7485
+ * });
7486
+ * console.log(res.data);
7487
+ *
7488
+ * // Example response
7489
+ * // {
7490
+ * // "findings": [],
7491
+ * // "nextPageToken": "my_nextPageToken",
7492
+ * // "readTime": "my_readTime",
7493
+ * // "totalSize": 0
7494
+ * // }
7495
+ * }
7496
+ *
7497
+ * main().catch(e => {
7498
+ * console.error(e);
7499
+ * throw e;
7500
+ * });
7501
+ *
7502
+ * ```
6148
7503
  *
6149
7504
  * @param params - Parameters for request
6150
7505
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
6151
7506
  * @param callback - Optional callback that handles the response.
6152
7507
  * @returns A promise if used with async/await, or void if used with a callback.
6153
7508
  */
6154
- list(params: Params$Resource$Organizations$Sources$Findings$List, options: StreamMethodOptions): GaxiosPromise<Readable>;
6155
- list(params?: Params$Resource$Organizations$Sources$Findings$List, options?: MethodOptions): GaxiosPromise<Schema$ListFindingsResponse>;
7509
+ list(params: Params$Resource$Organizations$Sources$Findings$List, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
7510
+ list(params?: Params$Resource$Organizations$Sources$Findings$List, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$ListFindingsResponse>>;
6156
7511
  list(params: Params$Resource$Organizations$Sources$Findings$List, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
6157
7512
  list(params: Params$Resource$Organizations$Sources$Findings$List, options: MethodOptions | BodyResponseCallback<Schema$ListFindingsResponse>, callback: BodyResponseCallback<Schema$ListFindingsResponse>): void;
6158
7513
  list(params: Params$Resource$Organizations$Sources$Findings$List, callback: BodyResponseCallback<Schema$ListFindingsResponse>): void;
6159
7514
  list(callback: BodyResponseCallback<Schema$ListFindingsResponse>): void;
6160
7515
  /**
6161
7516
  * Creates or updates a finding. The corresponding source must exist for a finding creation to succeed.
7517
+ * @example
7518
+ * ```js
7519
+ * // Before running the sample:
7520
+ * // - Enable the API at:
7521
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
7522
+ * // - Login into gcloud by running:
7523
+ * // ```sh
7524
+ * // $ gcloud auth application-default login
7525
+ * // ```
7526
+ * // - Install the npm module by running:
7527
+ * // ```sh
7528
+ * // $ npm install googleapis
7529
+ * // ```
7530
+ *
7531
+ * const {google} = require('googleapis');
7532
+ * const securitycenter = google.securitycenter('v1beta1');
7533
+ *
7534
+ * async function main() {
7535
+ * const auth = new google.auth.GoogleAuth({
7536
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7537
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7538
+ * });
7539
+ *
7540
+ * // Acquire an auth client, and bind it to all future calls
7541
+ * const authClient = await auth.getClient();
7542
+ * google.options({auth: authClient});
7543
+ *
7544
+ * // Do the magic
7545
+ * const res = await securitycenter.organizations.sources.findings.patch({
7546
+ * // The relative resource name of this finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id\}/sources/{source_id\}/findings/{finding_id\}"
7547
+ * name: 'organizations/my-organization/sources/my-source/findings/my-finding',
7548
+ * // The FieldMask to use when updating the finding resource. This field should not be specified when creating a finding.
7549
+ * updateMask: 'placeholder-value',
7550
+ *
7551
+ * // Request body metadata
7552
+ * requestBody: {
7553
+ * // request body parameters
7554
+ * // {
7555
+ * // "category": "my_category",
7556
+ * // "createTime": "my_createTime",
7557
+ * // "eventTime": "my_eventTime",
7558
+ * // "externalUri": "my_externalUri",
7559
+ * // "name": "my_name",
7560
+ * // "parent": "my_parent",
7561
+ * // "resourceName": "my_resourceName",
7562
+ * // "securityMarks": {},
7563
+ * // "sourceProperties": {},
7564
+ * // "state": "my_state"
7565
+ * // }
7566
+ * },
7567
+ * });
7568
+ * console.log(res.data);
7569
+ *
7570
+ * // Example response
7571
+ * // {
7572
+ * // "category": "my_category",
7573
+ * // "createTime": "my_createTime",
7574
+ * // "eventTime": "my_eventTime",
7575
+ * // "externalUri": "my_externalUri",
7576
+ * // "name": "my_name",
7577
+ * // "parent": "my_parent",
7578
+ * // "resourceName": "my_resourceName",
7579
+ * // "securityMarks": {},
7580
+ * // "sourceProperties": {},
7581
+ * // "state": "my_state"
7582
+ * // }
7583
+ * }
7584
+ *
7585
+ * main().catch(e => {
7586
+ * console.error(e);
7587
+ * throw e;
7588
+ * });
7589
+ *
7590
+ * ```
6162
7591
  *
6163
7592
  * @param params - Parameters for request
6164
7593
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
6165
7594
  * @param callback - Optional callback that handles the response.
6166
7595
  * @returns A promise if used with async/await, or void if used with a callback.
6167
7596
  */
6168
- patch(params: Params$Resource$Organizations$Sources$Findings$Patch, options: StreamMethodOptions): GaxiosPromise<Readable>;
6169
- patch(params?: Params$Resource$Organizations$Sources$Findings$Patch, options?: MethodOptions): GaxiosPromise<Schema$GoogleCloudSecuritycenterV1beta1Finding>;
7597
+ patch(params: Params$Resource$Organizations$Sources$Findings$Patch, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
7598
+ patch(params?: Params$Resource$Organizations$Sources$Findings$Patch, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudSecuritycenterV1beta1Finding>>;
6170
7599
  patch(params: Params$Resource$Organizations$Sources$Findings$Patch, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
6171
7600
  patch(params: Params$Resource$Organizations$Sources$Findings$Patch, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>, callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>): void;
6172
7601
  patch(params: Params$Resource$Organizations$Sources$Findings$Patch, callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>): void;
6173
7602
  patch(callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>): void;
6174
7603
  /**
6175
7604
  * Updates the state of a finding.
7605
+ * @example
7606
+ * ```js
7607
+ * // Before running the sample:
7608
+ * // - Enable the API at:
7609
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
7610
+ * // - Login into gcloud by running:
7611
+ * // ```sh
7612
+ * // $ gcloud auth application-default login
7613
+ * // ```
7614
+ * // - Install the npm module by running:
7615
+ * // ```sh
7616
+ * // $ npm install googleapis
7617
+ * // ```
7618
+ *
7619
+ * const {google} = require('googleapis');
7620
+ * const securitycenter = google.securitycenter('v1beta1');
7621
+ *
7622
+ * async function main() {
7623
+ * const auth = new google.auth.GoogleAuth({
7624
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7625
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7626
+ * });
7627
+ *
7628
+ * // Acquire an auth client, and bind it to all future calls
7629
+ * const authClient = await auth.getClient();
7630
+ * google.options({auth: authClient});
7631
+ *
7632
+ * // Do the magic
7633
+ * const res = await securitycenter.organizations.sources.findings.setState({
7634
+ * // Required. The relative resource name of the finding. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Example: "organizations/{organization_id\}/sources/{source_id\}/finding/{finding_id\}".
7635
+ * name: 'organizations/my-organization/sources/my-source/findings/my-finding',
7636
+ *
7637
+ * // Request body metadata
7638
+ * requestBody: {
7639
+ * // request body parameters
7640
+ * // {
7641
+ * // "startTime": "my_startTime",
7642
+ * // "state": "my_state"
7643
+ * // }
7644
+ * },
7645
+ * });
7646
+ * console.log(res.data);
7647
+ *
7648
+ * // Example response
7649
+ * // {
7650
+ * // "category": "my_category",
7651
+ * // "createTime": "my_createTime",
7652
+ * // "eventTime": "my_eventTime",
7653
+ * // "externalUri": "my_externalUri",
7654
+ * // "name": "my_name",
7655
+ * // "parent": "my_parent",
7656
+ * // "resourceName": "my_resourceName",
7657
+ * // "securityMarks": {},
7658
+ * // "sourceProperties": {},
7659
+ * // "state": "my_state"
7660
+ * // }
7661
+ * }
7662
+ *
7663
+ * main().catch(e => {
7664
+ * console.error(e);
7665
+ * throw e;
7666
+ * });
7667
+ *
7668
+ * ```
6176
7669
  *
6177
7670
  * @param params - Parameters for request
6178
7671
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
6179
7672
  * @param callback - Optional callback that handles the response.
6180
7673
  * @returns A promise if used with async/await, or void if used with a callback.
6181
7674
  */
6182
- setState(params: Params$Resource$Organizations$Sources$Findings$Setstate, options: StreamMethodOptions): GaxiosPromise<Readable>;
6183
- setState(params?: Params$Resource$Organizations$Sources$Findings$Setstate, options?: MethodOptions): GaxiosPromise<Schema$GoogleCloudSecuritycenterV1beta1Finding>;
7675
+ setState(params: Params$Resource$Organizations$Sources$Findings$Setstate, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
7676
+ setState(params?: Params$Resource$Organizations$Sources$Findings$Setstate, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudSecuritycenterV1beta1Finding>>;
6184
7677
  setState(params: Params$Resource$Organizations$Sources$Findings$Setstate, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
6185
7678
  setState(params: Params$Resource$Organizations$Sources$Findings$Setstate, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>, callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>): void;
6186
7679
  setState(params: Params$Resource$Organizations$Sources$Findings$Setstate, callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>): void;
6187
7680
  setState(callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1Finding>): void;
6188
7681
  /**
6189
7682
  * Updates security marks.
7683
+ * @example
7684
+ * ```js
7685
+ * // Before running the sample:
7686
+ * // - Enable the API at:
7687
+ * // https://console.developers.google.com/apis/api/securitycenter.googleapis.com
7688
+ * // - Login into gcloud by running:
7689
+ * // ```sh
7690
+ * // $ gcloud auth application-default login
7691
+ * // ```
7692
+ * // - Install the npm module by running:
7693
+ * // ```sh
7694
+ * // $ npm install googleapis
7695
+ * // ```
7696
+ *
7697
+ * const {google} = require('googleapis');
7698
+ * const securitycenter = google.securitycenter('v1beta1');
7699
+ *
7700
+ * async function main() {
7701
+ * const auth = new google.auth.GoogleAuth({
7702
+ * // Scopes can be specified either as an array or as a single, space-delimited string.
7703
+ * scopes: ['https://www.googleapis.com/auth/cloud-platform'],
7704
+ * });
7705
+ *
7706
+ * // Acquire an auth client, and bind it to all future calls
7707
+ * const authClient = await auth.getClient();
7708
+ * google.options({auth: authClient});
7709
+ *
7710
+ * // Do the magic
7711
+ * const res =
7712
+ * await securitycenter.organizations.sources.findings.updateSecurityMarks({
7713
+ * // The relative resource name of the SecurityMarks. See: https://cloud.google.com/apis/design/resource_names#relative_resource_name Examples: "organizations/{organization_id\}/assets/{asset_id\}/securityMarks" "organizations/{organization_id\}/sources/{source_id\}/findings/{finding_id\}/securityMarks".
7714
+ * name: 'organizations/my-organization/sources/my-source/findings/my-finding/securityMarks',
7715
+ * // The time at which the updated SecurityMarks take effect.
7716
+ * startTime: 'placeholder-value',
7717
+ * // The FieldMask to use when updating the security marks resource.
7718
+ * updateMask: 'placeholder-value',
7719
+ *
7720
+ * // Request body metadata
7721
+ * requestBody: {
7722
+ * // request body parameters
7723
+ * // {
7724
+ * // "marks": {},
7725
+ * // "name": "my_name"
7726
+ * // }
7727
+ * },
7728
+ * });
7729
+ * console.log(res.data);
7730
+ *
7731
+ * // Example response
7732
+ * // {
7733
+ * // "marks": {},
7734
+ * // "name": "my_name"
7735
+ * // }
7736
+ * }
7737
+ *
7738
+ * main().catch(e => {
7739
+ * console.error(e);
7740
+ * throw e;
7741
+ * });
7742
+ *
7743
+ * ```
6190
7744
  *
6191
7745
  * @param params - Parameters for request
6192
7746
  * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.
6193
7747
  * @param callback - Optional callback that handles the response.
6194
7748
  * @returns A promise if used with async/await, or void if used with a callback.
6195
7749
  */
6196
- updateSecurityMarks(params: Params$Resource$Organizations$Sources$Findings$Updatesecuritymarks, options: StreamMethodOptions): GaxiosPromise<Readable>;
6197
- updateSecurityMarks(params?: Params$Resource$Organizations$Sources$Findings$Updatesecuritymarks, options?: MethodOptions): GaxiosPromise<Schema$GoogleCloudSecuritycenterV1beta1SecurityMarks>;
7750
+ updateSecurityMarks(params: Params$Resource$Organizations$Sources$Findings$Updatesecuritymarks, options: StreamMethodOptions): Promise<GaxiosResponseWithHTTP2<Readable>>;
7751
+ updateSecurityMarks(params?: Params$Resource$Organizations$Sources$Findings$Updatesecuritymarks, options?: MethodOptions): Promise<GaxiosResponseWithHTTP2<Schema$GoogleCloudSecuritycenterV1beta1SecurityMarks>>;
6198
7752
  updateSecurityMarks(params: Params$Resource$Organizations$Sources$Findings$Updatesecuritymarks, options: StreamMethodOptions | BodyResponseCallback<Readable>, callback: BodyResponseCallback<Readable>): void;
6199
7753
  updateSecurityMarks(params: Params$Resource$Organizations$Sources$Findings$Updatesecuritymarks, options: MethodOptions | BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1SecurityMarks>, callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1SecurityMarks>): void;
6200
7754
  updateSecurityMarks(params: Params$Resource$Organizations$Sources$Findings$Updatesecuritymarks, callback: BodyResponseCallback<Schema$GoogleCloudSecuritycenterV1beta1SecurityMarks>): void;