Fichiers d'un datastore

Parcourir, téléverser, télécharger, copier, déplacer et supprimer les fichiers d'un datastore dans la console, et utiliser le point de terminaison HTTP.

Les fichiers d'un datastore, tels que les images cloud, les images ISO et les disques des machines virtuelles, sont accessibles dans la console, avec la ligne de commande et par HTTP. Les chemins sont relatifs à la racine du datastore : pas de / initial, pas de ... La navigation exige le privilège Datastore.Browse, et les téléversements, copies, déplacements et suppressions exigent Datastore.FileManagement.

Dans la console

Dans l'inventaire, sélectionnez le datastore puis Parcourir les fichiers, ou ouvrez l'onglet Fichiers. Lorsqu'aucun hôte ne peut joindre le datastore, l'onglet affiche Datastore inaccessible.

(Agrandir)
Fermer la vue agrandie
Parcourez les dossiers avec la liste. Dossier parent remonte d'un niveau et Actualiser relit le dossier. Le champ Dossier indique où vous êtes.
Sélectionnez Nouveau dossier, saisissez le Nom du dossier et sélectionnez Créer. Le nom ne peut pas contenir / \ : * ? " < > |.
Sélectionnez Téléverser des fichiers et choisissez les fichiers sur votre ordinateur, ou déposez-les sur la liste. Le téléversement affiche sa progression et son débit dans l'onglet Téléversements du panneau inférieur. Les images volumineuses sont téléversées en arrière-plan. Gardez l'onglet du navigateur ouvert jusqu'à la fin. Annuler le téléversement de ... en arrête un, et Ignorer retire de la liste un téléversement terminé ou échoué. Un fichier plus grand que la limite de téléversement du contrôleur est refusé, et un fichier qui est le disque d'une machine virtuelle n'est pas remplacé.
Utilisez les actions d'une ligne. Télécharger ... enregistre un fichier. Copier ... le copie vers un nouveau chemin sous la racine du datastore, et Renommer ou déplacer ... le renomme ou le déplace ; le dossier de destination doit exister. Supprimer ... supprime un fichier, ou un dossier et tout son contenu, après une confirmation qui indique que l'opération est irréversible. Les disques des machines virtuelles et les dossiers qui les contiennent sont refusés.

Résultat

Le fichier est listé dans le dossier, avec sa taille et l'heure de la dernière modification. Les dossiers et les fichiers ISO que vous avez téléversés peuvent être choisis dans l'assistant de création d'une machine et dans la boîte de dialogue de modification de son matériel, voir Créer une machine virtuelle.

Automatisation

Avec la CLI

Shell

kyvernon datastore ls <datastore> images
kyvernon datastore mkdir <datastore> images/debian
kyvernon datastore upload <datastore> ./debian-12.qcow2 --path images/debian/debian-12.qcow2
kyvernon datastore download <datastore> images/debian/debian-12.qcow2 --to ./copy.qcow2
kyvernon datastore cp <datastore> images/debian/debian-12.qcow2 images/debian/base.qcow2
kyvernon datastore mv <datastore> images/debian/base.qcow2 images/base.qcow2 --overwrite
kyvernon datastore rm <datastore> images/debian/debian-12.qcow2

upload envoie le fichier local en flux. Sans --path, il va à la racine sous son propre nom. --overwrite remplace un fichier existant.
cp et mv fonctionnent dans un même datastore, ou vers un autre datastore du même hôte avec --destination-datastore. Ils sont synchrones.
mkdir crée le dossier et ses parents.
rm supprime un fichier, ou un dossier avec son contenu.

Avec l'API

Opération	Demande
Lister un dossier	`GET /v1/datastores/{id}/files?path=...`
Créer un dossier	`POST /v1/datastores/{id}/folders`
Télécharger	`GET /v1/datastores/{id}/files/content?path=...`, `Range: bytes=a-b` répond 206
Téléverser	`PUT /v1/datastores/{id}/files/content?path=...`, en flux ; `overwrite=true` remplace un fichier existant
Copier, déplacer	`POST /v1/datastores/{id}/files/copy`, `POST /v1/datastores/{id}/files/move`
Supprimer	`DELETE /v1/datastores/{id}/files?path=...`

Un téléversement est écrit dans un fichier temporaire puis renommé à sa place une fois terminé, de sorte qu'un téléversement interrompu ne laisse aucun fichier partiel sous le nom définitif. Un fichier plus grand que la limite de téléversement est refusé avec error.datastore_upload_too_large.

Le point de terminaison de fichiers de datastore de l'API vSphere est également servi : GET, PUT et DELETE /folder/<path>?dcPath=<datacenter>&dsName=<datastore>. Il accepte un jeton bearer, le cookie de session des points de terminaison vSphere ou un vmware_cgi_ticket ; PUT répond 201 pour un nouveau fichier et 200 pour un fichier remplacé. Les outils écrits pour l'API vSphere l'utilisent pour leurs téléversements et téléchargements de datastore.