FilesystemService

(-- api-linter: core::0136::http-method=disabled aip.dev/not-precedent: MakeDirectory is a custom method on a singleton resource, not a standard Create method. It uses POST for consistency with other custom methods on the Filesystem singleton. --) (-- api-linter: core::0133::synonyms=disabled aip.dev/not-precedent: MakeDirectory is a custom method on a singleton resource. The "make" verb follows Unix convention (mkdir) and clearly conveys imperative action. --) Creates a directory (similar to Unix mkdir). If the path already exists (including if it's a symbolic link to a directory), returns an error.

Authorization: Only the creator of the parent SandboxEngine is allowed to call this method.

post/v1/{name}/filesystem:makeDirectory

Request

Path parameters

namestring required

Required. The name of the sandbox engine. Format: workspaces/{workspace}/sandboxEngines/{sandbox_engine}

Request body

pathstring required

Required. The path where the directory should be created. All paths are rooted at the sandbox filesystem root. Must start with a forward slash (e.g., "/data", "/workspace/data"). The directory will be created with 0755 permissions (rwxr-xr-x).

createParentDirectoriesboolean

Optional. If true, creates parent directories if they don't exist. If false or unspecified, the operation will fail if parent directories don't exist.

Response

A successful response.

Changes

No recorded changes to this operation across all 1 revision of this API.