---
title: "protectedpath start-prefetch"
slug: "protectedpath-start-prefetch"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/protectedpath-start-prefetch"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# protectedpath start-prefetch

This command is used to prefetch a folder to the cache on a cluster. The cluster must be the destination cluster for a Global Access share of a protected path on a source cluster.

## Usage

```plaintext
vcli: admin> protectedpath start-prefetch --id ID
                                          --path PATH
                                          --prefetch-type TYPE
```

## Required Parameters

| `--id ID` | The Protected Path ID. |
| --- | --- |
| `--path PATH` | The path (file or folder) to prefetch. Example: `/test `or `/test/file.dat` The path on the source cluster is fetched. If the path does not exist on the source, the command fails. |
| `--prefetch-type TYPE` | The type of prefetch to perform. Options: - META_DATA_ONLY. Prefetches only the metadata for the folder and subfolders - FULL. Prefetches the metadata and file data in the folder and subfolders |

## Example

This example prefetches a folder (all the files) to the cache.

```plaintext
vcli: admin> protectedpath start-prefetch --id 123 --path /test --prefetch-type FULL
```