diff --git a/docs/dyn/dataform_v1beta1.projects.locations.repositories.html b/docs/dyn/dataform_v1beta1.projects.locations.repositories.html index 3c07a5ddf3b..865591673f1 100644 --- a/docs/dyn/dataform_v1beta1.projects.locations.repositories.html +++ b/docs/dyn/dataform_v1beta1.projects.locations.repositories.html @@ -102,6 +102,9 @@
Close httplib2 connections.
+
+ commit(name, body=None, x__xgafv=None)
Applies a Git commit to a Repository. The Repository must not have a value for `git_remote_settings.url`.
computeAccessTokenStatus(name, x__xgafv=None)
Computes a Repository's Git access token status.
@@ -111,6 +114,12 @@
delete(name, force=None, x__xgafv=None)
Deletes a single Repository.
+
+ fetchHistory(name, pageSize=None, pageToken=None, x__xgafv=None)
Fetches a Repository's history of commits. The Repository must not have a value for `git_remote_settings.url`.
+ +Retrieves the next page of results.
fetchRemoteBranches(name, x__xgafv=None)
Fetches a Repository's remote branches.
@@ -129,6 +138,15 @@
patch(name, body=None, updateMask=None, x__xgafv=None)
Updates a single Repository.
+ +Returns the contents of a given Repository directory. The Repository must not have a value for `git_remote_settings.url`.
+
+ queryDirectoryContents_next()
Retrieves the next page of results.
+
+ readFile(name, commitSha=None, path=None, x__xgafv=None)
Returns the contents of a file (inside a Repository). The Repository must not have a value for `git_remote_settings.url`.
setIamPolicy(resource, body=None, x__xgafv=None)
Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
@@ -141,6 +159,47 @@Close httplib2 connections.+
commit(name, body=None, x__xgafv=None)
+ Applies a Git commit to a Repository. The Repository must not have a value for `git_remote_settings.url`. + +Args: + name: string, Required. The repository's name. (required) + body: object, The request body. + The object takes the form of: + +{ # `CommitRepositoryChanges` request message. + "commitMetadata": { # Represents a Dataform Git commit. # Required. The changes to commit to the repository. + "author": { # Represents the author of a Git commit. # Required. The commit's author. + "emailAddress": "A String", # Required. The commit author's email address. + "name": "A String", # Required. The commit author's name. + }, + "commitMessage": "A String", # Optional. The commit's message. + }, + "fileOperations": { # A map to the path of the file to the operation. The path is the ull file path including filename, from repository root. + "a_key": { # Represents a single file operation to the repository. + "deleteFile": { # Represents the delete file operation. # Represents the delete operation. + }, + "writeFile": { # Represents the write file operation (for files added or modified). # Represents the write operation. + "contents": "A String", # The file's contents. + }, + }, + }, + "requiredHeadCommitSha": "A String", # Optional. The commit SHA which must be the repository's current HEAD before applying this commit; otherwise this request will fail. If unset, no validation on the current HEAD commit SHA is performed. +} + + x__xgafv: string, V1 error format. + Allowed values + 1 - v1 error format + 2 - v2 error format + +Returns: + An object of the form: + + { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } +}+
computeAccessTokenStatus(name, x__xgafv=None)
Computes a Repository's Git access token status. @@ -170,15 +229,20 @@Method Details
The object takes the form of: { # Represents a Dataform Git repository. + "displayName": "A String", # Optional. The repository's user-friendly name. "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. - "authenticationTokenSecretVersion": "A String", # Required. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. + "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Required. The Git remote's default branch name. "tokenStatus": "A String", # Output only. Deprecated: The field does not contain any token status information. Instead use https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories/computeAccessTokenStatus "url": "A String", # Required. The Git remote's URL. }, + "labels": { # Optional. Repository user labels. + "a_key": "A String", + }, "name": "A String", # Output only. The repository's name. "npmrcEnvironmentVariablesSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to be used to interpolate variables into the .npmrc file for package installation operations. Must be in the format `projects/*/secrets/*/versions/*`. The file itself must be in a JSON format. "serviceAccount": "A String", # Optional. The service account to run workflow invocations under. + "setAuthenticatedUserAdmin": True or False, # Optional. Input only. If set to true, the authenticated user will be granted the roles/dataform.admin role on the created repository. To modify access to the created repository later apply setIamPolicy from https://cloud.google.com/dataform/reference/rest#rest-resource:-v1beta1.projects.locations.repositories "workspaceCompilationOverrides": { # Configures workspace compilation overrides for a repository. Primarily used by the UI (`console.cloud.google.com`). `schema_suffix` and `table_prefix` can have a special expression - `${workspaceName}`, which refers to the workspace name from which the compilation results will be created. API callers are expected to resolve the expression in these overrides and provide them explicitly in `code_compilation_config` (https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories.compilationResults#codecompilationconfig) when creating workspace-scoped compilation results. # Optional. If set, fields of `workspace_compilation_overrides` override the default compilation settings that are specified in dataform.json when creating workspace-scoped compilation results. See documentation for `WorkspaceCompilationOverrides` for more information. "defaultDatabase": "A String", # Optional. The default database (Google Cloud project ID). "schemaSuffix": "A String", # Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names. @@ -196,15 +260,20 @@Method Details
An object of the form: { # Represents a Dataform Git repository. + "displayName": "A String", # Optional. The repository's user-friendly name. "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. - "authenticationTokenSecretVersion": "A String", # Required. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. + "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Required. The Git remote's default branch name. "tokenStatus": "A String", # Output only. Deprecated: The field does not contain any token status information. Instead use https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories/computeAccessTokenStatus "url": "A String", # Required. The Git remote's URL. }, + "labels": { # Optional. Repository user labels. + "a_key": "A String", + }, "name": "A String", # Output only. The repository's name. "npmrcEnvironmentVariablesSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to be used to interpolate variables into the .npmrc file for package installation operations. Must be in the format `projects/*/secrets/*/versions/*`. The file itself must be in a JSON format. "serviceAccount": "A String", # Optional. The service account to run workflow invocations under. + "setAuthenticatedUserAdmin": True or False, # Optional. Input only. If set to true, the authenticated user will be granted the roles/dataform.admin role on the created repository. To modify access to the created repository later apply setIamPolicy from https://cloud.google.com/dataform/reference/rest#rest-resource:-v1beta1.projects.locations.repositories "workspaceCompilationOverrides": { # Configures workspace compilation overrides for a repository. Primarily used by the UI (`console.cloud.google.com`). `schema_suffix` and `table_prefix` can have a special expression - `${workspaceName}`, which refers to the workspace name from which the compilation results will be created. API callers are expected to resolve the expression in these overrides and provide them explicitly in `code_compilation_config` (https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories.compilationResults#codecompilationconfig) when creating workspace-scoped compilation results. # Optional. If set, fields of `workspace_compilation_overrides` override the default compilation settings that are specified in dataform.json when creating workspace-scoped compilation results. See documentation for `WorkspaceCompilationOverrides` for more information. "defaultDatabase": "A String", # Optional. The default database (Google Cloud project ID). "schemaSuffix": "A String", # Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names. @@ -232,6 +301,52 @@Method Details
}
fetchHistory(name, pageSize=None, pageToken=None, x__xgafv=None)
+ Fetches a Repository's history of commits. The Repository must not have a value for `git_remote_settings.url`. + +Args: + name: string, Required. The repository's name. (required) + pageSize: integer, Optional. Maximum number of commits to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default. + pageToken: string, Optional. Page token received from a previous `FetchRepositoryHistory` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `FetchRepositoryHistory` must match the call that provided the page token. + x__xgafv: string, V1 error format. + Allowed values + 1 - v1 error format + 2 - v2 error format + +Returns: + An object of the form: + + { # `FetchRepositoryHistory` response message. + "commits": [ # A list of commit logs, ordered by 'git log' default order. + { # Represents a single commit log. + "author": { # Represents the author of a Git commit. # The commit author for this commit log entry. + "emailAddress": "A String", # Required. The commit author's email address. + "name": "A String", # Required. The commit author's name. + }, + "commitMessage": "A String", # The commit message for this commit log entry. + "commitSha": "A String", # The commit SHA for this commit log entry. + "commitTime": "A String", # Commit timestamp. + }, + ], + "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. +}+
fetchHistory_next()
+ Retrieves the next page of results. + + Args: + previous_request: The request for the previous page. (required) + previous_response: The response from the request for the previous page. (required) + + Returns: + A request object that you can call 'execute()' on to request the next + page. Returns None if there are no more items in the collection. ++
fetchRemoteBranches(name, x__xgafv=None)
Fetches a Repository's remote branches. @@ -268,15 +383,20 @@Method Details
An object of the form: { # Represents a Dataform Git repository. + "displayName": "A String", # Optional. The repository's user-friendly name. "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. - "authenticationTokenSecretVersion": "A String", # Required. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. + "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Required. The Git remote's default branch name. "tokenStatus": "A String", # Output only. Deprecated: The field does not contain any token status information. Instead use https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories/computeAccessTokenStatus "url": "A String", # Required. The Git remote's URL. }, + "labels": { # Optional. Repository user labels. + "a_key": "A String", + }, "name": "A String", # Output only. The repository's name. "npmrcEnvironmentVariablesSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to be used to interpolate variables into the .npmrc file for package installation operations. Must be in the format `projects/*/secrets/*/versions/*`. The file itself must be in a JSON format. "serviceAccount": "A String", # Optional. The service account to run workflow invocations under. + "setAuthenticatedUserAdmin": True or False, # Optional. Input only. If set to true, the authenticated user will be granted the roles/dataform.admin role on the created repository. To modify access to the created repository later apply setIamPolicy from https://cloud.google.com/dataform/reference/rest#rest-resource:-v1beta1.projects.locations.repositories "workspaceCompilationOverrides": { # Configures workspace compilation overrides for a repository. Primarily used by the UI (`console.cloud.google.com`). `schema_suffix` and `table_prefix` can have a special expression - `${workspaceName}`, which refers to the workspace name from which the compilation results will be created. API callers are expected to resolve the expression in these overrides and provide them explicitly in `code_compilation_config` (https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories.compilationResults#codecompilationconfig) when creating workspace-scoped compilation results. # Optional. If set, fields of `workspace_compilation_overrides` override the default compilation settings that are specified in dataform.json when creating workspace-scoped compilation results. See documentation for `WorkspaceCompilationOverrides` for more information. "defaultDatabase": "A String", # Optional. The default database (Google Cloud project ID). "schemaSuffix": "A String", # Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names. @@ -342,15 +462,20 @@Method Details
"nextPageToken": "A String", # A token which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. "repositories": [ # List of repositories. { # Represents a Dataform Git repository. + "displayName": "A String", # Optional. The repository's user-friendly name. "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. - "authenticationTokenSecretVersion": "A String", # Required. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. + "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Required. The Git remote's default branch name. "tokenStatus": "A String", # Output only. Deprecated: The field does not contain any token status information. Instead use https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories/computeAccessTokenStatus "url": "A String", # Required. The Git remote's URL. }, + "labels": { # Optional. Repository user labels. + "a_key": "A String", + }, "name": "A String", # Output only. The repository's name. "npmrcEnvironmentVariablesSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to be used to interpolate variables into the .npmrc file for package installation operations. Must be in the format `projects/*/secrets/*/versions/*`. The file itself must be in a JSON format. "serviceAccount": "A String", # Optional. The service account to run workflow invocations under. + "setAuthenticatedUserAdmin": True or False, # Optional. Input only. If set to true, the authenticated user will be granted the roles/dataform.admin role on the created repository. To modify access to the created repository later apply setIamPolicy from https://cloud.google.com/dataform/reference/rest#rest-resource:-v1beta1.projects.locations.repositories "workspaceCompilationOverrides": { # Configures workspace compilation overrides for a repository. Primarily used by the UI (`console.cloud.google.com`). `schema_suffix` and `table_prefix` can have a special expression - `${workspaceName}`, which refers to the workspace name from which the compilation results will be created. API callers are expected to resolve the expression in these overrides and provide them explicitly in `code_compilation_config` (https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories.compilationResults#codecompilationconfig) when creating workspace-scoped compilation results. # Optional. If set, fields of `workspace_compilation_overrides` override the default compilation settings that are specified in dataform.json when creating workspace-scoped compilation results. See documentation for `WorkspaceCompilationOverrides` for more information. "defaultDatabase": "A String", # Optional. The default database (Google Cloud project ID). "schemaSuffix": "A String", # Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names. @@ -388,15 +513,20 @@Method Details
The object takes the form of: { # Represents a Dataform Git repository. + "displayName": "A String", # Optional. The repository's user-friendly name. "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. - "authenticationTokenSecretVersion": "A String", # Required. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. + "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Required. The Git remote's default branch name. "tokenStatus": "A String", # Output only. Deprecated: The field does not contain any token status information. Instead use https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories/computeAccessTokenStatus "url": "A String", # Required. The Git remote's URL. }, + "labels": { # Optional. Repository user labels. + "a_key": "A String", + }, "name": "A String", # Output only. The repository's name. "npmrcEnvironmentVariablesSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to be used to interpolate variables into the .npmrc file for package installation operations. Must be in the format `projects/*/secrets/*/versions/*`. The file itself must be in a JSON format. "serviceAccount": "A String", # Optional. The service account to run workflow invocations under. + "setAuthenticatedUserAdmin": True or False, # Optional. Input only. If set to true, the authenticated user will be granted the roles/dataform.admin role on the created repository. To modify access to the created repository later apply setIamPolicy from https://cloud.google.com/dataform/reference/rest#rest-resource:-v1beta1.projects.locations.repositories "workspaceCompilationOverrides": { # Configures workspace compilation overrides for a repository. Primarily used by the UI (`console.cloud.google.com`). `schema_suffix` and `table_prefix` can have a special expression - `${workspaceName}`, which refers to the workspace name from which the compilation results will be created. API callers are expected to resolve the expression in these overrides and provide them explicitly in `code_compilation_config` (https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories.compilationResults#codecompilationconfig) when creating workspace-scoped compilation results. # Optional. If set, fields of `workspace_compilation_overrides` override the default compilation settings that are specified in dataform.json when creating workspace-scoped compilation results. See documentation for `WorkspaceCompilationOverrides` for more information. "defaultDatabase": "A String", # Optional. The default database (Google Cloud project ID). "schemaSuffix": "A String", # Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names. @@ -414,15 +544,20 @@Method Details
An object of the form: { # Represents a Dataform Git repository. + "displayName": "A String", # Optional. The repository's user-friendly name. "gitRemoteSettings": { # Controls Git remote configuration for a repository. # Optional. If set, configures this repository to be linked to a Git remote. - "authenticationTokenSecretVersion": "A String", # Required. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. + "authenticationTokenSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`. "defaultBranch": "A String", # Required. The Git remote's default branch name. "tokenStatus": "A String", # Output only. Deprecated: The field does not contain any token status information. Instead use https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories/computeAccessTokenStatus "url": "A String", # Required. The Git remote's URL. }, + "labels": { # Optional. Repository user labels. + "a_key": "A String", + }, "name": "A String", # Output only. The repository's name. "npmrcEnvironmentVariablesSecretVersion": "A String", # Optional. The name of the Secret Manager secret version to be used to interpolate variables into the .npmrc file for package installation operations. Must be in the format `projects/*/secrets/*/versions/*`. The file itself must be in a JSON format. "serviceAccount": "A String", # Optional. The service account to run workflow invocations under. + "setAuthenticatedUserAdmin": True or False, # Optional. Input only. If set to true, the authenticated user will be granted the roles/dataform.admin role on the created repository. To modify access to the created repository later apply setIamPolicy from https://cloud.google.com/dataform/reference/rest#rest-resource:-v1beta1.projects.locations.repositories "workspaceCompilationOverrides": { # Configures workspace compilation overrides for a repository. Primarily used by the UI (`console.cloud.google.com`). `schema_suffix` and `table_prefix` can have a special expression - `${workspaceName}`, which refers to the workspace name from which the compilation results will be created. API callers are expected to resolve the expression in these overrides and provide them explicitly in `code_compilation_config` (https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories.compilationResults#codecompilationconfig) when creating workspace-scoped compilation results. # Optional. If set, fields of `workspace_compilation_overrides` override the default compilation settings that are specified in dataform.json when creating workspace-scoped compilation results. See documentation for `WorkspaceCompilationOverrides` for more information. "defaultDatabase": "A String", # Optional. The default database (Google Cloud project ID). "schemaSuffix": "A String", # Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names. @@ -431,6 +566,70 @@Method Details
}
queryDirectoryContents(name, commitSha=None, pageSize=None, pageToken=None, path=None, x__xgafv=None)
+ Returns the contents of a given Repository directory. The Repository must not have a value for `git_remote_settings.url`. + +Args: + name: string, Required. The repository's name. (required) + commitSha: string, Optional. The Commit SHA for the commit to query from. If unset, the directory will be queried from HEAD. + pageSize: integer, Optional. Maximum number of paths to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default. + pageToken: string, Optional. Page token received from a previous `QueryRepositoryDirectoryContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryRepositoryDirectoryContents` must match the call that provided the page token. + path: string, Optional. The directory's full path including directory name, relative to root. If left unset, the root is used. + x__xgafv: string, V1 error format. + Allowed values + 1 - v1 error format + 2 - v2 error format + +Returns: + An object of the form: + + { # `QueryRepositoryDirectoryContents` response message. + "directoryEntries": [ # List of entries in the directory. + { # Represents a single entry in a directory. + "directory": "A String", # A child directory in the directory. + "file": "A String", # A file in the directory. + }, + ], + "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages. +}+
queryDirectoryContents_next()
+ Retrieves the next page of results. + + Args: + previous_request: The request for the previous page. (required) + previous_response: The response from the request for the previous page. (required) + + Returns: + A request object that you can call 'execute()' on to request the next + page. Returns None if there are no more items in the collection. ++
readFile(name, commitSha=None, path=None, x__xgafv=None)
+ Returns the contents of a file (inside a Repository). The Repository must not have a value for `git_remote_settings.url`. + +Args: + name: string, Required. The repository's name. (required) + commitSha: string, Optional. The commit SHA for the commit to read from. If unset, the file will be read from HEAD. + path: string, Required. Full file path to read including filename, from repository root. + x__xgafv: string, V1 error format. + Allowed values + 1 - v1 error format + 2 - v2 error format + +Returns: + An object of the form: + + { # `ReadRepositoryFile` response message. + "contents": "A String", # The file's contents. +}+
setIamPolicy(resource, body=None, x__xgafv=None)
Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. diff --git a/googleapiclient/discovery_cache/documents/dataform.v1beta1.json b/googleapiclient/discovery_cache/documents/dataform.v1beta1.json index 9b768f84a15..2b3f8c2833f 100644 --- a/googleapiclient/discovery_cache/documents/dataform.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/dataform.v1beta1.json @@ -178,6 +178,34 @@ "resources": { "repositories": { "methods": { + "commit": { + "description": "Applies a Git commit to a Repository. The Repository must not have a value for `git_remote_settings.url`.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:commit", + "httpMethod": "POST", + "id": "dataform.projects.locations.repositories.commit", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The repository's name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1beta1/{+name}:commit", + "request": { + "$ref": "CommitRepositoryChangesRequest" + }, + "response": { + "$ref": "Empty" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "computeAccessTokenStatus": { "description": "Computes a Repository's Git access token status.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:computeAccessTokenStatus", @@ -266,6 +294,42 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "fetchHistory": { + "description": "Fetches a Repository's history of commits. The Repository must not have a value for `git_remote_settings.url`.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:fetchHistory", + "httpMethod": "GET", + "id": "dataform.projects.locations.repositories.fetchHistory", + "parameterOrder": [ + "name" + ], + "parameters": { + "name": { + "description": "Required. The repository's name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "Optional. Maximum number of commits to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Page token received from a previous `FetchRepositoryHistory` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `FetchRepositoryHistory` must match the call that provided the page token.", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+name}:fetchHistory", + "response": { + "$ref": "FetchRepositoryHistoryResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "fetchRemoteBranches": { "description": "Fetches a Repository's remote branches.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:fetchRemoteBranches", @@ -427,6 +491,87 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "queryDirectoryContents": { + "description": "Returns the contents of a given Repository directory. The Repository must not have a value for `git_remote_settings.url`.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:queryDirectoryContents", + "httpMethod": "GET", + "id": "dataform.projects.locations.repositories.queryDirectoryContents", + "parameterOrder": [ + "name" + ], + "parameters": { + "commitSha": { + "description": "Optional. The Commit SHA for the commit to query from. If unset, the directory will be queried from HEAD.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The repository's name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", + "required": true, + "type": "string" + }, + "pageSize": { + "description": "Optional. Maximum number of paths to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", + "format": "int32", + "location": "query", + "type": "integer" + }, + "pageToken": { + "description": "Optional. Page token received from a previous `QueryRepositoryDirectoryContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryRepositoryDirectoryContents` must match the call that provided the page token.", + "location": "query", + "type": "string" + }, + "path": { + "description": "Optional. The directory's full path including directory name, relative to root. If left unset, the root is used.", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+name}:queryDirectoryContents", + "response": { + "$ref": "QueryRepositoryDirectoryContentsResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, + "readFile": { + "description": "Returns the contents of a file (inside a Repository). The Repository must not have a value for `git_remote_settings.url`.", + "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:readFile", + "httpMethod": "GET", + "id": "dataform.projects.locations.repositories.readFile", + "parameterOrder": [ + "name" + ], + "parameters": { + "commitSha": { + "description": "Optional. The commit SHA for the commit to read from. If unset, the file will be read from HEAD.", + "location": "query", + "type": "string" + }, + "name": { + "description": "Required. The repository's name.", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", + "required": true, + "type": "string" + }, + "path": { + "description": "Required. Full file path to read including filename, from repository root.", + "location": "query", + "type": "string" + } + }, + "path": "v1beta1/{+name}:readFile", + "response": { + "$ref": "ReadRepositoryFileResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "setIamPolicy": { "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:setIamPolicy", @@ -1816,7 +1961,7 @@ } } }, - "revision": "20230707", + "revision": "20230728", "rootUrl": "https://dataform.googleapis.com/", "schemas": { "Assertion": { @@ -1978,6 +2123,67 @@ }, "type": "object" }, + "CommitLogEntry": { + "description": "Represents a single commit log.", + "id": "CommitLogEntry", + "properties": { + "author": { + "$ref": "CommitAuthor", + "description": "The commit author for this commit log entry." + }, + "commitMessage": { + "description": "The commit message for this commit log entry.", + "type": "string" + }, + "commitSha": { + "description": "The commit SHA for this commit log entry.", + "type": "string" + }, + "commitTime": { + "description": "Commit timestamp.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, + "CommitMetadata": { + "description": "Represents a Dataform Git commit.", + "id": "CommitMetadata", + "properties": { + "author": { + "$ref": "CommitAuthor", + "description": "Required. The commit's author." + }, + "commitMessage": { + "description": "Optional. The commit's message.", + "type": "string" + } + }, + "type": "object" + }, + "CommitRepositoryChangesRequest": { + "description": "`CommitRepositoryChanges` request message.", + "id": "CommitRepositoryChangesRequest", + "properties": { + "commitMetadata": { + "$ref": "CommitMetadata", + "description": "Required. The changes to commit to the repository." + }, + "fileOperations": { + "additionalProperties": { + "$ref": "FileOperation" + }, + "description": "A map to the path of the file to the operation. The path is the ull file path including filename, from repository root.", + "type": "object" + }, + "requiredHeadCommitSha": { + "description": "Optional. The commit SHA which must be the repository's current HEAD before applying this commit; otherwise this request will fail. If unset, no validation on the current HEAD commit SHA is performed.", + "type": "string" + } + }, + "type": "object" + }, "CommitWorkspaceChangesRequest": { "description": "`CommitWorkspaceChanges` request message.", "id": "CommitWorkspaceChangesRequest", @@ -2142,6 +2348,12 @@ }, "type": "object" }, + "DeleteFile": { + "description": "Represents the delete file operation.", + "id": "DeleteFile", + "properties": {}, + "type": "object" + }, "DirectoryEntry": { "description": "Represents a single entry in a directory.", "id": "DirectoryEntry", @@ -2242,12 +2454,45 @@ }, "type": "object" }, + "FetchRepositoryHistoryResponse": { + "description": "`FetchRepositoryHistory` response message.", + "id": "FetchRepositoryHistoryResponse", + "properties": { + "commits": { + "description": "A list of commit logs, ordered by 'git log' default order.", + "items": { + "$ref": "CommitLogEntry" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + } + }, + "type": "object" + }, + "FileOperation": { + "description": "Represents a single file operation to the repository.", + "id": "FileOperation", + "properties": { + "deleteFile": { + "$ref": "DeleteFile", + "description": "Represents the delete operation." + }, + "writeFile": { + "$ref": "WriteFile", + "description": "Represents the write operation." + } + }, + "type": "object" + }, "GitRemoteSettings": { "description": "Controls Git remote configuration for a repository.", "id": "GitRemoteSettings", "properties": { "authenticationTokenSecretVersion": { - "description": "Required. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`.", + "description": "Optional. The name of the Secret Manager secret version to use as an authentication token for Git operations. Must be in the format `projects/*/secrets/*/versions/*`.", "type": "string" }, "defaultBranch": { @@ -2816,6 +3061,24 @@ }, "type": "object" }, + "QueryRepositoryDirectoryContentsResponse": { + "description": "`QueryRepositoryDirectoryContents` response message.", + "id": "QueryRepositoryDirectoryContentsResponse", + "properties": { + "directoryEntries": { + "description": "List of entries in the directory.", + "items": { + "$ref": "DirectoryEntry" + }, + "type": "array" + }, + "nextPageToken": { + "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", + "type": "string" + } + }, + "type": "object" + }, "QueryWorkflowInvocationActionsResponse": { "description": "`QueryWorkflowInvocationActions` response message.", "id": "QueryWorkflowInvocationActionsResponse", @@ -2846,6 +3109,18 @@ }, "type": "object" }, + "ReadRepositoryFileResponse": { + "description": "`ReadRepositoryFile` response message.", + "id": "ReadRepositoryFileResponse", + "properties": { + "contents": { + "description": "The file's contents.", + "format": "byte", + "type": "string" + } + }, + "type": "object" + }, "Relation": { "description": "Represents a database relation.", "id": "Relation", @@ -3033,10 +3308,21 @@ "description": "Represents a Dataform Git repository.", "id": "Repository", "properties": { + "displayName": { + "description": "Optional. The repository's user-friendly name.", + "type": "string" + }, "gitRemoteSettings": { "$ref": "GitRemoteSettings", "description": "Optional. If set, configures this repository to be linked to a Git remote." }, + "labels": { + "additionalProperties": { + "type": "string" + }, + "description": "Optional. Repository user labels.", + "type": "object" + }, "name": { "description": "Output only. The repository's name.", "readOnly": true, @@ -3050,6 +3336,10 @@ "description": "Optional. The service account to run workflow invocations under.", "type": "string" }, + "setAuthenticatedUserAdmin": { + "description": "Optional. Input only. If set to true, the authenticated user will be granted the roles/dataform.admin role on the created repository. To modify access to the created repository later apply setIamPolicy from https://cloud.google.com/dataform/reference/rest#rest-resource:-v1beta1.projects.locations.repositories", + "type": "boolean" + }, "workspaceCompilationOverrides": { "$ref": "WorkspaceCompilationOverrides", "description": "Optional. If set, fields of `workspace_compilation_overrides` override the default compilation settings that are specified in dataform.json when creating workspace-scoped compilation results. See documentation for `WorkspaceCompilationOverrides` for more information." @@ -3401,6 +3691,18 @@ }, "type": "object" }, + "WriteFile": { + "description": "Represents the write file operation (for files added or modified).", + "id": "WriteFile", + "properties": { + "contents": { + "description": "The file's contents.", + "format": "byte", + "type": "string" + } + }, + "type": "object" + }, "WriteFileRequest": { "description": "`WriteFile` request message.", "id": "WriteFileRequest",