{ "protocol": "rest", "mtlsRootUrl": "https://dataform.mtls.googleapis.com/", "endpoints": [ { "description": "Regional Endpoint", "endpointUrl": "https://dataform.africa-south1.rep.googleapis.com/", "location": "africa-south1" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.asia-east1.rep.googleapis.com/", "location": "asia-east1" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.asia-east2.rep.googleapis.com/", "location": "asia-east2" }, { "endpointUrl": "https://dataform.asia-northeast1.rep.googleapis.com/", "location": "asia-northeast1", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.asia-northeast2.rep.googleapis.com/", "location": "asia-northeast2", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.asia-northeast3.rep.googleapis.com/", "location": "asia-northeast3" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.asia-south1.rep.googleapis.com/", "location": "asia-south1" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.asia-south2.rep.googleapis.com/", "location": "asia-south2" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.asia-southeast1.rep.googleapis.com/", "location": "asia-southeast1" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.asia-southeast2.rep.googleapis.com/", "location": "asia-southeast2" }, { "endpointUrl": "https://dataform.australia-southeast1.rep.googleapis.com/", "location": "australia-southeast1", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.australia-southeast2.rep.googleapis.com/", "location": "australia-southeast2" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-central2.rep.googleapis.com/", "location": "europe-central2" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-north1.rep.googleapis.com/", "location": "europe-north1" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-north2.rep.googleapis.com/", "location": "europe-north2" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-southwest1.rep.googleapis.com/", "location": "europe-southwest1" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-west1.rep.googleapis.com/", "location": "europe-west1" }, { "endpointUrl": "https://dataform.europe-west10.rep.googleapis.com/", "location": "europe-west10", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-west12.rep.googleapis.com/", "location": "europe-west12" }, { "endpointUrl": "https://dataform.europe-west2.rep.googleapis.com/", "location": "europe-west2", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-west3.rep.googleapis.com/", "location": "europe-west3" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-west4.rep.googleapis.com/", "location": "europe-west4" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-west6.rep.googleapis.com/", "location": "europe-west6" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-west8.rep.googleapis.com/", "location": "europe-west8" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.europe-west9.rep.googleapis.com/", "location": "europe-west9" }, { "endpointUrl": "https://dataform.me-central1.rep.googleapis.com/", "location": "me-central1", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.me-central2.rep.googleapis.com/", "location": "me-central2" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.me-west1.rep.googleapis.com/", "location": "me-west1" }, { "endpointUrl": "https://dataform.northamerica-northeast1.rep.googleapis.com/", "location": "northamerica-northeast1", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.northamerica-northeast2.rep.googleapis.com/", "location": "northamerica-northeast2", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.northamerica-south1.rep.googleapis.com/", "location": "northamerica-south1" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.southamerica-east1.rep.googleapis.com/", "location": "southamerica-east1" }, { "endpointUrl": "https://dataform.southamerica-west1.rep.googleapis.com/", "location": "southamerica-west1", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.us-central1.rep.googleapis.com/", "location": "us-central1", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.us-east1.rep.googleapis.com/", "location": "us-east1", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.us-east4.rep.googleapis.com/", "location": "us-east4", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.us-east5.rep.googleapis.com/", "location": "us-east5", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.us-east7.rep.googleapis.com/", "location": "us-east7" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.us-south1.rep.googleapis.com/", "location": "us-south1" }, { "endpointUrl": "https://dataform.us-west1.rep.googleapis.com/", "location": "us-west1", "description": "Regional Endpoint" }, { "description": "Regional Endpoint", "endpointUrl": "https://dataform.us-west2.rep.googleapis.com/", "location": "us-west2" }, { "endpointUrl": "https://dataform.us-west3.rep.googleapis.com/", "location": "us-west3", "description": "Regional Endpoint" }, { "endpointUrl": "https://dataform.us-west4.rep.googleapis.com/", "location": "us-west4", "description": "Regional Endpoint" } ], "basePath": "", "schemas": { "Assertion": { "description": "Represents an assertion upon a SQL query which is required return zero rows.", "properties": { "parentAction": { "$ref": "Target", "description": "The parent action of this assertion. Only set if this assertion was automatically generated." }, "dependencyTargets": { "type": "array", "description": "A list of actions that this action depends on.", "items": { "$ref": "Target" } }, "relationDescriptor": { "description": "Descriptor for the assertion's automatically-generated view and its columns.", "$ref": "RelationDescriptor" }, "disabled": { "description": "Whether this action is disabled (i.e. should not be run).", "type": "boolean" }, "tags": { "description": "Arbitrary, user-defined tags on this action.", "items": { "type": "string" }, "type": "array" }, "selectQuery": { "description": "The SELECT query which must return zero rows in order for this assertion to succeed.", "type": "string" } }, "type": "object", "id": "Assertion" }, "PushGitCommitsRequest": { "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" } }, "description": "`PushGitCommits` request message." }, "ReleaseConfig": { "type": "object", "id": "ReleaseConfig", "description": "Represents a Dataform release configuration.", "properties": { "codeCompilationConfig": { "description": "Optional. If set, fields of `code_compilation_config` override the default compilation settings that are specified in dataform.json.", "$ref": "CodeCompilationConfig" }, "internalMetadata": { "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.", "readOnly": true }, "name": { "description": "Identifier. The release config's name.", "type": "string" }, "recentScheduledReleaseRecords": { "type": "array", "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.", "readOnly": true, "items": { "$ref": "ScheduledReleaseRecord" } }, "disabled": { "description": "Optional. Disables automatic creation of compilation results.", "type": "boolean" }, "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" }, "cronSchedule": { "description": "Optional. Optional schedule (in cron format) for automatic creation of compilation results.", "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" }, "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" } } }, "ListLocationsResponse": { "properties": { "locations": { "description": "A list of locations that matches the specified filter in the request.", "items": { "$ref": "Location" }, "type": "array" }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } }, "description": "The response message for Locations.ListLocations.", "id": "ListLocationsResponse", "type": "object" }, "Target": { "type": "object", "id": "Target", "description": "Represents an action identifier. If the action writes output, the output will be written to the referenced database object.", "properties": { "database": { "description": "Optional. The action's database (Google Cloud project ID) .", "type": "string" }, "schema": { "description": "Optional. The action's schema (BigQuery dataset ID), within `database`.", "type": "string" }, "name": { "description": "Optional. The action's name, within `database` and `schema`.", "type": "string" } } }, "MakeDirectoryResponse": { "type": "object", "id": "MakeDirectoryResponse", "description": "`MakeDirectory` response message.", "properties": {} }, "LoadConfig": { "properties": { "unique": { "description": "Insert records where the value of a column is not already present in the destination table", "$ref": "IncrementalLoadMode" }, "maximum": { "description": "Insert records where the value exceeds the previous maximum value for a column in the destination table", "$ref": "IncrementalLoadMode" }, "replace": { "$ref": "SimpleLoadMode", "description": "Replace destination table" }, "append": { "$ref": "SimpleLoadMode", "description": "Append into destination table" } }, "description": "Simplified load configuration for actions", "id": "LoadConfig", "type": "object" }, "QueryDirectoryContentsResponse": { "id": "QueryDirectoryContentsResponse", "type": "object", "properties": { "directoryEntries": { "description": "List of entries in the directory.", "items": { "$ref": "DirectoryEntry" }, "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "description": "`QueryDirectoryContents` response message." }, "QueryUserRootContentsResponse": { "description": "`QueryUserRootContents` response message.", "properties": { "entries": { "description": "List of entries in the folder.", "items": { "$ref": "RootContentsEntry" }, "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "type": "object", "id": "QueryUserRootContentsResponse" }, "ListWorkflowConfigsResponse": { "description": "`ListWorkflowConfigs` response message.", "properties": { "workflowConfigs": { "type": "array", "description": "List of workflow configs.", "items": { "$ref": "WorkflowConfig" } }, "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" }, "unreachable": { "description": "Locations which could not be reached.", "items": { "type": "string" }, "type": "array" } }, "type": "object", "id": "ListWorkflowConfigsResponse" }, "Config": { "properties": { "name": { "description": "Identifier. The config name.", "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" }, "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" } }, "description": "Config for all repositories in a given project and location.", "id": "Config", "type": "object" }, "ReadFileResponse": { "description": "`ReadFile` response message.", "properties": { "fileContents": { "type": "string", "format": "byte", "description": "The file's contents." } }, "type": "object", "id": "ReadFileResponse" }, "SearchFilesResponse": { "description": "Client-facing representation of a file search response.", "properties": { "searchResults": { "description": "List of matched results.", "items": { "$ref": "SearchResult" }, "type": "array" }, "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" } }, "type": "object", "id": "SearchFilesResponse" }, "DirectorySearchResult": { "id": "DirectorySearchResult", "type": "object", "properties": { "path": { "description": "File system path relative to the workspace root.", "type": "string" } }, "description": "Client-facing representation of a directory entry in search results." }, "FileOperation": { "id": "FileOperation", "type": "object", "properties": { "writeFile": { "description": "Represents the write operation.", "$ref": "WriteFile" }, "deleteFile": { "$ref": "DeleteFile", "description": "Represents the delete operation." } }, "description": "Represents a single file operation to the repository." }, "Repository": { "description": "Represents a Dataform Git repository.", "properties": { "gitRemoteSettings": { "description": "Optional. If set, configures this repository to be linked to a Git remote.", "$ref": "GitRemoteSettings" }, "createTime": { "description": "Output only. The timestamp of when the repository was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "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" }, "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" }, "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" }, "serviceAccount": { "description": "Optional. The service account to run workflow invocations under.", "type": "string" }, "displayName": { "description": "Optional. The repository's user-friendly name.", "type": "string" }, "workspaceCompilationOverrides": { "$ref": "WorkspaceCompilationOverrides", "description": "Optional. If set, fields of `workspace_compilation_overrides` override the default compilation settings that are specified in dataform.json when creating workspace-scoped compilation results. See documentation for `WorkspaceCompilationOverrides` for more information." }, "dataEncryptionState": { "description": "Output only. A data encryption state of a Git repository if this Repository is protected by a KMS key.", "readOnly": true, "$ref": "DataEncryptionState" }, "name": { "description": "Identifier. The repository's name.", "type": "string" }, "labels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "Optional. Repository user labels." }, "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" }, "setAuthenticatedUserAdmin": { "description": "Optional. Input only. If set to true, the authenticated user will be granted the roles/dataform.admin role on the created repository. To modify access to the created repository later apply setIamPolicy from https://cloud.google.com/dataform/reference/rest#rest-resource:-v1beta1.projects.locations.repositories", "type": "boolean" }, "teamFolderName": { "type": "string", "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.", "readOnly": true } }, "type": "object", "id": "Repository" }, "MoveFileRequest": { "type": "object", "id": "MoveFileRequest", "description": "`MoveFile` request message.", "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" } } }, "QueryRepositoryDirectoryContentsResponse": { "id": "QueryRepositoryDirectoryContentsResponse", "type": "object", "properties": { "directoryEntries": { "type": "array", "description": "List of entries in the directory.", "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." }, "GitRemoteSettings": { "type": "object", "id": "GitRemoteSettings", "description": "Controls Git remote configuration for a repository.", "properties": { "sshAuthenticationConfig": { "$ref": "SshAuthenticationConfig", "description": "Optional. Authentication fields for remote uris using SSH protocol." }, "tokenStatus": { "type": "string", "enum": [ "TOKEN_STATUS_UNSPECIFIED", "NOT_FOUND", "INVALID", "VALID" ], "deprecated": true, "description": "Output only. Deprecated: The field does not contain any token status information. Instead use https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories/computeAccessTokenStatus", "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." ] }, "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" }, "url": { "description": "Required. The Git remote's URL.", "type": "string" }, "defaultBranch": { "description": "Required. The Git remote's default branch name. If not set, `main` will be used and stored for the repository.", "type": "string" } } }, "InvocationConfig": { "id": "InvocationConfig", "type": "object", "properties": { "fullyRefreshIncrementalTablesEnabled": { "description": "Optional. When set to true, any incremental tables will be fully refreshed.", "type": "boolean" }, "serviceAccount": { "description": "Optional. The service account to run workflow invocations under.", "type": "string" }, "transitiveDependenciesIncluded": { "description": "Optional. When set to true, transitive dependencies of included actions will be executed.", "type": "boolean" }, "transitiveDependentsIncluded": { "description": "Optional. When set to true, transitive dependents of included actions will be executed.", "type": "boolean" }, "queryPriority": { "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.", "type": "string", "enum": [ "QUERY_PRIORITY_UNSPECIFIED", "INTERACTIVE", "BATCH" ] }, "includedTargets": { "description": "Optional. The set of action identifiers to include.", "items": { "$ref": "Target" }, "type": "array" }, "includedTags": { "description": "Optional. The set of tags to include.", "items": { "type": "string" }, "type": "array" } }, "description": "Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included." }, "ActionErrorTable": { "properties": { "target": { "description": "Error Table target.", "$ref": "Target" }, "retentionDays": { "description": "Error table partition expiration in days. Only positive values are allowed.", "type": "integer", "format": "int32" } }, "description": "Error table information, used to write error data into a BigQuery table.", "id": "ActionErrorTable", "type": "object" }, "WorkspaceCompilationOverrides": { "description": "Configures workspace compilation overrides for a repository. Primarily used by the UI (`console.cloud.google.com`). `schema_suffix` and `table_prefix` can have a special expression - `${workspaceName}`, which refers to the workspace name from which the compilation results will be created. API callers are expected to resolve the expression in these overrides and provide them explicitly in `code_compilation_config` (https://cloud.google.com/dataform/reference/rest/v1beta1/projects.locations.repositories.compilationResults#codecompilationconfig) when creating workspace-scoped compilation results.", "properties": { "schemaSuffix": { "description": "Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names.", "type": "string" }, "defaultDatabase": { "description": "Optional. The default database (Google Cloud project ID).", "type": "string" }, "tablePrefix": { "description": "Optional. The prefix that should be prepended to all table names.", "type": "string" } }, "type": "object", "id": "WorkspaceCompilationOverrides" }, "WriteFileRequest": { "description": "`WriteFile` request message.", "properties": { "path": { "description": "Required. The file.", "type": "string" }, "contents": { "type": "string", "format": "byte", "description": "Required. The file's contents." } }, "type": "object", "id": "WriteFileRequest" }, "Operation": { "description": "This resource represents a long-running operation that is the result of a network API call.", "properties": { "metadata": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object", "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." }, "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" }, "error": { "description": "The error result of the operation in case of failure or cancellation.", "$ref": "Status" }, "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" }, "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" } }, "type": "object", "id": "Operation" }, "Workspace": { "type": "object", "id": "Workspace", "description": "Represents a Dataform Git workspace.", "properties": { "createTime": { "type": "string", "format": "google-datetime", "description": "Output only. The timestamp of when the workspace was created.", "readOnly": true }, "privateResourceMetadata": { "$ref": "PrivateResourceMetadata", "description": "Output only. Metadata indicating whether this resource is user-scoped. For `Workspace` resources, the `user_scoped` field is always `true`.", "readOnly": true }, "internalMetadata": { "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.", "readOnly": true }, "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" }, "dataEncryptionState": { "description": "Output only. A data encryption state of a Git repository if this Workspace is protected by a KMS key.", "readOnly": true, "$ref": "DataEncryptionState" }, "name": { "description": "Identifier. The workspace's name.", "type": "string" } } }, "QueryCompilationResultActionsResponse": { "description": "`QueryCompilationResultActions` response message.", "properties": { "compilationResultActions": { "description": "List of compilation result actions.", "items": { "$ref": "CompilationResultAction" }, "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "type": "object", "id": "QueryCompilationResultActionsResponse" }, "DataPreparationAction": { "description": "Represents a workflow action that will run a Data Preparation.", "properties": { "contentsSql": { "description": "SQL definition for a Data Preparation. Contains a SQL query and additional context information.", "$ref": "ActionSqlDefinition" }, "jobId": { "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.", "readOnly": true, "type": "string" }, "contentsYaml": { "type": "string", "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 }, "generatedSql": { "type": "string", "description": "Output only. The generated BigQuery SQL script that will be executed. For reference only.", "readOnly": true } }, "type": "object", "id": "DataPreparationAction" }, "Relation": { "id": "Relation", "type": "object", "properties": { "fileFormat": { "description": "Optional. The file format for the BigQuery table.", "enumDescriptions": [ "Default value.", "Apache Parquet format." ], "type": "string", "enum": [ "FILE_FORMAT_UNSPECIFIED", "PARQUET" ] }, "incrementalTableConfig": { "$ref": "IncrementalTableConfig", "description": "Configures `INCREMENTAL_TABLE` settings for this relation. Only set if `relation_type` is `INCREMENTAL_TABLE`." }, "selectQuery": { "description": "The SELECT query which returns rows which this relation should contain.", "type": "string" }, "disabled": { "description": "Whether this action is disabled (i.e. should not be run).", "type": "boolean" }, "partitionExpression": { "description": "The SQL expression used to partition the relation.", "type": "string" }, "clusterExpressions": { "description": "A list of columns or SQL expressions used to cluster the table.", "items": { "type": "string" }, "type": "array" }, "partitionExpirationDays": { "format": "int32", "type": "integer", "description": "Sets the partition expiration in days." }, "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." }, "preOperations": { "type": "array", "description": "SQL statements to be executed before creating the relation.", "items": { "type": "string" } }, "dependencyTargets": { "type": "array", "description": "A list of actions that this action depends on.", "items": { "$ref": "Target" } }, "relationType": { "type": "string", "enum": [ "RELATION_TYPE_UNSPECIFIED", "TABLE", "VIEW", "INCREMENTAL_TABLE", "MATERIALIZED_VIEW" ], "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." }, "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" }, "tags": { "description": "Arbitrary, user-defined tags on this action.", "items": { "type": "string" }, "type": "array" }, "tableFormat": { "type": "string", "enum": [ "TABLE_FORMAT_UNSPECIFIED", "ICEBERG" ], "enumDescriptions": [ "Default value.", "Apache Iceberg format." ], "description": "Optional. The table format for the BigQuery table." }, "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" }, "postOperations": { "description": "SQL statements to be executed after creating the relation.", "items": { "type": "string" }, "type": "array" }, "requirePartitionFilter": { "description": "Specifies whether queries on this table must include a predicate filter that filters on the partitioning column.", "type": "boolean" }, "relationDescriptor": { "$ref": "RelationDescriptor", "description": "Descriptor for the relation and its columns." } }, "description": "Represents a database relation." }, "CompilationResult": { "properties": { "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" }, "compilationErrors": { "type": "array", "description": "Output only. Errors encountered during project compilation.", "readOnly": true, "items": { "$ref": "CompilationError" } }, "workspace": { "description": "Immutable. The name of the workspace to compile. Must be in the format `projects/*/locations/*/repositories/*/workspaces/*`.", "type": "string" }, "resolvedGitCommitSha": { "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.", "readOnly": true, "type": "string" }, "createTime": { "format": "google-datetime", "type": "string", "description": "Output only. The timestamp of when the compilation result was created.", "readOnly": true }, "name": { "type": "string", "description": "Output only. The compilation result's name.", "readOnly": true }, "dataEncryptionState": { "$ref": "DataEncryptionState", "description": "Output only. Only set if the repository has a KMS Key.", "readOnly": true }, "codeCompilationConfig": { "description": "Immutable. If set, fields of `code_compilation_config` override the default compilation settings that are specified in dataform.json.", "$ref": "CodeCompilationConfig" }, "internalMetadata": { "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.", "readOnly": true }, "releaseConfig": { "description": "Immutable. The name of the release config to compile. Must be in the format `projects/*/locations/*/repositories/*/releaseConfigs/*`.", "type": "string" }, "dataformCoreVersion": { "type": "string", "description": "Output only. The version of `@dataform/core` that was used for compilation.", "readOnly": true }, "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.", "readOnly": true, "$ref": "PrivateResourceMetadata" } }, "description": "Represents the result of compiling a Dataform project.", "id": "CompilationResult", "type": "object" }, "Declaration": { "type": "object", "id": "Declaration", "description": "Represents a relation which is not managed by Dataform but which may be referenced by Dataform actions.", "properties": { "relationDescriptor": { "$ref": "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." } } }, "RemoveDirectoryRequest": { "type": "object", "id": "RemoveDirectoryRequest", "description": "`RemoveDirectory` request message.", "properties": { "path": { "description": "Required. The directory's full path including directory name, relative to the workspace root.", "type": "string" } } }, "BigQueryAction": { "description": "Represents a workflow action that will run against BigQuery.", "properties": { "sqlScript": { "type": "string", "description": "Output only. The generated BigQuery SQL script that will be executed.", "readOnly": true }, "jobId": { "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.", "readOnly": true, "type": "string" } }, "type": "object", "id": "BigQueryAction" }, "DeleteFile": { "id": "DeleteFile", "type": "object", "properties": {}, "description": "Represents the delete file operation." }, "MoveDirectoryResponse": { "description": "`MoveDirectory` response message.", "properties": {}, "type": "object", "id": "MoveDirectoryResponse" }, "SetIamPolicyRequest": { "id": "SetIamPolicyRequest", "type": "object", "properties": { "policy": { "$ref": "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." } }, "description": "Request message for `SetIamPolicy` method." }, "PushGitCommitsResponse": { "properties": {}, "description": "`PushGitCommits` response message.", "id": "PushGitCommitsResponse", "type": "object" }, "ScheduledExecutionRecord": { "description": "A record of an attempt to create a workflow invocation for this workflow config.", "properties": { "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" }, "errorStatus": { "description": "The error status encountered upon this attempt to create the workflow invocation, if the attempt was unsuccessful.", "$ref": "Status" }, "executionTime": { "description": "Output only. The timestamp of this execution attempt.", "readOnly": true, "type": "string", "format": "google-datetime" } }, "type": "object", "id": "ScheduledExecutionRecord" }, "CommitRepositoryChangesResponse": { "description": "`CommitRepositoryChanges` response message.", "properties": { "commitSha": { "description": "The commit SHA of the current commit.", "type": "string" } }, "type": "object", "id": "CommitRepositoryChangesResponse" }, "Expr": { "id": "Expr", "type": "object", "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" }, "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" }, "expression": { "description": "Textual representation of an expression in Common Expression Language syntax.", "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" } }, "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." }, "PullGitCommitsResponse": { "properties": {}, "description": "`PullGitCommits` response message.", "id": "PullGitCommitsResponse", "type": "object" }, "FetchFileDiffResponse": { "description": "`FetchFileDiff` response message.", "properties": { "formattedDiff": { "description": "The raw formatted Git diff for the file.", "type": "string" } }, "type": "object", "id": "FetchFileDiffResponse" }, "QueryTeamFolderContentsResponse": { "type": "object", "id": "QueryTeamFolderContentsResponse", "description": "`QueryTeamFolderContents` response message.", "properties": { "entries": { "type": "array", "description": "List of entries in the TeamFolder.", "items": { "$ref": "TeamFolderContentsEntry" } }, "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" } } }, "RootContentsEntry": { "type": "object", "id": "RootContentsEntry", "description": "Represents a single content entry.", "properties": { "repository": { "$ref": "Repository", "description": "A repository." }, "folder": { "$ref": "Folder", "description": "A subfolder." } } }, "Policy": { "id": "Policy", "type": "object", "properties": { "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).", "type": "integer", "format": "int32" }, "bindings": { "type": "array", "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`.", "items": { "$ref": "Binding" } }, "etag": { "format": "byte", "type": "string", "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." } }, "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/)." }, "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" } }, "description": "`MoveRepository` request message.", "id": "MoveRepositoryRequest", "type": "object" }, "ResetWorkspaceChangesRequest": { "properties": { "clean": { "description": "Optional. If set to true, untracked files will be deleted.", "type": "boolean" }, "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.", "items": { "type": "string" }, "type": "array" } }, "description": "`ResetWorkspaceChanges` request message.", "id": "ResetWorkspaceChangesRequest", "type": "object" }, "FetchFileGitStatusesResponse": { "type": "object", "id": "FetchFileGitStatusesResponse", "description": "`FetchFileGitStatuses` response message.", "properties": { "uncommittedFileChanges": { "type": "array", "description": "A list of all files which have uncommitted Git changes. There will only be a single entry for any given file.", "items": { "$ref": "UncommittedFileChange" } } } }, "QueryWorkflowInvocationActionsResponse": { "description": "`QueryWorkflowInvocationActions` response message.", "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" }, "workflowInvocationActions": { "type": "array", "description": "List of workflow invocation actions.", "items": { "$ref": "WorkflowInvocationAction" } } }, "type": "object", "id": "QueryWorkflowInvocationActionsResponse" }, "TeamFolderContentsEntry": { "description": "Represents a single content entry.", "properties": { "folder": { "$ref": "Folder", "description": "A subfolder." }, "repository": { "description": "A repository.", "$ref": "Repository" } }, "type": "object", "id": "TeamFolderContentsEntry" }, "Empty": { "id": "Empty", "type": "object", "properties": {}, "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); }" }, "FolderContentsEntry": { "properties": { "repository": { "description": "A repository.", "$ref": "Repository" }, "folder": { "description": "A subfolder.", "$ref": "Folder" } }, "description": "Represents a single content entry.", "id": "FolderContentsEntry", "type": "object" }, "MoveFolderRequest": { "description": "`MoveFolder` request message.", "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" } }, "type": "object", "id": "MoveFolderRequest" }, "SearchResult": { "properties": { "file": { "$ref": "FileSearchResult", "description": "Details when search result is a file." }, "directory": { "$ref": "DirectorySearchResult", "description": "Details when search result is a directory." } }, "description": "Client-facing representation of a search result entry.", "id": "SearchResult", "type": "object" }, "DataPreparation": { "description": "Defines a compiled Data Preparation entity", "properties": { "dependencyTargets": { "description": "A list of actions that this action depends on.", "items": { "$ref": "Target" }, "type": "array" }, "contentsSql": { "$ref": "SqlDefinition", "description": "SQL definition for a Data Preparation. Contains a SQL query and additional context information." }, "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" }, "tags": { "type": "array", "description": "Arbitrary, user-defined tags on this action.", "items": { "type": "string" } } }, "type": "object", "id": "DataPreparation" }, "QueryFolderContentsResponse": { "description": "`QueryFolderContents` response message.", "properties": { "entries": { "type": "array", "description": "List of entries in the folder.", "items": { "$ref": "FolderContentsEntry" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } }, "type": "object", "id": "QueryFolderContentsResponse" }, "WorkflowInvocation": { "properties": { "invocationConfig": { "description": "Immutable. If left unset, a default InvocationConfig will be used.", "$ref": "InvocationConfig" }, "privateResourceMetadata": { "$ref": "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.", "readOnly": true }, "invocationTiming": { "description": "Output only. This workflow invocation's timing details.", "readOnly": true, "$ref": "Interval" }, "state": { "type": "string", "enum": [ "STATE_UNSPECIFIED", "RUNNING", "SUCCEEDED", "CANCELLED", "FAILED", "CANCELING" ], "description": "Output only. This workflow invocation's current state.", "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." ] }, "resolvedCompilationResult": { "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/*`.", "readOnly": true }, "workflowConfig": { "description": "Immutable. The name of the workflow config to invoke. Must be in the format `projects/*/locations/*/repositories/*/workflowConfigs/*`.", "type": "string" }, "internalMetadata": { "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.", "readOnly": true }, "dataEncryptionState": { "$ref": "DataEncryptionState", "description": "Output only. Only set if the repository has a KMS Key.", "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" }, "name": { "type": "string", "description": "Output only. The workflow invocation's name.", "readOnly": true } }, "description": "Represents a single invocation of a compilation result.", "id": "WorkflowInvocation", "type": "object" }, "TestIamPermissionsRequest": { "description": "Request message for `TestIamPermissions` method.", "properties": { "permissions": { "type": "array", "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).", "items": { "type": "string" } } }, "type": "object", "id": "TestIamPermissionsRequest" }, "Notebook": { "id": "Notebook", "type": "object", "properties": { "dependencyTargets": { "type": "array", "description": "A list of actions that this action depends on.", "items": { "$ref": "Target" } }, "contents": { "description": "The contents of the notebook.", "type": "string" }, "disabled": { "description": "Whether this action is disabled (i.e. should not be run).", "type": "boolean" }, "tags": { "type": "array", "description": "Arbitrary, user-defined tags on this action.", "items": { "type": "string" } } }, "description": "Represents a notebook." }, "InstallNpmPackagesResponse": { "id": "InstallNpmPackagesResponse", "type": "object", "properties": {}, "description": "`InstallNpmPackages` response message." }, "InstallNpmPackagesRequest": { "description": "`InstallNpmPackages` request message.", "properties": {}, "type": "object", "id": "InstallNpmPackagesRequest" }, "ResetWorkspaceChangesResponse": { "id": "ResetWorkspaceChangesResponse", "type": "object", "properties": {}, "description": "`ResetWorkspaceChanges` response message." }, "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).", "properties": { "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" }, "details": { "type": "array", "description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.", "items": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object" } }, "code": { "description": "The status code, which should be an enum value of google.rpc.Code.", "format": "int32", "type": "integer" } }, "type": "object", "id": "Status" }, "SearchTeamFoldersResponse": { "properties": { "results": { "type": "array", "description": "List of TeamFolders that match the search query.", "items": { "$ref": "TeamFolderSearchResult" } }, "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": "`SearchTeamFolders` response message.", "id": "SearchTeamFoldersResponse", "type": "object" }, "Interval": { "type": "object", "id": "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": { "endTime": { "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.", "type": "string", "format": "google-datetime" }, "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." } } }, "CommitMetadata": { "type": "object", "id": "CommitMetadata", "description": "Represents a Dataform Git commit.", "properties": { "commitMessage": { "description": "Optional. The commit's message.", "type": "string" }, "author": { "$ref": "CommitAuthor", "description": "Required. The commit's author." } } }, "FilesystemEntryMetadata": { "description": "Represents metadata for a single entry in a filesystem.", "properties": { "sizeBytes": { "type": "string", "format": "int64", "description": "Output only. Provides the size of the entry in bytes. For directories, this will be 0.", "readOnly": true }, "updateTime": { "description": "Output only. Represents the time of the last modification of the entry.", "readOnly": true, "format": "google-datetime", "type": "string" } }, "type": "object", "id": "FilesystemEntryMetadata" }, "DirectoryEntry": { "type": "object", "id": "DirectoryEntry", "description": "Represents a single entry in a directory.", "properties": { "file": { "description": "A file in the directory.", "type": "string" }, "metadata": { "description": "Entry with metadata.", "$ref": "FilesystemEntryMetadata" }, "directory": { "description": "A child directory in the directory.", "type": "string" } } }, "CompilationResultAction": { "type": "object", "id": "CompilationResultAction", "description": "Represents a single Dataform action in a compilation result.", "properties": { "target": { "$ref": "Target", "description": "This action's identifier. Unique within the compilation result." }, "canonicalTarget": { "description": "The action's identifier if the project had been compiled without any overrides configured. Unique within the compilation result.", "$ref": "Target" }, "operations": { "description": "The database operations executed by this action.", "$ref": "Operations" }, "internalMetadata": { "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.", "readOnly": true }, "notebook": { "$ref": "Notebook", "description": "The notebook executed by this action." }, "dataPreparation": { "description": "The data preparation executed by this action.", "$ref": "DataPreparation" }, "filePath": { "description": "The full path including filename in which this action is located, relative to the workspace root.", "type": "string" }, "declaration": { "description": "The declaration declared by this action.", "$ref": "Declaration" }, "assertion": { "$ref": "Assertion", "description": "The assertion executed by this action." }, "relation": { "$ref": "Relation", "description": "The database relation created/updated by this action." } } }, "CancelWorkflowInvocationResponse": { "type": "object", "id": "CancelWorkflowInvocationResponse", "description": "`CancelWorkflowInvocation` response message.", "properties": {} }, "IncrementalLoadMode": { "properties": { "column": { "description": "Column name for incremental load modes", "type": "string" } }, "description": "Load definition for incremental load modes", "id": "IncrementalLoadMode", "type": "object" }, "CommitWorkspaceChangesRequest": { "properties": { "paths": { "description": "Optional. Full file paths to commit including filename, rooted at workspace root. If left empty, all files will be committed.", "items": { "type": "string" }, "type": "array" }, "commitMessage": { "description": "Optional. The commit's message.", "type": "string" }, "author": { "$ref": "CommitAuthor", "description": "Required. The commit's author." } }, "description": "`CommitWorkspaceChanges` request message.", "id": "CommitWorkspaceChangesRequest", "type": "object" }, "FileSearchResult": { "description": "Client-facing representation of a file entry in search results.", "properties": { "path": { "description": "File system path relative to the workspace root.", "type": "string" } }, "type": "object", "id": "FileSearchResult" }, "ReadRepositoryFileResponse": { "id": "ReadRepositoryFileResponse", "type": "object", "properties": { "contents": { "format": "byte", "type": "string", "description": "The file's contents." } }, "description": "`ReadRepositoryFile` response message." }, "SqlDefinition": { "properties": { "load": { "description": "Load configuration.", "$ref": "LoadConfig" }, "errorTable": { "description": "Error table configuration,", "$ref": "ErrorTable" }, "query": { "description": "The SQL query representing the data preparation steps. Formatted as a Pipe SQL query statement.", "type": "string" } }, "description": "Definition of a SQL Data Preparation", "id": "SqlDefinition", "type": "object" }, "IamPolicyOverrideView": { "type": "object", "id": "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.", "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" } } }, "TeamFolder": { "properties": { "displayName": { "description": "Required. The TeamFolder's user-friendly name.", "type": "string" }, "createTime": { "format": "google-datetime", "type": "string", "description": "Output only. The timestamp of when the TeamFolder was created.", "readOnly": true }, "updateTime": { "format": "google-datetime", "type": "string", "description": "Output only. The timestamp of when the TeamFolder was last updated.", "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.", "readOnly": true, "type": "string" }, "name": { "description": "Identifier. The TeamFolder's name.", "type": "string" }, "creatorIamPrincipal": { "description": "Output only. The IAM principal identifier of the creator of the TeamFolder.", "readOnly": true, "type": "string" } }, "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.", "id": "TeamFolder", "type": "object" }, "TeamFolderSearchResult": { "description": "Represents a single content entry.", "properties": { "teamFolder": { "description": "A TeamFolder resource that is in the project / location.", "$ref": "TeamFolder" } }, "type": "object", "id": "TeamFolderSearchResult" }, "RemoveFileRequest": { "type": "object", "id": "RemoveFileRequest", "description": "`RemoveFile` request message.", "properties": { "path": { "description": "Required. The file's full path including filename, relative to the workspace root.", "type": "string" } } }, "WorkflowInvocationAction": { "description": "Represents a single action in a workflow invocation.", "properties": { "canonicalTarget": { "$ref": "Target", "description": "Output only. The action's identifier if the project had been compiled without any overrides configured. Unique within the compilation result.", "readOnly": true }, "failureReason": { "description": "Output only. If and only if action's state is FAILED a failure reason is set.", "readOnly": true, "type": "string" }, "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.", "readOnly": true, "$ref": "Interval" }, "dataPreparationAction": { "$ref": "DataPreparationAction", "description": "Output only. The workflow action's data preparation action details.", "readOnly": true }, "target": { "$ref": "Target", "description": "Output only. This action's identifier. Unique within the workflow invocation.", "readOnly": true }, "state": { "type": "string", "enum": [ "PENDING", "RUNNING", "SKIPPED", "DISABLED", "SUCCEEDED", "CANCELLED", "FAILED" ], "description": "Output only. This action's current state.", "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." ] }, "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" }, "bigqueryAction": { "description": "Output only. The workflow action's bigquery action details.", "readOnly": true, "$ref": "BigQueryAction" }, "notebookAction": { "$ref": "NotebookAction", "description": "Output only. The workflow action's notebook action details.", "readOnly": true } }, "type": "object", "id": "WorkflowInvocationAction" }, "ListReleaseConfigsResponse": { "type": "object", "id": "ListReleaseConfigsResponse", "description": "`ListReleaseConfigs` response message.", "properties": { "releaseConfigs": { "description": "List of release configs.", "items": { "$ref": "ReleaseConfig" }, "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "unreachable": { "type": "array", "description": "Locations which could not be reached.", "items": { "type": "string" } } } }, "ListWorkspacesResponse": { "id": "ListWorkspacesResponse", "type": "object", "properties": { "workspaces": { "type": "array", "description": "List of workspaces.", "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" }, "unreachable": { "description": "Locations which could not be reached.", "items": { "type": "string" }, "type": "array" } }, "description": "`ListWorkspaces` response message." }, "RemoveDirectoryResponse": { "id": "RemoveDirectoryResponse", "type": "object", "properties": {}, "description": "`RemoveDirectory` response message." }, "TestIamPermissionsResponse": { "type": "object", "id": "TestIamPermissionsResponse", "description": "Response message for `TestIamPermissions` method.", "properties": { "permissions": { "type": "array", "description": "A subset of `TestPermissionsRequest.permissions` that the caller is allowed.", "items": { "type": "string" } } } }, "DataEncryptionState": { "type": "object", "id": "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" } } }, "ColumnDescriptor": { "id": "ColumnDescriptor", "type": "object", "properties": { "path": { "type": "array", "description": "The identifier for the column. Each entry in `path` represents one level of nesting.", "items": { "type": "string" } }, "description": { "description": "A textual description of the column.", "type": "string" }, "bigqueryPolicyTags": { "type": "array", "description": "A list of BigQuery policy tags that will be applied to the column.", "items": { "type": "string" } } }, "description": "Describes a column." }, "ActionIncrementalLoadMode": { "id": "ActionIncrementalLoadMode", "type": "object", "properties": { "column": { "description": "Column name for incremental load modes", "type": "string" } }, "description": "Load definition for incremental load modes" }, "Operations": { "properties": { "disabled": { "description": "Whether this action is disabled (i.e. should not be run).", "type": "boolean" }, "tags": { "description": "Arbitrary, user-defined tags on this action.", "items": { "type": "string" }, "type": "array" }, "relationDescriptor": { "$ref": "RelationDescriptor", "description": "Descriptor for any output relation and its columns. Only set if `has_output` is true." }, "hasOutput": { "description": "Whether these operations produce an output relation.", "type": "boolean" }, "queries": { "description": "A list of arbitrary SQL statements that will be executed without alteration.", "items": { "type": "string" }, "type": "array" }, "dependencyTargets": { "type": "array", "description": "A list of actions that this action depends on.", "items": { "$ref": "Target" } } }, "description": "Represents a list of arbitrary database operations.", "id": "Operations", "type": "object" }, "CommitRepositoryChangesRequest": { "type": "object", "id": "CommitRepositoryChangesRequest", "description": "`CommitRepositoryChanges` request message.", "properties": { "fileOperations": { "type": "object", "additionalProperties": { "$ref": "FileOperation" }, "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." }, "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" }, "commitMetadata": { "description": "Required. The changes to commit to the repository.", "$ref": "CommitMetadata" } } }, "PrivateResourceMetadata": { "type": "object", "id": "PrivateResourceMetadata", "description": "Metadata used to identify if a resource is user scoped.", "properties": { "userScoped": { "description": "Output only. If true, this resource is user-scoped, meaning it is either a workspace or sourced from a workspace.", "readOnly": true, "type": "boolean" } } }, "MoveFileResponse": { "properties": {}, "description": "`MoveFile` response message.", "id": "MoveFileResponse", "type": "object" }, "SshAuthenticationConfig": { "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.", "id": "SshAuthenticationConfig", "type": "object" }, "CommitAuthor": { "type": "object", "id": "CommitAuthor", "description": "Represents the author of a Git commit.", "properties": { "name": { "description": "Required. The commit author's name.", "type": "string" }, "emailAddress": { "description": "Required. The commit author's email address.", "type": "string" } } }, "WorkflowConfig": { "properties": { "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" }, "disabled": { "description": "Optional. Disables automatic creation of workflow invocations.", "type": "boolean" }, "name": { "description": "Identifier. The workflow config's name.", "type": "string" }, "internalMetadata": { "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.", "readOnly": true }, "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" }, "updateTime": { "format": "google-datetime", "type": "string", "description": "Output only. The timestamp of when the WorkflowConfig was last updated.", "readOnly": true }, "recentScheduledExecutionRecords": { "type": "array", "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, "items": { "$ref": "ScheduledExecutionRecord" } }, "createTime": { "description": "Output only. The timestamp of when the WorkflowConfig was created.", "readOnly": true, "type": "string", "format": "google-datetime" }, "cronSchedule": { "description": "Optional. Optional schedule (in cron format) for automatic execution of this workflow config.", "type": "string" }, "invocationConfig": { "$ref": "InvocationConfig", "description": "Optional. If left unset, a default InvocationConfig will be used." } }, "description": "Represents a Dataform workflow configuration.", "id": "WorkflowConfig", "type": "object" }, "DeleteTeamFolderTreeRequest": { "id": "DeleteTeamFolderTreeRequest", "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" } }, "description": "`DeleteTeamFolderTree` request message." }, "WriteFile": { "properties": { "contents": { "description": "The file's contents.", "type": "string", "format": "byte" } }, "description": "Represents the write file operation (for files added or modified).", "id": "WriteFile", "type": "object" }, "ScheduledReleaseRecord": { "description": "A record of an attempt to create a compilation result for this release config.", "properties": { "errorStatus": { "description": "The error status encountered upon this attempt to create the compilation result, if the attempt was unsuccessful.", "$ref": "Status" }, "releaseTime": { "type": "string", "format": "google-datetime", "description": "Output only. The timestamp of this release attempt.", "readOnly": true }, "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" } }, "type": "object", "id": "ScheduledReleaseRecord" }, "RelationDescriptor": { "type": "object", "id": "RelationDescriptor", "description": "Describes a relation and its columns.", "properties": { "bigqueryLabels": { "additionalProperties": { "type": "string" }, "type": "object", "description": "A set of BigQuery labels that should be applied to the relation." }, "description": { "description": "A text description of the relation.", "type": "string" }, "columns": { "description": "A list of descriptions of columns within the relation.", "items": { "$ref": "ColumnDescriptor" }, "type": "array" } } }, "Location": { "type": "object", "id": "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" }, "metadata": { "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "type": "object", "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" }, "locationId": { "description": "The canonical id for this location. For example: `\"us-east1\"`.", "type": "string" }, "labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}" } } }, "CommitLogEntry": { "description": "Represents a single commit log.", "properties": { "commitSha": { "description": "The commit SHA for this commit log entry.", "type": "string" }, "commitMessage": { "description": "The commit message for this commit log entry.", "type": "string" }, "commitTime": { "format": "google-datetime", "type": "string", "description": "Commit timestamp." }, "author": { "$ref": "CommitAuthor", "description": "The commit author for this commit log entry." } }, "type": "object", "id": "CommitLogEntry" }, "ActionSimpleLoadMode": { "id": "ActionSimpleLoadMode", "type": "object", "properties": {}, "description": "Simple load definition" }, "NotebookAction": { "description": "Represents a workflow action that will run against a Notebook runtime.", "properties": { "contents": { "type": "string", "description": "Output only. The code contents of a Notebook to be run.", "readOnly": true }, "jobId": { "description": "Output only. The ID of the Vertex 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" } }, "type": "object", "id": "NotebookAction" }, "PullGitCommitsRequest": { "type": "object", "id": "PullGitCommitsRequest", "description": "`PullGitCommits` request message.", "properties": { "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" }, "author": { "$ref": "CommitAuthor", "description": "Required. The author of any merge commit which may be created as a result of merging fetched Git commits into this workspace." } } }, "ListCompilationResultsResponse": { "properties": { "unreachable": { "description": "Locations which could not be reached.", "items": { "type": "string" }, "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" }, "compilationResults": { "description": "List of compilation results.", "items": { "$ref": "CompilationResult" }, "type": "array" } }, "description": "`ListCompilationResults` response message.", "id": "ListCompilationResultsResponse", "type": "object" }, "ActionLoadConfig": { "id": "ActionLoadConfig", "type": "object", "properties": { "unique": { "description": "Insert records where the value of a column is not already present in the destination table", "$ref": "ActionIncrementalLoadMode" }, "maximum": { "description": "Insert records where the value exceeds the previous maximum value for a column in the destination table", "$ref": "ActionIncrementalLoadMode" }, "replace": { "$ref": "ActionSimpleLoadMode", "description": "Replace destination table" }, "append": { "$ref": "ActionSimpleLoadMode", "description": "Append into destination table" } }, "description": "Simplified load configuration for actions" }, "CancelOperationRequest": { "id": "CancelOperationRequest", "type": "object", "properties": {}, "description": "The request message for Operations.CancelOperation." }, "FetchRemoteBranchesResponse": { "type": "object", "id": "FetchRemoteBranchesResponse", "description": "`FetchRemoteBranches` response message.", "properties": { "branches": { "type": "array", "description": "The remote repository's branch names.", "items": { "type": "string" } } } }, "CancelWorkflowInvocationRequest": { "type": "object", "id": "CancelWorkflowInvocationRequest", "description": "`CancelWorkflowInvocation` request message.", "properties": {} }, "DeleteFolderTreeRequest": { "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" } }, "description": "`DeleteFolderTree` request message." }, "CompilationError": { "properties": { "message": { "description": "Output only. The error's top level message.", "readOnly": true, "type": "string" }, "stack": { "description": "Output only. The error's full stack trace.", "readOnly": true, "type": "string" }, "actionTarget": { "description": "Output only. The identifier of the action where this error occurred, if available.", "readOnly": true, "$ref": "Target" }, "path": { "description": "Output only. The path of the file where this error occurred, if available, relative to the project root.", "readOnly": true, "type": "string" } }, "description": "An error encountered when attempting to compile a Dataform project.", "id": "CompilationError", "type": "object" }, "ErrorTable": { "properties": { "target": { "description": "Error Table target.", "$ref": "Target" }, "retentionDays": { "description": "Error table partition expiration in days. Only positive values are allowed.", "type": "integer", "format": "int32" } }, "description": "Error table information, used to write error data into a BigQuery table.", "id": "ErrorTable", "type": "object" }, "SimpleLoadMode": { "description": "Simple load definition", "properties": {}, "type": "object", "id": "SimpleLoadMode" }, "CommitWorkspaceChangesResponse": { "id": "CommitWorkspaceChangesResponse", "type": "object", "properties": {}, "description": "`CommitWorkspaceChanges` response message." }, "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" } }, "type": "object", "id": "MoveDirectoryRequest" }, "IncrementalTableConfig": { "properties": { "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" }, "uniqueKeyParts": { "type": "array", "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.", "items": { "type": "string" } }, "incrementalPreOperations": { "description": "SQL statements to be executed before inserting new rows into the relation.", "items": { "type": "string" }, "type": "array" }, "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" }, "incrementalPostOperations": { "type": "array", "description": "SQL statements to be executed after inserting new rows into the relation.", "items": { "type": "string" } } }, "description": "Contains settings for relations of type `INCREMENTAL_TABLE`.", "id": "IncrementalTableConfig", "type": "object" }, "UncommittedFileChange": { "type": "object", "id": "UncommittedFileChange", "description": "Represents the Git state of a file with uncommitted changes.", "properties": { "path": { "description": "The file's full path including filename, relative to the workspace root.", "type": "string" }, "state": { "description": "Output only. Indicates the status of the file.", "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" ] } } }, "Binding": { "description": "Associates `members`, or principals, with a `role`.", "properties": { "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" }, "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" }, "members": { "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`.", "items": { "type": "string" }, "type": "array" } }, "type": "object", "id": "Binding" }, "ComputeRepositoryAccessTokenStatusResponse": { "properties": { "tokenStatus": { "type": "string", "enum": [ "TOKEN_STATUS_UNSPECIFIED", "NOT_FOUND", "INVALID", "VALID", "PERMISSION_DENIED" ], "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." } }, "description": "`ComputeRepositoryAccessTokenStatus` response message.", "id": "ComputeRepositoryAccessTokenStatusResponse", "type": "object" }, "ListRepositoriesResponse": { "type": "object", "id": "ListRepositoriesResponse", "description": "`ListRepositories` response message.", "properties": { "unreachable": { "description": "Locations which could not be reached.", "items": { "type": "string" }, "type": "array" }, "repositories": { "description": "List of repositories.", "items": { "$ref": "Repository" }, "type": "array" }, "nextPageToken": { "description": "A token which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "RemoveFileResponse": { "type": "object", "id": "RemoveFileResponse", "description": "`RemoveFile` response message.", "properties": {} }, "ListWorkflowInvocationsResponse": { "type": "object", "id": "ListWorkflowInvocationsResponse", "description": "`ListWorkflowInvocations` response message.", "properties": { "unreachable": { "type": "array", "description": "Locations which could not be reached.", "items": { "type": "string" } }, "workflowInvocations": { "description": "List of workflow invocations.", "items": { "$ref": "WorkflowInvocation" }, "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "Folder": { "properties": { "displayName": { "description": "Required. The Folder's user-friendly name.", "type": "string" }, "createTime": { "type": "string", "format": "google-datetime", "description": "Output only. The timestamp of when the Folder was created.", "readOnly": true }, "teamFolderName": { "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.", "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" }, "updateTime": { "description": "Output only. The timestamp of when the Folder was last updated.", "readOnly": true, "format": "google-datetime", "type": "string" }, "internalMetadata": { "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.", "readOnly": true }, "name": { "description": "Identifier. The Folder's name.", "type": "string" }, "creatorIamPrincipal": { "type": "string", "description": "Output only. The IAM principal identifier of the creator of the Folder.", "readOnly": true } }, "description": "Represents a Dataform Folder. This is a resource that is used to organize Files and other Folders and provide hierarchical access controls.", "id": "Folder", "type": "object" }, "PolicyName": { "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.", "properties": { "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" }, "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": "object", "id": "PolicyName" }, "MakeDirectoryRequest": { "id": "MakeDirectoryRequest", "type": "object", "properties": { "path": { "description": "Required. The directory's full path including directory name, relative to the workspace root.", "type": "string" } }, "description": "`MakeDirectory` request message." }, "OperationMetadata": { "id": "OperationMetadata", "type": "object", "properties": { "target": { "description": "Output only. Server-defined resource path for the target of the operation.", "readOnly": true, "type": "string" }, "verb": { "description": "Output only. Name of the verb executed by the operation.", "readOnly": true, "type": "string" }, "createTime": { "type": "string", "format": "google-datetime", "description": "Output only. The time the operation was created.", "readOnly": true }, "endTime": { "description": "Output only. The time the operation finished running.", "readOnly": true, "type": "string", "format": "google-datetime" }, "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`.", "readOnly": true, "type": "boolean" }, "apiVersion": { "description": "Output only. API version used to start the operation.", "readOnly": true, "type": "string" }, "statusDetail": { "type": "string", "description": "Output only. Human-readable status of the operation, if any.", "readOnly": true } }, "description": "Represents the metadata of the long-running operation." }, "FetchGitAheadBehindResponse": { "id": "FetchGitAheadBehindResponse", "type": "object", "properties": { "commitsBehind": { "type": "integer", "format": "int32", "description": "The number of commits in the workspace that are not in the remote branch." }, "commitsAhead": { "description": "The number of commits in the remote branch that are not in the workspace.", "type": "integer", "format": "int32" } }, "description": "`FetchGitAheadBehind` response message." }, "CodeCompilationConfig": { "type": "object", "id": "CodeCompilationConfig", "description": "Configures various aspects of Dataform code compilation.", "properties": { "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" }, "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" }, "defaultDatabase": { "description": "Optional. The default database (Google Cloud project ID).", "type": "string" }, "vars": { "description": "Optional. User-defined variables that are made available to project code during compilation.", "type": "object", "additionalProperties": { "type": "string" } }, "tablePrefix": { "description": "Optional. The prefix that should be prepended to all table names.", "type": "string" }, "defaultNotebookRuntimeOptions": { "$ref": "NotebookRuntimeOptions", "description": "Optional. The default notebook runtime options." }, "schemaSuffix": { "description": "Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names.", "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" } } }, "WriteFileResponse": { "id": "WriteFileResponse", "type": "object", "properties": {}, "description": "`WriteFile` response message." }, "ActionSqlDefinition": { "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": { "$ref": "ActionLoadConfig", "description": "Load configuration." } }, "description": "Definition of a SQL Data Preparation", "id": "ActionSqlDefinition", "type": "object" }, "FetchRepositoryHistoryResponse": { "type": "object", "id": "FetchRepositoryHistoryResponse", "description": "`FetchRepositoryHistory` response message.", "properties": { "commits": { "description": "A list of commit logs, ordered by 'git log' default order.", "items": { "$ref": "CommitLogEntry" }, "type": "array" }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "NotebookRuntimeOptions": { "id": "NotebookRuntimeOptions", "type": "object", "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" } }, "description": "Configures various aspects of Dataform notebook runtime." }, "ListOperationsResponse": { "type": "object", "id": "ListOperationsResponse", "description": "The response message for Operations.ListOperations.", "properties": { "nextPageToken": { "description": "The standard List next-page token.", "type": "string" }, "unreachable": { "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.", "items": { "type": "string" }, "type": "array" }, "operations": { "type": "array", "description": "A list of operations that matches the specified filter in the request.", "items": { "$ref": "Operation" } } } } }, "rootUrl": "https://dataform.googleapis.com/", "ownerName": "Google", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "resources": { "projects": { "resources": { "locations": { "methods": { "get": { "httpMethod": "GET", "id": "dataform.projects.locations.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Location" }, "description": "Gets information about a location.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Resource name for the location." } } }, "updateConfig": { "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.*", "response": { "$ref": "Config" }, "httpMethod": "PATCH", "id": "dataform.projects.locations.updateConfig", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/config", "parameters": { "updateMask": { "type": "string", "format": "google-fieldmask", "description": "Optional. Specifies the fields to be updated in the config.", "location": "query" }, "name": { "location": "path", "description": "Identifier. The config name.", "pattern": "^projects/[^/]+/locations/[^/]+/config$", "type": "string", "required": true } }, "parameterOrder": [ "name" ], "request": { "$ref": "Config" } }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations", "parameters": { "name": { "location": "path", "description": "The resource that owns the locations collection, if applicable.", "pattern": "^projects/[^/]+$", "type": "string", "required": true }, "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": { "type": "string", "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).", "location": "query" }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "description": "The maximum number of results to return. If not set, the service selects a default." }, "extraLocationTypes": { "description": "Optional. Do not use this field. It is unsupported and is ignored unless explicitly documented otherwise. This is primarily for internal usage.", "repeated": true, "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "id": "dataform.projects.locations.list", "path": "v1beta1/{+name}/locations", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "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.", "response": { "$ref": "ListLocationsResponse" } }, "queryUserRootContents": { "parameterOrder": [ "location" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:queryUserRootContents", "parameters": { "pageSize": { "format": "int32", "type": "integer", "location": "query", "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": { "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" }, "location": { "location": "path", "description": "Required. Location of the user root folder to list contents for. Format: projects/*/locations/*", "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "required": true }, "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), created_at, last_modified_at. Examples: * `orderBy=\"display_name\"` * `orderBy=\"display_name desc\"`" }, "pageToken": { "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", "type": "string" } }, "httpMethod": "GET", "id": "dataform.projects.locations.queryUserRootContents", "path": "v1beta1/{+location}:queryUserRootContents", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "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." }, "getConfig": { "response": { "$ref": "Config" }, "description": "Get default config for a given project and location.", "httpMethod": "GET", "id": "dataform.projects.locations.getConfig", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/config", "parameters": { "name": { "description": "Required. The config name.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/config$" } } } }, "resources": { "operations": { "methods": { "get": { "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.", "response": { "$ref": "Operation" }, "id": "dataform.projects.locations.operations.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "parameters": { "name": { "description": "The name of the operation resource.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true } }, "parameterOrder": [ "name" ] }, "delete": { "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`.", "response": { "$ref": "Empty" }, "httpMethod": "DELETE", "id": "dataform.projects.locations.operations.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}", "parameters": { "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "type": "string", "location": "path", "description": "The name of the operation resource to be deleted." } }, "parameterOrder": [ "name" ] }, "list": { "description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.", "response": { "$ref": "ListOperationsResponse" }, "httpMethod": "GET", "id": "dataform.projects.locations.operations.list", "path": "v1beta1/{+name}/operations", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations", "parameters": { "returnPartialSuccess": { "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", "type": "boolean" }, "filter": { "location": "query", "description": "The standard list filter.", "type": "string" }, "pageSize": { "type": "integer", "format": "int32", "description": "The standard list page size.", "location": "query" }, "pageToken": { "type": "string", "description": "The standard list page token.", "location": "query" }, "name": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "required": true, "location": "path", "description": "The name of the operation's parent resource." } }, "parameterOrder": [ "name" ] }, "cancel": { "httpMethod": "POST", "id": "dataform.projects.locations.operations.cancel", "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "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`.", "parameterOrder": [ "name" ], "request": { "$ref": "CancelOperationRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/operations/{operationsId}:cancel", "parameters": { "name": { "description": "The name of the operation resource to be cancelled.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/operations/[^/]+$", "required": true } } } } }, "teamFolders": { "methods": { "delete": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Required. The TeamFolder's name." } }, "parameterOrder": [ "name" ], "id": "dataform.projects.locations.teamFolders.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "description": "Deletes a single TeamFolder.", "response": { "$ref": "Empty" } }, "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.", "httpMethod": "GET", "id": "dataform.projects.locations.teamFolders.getIamPolicy", "path": "v1beta1/{+resource}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "resource" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:getIamPolicy", "parameters": { "resource": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "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.", "location": "path" }, "options.requestedPolicyVersion": { "location": "query", "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).", "format": "int32", "type": "integer" } } }, "setIamPolicy": { "httpMethod": "POST", "id": "dataform.projects.locations.teamFolders.setIamPolicy", "path": "v1beta1/{+resource}:setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "response": { "$ref": "Policy" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:setIamPolicy", "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.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$" } }, "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" } }, "deleteTree": { "parameterOrder": [ "name" ], "request": { "$ref": "DeleteTeamFolderTreeRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:deleteTree", "parameters": { "name": { "description": "Required. The TeamFolder's name. Format: projects/{project}/locations/{location}/teamFolders/{team_folder}", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$" } }, "response": { "$ref": "Operation" }, "description": "Deletes a TeamFolder with its contents (Folders, Repositories, Workspaces, ReleaseConfigs, and WorkflowConfigs).", "httpMethod": "POST", "id": "dataform.projects.locations.teamFolders.deleteTree", "path": "v1beta1/{+name}:deleteTree", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "queryContents": { "parameterOrder": [ "teamFolder" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:queryContents", "parameters": { "orderBy": { "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\"`", "type": "string" }, "pageToken": { "type": "string", "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.", "location": "query" }, "pageSize": { "location": "query", "description": "Optional. Maximum number of paths to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "format": "int32", "type": "integer" }, "filter": { "type": "string", "description": "Optional. Optional filtering for the returned list. Filtering is currently only supported on the `display_name` field. Example: * `filter=\"display_name=\"MyFolder\"\"`", "location": "query" }, "teamFolder": { "description": "Required. Resource name of the TeamFolder to list contents for. Format: `projects/*/locations/*/teamFolders/*`.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$" } }, "httpMethod": "GET", "id": "dataform.projects.locations.teamFolders.queryContents", "path": "v1beta1/{+teamFolder}:queryContents", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "QueryTeamFolderContentsResponse" }, "description": "Returns the contents of a given TeamFolder." }, "search": { "response": { "$ref": "SearchTeamFoldersResponse" }, "description": "Returns all TeamFolders in a given location that the caller has access to and match the provided filter.", "id": "dataform.projects.locations.teamFolders.search", "path": "v1beta1/{+location}/teamFolders:search", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "location" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders:search", "parameters": { "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\"\"`" }, "pageSize": { "location": "query", "description": "Optional. Maximum number of TeamFolders to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "format": "int32", "type": "integer" }, "location": { "description": "Required. Location in which to query TeamFolders. Format: `projects/*/locations/*`.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$", "required": true }, "orderBy": { "type": "string", "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\"`", "location": "query" }, "pageToken": { "type": "string", "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.", "location": "query" } } }, "get": { "id": "dataform.projects.locations.teamFolders.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "TeamFolder" }, "description": "Fetches a single TeamFolder.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}", "parameters": { "name": { "description": "Required. The TeamFolder's name.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$" } } }, "patch": { "httpMethod": "PATCH", "id": "dataform.projects.locations.teamFolders.patch", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "TeamFolder" }, "description": "Updates a single TeamFolder.", "parameterOrder": [ "name" ], "request": { "$ref": "TeamFolder" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}", "parameters": { "updateMask": { "type": "string", "format": "google-fieldmask", "description": "Optional. Specifies the fields to be updated in the Folder. If left unset, all fields will be updated.", "location": "query" }, "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "type": "string", "location": "path", "description": "Identifier. The TeamFolder's name." } } }, "create": { "response": { "$ref": "TeamFolder" }, "description": "Creates a new TeamFolder in a given project and location.", "id": "dataform.projects.locations.teamFolders.create", "path": "v1beta1/{+parent}/teamFolders", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameterOrder": [ "parent" ], "request": { "$ref": "TeamFolder" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders", "parameters": { "teamFolderId": { "type": "string", "deprecated": true, "description": "Deprecated: This field is not used. The resource name is generated automatically. The ID to use for the TeamFolder, which will become the final component of the TeamFolder's resource name.", "location": "query" }, "parent": { "location": "path", "description": "Required. The location in which to create the TeamFolder. Must be in the format `projects/*/locations/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string" } } }, "testIamPermissions": { "parameterOrder": [ "resource" ], "request": { "$ref": "TestIamPermissionsRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/teamFolders/{teamFoldersId}:testIamPermissions", "parameters": { "resource": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/teamFolders/[^/]+$", "type": "string", "location": "path", "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." } }, "httpMethod": "POST", "id": "dataform.projects.locations.teamFolders.testIamPermissions", "path": "v1beta1/{+resource}:testIamPermissions", "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." } } }, "repositories": { "methods": { "get": { "response": { "$ref": "Repository" }, "description": "Fetches a single Repository.", "id": "dataform.projects.locations.repositories.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}", "parameters": { "name": { "location": "path", "description": "Required. The repository's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string", "required": true } } }, "move": { "httpMethod": "POST", "id": "dataform.projects.locations.repositories.move", "path": "v1beta1/{+name}:move", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Moves a Repository to a new location.", "response": { "$ref": "Operation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:move", "parameters": { "name": { "description": "Required. The full resource name of the repository to move.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true } }, "parameterOrder": [ "name" ], "request": { "$ref": "MoveRepositoryRequest" } }, "delete": { "id": "dataform.projects.locations.repositories.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "description": "Deletes a single Repository.", "response": { "$ref": "Empty" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}", "parameters": { "name": { "description": "Required. The repository's name.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$" }, "force": { "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", "type": "boolean" } }, "parameterOrder": [ "name" ] }, "setIamPolicy": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:setIamPolicy", "parameters": { "resource": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string", "location": "path", "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." } }, "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" }, "description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.", "response": { "$ref": "Policy" }, "id": "dataform.projects.locations.repositories.setIamPolicy", "path": "v1beta1/{+resource}:setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST" }, "computeAccessTokenStatus": { "response": { "$ref": "ComputeRepositoryAccessTokenStatusResponse" }, "description": "Computes a Repository's Git access token status.", "id": "dataform.projects.locations.repositories.computeAccessTokenStatus", "path": "v1beta1/{+name}:computeAccessTokenStatus", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:computeAccessTokenStatus", "parameters": { "name": { "description": "Required. The repository's name.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$" } } }, "fetchHistory": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:fetchHistory", "parameters": { "name": { "description": "Required. The repository's name.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true }, "pageSize": { "format": "int32", "type": "integer", "location": "query", "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." }, "pageToken": { "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.", "type": "string" } }, "response": { "$ref": "FetchRepositoryHistoryResponse" }, "description": "Fetches a Repository's history of commits. The Repository must not have a value for `git_remote_settings.url`.", "httpMethod": "GET", "id": "dataform.projects.locations.repositories.fetchHistory", "path": "v1beta1/{+name}:fetchHistory", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "create": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories", "parameters": { "parent": { "description": "Required. The location in which to create the repository. Must be in the format `projects/*/locations/*`.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "repositoryId": { "description": "Required. The ID to use for the repository, which will become the final component of the repository's resource name.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "Repository" }, "id": "dataform.projects.locations.repositories.create", "path": "v1beta1/{+parent}/repositories", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "description": "Creates a new Repository in a given project and location.", "response": { "$ref": "Repository" } }, "readFile": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:readFile", "parameters": { "name": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "description": "Required. The repository's name.", "location": "path" }, "path": { "description": "Required. Full file path to read including filename, from repository root.", "location": "query", "type": "string" }, "commitSha": { "description": "Optional. The commit SHA for the commit to read from. If unset, the file will be read from HEAD.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ], "httpMethod": "GET", "id": "dataform.projects.locations.repositories.readFile", "path": "v1beta1/{+name}:readFile", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Returns the contents of a file (inside a Repository). The Repository must not have a value for `git_remote_settings.url`.", "response": { "$ref": "ReadRepositoryFileResponse" } }, "testIamPermissions": { "id": "dataform.projects.locations.repositories.testIamPermissions", "path": "v1beta1/{+resource}:testIamPermissions", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "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.", "response": { "$ref": "TestIamPermissionsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:testIamPermissions", "parameters": { "resource": { "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.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$" } }, "parameterOrder": [ "resource" ], "request": { "$ref": "TestIamPermissionsRequest" } }, "commit": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:commit", "parameters": { "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string", "location": "path", "description": "Required. The repository's name." } }, "parameterOrder": [ "name" ], "request": { "$ref": "CommitRepositoryChangesRequest" }, "httpMethod": "POST", "id": "dataform.projects.locations.repositories.commit", "path": "v1beta1/{+name}:commit", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Applies a Git commit to a Repository. The Repository must not have a value for `git_remote_settings.url`.", "response": { "$ref": "CommitRepositoryChangesResponse" } }, "patch": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}", "parameters": { "name": { "location": "path", "description": "Identifier. The repository's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string", "required": true }, "updateMask": { "location": "query", "description": "Optional. Specifies the fields to be updated in the repository. If left unset, all fields will be updated.", "format": "google-fieldmask", "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$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.*", "response": { "$ref": "Repository" }, "id": "dataform.projects.locations.repositories.patch", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH" }, "getIamPolicy": { "id": "dataform.projects.locations.repositories.getIamPolicy", "path": "v1beta1/{+resource}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.", "response": { "$ref": "Policy" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:getIamPolicy", "parameters": { "options.requestedPolicyVersion": { "format": "int32", "type": "integer", "location": "query", "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)." }, "resource": { "location": "path", "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.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string" } }, "parameterOrder": [ "resource" ] }, "fetchRemoteBranches": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:fetchRemoteBranches", "parameters": { "name": { "description": "Required. The repository's name.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true } }, "parameterOrder": [ "name" ], "description": "Fetches a Repository's remote branches.", "response": { "$ref": "FetchRemoteBranchesResponse" }, "id": "dataform.projects.locations.repositories.fetchRemoteBranches", "path": "v1beta1/{+name}:fetchRemoteBranches", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "queryDirectoryContents": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}:queryDirectoryContents", "parameters": { "name": { "location": "path", "description": "Required. The repository's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string", "required": true }, "path": { "description": "Optional. The directory's full path including directory name, relative to root. If left unset, the root is used.", "location": "query", "type": "string" }, "commitSha": { "type": "string", "location": "query", "description": "Optional. The Commit SHA for the commit to query from. If unset, the directory will be queried from HEAD." }, "pageToken": { "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.", "type": "string" }, "pageSize": { "location": "query", "description": "Optional. Maximum number of paths to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "format": "int32", "type": "integer" } }, "parameterOrder": [ "name" ], "description": "Returns the contents of a given Repository directory. The Repository must not have a value for `git_remote_settings.url`.", "response": { "$ref": "QueryRepositoryDirectoryContentsResponse" }, "httpMethod": "GET", "id": "dataform.projects.locations.repositories.queryDirectoryContents", "path": "v1beta1/{+name}:queryDirectoryContents", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "list": { "httpMethod": "GET", "id": "dataform.projects.locations.repositories.list", "path": "v1beta1/{+parent}/repositories", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "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)*.", "response": { "$ref": "ListRepositoriesResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories", "parameters": { "filter": { "location": "query", "description": "Optional. Filter for the returned list.", "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Required. The location in which to list repositories. Must be in the format `projects/*/locations/*`." }, "pageSize": { "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.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "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.", "type": "string" }, "orderBy": { "type": "string", "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." } }, "parameterOrder": [ "parent" ] } }, "resources": { "releaseConfigs": { "methods": { "list": { "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs", "parameters": { "parent": { "location": "path", "description": "Required. The repository in which to list release configs. Must be in the format `projects/*/locations/*/repositories/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string" }, "pageSize": { "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.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "type": "string", "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." } }, "response": { "$ref": "ListReleaseConfigsResponse" }, "description": "Lists ReleaseConfigs in a given Repository.", "id": "dataform.projects.locations.repositories.releaseConfigs.list", "path": "v1beta1/{+parent}/releaseConfigs", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "get": { "description": "Fetches a single ReleaseConfig.", "response": { "$ref": "ReleaseConfig" }, "httpMethod": "GET", "id": "dataform.projects.locations.repositories.releaseConfigs.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs/{releaseConfigsId}", "parameters": { "name": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/releaseConfigs/[^/]+$", "description": "Required. The release config's name.", "location": "path" } }, "parameterOrder": [ "name" ] }, "patch": { "parameterOrder": [ "name" ], "request": { "$ref": "ReleaseConfig" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs/{releaseConfigsId}", "parameters": { "name": { "location": "path", "description": "Identifier. The release config's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/releaseConfigs/[^/]+$", "type": "string", "required": true }, "updateMask": { "description": "Optional. Specifies the fields to be updated in the release config. If left unset, all fields will be updated.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "id": "dataform.projects.locations.repositories.releaseConfigs.patch", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "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.*" }, "delete": { "httpMethod": "DELETE", "id": "dataform.projects.locations.repositories.releaseConfigs.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Empty" }, "description": "Deletes a single ReleaseConfig.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs/{releaseConfigsId}", "parameters": { "name": { "location": "path", "description": "Required. The release config's name.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/releaseConfigs/[^/]+$", "type": "string" } } }, "create": { "description": "Creates a new ReleaseConfig in a given Repository.", "response": { "$ref": "ReleaseConfig" }, "id": "dataform.projects.locations.repositories.releaseConfigs.create", "path": "v1beta1/{+parent}/releaseConfigs", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/releaseConfigs", "parameters": { "parent": { "location": "path", "description": "Required. The repository in which to create the release config. Must be in the format `projects/*/locations/*/repositories/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string", "required": true }, "releaseConfigId": { "description": "Required. The ID to use for the release config, which will become the final component of the release config's resource name.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "ReleaseConfig" } } } }, "workspaces": { "methods": { "removeDirectory": { "description": "Deletes a directory (inside a Workspace) and all of its contents.", "response": { "$ref": "RemoveDirectoryResponse" }, "id": "dataform.projects.locations.repositories.workspaces.removeDirectory", "path": "v1beta1/{+workspace}:removeDirectory", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:removeDirectory", "parameters": { "workspace": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Required. The workspace's name." } }, "parameterOrder": [ "workspace" ], "request": { "$ref": "RemoveDirectoryRequest" } }, "reset": { "parameterOrder": [ "name" ], "request": { "$ref": "ResetWorkspaceChangesRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:reset", "parameters": { "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string", "location": "path", "description": "Required. The workspace's name." } }, "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workspaces.reset", "path": "v1beta1/{+name}:reset", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "ResetWorkspaceChangesResponse" }, "description": "Performs a Git reset for uncommitted files in a Workspace." }, "get": { "description": "Fetches a single Workspace.", "response": { "$ref": "Workspace" }, "httpMethod": "GET", "id": "dataform.projects.locations.repositories.workspaces.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}", "parameters": { "name": { "location": "path", "description": "Required. The workspace's name.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string" } }, "parameterOrder": [ "name" ] }, "push": { "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workspaces.push", "path": "v1beta1/{+name}:push", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "PushGitCommitsResponse" }, "description": "Pushes Git commits from a Workspace to the Repository's remote.", "parameterOrder": [ "name" ], "request": { "$ref": "PushGitCommitsRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:push", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name.", "location": "path" } } }, "delete": { "response": { "$ref": "Empty" }, "description": "Deletes a single Workspace.", "id": "dataform.projects.locations.repositories.workspaces.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Required. The workspace resource's name." } } }, "setIamPolicy": { "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:setIamPolicy", "parameters": { "resource": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string", "location": "path", "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." } }, "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workspaces.setIamPolicy", "path": "v1beta1/{+resource}:setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "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.", "id": "dataform.projects.locations.repositories.workspaces.makeDirectory", "path": "v1beta1/{+workspace}:makeDirectory", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameterOrder": [ "workspace" ], "request": { "$ref": "MakeDirectoryRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:makeDirectory", "parameters": { "workspace": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "description": "Required. The workspace's name.", "location": "path" } } }, "installNpmPackages": { "parameterOrder": [ "workspace" ], "request": { "$ref": "InstallNpmPackagesRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:installNpmPackages", "parameters": { "workspace": { "location": "path", "description": "Required. The workspace's name.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string" } }, "response": { "$ref": "InstallNpmPackagesResponse" }, "description": "Installs dependency NPM packages (inside a Workspace).", "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workspaces.installNpmPackages", "path": "v1beta1/{+workspace}:installNpmPackages", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "fetchFileGitStatuses": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:fetchFileGitStatuses", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true, "description": "Required. The workspace's name.", "location": "path" } }, "response": { "$ref": "FetchFileGitStatusesResponse" }, "description": "Fetches Git statuses for the files in a Workspace.", "id": "dataform.projects.locations.repositories.workspaces.fetchFileGitStatuses", "path": "v1beta1/{+name}:fetchFileGitStatuses", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "fetchFileDiff": { "httpMethod": "GET", "id": "dataform.projects.locations.repositories.workspaces.fetchFileDiff", "path": "v1beta1/{+workspace}:fetchFileDiff", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Fetches Git diff for an uncommitted file in a Workspace.", "response": { "$ref": "FetchFileDiffResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:fetchFileDiff", "parameters": { "path": { "type": "string", "location": "query", "description": "Required. The file's full path including filename, relative to the workspace root." }, "workspace": { "location": "path", "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string", "required": true } }, "parameterOrder": [ "workspace" ] }, "fetchGitAheadBehind": { "id": "dataform.projects.locations.repositories.workspaces.fetchGitAheadBehind", "path": "v1beta1/{+name}:fetchGitAheadBehind", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "description": "Fetches Git ahead/behind against a remote branch.", "response": { "$ref": "FetchGitAheadBehindResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:fetchGitAheadBehind", "parameters": { "name": { "description": "Required. The workspace's name.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true }, "remoteBranch": { "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.", "location": "query", "type": "string" } }, "parameterOrder": [ "name" ] }, "create": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces", "parameters": { "workspaceId": { "description": "Required. The ID to use for the workspace, which will become the final component of the workspace's resource name.", "location": "query", "type": "string" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The repository in which to create the workspace. Must be in the format `projects/*/locations/*/repositories/*`.", "location": "path" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "Workspace" }, "description": "Creates a new Workspace in a given Repository.", "response": { "$ref": "Workspace" }, "id": "dataform.projects.locations.repositories.workspaces.create", "path": "v1beta1/{+parent}/workspaces", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST" }, "readFile": { "response": { "$ref": "ReadFileResponse" }, "description": "Returns the contents of a file (inside a Workspace).", "httpMethod": "GET", "id": "dataform.projects.locations.repositories.workspaces.readFile", "path": "v1beta1/{+workspace}:readFile", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "workspace" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:readFile", "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/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Required. The workspace's name." }, "revision": { "type": "string", "description": "Optional. The Git revision of the file to return. If left empty, the current contents of `path` will be returned.", "location": "query" } } }, "testIamPermissions": { "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workspaces.testIamPermissions", "path": "v1beta1/{+resource}:testIamPermissions", "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.", "parameterOrder": [ "resource" ], "request": { "$ref": "TestIamPermissionsRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:testIamPermissions", "parameters": { "resource": { "location": "path", "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/[^/]+$", "type": "string", "required": true } } }, "commit": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:commit", "parameters": { "name": { "location": "path", "description": "Required. The workspace's name.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "CommitWorkspaceChangesRequest" }, "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workspaces.commit", "path": "v1beta1/{+name}:commit", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Applies a Git commit for uncommitted files in a Workspace.", "response": { "$ref": "CommitWorkspaceChangesResponse" } }, "moveDirectory": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:moveDirectory", "parameters": { "workspace": { "description": "Required. The workspace's name.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true } }, "parameterOrder": [ "workspace" ], "request": { "$ref": "MoveDirectoryRequest" }, "description": "Moves a directory (inside a Workspace), and all of its contents, to a new location.", "response": { "$ref": "MoveDirectoryResponse" }, "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workspaces.moveDirectory", "path": "v1beta1/{+workspace}:moveDirectory", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "getIamPolicy": { "parameterOrder": [ "resource" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:getIamPolicy", "parameters": { "resource": { "location": "path", "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/[^/]+$", "type": "string", "required": true }, "options.requestedPolicyVersion": { "location": "query", "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).", "format": "int32", "type": "integer" } }, "httpMethod": "GET", "id": "dataform.projects.locations.repositories.workspaces.getIamPolicy", "path": "v1beta1/{+resource}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "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." }, "searchFiles": { "response": { "$ref": "SearchFilesResponse" }, "description": "Finds the contents of a given Workspace directory by filter.", "id": "dataform.projects.locations.repositories.workspaces.searchFiles", "path": "v1beta1/{+workspace}:searchFiles", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameterOrder": [ "workspace" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:searchFiles", "parameters": { "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" }, "workspace": { "location": "path", "description": "Required. The workspace's name.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string" }, "pageSize": { "location": "query", "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.", "format": "int32", "type": "integer" }, "filter": { "type": "string", "location": "query", "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." } } }, "moveFile": { "parameterOrder": [ "workspace" ], "request": { "$ref": "MoveFileRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:moveFile", "parameters": { "workspace": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Required. The workspace's name." } }, "response": { "$ref": "MoveFileResponse" }, "description": "Moves a file (inside a Workspace) to a new location.", "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workspaces.moveFile", "path": "v1beta1/{+workspace}:moveFile", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "writeFile": { "response": { "$ref": "WriteFileResponse" }, "description": "Writes to a file (inside a Workspace).", "id": "dataform.projects.locations.repositories.workspaces.writeFile", "path": "v1beta1/{+workspace}:writeFile", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameterOrder": [ "workspace" ], "request": { "$ref": "WriteFileRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:writeFile", "parameters": { "workspace": { "description": "Required. The workspace's name.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "required": true } } }, "queryDirectoryContents": { "httpMethod": "GET", "id": "dataform.projects.locations.repositories.workspaces.queryDirectoryContents", "path": "v1beta1/{+workspace}:queryDirectoryContents", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Returns the contents of a given Workspace directory.", "response": { "$ref": "QueryDirectoryContentsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:queryDirectoryContents", "parameters": { "workspace": { "location": "path", "description": "Required. The workspace's name.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "type": "string", "required": true }, "pageSize": { "location": "query", "description": "Optional. Maximum number of paths to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "format": "int32", "type": "integer" }, "view": { "type": "string", "enum": [ "DIRECTORY_CONTENTS_VIEW_UNSPECIFIED", "DIRECTORY_CONTENTS_VIEW_BASIC", "DIRECTORY_CONTENTS_VIEW_METADATA" ], "location": "query", "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." ], "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." }, "path": { "type": "string", "location": "query", "description": "Optional. The directory's full path including directory name, relative to the workspace root. If left unset, the workspace root is used." }, "pageToken": { "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.", "location": "query", "type": "string" } }, "parameterOrder": [ "workspace" ] }, "list": { "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces", "parameters": { "orderBy": { "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", "type": "string" }, "pageToken": { "location": "query", "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.", "type": "string" }, "filter": { "type": "string", "location": "query", "description": "Optional. Filter for the returned list." }, "parent": { "description": "Required. The repository in which to list workspaces. Must be in the format `projects/*/locations/*/repositories/*`.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true }, "pageSize": { "location": "query", "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.", "format": "int32", "type": "integer" } }, "id": "dataform.projects.locations.repositories.workspaces.list", "path": "v1beta1/{+parent}/workspaces", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "ListWorkspacesResponse" }, "description": "Lists Workspaces in a given Repository." }, "pull": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:pull", "parameters": { "name": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "description": "Required. The workspace's name.", "location": "path" } }, "parameterOrder": [ "name" ], "request": { "$ref": "PullGitCommitsRequest" }, "id": "dataform.projects.locations.repositories.workspaces.pull", "path": "v1beta1/{+name}:pull", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "description": "Pulls Git commits from the Repository's remote into a Workspace.", "response": { "$ref": "PullGitCommitsResponse" } }, "removeFile": { "response": { "$ref": "RemoveFileResponse" }, "description": "Deletes a file (inside a Workspace).", "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workspaces.removeFile", "path": "v1beta1/{+workspace}:removeFile", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "workspace" ], "request": { "$ref": "RemoveFileRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workspaces/{workspacesId}:removeFile", "parameters": { "workspace": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workspaces/[^/]+$", "description": "Required. The workspace's name.", "location": "path" } } } } }, "workflowConfigs": { "methods": { "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs", "parameters": { "pageToken": { "type": "string", "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." }, "parent": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "description": "Required. The repository in which to list workflow configs. Must be in the format `projects/*/locations/*/repositories/*`.", "location": "path" }, "pageSize": { "location": "query", "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.", "format": "int32", "type": "integer" } }, "parameterOrder": [ "parent" ], "httpMethod": "GET", "id": "dataform.projects.locations.repositories.workflowConfigs.list", "path": "v1beta1/{+parent}/workflowConfigs", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Lists WorkflowConfigs in a given Repository.", "response": { "$ref": "ListWorkflowConfigsResponse" } }, "get": { "httpMethod": "GET", "id": "dataform.projects.locations.repositories.workflowConfigs.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "WorkflowConfig" }, "description": "Fetches a single WorkflowConfig.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs/{workflowConfigsId}", "parameters": { "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowConfigs/[^/]+$", "type": "string", "location": "path", "description": "Required. The workflow config's name." } } }, "patch": { "id": "dataform.projects.locations.repositories.workflowConfigs.patch", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "PATCH", "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.*", "response": { "$ref": "WorkflowConfig" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs/{workflowConfigsId}", "parameters": { "name": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowConfigs/[^/]+$", "description": "Identifier. The workflow config's name.", "location": "path" }, "updateMask": { "location": "query", "description": "Optional. Specifies the fields to be updated in the workflow config. If left unset, all fields will be updated.", "format": "google-fieldmask", "type": "string" } }, "parameterOrder": [ "name" ], "request": { "$ref": "WorkflowConfig" } }, "create": { "response": { "$ref": "WorkflowConfig" }, "description": "Creates a new WorkflowConfig in a given Repository.", "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workflowConfigs.create", "path": "v1beta1/{+parent}/workflowConfigs", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "parent" ], "request": { "$ref": "WorkflowConfig" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs", "parameters": { "workflowConfigId": { "location": "query", "description": "Required. The ID to use for the workflow config, which will become the final component of the workflow config's resource name.", "type": "string" }, "parent": { "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Required. The repository in which to create the workflow config. Must be in the format `projects/*/locations/*/repositories/*`." } } }, "delete": { "description": "Deletes a single WorkflowConfig.", "response": { "$ref": "Empty" }, "id": "dataform.projects.locations.repositories.workflowConfigs.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "DELETE", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowConfigs/{workflowConfigsId}", "parameters": { "name": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowConfigs/[^/]+$", "description": "Required. The workflow config's name.", "location": "path" } }, "parameterOrder": [ "name" ] } } }, "workflowInvocations": { "methods": { "create": { "parameterOrder": [ "parent" ], "request": { "$ref": "WorkflowInvocation" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations", "parameters": { "parent": { "location": "path", "description": "Required. The repository in which to create the workflow invocation. Must be in the format `projects/*/locations/*/repositories/*`.", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string", "required": true } }, "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workflowInvocations.create", "path": "v1beta1/{+parent}/workflowInvocations", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "WorkflowInvocation" }, "description": "Creates a new WorkflowInvocation in a given Repository." }, "query": { "id": "dataform.projects.locations.repositories.workflowInvocations.query", "path": "v1beta1/{+name}:query", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "QueryWorkflowInvocationActionsResponse" }, "description": "Returns WorkflowInvocationActions in a given WorkflowInvocation.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations/{workflowInvocationsId}:query", "parameters": { "name": { "description": "Required. The workflow invocation's name.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowInvocations/[^/]+$" }, "pageSize": { "type": "integer", "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.", "location": "query" }, "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" } } }, "delete": { "description": "Deletes a single WorkflowInvocation.", "response": { "$ref": "Empty" }, "httpMethod": "DELETE", "id": "dataform.projects.locations.repositories.workflowInvocations.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations/{workflowInvocationsId}", "parameters": { "name": { "description": "Required. The workflow invocation resource's name.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowInvocations/[^/]+$" } }, "parameterOrder": [ "name" ] }, "list": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations", "parameters": { "parent": { "location": "path", "description": "Required. The parent resource of the WorkflowInvocation type. Must be in the format `projects/*/locations/*/repositories/*`.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "type": "string" }, "pageSize": { "location": "query", "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.", "format": "int32", "type": "integer" }, "filter": { "location": "query", "description": "Optional. Filter for the returned list.", "type": "string" }, "orderBy": { "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", "type": "string" }, "pageToken": { "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", "type": "string" } }, "parameterOrder": [ "parent" ], "description": "Lists WorkflowInvocations in a given Repository.", "response": { "$ref": "ListWorkflowInvocationsResponse" }, "httpMethod": "GET", "id": "dataform.projects.locations.repositories.workflowInvocations.list", "path": "v1beta1/{+parent}/workflowInvocations", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] }, "cancel": { "description": "Requests cancellation of a running WorkflowInvocation.", "response": { "$ref": "CancelWorkflowInvocationResponse" }, "httpMethod": "POST", "id": "dataform.projects.locations.repositories.workflowInvocations.cancel", "path": "v1beta1/{+name}:cancel", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations/{workflowInvocationsId}:cancel", "parameters": { "name": { "description": "Required. The workflow invocation resource's name.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowInvocations/[^/]+$" } }, "parameterOrder": [ "name" ], "request": { "$ref": "CancelWorkflowInvocationRequest" } }, "get": { "description": "Fetches a single WorkflowInvocation.", "response": { "$ref": "WorkflowInvocation" }, "httpMethod": "GET", "id": "dataform.projects.locations.repositories.workflowInvocations.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/workflowInvocations/{workflowInvocationsId}", "parameters": { "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/workflowInvocations/[^/]+$", "type": "string", "location": "path", "description": "Required. The workflow invocation resource's name." } }, "parameterOrder": [ "name" ] } } }, "compilationResults": { "methods": { "get": { "httpMethod": "GET", "id": "dataform.projects.locations.repositories.compilationResults.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Fetches a single CompilationResult.", "response": { "$ref": "CompilationResult" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/compilationResults/{compilationResultsId}", "parameters": { "name": { "location": "path", "description": "Required. The compilation result's name.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/compilationResults/[^/]+$", "type": "string" } }, "parameterOrder": [ "name" ] }, "list": { "id": "dataform.projects.locations.repositories.compilationResults.list", "path": "v1beta1/{+parent}/compilationResults", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "response": { "$ref": "ListCompilationResultsResponse" }, "description": "Lists CompilationResults in a given Repository.", "parameterOrder": [ "parent" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/compilationResults", "parameters": { "filter": { "location": "query", "description": "Optional. Filter for the returned list.", "type": "string" }, "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The repository in which to list compilation results. Must be in the format `projects/*/locations/*/repositories/*`.", "location": "path" }, "pageSize": { "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", "type": "integer", "format": "int32" }, "orderBy": { "type": "string", "location": "query", "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." }, "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" } } }, "create": { "parameterOrder": [ "parent" ], "request": { "$ref": "CompilationResult" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/compilationResults", "parameters": { "parent": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+$", "required": true, "description": "Required. The repository in which to create the compilation result. Must be in the format `projects/*/locations/*/repositories/*`.", "location": "path" } }, "id": "dataform.projects.locations.repositories.compilationResults.create", "path": "v1beta1/{+parent}/compilationResults", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "response": { "$ref": "CompilationResult" }, "description": "Creates a new CompilationResult in a given project and location." }, "query": { "description": "Returns CompilationResultActions in a given CompilationResult.", "response": { "$ref": "QueryCompilationResultActionsResponse" }, "id": "dataform.projects.locations.repositories.compilationResults.query", "path": "v1beta1/{+name}:query", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/repositories/{repositoriesId}/compilationResults/{compilationResultsId}:query", "parameters": { "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." }, "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/repositories/[^/]+/compilationResults/[^/]+$", "type": "string", "location": "path", "description": "Required. The compilation result's name." }, "pageSize": { "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", "type": "integer", "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." } }, "parameterOrder": [ "name" ] } } } } }, "folders": { "methods": { "delete": { "httpMethod": "DELETE", "id": "dataform.projects.locations.folders.delete", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "Empty" }, "description": "Deletes a single Folder.", "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}", "parameters": { "name": { "description": "Required. The Folder's name.", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true } } }, "getIamPolicy": { "httpMethod": "GET", "id": "dataform.projects.locations.folders.getIamPolicy", "path": "v1beta1/{+resource}:getIamPolicy", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "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.", "parameterOrder": [ "resource" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:getIamPolicy", "parameters": { "options.requestedPolicyVersion": { "format": "int32", "type": "integer", "location": "query", "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)." }, "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.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$" } } }, "setIamPolicy": { "httpMethod": "POST", "id": "dataform.projects.locations.folders.setIamPolicy", "path": "v1beta1/{+resource}:setIamPolicy", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "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.", "parameterOrder": [ "resource" ], "request": { "$ref": "SetIamPolicyRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:setIamPolicy", "parameters": { "resource": { "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "type": "string", "required": true, "location": "path", "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." } } }, "create": { "httpMethod": "POST", "id": "dataform.projects.locations.folders.create", "path": "v1beta1/{+parent}/folders", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "description": "Creates a new Folder in a given project and location.", "response": { "$ref": "Folder" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders", "parameters": { "folderId": { "description": "Deprecated: This field is not used. The resource name is generated automatically. The ID to use for the Folder, which will become the final component of the Folder's resource name.", "location": "query", "type": "string", "deprecated": true }, "parent": { "description": "Required. The location in which to create the Folder. Must be in the format `projects/*/locations/*`.", "location": "path", "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+$" } }, "parameterOrder": [ "parent" ], "request": { "$ref": "Folder" } }, "testIamPermissions": { "id": "dataform.projects.locations.folders.testIamPermissions", "path": "v1beta1/{+resource}:testIamPermissions", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "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.", "response": { "$ref": "TestIamPermissionsResponse" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:testIamPermissions", "parameters": { "resource": { "location": "path", "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.", "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "type": "string" } }, "parameterOrder": [ "resource" ], "request": { "$ref": "TestIamPermissionsRequest" } }, "deleteTree": { "response": { "$ref": "Operation" }, "description": "Deletes a Folder with its contents (Folders, Repositories, Workspaces, ReleaseConfigs, and WorkflowConfigs).", "httpMethod": "POST", "id": "dataform.projects.locations.folders.deleteTree", "path": "v1beta1/{+name}:deleteTree", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "parameterOrder": [ "name" ], "request": { "$ref": "DeleteFolderTreeRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:deleteTree", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "type": "string", "required": true, "location": "path", "description": "Required. The Folder's name. Format: projects/{project}/locations/{location}/folders/{folder}" } } }, "queryFolderContents": { "parameterOrder": [ "folder" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:queryFolderContents", "parameters": { "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." }, "folder": { "description": "Required. Resource name of the Folder to list contents for. Format: projects/*/locations/*/folders/*", "location": "path", "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true }, "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": { "location": "query", "description": "Optional. Maximum number of paths to return. The server may return fewer items than requested. If unspecified, the server will pick an appropriate default.", "format": "int32", "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\"\"`" } }, "response": { "$ref": "QueryFolderContentsResponse" }, "description": "Returns the contents of a given Folder.", "id": "dataform.projects.locations.folders.queryFolderContents", "path": "v1beta1/{+folder}:queryFolderContents", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "move": { "response": { "$ref": "Operation" }, "description": "Moves a Folder to a new Folder, TeamFolder, or the root location.", "id": "dataform.projects.locations.folders.move", "path": "v1beta1/{+name}:move", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "POST", "parameterOrder": [ "name" ], "request": { "$ref": "MoveFolderRequest" }, "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}:move", "parameters": { "name": { "required": true, "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "type": "string", "location": "path", "description": "Required. The full resource name of the Folder to move." } } }, "get": { "parameterOrder": [ "name" ], "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}", "parameters": { "name": { "required": true, "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "description": "Required. The Folder's name.", "location": "path" } }, "response": { "$ref": "Folder" }, "description": "Fetches a single Folder.", "id": "dataform.projects.locations.folders.get", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET" }, "patch": { "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/folders/{foldersId}", "parameters": { "name": { "type": "string", "pattern": "^projects/[^/]+/locations/[^/]+/folders/[^/]+$", "required": true, "description": "Identifier. The Folder's name.", "location": "path" }, "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", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "name" ], "request": { "$ref": "Folder" }, "description": "Updates a single Folder.", "response": { "$ref": "Folder" }, "httpMethod": "PATCH", "id": "dataform.projects.locations.folders.patch", "path": "v1beta1/{+name}", "scopes": [ "https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform" ] } } } } } } } }, "id": "dataform:v1beta1", "version_module": true, "discoveryVersion": "v1", "kind": "discovery#restDescription", "documentationLink": "https://cloud.google.com/dataform/docs", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/bigquery": { "description": "View and manage your data in Google BigQuery and see the email address for your Google Account" }, "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." } } } }, "baseUrl": "https://dataform.googleapis.com/", "ownerDomain": "google.com", "description": "Service to develop, version control, and operationalize SQL pipelines in BigQuery.", "fullyEncodeReservedExpansion": true, "batchPath": "batch", "version": "v1beta1", "title": "Dataform API", "name": "dataform", "revision": "20260421", "parameters": { "quotaUser": { "type": "string", "location": "query", "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." }, "access_token": { "location": "query", "description": "OAuth access token.", "type": "string" }, "prettyPrint": { "type": "boolean", "default": "true", "location": "query", "description": "Returns response with indentations and line breaks." }, "callback": { "type": "string", "location": "query", "description": "JSONP" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "$.xgafv": { "description": "V1 error format.", "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query", "type": "string", "enum": [ "1", "2" ] }, "alt": { "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "location": "query", "description": "Data format for response.", "default": "json", "type": "string", "enum": [ "json", "media", "proto" ] }, "key": { "type": "string", "location": "query", "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." }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "oauth_token": { "location": "query", "description": "OAuth 2.0 token for the current user.", "type": "string" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" } }, "servicePath": "" }