apache / apache/cloudstack

Optional templateid param fails for KVM VM import

Offen Anfängerfreundlich
#13,067 2 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
bug
Vorherrschende Sprache
Java
Sterne
3.1k
Forks
1.4k
Ø Merge
6 T. 19 Std.
Gemergte PRs (30 T.)
32

Beschreibung

### 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.

Image

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.

Beitragsleitfaden

Beitragsleitfaden öffnen

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.

Bewertung

Tech-Stack
java
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Aktiv
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
68/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.