> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/guides/guides-fr/configuration-et-migration/migration-massive-de-donnees-vers-shade-via-rclone.md).

# Migration massive de données vers Shade via Rclone

Comment migrer des données vers Shade via Rclone

### Gérer efficacement la migration et le transfert de données

Ce guide explique comment migrer de grandes quantités de données vers votre espace Shade Drive ou depuis celui-ci à l’aide de rclone, un puissant outil open source compatible avec de nombreuses sources différentes.

### Télécharger rclone

Le backend Shade est désormais disponible nativement dans rclone. Vous pouvez télécharger rclone depuis la [page officielle de téléchargement de rclone](https://rclone.org/downloads/).

### À propos de rclone

[rclone](https://rclone.org/) est un puissant programme en ligne de commande permettant de gérer des fichiers sur des services de stockage cloud. Il est souvent décrit comme « rsync pour le stockage cloud » et prend en charge plus de 70 fournisseurs de stockage cloud.

Voici quelques cas d’utilisation courants de rclone :

* **Synchronisation et sauvegarde** de fichiers entre votre système local et un service de stockage cloud
* **Migration de données** d’un fournisseur de stockage cloud à un autre
* **Automatisation des flux de travail** avec des synchronisations et des sauvegardes planifiées
* **Gestion des transferts de fichiers volumineux** avec reprise des transferts et contrôle de la bande passante
* **Opérations par lots** pour copier, déplacer ou supprimer des fichiers entre différents services cloud

Grâce au backend rclone de Shade, vous pouvez exploiter toutes les puissantes fonctionnalités de rclone pour interagir directement avec vos espaces Shade Drive depuis la ligne de commande.

### Configuration

Voici un exemple de configuration de Shade.

Tout d’abord, [créez un compte gratuit](https://app.shade.inc/) et choisissez une offre.

Vous devrez vous connecter et récupérer la `API Key` et le `Drive ID` de votre compte dans les paramètres de celui-ci, ainsi que de l’espace créé, respectivement.

Ouvrez ensuite une invite de commandes ou un terminal, accédez au dossier où vous avez téléchargé le fichier, puis exécutez

`./rclone config`\
\
(Sur Mac, vous devrez autoriser votre ordinateur à exécuter ce fichier. Pour cela, exécutez

`chmod +x rclone` )

Suivez ensuite cette procédure interactive :

```
e) Modifier une connexion distante existante
n) Nouvelle connexion distante
d) Supprimer une connexion distante
r) Renommer une connexion distante
c) Copier une connexion distante
s) Définir un mot de passe de configuration
q) Quitter la configuration
e/n/d/r/c/s/q> n

Saisissez un nom pour la nouvelle connexion distante.
name> Shade

Option Storage.
Type de stockage à configurer.
Choisissez un numéro dans la liste ci-dessous ou saisissez une valeur personnalisée.
(Faites défiler la liste jusqu’à l’option Shade. Au 5 novembre 2025, il s’agit de l’option 52.)
[AUTRES OPTIONS]
xx / Shade FS
   \ (shade)
[AUTRES OPTIONS]
Stockage> xx

Option drive_id.
L’identifiant de votre lecteur, que vous trouverez dans les paramètres du lecteur. Vous devez créer une configuration rclone distincte pour chaque lecteur.
Saisissez une valeur.
drive_id> [YOUR_ID]

Option api_key.
Une clé API pour votre compte.
Saisissez une valeur.
api_key> [YOUR_API_KEY]

Modifier la configuration avancée ?
y) Oui
n) Non (par défaut)
y/n> n

Configuration terminée.
Options :
- type: shade
- drive_id: [YOUR_ID]
- api_key: [YOUR_API_KEY]
Conserver ce remote « Shade » ?
y) Oui, c’est bon (par défaut)
e) Modifier ce remote
d) Supprimer ce remote
y/e/d> y

```

### Exemple de workflow : copier des fichiers vers Shade

Une fois votre remote Shade configuré, vous pouvez facilement copier des fichiers de votre système de fichiers local vers Shade. Voici un workflow courant :

#### Copier un dossier local vers Shade

Pour copier un dossier de votre système local vers votre lecteur Shade :

```bash
./rclone copy /path/to/local/folder Shade:/destination/folder
```

Par exemple, pour copier votre dossier « Projects » vers Shade :

```bash
./rclone copy ~/Projects Shade:/Projects
```

Cette commande va :

* Copier tous les fichiers de votre dossier local Projects vers Shade
* Conserver la structure des dossiers
* Ignorer les fichiers déjà présents et qui n’ont pas été modifiés
* Afficher la progression pendant le transfert

#### Autres commandes utiles

**Synchroniser un dossier** (rend la destination identique à la source, suppressions comprises) :

```bash
./rclone sync ~/Projects Shade:/Projects
```

**Vérifier ce qui serait copié** sans effectuer la copie :

```bash
./rclone copy ~/Projects Shade:/Projects --dry-run
```

**Copier avec la progression et les statistiques**:

```bash
./rclone copy ~/Projects Shade:/Projects --progress --stats 1s
```

**Lister les fichiers de votre lecteur Shade**:

```bash
./rclone ls Shade:/
```

### Autre possibilité : utiliser le backend S3 de rclone

Si vous utilisez rclone avec Shade, nous vous recommandons le [backend natif Shade](https://rclone.org/shade/) pour une expérience optimale. Le backend S3 générique de rclone est également pris en charge si vous avez déjà des scripts ou des workflows basés sur S3, mais ce n’est pas la connexion rclone recommandée.

1. Pour savoir comment générer une clé S3 et obtenir son ID de clé d’accès et sa clé d’accès secrète, consultez [Utiliser l’API S3 de Shade](https://academy.shade.inc/developers/using-shades-s3-api).
2. Ajoutez un remote à votre fichier de configuration rclone (exécutez `./rclone config file` pour le trouver) :

```
[ShadeS3]
type = s3
provider = Other
access_key_id = YOUR_ACCESS_KEY_ID
secret_access_key = YOUR_SECRET_ACCESS_KEY
endpoint = https://s3.shade.inc
region = us-east-1
no_check_bucket = true
```

3. Utilisez l’ID de votre drive comme nom de bucket :

```bash
./rclone copy ~/Projects ShadeS3:YOUR_DRIVE_ID/Projects --progress
```

Chaque bucket correspond à un drive Shade existant ; n’essayez donc pas de créer ou de supprimer des buckets.

### Options standard

Voici les options standard propres à shade (Shade FS).

**Remarque :** Pour la plupart des utilisateurs, il suffit de configurer `drive_id` et `api_key`. Les options avancées ci-dessous correspondent à des cas d’utilisation spécifiques et peuvent conserver leurs valeurs par défaut.

#### --shade-drive-id

L’identifiant de votre lecteur, que vous trouverez dans les paramètres du lecteur. Vous devez créer une configuration rclone distincte pour chaque lecteur.

Propriétés :

* Config : drive\_id
* Var. d’env. : RCLONE\_SHADE\_DRIVE\_ID
* Type : chaîne
* Obligatoire : oui

#### --shade-api-key

Clé API de votre compte. Vous la trouverez dans Paramètres > Clés API.

Propriétés :

* Config : api\_key
* Var. d’env. : RCLONE\_SHADE\_API\_KEY
* Type : chaîne
* Obligatoire : oui

### Options avancées

Voici les options avancées propres à shade (Shade FS).

#### --shade-endpoint

Point de terminaison du service.

Laissez ce champ vide en règle générale.

Propriétés :

* Config : endpoint
* Var. d’env. : RCLONE\_SHADE\_ENDPOINT
* Type : chaîne
* Obligatoire : non

#### --shade-chunk-size

Taille des blocs utilisés pour le téléversement.

Tout fichier dépassant cette taille sera téléversé en blocs de cette taille.

Notez que cette valeur est stockée en mémoire pour chaque transfert : l’augmenter accroît donc l’utilisation de la mémoire.

Le minimum est de 5 MB et le maximum de 5 GB.

Propriétés :

* Config : chunk\_size
* Var. d’env. : RCLONE\_SHADE\_CHUNK\_SIZE
* Type : SizeSuffix
* Par défaut : 64Mi

#### --shade-encoding

Encodage du backend.

Consultez la [section sur l’encodage dans la présentation générale](https://github.com/shade-labs/docs/blob/main/overview/README.md#encoding) pour en savoir plus.

Propriétés :

* Config : encoding
* Variable d’environnement : RCLONE\_SHADE\_ENCODING
* Type : Encoding
* Par défaut : Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot

#### --shade-description

Description du stockage distant.

Propriétés :

* Config : description
* Variable d’environnement : RCLONE\_SHADE\_DESCRIPTION
* Type : chaîne
* Obligatoire : non

### Routes d’API utilisées par l’intégration rclone

Les routes suivantes sont utilisées par l’intégration rclone pour communiquer directement avec le système de fichiers Shade. Si vous souhaitez utiliser directement ces routes dans vos propres applications, vous devez d’abord obtenir un jeton utilisateur en appelant la route appropriée dans la section « Users » de la section « Using the API » de notre documentation. Une fois le jeton utilisateur obtenu, transmettez-le dans vos requêtes comme jeton Bearer à la place de votre clé API.

**Remarque :** Le backend rclone gère automatiquement l’authentification à l’aide de votre clé API. Vous n’avez besoin de vous préoccuper des jetons utilisateur que si vous développez des intégrations personnalisées en dehors de rclone.

## GET /{drive-id}/fs/listdir

> List directory contents for a given drive path

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/listdir":{"get":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getByDriveFsListdir","summary":"List directory contents for a given drive path"}}}}
```

## GET /{drive-id}/fs/attr

> Get file or directory attributes/metadata

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/attr":{"get":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getByDriveFsAttr","summary":"Get file or directory attributes/metadata"}}}}
```

## GET /{drive-id}/fs/download

> Download a file with optional content disposition

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/download":{"get":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","required":true,"schema":{"type":"string"}},{"name":"disposition_type","in":"query","required":true,"schema":{"default":"attachment","type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getByDriveFsDownload","summary":"Download a file with optional content disposition"}}}}
```

## POST /{drive-id}/fs/mkdir

> Create a directory at the specified path

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/mkdir":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"postByDriveFsMkdir","summary":"Create a directory at the specified path"}}}}
```

## POST /{drive-id}/fs/mkdir/batch

> Create multiple directories in a single request

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/mkdir/batch":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{},"required":true},"operationId":"postByDriveFsMkdirBatch","summary":"Create multiple directories in a single request"}}}}
```

## POST /{drive-id}/fs/copy-file

> Copy a file from one path to another

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/copy-file":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":true,"schema":{"type":"string"}},{"name":"to","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"postByDriveFsCopy-file","summary":"Copy a file from one path to another"}}}}
```

## POST /{drive-id}/fs/move

> Move or rename a file or directory

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/move":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","required":true,"schema":{"type":"string"}},{"name":"to","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"postByDriveFsMove","summary":"Move or rename a file or directory"}}}}
```

## POST /{drive-id}/fs/delete

> Delete a file or directory at the specified path

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/fs/delete":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"postByDriveFsDelete","summary":"Delete a file or directory at the specified path"}}}}
```

## GET /{drive-id}/info/storage

> Fetch overall storage usage and limits

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/info/storage":{"get":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getByDriveInfoStorage","summary":"Fetch overall storage usage and limits"}}}}
```

## GET /{drive-id}/info/upload

> Fetch upload configuration and constraints

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/info/upload":{"get":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"operationId":"getByDriveInfoUpload","summary":"Fetch upload configuration and constraints"}}}}
```

## POST /{drive-id}/upload/multipart/part/{partNumber}

> Upload a specific part of a multipart upload

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/upload/multipart/part/{partNumber}":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"partNumber","in":"path","required":true,"schema":{"type":"number"}},{"name":"token","in":"query","required":true,"schema":{"type":"string"}},{"name":"signAllEndpoints","in":"query","required":false,"schema":{"type":"string"}}],"operationId":"postByDriveUploadMultipartPartByPartNumber","summary":"Upload a specific part of a multipart upload"}}}}
```

## POST /{drive-id}/upload/multipart

> Initiate a multipart upload session

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/upload/multipart":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{},"required":true},"operationId":"postByDriveUploadMultipart","summary":"Initiate a multipart upload session"}}}}
```

## POST /{drive-id}/upload/multipart/complete

> Complete a multipart upload by finalizing parts

```json
{"openapi":"3.1.1","info":{"title":"Shade Rclone Routes","version":"0.0.0"},"paths":{"/{drive-id}/upload/multipart/complete":{"post":{"tags":["drives"],"parameters":[{"name":"drive","in":"path","required":true,"schema":{"type":"string"}},{"name":"token","in":"query","required":true,"schema":{"type":"string"}},{"name":"authorization","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{},"required":true},"operationId":"postByDriveUploadMultipartComplete","summary":"Complete a multipart upload by finalizing parts"}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/guides/guides-fr/configuration-et-migration/migration-massive-de-donnees-vers-shade-via-rclone.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
