Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ECS::CustomImage

Última atualização: Jun 27, 2026

Cria uma imagem personalizada.

Sintaxe

{
  "Type": "ALIYUN::ECS::CustomImage",
  "Properties": {
    "Description": String,
    "InstanceId": String,
    "ImageName": String,
    "SnapshotId": String,
    "Tag": List,
    "ResourceGroupId": String,
    "Platform": String,
    "DiskDeviceMapping": List,
    "Architecture": String,
    "ImageFamily": String,
    "Features": Map,
    "SourceRegionId": String,
    "DetectionStrategy": String,
    "ImageVersion": String,
    "BootMode": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

Description

String

Não

Não

Descrição da imagem.

A descrição deve ter de 2 a 256 caracteres. Não pode começar com http:// ou https://.

InstanceId

String

Não

Não

ID da instância.

Usa uma instância ECS para crie a imagem. Para mais informações, consulte Criar uma imagem personalizada a partir de uma instância.

ImageName

String

Não

Não

Nome da imagem.

O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, sublinhados (_) e hifens (-). Deve começar com uma letra e não pode iniciar com http:// ou https://.

SnapshotId

String

Não

Não

ID do snapshot.

Usa um snapshot para crie a imagem. Para mais informações, consulte Criar uma imagem personalizada a partir de um snapshot.

Tag

List

Não

Não

As tags.

Para mais informações, consulte Propriedades de Tag.

ResourceGroupId

String

Não

Sim

ID do grupo de recursos.

Nenhuma.

Platform

String

Não

Não

Distribuição do SO para o disco do sistema. Obrigatório ao criar um disco do sistema a partir de um snapshot de disco de dados.

Valores válidos:

  • CentOS

  • Ubuntu

  • SUSE

  • OpenSUSE

  • RedHat

  • Debian

  • CoreOS

  • Aliyun

  • Windows Server 2012

  • Windows 7

  • Customized Linux

  • Others Linux (padrão)

Features

Map

Não

Não

Atributos de recurso da imagem.

Propriedade Features.

DiskDeviceMapping

List

Não

Não

Mapeamentos entre disco e snapshot.

Para mais informações, consulte Propriedades de DiskDeviceMapping.

Architecture

String

Não

Não

Arquitetura do sistema. Obrigatório ao criar um disco do sistema a partir de um snapshot de disco de dados.

Valores válidos:

  • i386

  • x86_64 (padrão)

ImageFamily

String

Não

Não

Nome da família de imagens.

O nome deve ter de 2 a 128 caracteres e pode conter letras, dígitos, dois-pontos (:), sublinhados (_) e hifens (-). Deve começar com uma letra e não pode iniciar com aliyun ou acs:. Não pode conter http:// ou https://.

SourceRegionId

String

Não

Não

ID da região da instância ou snapshot de source.

Por padrão, usa o ID da região atual.

DetectionStrategy

String

Não

Não

Modo de verificação da imagem.

Se não especificado, nenhuma verificação ocorre. Apenas o modo de verificação padrão tem suporte.

Nota

A maioria das distribuições Linux e Windows tem suporte. Para mais informações sobre os itens de verificação e os limites de SO para verificação de imagens, consulte Verificar e corrigir imagens personalizadas e Limites do sistema operacional para verificação de imagem.

ImageVersion

String

Não

Não

Versão da imagem.

Se InstanceId referenciar uma instância cuja imagem seja do Alibaba Cloud Marketplace ou derivada dele, deixe este campo vazio ou defina-o como a versão da imagem da instância.

BootMode

String

Não

Não

Modo de inicialização da imagem.

Valores válidos:

  • BIOS: Modo de inicialização Basic Input/Output System (BIOS)

  • UEFI: Modo de inicialização Unified Extensible Firmware Interface (UEFI)

Nota

Certifique-se de que a imagem tenha suporte ao modo de inicialização especificado. Um modo sem suporte impede a inicialização das instâncias.

Sintaxe de Features

"Features": 
  {
    "ImdsSupport": String
  }

Propriedade Features

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

ImdsSupport

String

Não

Não

Modo de acesso aos metadados da imagem.

Valores válidos:

  • v1: Modo de reforço de segurança indisponível para instâncias criadas a partir desta imagem.

  • v2: Modo de reforço de segurança disponível para instâncias criadas a partir desta imagem.

Sintaxe de Tag

"Tag": [
  {
    "Key": String,
    "Value": String
  }
]

Propriedades de Tag

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

Key

String

Não

Não

Chave da tag.

A chave da tag deve ter de 1 a 128 caracteres e não pode conter http:// ou https://. Não pode começar com aliyun ou acs:.

Value

String

Não

Não

Valor da tag.

O valor da tag pode ter até 128 caracteres e não pode conter http:// ou https://. Não pode começar com aliyun ou acs:.

Sintaxe de DiskDeviceMapping

"DiskDeviceMapping": [
  {
    "Device": String,
    "SnapshotId": String,
    "Size": Integer,
    "DiskType": String
  }
]

Propriedades de DiskDeviceMapping

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

Device

String

Não

Não

Nome do dispositivo de disco.

Valores válidos:

  • Para discos básicos, os valores válidos variam de /dev/xvda a /dev/xvdz em ordem alfabética.

  • Para categorias de disco diferentes de discos básicos, os valores válidos variam de /dev/vda a /dev/vdz em ordem alfabética.

SnapshotId

String

Não

Não

ID do snapshot.

Nenhuma.

Size

Integer

Não

Não

Tamanho do disco.

  • Se SnapshotId estiver vazio, Size aceita os seguintes valores:

    • Valores válidos para discos básicos: 5 a 2000.

      Valor padrão: 5.

    • Valores válidos para categorias de disco diferentes de discos básicos: 20 a 32768.

      Valor padrão: 20.

  • Se SnapshotId for especificado, Size deve ser maior ou igual ao tamanho do snapshot. Padrão: o tamanho do snapshot.

Unidade: GiB.

DiskType

String

Não

Não

Tipo de disco.

Cria um disco do sistema a partir de um snapshot de disco de dados. Se não especificado, usa o tipo de disco do snapshot.

Valores válidos:

  • system: disco do sistema

  • data: disco de dados

Valores de retorno

Fn::GetAtt

ImageId: o ID da imagem personalizada.

SourceRegionId: o ID da região à qual a instância ou snapshot pertence.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Description:
  en: Create ECS Custom Image
Parameters:
  InstanceId:
    Type: String
    AssociationProperty: ALIYUN::ECS::Instance::InstanceId
Resources:
  CustomImage:
    Type: ALIYUN::ECS::CustomImage
    Properties:
      InstanceId:
        Ref: InstanceId
      ImageName: myImageName
Outputs:
  ImageId:
    Value:
      Fn::GetAtt:
        - CustomImage
        - ImageId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": {
    "en": "Create ECS Custom Image"
  },
  "Parameters": {
    "InstanceId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::Instance::InstanceId"
    }
  },
  "Resources": {
    "CustomImage": {
      "Type": "ALIYUN::ECS::CustomImage",
      "Properties": {
        "InstanceId": {
          "Ref": "InstanceId"
        },
        "ImageName": "myImageName"
      }
    }
  },
  "Outputs": {
    "ImageId": {
      "Value": {
        "Fn::GetAtt": [
          "CustomImage",
          "ImageId"
        ]
      }
    }
  }
}          

Mais exemplos: custom-image.yml. Estes exemplos usam ALIYUN::ECS::CustomImage e ALIYUN::ECS::CopyImage.