{ "version_module": true, "resources": { "projects": { "resources": { "locations": { "methods": { "updateConfig": { "response": { "$ref": "Config" }, "description": "Update default config for a given project and location. **Note:** *This method does not fully implement [AIP/134](https://google.aip.dev/134). The wildcard entry (\\*) is treated as a bad request, and when the `field_mask` is omitted, the request is treated as a full update on all modifiable fields.*", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/config", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/config$", "required": true, "description": "Identifier. The config name." }, "updateMask": { "type": "string", "location": "query", "format": "google-fieldmask", "description": "Optional. Specifies the fields to be updated in the config." } }, "id": "dataform.projects.locations.updateConfig", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "Config" } }, "queryUserRootContents": { "response": { "$ref": "QueryUserRootContentsResponse" }, "description": "Returns the contents of a caller's root folder in a given location. The root folder contains all resources that are created by the user and not contained in any other folder.", "path": "v1/{+location}:queryUserRootContents", "httpMethod": "GET", "parameters": { "pageSize": { "type": "integer", "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.", "location": "query", "format": "int32" }, "filter": { "type": "string", "location": "query", "description": "Optional. Optional filtering for the returned list. Filtering is currently only supported on the `display_name` field. Example: * `filter=\"display_name=\"MyFolder\"\"`" }, "pageToken": { "type": "string", "description": "Optional. Page token received from a previous `QueryUserRootContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryUserRootFolderContents`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query" }, "location": { "location": "path", "type": "string", "description": "Required. Location of the user root folder to list contents for. Format: projects/*/locations/*", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true }, "orderBy": { "description": "Optional. Field to additionally sort results by. Will order Folders before Repositories, and then by `order_by` in ascending order. Supported keywords: display_name (default), created_at, last_modified_at. Examples: * `orderBy=\"display_name\"` * `orderBy=\"display_name desc\"`", "location": "query", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:queryUserRootContents", "parameterOrder": [ "location" ], "id": "dataform.projects.locations.queryUserRootContents", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "get": { "id": "dataform.projects.locations.get", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Location" }, "description": "Gets information about a location.", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "description": "Resource name for the location." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", "parameterOrder": [ "name" ] }, "getConfig": { "response": { "$ref": "Config" }, "description": "Get default config for a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/config", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The config name.", "pattern": "^projects/[^/]+/locations/[^/]+/config$", "required": true, "location": "path", "type": "string" } }, "id": "dataform.projects.locations.getConfig", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "response": { "$ref": "ListLocationsResponse" }, "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version.", "path": "v1/{+name}/locations", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "description": "The resource that owns the locations collection, if applicable.", "pattern": "^projects/[^/]+$", "required": true }, "extraLocationTypes": { "description": "Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.", "repeated": true, "location": "query", "type": "string" }, "pageToken": { "type": "string", "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", "location": "query" }, "filter": { "location": "query", "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "type": "string" }, "pageSize": { "type": "integer", "description": "The maximum number of results to return. If not set, the service selects a default.", "location": "query", "format": "int32" } }, "flatPath": "v1/projects/{projectsId}/locations", "parameterOrder": [ "name" ], "id": "dataform.projects.locations.list", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] } }, "resources": { "folders": { "methods": { "patch": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "Folder" }, "id": "dataform.projects.locations.folders.patch", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "description": "Identifier. The Folder's name.", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true, "location": "path", "type": "string" }, "updateMask": { "description": "Optional. Specifies the fields to be updated in the Folder. If left unset, all fields that can be updated, will be updated. A few fields cannot be updated and will be ignored if specified in the update_mask (e.g. parent_name, team_folder_name).", "location": "query", "format": "google-fieldmask", "type": "string" } }, "response": { "$ref": "Folder" }, "description": "Updates a single Folder." }, "getIamPolicy": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.folders.getIamPolicy", "path": "v1/{+resource}:getIamPolicy", "httpMethod": "GET", "parameters": { "resource": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true, "description": "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." }, "options.requestedPolicyVersion": { "type": "integer", "location": "query", "format": "int32", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:getIamPolicy", "parameterOrder": [ "resource" ], "response": { "$ref": "Policy" }, "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set." }, "setIamPolicy": { "request": { "$ref": "SetIamPolicyRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.folders.setIamPolicy", "path": "v1/{+resource}:setIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true, "description": "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.", "type": "string", "location": "path" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:setIamPolicy", "parameterOrder": [ "resource" ], "response": { "$ref": "Policy" }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors." }, "deleteTree": { "response": { "$ref": "Operation" }, "description": "Deletes a Folder with its contents (Folders, Repositories, Workspaces, ReleaseConfigs, and WorkflowConfigs).", "path": "v1/{+name}:deleteTree", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true, "description": "Required. The Folder's name. Format: projects/{project}/locations/{location}/folders/{folder}" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:deleteTree", "parameterOrder": [ "name" ], "id": "dataform.projects.locations.folders.deleteTree", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "DeleteFolderTreeRequest" } }, "queryFolderContents": { "path": "v1/{+folder}:queryFolderContents", "httpMethod": "GET", "parameters": { "folder": { "description": "Required. Resource name of the Folder to list contents for. Format: projects/*/locations/*/folders/*", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true, "location": "path", "type": "string" }, "orderBy": { "type": "string", "location": "query", "description": "Optional. Field to additionally sort results by. Will order Folders before Repositories, and then by `order_by` in ascending order. Supported keywords: display_name (default), create_time, last_modified_time. Examples: * `orderBy=\"display_name\"` * `orderBy=\"display_name desc\"`" }, "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.", "location": "query", "format": "int32", "type": "integer" }, "filter": { "type": "string", "location": "query", "description": "Optional. Optional filtering for the returned list. Filtering is currently only supported on the `display_name` field. Example: * `filter=\"display_name=\"MyFolder\"\"`" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. Page token received from a previous `QueryFolderContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryFolderContents`, with the exception of `page_size`, must match the call that provided the page token." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:queryFolderContents", "parameterOrder": [ "folder" ], "response": { "$ref": "QueryFolderContentsResponse" }, "description": "Returns the contents of a given Folder.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.folders.queryFolderContents" }, "testIamPermissions": { "id": "dataform.projects.locations.folders.testIamPermissions", "request": { "$ref": "TestIamPermissionsRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "TestIamPermissionsResponse" }, "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "path": "v1/{+resource}:testIamPermissions", "httpMethod": "POST", "parameters": { "resource": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true, "description": "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." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:testIamPermissions", "parameterOrder": [ "resource" ] }, "create": { "response": { "$ref": "Folder" }, "description": "Creates a new Folder in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/folders", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/folders", "httpMethod": "POST", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. The location in which to create the Folder. Must be in the format `projects/*/locations/*`.", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true } }, "id": "dataform.projects.locations.folders.create", "request": { "$ref": "Folder" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "move": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "MoveFolderRequest" }, "id": "dataform.projects.locations.folders.move", "path": "v1/{+name}:move", "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true, "description": "Required. The full resource name of the Folder to move.", "type": "string", "location": "path" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:move", "parameterOrder": [ "name" ], "response": { "$ref": "Operation" }, "description": "Moves a Folder to a new Folder, TeamFolder, or the root location." }, "get": { "id": "dataform.projects.locations.folders.get", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Folder" }, "description": "Fetches a single Folder.", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The Folder's name.", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}", "parameterOrder": [ "name" ] }, "delete": { "response": { "$ref": "Empty" }, "description": "Deletes a single Folder.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true, "description": "Required. The Folder's name.", "type": "string", "location": "path" } }, "id": "dataform.projects.locations.folders.delete", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] } } }, "repositories": { "methods": { "fetchHistory": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:fetchHistory", "parameterOrder": [ "name" ], "path": "v1/{+name}:fetchHistory", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The repository's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "location": "path", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "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.", "type": "integer" }, "pageToken": { "type": "string", "location": "query", "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`, with the exception of `page_size`, must match the call that provided the page token." } }, "response": { "$ref": "FetchRepositoryHistoryResponse" }, "description": "Fetches a Repository's history of commits. The Repository must not have a value for `git_remote_settings.url`.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.fetchHistory" }, "get": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The repository's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "location": "path", "type": "string" } }, "response": { "$ref": "Repository" }, "description": "Fetches a single Repository.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.get" }, "delete": { "response": { "$ref": "Empty" }, "description": "Deletes a single Repository.", "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The repository's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true }, "force": { "type": "boolean", "description": "Optional. If set to true, child resources of this repository (compilation results and workflow invocations) will also be deleted. Otherwise, the request will only succeed if the repository has no child resources. **Note:** *This flag doesn't support deletion of workspaces, release configs or workflow configs. If any of such resources exists in the repository, the request will fail.*.", "location": "query" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}", "parameterOrder": [ "name" ], "id": "dataform.projects.locations.repositories.delete", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "id": "dataform.projects.locations.repositories.patch", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "Repository" }, "response": { "$ref": "Repository" }, "description": "Updates a single Repository. **Note:** *This method does not fully implement [AIP/134](https://google.aip.dev/134). The wildcard entry (\\*) is treated as a bad request, and when the `field_mask` is omitted, the request is treated as a full update on all modifiable fields.*", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "description": "Identifier. The repository's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "location": "path", "type": "string" }, "updateMask": { "location": "query", "format": "google-fieldmask", "description": "Optional. Specifies the fields to be updated in the repository. If left unset, all fields will be updated.", "type": "string" } } }, "list": { "response": { "$ref": "ListRepositoriesResponse" }, "description": "Lists Repositories in a given project and location. **Note:** *This method can return repositories not shown in the [Dataform UI](https://console.cloud.google.com/bigquery/dataform)*.", "path": "v1/{+parent}/repositories", "httpMethod": "GET", "parameters": { "orderBy": { "type": "string", "description": "Optional. This field only supports ordering by `name`. If unspecified, the server will choose the ordering. If specified, the default order is ascending for the `name` field.", "location": "query" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "description": "Required. The location in which to list repositories. Must be in the format `projects/*/locations/*`.", "type": "string", "location": "path" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. Page token received from a previous `ListRepositories` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListRepositories`, with the exception of `page_size`, must match the call that provided the page token." }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "Optional. Maximum number of repositories to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default." }, "filter": { "description": "Optional. Filter for the returned list.", "location": "query", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories", "parameterOrder": [ "parent" ], "id": "dataform.projects.locations.repositories.list", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "getIamPolicy": { "response": { "$ref": "Policy" }, "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "path": "v1/{+resource}:getIamPolicy", "httpMethod": "GET", "parameters": { "resource": { "location": "path", "type": "string", "description": "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.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true }, "options.requestedPolicyVersion": { "type": "integer", "location": "query", "format": "int32", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies)." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:getIamPolicy", "parameterOrder": [ "resource" ], "id": "dataform.projects.locations.repositories.getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "readFile": { "id": "dataform.projects.locations.repositories.readFile", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ReadRepositoryFileResponse" }, "description": "Returns the contents of a file (inside a Repository). The Repository must not have a value for `git_remote_settings.url`.", "path": "v1/{+name}:readFile", "httpMethod": "GET", "parameters": { "path": { "type": "string", "location": "query", "description": "Required. Full file path to read including filename, from repository root." }, "commitSha": { "location": "query", "description": "Optional. The commit SHA for the commit to read from. If unset, the file will be read from HEAD.", "type": "string" }, "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The repository's name." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:readFile", "parameterOrder": [ "name" ] }, "create": { "id": "dataform.projects.locations.repositories.create", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "Repository" }, "response": { "$ref": "Repository" }, "description": "Creates a new Repository in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/repositories", "httpMethod": "POST", "parameters": { "repositoryId": { "location": "query", "description": "Required. The ID to use for the repository, which will become the final component of the repository's resource name.", "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "description": "Required. The location in which to create the repository. Must be in the format `projects/*/locations/*`.", "type": "string", "location": "path" } } }, "queryDirectoryContents": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:queryDirectoryContents", "parameterOrder": [ "name" ], "path": "v1/{+name}:queryDirectoryContents", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The repository's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "location": "path", "type": "string" }, "path": { "type": "string", "location": "query", "description": "Optional. The directory's full path including directory name, relative to root. If left unset, the root is used." }, "commitSha": { "location": "query", "description": "Optional. The Commit SHA for the commit to query from. If unset, the directory will be queried from HEAD.", "type": "string" }, "pageToken": { "type": "string", "location": "query", "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`, with the exception of `page_size`, must match the call that provided the page token." }, "pageSize": { "type": "integer", "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.", "location": "query", "format": "int32" } }, "response": { "$ref": "QueryRepositoryDirectoryContentsResponse" }, "description": "Returns the contents of a given Repository directory. The Repository must not have a value for `git_remote_settings.url`.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.queryDirectoryContents" }, "fetchRemoteBranches": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.fetchRemoteBranches", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:fetchRemoteBranches", "parameterOrder": [ "name" ], "path": "v1/{+name}:fetchRemoteBranches", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The repository's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "location": "path", "type": "string" } }, "response": { "$ref": "FetchRemoteBranchesResponse" }, "description": "Fetches a Repository's remote branches." }, "computeAccessTokenStatus": { "path": "v1/{+name}:computeAccessTokenStatus", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The repository's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "location": "path", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:computeAccessTokenStatus", "parameterOrder": [ "name" ], "response": { "$ref": "ComputeRepositoryAccessTokenStatusResponse" }, "description": "Computes a Repository's Git access token status.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.computeAccessTokenStatus" }, "setIamPolicy": { "request": { "$ref": "SetIamPolicyRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.setIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:setIamPolicy", "parameterOrder": [ "resource" ], "path": "v1/{+resource}:setIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "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.", "type": "string", "location": "path" } }, "response": { "$ref": "Policy" }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors." }, "commit": { "response": { "$ref": "CommitRepositoryChangesResponse" }, "description": "Applies a Git commit to a Repository. The Repository must not have a value for `git_remote_settings.url`.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:commit", "parameterOrder": [ "name" ], "path": "v1/{+name}:commit", "httpMethod": "POST", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The repository's name.", "type": "string", "location": "path" } }, "id": "dataform.projects.locations.repositories.commit", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "CommitRepositoryChangesRequest" } }, "testIamPermissions": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "TestIamPermissionsRequest" }, "id": "dataform.projects.locations.repositories.testIamPermissions", "path": "v1/{+resource}:testIamPermissions", "httpMethod": "POST", "parameters": { "resource": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "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." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:testIamPermissions", "parameterOrder": [ "resource" ], "response": { "$ref": "TestIamPermissionsResponse" }, "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning." }, "move": { "id": "dataform.projects.locations.repositories.move", "request": { "$ref": "MoveRepositoryRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Operation" }, "description": "Moves a Repository to a new location.", "path": "v1/{+name}:move", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The full resource name of the repository to move." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:move", "parameterOrder": [ "name" ] } }, "resources": { "releaseConfigs": { "methods": { "patch": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "ReleaseConfig" }, "id": "dataform.projects.locations.repositories.releaseConfigs.patch", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs/{releaseConfigsId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/releaseConfigs/[^/]+$", "required": true, "description": "Identifier. The release config's name.", "type": "string", "location": "path" }, "updateMask": { "type": "string", "description": "Optional. Specifies the fields to be updated in the release config. If left unset, all fields will be updated.", "location": "query", "format": "google-fieldmask" } }, "response": { "$ref": "ReleaseConfig" }, "description": "Updates a single ReleaseConfig. **Note:** *This method does not fully implement [AIP/134](https://google.aip.dev/134). The wildcard entry (\\*) is treated as a bad request, and when the `field_mask` is omitted, the request is treated as a full update on all modifiable fields.*" }, "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/releaseConfigs", "httpMethod": "GET", "parameters": { "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "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." }, "pageToken": { "location": "query", "description": "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)", "type": "string" }, "parent": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The repository in which to list release configs. Must be in the format `projects/*/locations/*/repositories/*`." } }, "response": { "$ref": "ListReleaseConfigsResponse" }, "description": "Lists ReleaseConfigs in a given Repository.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.releaseConfigs.list" }, "get": { "id": "dataform.projects.locations.repositories.releaseConfigs.get", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ReleaseConfig" }, "description": "Fetches a single ReleaseConfig.", "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/releaseConfigs/[^/]+$", "required": true, "description": "Required. The release config's name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:GetReleaseConfigRequest)" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs/{releaseConfigsId}", "parameterOrder": [ "name" ] }, "delete": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.releaseConfigs.delete", "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/releaseConfigs/[^/]+$", "required": true, "description": "Required. The release config's name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:DeleteReleaseConfigRequest)", "type": "string", "location": "path" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs/{releaseConfigsId}", "parameterOrder": [ "name" ], "response": { "$ref": "Empty" }, "description": "Deletes a single ReleaseConfig." }, "create": { "id": "dataform.projects.locations.repositories.releaseConfigs.create", "request": { "$ref": "ReleaseConfig" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ReleaseConfig" }, "description": "Creates a new ReleaseConfig in a given Repository.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/releaseConfigs", "httpMethod": "POST", "parameters": { "parent": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The repository in which to create the release config. Must be in the format `projects/*/locations/*/repositories/*`." }, "releaseConfigId": { "location": "query", "description": "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)", "type": "string" } } } } }, "workspaces": { "methods": { "writeFile": { "path": "v1/{+workspace}:writeFile", "httpMethod": "POST", "parameters": { "workspace": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name.", "type": "string", "location": "path" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:writeFile", "parameterOrder": [ "workspace" ], "response": { "$ref": "WriteFileResponse" }, "description": "Writes to a file (inside a Workspace).", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "WriteFileRequest" }, "id": "dataform.projects.locations.repositories.workspaces.writeFile" }, "pull": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:pull", "parameterOrder": [ "name" ], "path": "v1/{+name}:pull", "httpMethod": "POST", "parameters": { "name": { "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "location": "path", "type": "string" } }, "response": { "$ref": "PullGitCommitsResponse" }, "description": "Pulls Git commits from the Repository's remote into a Workspace.", "request": { "$ref": "PullGitCommitsRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workspaces.pull" }, "push": { "id": "dataform.projects.locations.repositories.workspaces.push", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "PushGitCommitsRequest" }, "response": { "$ref": "PushGitCommitsResponse" }, "description": "Pushes Git commits from a Workspace to the Repository's remote.", "path": "v1/{+name}:push", "httpMethod": "POST", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:push", "parameterOrder": [ "name" ] }, "fetchFileDiff": { "id": "dataform.projects.locations.repositories.workspaces.fetchFileDiff", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "FetchFileDiffResponse" }, "description": "Fetches Git diff for an uncommitted file in a Workspace.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:fetchFileDiff", "parameterOrder": [ "workspace" ], "path": "v1/{+workspace}:fetchFileDiff", "httpMethod": "GET", "parameters": { "workspace": { "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "location": "path", "type": "string" }, "path": { "type": "string", "location": "query", "description": "Required. The file's full path including filename, relative to the workspace root." } } }, "queryDirectoryContents": { "response": { "$ref": "QueryDirectoryContentsResponse" }, "description": "Returns the contents of a given Workspace directory.", "path": "v1/{+workspace}:queryDirectoryContents", "httpMethod": "GET", "parameters": { "pageToken": { "location": "query", "description": "Optional. Page token received from a previous `QueryDirectoryContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryDirectoryContents`, with the exception of `page_size`, must match the call that provided the page token.", "type": "string" }, "pageSize": { "type": "integer", "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.", "location": "query", "format": "int32" }, "workspace": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name." }, "path": { "type": "string", "description": "Optional. The directory's full path including directory name, relative to the workspace root. If left unset, the workspace root is used.", "location": "query" }, "view": { "description": "Optional. Specifies the metadata to return for each directory entry. If unspecified, the default is `DIRECTORY_CONTENTS_VIEW_BASIC`. Currently the `DIRECTORY_CONTENTS_VIEW_METADATA` view is not supported by CMEK-protected workspaces.", "location": "query", "enum": [ "DIRECTORY_CONTENTS_VIEW_UNSPECIFIED", "DIRECTORY_CONTENTS_VIEW_BASIC", "DIRECTORY_CONTENTS_VIEW_METADATA" ], "enumDescriptions": [ "The default unset value. Defaults to DIRECTORY_CONTENTS_VIEW_BASIC.", "Includes only the file or directory name. This is the default behavior.", "Includes all metadata for each file or directory. Currently not supported by CMEK-protected workspaces." ], "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:queryDirectoryContents", "parameterOrder": [ "workspace" ], "id": "dataform.projects.locations.repositories.workspaces.queryDirectoryContents", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "searchFiles": { "id": "dataform.projects.locations.repositories.workspaces.searchFiles", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "SearchFilesResponse" }, "description": "Finds the contents of a given Workspace directory by filter.", "path": "v1/{+workspace}:searchFiles", "httpMethod": "GET", "parameters": { "workspace": { "location": "path", "type": "string", "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true }, "pageToken": { "description": "Optional. Page token received from a previous `SearchFilesRequest` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `SearchFilesRequest`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "description": "Optional. Maximum number of search results to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "type": "integer" }, "filter": { "type": "string", "description": "Optional. Optional filter for the returned list in filtering format. Filtering is only currently supported on the `path` field. See https://google.aip.dev/160 for details.", "location": "query" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:searchFiles", "parameterOrder": [ "workspace" ] }, "installNpmPackages": { "id": "dataform.projects.locations.repositories.workspaces.installNpmPackages", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "InstallNpmPackagesRequest" }, "response": { "$ref": "InstallNpmPackagesResponse" }, "description": "Installs dependency NPM packages (inside a Workspace).", "path": "v1/{+workspace}:installNpmPackages", "httpMethod": "POST", "parameters": { "workspace": { "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "location": "path", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:installNpmPackages", "parameterOrder": [ "workspace" ] }, "removeDirectory": { "path": "v1/{+workspace}:removeDirectory", "httpMethod": "POST", "parameters": { "workspace": { "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "location": "path", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:removeDirectory", "parameterOrder": [ "workspace" ], "response": { "$ref": "RemoveDirectoryResponse" }, "description": "Deletes a directory (inside a Workspace) and all of its contents.", "request": { "$ref": "RemoveDirectoryRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workspaces.removeDirectory" }, "reset": { "response": { "$ref": "ResetWorkspaceChangesResponse" }, "description": "Performs a Git reset for uncommitted files in a Workspace.", "path": "v1/{+name}:reset", "httpMethod": "POST", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:reset", "parameterOrder": [ "name" ], "id": "dataform.projects.locations.repositories.workspaces.reset", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "ResetWorkspaceChangesRequest" } }, "setIamPolicy": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "SetIamPolicyRequest" }, "id": "dataform.projects.locations.repositories.workspaces.setIamPolicy", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:setIamPolicy", "parameterOrder": [ "resource" ], "path": "v1/{+resource}:setIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "location": "path", "type": "string", "description": "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.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true } }, "response": { "$ref": "Policy" }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors." }, "makeDirectory": { "response": { "$ref": "MakeDirectoryResponse" }, "description": "Creates a directory inside a Workspace.", "path": "v1/{+workspace}:makeDirectory", "httpMethod": "POST", "parameters": { "workspace": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name.", "type": "string", "location": "path" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:makeDirectory", "parameterOrder": [ "workspace" ], "id": "dataform.projects.locations.repositories.workspaces.makeDirectory", "request": { "$ref": "MakeDirectoryRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "testIamPermissions": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:testIamPermissions", "parameterOrder": [ "resource" ], "path": "v1/{+resource}:testIamPermissions", "httpMethod": "POST", "parameters": { "resource": { "location": "path", "type": "string", "description": "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.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true } }, "response": { "$ref": "TestIamPermissionsResponse" }, "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "TestIamPermissionsRequest" }, "id": "dataform.projects.locations.repositories.workspaces.testIamPermissions" }, "fetchFileGitStatuses": { "response": { "$ref": "FetchFileGitStatusesResponse" }, "description": "Fetches Git statuses for the files in a Workspace.", "path": "v1/{+name}:fetchFileGitStatuses", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:fetchFileGitStatuses", "parameterOrder": [ "name" ], "id": "dataform.projects.locations.repositories.workspaces.fetchFileGitStatuses", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "commit": { "request": { "$ref": "CommitWorkspaceChangesRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workspaces.commit", "path": "v1/{+name}:commit", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:commit", "parameterOrder": [ "name" ], "response": { "$ref": "CommitWorkspaceChangesResponse" }, "description": "Applies a Git commit for uncommitted files in a Workspace." }, "get": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name.", "type": "string", "location": "path" } }, "response": { "$ref": "Workspace" }, "description": "Fetches a single Workspace.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workspaces.get" }, "delete": { "id": "dataform.projects.locations.repositories.workspaces.delete", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Empty" }, "description": "Deletes a single Workspace.", "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace resource's name." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}", "parameterOrder": [ "name" ] }, "list": { "response": { "$ref": "ListWorkspacesResponse" }, "description": "Lists Workspaces in a given Repository.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/workspaces", "httpMethod": "GET", "parameters": { "pageToken": { "description": "Optional. Page token received from a previous `ListWorkspaces` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListWorkspaces`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "description": "Optional. Maximum number of workspaces to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "type": "integer" }, "filter": { "type": "string", "description": "Optional. Filter for the returned list.", "location": "query" }, "parent": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The repository in which to list workspaces. Must be in the format `projects/*/locations/*/repositories/*`." }, "orderBy": { "type": "string", "description": "Optional. This field only supports ordering by `name`. If unspecified, the server will choose the ordering. If specified, the default order is ascending for the `name` field.", "location": "query" } }, "id": "dataform.projects.locations.repositories.workspaces.list", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "removeFile": { "response": { "$ref": "RemoveFileResponse" }, "description": "Deletes a file (inside a Workspace).", "path": "v1/{+workspace}:removeFile", "httpMethod": "POST", "parameters": { "workspace": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:removeFile", "parameterOrder": [ "workspace" ], "id": "dataform.projects.locations.repositories.workspaces.removeFile", "request": { "$ref": "RemoveFileRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "getIamPolicy": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:getIamPolicy", "parameterOrder": [ "resource" ], "path": "v1/{+resource}:getIamPolicy", "httpMethod": "GET", "parameters": { "resource": { "location": "path", "type": "string", "description": "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.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true }, "options.requestedPolicyVersion": { "type": "integer", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "location": "query", "format": "int32" } }, "response": { "$ref": "Policy" }, "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workspaces.getIamPolicy" }, "fetchGitAheadBehind": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workspaces.fetchGitAheadBehind", "path": "v1/{+name}:fetchGitAheadBehind", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "location": "path", "type": "string" }, "remoteBranch": { "type": "string", "location": "query", "description": "Optional. The name of the branch in the Git remote against which this workspace should be compared. If left unset, the repository's default branch name will be used." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:fetchGitAheadBehind", "parameterOrder": [ "name" ], "response": { "$ref": "FetchGitAheadBehindResponse" }, "description": "Fetches Git ahead/behind against a remote branch." }, "create": { "path": "v1/{+parent}/workspaces", "httpMethod": "POST", "parameters": { "parent": { "description": "Required. The repository in which to create the workspace. Must be in the format `projects/*/locations/*/repositories/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "location": "path", "type": "string" }, "workspaceId": { "type": "string", "description": "Required. The ID to use for the workspace, which will become the final component of the workspace's resource name.", "location": "query" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces", "parameterOrder": [ "parent" ], "response": { "$ref": "Workspace" }, "description": "Creates a new Workspace in a given Repository.", "request": { "$ref": "Workspace" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workspaces.create" }, "moveDirectory": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "MoveDirectoryRequest" }, "id": "dataform.projects.locations.repositories.workspaces.moveDirectory", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:moveDirectory", "parameterOrder": [ "workspace" ], "path": "v1/{+workspace}:moveDirectory", "httpMethod": "POST", "parameters": { "workspace": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name.", "type": "string", "location": "path" } }, "response": { "$ref": "MoveDirectoryResponse" }, "description": "Moves a directory (inside a Workspace), and all of its contents, to a new location." }, "readFile": { "id": "dataform.projects.locations.repositories.workspaces.readFile", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ReadFileResponse" }, "description": "Returns the contents of a file (inside a Workspace).", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:readFile", "parameterOrder": [ "workspace" ], "path": "v1/{+workspace}:readFile", "httpMethod": "GET", "parameters": { "path": { "type": "string", "location": "query", "description": "Required. The file's full path including filename, relative to the workspace root." }, "workspace": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name.", "type": "string", "location": "path" }, "revision": { "type": "string", "location": "query", "description": "Optional. The Git revision of the file to return. If left empty, the current contents of `path` will be returned." } } }, "moveFile": { "id": "dataform.projects.locations.repositories.workspaces.moveFile", "request": { "$ref": "MoveFileRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "MoveFileResponse" }, "description": "Moves a file (inside a Workspace) to a new location.", "path": "v1/{+workspace}:moveFile", "httpMethod": "POST", "parameters": { "workspace": { "location": "path", "type": "string", "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:moveFile", "parameterOrder": [ "workspace" ] } } }, "workflowInvocations": { "methods": { "list": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workflowInvocations.list", "path": "v1/{+parent}/workflowInvocations", "httpMethod": "GET", "parameters": { "parent": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The parent resource of the WorkflowInvocation type. Must be in the format `projects/*/locations/*/repositories/*`." }, "pageSize": { "description": "Optional. Maximum number of workflow invocations to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "location": "query", "format": "int32", "type": "integer" }, "filter": { "type": "string", "location": "query", "description": "Optional. Filter for the returned list." }, "pageToken": { "type": "string", "description": "Optional. Page token received from a previous `ListWorkflowInvocations` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListWorkflowInvocations`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query" }, "orderBy": { "location": "query", "description": "Optional. This field only supports ordering by `name`. If unspecified, the server will choose the ordering. If specified, the default order is ascending for the `name` field.", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations", "parameterOrder": [ "parent" ], "response": { "$ref": "ListWorkflowInvocationsResponse" }, "description": "Lists WorkflowInvocations in a given Repository." }, "query": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations/{workflowInvocationsId}:query", "parameterOrder": [ "name" ], "path": "v1/{+name}:query", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The workflow invocation's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowInvocations/[^/]+$", "required": true }, "pageSize": { "location": "query", "format": "int32", "description": "Optional. Maximum number of workflow invocations to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "type": "integer" }, "pageToken": { "description": "Optional. Page token received from a previous `QueryWorkflowInvocationActions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryWorkflowInvocationActions`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query", "type": "string" } }, "response": { "$ref": "QueryWorkflowInvocationActionsResponse" }, "description": "Returns WorkflowInvocationActions in a given WorkflowInvocation.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workflowInvocations.query" }, "get": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations/{workflowInvocationsId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The workflow invocation resource's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowInvocations/[^/]+$", "required": true } }, "response": { "$ref": "WorkflowInvocation" }, "description": "Fetches a single WorkflowInvocation.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workflowInvocations.get" }, "delete": { "id": "dataform.projects.locations.repositories.workflowInvocations.delete", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Empty" }, "description": "Deletes a single WorkflowInvocation.", "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowInvocations/[^/]+$", "required": true, "description": "Required. The workflow invocation resource's name." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations/{workflowInvocationsId}", "parameterOrder": [ "name" ] }, "create": { "response": { "$ref": "WorkflowInvocation" }, "description": "Creates a new WorkflowInvocation in a given Repository.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/workflowInvocations", "httpMethod": "POST", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. The repository in which to create the workflow invocation. Must be in the format `projects/*/locations/*/repositories/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true } }, "id": "dataform.projects.locations.repositories.workflowInvocations.create", "request": { "$ref": "WorkflowInvocation" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations/{workflowInvocationsId}:cancel", "parameterOrder": [ "name" ], "path": "v1/{+name}:cancel", "httpMethod": "POST", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The workflow invocation resource's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowInvocations/[^/]+$", "required": true } }, "response": { "$ref": "CancelWorkflowInvocationResponse" }, "description": "Requests cancellation of a running WorkflowInvocation.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "CancelWorkflowInvocationRequest" }, "id": "dataform.projects.locations.repositories.workflowInvocations.cancel" } } }, "compilationResults": { "methods": { "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/compilationResults", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/compilationResults", "httpMethod": "GET", "parameters": { "orderBy": { "description": "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.", "location": "query", "type": "string" }, "parent": { "location": "path", "type": "string", "description": "Required. The repository in which to list compilation results. Must be in the format `projects/*/locations/*/repositories/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true }, "pageToken": { "type": "string", "description": "Optional. Page token received from a previous `ListCompilationResults` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCompilationResults`, with the exception of `page_size`, must match the call that provided the page token.", "location": "query" }, "pageSize": { "location": "query", "format": "int32", "description": "Optional. Maximum number of compilation results to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "type": "integer" }, "filter": { "description": "Optional. Filter for the returned list. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:ListCompilationResultsRequest)", "location": "query", "type": "string" } }, "response": { "$ref": "ListCompilationResultsResponse" }, "description": "Lists CompilationResults in a given Repository.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.compilationResults.list" }, "get": { "response": { "$ref": "CompilationResult" }, "description": "Fetches a single CompilationResult.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/compilationResults/{compilationResultsId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The compilation result's name. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:GetCompilationResultRequest)", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/compilationResults/[^/]+$", "required": true, "location": "path", "type": "string" } }, "id": "dataform.projects.locations.repositories.compilationResults.get", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "query": { "id": "dataform.projects.locations.repositories.compilationResults.query", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "QueryCompilationResultActionsResponse" }, "description": "Returns CompilationResultActions in a given CompilationResult.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/compilationResults/{compilationResultsId}:query", "parameterOrder": [ "name" ], "path": "v1/{+name}:query", "httpMethod": "GET", "parameters": { "name": { "description": "Required. The compilation result's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/compilationResults/[^/]+$", "required": true, "location": "path", "type": "string" }, "pageToken": { "type": "string", "location": "query", "description": "Optional. Page token received from a previous `QueryCompilationResultActions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryCompilationResultActions`, with the exception of `page_size`, must match the call that provided the page token." }, "pageSize": { "type": "integer", "description": "Optional. Maximum number of compilation results to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "location": "query", "format": "int32" }, "filter": { "type": "string", "location": "query", "description": "Optional. Optional filter for the returned list. Filtering is only currently supported on the `file_path` field." } } }, "create": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/compilationResults", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/compilationResults", "httpMethod": "POST", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. The repository in which to create the compilation result. Must be in the format `projects/*/locations/*/repositories/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true } }, "response": { "$ref": "CompilationResult" }, "description": "Creates a new CompilationResult in a given project and location.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "CompilationResult" }, "id": "dataform.projects.locations.repositories.compilationResults.create" } } }, "workflowConfigs": { "methods": { "patch": { "path": "v1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowConfigs/[^/]+$", "required": true, "description": "Identifier. The workflow config's name.", "type": "string", "location": "path" }, "updateMask": { "description": "Optional. Specifies the fields to be updated in the workflow config. If left unset, all fields will be updated.", "location": "query", "format": "google-fieldmask", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs/{workflowConfigsId}", "parameterOrder": [ "name" ], "response": { "$ref": "WorkflowConfig" }, "description": "Updates a single WorkflowConfig. **Note:** *This method does not fully implement [AIP/134](https://google.aip.dev/134). The wildcard entry (\\*) is treated as a bad request, and when the `field_mask` is omitted, the request is treated as a full update on all modifiable fields.*", "request": { "$ref": "WorkflowConfig" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workflowConfigs.patch" }, "list": { "id": "dataform.projects.locations.repositories.workflowConfigs.list", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ListWorkflowConfigsResponse" }, "description": "Lists WorkflowConfigs in a given Repository.", "path": "v1/{+parent}/workflowConfigs", "httpMethod": "GET", "parameters": { "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The repository in which to list workflow configs. Must be in the format `projects/*/locations/*/repositories/*`.", "type": "string", "location": "path" }, "pageSize": { "type": "integer", "location": "query", "format": "int32", "description": "Optional. Maximum number of workflow configs to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default." }, "pageToken": { "location": "query", "description": "Optional. Page token received from a previous `ListWorkflowConfigs` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListWorkflowConfigs`, with the exception of `page_size`, must match the call that provided the page token.", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs", "parameterOrder": [ "parent" ] }, "create": { "response": { "$ref": "WorkflowConfig" }, "description": "Creates a new WorkflowConfig in a given Repository.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/workflowConfigs", "httpMethod": "POST", "parameters": { "workflowConfigId": { "description": "Required. The ID to use for the workflow config, which will become the final component of the workflow config's resource name.", "location": "query", "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The repository in which to create the workflow config. Must be in the format `projects/*/locations/*/repositories/*`.", "type": "string", "location": "path" } }, "id": "dataform.projects.locations.repositories.workflowConfigs.create", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "WorkflowConfig" } }, "get": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs/{workflowConfigsId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowConfigs/[^/]+$", "required": true, "description": "Required. The workflow config's name.", "type": "string", "location": "path" } }, "response": { "$ref": "WorkflowConfig" }, "description": "Fetches a single WorkflowConfig.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.repositories.workflowConfigs.get" }, "delete": { "response": { "$ref": "Empty" }, "description": "Deletes a single WorkflowConfig.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs/{workflowConfigsId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "location": "path", "type": "string", "description": "Required. The workflow config's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowConfigs/[^/]+$", "required": true } }, "id": "dataform.projects.locations.repositories.workflowConfigs.delete", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] } } } } }, "operations": { "methods": { "cancel": { "request": { "$ref": "CancelOperationRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.operations.cancel", "path": "v1/{+name}:cancel", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true, "description": "The name of the operation resource to be cancelled." } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "parameterOrder": [ "name" ], "response": { "$ref": "Empty" }, "description": "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`." }, "list": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations", "parameterOrder": [ "name" ], "path": "v1/{+name}/operations", "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "description": "The name of the operation's parent resource.", "type": "string", "location": "path" }, "returnPartialSuccess": { "type": "boolean", "description": "When set to `true`, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be `true` when reading across collections. For example, when `parent` is set to `\"projects/example/locations/-\"`. This field is not supported by default and will result in an `UNIMPLEMENTED` error if set unless explicitly documented otherwise in service or product specific documentation.", "location": "query" }, "pageToken": { "description": "The standard list page token.", "location": "query", "type": "string" }, "filter": { "description": "The standard list filter.", "location": "query", "type": "string" }, "pageSize": { "location": "query", "format": "int32", "description": "The standard list page size.", "type": "integer" } }, "response": { "$ref": "ListOperationsResponse" }, "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.operations.list" }, "get": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.operations.get", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "location": "path", "type": "string", "description": "The name of the operation resource.", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true } }, "response": { "$ref": "Operation" }, "description": "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." }, "delete": { "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "description": "The name of the operation resource to be deleted.", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true, "location": "path", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "parameterOrder": [ "name" ], "response": { "$ref": "Empty" }, "description": "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`.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.operations.delete" } } }, "teamFolders": { "methods": { "setIamPolicy": { "path": "v1/{+resource}:setIamPolicy", "httpMethod": "POST", "parameters": { "resource": { "description": "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.", "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "required": true, "location": "path", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:setIamPolicy", "parameterOrder": [ "resource" ], "response": { "$ref": "Policy" }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "request": { "$ref": "SetIamPolicyRequest" }, "id": "dataform.projects.locations.teamFolders.setIamPolicy" }, "getIamPolicy": { "response": { "$ref": "Policy" }, "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:getIamPolicy", "parameterOrder": [ "resource" ], "path": "v1/{+resource}:getIamPolicy", "httpMethod": "GET", "parameters": { "resource": { "description": "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.", "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "required": true, "location": "path", "type": "string" }, "options.requestedPolicyVersion": { "type": "integer", "description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "location": "query", "format": "int32" } }, "id": "dataform.projects.locations.teamFolders.getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "patch": { "id": "dataform.projects.locations.teamFolders.patch", "request": { "$ref": "TeamFolder" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "TeamFolder" }, "description": "Updates a single TeamFolder.", "path": "v1/{+name}", "httpMethod": "PATCH", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "required": true, "description": "Identifier. The TeamFolder's name.", "type": "string", "location": "path" }, "updateMask": { "description": "Optional. Specifies the fields to be updated in the Folder. If left unset, all fields will be updated.", "location": "query", "format": "google-fieldmask", "type": "string" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}", "parameterOrder": [ "name" ] }, "search": { "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/teamFolders:search", "parameterOrder": [ "location" ], "path": "v1/{+location}/teamFolders:search", "httpMethod": "GET", "parameters": { "location": { "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true, "description": "Required. Location in which to query TeamFolders. Format: `projects/*/locations/*`.", "type": "string", "location": "path" }, "orderBy": { "type": "string", "location": "query", "description": "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\"`" }, "pageToken": { "location": "query", "description": "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.", "type": "string" }, "pageSize": { "type": "integer", "description": "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.", "location": "query", "format": "int32" }, "filter": { "location": "query", "description": "Optional. Optional filtering for the returned list. Filtering is currently only supported on the `display_name` field. Example: * `filter=\"display_name=\"MyFolder\"\"`", "type": "string" } }, "response": { "$ref": "SearchTeamFoldersResponse" }, "description": "Returns all TeamFolders in a given location that the caller has access to and match the provided filter.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.teamFolders.search" }, "create": { "id": "dataform.projects.locations.teamFolders.create", "request": { "$ref": "TeamFolder" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "TeamFolder" }, "description": "Creates a new TeamFolder in a given project and location.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/teamFolders", "parameterOrder": [ "parent" ], "path": "v1/{+parent}/teamFolders", "httpMethod": "POST", "parameters": { "parent": { "location": "path", "type": "string", "description": "Required. The location in which to create the TeamFolder. Must be in the format `projects/*/locations/*`.", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true } } }, "testIamPermissions": { "response": { "$ref": "TestIamPermissionsResponse" }, "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.", "path": "v1/{+resource}:testIamPermissions", "httpMethod": "POST", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "required": true, "description": "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.", "type": "string", "location": "path" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:testIamPermissions", "parameterOrder": [ "resource" ], "id": "dataform.projects.locations.teamFolders.testIamPermissions", "request": { "$ref": "TestIamPermissionsRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "deleteTree": { "response": { "$ref": "Operation" }, "description": "Deletes a TeamFolder with its contents (Folders, Repositories, Workspaces, ReleaseConfigs, and WorkflowConfigs).", "path": "v1/{+name}:deleteTree", "httpMethod": "POST", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "required": true, "description": "Required. The TeamFolder's name. Format: projects/{project}/locations/{location}/teamFolders/{team_folder}" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:deleteTree", "parameterOrder": [ "name" ], "id": "dataform.projects.locations.teamFolders.deleteTree", "request": { "$ref": "DeleteTeamFolderTreeRequest" }, "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "queryContents": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.teamFolders.queryContents", "path": "v1/{+teamFolder}:queryContents", "httpMethod": "GET", "parameters": { "pageSize": { "type": "integer", "location": "query", "format": "int32", "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." }, "filter": { "type": "string", "location": "query", "description": "Optional. Optional filtering for the returned list. Filtering is currently only supported on the `display_name` field. Example: * `filter=\"display_name=\"MyFolder\"\"`" }, "pageToken": { "location": "query", "description": "Optional. Page token received from a previous `QueryTeamFolderContents` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `QueryTeamFolderContents`, with the exception of `page_size`, must match the call that provided the page token.", "type": "string" }, "orderBy": { "type": "string", "location": "query", "description": "Optional. Field to additionally sort results by. Will order Folders before Repositories, and then by `order_by` in ascending order. Supported keywords: `display_name` (default), `create_time`, last_modified_time. Examples: * `orderBy=\"display_name\"` * `orderBy=\"display_name desc\"`" }, "teamFolder": { "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "required": true, "description": "Required. Resource name of the TeamFolder to list contents for. Format: `projects/*/locations/*/teamFolders/*`.", "type": "string", "location": "path" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:queryContents", "parameterOrder": [ "teamFolder" ], "response": { "$ref": "QueryTeamFolderContentsResponse" }, "description": "Returns the contents of a given TeamFolder." }, "get": { "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.teamFolders.get", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}", "parameterOrder": [ "name" ], "path": "v1/{+name}", "httpMethod": "GET", "parameters": { "name": { "type": "string", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "required": true, "description": "Required. The TeamFolder's name." } }, "response": { "$ref": "TeamFolder" }, "description": "Fetches a single TeamFolder." }, "delete": { "path": "v1/{+name}", "httpMethod": "DELETE", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "required": true, "description": "Required. The TeamFolder's name.", "type": "string", "location": "path" } }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}", "parameterOrder": [ "name" ], "response": { "$ref": "Empty" }, "description": "Deletes a single TeamFolder.", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "id": "dataform.projects.locations.teamFolders.delete" } } } } } } } }, "protocol": "rest", "ownerName": "Google", "title": "Dataform API", "fullyEncodeReservedExpansion": true, "batchPath": "batch", "basePath": "", "documentationLink": "https://cloud.google.com/dataform/docs", "endpoints": [ { "location": "africa-south1", "endpointUrl": "https://dataform.africa-south1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.asia-east1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "asia-east1" }, { "endpointUrl": "https://dataform.asia-east2.rep.googleapis.com/", "description": "Regional Endpoint", "location": "asia-east2" }, { "endpointUrl": "https://dataform.asia-northeast1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "asia-northeast1" }, { "location": "asia-northeast2", "endpointUrl": "https://dataform.asia-northeast2.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "asia-northeast3", "endpointUrl": "https://dataform.asia-northeast3.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.asia-south1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "asia-south1" }, { "location": "asia-south2", "endpointUrl": "https://dataform.asia-south2.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "asia-southeast1", "endpointUrl": "https://dataform.asia-southeast1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "asia-southeast2", "endpointUrl": "https://dataform.asia-southeast2.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "australia-southeast1", "endpointUrl": "https://dataform.australia-southeast1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.australia-southeast2.rep.googleapis.com/", "description": "Regional Endpoint", "location": "australia-southeast2" }, { "location": "europe-central2", "endpointUrl": "https://dataform.europe-central2.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "europe-north1", "endpointUrl": "https://dataform.europe-north1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "europe-north2", "endpointUrl": "https://dataform.europe-north2.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "europe-southwest1", "endpointUrl": "https://dataform.europe-southwest1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "europe-west1", "endpointUrl": "https://dataform.europe-west1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "europe-west10", "endpointUrl": "https://dataform.europe-west10.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.europe-west12.rep.googleapis.com/", "description": "Regional Endpoint", "location": "europe-west12" }, { "endpointUrl": "https://dataform.europe-west2.rep.googleapis.com/", "description": "Regional Endpoint", "location": "europe-west2" }, { "location": "europe-west3", "endpointUrl": "https://dataform.europe-west3.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.europe-west4.rep.googleapis.com/", "description": "Regional Endpoint", "location": "europe-west4" }, { "endpointUrl": "https://dataform.europe-west6.rep.googleapis.com/", "description": "Regional Endpoint", "location": "europe-west6" }, { "endpointUrl": "https://dataform.europe-west8.rep.googleapis.com/", "description": "Regional Endpoint", "location": "europe-west8" }, { "endpointUrl": "https://dataform.europe-west9.rep.googleapis.com/", "description": "Regional Endpoint", "location": "europe-west9" }, { "location": "me-central1", "endpointUrl": "https://dataform.me-central1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "location": "me-central2", "endpointUrl": "https://dataform.me-central2.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.me-west1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "me-west1" }, { "location": "northamerica-northeast1", "endpointUrl": "https://dataform.northamerica-northeast1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.northamerica-northeast2.rep.googleapis.com/", "description": "Regional Endpoint", "location": "northamerica-northeast2" }, { "endpointUrl": "https://dataform.northamerica-south1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "northamerica-south1" }, { "endpointUrl": "https://dataform.southamerica-east1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "southamerica-east1" }, { "endpointUrl": "https://dataform.southamerica-west1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "southamerica-west1" }, { "location": "us-central1", "endpointUrl": "https://dataform.us-central1.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.us-east1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-east1" }, { "endpointUrl": "https://dataform.us-east4.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-east4" }, { "endpointUrl": "https://dataform.us-east5.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-east5" }, { "endpointUrl": "https://dataform.us-east7.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-east7" }, { "endpointUrl": "https://dataform.us-south1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-south1" }, { "endpointUrl": "https://dataform.us-west1.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-west1" }, { "location": "us-west2", "endpointUrl": "https://dataform.us-west2.rep.googleapis.com/", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.us-west3.rep.googleapis.com/", "description": "Regional Endpoint", "location": "us-west3" }, { "location": "us-west4", "endpointUrl": "https://dataform.us-west4.rep.googleapis.com/", "description": "Regional Endpoint" } ], "schemas": { "ReadRepositoryFileResponse": { "description": "`ReadRepositoryFile` response message.", "properties": { "contents": { "description": "The file's contents.", "format": "byte", "type": "string" } }, "id": "ReadRepositoryFileResponse", "type": "object" }, "CompilationResult": { "id": "CompilationResult", "type": "object", "properties": { "codeCompilationConfig": { "description": "Immutable. If set, fields of `code_compilation_config` override the default compilation settings that are specified in dataform.json.", "$ref": "CodeCompilationConfig" }, "dataformCoreVersion": { "type": "string", "readOnly": true, "description": "Output only. The version of `@dataform/core` that was used for compilation." }, "resolvedGitCommitSha": { "readOnly": true, "type": "string", "description": "Output only. The fully resolved Git commit SHA of the code that was compiled. Not set for compilation results whose source is a workspace." }, "compilationErrors": { "type": "array", "items": { "$ref": "CompilationError" }, "readOnly": true, "description": "Output only. Errors encountered during project compilation." }, "privateResourceMetadata": { "readOnly": true, "$ref": "PrivateResourceMetadata", "description": "Output only. Metadata indicating whether this resource is user-scoped. `CompilationResult` resource is `user_scoped` only if it is sourced from a workspace." }, "internalMetadata": { "description": "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.", "readOnly": true, "type": "string" }, "releaseConfig": { "description": "Immutable. The name of the release config to compile. Must be in the format `projects/*/locations/*/repositories/*/releaseConfigs/*`.", "type": "string" }, "dataEncryptionState": { "description": "Output only. Only set if the repository has a KMS Key.", "$ref": "DataEncryptionState", "readOnly": true }, "name": { "readOnly": true, "type": "string", "description": "Output only. The compilation result's name." }, "gitCommitish": { "description": "Immutable. Git commit/tag/branch name at which the repository should be compiled. Must exist in the remote repository. Examples: - a commit SHA: `12ade345` - a tag: `tag1` - a branch name: `branch1`", "type": "string" }, "createTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The timestamp of when the compilation result was created." }, "workspace": { "description": "Immutable. The name of the workspace to compile. Must be in the format `projects/*/locations/*/repositories/*/workspaces/*`.", "type": "string" } }, "description": "Represents the result of compiling a Dataform project." }, "CancelOperationRequest": { "properties": {}, "id": "CancelOperationRequest", "type": "object", "description": "The request message for Operations.CancelOperation." }, "IncrementalLoadMode": { "id": "IncrementalLoadMode", "type": "object", "properties": { "column": { "description": "Column name for incremental load modes", "type": "string" } }, "description": "Load definition for incremental load modes" }, "Policy": { "id": "Policy", "type": "object", "properties": { "etag": { "format": "byte", "description": "`etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.", "type": "string" }, "version": { "description": "Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "format": "int32", "type": "integer" }, "bindings": { "type": "array", "items": { "$ref": "Binding" }, "description": "Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`." } }, "description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:mike@example.com\", \"group:admins@example.com\", \"domain:google.com\", \"serviceAccount:my-project-id@appspot.gserviceaccount.com\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:eve@example.com\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time \u003c timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time \u003c timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/)." }, "CommitWorkspaceChangesRequest": { "description": "`CommitWorkspaceChanges` request message.", "id": "CommitWorkspaceChangesRequest", "type": "object", "properties": { "author": { "description": "Required. The commit's author.", "$ref": "CommitAuthor" }, "commitMessage": { "description": "Optional. The commit's message.", "type": "string" }, "paths": { "type": "array", "items": { "type": "string" }, "description": "Optional. Full file paths to commit including filename, rooted at workspace root. If left empty, all files will be committed." } } }, "QueryUserRootContentsResponse": { "properties": { "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" }, "entries": { "type": "array", "items": { "$ref": "RootContentsEntry" }, "description": "List of entries in the folder." } }, "id": "QueryUserRootContentsResponse", "type": "object", "description": "`QueryUserRootContents` response message." }, "CommitRepositoryChangesRequest": { "id": "CommitRepositoryChangesRequest", "type": "object", "properties": { "commitMetadata": { "description": "Required. The changes to commit to the repository.", "$ref": "CommitMetadata" }, "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" }, "fileOperations": { "description": "Optional. A map to the path of the file to the operation. The path is the full file path including filename, from repository root.", "additionalProperties": { "$ref": "FileOperation" }, "type": "object" } }, "description": "`CommitRepositoryChanges` request message." }, "QueryWorkflowInvocationActionsResponse": { "description": "`QueryWorkflowInvocationActions` response message.", "id": "QueryWorkflowInvocationActionsResponse", "type": "object", "properties": { "workflowInvocationActions": { "type": "array", "items": { "$ref": "WorkflowInvocationAction" }, "description": "List of workflow invocation actions." }, "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" } } }, "DataPreparationAction": { "description": "Represents a workflow action that will run a Data Preparation.", "id": "DataPreparationAction", "type": "object", "properties": { "jobId": { "readOnly": true, "type": "string", "description": "Output only. The ID of the BigQuery job that executed the SQL in sql_script. Only set once the job has started to run." }, "contentsYaml": { "description": "Output only. YAML representing the contents of the data preparation. Can be used to show the customer what the input was to their workflow.", "readOnly": true, "type": "string" }, "generatedSql": { "description": "Output only. The generated BigQuery SQL script that will be executed. For reference only.", "type": "string", "readOnly": true }, "contentsSql": { "description": "SQL definition for a Data Preparation. Contains a SQL query and additional context information.", "$ref": "ActionSqlDefinition" } } }, "SearchFilesResponse": { "description": "Client-facing representation of a file search response.", "id": "SearchFilesResponse", "type": "object", "properties": { "searchResults": { "type": "array", "items": { "$ref": "SearchResult" }, "description": "List of matched results." }, "nextPageToken": { "description": "Optional. 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" } } }, "Assertion": { "description": "Represents an assertion upon a SQL query which is required return zero rows.", "properties": { "parentAction": { "description": "The parent action of this assertion. Only set if this assertion was automatically generated.", "$ref": "Target" }, "selectQuery": { "description": "The SELECT query which must return zero rows in order for this assertion to succeed.", "type": "string" }, "disabled": { "description": "Whether this action is disabled (i.e. should not be run).", "type": "boolean" }, "tags": { "description": "Arbitrary, user-defined tags on this action.", "type": "array", "items": { "type": "string" } }, "relationDescriptor": { "description": "Descriptor for the assertion's automatically-generated view and its columns.", "$ref": "RelationDescriptor" }, "dependencyTargets": { "description": "A list of actions that this action depends on.", "type": "array", "items": { "$ref": "Target" } } }, "id": "Assertion", "type": "object" }, "WriteFileResponse": { "description": "`WriteFile` response message.", "id": "WriteFileResponse", "type": "object", "properties": {} }, "RootContentsEntry": { "description": "Represents a single content entry.", "properties": { "folder": { "description": "A subfolder.", "$ref": "Folder" }, "repository": { "description": "A repository.", "$ref": "Repository" } }, "id": "RootContentsEntry", "type": "object" }, "FetchRepositoryHistoryResponse": { "description": "`FetchRepositoryHistory` response message.", "id": "FetchRepositoryHistoryResponse", "type": "object", "properties": { "commits": { "description": "A list of commit logs, ordered by 'git log' default order.", "type": "array", "items": { "$ref": "CommitLogEntry" } }, "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" } } }, "RelationDescriptor": { "description": "Describes a relation and its columns.", "id": "RelationDescriptor", "type": "object", "properties": { "columns": { "description": "A list of descriptions of columns within the relation.", "type": "array", "items": { "$ref": "ColumnDescriptor" } }, "description": { "description": "A text description of the relation.", "type": "string" }, "bigqueryLabels": { "type": "object", "description": "A set of BigQuery labels that should be applied to the relation.", "additionalProperties": { "type": "string" } } } }, "IamPolicyOverrideView": { "description": "Contains metadata about the IAM policy override for a given Dataform resource. If is_active is true, this the policy encoded in iam_policy_name is the source of truth for this resource. Will be provided in internal ESV2 views for: Workspaces, Repositories, Folders, TeamFolders.", "id": "IamPolicyOverrideView", "type": "object", "properties": { "iamPolicyName": { "description": "The IAM policy name for the resource.", "$ref": "PolicyName" }, "isActive": { "description": "Whether the IAM policy encoded in this view is active.", "type": "boolean" } } }, "LoadConfig": { "properties": { "maximum": { "description": "Insert records where the value exceeds the previous maximum value for a column in the destination table", "$ref": "IncrementalLoadMode" }, "unique": { "description": "Insert records where the value of a column is not already present in the destination table", "$ref": "IncrementalLoadMode" }, "replace": { "description": "Replace destination table", "$ref": "SimpleLoadMode" }, "append": { "description": "Append into destination table", "$ref": "SimpleLoadMode" } }, "id": "LoadConfig", "type": "object", "description": "Simplified load configuration for actions" }, "DeleteFolderTreeRequest": { "description": "`DeleteFolderTree` request message.", "id": "DeleteFolderTreeRequest", "type": "object", "properties": { "force": { "description": "Optional. If `false` (default): The operation will fail if any Repository within the folder hierarchy has associated Release Configs or Workflow Configs. If `true`: The operation will attempt to delete everything, including any Release Configs and Workflow Configs linked to Repositories within the folder hierarchy. This permanently removes schedules and resources.", "type": "boolean" } } }, "ResetWorkspaceChangesResponse": { "description": "`ResetWorkspaceChanges` response message.", "properties": {}, "id": "ResetWorkspaceChangesResponse", "type": "object" }, "RemoveDirectoryRequest": { "description": "`RemoveDirectory` request message.", "properties": { "path": { "description": "Required. The directory's full path including directory name, relative to the workspace root.", "type": "string" } }, "id": "RemoveDirectoryRequest", "type": "object" }, "SearchResult": { "description": "Client-facing representation of a search result entry.", "properties": { "directory": { "description": "Details when search result is a directory.", "$ref": "DirectorySearchResult" }, "file": { "description": "Details when search result is a file.", "$ref": "FileSearchResult" } }, "id": "SearchResult", "type": "object" }, "TestIamPermissionsRequest": { "id": "TestIamPermissionsRequest", "type": "object", "properties": { "permissions": { "description": "The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).", "type": "array", "items": { "type": "string" } } }, "description": "Request message for `TestIamPermissions` method." }, "ListWorkspacesResponse": { "id": "ListWorkspacesResponse", "type": "object", "properties": { "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Locations which could not be reached." }, "workspaces": { "description": "List of workspaces.", "type": "array", "items": { "$ref": "Workspace" } }, "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" } }, "description": "`ListWorkspaces` response message." }, "QueryDirectoryContentsResponse": { "properties": { "directoryEntries": { "description": "List of entries in the directory.", "type": "array", "items": { "$ref": "DirectoryEntry" } }, "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" } }, "id": "QueryDirectoryContentsResponse", "type": "object", "description": "`QueryDirectoryContents` response message." }, "SetIamPolicyRequest": { "description": "Request message for `SetIamPolicy` method.", "id": "SetIamPolicyRequest", "type": "object", "properties": { "policy": { "description": "REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them.", "$ref": "Policy" } } }, "TeamFolderContentsEntry": { "properties": { "folder": { "description": "A subfolder.", "$ref": "Folder" }, "repository": { "description": "A repository.", "$ref": "Repository" } }, "id": "TeamFolderContentsEntry", "type": "object", "description": "Represents a single content entry." }, "MoveFolderRequest": { "description": "`MoveFolder` request message.", "id": "MoveFolderRequest", "type": "object", "properties": { "destinationContainingFolder": { "description": "Optional. The name of the Folder, TeamFolder, or root location to move the Folder to. Can be in the format of: \"\" to move into the root User folder, `projects/*/locations/*/folders/*`, `projects/*/locations/*/teamFolders/*`", "type": "string" } } }, "TeamFolder": { "id": "TeamFolder", "type": "object", "properties": { "displayName": { "description": "Required. The TeamFolder's user-friendly name.", "type": "string" }, "internalMetadata": { "description": "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.", "readOnly": true, "type": "string" }, "updateTime": { "type": "string", "readOnly": true, "description": "Output only. The timestamp of when the TeamFolder was last updated.", "format": "google-datetime" }, "name": { "description": "Identifier. The TeamFolder's name.", "type": "string" }, "creatorIamPrincipal": { "readOnly": true, "type": "string", "description": "Output only. The IAM principal identifier of the creator of the TeamFolder." }, "createTime": { "description": "Output only. The timestamp of when the TeamFolder was created.", "format": "google-datetime", "type": "string", "readOnly": true } }, "description": "Represents a Dataform TeamFolder. This is a resource that sits at the project level and is used to organize Repositories and Folders with hierarchical access controls. They provide a team context and stricter access controls." }, "Workspace": { "properties": { "privateResourceMetadata": { "description": "Output only. Metadata indicating whether this resource is user-scoped. For `Workspace` resources, the `user_scoped` field is always `true`.", "readOnly": true, "$ref": "PrivateResourceMetadata" }, "internalMetadata": { "readOnly": true, "type": "string", "description": "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." }, "disableMoves": { "description": "Optional. If set to true, workspaces will not be moved if its linked Repository is moved. Instead, it will be deleted.", "type": "boolean" }, "createTime": { "description": "Output only. The timestamp of when the workspace was created.", "format": "google-datetime", "type": "string", "readOnly": true }, "dataEncryptionState": { "$ref": "DataEncryptionState", "readOnly": true, "description": "Output only. A data encryption state of a Git repository if this Workspace is protected by a KMS key." }, "name": { "description": "Identifier. The workspace's name.", "type": "string" } }, "id": "Workspace", "type": "object", "description": "Represents a Dataform Git workspace." }, "ScheduledExecutionRecord": { "properties": { "errorStatus": { "description": "The error status encountered upon this attempt to create the workflow invocation, if the attempt was unsuccessful.", "$ref": "Status" }, "workflowInvocation": { "description": "The name of the created workflow invocation, if one was successfully created. Must be in the format `projects/*/locations/*/repositories/*/workflowInvocations/*`.", "type": "string" }, "executionTime": { "format": "google-datetime", "description": "Output only. The timestamp of this execution attempt.", "readOnly": true, "type": "string" } }, "id": "ScheduledExecutionRecord", "type": "object", "description": "A record of an attempt to create a workflow invocation for this workflow config." }, "Notebook": { "id": "Notebook", "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "string" }, "description": "Arbitrary, user-defined tags on this action." }, "contents": { "description": "The contents of the notebook.", "type": "string" }, "disabled": { "description": "Whether this action is disabled (i.e. should not be run).", "type": "boolean" }, "dependencyTargets": { "description": "A list of actions that this action depends on.", "type": "array", "items": { "$ref": "Target" } } }, "description": "Represents a notebook." }, "InvocationConfig": { "description": "Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included.", "id": "InvocationConfig", "type": "object", "properties": { "transitiveDependentsIncluded": { "description": "Optional. When set to true, transitive dependents of included actions will be executed.", "type": "boolean" }, "includedTargets": { "type": "array", "items": { "$ref": "Target" }, "description": "Optional. The set of action identifiers to include." }, "includedTags": { "description": "Optional. The set of tags to include.", "type": "array", "items": { "type": "string" } }, "queryPriority": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Query will be executed in BigQuery with interactive priority. More information can be found at https://cloud.google.com/bigquery/docs/running-queries#queries.", "Query will be executed in BigQuery with batch priority. More information can be found at https://cloud.google.com/bigquery/docs/running-queries#batchqueries." ], "description": "Optional. Specifies the priority for query execution in BigQuery. More information can be found at https://cloud.google.com/bigquery/docs/running-queries#queries.", "enum": [ "QUERY_PRIORITY_UNSPECIFIED", "INTERACTIVE", "BATCH" ] }, "serviceAccount": { "description": "Optional. The service account to run workflow invocations under.", "type": "string" }, "fullyRefreshIncrementalTablesEnabled": { "description": "Optional. When set to true, any incremental tables will be fully refreshed.", "type": "boolean" }, "transitiveDependenciesIncluded": { "description": "Optional. When set to true, transitive dependencies of included actions will be executed.", "type": "boolean" } } }, "ComputeRepositoryAccessTokenStatusResponse": { "description": "`ComputeRepositoryAccessTokenStatus` response message.", "properties": { "tokenStatus": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "The token could not be found in Secret Manager (or the Dataform Service Account did not have permission to access it).", "The token could not be used to authenticate against the Git remote.", "The token was used successfully to authenticate against the Git remote.", "The token is not accessible due to permission issues." ], "description": "Indicates the status of the Git access token.", "enum": [ "TOKEN_STATUS_UNSPECIFIED", "NOT_FOUND", "INVALID", "VALID", "PERMISSION_DENIED" ] } }, "id": "ComputeRepositoryAccessTokenStatusResponse", "type": "object" }, "ListOperationsResponse": { "properties": { "operations": { "type": "array", "items": { "$ref": "Operation" }, "description": "A list of operations that matches the specified filter in the request." }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Unordered list. Unreachable resources. Populated when the request sets `ListOperationsRequest.return_partial_success` and reads across collections. For example, when attempting to list all resources across all supported locations." }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } }, "id": "ListOperationsResponse", "type": "object", "description": "The response message for Operations.ListOperations." }, "ListCompilationResultsResponse": { "properties": { "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" }, "compilationResults": { "description": "List of compilation results.", "type": "array", "items": { "$ref": "CompilationResult" } }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Locations which could not be reached. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:ListCompilationResultsResponse)" } }, "id": "ListCompilationResultsResponse", "type": "object", "description": "`ListCompilationResults` response message." }, "SqlDefinition": { "description": "Definition of a SQL Data Preparation", "properties": { "query": { "description": "The SQL query representing the data preparation steps. Formatted as a Pipe SQL query statement.", "type": "string" }, "load": { "description": "Load configuration.", "$ref": "LoadConfig" }, "errorTable": { "description": "Error table configuration,", "$ref": "ErrorTable" } }, "id": "SqlDefinition", "type": "object" }, "ListReleaseConfigsResponse": { "description": "`ListReleaseConfigs` response message.", "id": "ListReleaseConfigsResponse", "type": "object", "properties": { "unreachable": { "description": "Locations which could not be reached. LINT.ThenChange(//depot/google3/google/cloud/dataform/v2main/data_pipelines.proto:ListReleaseConfigsResponse)", "type": "array", "items": { "type": "string" } }, "releaseConfigs": { "type": "array", "items": { "$ref": "ReleaseConfig" }, "description": "List of release configs." }, "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" } } }, "Expr": { "properties": { "title": { "description": "Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.", "type": "string" }, "expression": { "description": "Textual representation of an expression in Common Expression Language syntax.", "type": "string" }, "location": { "description": "Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.", "type": "string" }, "description": { "description": "Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.", "type": "string" } }, "id": "Expr", "type": "object", "description": "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() \u003c 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." }, "CommitAuthor": { "id": "CommitAuthor", "type": "object", "properties": { "name": { "description": "Required. The commit author's name.", "type": "string" }, "emailAddress": { "description": "Required. The commit author's email address.", "type": "string" } }, "description": "Represents the author of a Git commit." }, "CompilationResultAction": { "description": "Represents a single Dataform action in a compilation result.", "properties": { "internalMetadata": { "description": "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.", "type": "string", "readOnly": true }, "declaration": { "description": "The declaration declared by this action.", "$ref": "Declaration" }, "target": { "description": "This action's identifier. Unique within the compilation result.", "$ref": "Target" }, "relation": { "description": "The database relation created/updated by this action.", "$ref": "Relation" }, "operations": { "description": "The database operations executed by this action.", "$ref": "Operations" }, "dataPreparation": { "description": "The data preparation executed by this action.", "$ref": "DataPreparation" }, "canonicalTarget": { "description": "The action's identifier if the project had been compiled without any overrides configured. Unique within the compilation result.", "$ref": "Target" }, "filePath": { "description": "The full path including filename in which this action is located, relative to the workspace root.", "type": "string" }, "assertion": { "description": "The assertion executed by this action.", "$ref": "Assertion" }, "notebook": { "description": "The notebook executed by this action.", "$ref": "Notebook" } }, "id": "CompilationResultAction", "type": "object" }, "ListLocationsResponse": { "description": "The response message for Locations.ListLocations.", "id": "ListLocationsResponse", "type": "object", "properties": { "locations": { "description": "A list of locations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "Location" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } } }, "PullGitCommitsRequest": { "id": "PullGitCommitsRequest", "type": "object", "properties": { "author": { "description": "Required. The author of any merge commit which may be created as a result of merging fetched Git commits into this workspace.", "$ref": "CommitAuthor" }, "remoteBranch": { "description": "Optional. The name of the branch in the Git remote from which to pull commits. If left unset, the repository's default branch name will be used.", "type": "string" } }, "description": "`PullGitCommits` request message." }, "Location": { "description": "A resource that represents a Google Cloud location.", "properties": { "displayName": { "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\".", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "type": "object" }, "locationId": { "description": "The canonical id for this location. For example: `\"us-east1\"`.", "type": "string" }, "metadata": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "description": "Service-specific metadata. For example the available capacity at the given location." }, "name": { "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`", "type": "string" } }, "id": "Location", "type": "object" }, "CancelWorkflowInvocationRequest": { "description": "`CancelWorkflowInvocation` request message.", "properties": {}, "id": "CancelWorkflowInvocationRequest", "type": "object" }, "DeleteFile": { "description": "Represents the delete file operation.", "id": "DeleteFile", "type": "object", "properties": {} }, "Target": { "description": "Represents an action identifier. If the action writes output, the output will be written to the referenced database object.", "properties": { "schema": { "description": "Optional. The action's schema (BigQuery dataset ID), within `database`.", "type": "string" }, "database": { "description": "Optional. The action's database (Google Cloud project ID) .", "type": "string" }, "name": { "description": "Optional. The action's name, within `database` and `schema`.", "type": "string" } }, "id": "Target", "type": "object" }, "FetchFileGitStatusesResponse": { "description": "`FetchFileGitStatuses` response message.", "id": "FetchFileGitStatusesResponse", "type": "object", "properties": { "uncommittedFileChanges": { "description": "A list of all files which have uncommitted Git changes. There will only be a single entry for any given file.", "type": "array", "items": { "$ref": "UncommittedFileChange" } } } }, "CommitMetadata": { "description": "Represents a Dataform Git commit.", "id": "CommitMetadata", "type": "object", "properties": { "author": { "description": "Required. The commit's author.", "$ref": "CommitAuthor" }, "commitMessage": { "description": "Optional. The commit's message.", "type": "string" } } }, "FileOperation": { "id": "FileOperation", "type": "object", "properties": { "writeFile": { "description": "Represents the write operation.", "$ref": "WriteFile" }, "deleteFile": { "description": "Represents the delete operation.", "$ref": "DeleteFile" } }, "description": "Represents a single file operation to the repository." }, "PrivateResourceMetadata": { "description": "Metadata used to identify if a resource is user scoped.", "properties": { "userScoped": { "readOnly": true, "type": "boolean", "description": "Output only. If true, this resource is user-scoped, meaning it is either a workspace or sourced from a workspace." } }, "id": "PrivateResourceMetadata", "type": "object" }, "CodeCompilationConfig": { "description": "Configures various aspects of Dataform code compilation.", "properties": { "defaultDatabase": { "description": "Optional. The default database (Google Cloud project ID).", "type": "string" }, "defaultSchema": { "description": "Optional. The default schema (BigQuery dataset ID).", "type": "string" }, "databaseSuffix": { "description": "Optional. The suffix that should be appended to all database (Google Cloud project ID) names.", "type": "string" }, "tablePrefix": { "description": "Optional. The prefix that should be prepended to all table names.", "type": "string" }, "defaultLocation": { "description": "Optional. The default BigQuery location to use. Defaults to \"US\". See the BigQuery docs for a full list of locations: https://cloud.google.com/bigquery/docs/locations.", "type": "string" }, "schemaSuffix": { "description": "Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names.", "type": "string" }, "defaultNotebookRuntimeOptions": { "description": "Optional. The default notebook runtime options.", "$ref": "NotebookRuntimeOptions" }, "vars": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Optional. User-defined variables that are made available to project code during compilation." }, "assertionSchema": { "description": "Optional. The default schema (BigQuery dataset ID) for assertions.", "type": "string" }, "builtinAssertionNamePrefix": { "description": "Optional. The prefix to prepend to built-in assertion names.", "type": "string" } }, "id": "CodeCompilationConfig", "type": "object" }, "QueryRepositoryDirectoryContentsResponse": { "id": "QueryRepositoryDirectoryContentsResponse", "type": "object", "properties": { "directoryEntries": { "description": "List of entries in the directory.", "type": "array", "items": { "$ref": "DirectoryEntry" } }, "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" } }, "description": "`QueryRepositoryDirectoryContents` response message." }, "ScheduledReleaseRecord": { "description": "A record of an attempt to create a compilation result for this release config.", "id": "ScheduledReleaseRecord", "type": "object", "properties": { "errorStatus": { "description": "The error status encountered upon this attempt to create the compilation result, if the attempt was unsuccessful.", "$ref": "Status" }, "compilationResult": { "description": "The name of the created compilation result, if one was successfully created. Must be in the format `projects/*/locations/*/repositories/*/compilationResults/*`.", "type": "string" }, "releaseTime": { "format": "google-datetime", "description": "Output only. The timestamp of this release attempt.", "readOnly": true, "type": "string" } } }, "PushGitCommitsResponse": { "properties": {}, "id": "PushGitCommitsResponse", "type": "object", "description": "`PushGitCommits` response message." }, "ReadFileResponse": { "description": "`ReadFile` response message.", "properties": { "fileContents": { "type": "string", "description": "The file's contents.", "format": "byte" } }, "id": "ReadFileResponse", "type": "object" }, "QueryTeamFolderContentsResponse": { "id": "QueryTeamFolderContentsResponse", "type": "object", "properties": { "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" }, "entries": { "type": "array", "items": { "$ref": "TeamFolderContentsEntry" }, "description": "List of entries in the TeamFolder." } }, "description": "`QueryTeamFolderContents` response message." }, "InstallNpmPackagesRequest": { "description": "`InstallNpmPackages` request message.", "properties": {}, "id": "InstallNpmPackagesRequest", "type": "object" }, "FetchFileDiffResponse": { "description": "`FetchFileDiff` response message.", "id": "FetchFileDiffResponse", "type": "object", "properties": { "formattedDiff": { "description": "The raw formatted Git diff for the file.", "type": "string" } } }, "GitRemoteSettings": { "properties": { "defaultBranch": { "description": "Optional. The Git remote's default branch name. If not set `main` will be used.", "type": "string" }, "tokenStatus": { "type": "string", "readOnly": true, "enumDescriptions": [ "Default value. This value is unused.", "The token could not be found in Secret Manager (or the Dataform Service Account did not have permission to access it).", "The token could not be used to authenticate against the Git remote.", "The token was used successfully to authenticate against the Git remote." ], "deprecated": true, "enum": [ "TOKEN_STATUS_UNSPECIFIED", "NOT_FOUND", "INVALID", "VALID" ], "description": "Output only. Deprecated: The field does not contain any token status information." }, "authenticationTokenSecretVersion": { "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" }, "sshAuthenticationConfig": { "description": "Optional. Authentication fields for remote uris using SSH protocol.", "$ref": "SshAuthenticationConfig" }, "url": { "description": "Required. The Git remote's URL.", "type": "string" }, "effectiveDefaultBranch": { "readOnly": true, "type": "string", "description": "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`." } }, "id": "GitRemoteSettings", "type": "object", "description": "Controls Git remote configuration for a repository." }, "ActionErrorTable": { "properties": { "target": { "description": "Error Table target.", "$ref": "Target" }, "retentionDays": { "format": "int32", "description": "Error table partition expiration in days. Only positive values are allowed.", "type": "integer" } }, "id": "ActionErrorTable", "type": "object", "description": "Error table information, used to write error data into a BigQuery table." }, "Folder": { "id": "Folder", "type": "object", "properties": { "createTime": { "description": "Output only. The timestamp of when the Folder was created.", "format": "google-datetime", "type": "string", "readOnly": true }, "teamFolderName": { "readOnly": true, "type": "string", "description": "Output only. The resource name of the TeamFolder that this Folder is associated with. This should take the format: projects/{project}/locations/{location}/teamFolders/{teamFolder}. If this is not set, the Folder is not associated with a TeamFolder and is a UserFolder." }, "updateTime": { "format": "google-datetime", "description": "Output only. The timestamp of when the Folder was last updated.", "readOnly": true, "type": "string" }, "name": { "description": "Identifier. The Folder's name.", "type": "string" }, "creatorIamPrincipal": { "description": "Output only. The IAM principal identifier of the creator of the Folder.", "readOnly": true, "type": "string" }, "containingFolder": { "description": "Optional. The containing Folder resource name. This should take the format: projects/{project}/locations/{location}/folders/{folder}, projects/{project}/locations/{location}/teamFolders/{teamFolder}, or just \"\" if this is a root Folder. This field can only be updated through MoveFolder.", "type": "string" }, "internalMetadata": { "description": "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.", "readOnly": true, "type": "string" }, "displayName": { "description": "Required. The Folder's user-friendly name.", "type": "string" } }, "description": "Represents a Dataform Folder. This is a resource that is used to organize Files and other Folders and provide hierarchical access controls." }, "ListWorkflowConfigsResponse": { "description": "`ListWorkflowConfigs` response message.", "id": "ListWorkflowConfigsResponse", "type": "object", "properties": { "workflowConfigs": { "type": "array", "items": { "$ref": "WorkflowConfig" }, "description": "List of workflow configs." }, "unreachable": { "description": "Locations which could not be reached.", "type": "array", "items": { "type": "string" } }, "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" } } }, "WriteFile": { "description": "Represents the write file operation (for files added or modified).", "id": "WriteFile", "type": "object", "properties": { "contents": { "format": "byte", "description": "The file's contents.", "type": "string" } } }, "NotebookAction": { "properties": { "contents": { "readOnly": true, "type": "string", "description": "Output only. The code contents of a Notebook to be run." }, "jobId": { "description": "Output only. The ID of the Gemini Enterprise Agent Platform job that executed the notebook in contents and also the ID used for the outputs created in Google Cloud Storage buckets. Only set once the job has started to run.", "readOnly": true, "type": "string" } }, "id": "NotebookAction", "type": "object", "description": "Represents a workflow action that will run against a Notebook runtime." }, "CommitRepositoryChangesResponse": { "description": "`CommitRepositoryChanges` response message.", "id": "CommitRepositoryChangesResponse", "type": "object", "properties": { "commitSha": { "description": "The commit SHA of the current commit.", "type": "string" } } }, "ColumnDescriptor": { "properties": { "path": { "description": "The identifier for the column. Each entry in `path` represents one level of nesting.", "type": "array", "items": { "type": "string" } }, "description": { "description": "A textual description of the column.", "type": "string" }, "bigqueryPolicyTags": { "type": "array", "items": { "type": "string" }, "description": "A list of BigQuery policy tags that will be applied to the column." } }, "id": "ColumnDescriptor", "type": "object", "description": "Describes a column." }, "FilesystemEntryMetadata": { "id": "FilesystemEntryMetadata", "type": "object", "properties": { "sizeBytes": { "description": "Output only. Provides the size of the entry in bytes. For directories, this will be 0.", "format": "int64", "type": "string", "readOnly": true }, "updateTime": { "format": "google-datetime", "description": "Output only. Represents the time of the last modification of the entry.", "readOnly": true, "type": "string" } }, "description": "Represents metadata for a single entry in a filesystem." }, "RemoveFileResponse": { "properties": {}, "id": "RemoveFileResponse", "type": "object", "description": "`RemoveFile` response message." }, "OperationMetadata": { "id": "OperationMetadata", "type": "object", "properties": { "endTime": { "type": "string", "readOnly": true, "description": "Output only. The time the operation finished running.", "format": "google-datetime" }, "verb": { "type": "string", "readOnly": true, "description": "Output only. Name of the verb executed by the operation." }, "statusDetail": { "description": "Output only. Human-readable status of the operation, if any.", "readOnly": true, "type": "string" }, "target": { "description": "Output only. Server-defined resource path for the target of the operation.", "readOnly": true, "type": "string" }, "cancelRequested": { "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "type": "boolean", "readOnly": true }, "apiVersion": { "type": "string", "readOnly": true, "description": "Output only. API version used to start the operation." }, "createTime": { "type": "string", "readOnly": true, "description": "Output only. The time the operation was created.", "format": "google-datetime" } }, "description": "Represents the metadata of the long-running operation." }, "ListRepositoriesResponse": { "properties": { "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" }, "repositories": { "description": "List of repositories.", "type": "array", "items": { "$ref": "Repository" } }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Locations which could not be reached." } }, "id": "ListRepositoriesResponse", "type": "object", "description": "`ListRepositories` response message." }, "CommitLogEntry": { "id": "CommitLogEntry", "type": "object", "properties": { "commitTime": { "type": "string", "format": "google-datetime", "description": "Commit timestamp." }, "commitSha": { "description": "The commit SHA for this commit log entry.", "type": "string" }, "author": { "description": "The commit author for this commit log entry.", "$ref": "CommitAuthor" }, "commitMessage": { "description": "The commit message for this commit log entry.", "type": "string" } }, "description": "Represents a single commit log." }, "RemoveDirectoryResponse": { "properties": {}, "id": "RemoveDirectoryResponse", "type": "object", "description": "`RemoveDirectory` response message." }, "Interval": { "description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.", "properties": { "startTime": { "type": "string", "format": "google-datetime", "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start." }, "endTime": { "type": "string", "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.", "format": "google-datetime" } }, "id": "Interval", "type": "object" }, "ActionSimpleLoadMode": { "properties": {}, "id": "ActionSimpleLoadMode", "type": "object", "description": "Simple load definition" }, "SearchTeamFoldersResponse": { "description": "`SearchTeamFolders` response message.", "id": "SearchTeamFoldersResponse", "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "TeamFolderSearchResult" }, "description": "List of TeamFolders that match the search query." }, "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" } } }, "PushGitCommitsRequest": { "description": "`PushGitCommits` request message.", "id": "PushGitCommitsRequest", "type": "object", "properties": { "remoteBranch": { "description": "Optional. The name of the branch in the Git remote to which commits should be pushed. If left unset, the repository's default branch name will be used.", "type": "string" } } }, "ReleaseConfig": { "properties": { "recentScheduledReleaseRecords": { "type": "array", "items": { "$ref": "ScheduledReleaseRecord" }, "readOnly": true, "description": "Output only. Records of the 10 most recent scheduled release attempts, ordered in descending order of `release_time`. Updated whenever automatic creation of a compilation result is triggered by cron_schedule." }, "disabled": { "description": "Optional. Disables automatic creation of compilation results.", "type": "boolean" }, "name": { "description": "Identifier. The release config's name.", "type": "string" }, "releaseCompilationResult": { "description": "Optional. The name of the currently released compilation result for this release config. This value is updated when a compilation result is automatically created from this release config (using cron_schedule), or when this resource is updated by API call (perhaps to roll back to an earlier release). The compilation result must have been created using this release config. Must be in the format `projects/*/locations/*/repositories/*/compilationResults/*`.", "type": "string" }, "gitCommitish": { "description": "Required. Git commit/tag/branch name at which the repository should be compiled. Must exist in the remote repository. Examples: - a commit SHA: `12ade345` - a tag: `tag1` - a branch name: `branch1`", "type": "string" }, "timeZone": { "description": "Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC.", "type": "string" }, "internalMetadata": { "description": "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)", "type": "string", "readOnly": true }, "codeCompilationConfig": { "description": "Optional. If set, fields of `code_compilation_config` override the default compilation settings that are specified in dataform.json.", "$ref": "CodeCompilationConfig" }, "cronSchedule": { "description": "Optional. Optional schedule (in cron format) for automatic creation of compilation results.", "type": "string" } }, "id": "ReleaseConfig", "type": "object", "description": "Represents a Dataform release configuration." }, "MoveFileRequest": { "description": "`MoveFile` request message.", "id": "MoveFileRequest", "type": "object", "properties": { "path": { "description": "Required. The file's full path including filename, relative to the workspace root.", "type": "string" }, "newPath": { "description": "Required. The file's new path including filename, relative to the workspace root.", "type": "string" } } }, "MakeDirectoryRequest": { "description": "`MakeDirectory` request message.", "id": "MakeDirectoryRequest", "type": "object", "properties": { "path": { "description": "Required. The directory's full path including directory name, relative to the workspace root.", "type": "string" } } }, "DirectorySearchResult": { "properties": { "path": { "description": "File system path relative to the workspace root.", "type": "string" } }, "id": "DirectorySearchResult", "type": "object", "description": "Client-facing representation of a directory entry in search results." }, "DataEncryptionState": { "description": "Describes encryption state of a resource.", "properties": { "kmsKeyVersionName": { "description": "Required. The KMS key version name with which data of a resource is encrypted.", "type": "string" } }, "id": "DataEncryptionState", "type": "object" }, "QueryCompilationResultActionsResponse": { "id": "QueryCompilationResultActionsResponse", "type": "object", "properties": { "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" }, "compilationResultActions": { "description": "List of compilation result actions.", "type": "array", "items": { "$ref": "CompilationResultAction" } } }, "description": "`QueryCompilationResultActions` response message." }, "CancelWorkflowInvocationResponse": { "id": "CancelWorkflowInvocationResponse", "type": "object", "properties": {}, "description": "`CancelWorkflowInvocation` response message." }, "Empty": { "description": "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); }", "id": "Empty", "type": "object", "properties": {} }, "WriteFileRequest": { "description": "`WriteFile` request message.", "id": "WriteFileRequest", "type": "object", "properties": { "path": { "description": "Required. The file.", "type": "string" }, "contents": { "format": "byte", "description": "Required. The file's contents.", "type": "string" } } }, "ResetWorkspaceChangesRequest": { "description": "`ResetWorkspaceChanges` request message.", "id": "ResetWorkspaceChangesRequest", "type": "object", "properties": { "paths": { "description": "Optional. Full file paths to reset back to their committed state including filename, rooted at workspace root. If left empty, all files will be reset.", "type": "array", "items": { "type": "string" } }, "clean": { "description": "Optional. If set to true, untracked files will be deleted.", "type": "boolean" } } }, "DataPreparation": { "description": "Defines a compiled Data Preparation entity", "id": "DataPreparation", "type": "object", "properties": { "contentsYaml": { "description": "The data preparation definition, stored as a YAML string.", "type": "string" }, "disabled": { "description": "Whether this action is disabled (i.e. should not be run).", "type": "boolean" }, "contentsSql": { "description": "SQL definition for a Data Preparation. Contains a SQL query and additional context information.", "$ref": "SqlDefinition" }, "tags": { "description": "Arbitrary, user-defined tags on this action.", "type": "array", "items": { "type": "string" } }, "dependencyTargets": { "description": "A list of actions that this action depends on.", "type": "array", "items": { "$ref": "Target" } } } }, "WorkspaceCompilationOverrides": { "description": "Configures workspace compilation overrides for a repository.", "properties": { "defaultDatabase": { "description": "Optional. The default database (Google Cloud project ID).", "type": "string" }, "schemaSuffix": { "description": "Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names.", "type": "string" }, "tablePrefix": { "description": "Optional. The prefix that should be prepended to all table names.", "type": "string" } }, "id": "WorkspaceCompilationOverrides", "type": "object" }, "SimpleLoadMode": { "id": "SimpleLoadMode", "type": "object", "properties": {}, "description": "Simple load definition" }, "ActionLoadConfig": { "properties": { "maximum": { "description": "Insert records where the value exceeds the previous maximum value for a column in the destination table", "$ref": "ActionIncrementalLoadMode" }, "unique": { "description": "Insert records where the value of a column is not already present in the destination table", "$ref": "ActionIncrementalLoadMode" }, "replace": { "description": "Replace destination table", "$ref": "ActionSimpleLoadMode" }, "append": { "description": "Append into destination table", "$ref": "ActionSimpleLoadMode" } }, "id": "ActionLoadConfig", "type": "object", "description": "Simplified load configuration for actions" }, "DirectoryEntry": { "description": "Represents a single entry in a directory.", "id": "DirectoryEntry", "type": "object", "properties": { "directory": { "description": "A child directory in the directory. The path is returned including the full folder structure from the root.", "type": "string" }, "metadata": { "description": "Entry with metadata.", "$ref": "FilesystemEntryMetadata" }, "file": { "description": "A file in the directory. The path is returned including the full folder structure from the root.", "type": "string" } } }, "Operations": { "description": "Represents a list of arbitrary database operations.", "id": "Operations", "type": "object", "properties": { "tags": { "description": "Arbitrary, user-defined tags on this action.", "type": "array", "items": { "type": "string" } }, "relationDescriptor": { "description": "Descriptor for any output relation and its columns. Only set if `has_output` is true.", "$ref": "RelationDescriptor" }, "dependencyTargets": { "type": "array", "items": { "$ref": "Target" }, "description": "A list of actions that this action depends on." }, "queries": { "description": "A list of arbitrary SQL statements that will be executed without alteration.", "type": "array", "items": { "type": "string" } }, "hasOutput": { "description": "Whether these operations produce an output relation.", "type": "boolean" }, "disabled": { "description": "Whether this action is disabled (i.e. should not be run).", "type": "boolean" } } }, "FolderContentsEntry": { "properties": { "folder": { "description": "A subfolder.", "$ref": "Folder" }, "repository": { "description": "A repository.", "$ref": "Repository" } }, "id": "FolderContentsEntry", "type": "object", "description": "Represents a single content entry." }, "ErrorTable": { "id": "ErrorTable", "type": "object", "properties": { "target": { "description": "Error Table target.", "$ref": "Target" }, "retentionDays": { "type": "integer", "format": "int32", "description": "Error table partition expiration in days. Only positive values are allowed." } }, "description": "Error table information, used to write error data into a BigQuery table." }, "SshAuthenticationConfig": { "id": "SshAuthenticationConfig", "type": "object", "properties": { "userPrivateKeySecretVersion": { "description": "Required. The name of the Secret Manager secret version to use as a ssh private key for Git operations. Must be in the format `projects/*/secrets/*/versions/*`.", "type": "string" }, "hostPublicKey": { "description": "Required. Content of a public SSH key to verify an identity of a remote Git host.", "type": "string" } }, "description": "Configures fields for performing SSH authentication." }, "Status": { "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).", "id": "Status", "type": "object", "properties": { "details": { "type": "array", "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" }, "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use." }, "code": { "type": "integer", "description": "The status code, which should be an enum value of google.rpc.Code.", "format": "int32" }, "message": { "description": "A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.", "type": "string" } } }, "FetchGitAheadBehindResponse": { "id": "FetchGitAheadBehindResponse", "type": "object", "properties": { "commitsBehind": { "type": "integer", "description": "The number of commits in the workspace that are not in the remote branch.", "format": "int32" }, "commitsAhead": { "type": "integer", "format": "int32", "description": "The number of commits in the remote branch that are not in the workspace." } }, "description": "`FetchGitAheadBehind` response message." }, "BigQueryAction": { "description": "Represents a workflow action that will run against BigQuery.", "id": "BigQueryAction", "type": "object", "properties": { "sqlScript": { "type": "string", "readOnly": true, "description": "Output only. The generated BigQuery SQL script that will be executed." }, "jobId": { "type": "string", "readOnly": true, "description": "Output only. The ID of the BigQuery job that executed the SQL in sql_script. Only set once the job has started to run." } } }, "PullGitCommitsResponse": { "description": "`PullGitCommits` response message.", "id": "PullGitCommitsResponse", "type": "object", "properties": {} }, "PolicyName": { "properties": { "region": { "description": "For Cloud IAM: The location of the Policy. Must be empty or \"global\" for Policies owned by global IAM. Must name a region from prodspec/cloud-iam-cloudspec for Regional IAM Policies, see go/iam-faq#where-is-iam-currently-deployed. For Local IAM: This field should be set to \"local\".", "type": "string" }, "type": { "description": "Resource type. Types are defined in IAM's .service files. Valid values for type might be 'storage_buckets', 'compute_instances', 'resourcemanager_customers', 'billing_accounts', etc.", "type": "string" }, "id": { "description": "Identifies an instance of the type. ID format varies by type. The ID format is defined in the IAM .service file that defines the type, either in path_mapping or in a comment.", "type": "string" } }, "id": "PolicyName", "type": "object", "description": "An internal name for an IAM policy, based on the resource to which the policy applies. Not to be confused with a resource's external full resource name. For more information on this distinction, see go/iam-full-resource-names." }, "Operation": { "properties": { "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "Status" }, "name": { "description": "The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.", "type": "string" }, "metadata": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "description": "Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any." }, "response": { "description": "The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" }, "done": { "description": "If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.", "type": "boolean" } }, "id": "Operation", "type": "object", "description": "This resource represents a long-running operation that is the result of a network API call." }, "MoveDirectoryRequest": { "description": "`MoveDirectory` request message.", "properties": { "path": { "description": "Required. The directory's full path including directory name, relative to the workspace root.", "type": "string" }, "newPath": { "description": "Required. The new path for the directory including directory name, rooted at workspace root.", "type": "string" } }, "id": "MoveDirectoryRequest", "type": "object" }, "Repository": { "id": "Repository", "type": "object", "properties": { "serviceAccount": { "description": "Optional. The service account to run workflow invocations under.", "type": "string" }, "teamFolderName": { "type": "string", "readOnly": true, "description": "Output only. The resource name of the TeamFolder that this Repository is associated with. This should take the format: projects/{project}/locations/{location}/teamFolders/{teamFolder}. If this is not set, the Repository is not associated with a TeamFolder." }, "name": { "description": "Identifier. The repository's name.", "type": "string" }, "createTime": { "format": "google-datetime", "description": "Output only. The timestamp of when the repository was created.", "readOnly": true, "type": "string" }, "npmrcEnvironmentVariablesSecretVersion": { "description": "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.", "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.", "type": "boolean" }, "containingFolder": { "description": "Optional. The name of the containing folder of the repository. The field is immutable and it can be modified via a MoveRepository operation. Format: `projects/*/locations/*/folders/*`. or `projects/*/locations/*/teamFolders/*`.", "type": "string" }, "labels": { "type": "object", "description": "Optional. Repository user labels.", "additionalProperties": { "type": "string" } }, "gitRemoteSettings": { "description": "Optional. If set, configures this repository to be linked to a Git remote.", "$ref": "GitRemoteSettings" }, "displayName": { "description": "Optional. The repository's user-friendly name.", "type": "string" }, "dataEncryptionState": { "description": "Output only. A data encryption state of a Git repository if this Repository is protected by a KMS key.", "$ref": "DataEncryptionState", "readOnly": true }, "internalMetadata": { "type": "string", "readOnly": true, "description": "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." }, "kmsKeyName": { "description": "Optional. The reference to a KMS encryption key. If provided, it will be used to encrypt user data in the repository and all child resources. It is not possible to add or update the encryption key after the repository is created. Example: `projects/{kms_project}/locations/{location}/keyRings/{key_location}/cryptoKeys/{key}`", "type": "string" }, "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.", "$ref": "WorkspaceCompilationOverrides" } }, "description": "Represents a Dataform Git repository." }, "MoveDirectoryResponse": { "description": "`MoveDirectory` response message.", "properties": {}, "id": "MoveDirectoryResponse", "type": "object" }, "Declaration": { "description": "Represents a relation which is not managed by Dataform but which may be referenced by Dataform actions.", "id": "Declaration", "type": "object", "properties": { "relationDescriptor": { "description": "Descriptor for the relation and its columns. Used as documentation only, i.e. values here will result in no changes to the relation's metadata.", "$ref": "RelationDescriptor" } } }, "WorkflowInvocationAction": { "id": "WorkflowInvocationAction", "type": "object", "properties": { "bigqueryAction": { "description": "Output only. The workflow action's bigquery action details.", "readOnly": true, "$ref": "BigQueryAction" }, "dataPreparationAction": { "$ref": "DataPreparationAction", "readOnly": true, "description": "Output only. The workflow action's data preparation action details." }, "failureReason": { "description": "Output only. If and only if action's state is FAILED a failure reason is set.", "type": "string", "readOnly": true }, "internalMetadata": { "description": "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.", "type": "string", "readOnly": true }, "invocationTiming": { "description": "Output only. This action's timing details. `start_time` will be set if the action is in [RUNNING, SUCCEEDED, CANCELLED, FAILED] state. `end_time` will be set if the action is in [SUCCEEDED, CANCELLED, FAILED] state.", "$ref": "Interval", "readOnly": true }, "target": { "description": "Output only. This action's identifier. Unique within the workflow invocation.", "$ref": "Target", "readOnly": true }, "state": { "enum": [ "PENDING", "RUNNING", "SKIPPED", "DISABLED", "SUCCEEDED", "CANCELLED", "FAILED" ], "type": "string", "readOnly": true, "enumDescriptions": [ "The action has not yet been considered for invocation.", "The action is currently running.", "Execution of the action was skipped because upstream dependencies did not all complete successfully. A terminal state.", "Execution of the action was disabled as per the configuration of the corresponding compilation result action. A terminal state.", "The action succeeded. A terminal state.", "The action was cancelled. A terminal state.", "The action failed. A terminal state." ], "description": "Output only. This action's current state." }, "notebookAction": { "description": "Output only. The workflow action's notebook action details.", "readOnly": true, "$ref": "NotebookAction" }, "canonicalTarget": { "$ref": "Target", "readOnly": true, "description": "Output only. The action's identifier if the project had been compiled without any overrides configured. Unique within the compilation result." } }, "description": "Represents a single action in a workflow invocation." }, "ActionIncrementalLoadMode": { "properties": { "column": { "description": "Column name for incremental load modes", "type": "string" } }, "id": "ActionIncrementalLoadMode", "type": "object", "description": "Load definition for incremental load modes" }, "TeamFolderSearchResult": { "id": "TeamFolderSearchResult", "type": "object", "properties": { "teamFolder": { "description": "A TeamFolder resource that is in the project / location.", "$ref": "TeamFolder" } }, "description": "Represents a single content entry." }, "CommitWorkspaceChangesResponse": { "properties": {}, "id": "CommitWorkspaceChangesResponse", "type": "object", "description": "`CommitWorkspaceChanges` response message." }, "QueryFolderContentsResponse": { "description": "`QueryFolderContents` response message.", "id": "QueryFolderContentsResponse", "type": "object", "properties": { "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" }, "entries": { "type": "array", "items": { "$ref": "FolderContentsEntry" }, "description": "List of entries in the folder." } } }, "UncommittedFileChange": { "description": "Represents the Git state of a file with uncommitted changes.", "id": "UncommittedFileChange", "type": "object", "properties": { "path": { "description": "The file's full path including filename, relative to the workspace root.", "type": "string" }, "state": { "readOnly": true, "enumDescriptions": [ "Default value. This value is unused.", "The file has been newly added.", "The file has been deleted.", "The file has been modified.", "The file contains merge conflicts." ], "type": "string", "enum": [ "STATE_UNSPECIFIED", "ADDED", "DELETED", "MODIFIED", "HAS_CONFLICTS" ], "description": "Output only. Indicates the status of the file." } } }, "Config": { "id": "Config", "type": "object", "properties": { "internalMetadata": { "description": "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.", "readOnly": true, "type": "string" }, "defaultKmsKeyName": { "description": "Optional. The default KMS key that is used if no encryption key is provided when a repository is created.", "type": "string" }, "name": { "description": "Identifier. The config name.", "type": "string" } }, "description": "Config for all repositories in a given project and location." }, "NotebookRuntimeOptions": { "description": "Configures various aspects of Dataform notebook runtime.", "properties": { "aiPlatformNotebookRuntimeTemplate": { "description": "Optional. The resource name of the [Colab runtime template] (https://cloud.google.com/colab/docs/runtimes), from which a runtime is created for notebook executions. If not specified, a runtime is created with Colab's default specifications.", "type": "string" }, "gcsOutputBucket": { "description": "Optional. The Google Cloud Storage location to upload the result to. Format: `gs://bucket-name`.", "type": "string" } }, "id": "NotebookRuntimeOptions", "type": "object" }, "Relation": { "description": "Represents a database relation.", "properties": { "postOperations": { "description": "SQL statements to be executed after creating the relation.", "type": "array", "items": { "type": "string" } }, "incrementalTableConfig": { "description": "Configures `INCREMENTAL_TABLE` settings for this relation. Only set if `relation_type` is `INCREMENTAL_TABLE`.", "$ref": "IncrementalTableConfig" }, "fileFormat": { "enum": [ "FILE_FORMAT_UNSPECIFIED", "PARQUET" ], "description": "Optional. The file format for the BigQuery table.", "enumDescriptions": [ "Default value.", "Apache Parquet format." ], "type": "string" }, "storageUri": { "description": "Optional. The fully qualified location prefix of the external folder where table data is stored. The URI should be in the format `gs://bucket/path_to_table/`.", "type": "string" }, "disabled": { "description": "Whether this action is disabled (i.e. should not be run).", "type": "boolean" }, "relationDescriptor": { "description": "Descriptor for the relation and its columns.", "$ref": "RelationDescriptor" }, "relationType": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "The relation is a table.", "The relation is a view.", "The relation is an incrementalized table.", "The relation is a materialized view." ], "description": "The type of this relation.", "enum": [ "RELATION_TYPE_UNSPECIFIED", "TABLE", "VIEW", "INCREMENTAL_TABLE", "MATERIALIZED_VIEW" ] }, "partitionExpression": { "description": "The SQL expression used to partition the relation.", "type": "string" }, "clusterExpressions": { "type": "array", "items": { "type": "string" }, "description": "A list of columns or SQL expressions used to cluster the table." }, "additionalOptions": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Additional options that will be provided as key/value pairs into the options clause of a create table/view statement. See https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language for more information on which options are supported." }, "tags": { "type": "array", "items": { "type": "string" }, "description": "Arbitrary, user-defined tags on this action." }, "tableFormat": { "type": "string", "enumDescriptions": [ "Default value.", "Apache Iceberg format." ], "description": "Optional. The table format for the BigQuery table.", "enum": [ "TABLE_FORMAT_UNSPECIFIED", "ICEBERG" ] }, "preOperations": { "type": "array", "items": { "type": "string" }, "description": "SQL statements to be executed before creating the relation." }, "partitionExpirationDays": { "description": "Sets the partition expiration in days.", "format": "int32", "type": "integer" }, "dependencyTargets": { "description": "A list of actions that this action depends on.", "type": "array", "items": { "$ref": "Target" } }, "selectQuery": { "description": "The SELECT query which returns rows which this relation should contain.", "type": "string" }, "requirePartitionFilter": { "description": "Specifies whether queries on this table must include a predicate filter that filters on the partitioning column.", "type": "boolean" }, "connection": { "description": "Optional. The connection specifying the credentials to be used to read and write to external storage, such as Cloud Storage. The connection can have the form `{project}.{location}.{connection_id}` or `projects/{project}/locations/{location}/connections/{connection_id}`, or be set to DEFAULT.", "type": "string" } }, "id": "Relation", "type": "object" }, "WorkflowConfig": { "description": "Represents a Dataform workflow configuration.", "id": "WorkflowConfig", "type": "object", "properties": { "invocationConfig": { "description": "Optional. If left unset, a default InvocationConfig will be used.", "$ref": "InvocationConfig" }, "updateTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The timestamp of when the WorkflowConfig was last updated." }, "cronSchedule": { "description": "Optional. Optional schedule (in cron format) for automatic execution of this workflow config.", "type": "string" }, "recentScheduledExecutionRecords": { "description": "Output only. Records of the 10 most recent scheduled execution attempts, ordered in descending order of `execution_time`. Updated whenever automatic creation of a workflow invocation is triggered by cron_schedule.", "readOnly": true, "type": "array", "items": { "$ref": "ScheduledExecutionRecord" } }, "internalMetadata": { "description": "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.", "type": "string", "readOnly": true }, "name": { "description": "Identifier. The workflow config's name.", "type": "string" }, "releaseConfig": { "description": "Required. The name of the release config whose release_compilation_result should be executed. Must be in the format `projects/*/locations/*/repositories/*/releaseConfigs/*`.", "type": "string" }, "createTime": { "readOnly": true, "type": "string", "format": "google-datetime", "description": "Output only. The timestamp of when the WorkflowConfig was created." }, "timeZone": { "description": "Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC.", "type": "string" }, "disabled": { "description": "Optional. Disables automatic creation of workflow invocations.", "type": "boolean" } } }, "InstallNpmPackagesResponse": { "description": "`InstallNpmPackages` response message.", "id": "InstallNpmPackagesResponse", "type": "object", "properties": {} }, "WorkflowInvocation": { "properties": { "workflowConfig": { "description": "Immutable. The name of the workflow config to invoke. Must be in the format `projects/*/locations/*/repositories/*/workflowConfigs/*`.", "type": "string" }, "invocationConfig": { "description": "Immutable. If left unset, a default InvocationConfig will be used.", "$ref": "InvocationConfig" }, "resolvedCompilationResult": { "readOnly": true, "type": "string", "description": "Output only. The resolved compilation result that was used to create this invocation. Will be in the format `projects/*/locations/*/repositories/*/compilationResults/*`." }, "state": { "enum": [ "STATE_UNSPECIFIED", "RUNNING", "SUCCEEDED", "CANCELLED", "FAILED", "CANCELING" ], "readOnly": true, "enumDescriptions": [ "Default value. This value is unused.", "The workflow invocation is currently running.", "The workflow invocation succeeded. A terminal state.", "The workflow invocation was cancelled. A terminal state.", "The workflow invocation failed. A terminal state.", "The workflow invocation is being cancelled, but some actions are still running." ], "type": "string", "description": "Output only. This workflow invocation's current state." }, "internalMetadata": { "readOnly": true, "type": "string", "description": "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." }, "invocationTiming": { "description": "Output only. This workflow invocation's timing details.", "readOnly": true, "$ref": "Interval" }, "privateResourceMetadata": { "description": "Output only. Metadata indicating whether this resource is user-scoped. `WorkflowInvocation` resource is `user_scoped` only if it is sourced from a compilation result and the compilation result is user-scoped.", "$ref": "PrivateResourceMetadata", "readOnly": true }, "name": { "type": "string", "readOnly": true, "description": "Output only. The workflow invocation's name." }, "dataEncryptionState": { "description": "Output only. Only set if the repository has a KMS Key.", "$ref": "DataEncryptionState", "readOnly": true }, "compilationResult": { "description": "Immutable. The name of the compilation result to use for this invocation. Must be in the format `projects/*/locations/*/repositories/*/compilationResults/*`.", "type": "string" } }, "id": "WorkflowInvocation", "type": "object", "description": "Represents a single invocation of a compilation result." }, "FileSearchResult": { "id": "FileSearchResult", "type": "object", "properties": { "path": { "description": "File system path relative to the workspace root.", "type": "string" } }, "description": "Client-facing representation of a file entry in search results." }, "ListWorkflowInvocationsResponse": { "properties": { "unreachable": { "description": "Locations which could not be reached.", "type": "array", "items": { "type": "string" } }, "workflowInvocations": { "type": "array", "items": { "$ref": "WorkflowInvocation" }, "description": "List of workflow invocations." }, "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" } }, "id": "ListWorkflowInvocationsResponse", "type": "object", "description": "`ListWorkflowInvocations` response message." }, "CompilationError": { "properties": { "actionTarget": { "$ref": "Target", "readOnly": true, "description": "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)" }, "message": { "description": "Output only. The error's top level message.", "readOnly": true, "type": "string" }, "stack": { "type": "string", "readOnly": true, "description": "Output only. The error's full stack trace." }, "path": { "description": "Output only. The path of the file where this error occurred, if available, relative to the project root.", "type": "string", "readOnly": true } }, "id": "CompilationError", "type": "object", "description": "An error encountered when attempting to compile a Dataform project." }, "DeleteTeamFolderTreeRequest": { "description": "`DeleteTeamFolderTree` request message.", "properties": { "force": { "description": "Optional. If `false` (default): The operation will fail if any Repository within the folder hierarchy has associated Release Configs or Workflow Configs. If `true`: The operation will attempt to delete everything, including any Release Configs and Workflow Configs linked to Repositories within the folder hierarchy. This permanently removes schedules and resources.", "type": "boolean" } }, "id": "DeleteTeamFolderTreeRequest", "type": "object" }, "MoveRepositoryRequest": { "properties": { "destinationContainingFolder": { "description": "Optional. The name of the Folder, TeamFolder, or root location to move the repository to. Can be in the format of: \"\" to move into the root User folder, `projects/*/locations/*/folders/*`, `projects/*/locations/*/teamFolders/*`", "type": "string" } }, "id": "MoveRepositoryRequest", "type": "object", "description": "`MoveRepository` request message." }, "MoveFileResponse": { "description": "`MoveFile` response message.", "id": "MoveFileResponse", "type": "object", "properties": {} }, "RemoveFileRequest": { "id": "RemoveFileRequest", "type": "object", "properties": { "path": { "description": "Required. The file's full path including filename, relative to the workspace root.", "type": "string" } }, "description": "`RemoveFile` request message." }, "MakeDirectoryResponse": { "description": "`MakeDirectory` response message.", "properties": {}, "id": "MakeDirectoryResponse", "type": "object" }, "IncrementalTableConfig": { "id": "IncrementalTableConfig", "type": "object", "properties": { "uniqueKeyParts": { "type": "array", "items": { "type": "string" }, "description": "A set of columns or SQL expressions used to define row uniqueness. If any duplicates are discovered (as defined by `unique_key_parts`), only the newly selected rows (as defined by `incremental_select_query`) will be included in the relation." }, "incrementalSelectQuery": { "description": "The SELECT query which returns rows which should be inserted into the relation if it already exists and is not being refreshed.", "type": "string" }, "updatePartitionFilter": { "description": "A SQL expression conditional used to limit the set of existing rows considered for a merge operation (see `unique_key_parts` for more information).", "type": "string" }, "refreshDisabled": { "description": "Whether this table should be protected from being refreshed.", "type": "boolean" }, "incrementalPreOperations": { "description": "SQL statements to be executed before inserting new rows into the relation.", "type": "array", "items": { "type": "string" } }, "incrementalPostOperations": { "type": "array", "items": { "type": "string" }, "description": "SQL statements to be executed after inserting new rows into the relation." } }, "description": "Contains settings for relations of type `INCREMENTAL_TABLE`." }, "Binding": { "description": "Associates `members`, or principals, with a `role`.", "id": "Binding", "type": "object", "properties": { "role": { "description": "Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).", "type": "string" }, "condition": { "description": "The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).", "$ref": "Expr" }, "members": { "type": "array", "items": { "type": "string" }, "description": "Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`." } } }, "ActionSqlDefinition": { "id": "ActionSqlDefinition", "type": "object", "properties": { "errorTable": { "description": "Error table configuration,", "$ref": "ActionErrorTable" }, "query": { "description": "The SQL query representing the data preparation steps. Formatted as a Pipe SQL query statement.", "type": "string" }, "loadConfig": { "description": "Load configuration.", "$ref": "ActionLoadConfig" } }, "description": "Definition of a SQL Data Preparation" }, "TestIamPermissionsResponse": { "id": "TestIamPermissionsResponse", "type": "object", "properties": { "permissions": { "type": "array", "items": { "type": "string" }, "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed." } }, "description": "Response message for `TestIamPermissions` method." }, "FetchRemoteBranchesResponse": { "description": "`FetchRemoteBranches` response message.", "properties": { "branches": { "type": "array", "items": { "type": "string" }, "description": "The remote repository's branch names." } }, "id": "FetchRemoteBranchesResponse", "type": "object" } }, "mtlsRootUrl": "https://dataform.mtls.googleapis.com/", "name": "dataform", "baseUrl": "https://dataform.googleapis.com/", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "kind": "discovery#restDescription", "description": "Service to develop, version control, and operationalize SQL pipelines in BigQuery.", "version": "v1", "discoveryVersion": "v1", "parameters": { "callback": { "description": "JSONP", "location": "query", "type": "string" }, "access_token": { "description": "OAuth access token.", "location": "query", "type": "string" }, "quotaUser": { "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query" }, "alt": { "description": "Data format for response.", "type": "string", "default": "json", "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "enum": [ "json", "media", "proto" ], "location": "query" }, "prettyPrint": { "location": "query", "description": "Returns response with indentations and line breaks.", "type": "boolean", "default": "true" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "oauth_token": { "description": "OAuth 2.0 token for the current user.", "location": "query", "type": "string" }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query", "type": "string" }, "key": { "type": "string", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query" }, "$.xgafv": { "description": "V1 error format.", "type": "string", "enumDescriptions": [ "v1 error format", "v2 error format" ], "enum": [ "1", "2" ], "location": "query" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" } }, "servicePath": "", "revision": "20260515", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." }, "https://www.googleapis.com/auth/bigquery": { "description": "View and manage your data in Google BigQuery and see the email address for your Google Account" } } } }, "id": "dataform:v1", "ownerDomain": "google.com", "rootUrl": "https://dataform.googleapis.com/" }