@googleapis/dataform 16.0.0 → 17.0.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.
@@ -375,7 +375,7 @@ export declare namespace dataform_v1beta1 {
375
375
  */
376
376
  export interface Schema$CompilationError {
377
377
  /**
378
- * Output only. The identifier of the action where this error occurred, if available. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:CompilationError)
378
+ * Output only. The identifier of the action where this error occurred, if available.
379
379
  */
380
380
  actionTarget?: Schema$Target;
381
381
  /**
@@ -823,13 +823,17 @@ export declare namespace dataform_v1beta1 {
823
823
  */
824
824
  authenticationTokenSecretVersion?: string | null;
825
825
  /**
826
- * Optional. The Git remote's default branch name. If not set `main` will be used.
826
+ * Optional. The Git remote's default branch name. If not set, `main` will be used.
827
827
  */
828
828
  defaultBranch?: string | null;
829
829
  /**
830
830
  * Output only. The Git remote's effective default branch name. This is the default branch name of the Git remote if it is set, otherwise it is `main`.
831
831
  */
832
832
  effectiveDefaultBranch?: string | null;
833
+ /**
834
+ * Optional. Resource name for the `GitRepositoryLink` used for machine credentials. Must be in the format `projects/x/locations/x/connections/x/gitRepositoryLinks/x`
835
+ */
836
+ gitRepositoryLink?: string | null;
833
837
  /**
834
838
  * Optional. Authentication fields for remote uris using SSH protocol.
835
839
  */
@@ -963,7 +967,7 @@ export declare namespace dataform_v1beta1 {
963
967
  */
964
968
  nextPageToken?: string | null;
965
969
  /**
966
- * Locations which could not be reached. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:ListCompilationResultsResponse)
970
+ * Locations which could not be reached.
967
971
  */
968
972
  unreachable?: string[] | null;
969
973
  }
@@ -1010,7 +1014,7 @@ export declare namespace dataform_v1beta1 {
1010
1014
  */
1011
1015
  releaseConfigs?: Schema$ReleaseConfig[];
1012
1016
  /**
1013
- * Locations which could not be reached. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:ListReleaseConfigsResponse)
1017
+ * Locations which could not be reached.
1014
1018
  */
1015
1019
  unreachable?: string[] | null;
1016
1020
  }
@@ -1641,7 +1645,7 @@ export declare namespace dataform_v1beta1 {
1641
1645
  */
1642
1646
  gitCommitish?: string | null;
1643
1647
  /**
1644
- * Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:ReleaseConfig)
1648
+ * Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string.
1645
1649
  */
1646
1650
  internalMetadata?: string | null;
1647
1651
  /**
@@ -1919,6 +1923,19 @@ export declare namespace dataform_v1beta1 {
1919
1923
  */
1920
1924
  message?: string | null;
1921
1925
  }
1926
+ /**
1927
+ * Represents a table update trigger configuration.
1928
+ */
1929
+ export interface Schema$TableUpdateTrigger {
1930
+ /**
1931
+ * The target table to trigger the workflow.
1932
+ */
1933
+ table?: Schema$Target;
1934
+ /**
1935
+ * Output only. The modification time of this table that resulted in an invocation of the workflow. This would be updated by the triggering service after a successful workflow invocation.
1936
+ */
1937
+ triggerUpdateTime?: string | null;
1938
+ }
1922
1939
  /**
1923
1940
  * Represents an action identifier. If the action writes output, the output will be written to the referenced database object.
1924
1941
  */
@@ -2005,6 +2022,19 @@ export declare namespace dataform_v1beta1 {
2005
2022
  */
2006
2023
  permissions?: string[] | null;
2007
2024
  }
2025
+ /**
2026
+ * A record of an attempt to evaluate trigger conditions.
2027
+ */
2028
+ export interface Schema$TriggerEvaluationRecord {
2029
+ /**
2030
+ * Output only. The timestamp of this trigger evaluation attempt.
2031
+ */
2032
+ evaluationTime?: string | null;
2033
+ /**
2034
+ * Output only. The status of the trigger evaluation. Success is indicated by a code of 0 (OK). Message will only be present if the status code is non-zero.
2035
+ */
2036
+ status?: Schema$Status;
2037
+ }
2008
2038
  /**
2009
2039
  * Represents the Git state of a file with uncommitted changes.
2010
2040
  */
@@ -2062,6 +2092,10 @@ export declare namespace dataform_v1beta1 {
2062
2092
  * Output only. The timestamp of when the WorkflowConfig was last updated.
2063
2093
  */
2064
2094
  updateTime?: string | null;
2095
+ /**
2096
+ * Optional. Optional trigger configuration for this workflow. If present, the workflow will be triggered based on the specified triggers.
2097
+ */
2098
+ workflowTriggerConfig?: Schema$WorkflowTriggerConfig;
2065
2099
  }
2066
2100
  /**
2067
2101
  * Represents a single invocation of a compilation result.
@@ -2149,6 +2183,44 @@ export declare namespace dataform_v1beta1 {
2149
2183
  */
2150
2184
  target?: Schema$Target;
2151
2185
  }
2186
+ /**
2187
+ * The trigger definition to invoke a workflow.
2188
+ */
2189
+ export interface Schema$WorkflowTrigger {
2190
+ /**
2191
+ * The table update trigger configuration.
2192
+ */
2193
+ tableUpdateTrigger?: Schema$TableUpdateTrigger;
2194
+ }
2195
+ /**
2196
+ * Represents a trigger configuration for a workflow.
2197
+ */
2198
+ export interface Schema$WorkflowTriggerConfig {
2199
+ /**
2200
+ * Optional. The condition to use when triggering the workflow.
2201
+ */
2202
+ condition?: string | null;
2203
+ /**
2204
+ * Output only. The timestamp of the last successful trigger evaluation.
2205
+ */
2206
+ lastSuccessfulEvaluationTime?: string | null;
2207
+ /**
2208
+ * Optional. The effective maximum wait time duration for the trigger condition to be met. If not specified, the workflow won't be triggered until conditions are met.
2209
+ */
2210
+ maxWaitDuration?: string | null;
2211
+ /**
2212
+ * Optional. Minimum duration between two consecutive executions. If not specified, the workflow will be executed every time trigger conditions are met and no ongoing workflow execution.
2213
+ */
2214
+ minExecutionDuration?: string | null;
2215
+ /**
2216
+ * Output only. Records of the 10 most recent trigger evaluations, ordered in descending order of `evaluation_time`. Updated whenever the service evaluates the trigger conditions (via polling or upon receiving a push event).
2217
+ */
2218
+ recentTriggerEvaluationRecords?: Schema$TriggerEvaluationRecord[];
2219
+ /**
2220
+ * Required. The trigger definitions to invoke a workflow.
2221
+ */
2222
+ workflowTriggers?: Schema$WorkflowTrigger[];
2223
+ }
2152
2224
  /**
2153
2225
  * Represents a Dataform Git workspace.
2154
2226
  */
@@ -4136,7 +4208,7 @@ export declare namespace dataform_v1beta1 {
4136
4208
  delete(params: Params$Resource$Projects$Locations$Repositories$Delete, callback: BodyResponseCallback<Schema$Empty>): void;
4137
4209
  delete(callback: BodyResponseCallback<Schema$Empty>): void;
4138
4210
  /**
4139
- * Deletes a single Repository asynchronously.
4211
+ * Deletes a single repository asynchronously.
4140
4212
  * @example
4141
4213
  * ```js
4142
4214
  * // Before running the sample:
@@ -5343,7 +5415,7 @@ export declare namespace dataform_v1beta1 {
5343
5415
  * // Do the magic
5344
5416
  * const res =
5345
5417
  * await dataform.projects.locations.repositories.compilationResults.get({
5346
- * // Required. The compilation result's name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:GetCompilationResultRequest)
5418
+ * // Required. The compilation result's name.
5347
5419
  * name: 'projects/my-project/locations/my-location/repositories/my-repositorie/compilationResults/my-compilationResult',
5348
5420
  * });
5349
5421
  * console.log(res.data);
@@ -5418,7 +5490,7 @@ export declare namespace dataform_v1beta1 {
5418
5490
  * // Do the magic
5419
5491
  * const res =
5420
5492
  * await dataform.projects.locations.repositories.compilationResults.list({
5421
- * // Optional. Filter for the returned list. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:ListCompilationResultsRequest)
5493
+ * // Optional. Filter for the returned list.
5422
5494
  * filter: 'placeholder-value',
5423
5495
  * // Optional. This field only supports ordering by `name` and `create_time`. If unspecified, the server will choose the ordering. If specified, the default order is ascending for the `name` field.
5424
5496
  * orderBy: 'placeholder-value',
@@ -5542,13 +5614,13 @@ export declare namespace dataform_v1beta1 {
5542
5614
  }
5543
5615
  export interface Params$Resource$Projects$Locations$Repositories$Compilationresults$Get extends StandardParameters {
5544
5616
  /**
5545
- * Required. The compilation result's name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:GetCompilationResultRequest)
5617
+ * Required. The compilation result's name.
5546
5618
  */
5547
5619
  name?: string;
5548
5620
  }
5549
5621
  export interface Params$Resource$Projects$Locations$Repositories$Compilationresults$List extends StandardParameters {
5550
5622
  /**
5551
- * Optional. Filter for the returned list. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:ListCompilationResultsRequest)
5623
+ * Optional. Filter for the returned list.
5552
5624
  */
5553
5625
  filter?: string;
5554
5626
  /**
@@ -5627,7 +5699,7 @@ export declare namespace dataform_v1beta1 {
5627
5699
  * // Required. The repository in which to create the release config. Must be in the format `projects/x/locations/x/repositories/x`.
5628
5700
  * parent:
5629
5701
  * 'projects/my-project/locations/my-location/repositories/my-repositorie',
5630
- * // Required. The ID to use for the release config, which will become the final component of the release config's resource name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:CreateReleaseConfigRequest)
5702
+ * // Required. The ID to use for the release config, which will become the final component of the release config's resource name.
5631
5703
  * releaseConfigId: 'placeholder-value',
5632
5704
  *
5633
5705
  * // Request body metadata
@@ -5715,7 +5787,7 @@ export declare namespace dataform_v1beta1 {
5715
5787
  * // Do the magic
5716
5788
  * const res =
5717
5789
  * await dataform.projects.locations.repositories.releaseConfigs.delete({
5718
- * // Required. The release config's name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:DeleteReleaseConfigRequest)
5790
+ * // Required. The release config's name.
5719
5791
  * name: 'projects/my-project/locations/my-location/repositories/my-repositorie/releaseConfigs/my-releaseConfig',
5720
5792
  * });
5721
5793
  * console.log(res.data);
@@ -5777,7 +5849,7 @@ export declare namespace dataform_v1beta1 {
5777
5849
  * // Do the magic
5778
5850
  * const res = await dataform.projects.locations.repositories.releaseConfigs.get(
5779
5851
  * {
5780
- * // Required. The release config's name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:GetReleaseConfigRequest)
5852
+ * // Required. The release config's name.
5781
5853
  * name: 'projects/my-project/locations/my-location/repositories/my-repositorie/releaseConfigs/my-releaseConfig',
5782
5854
  * },
5783
5855
  * );
@@ -5852,7 +5924,7 @@ export declare namespace dataform_v1beta1 {
5852
5924
  * await dataform.projects.locations.repositories.releaseConfigs.list({
5853
5925
  * // Optional. Maximum number of release configs to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.
5854
5926
  * pageSize: 'placeholder-value',
5855
- * // Optional. Page token received from a previous `ListReleaseConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReleaseConfigs`, with the exception of `page_size`, must match the call that provided the page token. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:ListReleaseConfigsRequest)
5927
+ * // Optional. Page token received from a previous `ListReleaseConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReleaseConfigs`, with the exception of `page_size`, must match the call that provided the page token.
5856
5928
  * pageToken: 'placeholder-value',
5857
5929
  * // Required. The repository in which to list release configs. Must be in the format `projects/x/locations/x/repositories/x`.
5858
5930
  * parent:
@@ -5983,7 +6055,7 @@ export declare namespace dataform_v1beta1 {
5983
6055
  */
5984
6056
  parent?: string;
5985
6057
  /**
5986
- * Required. The ID to use for the release config, which will become the final component of the release config's resource name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:CreateReleaseConfigRequest)
6058
+ * Required. The ID to use for the release config, which will become the final component of the release config's resource name.
5987
6059
  */
5988
6060
  releaseConfigId?: string;
5989
6061
  /**
@@ -5993,13 +6065,13 @@ export declare namespace dataform_v1beta1 {
5993
6065
  }
5994
6066
  export interface Params$Resource$Projects$Locations$Repositories$Releaseconfigs$Delete extends StandardParameters {
5995
6067
  /**
5996
- * Required. The release config's name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:DeleteReleaseConfigRequest)
6068
+ * Required. The release config's name.
5997
6069
  */
5998
6070
  name?: string;
5999
6071
  }
6000
6072
  export interface Params$Resource$Projects$Locations$Repositories$Releaseconfigs$Get extends StandardParameters {
6001
6073
  /**
6002
- * Required. The release config's name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:GetReleaseConfigRequest)
6074
+ * Required. The release config's name.
6003
6075
  */
6004
6076
  name?: string;
6005
6077
  }
@@ -6009,7 +6081,7 @@ export declare namespace dataform_v1beta1 {
6009
6081
  */
6010
6082
  pageSize?: number;
6011
6083
  /**
6012
- * Optional. Page token received from a previous `ListReleaseConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReleaseConfigs`, with the exception of `page_size`, must match the call that provided the page token. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:ListReleaseConfigsRequest)
6084
+ * Optional. Page token received from a previous `ListReleaseConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListReleaseConfigs`, with the exception of `page_size`, must match the call that provided the page token.
6013
6085
  */
6014
6086
  pageToken?: string;
6015
6087
  /**
@@ -6088,7 +6160,8 @@ export declare namespace dataform_v1beta1 {
6088
6160
  * // "recentScheduledExecutionRecords": [],
6089
6161
  * // "releaseConfig": "my_releaseConfig",
6090
6162
  * // "timeZone": "my_timeZone",
6091
- * // "updateTime": "my_updateTime"
6163
+ * // "updateTime": "my_updateTime",
6164
+ * // "workflowTriggerConfig": {}
6092
6165
  * // }
6093
6166
  * },
6094
6167
  * });
@@ -6105,7 +6178,8 @@ export declare namespace dataform_v1beta1 {
6105
6178
  * // "recentScheduledExecutionRecords": [],
6106
6179
  * // "releaseConfig": "my_releaseConfig",
6107
6180
  * // "timeZone": "my_timeZone",
6108
- * // "updateTime": "my_updateTime"
6181
+ * // "updateTime": "my_updateTime",
6182
+ * // "workflowTriggerConfig": {}
6109
6183
  * // }
6110
6184
  * }
6111
6185
  *
@@ -6240,7 +6314,8 @@ export declare namespace dataform_v1beta1 {
6240
6314
  * // "recentScheduledExecutionRecords": [],
6241
6315
  * // "releaseConfig": "my_releaseConfig",
6242
6316
  * // "timeZone": "my_timeZone",
6243
- * // "updateTime": "my_updateTime"
6317
+ * // "updateTime": "my_updateTime",
6318
+ * // "workflowTriggerConfig": {}
6244
6319
  * // }
6245
6320
  * }
6246
6321
  *
@@ -6386,7 +6461,8 @@ export declare namespace dataform_v1beta1 {
6386
6461
  * // "recentScheduledExecutionRecords": [],
6387
6462
  * // "releaseConfig": "my_releaseConfig",
6388
6463
  * // "timeZone": "my_timeZone",
6389
- * // "updateTime": "my_updateTime"
6464
+ * // "updateTime": "my_updateTime",
6465
+ * // "workflowTriggerConfig": {}
6390
6466
  * // }
6391
6467
  * },
6392
6468
  * });
@@ -6403,7 +6479,8 @@ export declare namespace dataform_v1beta1 {
6403
6479
  * // "recentScheduledExecutionRecords": [],
6404
6480
  * // "releaseConfig": "my_releaseConfig",
6405
6481
  * // "timeZone": "my_timeZone",
6406
- * // "updateTime": "my_updateTime"
6482
+ * // "updateTime": "my_updateTime",
6483
+ * // "workflowTriggerConfig": {}
6407
6484
  * // }
6408
6485
  * }
6409
6486
  *
@@ -9521,7 +9598,7 @@ export declare namespace dataform_v1beta1 {
9521
9598
  * location: 'projects/my-project/locations/my-location',
9522
9599
  * // Optional. Field to additionally sort results by. Supported keywords: `display_name` (default), `create_time`, `last_modified_time`. Examples: * `orderBy="display_name"` * `orderBy="display_name desc"`
9523
9600
  * orderBy: 'placeholder-value',
9524
- * // Optional. Maximum number of TeamFolders to return. The server may return fewer items than requested. If unspecified, the server will pick a default of page_size = 50.
9601
+ * // Optional. Maximum number of `TeamFolders` to return. The server may return fewer items than requested. If unspecified, the server will pick a default of `page_size` = 50.
9525
9602
  * pageSize: 'placeholder-value',
9526
9603
  * // Optional. Page token received from a previous `SearchTeamFolders` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `SearchTeamFolders`, with the exception of `page_size`, must match the call that provided the page token.
9527
9604
  * pageToken: 'placeholder-value',
@@ -9796,7 +9873,7 @@ export declare namespace dataform_v1beta1 {
9796
9873
  */
9797
9874
  orderBy?: string;
9798
9875
  /**
9799
- * Optional. Maximum number of TeamFolders to return. The server may return fewer items than requested. If unspecified, the server will pick a default of page_size = 50.
9876
+ * Optional. Maximum number of `TeamFolders` to return. The server may return fewer items than requested. If unspecified, the server will pick a default of `page_size` = 50.
9800
9877
  */
9801
9878
  pageSize?: number;
9802
9879
  /**