Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::ECS::LaunchTemplate

Última atualização: Aug 25, 2026

O recurso ALIYUN::ECS::LaunchTemplate cria um modelo de inicialização do ECS.

Sintaxe

{
  "Type": "ALIYUN::ECS::LaunchTemplate",
  "Properties": {
    "LaunchTemplateName": String,
    "VersionDescription": String,
    "ImageId": String,
    "InstanceType": String,
    "SecurityGroupId": String,
    "NetworkType": String,
    "VSwitchId": String,
    "InstanceName": String,
    "Description": String,
    "InternetMaxBandwidthOut": Integer,
    "HostName": String,
    "ZoneId": String,
    "SystemDiskCategory": String,
    "SystemDiskSize": Number,
    "SystemDiskDiskName": String,
    "SystemDiskDescription": String,
    "IoOptimized": String,
    "InternetChargeType": String,
    "UserData": String,
    "KeyPairName": String,
    "RamRoleName": String,
    "AutoReleaseTime": String,
    "SpotStrategy": String,
    "SpotPriceLimit": String,
    "SecurityEnhancementStrategy": String,
    "DiskMappings": List,
    "NetworkInterfaces": List,
    "Tags": List,
    "TemplateTags": List,
    "TemplateResourceGroupId": String,
    "SecurityGroupIds": List,
    "ResourceGroupId": String,
    "SpotDuration": Integer,
    "ImageOwnerAlias": String,
    "Period": Integer,
    "Ipv6AddressCount": Integer,
    "PrivateIpAddress": String,
    "PasswordInherit": Boolean,
    "SystemDiskDeleteWithInstance": Boolean,
    "DeploymentSetId": String,
    "InstanceChargeType": String,
    "SystemDiskPerformanceLevel": String
  }
}

Propriedades

PropriedadeTipoObrigatórioAtualização permitidaDescriçãoRestrições
LaunchTemplateNameStringSimNãoNome do modelo de inicialização.O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou caractere chinês. Não pode começar com http:// ou https://. Pode conter letras, caracteres chineses, dígitos, dois pontos (:), sublinhados (_) e hifens (-).
VersionDescriptionStringNãoNãoDescrição da versão do modelo de inicialização.A descrição deve ter de 2 a 128 caracteres. Deve começar com uma letra ou caractere chinês. Não pode começar com http:// ou https://.
ImageIdStringNãoNãoID da imagem.Nenhuma
InstanceTypeStringNãoNãoTipo da instância.Nenhuma
SecurityGroupIdStringNãoNãoID do grupo de segurança.Nenhuma
NetworkTypeStringNãoNãoTipo de rede da instância.Valores válidos:
  • classic: Rede clássica.
  • vpc: Virtual Private Cloud (VPC).
VSwitchIdStringNãoNãoID do vSwitch.Este parâmetro é válido apenas quando NetworkType está definido como vpc.
InstanceNameStringNãoNãoNome da instância.O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou caractere chinês. Não pode começar com http:// ou https://.
DescriptionStringNãoNãoDescrição da instância.A descrição deve ter de 2 a 128 caracteres. Deve começar com uma letra ou caractere chinês. Não pode começar com http:// ou https://.
InternetMaxBandwidthOutIntegerNãoNãoLargura de banda pública de saída máxima.O valor deve ser um número inteiro de 0 a 100.

Unidade: Mbit/s.

HostNameStringNãoNãoHostname da instância.

Um ponto (.) ou hífen (-) não pode ser o primeiro nem o último caractere. Esses caracteres também não podem aparecer consecutivamente.

Valores válidos:
  • Para instâncias Windows, o hostname deve ter de 2 a 15 caracteres. Não pode conter apenas dígitos. Pode conter letras, dígitos e hifens (-).
  • Para outros tipos de instância, como Linux, o hostname deve ter de 2 a 64 caracteres. Pode conter letras, dígitos e hifens (-).
ZoneIdStringNãoNãoID da zona onde a instância está localizada.Nenhuma
SystemDiskCategoryStringNãoNãoCategoria do disco do sistema.Valores válidos:
  • cloud: disco básico.
  • cloud_efficiency: disco ultra.
  • cloud_ssd: SSD padrão.
  • ephemeral_ssd: SSD local.
SystemDiskSizeNumberNãoNãoTamanho do disco do sistema.O valor deve ser um número inteiro de 20 a 500.

Unidade: GB.

SystemDiskDiskNameStringNãoNãoNome do disco do sistema.O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou caractere chinês. Não pode começar com http:// ou https://. Pode conter letras, caracteres chineses, dígitos, dois pontos (:), sublinhados (_) e hifens (-).
SystemDiskDescriptionStringNãoNãoDescrição do disco do sistema.A descrição deve ter de 2 a 256 caracteres. Não pode começar com http:// ou https://.
IoOptimizedStringNãoNãoIndica se a instância é otimizada para E/S.Valores válidos:
  • none: A instância não é otimizada para E/S.
  • optimized: A instância é otimizada para E/S.
InternetChargeTypeStringNãoNãoMétodo de faturamento para uso de rede.Valores válidos:
  • PayByBandwidth: pagamento por largura de banda.
  • PayByTraffic: pagamento por transferência de dados.
UserDataStringNãoNãoDados de usuário da instância.Os dados de usuário devem estar codificados em Base64. Os dados brutos não podem exceder 16 KB.
KeyPairNameStringNãoNãoNome do par de chaves.Este parâmetro é obrigatório apenas para instâncias Linux. Se você especificar este parâmetro, o login por senha será desativado.
RamRoleNameStringNãoNãoNome da função RAM da instância.Nenhuma
AutoReleaseTimeStringNãoNãoHorário de liberação automática da instância.O horário deve estar no formato yyyy-MM-ddTHH:mm:ssZ e em UTC. O horário segue o padrão ISO 8601.
SpotStrategyStringNãoNãoDefina a política de preempção para instâncias de pagamento conforme o uso.

Este parâmetro é válido apenas quando InstanceChargeType está definido como PostPaid.

Valores válidos:

  • NoSpot: Instância regular de pagamento conforme o uso.
  • SpotWithPriceLimit: Instância spot com preço máximo especificado.
  • SpotAsPriceGo: Instância spot em que o sistema oferece lance automaticamente até o preço de pagamento conforme o uso.
SpotPriceLimitStringNãoNãoPreço horário máximo da instância.O valor pode ter até três casas decimais.
SecurityEnhancementStrategyStringNãoNãoIndica se o reforço de segurança deve ser ativado.Valores válidos:
  • Active: Item ativado.
  • Deactivated: Desativado.
DiskMappingsListNãoNãoLista de discos de dados.É possível adicionar até 16 discos de dados.

Para mais informações, consulte a propriedade DiskMappings.

NetworkInterfacesListNãoNãoLista de interfaces de rede elásticas (ENIs).É possível adicionar até 8 ENIs.

Para mais informações, consulte a propriedade NetworkInterfaces.

TagsListNãoNãoLista de tags para a instância, grupo de segurança, discos e ENIs.É possível adicionar até 20 tags.

Para mais informações, consulte a propriedade Tags.

TemplateTagsListNãoNãoLista de tags para o modelo de inicialização.É possível adicionar até 20 tags.

Para mais informações, consulte a propriedade TemplateTags.

TemplateResourceGroupIdStringNãoNãoID do grupo de recursos ao qual o modelo de inicialização pertence.Nenhuma
SecurityGroupIdsListNãoNãoUm ou mais grupos de segurança aos quais a instância pertence.A quantidade de grupos de segurança é determinada pela cota.
Nota Não é possível especificar SecurityGroupId e SecurityGroupIds simultaneamente.
ResourceGroupIdStringNãoNãoID do grupo de recursos ao qual a instância, o armazenamento em bloco e as ENIs pertencem.Nenhuma
SpotDurationIntegerNãoNãoPeríodo de retenção da instância spot.O valor deve ser um número inteiro de 0 a 6.

Valor padrão: 1.

Unidade: horas.

Nota Para definir o valor como um número inteiro de 2 a 6, envie um ticket.
ImageOwnerAliasStringNãoNãoOrigem da imagem.Valores válidos:
  • system: imagens públicas fornecidas pelo Alibaba Cloud.
  • self: imagens personalizadas criadas por você.
  • others: imagens compartilhadas por outros usuários do Alibaba Cloud.
  • Marketplace: Marketplace de imagens.
PeriodIntegerNãoNãoDuração da assinatura do recurso.Este parâmetro é obrigatório e válido apenas quando InstanceChargeType está definido como PrePaid.

Valores válidos: 1 a 9, 12, 24, 36, 48 e 60.

Unidade: meses.

Ipv6AddressCountIntegerNãoNãoQuantidade de endereços IPv6 gerados aleatoriamente para atribuir à ENI primária.O valor deve ser um número inteiro de 1 a 10.
PrivateIpAddressStringNãoNãoEndereço IP privado da instância.Ao definir o endereço IP privado para uma instância ECS em uma VPC, selecione um bloco CIDR livre no vSwitch.
PasswordInheritBooleanNãoNãoIndica se a senha predefinida da imagem deve ser usada.Valores válidos:
  • true: Ativado
  • false: Este valor não é utilizado.
Nota Especifique PasswordInherit ou Password.
SystemDiskDeleteWithInstanceBooleanNãoNãoIndica se o disco do sistema deve ser liberado quando a instância for liberada.Valores válidos:
  • true (padrão): A instância é liberada.
  • false: Não libera.
DeploymentSetIdStringNãoNãoID do conjunto de implantação.Nenhuma
InstanceChargeTypeStringNãoNãoMétodo de faturamento da instância.Valores válidos:
  • PrePaid: assinatura.
  • PostPaid: pagamento conforme o uso.
SystemDiskPerformanceLevelStringNãoNãoNível de desempenho do ESSD usado como disco do sistema.Valores válidos:
  • PL0 (padrão): Um único disco pode entregar até 10.000 IOPS de leitura/gravação aleatória.
  • PL1: Um único disco pode entregar até 50.000 IOPS de leitura/gravação aleatória.
  • PL2: Um único disco pode entregar até 100.000 IOPS de leitura/gravação aleatória.
  • PL3: Um único disco pode entregar até 1.000.000 IOPS de leitura/gravação aleatória.

Sintaxe de DiskMappings

"DiskMappings": [
  {
    "Category": String,
    "DiskName": String,
    "Description": String,
    "SnapshotId": String,
    "Size": String,
    "Encrypted": String,
    "DeleteWithInstance": String,
    "PerformanceLevel": String
  }
]

Propriedades de DiskMappings

PropriedadeTipoObrigatórioAtualização permitidaDescriçãoRestrições
CategoryStringNãoNãoCategoria do disco de dados.Valores válidos:
  • cloud: disco básico.
  • cloud_efficiency: disco ultra.
  • cloud_ssd: SSD padrão.
  • ephemeral_ssd: SSD local.
DiskNameStringNãoNãoNome do disco de dados.O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou caractere chinês. Não pode começar com http:// ou https://. Pode conter letras, caracteres chineses, dígitos, dois pontos (:), sublinhados (_) e hifens (-).
DescriptionStringNãoNãoDescrição do disco de dados.A descrição deve ter de 2 a 256 caracteres. Não pode começar com http:// ou https://.
SnapshotIdStringNãoNãoSnapshot usado para criar o disco de dados.Nenhuma
SizeStringNãoNãoTamanho do disco do sistema

Valores válidos:

  • cloud: 5 a 2000.
  • cloud_efficiency: 20 a 32768.
  • cloud_ssd: 20 a 32768.
  • ephemeral_ssd: 5 a 800.

Unidade: GB.

EncryptedBooleanNãoNãoIndica se o disco de dados deve ser criptografado.Valores válidos:
  • true: Criptografia ativada.
  • false: Os dados não são criptografados.
DeleteWithInstanceBooleanNãoNãoIndica se o disco de dados deve ser liberado quando a instância for liberada.Valores válidos:
  • true: Aciona a liberação.
  • false: Não libera o disco de dados.
PerformanceLevelStringNãoNãoNível de desempenho do ESSD usado como disco de dados.Valores válidos:
  • PL0 (padrão): Um único disco pode entregar até 10.000 IOPS de leitura/gravação aleatória.
  • PL1: Um único disco pode entregar até 50.000 IOPS de leitura/gravação aleatória.
  • PL2: Um único disco pode entregar até 100.000 IOPS de leitura/gravação aleatória.
  • PL3: Um único disco pode entregar até 1.000.000 IOPS de leitura/gravação aleatória.

Sintaxe de NetworkInterfaces

"NetworkInterfaces": [
  {
    "PrimaryIpAddress": String,
    "VSwitchId": String,
    "SecurityGroupId": String,
    "NetworkInterfaceName": String,
    "Description": String
  }
]

Propriedades de NetworkInterfaces

Nome da propriedade

Tipo

Obrigatório

Atualização permitida

Descrição

Restrições

PrimaryIpAddress

String

Não

Não

Endereço IP privado primário da ENI.

Nenhuma

VSwitchId

String

Não

Não

ID do vSwitch ao qual a ENI pertence.

Nenhuma

SecurityGroupId

String

Não

Não

ID do grupo de segurança ao qual a ENI pertence.

Nenhuma

NetworkInterfaceName

String

Não

Não

Nome da ENI.

Nenhuma

Description

String

Não

Não

Descrição da ENI.

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

Sintaxe de Tags

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

Propriedades de Tags

Propriedade

Tipo

Obrigatório

Atualização permitida

Descrição

Restrições

Key

String

Não

Não

Chave da tag.

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

Value

String

Não

Não

Valor da tag.

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

Sintaxe de TemplateTags

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

Propriedades de TemplateTags

Propriedade

Tipo

Obrigatório

Atualização permitida

Descrição

Restrições

Key

String

Não

Não

Chave da tag.

O valor deve ter de 1 a 128 caracteres, não pode começar com aliyun ou acs:, e não pode conter http:// ou https://.

Value

String

Não

Não

Valor da tag.

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

Valores de retorno

Fn::GetAtt

  • LaunchTemplateId: ID do modelo de inicialização.

  • LaunchTemplateName: Nome do modelo de inicialização.

  • DefaultVersionNumber: Número da versão padrão do modelo de inicialização.

  • LatestVersionNumber: Número da versão mais recente do modelo de inicialização.

Exemplos

  • Formato YAML

    ROSTemplateFormatVersion: '2015-09-01'
    Description: Test ECS LaunchTemplate
    Parameters:
      VSwitchId:
        Type: String
        AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
      SecurityGroupId:
        AssociationProperty: ALIYUN::ECS::SecurityGroup::SecurityGroupId
        Type: String
    Resources:
      LaunchTemplate:
        Type: ALIYUN::ECS::LaunchTemplate
        Properties:
          LaunchTemplateName: mytest
          VersionDescription: Test create LaunchTemplate
          ImageId: centos_7
          InstanceType: ecs.c5.large
          SystemDiskCategory: cloud_essd
          SecurityGroupId:
            Ref: SecurityGroupId
          VSwitchId:
            Ref: VSwitchId
    Outputs: {}
  • Formato JSON

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Description": "Test ECS LaunchTemplate",
      "Parameters": {
        "VSwitchId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId"
        },
        "SecurityGroupId": {
          "AssociationProperty": "ALIYUN::ECS::SecurityGroup::SecurityGroupId",
          "Type": "String"
        }
      },
      "Resources": {
        "LaunchTemplate": {
          "Type": "ALIYUN::ECS::LaunchTemplate",
          "Properties": {
            "LaunchTemplateName": "mytest",
            "VersionDescription": "Test create LaunchTemplate",
            "ImageId": "centos_7",
            "InstanceType": "ecs.c5.large",
            "SystemDiskCategory": "cloud_essd",
            "SecurityGroupId": {
              "Ref": "SecurityGroupId"
            },
            "VSwitchId": {
              "Ref": "VSwitchId"
            }
          }
        }
      },
      "Outputs": {
      }
    }

Para mais exemplos que utilizam um modelo de inicialização do ECS com um grupo de provisionamento automático, consulte o exemplo JSON e o exemplo YAML.