Werkwijze Voor: gebruikers

Contentbibliotheken

Maak een contentbibliotheek op een datastore in de console, registreer of upload ISO- en OVF-items en gebruik de items.

Een contentbibliotheek is een catalogus van ISO- en OVF-bestanden. Een bibliotheek wordt gedragen door één datastore en een item verwijst naar een bestand daarop. U kunt een bestand registreren dat er al staat, of een bestand uploaden naar een nieuw item. De items van het type ISO kunt u kiezen wanneer u een ISO-image aan een virtuele machine koppelt, zie Hardware wijzigen. U hebt een datastore met vrije ruimte nodig.

In de console

  1. Selecteer op de startpagina Contentbibliotheken.

    Contentbibliotheken met hun items (Groter weergeven)
  2. Voer onder Nieuwe bibliotheek een Naam in, kies de Datastore en selecteer Bibliotheek aanmaken. De bibliotheek verschijnt in de lijst Bibliotheken.
  3. Selecteer de bibliotheek in de lijst. Het onderdeel Bibliotheekitems toont de items.
  4. Als u een item wilt toevoegen, voert u een Naam in en kiest u het Type, ISO of OVF/OVA.
  5. Voer het Datastorepad in van een bestand dat al op de datastore staat, of kies een bestand onder Bestand uploaden. Een upload maakt een leeg item en stuurt het bestand naar de datastore van de bibliotheek.
  6. Selecteer Item toevoegen, of Uploaden als u een bestand hebt gekozen.

Verwijderen verwijdert een bibliotheek en Verwijderen verwijdert een item. De bestanden op de datastore staan beschreven in Bestanden op een datastore.

Resultaat

Het item staat in de lijst met zijn type en het datastorepad van zijn bestand. ISO-items worden aangeboden in het dialoogvenster waarin u de hardware van een machine wijzigt, onder Uit contentbibliotheek.

Automatisering

Met de CLI

Shell
kyvernon content libraries create images --datastore <datastore> --description "ISO images"
kyvernon content items create ubuntu-26.04 --library <library> --type iso \
  --file-path iso/ubuntu-26.04.iso
kyvernon content items list --library <library>

Om een bestand naar een leeg item te uploaden, opent u een updatesessie, voegt u het bestand toe, uploadt u het en rondt u de sessie af:

Shell
kyvernon content items create tools --library <library> --type iso
kyvernon content sessions create <item>
kyvernon content sessions add-file <session> tools.iso --size 734003200
kyvernon content sessions upload <session> tools.iso ./tools.iso
kyvernon content sessions complete <session>

sessions cancel breekt een sessie af en sessions files toont de bestanden ervan. Overige opdrachten: libraries list, get en delete; items get en delete; sessions list en get. De types van een item zijn iso, ovf en vm-template.

Met de API

BewerkingVerzoek
BibliothekenGET, POST /v1/content/libraries; GET, DELETE /v1/content/libraries/{id}
ItemsGET, POST /v1/content/library-items; GET, DELETE /v1/content/library-items/{id}
UpdatesessiesGET, POST /v1/content/update-sessions; GET, DELETE /v1/content/update-sessions/{id}
Een bestand aan een sessie toevoegenPOST /v1/content/update-sessions/{id}/files
Het bestand verzendenPUT /v1/content/update-sessions/{id}/files/{name}/content
AfrondenPOST /v1/content/update-sessions/{id}/complete

Een bibliotheek wordt gemaakt met name, datastoreId en een optionele description. Een item neemt libraryId, name, type en ofwel filePath, ofwel niets voor een upload. Bibliotheken zijn lokaal voor de controller; hun type is altijd LOCAL.

Versie 0.1. Laatst gewijzigd: 2026-11-14