Optional templateid param fails for KVM VM import

Offen Anfängerfreundlich

#13,067 erstellt am 24.4.2026 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit: 2/5
Geschätzter Aufwand: 1-3 Stunden
Anfängerfreundlichkeit: 68/100

Issue-Typ: Dokumentation
Klarheit: Größtenteils klar
Aktivitätsstatus: Aktiv
Tech-Stack: java
Bereich: documentation

Rechercherichtung

Beginnen Sie mit der dokumentierten importUnmanagedInstance API und docs/en/4.22.0.0/adminguide/virtual_machines/importing_unmanaging_vms.html und prüfen Sie anschließend UnmanagedVMsManagerImpl.java im Bereich der Zeilen 1605–1607, um die KVM-Einschränkung zu bestätigen. Klären Sie mit den Maintainer:innen, ob das beabsichtigte Ergebnis ausschließlich eine Dokumentationsänderung oder eine Codeänderung ist; abgeschlossen ist die Aufgabe, wenn die API- und Administratorendokumentation das Verhalten von templateid korrekt beschreiben.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

bug

problem

When importing a KVM VM via API and if a template is not specified, import fails with error,
Template is needed and unable to use default template for hypervisor KVM
Even though templateid parameter is specified as optional in the API documentation:
https://cloudstack.apache.org/api/apidocs-4.22/apis/importUnmanagedInstance.html

In UI, template is a required field though.

Documentation doesn't talk about this restriction on KVM
https://docs.cloudstack.apache.org/en/4.22.0.0/adminguide/virtual_machines/importing_unmanaging_vms.html

This is more of a documentation issue if the following block can not be updated:
https://github.com/apache/cloudstack/blob/4.22.0.0/server/src/main/java/org/apache/cloudstack/vm/UnmanagedVMsManagerImpl.java#L1605-L1607

versions

4.22; Maybe other versions as well
Import VM

The steps to reproduce the bug

No response

What to do about it?

Either update the documentation or remove the restriction to use default dummy template.

Vorherrschende Sprache: Java
Sterne: 3.1k
Forks: 1.4k
Ø Merge: 7 T. 5 Std.
Gemergte PRs (30 T.): 28

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
Forken Sie das Repository und arbeiten Sie in einem Branch.
Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus apache/cloudstack

create-kubernetes-binaries-iso.sh builds the ISO without setting a volume ID on EL8 based os's Offen

bug component:kubernetes

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 88/100

apache/cloudstack#14180 · Erstellt am 16.9.2026
Resource fetching missing projectid: "-1" parameter Offen

bug component:projects component:UI

Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 88/100

apache/cloudstack#14070 · 5 Kommentare · Erstellt am 07.9.2026
Nas backup restore fails if the backup repository mount options have a trailing space Offen

component:backup

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 76/100

apache/cloudstack#14013 · Erstellt am 31.8.2026
KVM agent fails to connect to Ceph RBD storage pool after upgrading Ceph client to Tentacle 20.2.4 Offen

bug component:ceph

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100

apache/cloudstack#13989 · 3 Kommentare · Erstellt am 27.8.2026
[UI BUG] Resource limits for type 15 (ObjectStorage) and 16 (GPU) do not sync/display correctly in Web UI Offen

component:UI

Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 68/100

apache/cloudstack#13944 · 3 Kommentare · Erstellt am 21.8.2026

Alle Issues in apache/cloudstack