Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Optional templateid param fails for KVM VM import

Aberta Para iniciantes
#13,067 2 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Um pull request relacionado já foi integrado.

  • #13126 de @andrijapanicsb — integrado

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
68/100
Tipo de issue
Documentação
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
java
Domínio
documentation

Direção de pesquisa

Comece pela API importUnmanagedInstance documentada e por docs/en/4.22.0.0/adminguide/virtual_machines/importing_unmanaging_vms.html; depois, inspecione UnmanagedVMsManagerImpl.java por volta das linhas 1605-1607 para confirmar a restrição do KVM. Verifique com os maintainers se o resultado pretendido é apenas uma alteração na documentação ou uma alteração no código; considera-se concluído quando a documentação da API e a documentação para administradores descreverem com precisão o comportamento de templateid.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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.

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.

Linguagem predominante
Java
Estrelas
3.1k
Forks
1.4k
Merge médio
6d 3h
PRs com merge (30d)
16

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de apache/cloudstack

Todas as issues de apache/cloudstack

Issues semelhantes

Mais issues de Java

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.