> ## Documentation Index
> Fetch the complete documentation index at: https://vastai-80aa3a82-docs-disable-ssh-password-login.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# VastAI.cloud_copy

Copy files between cloud and instance.

## Signature

```python theme={null}
VastAI.cloud_copy(
    src: str,
    dst: str = '/workspace',
    instance: Optional[str] = None,
    connection: Optional[str] = None,
    transfer: str = 'Instance to Cloud',
    dry_run: bool = False,
    size_only: bool = False,
    ignore_existing: bool = False,
    update: bool = False,
    delete_excluded: bool = False,
    flags: Optional[list] = None
) -> dict
```

## Parameters

<ParamField path="src" type="str" required>
  path to source of object to copy
</ParamField>

<ParamField path="dst" type="str" default="/workspace">
  path to target of copy operation
</ParamField>

<ParamField path="instance" type="Optional[str]">
  id of the instance
</ParamField>

<ParamField path="connection" type="Optional[str]">
  id of cloud connection on your account (get from calling 'vastai show connections')
</ParamField>

<ParamField path="transfer" type="str" default="Instance to Cloud">
  type of transfer, possible options include Instance To Cloud and Cloud To Instance
</ParamField>

<ParamField path="dry_run" type="bool">
  show what would have been transferred
</ParamField>

<ParamField path="size_only" type="bool">
  skip based on size only, not mod-time or checksum
</ParamField>

<ParamField path="ignore_existing" type="bool">
  skip all files that exist on destination
</ParamField>

<ParamField path="update" type="bool">
  skip files that are newer on the destination
</ParamField>

<ParamField path="delete_excluded" type="bool">
  delete files on dest excluded from transfer
</ParamField>

<ParamField path="flags" type="Optional[list]" />

## Returns

`dict`

## Example

```python theme={null}
from vastai import VastAI

client = VastAI(api_key="YOUR_API_KEY")
result = client.cloud_copy(src="value")
print(result)
```