Todos os produtos
Search
Central de documentação

Elastic Compute Service:Import custom image

Última atualização: Jul 03, 2026

Para criar rapidamente instâncias ECS no Alibaba Cloud idênticas ao seu ambiente de servidor local ou existente, importe uma imagem personalizada. Esse método elimina a instalação manual de aplicativos e a configuração do sistema em novas instâncias, sendo ideal para implantações padronizadas e em grande escala. Este tópico descreve como preparar um arquivo de imagem, importá-lo para o Alibaba Cloud e criar uma imagem personalizada para iniciar instâncias ECS.

Você também pode usar o Server Migration Center (SMC) para migrar servidores para o Alibaba Cloud a partir de data centers on-premises, máquinas virtuais locais ou outros provedores de nuvem. O SMC gera uma imagem personalizada do servidor migrado para criar instâncias ECS. Para obter mais informações, consulte Migrar servidores para o ECS .

Pré-requisitos

Antes de importar um arquivo de imagem para o console ECS, conclua as seguintes etapas:

  • Consulte Limites e requisitos para importação de imagens para garantir que o arquivo de imagem atenda a todos os requisitos de importação e evitar problemas de compatibilidade.

  • O ECS suporta a importação de arquivos de imagem apenas nos formatos QCOW2, VHD, RAW e VMDK. Caso seu arquivo de imagem esteja em outro formato, converta o formato da imagem antes de fazer o upload do arquivo.

    Diferenças entre os formatos QCOW2, VHD e RAW

    Formato

    Descrição

    Recursos

    QCOW2

    Formato de imagem de máquina virtual para QEMU. Utiliza um único arquivo para representar um dispositivo de bloco e suporta alocação dinâmica de espaço em disco.

    • Consome menos espaço em disco.

    • Suporta copy-on-write (CoW), em que o arquivo de imagem reflete apenas as alterações feitas no disco subjacente.

    • Permite múltiplos snapshots históricos.

    • Oferece suporte à compressão ZLIB e criptografia AES.

    VHD

    Formato de arquivo de disco virtual da Microsoft. Um arquivo VHD pode ser compactado em um único arquivo no sistema de arquivos do host local e utilizado para diversas finalidades.

    • Fácil manutenção. É possível particionar, formatar, compactar ou excluir o disco virtual sem afetar as partições físicas.

    • Backup simplificado. Faça backup apenas do arquivo VHD ou de toda a partição física que o contém.

    • Migração facilitada. Para usar um arquivo VHD em outro computador, desanexe-o do computador atual, copie-o para o computador de destino e anexe-o novamente.

    • Implantação direta do sistema. Use a ferramenta ImageX para aplicar uma imagem capturada a um VHD ou utilize um servidor Windows Deployment Services (WDS) para implantar um sistema em um VHD.

    RAW

    Formato de arquivo de leitura/gravação direta que não suporta alocação dinâmica de espaço. Oferece o melhor desempenho de I/O entre todos os formatos de imagem.

    • Endereçamento simples e alta eficiência de acesso.

    • Conversão fácil para outros formatos por meio de ferramentas específicas.

    • Montagem em host local. Permite transferência de dados entre o arquivo de imagem e o host sem iniciar a máquina virtual.

  • Conceda permissões ao ECS para acessar recursos do Object Storage Service (OSS). O ECS obtém essas permissões assumindo a função AliyunECSImageImportDefaultRole.

    Se esta for a primeira vez que você importa uma imagem, siga as instruções do assistente na página Imagens do console ECS para conceder as permissões necessárias.

    Para importar uma imagem personalizada como usuário RAM, uma conta Alibaba Cloud deve primeiro conceder a esse usuário as permissões necessárias para o bucket do OSS. Para obter mais informações, consulte Autorizar um usuário RAM a acessar um bucket do OSS .

Tutorial em vídeo

O vídeo a seguir demonstra como importar uma imagem personalizada no console ECS.

Procedimento

Etapa 1: Preparar e fazer upload do arquivo de imagem

Antes de importar uma imagem, faça o upload de um arquivo de imagem compatível para o Object Storage Service (OSS). Certifique-se de que o arquivo atenda aos requisitos descritos em Limites e requisitos para importação de imagens. Caso contrário, a importação poderá falhar ou as instâncias criadas a partir da imagem poderão não funcionar corretamente.

Faça o upload do arquivo de imagem local para o OSS e obtenha a URL do arquivo. Para obter mais informações, consulte Métodos para upload de arquivos no OSS.

Nota

Para incluir discos de dados na imagem importada, prepare arquivos de imagem separados para o disco do sistema e para cada disco de dados e, em seguida, faça o upload dos arquivos para o OSS. Ao criar uma instância ECS a partir da imagem personalizada, a instância incluirá tanto o disco do sistema quanto os discos de dados.

Etapa 2: Importar a imagem personalizada

  1. Acesse a página Imagens do console ECS. No canto superior esquerdo da página, selecione a região e o grupo de recursos de destino. Em seguida, na barra de navegação superior, selecione seu projeto na lista suspensa Product/Project e verifique se a conta correta está selecionada na lista suspensa Account à direita.

    Importante

    A região selecionada deve corresponder à região do bucket do OSS onde o arquivo de imagem está armazenado.

    Regiões do Finance Cloud

    Uma região do Finance Cloud pode ter nomes diferentes no ECS e no OSS. A tabela a seguir descreve os mapeamentos.

    • A região China (Hangzhou) Finance no ECS (cn-hangzhou) corresponde à região oss-cn-hzfinance no OSS.

    • A região China (Shanghai) Finance no ECS (cn-shanghai-finance-1) corresponde à região oss-cn-shanghai-finance-1-pub no OSS.

    • A região China (Shenzhen) Finance no ECS (cn-shenzhen-finance-1) corresponde à região oss-cn-szfinance no OSS.

    • A região China (Beijing) Finance no ECS (cn-beijing-finance-1) corresponde à região oss-cn-beijing-finance-1 no OSS.

  2. Na página Images, clique em Import Image > Import Image no canto superior direito.

  3. Na página Prepare Before Import do assistente, confirme que os preparativos foram concluídos, clique em Next e, em seguida, clique em Confirm.

  4. Na página Import Image File do assistente, configure os seguintes parâmetros.

    Parâmetro

    Obrigatório

    Descrição

    Image File URL

    Sim

    Insira a URL do arquivo de imagem obtida na Etapa 1. A região do arquivo de imagem no OSS deve corresponder à região atualmente selecionada. Para alterar a região, selecione uma nova região na barra de menu superior e reabra a caixa de diálogo Import Image.

    Image Name

    Sim

    Insira um nome para a imagem que será exibido após a importação. O nome deve ter entre 2 e 128 caracteres. Deve começar com uma letra ou caractere chinês e pode conter dígitos, pontos (.), sublinhados (_), dois pontos (:) e hífens (-).

    OS Type

    Sim

    Selecione o tipo de SO do arquivo de imagem a ser importado. Este deve corresponder ao tipo real de SO do arquivo de imagem.

    Valores válidos: Windows e linux. Se o sistema operacional da imagem não estiver na lista de plataformas suportadas, selecione linux.

    OS Version

    Sim

    Selecione a versão do SO do arquivo de imagem a ser importado. Esta deve corresponder à versão real do SO do arquivo de imagem.

    Se o seu sistema operacional não estiver na lista de plataformas suportadas, você tem as seguintes opções:

    • Selecione Aliyun Customized Linux: Certifique-se de ter adicionado manualmente scripts de análise para garantir que a imagem esteja disponível. Para obter mais informações, consulte Personalizar uma imagem Linux.

    • Selecione Others Linux: O ECS não realiza nenhum processamento na instância criada a partir desta imagem. Após a criação da instância, configure manualmente o endereço IP, as rotas e a senha dentro da instância.

    • Se o seu sistema operacional for uma versão personalizada baseada no kernel Linux, abra um ticket.

    System Architecture

    Sim

    Selecione a arquitetura de sistema do arquivo de imagem. Arquiteturas suportadas:

    • i386 (32 bits)

    • x86_64 (64 bits)

    • arm64 (64 bits)

    License Type

    Este parâmetro é obrigatório quando o OS Type está definido como Windows.

    Tipo de licença usado para ativar o sistema operacional após a importação da imagem. Valores válidos:

    • Alibaba Cloud License: Ao criar uma instância a partir da imagem importada, você será cobrado por uma taxa de licença do Windows Server, e o SO será ativado automaticamente pelos servidores de ativação do Alibaba Cloud.

    Para obter mais informações sobre faturamento, consulte Faturamento de imagens.
    • BYOL: Ao criar uma instância a partir da imagem importada, o Alibaba Cloud não cobra taxa de licença de SO nem ativa o Windows Server automaticamente. Você deve fornecer uma licença válida e ativar o SO manualmente.

    Detect Image

    Não

    O recurso de verificação de imagem valida se uma imagem personalizada é válida e pode ser usada para criar instâncias ECS totalmente funcionais.

    Por padrão, a opção Check After Import vem selecionada. A verificação da imagem é executada imediatamente após a conclusão da importação. Após a verificação, visualize os detalhes na coluna Check Result da lista de imagens personalizadas. Se houver itens que precisem de correção, use o recurso Fix ou aplique manualmente os reparos sugeridos nos detalhes da imagem.

    Nota

    O recurso de verificação de imagem está disponível apenas para sistemas operacionais específicos. Para obter uma lista de sistemas operacionais não suportados, consulte Limites de SO para verificação de imagem.

    Boot Mode

    Não

    Selecione o modo de inicialização da imagem. Valores válidos: BIOS e UEFI.

    O modo de inicialização especifica o método usado para iniciar o disco do sistema quando uma instância ECS é criada. Essa configuração deve corresponder ao modo de inicialização do seu arquivo de imagem. Caso contrário, as instâncias criadas a partir da imagem personalizada poderão falhar ao iniciar.

    Image Format

    Não

    Selecione Auto (padrão) ou especifique o formato como RAW, QCOW2, VHD ou VMDK. Recomendamos que essa configuração corresponda ao formato do seu arquivo de imagem.

    Se não tiver certeza sobre o formato da imagem, selecione Auto. O sistema detecta e define automaticamente o formato da imagem para corresponder ao seu arquivo.

    Nota

    O ECS não suporta a importação direta de arquivos de imagem ISO. Converta o arquivo ISO para um formato de imagem suportado antes de importá-lo. Para obter mais informações, consulte Como converter um arquivo ISO para um formato de imagem suportado pelo ECS?

    Disk Configuration

    Não

    Defina a capacidade do disco do sistema e adicione imagens de disco de dados.

    1. Selecione Configure Disk Properties.

    2. Os parâmetros do disco do sistema são preenchidos automaticamente. Basta especificar a capacidade do disco do sistema. O tamanho deve estar entre 1 GiB e 2.048 GiB e ser pelo menos igual ao tamanho do arquivo de imagem.

      Nota

      O tamanho do arquivo de imagem refere-se ao tamanho do arquivo no OSS, que pode ser visualizado no console OSS.

    3. Clique em Add Data Disk e configure os parâmetros.

      • Image File URL: Insira a URL do arquivo de imagem do disco de dados obtida na Etapa 1. O método para obter a URL é o mesmo utilizado para o disco do sistema.

      • Mount Point: Atribuído automaticamente pelo sistema.

      • Image Format: Selecione Auto ou especifique o formato como RAW, QCOW2, VHD ou VMDK. A configuração deve corresponder ao formato do seu arquivo de imagem.

      • Disk Capacity (GiB): O tamanho deve estar entre 1 GiB e 2.048 GiB e ser pelo menos igual ao tamanho do arquivo de imagem.

        Nota

        O tamanho do arquivo de imagem refere-se ao tamanho do arquivo no OSS, que pode ser visualizado no console OSS.

    Image Description

    Não

    Insira uma descrição para a imagem a fim de facilitar o gerenciamento futuro.

    Tag

    Não

    Adicione tags à imagem para categorizá-la, facilitando a busca e operações em lote.

    Resource Group

    Não

    Atribua a imagem a um grupo de recursos para gerenciamento hierárquico.

    Importante

    Se uma conta Alibaba Cloud conceder a um usuário RAM permissões com escopo limitado a um grupo de recursos específico, certifique-se de selecionar o mesmo grupo de recursos aqui.

  5. Após confirmar que as informações estão corretas, clique em OK.

    O sistema cria uma tarefa para importar a imagem personalizada.

(Opcional) Etapa 3: Visualizar ou cancelar a tarefa de importação

  • Visualizar a tarefa de importação

    Verifique o progresso da tarefa de importação na lista de imagens personalizadas da região de destino ou na página Gerenciamento de Tarefas.

    Nota

    O tempo necessário para importar uma imagem personalizada varia conforme o tamanho do arquivo de imagem e o número de tarefas de importação simultâneas.

    • Ao importar uma imagem personalizada, um snapshot é criado automaticamente. Visualize suas informações na lista Snapshots. Antes da conclusão da tarefa de importação, o status do snapshot é exibido como Failed. Após a conclusão da tarefa, o status do snapshot muda para Completed, e o status da imagem muda para Available. A capacidade do snapshot é igual ao tamanho do arquivo de imagem personalizada importado, independentemente do tamanho do disco do sistema especificado durante a importação. Snapshots são um serviço pago. Para obter mais informações, consulte Faturamento de snapshots.

    • Caso tenha ativado o recurso de verificação de imagem, visualize os resultados na coluna Check Result da lista de imagens personalizadas após a conclusão da verificação. Se houver itens que precisem de correção, use o recurso Fix ou aplique manualmente os reparos sugeridos nos detalhes da imagem. Para obter mais informações sobre os itens de verificação e sugestões de reparo, consulte Verificar e reparar uma imagem personalizada.

    • Uma tarefa de importação pode falhar devido a um erro inesperado durante a validação do arquivo. Tais erros podem afetar operações subsequentes, como a criação de instâncias. Siga estas etapas para identificar e corrigir o problema.

      1. Verifique o código de erro na página Gerenciamento de Tarefas ou chamando a operação da API DescribeTaskAttribute.

      2. Use o código de erro para identificar e corrigir o problema.

        Códigos de erro

        Código de erro

        Causa

        Solução de problemas

        Solução

        UNKNOWN_IMAGE_FORMAT

        O formato do arquivo de imagem não é suportado.

        Execute o comando qemu-img check para verificar o formato do arquivo de imagem.

        Converta o formato da imagem. Recomendamos o uso do formato RAW ou VHD.

        Nota

        Recomendamos o uso da ferramenta qemu-img com parâmetros padrão para converter o formato do arquivo de imagem. Para obter mais informações, consulte Converter formatos de imagem.

        IMAGE_SIZE_EXCEEDS_LIMIT

        O arquivo de imagem é muito grande.

        Execute o comando qemu-img info para verificar o tamanho do arquivo de imagem.

        • Reduza o tamanho do arquivo de imagem.

        • Converta o formato da imagem. Recomendamos o uso do formato RAW ou VHD.

          Nota

          Recomendamos o uso da ferramenta qemu-img com parâmetros padrão para converter o formato do arquivo de imagem. Para obter mais informações, consulte Converter formatos de imagem.

        INVALID_IMAGE_SIZE

        Não foi possível recuperar o tamanho da imagem.

        Chame a operação da API do OSS GetObject para verificar se o objeto existe e está acessível.

        Tente fazer o upload do arquivo de imagem novamente para um novo objeto no OSS.

        IMAGE_FILE_NOT_FOUND

        A origem do arquivo de imagem não foi encontrada.

        Chame a operação da API do OSS GetObject para verificar se o objeto existe e está acessível.

        • Não exclua o objeto do OSS antes que a tarefa de importação seja concluída.

        • Evite usar caracteres especiais em nomes de arquivos no OSS. Para obter mais informações, consulte Convenções de nomenclatura de objetos.

        • Tente fazer o upload do arquivo de imagem novamente para um novo objeto no OSS.

        INVALID_IMAGE_FORMAT

        Formato de imagem inválido.

        O formato declarado no cabeçalho do arquivo não é suportado.

        Verifique o formato do arquivo de imagem. Para formatos diferentes de RAW ou VHD, recomendamos converter a imagem para o formato RAW ou VHD.

        Nota

        Recomendamos o uso da ferramenta qemu-img com parâmetros padrão para converter o formato do arquivo de imagem. Para obter mais informações, consulte Converter formatos de imagem.

  • Cancelar a tarefa de importação

    Cancele uma tarefa de importação em andamento de duas maneiras:

    • Método 1: Na lista de imagens, clique em Cancel Import.

    • Método 2: Na página Gerenciamento de Tarefas, cancele a tarefa de importação de imagem.

      1. No painel de navegação à esquerda, escolha Maintenance & Monitoring > Tasks.

      2. Localize a tarefa de importação de imagem personalizada e clique em Cancel na coluna Actions.

Detalhes de faturamento

A importação de uma imagem personalizada gera as seguintes taxas:

  • Antes de importar uma imagem personalizada, faça o upload do arquivo de imagem local para o OSS. Essa operação gera taxas de armazenamento do OSS.

  • Durante o processo de importação, o arquivo de imagem é carregado e baixado do OSS. Essas operações geram taxas de transferência de dados do OSS.

  • O processo de importação chama APIs do OSS. Essa operação gera taxas de requisição de API do OSS.

  • Ao importar uma imagem personalizada para o ECS, um snapshot é criado por padrão. Isso gera taxas de armazenamento de snapshot, cobradas no modelo pagamento conforme o uso. Para obter mais informações, consulte Faturamento de snapshots.

Perguntas frequentes

O que fazer se eu selecionei o tipo de licença errado ao importar uma imagem do Windows Server, resultando em cobranças extras?

Se você definiu acidentalmente o tipo de licença como Alibaba Cloud License ao importar uma imagem do Windows Server, as instâncias criadas a partir dessa imagem serão cobradas por uma taxa de licença e ativadas automaticamente. Chame a operação da API ModifyImageAttribute para alterar o atributo LicenseType para BYOL.

Chame a operação DescribeImages para consultar o tipo de licença de uma imagem do Windows Server importada.
  • Para novas instâncias ECS: Se você alterar o valor de LicenseType da imagem importada para BYOL, as novas instâncias criadas a partir da imagem não incorrerão mais em taxas de licença do Windows Server e não serão ativadas automaticamente.

  • Para instâncias ECS existentes: Para instâncias já criadas a partir da imagem original, alterar o LicenseType da imagem para BYOL não interrompe o faturamento do Windows Server. Para interromper o faturamento, entre em contato com o atendimento ao cliente para solicitar uma correção de dados.