Werkwijze Voor: gebruikers, ontwikkelaars

Bestanden op een datastore

Blader door, upload, download, kopieer, verplaats en verwijder bestanden op een datastore in de console, en gebruik het bestandsendpoint.

De bestanden van een datastore, zoals cloudimages, ISO-images en de schijven van virtuele machines, zijn beschikbaar in de console, met de opdrachtregel en via HTTP. Paden zijn relatief ten opzichte van de root van de datastore: geen voorafgaande /, geen ... Bladeren vereist de bevoegdheid Datastore.Browse, en uploads, kopieën, verplaatsingen en verwijderingen vereisen Datastore.FileManagement.

In de console

  1. Selecteer in de inventaris de datastore en selecteer Bestanden doorzoeken, of open het tabblad Bestanden. Als geen enkele host de datastore kan bereiken, toont het tabblad in plaats daarvan Datastore niet toegankelijk.

    Tabblad Bestanden van een datastore met mappen, uploaden en downloaden (Groter weergeven)
  2. Ga door de mappen met de lijst. Omhoog gaat een niveau omhoog en Vernieuwen leest de map opnieuw. Het veld Map toont waar u bent.
  3. Selecteer Nieuwe map, voer de Mapnaam in en selecteer Aanmaken. De naam mag geen / \ : * ? " < > | bevatten.
  4. Selecteer Bestanden uploaden en kies de bestanden op uw computer, of sleep ze naar de lijst. De upload toont zijn voortgang en snelheid op het tabblad Uploads van het paneel onderaan. Grote images worden op de achtergrond geüpload. Houd het browsertabblad open tot ze klaar zijn. Upload van ... annuleren stopt er één, en Sluiten haalt een voltooide of mislukte upload uit de lijst. Een bestand dat groter is dan de uploadlimiet van de controller wordt geweigerd, en een bestand dat de schijf van een virtuele machine is, wordt niet vervangen.
  5. Gebruik de acties van een rij. ... downloaden slaat een bestand op. ... kopiëren kopieert het naar een nieuw pad onder de root van de datastore, en ... hernoemen of verplaatsen hernoemt of verplaatst het; de map waarin het terechtkomt, moet bestaan. ... verwijderen verwijdert een bestand, of een map met alles erin, na een bevestiging die zegt dat dit niet ongedaan kan worden gemaakt. De schijven van virtuele machines en de mappen die ze bevatten, worden geweigerd.

Resultaat

Het bestand staat in de map, met zijn grootte en het tijdstip van de laatste wijziging. De mappen en ISO-bestanden die u hebt geüpload, kunt u kiezen in de wizard die een machine maakt en in het dialoogvenster waarin u de hardware wijzigt, zie Een virtuele machine maken.

Automatisering

Met de 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 streamt het lokale bestand. Zonder --path komt het in de root onder zijn eigen naam. --overwrite vervangt een bestaand bestand.
  • cp en mv werken binnen één datastore, of naar een andere datastore van dezelfde host met --destination-datastore. Ze zijn synchroon.
  • mkdir maakt de map en de bovenliggende mappen.
  • rm verwijdert een bestand, of een map met de inhoud.

Met de API

BewerkingVerzoek
Een map tonenGET /v1/datastores/{id}/files?path=...
Een map makenPOST /v1/datastores/{id}/folders
DownloadenGET /v1/datastores/{id}/files/content?path=..., Range: bytes=a-b antwoordt met 206
UploadenPUT /v1/datastores/{id}/files/content?path=..., gestreamd; overwrite=true vervangt een bestaand bestand
Kopiëren, verplaatsenPOST /v1/datastores/{id}/files/copy, POST /v1/datastores/{id}/files/move
VerwijderenDELETE /v1/datastores/{id}/files?path=...

Een upload wordt naar een tijdelijk bestand geschreven en op zijn plaats hernoemd wanneer hij compleet is, zodat een afgebroken upload geen gedeeltelijk bestand onder de echte naam achterlaat. Een bestand dat groter is dan de uploadlimiet wordt geweigerd met error.datastore_upload_too_large.

Het bestandsendpoint van de datastore uit de vSphere-API wordt ook aangeboden: GET, PUT en DELETE /folder/<path>?dcPath=<datacenter>&dsName=<datastore>. Het accepteert een bearer-token, de sessiecookie van de vSphere-endpoints of een vmware_cgi_ticket; PUT antwoordt met 201 voor een nieuw bestand en 200 voor een vervangen bestand. Hulpmiddelen die voor de vSphere-API zijn geschreven, gebruiken het voor hun uploads en downloads van datastores.

Versie 0.1. Laatst gewijzigd: 2026-11-14