Todos os produtos
Search
Central de documentação

Elastic Compute Service:CreateLaunchTemplate

Última atualização: Oct 16, 2026

Cria um modelo de inicialização de instância ECS. Um modelo de inicialização elimina a necessidade de especificar um grande número de parâmetros de configuração toda vez que você cria uma instância.

Descrição da operação

Após chamar CreateLaunchTemplate para criar um modelo de inicialização, uma versão padrão com o número de versão 1 é gerada automaticamente. Posteriormente, você pode criar várias versões com base neste modelo chamando CreateLaunchTemplateVersion. Os números de versão incrementam sequencialmente a partir de 1. Se você não especificar um número de versão do modelo ao criar uma instância chamando RunInstances, a versão padrão será usada.

Uma versão de um modelo de inicialização de instância contém as configurações necessárias para criar uma instância, como a região, o ID da imagem, o tipo de instância, o ID do grupo de segurança e a largura de banda pública. Se uma configuração específica da instância não for especificada na versão, você deverá especificá-la ao criar a instância.

Ao chamar esta operação, observe os seguintes itens:

  • Você pode criar até 30 modelos de inicialização de instância em uma região para cada conta, e cada modelo pode ter até 30 versões.

  • A maioria dos parâmetros de um modelo de inicialização de instância é opcional. Ao criar um modelo, o Alibaba Cloud não verifica a existência ou a validade dos valores dos parâmetros no modelo. A validade dos valores dos parâmetros é verificada somente quando uma instância é realmente criada.

  • Se uma configuração for definida no modelo de inicialização de instância, você não poderá filtrar essa configuração ao criar uma instância chamando RunInstances. Por exemplo, se o modelo definir HostName=LocalHost e o parâmetro HostName em RunInstances for deixado vazio, o nome do host da instância permanecerá LocalHost. Para substituir a configuração HostName=LocalHost, você pode definir HostName como MyHost ou outro valor em RunInstances.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

TemplateTag

array<object>

Não

As tags do modelo de inicialização.

Nota

Você só pode criar e consultar as tags dos modelos de inicialização chamando operações de API. Você não pode criar ou visualizar as tags no console.

object

Não

As tags do modelo de inicialização.

Key

string

Não

A chave da tag do modelo de inicialização. Valores válidos de N: 1 a 20. Se você especificar este parâmetro, ele não poderá ser uma string vazia. A chave da tag pode ter até 128 caracteres de comprimento. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://.

TestKey

Value

string

Não

O valor da tag do modelo de inicialização. Valores válidos de N: 1 a 20. Se você especificar este parâmetro, ele poderá ser uma string vazia. O valor da tag pode ter até 128 caracteres de comprimento. Não pode começar com aliyun ou acs: e não pode conter http:// ou https://.

TestValue

LaunchTemplateName

string

Sim

O nome do modelo de inicialização de instância. O nome deve ter de 2 a 128 caracteres de comprimento e pode conter letras e caracteres chineses. Deve começar com uma letra ou um caractere chinês e não pode começar com http:// ou https://. Pode conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-).

testLaunchTemplateName

VersionDescription

string

Não

A descrição da versão do modelo de inicialização de instância. A descrição deve ter de 2 a 256 caracteres de comprimento e pode conter letras e caracteres chineses. Não pode começar com http:// ou https://.

testVersionDescription

ImageId

string

Não

O ID da imagem. Este é o recurso de imagem selecionado quando a instância é iniciada. Você pode chamar a operação DescribeImages para consultar os recursos de imagem disponíveis.

win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd

ImageOwnerAlias

string

Não

A origem da imagem. Valores válidos:

  • system: imagens públicas fornecidas pelo Alibaba Cloud.

  • self: imagens personalizadas que você criou.

  • others: imagens compartilhadas de outras contas do Alibaba Cloud.

  • marketplace: imagens fornecidas pelo Alibaba Cloud Marketplace. Você pode usar as imagens do Alibaba Cloud Marketplace que consultou sem precisar assiná-las antecipadamente. Você deve prestar atenção aos detalhes de cobrança das imagens do Alibaba Cloud Marketplace.

system

PasswordInherit

boolean

Não

Especifica se deve ser usada a senha predefinida da imagem.

Nota

Ao especificar este parâmetro, deixe Password vazio e certifique-se de que a imagem selecionada tenha uma senha predefinida.

false

InstanceType

string

Não

As especificações de recursos da instância. Para obter mais informações, consulte Família de instâncias. Você também pode invocar a operação DescribeInstanceTypes para obter a lista de tipos de instância mais recente.

ecs.g5.large

SecurityGroupId

string

Não

O ID do grupo de segurança ao qual a nova instância pertence. Instâncias no mesmo grupo de segurança podem acessar umas às outras. Um grupo de segurança pode gerenciar até 1.000 instâncias.

Nota

Você não pode especificar SecurityGroupId e SecurityGroupIds.N ao mesmo tempo.

sg-bp15ed6xe1yxeycg****

VpcId

string

Não

O ID da nuvem privada virtual (VPC).

vpc-bp12433upq1y5scen****

VSwitchId

string

Não

O ID do vSwitch. Este parâmetro é obrigatório quando você cria uma instância VPC.

vsw-bp1s5fnvk4gn2tws0****

InstanceName

string

Não

O nome da instância. O nome deve ter de 2 a 128 caracteres de comprimento e pode conter caracteres na categoria Letter do Unicode, incluindo letras e dígitos. Pode conter dois-pontos (:), sublinhados (_), pontos (.) e hifens (-). Valor padrão: o InstanceId da instância.

Ao criar várias instâncias ECS, você pode especificar em lote nomes de instância sequenciais, que podem conter colchetes ([]) e vírgulas (,). Para obter mais informações, consulte Especificar em lote nomes de instância ou nomes de host sequenciais.

k8s-node-[1,4]-alibabacloud

Description

string

Não

A descrição da instância. A descrição deve ter de 2 a 256 caracteres de comprimento e pode conter letras e caracteres chineses. Não pode começar com http:// ou https://.

testECSDescription

InternetMaxBandwidthIn

integer

Não

A largura de banda pública de entrada máxima. Unidade: Mbit/s. Valores válidos:

  • Quando a largura de banda pública de saída adquirida for menor ou igual a 10 Mbit/s: 1 a 10. Valor padrão: 10.

  • Quando a largura de banda pública de saída adquirida for maior que 10 Mbit/s: 1 até o valor de InternetMaxBandwidthOut. Valor padrão: o valor de InternetMaxBandwidthOut.

10

InternetMaxBandwidthOut

integer

Não

A largura de banda pública de saída máxima. Unidade: Mbit/s. Valores válidos: 0 a 100.

10

HostName

string

Não

O nome do host do servidor Elastic Compute Service.

  • O nome do host não pode começar ou terminar com um ponto (.) ou um hífen (-). Não pode conter pontos (.) ou hifens (-) consecutivos.

  • Para instâncias Windows, o nome do host deve ter de 2 a 15 caracteres de comprimento e não pode conter pontos (.). Não pode conter apenas dígitos. Pode conter letras maiúsculas e minúsculas, dígitos e hifens (-).

  • Para instâncias de outros sistemas operacionais, como Linux, o nome do host deve ter de 2 a 64 caracteres de comprimento. Pode conter vários segmentos separados por pontos (.). Cada segmento pode conter letras maiúsculas e minúsculas, dígitos e hifens (-).

testHostName

ZoneId

string

Não

O ID da zona da instância.

cn-hangzhou-g

SystemDisk.Category

string

Não

A categoria do disco do sistema. Valores válidos:

  • cloud: disco básico.

  • cloud_efficiency: disco ultra.

  • cloud_ssd: SSD padrão.

  • cloud_essd: ESSD. Você pode usar o parâmetro SystemDisk.PerformanceLevel para definir o nível de desempenho do disco.

  • cloud_auto: disco ESSD AutoPL.

  • cloud_essd_entry: disco ESSD Entry.

Valor padrão: cloud para tipos de instância descontinuados que não são instâncias otimizadas para E/S, e cloud_efficiency para outros tipos de instância.

cloud_ssd

SystemDisk.Size

integer

Não

O tamanho do disco do sistema. Unidade: GiB. Valores válidos:

  • cloud: 20 a 500.

  • Outras categorias de disco: 20 a 2048.

O valor deste parâmetro deve ser maior ou igual a max{20, ImageSize}.

40

SystemDisk.DiskName

string

Não

O nome do disco do sistema. O nome deve ter de 2 a 128 caracteres de comprimento e pode conter letras e caracteres chineses. Deve começar com uma letra ou um caractere chinês e não pode começar com http:// ou https://. Pode conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-).

testSystemDiskName

SystemDisk.Description

string

Não

A descrição do disco do sistema. A descrição deve ter de 2 a 256 caracteres de comprimento e pode conter letras e caracteres chineses. Não pode começar com http:// ou https://.

testSystemDiskDescription

SystemDisk.Iops

integer

Não

Nota

Este parâmetro está em visualização por convite e não está disponível.

null

SystemDisk.PerformanceLevel

string

Não

O nível de desempenho do ESSD usado como disco do sistema. Valores válidos:

  • PL0 (padrão): Um único ESSD pode oferecer até 10.000 IOPS de leitura/gravação aleatória.

  • PL1: Um único ESSD pode oferecer até 50.000 IOPS de leitura/gravação aleatória.

  • PL2: Um único ESSD pode oferecer até 100.000 IOPS de leitura/gravação aleatória.

  • PL3: Um único ESSD pode oferecer até 1.000.000 IOPS de leitura/gravação aleatória.

Para obter mais detalhes sobre como selecionar o nível de desempenho de um ESSD, consulte ESSD.

PL0

SystemDisk.DeleteWithInstance

boolean

Não

Especifica se o disco do sistema deve ser liberado quando a instância for liberada. Valores válidos:

  • true: libera o disco do sistema quando a instância é liberada.

  • false: não libera o disco do sistema quando a instância é liberada.

Valor padrão: true.

true

SystemDisk.AutoSnapshotPolicyId

string

Não

O ID da política de snapshot automático aplicada ao disco do sistema.

sp-gc7c37d4ylw7mtnk****

SystemDisk.ProvisionedIops

integer

Não

O IOPS de leitura/gravação provisionado do disco ESSD AutoPL. Valores válidos: 0 a min{50000, 1000 × Capacity - Baseline performance}.

Baseline performance = min{1800 + 50 × Capacity, 50000}.

Nota

Este parâmetro é suportado apenas quando DiskCategory está definido como cloud_auto. Para obter mais informações, consulte Discos ESSD AutoPL e Modificar as informações provisionadas de um disco ESSD AutoPL.

50000

SystemDisk.BurstingEnabled

boolean

Não

Especifica se o recurso de pico de desempenho deve ser ativado. Valores válidos:

  • true: ativa o recurso.

  • false: desativa o recurso.

true

IoOptimized

string

Não

Especifica se a instância é uma 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.

optimized

InstanceChargeType

string

Não

O método de cobrança da instância. Valores válidos:

  • PrePaid: assinatura. Se você selecionar este método de cobrança, você deve confirmar que sua conta suporta pagamento por crédito. Caso contrário, uma falha InvalidPayMethod será retornada.

  • PostPaid: pay-as-you-go.

PrePaid

Period

integer

Não

O período de assinatura da instância. Unidade: meses. Este parâmetro é válido e obrigatório apenas quando InstanceChargeType está definido como PrePaid. Valores válidos: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 e 60.

1

InternetChargeType

string

Não

O método de cobrança para uso de rede. Valores válidos:

  • PayByBandwidth: pay-by-bandwidth.

  • PayByTraffic: pay-by-traffic.

Nota

No padrão pay-by-traffic, as larguras de banda de pico de entrada e saída são usadas como limites superiores de largura de banda em vez de especificações de desempenho garantido. Em caso de contenção de recursos, as larguras de banda de pico não podem ser garantidas. Se o seu negócio exigir larguras de banda garantidas, use o método de cobrança pay-by-bandwidth.

PayByTraffic

EnableVmOsConfig

boolean

Não

Especifica se a configuração do sistema operacional da instância deve ser ativada.

Nota

Este parâmetro será descontinuado. Para melhorar a compatibilidade, recomendamos que você use outros parâmetros.

false

NetworkType

string

Não

O tipo de rede da instância. Valores válidos:

  • classic: rede clássica. Este tipo de rede está sendo descontinuado. Para obter mais informações, consulte Aviso de descontinuação.

  • vpc: VPC.

vpc

UserData

string

Não

Os dados do usuário da instância. Os dados do usuário da instância devem ser codificados em Base64. O tamanho máximo dos dados brutos é de 32 KB.

ZWNobyBoZWxsbyBlY3Mh

KeyPairName

string

Não

O nome do par de chaves.

  • Para instâncias Windows, este parâmetro é ignorado. Mesmo que você especifique este parâmetro, apenas o parâmetro Password terá efeito.

  • Para instâncias Linux, o método de login por senha é desativado por padrão.

testKeyPairName

RamRoleName

string

Não

O nome da função RAM da instância. Você pode chamar a operação ListRoles fornecida pelo RAM para consultar as funções RAM da instância que você criou.

testRamRoleName

AutoReleaseTime

string

Não

A hora de liberação automática. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

  • Se o valor de ss não for 00, a hora será automaticamente arredondada para baixo para o minuto atual (mm).

  • A hora de liberação mais cedo é meia hora após a hora atual.

  • A hora de liberação mais tarde não pode ser superior a três anos após a hora atual. ISO 8601

2018-01-01T12:05:00Z

SpotStrategy

string

Não

A política de preempção para a instância pay-as-you-go. Este parâmetro só tem efeito quando InstanceChargeType está definido como PostPaid. Valores válidos:

  • NoSpot: A instância é uma instância pay-as-you-go regular.

  • SpotWithPriceLimit: A instância é uma instância spot com um preço máximo por hora definido pelo usuário.

  • SpotAsPriceGo: A instância é uma instância spot para a qual o preço de mercado é usado automaticamente como preço de lance.

NoSpot

SpotPriceLimit

number

Não

O preço máximo por hora da instância. O valor pode ter precisão de até três casas decimais. Este parâmetro só tem efeito quando SpotStrategy está definido como SpotWithPriceLimit.

0.97

SpotDuration

integer

Não

O período de proteção da instância spot. Unidade: horas. Valor padrão: 1. Valores válidos:

  • 1: O Alibaba Cloud garante que a instância não esteja sujeita à liberação automática dentro de 1 hora após sua criação. Após 1 hora, o sistema compara automaticamente o preço de lance com o preço de mercado e verifica o inventário de recursos para determinar se deve reter ou revogar a instância.

  • 0: O Alibaba Cloud não garante que a instância seja retida por 1 hora após sua criação. O sistema compara automaticamente o preço de lance com o preço de mercado e verifica o inventário de recursos para determinar se deve reter ou revogar a instância.

O Alibaba Cloud envia uma notificação usando um evento do sistema ECS 5 minutos antes de a instância ser revogada. As instâncias spot usam o método de cobrança por segundo. Recomendamos que você selecione um período de proteção apropriado com base na duração de execução das suas tarefas.

Nota

Este parâmetro só tem efeito quando SpotStrategy está definido como SpotWithPriceLimit ou SpotAsPriceGo.

1

ResourceGroupId

string

Não

O ID do grupo de recursos corporativos ao qual a instância, o armazenamento em bloco e a interface de rede elástica (ENI) pertencem.

rg-bp67acfmxazb4p****

TemplateResourceGroupId

string

Não

O ID do grupo de recursos corporativos ao qual o modelo de inicialização pertence.

rg-bp67acfmxazb4p****

SecurityEnhancementStrategy

string

Não

Especifica se o endurecimento de segurança para o sistema operacional deve ser ativado. Valores válidos:

  • Active: ativa o endurecimento de segurança. Este valor é aplicável apenas a imagens públicas.

  • Deactive: desativa o endurecimento de segurança. Este valor é aplicável a todos os tipos de imagem.

Deactive

PrivateIpAddress

string

Não

O endereço IP privado da instância.

Ao especificar o endereço IP privado para uma instância ECS em uma VPC, o endereço IP deve ser selecionado do bloco CIDR ocioso do vSwitch especificado por VSwitchId.

10.1.**.**

DeploymentSetId

string

Não

O ID do conjunto de implantação.

ds-bp1brhwhoqinyjd6****

Ipv6AddressCount

integer

Não

O número de endereços IPv6 a serem gerados aleatoriamente para a ENI primária. Valores válidos: 1 a 10.

1

DataDisk

array<object>

Não

A lista de discos de dados.

object

Não

A lista de discos de dados.

PerformanceLevel

string

Não

O nível de desempenho do ESSD usado como disco de dados. O valor de N deve ser igual ao valor de N em DataDisk.N.Category=cloud_essd. Valores válidos:

  • PL0: Um único ESSD pode oferecer até 10.000 IOPS de leitura/gravação aleatória.

  • PL1 (padrão): Um único ESSD pode oferecer até 50.000 IOPS de leitura/gravação aleatória.

  • PL2: Um único ESSD pode oferecer até 100.000 IOPS de leitura/gravação aleatória.

  • PL3: Um único ESSD pode oferecer até 1.000.000 IOPS de leitura/gravação aleatória.

Para obter mais detalhes sobre como selecionar o nível de desempenho de um ESSD, consulte ESSD.

PL1

Description

string

Não

A descrição do disco de dados. A descrição deve ter de 2 a 256 caracteres de comprimento e pode conter letras e caracteres chineses. Não pode começar com http:// ou https://.

testDataDiskDescription

SnapshotId

string

Não

O ID do snapshot usado para criar o disco de dados N. Valores válidos de N: 1 a 16. Se você especificar o parâmetro DataDisk.N.SnapshotId, o parâmetro DataDisk.N.Size será ignorado. O tamanho real do disco criado é o tamanho do snapshot especificado.

Nota

Você não pode usar snapshots criados em ou antes de 15 de julho de 2013. Caso contrário, a solicitação será rejeitada.

s-bp17441ohwka0yuh****

Size

integer

Não

O tamanho do disco de dados N. Valores válidos de N: 1 a 16. Unidade: GiB. Valores válidos:

  • cloud: 5 a 2000.

  • cloud_efficiency: 20 a 32768.

  • cloud_ssd: 20 a 32768.

  • cloud_essd: Os valores válidos estão sujeitos ao valor de DataDisk.N.PerformanceLevel.
    • PL0: 1 a 32768.

    • PL1: 20 a 32768.

    • PL2: 461 a 32768.

    • PL3: 1261 a 32768.

  • cloud_auto: 1 a 32768.

  • cloud_essd_entry: 10 a 32768.

O valor deste parâmetro deve ser maior ou igual ao tamanho do snapshot especificado pelo parâmetro SnapshotId.

2000

Device

string

Não

O ponto de montagem do disco de dados. A convenção de nomenclatura para pontos de montagem varia com base no número de discos de dados anexados:

  • 1 a 25 discos de dados: /dev/xvd[b-z].

  • Mais de 25 discos de dados: /dev/xvd[aa-zz]. Por exemplo, o 26º disco de dados é nomeado /dev/xvdaa, e o 27º disco de dados é nomeado /dev/xvdab.

Nota

Este parâmetro é aplicável apenas a imagens completas. Você pode definir este parâmetro como o ponto de montagem do disco de dados na imagem completa e modificar os parâmetros DataDisk.N.Size e DataDisk.N.Category para alterar a categoria e o tamanho do disco de dados na imagem completa.

/dev/xvdb

DiskName

string

Não

O nome do disco de dados. O nome deve ter de 2 a 128 caracteres de comprimento e pode conter letras e caracteres chineses. Deve começar com uma letra ou um caractere chinês e não pode começar com http:// ou https://. Pode conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-).

testDataDiskName

Category

string

Não

A categoria do disco de dados N. Valores válidos:

  • cloud_efficiency: disco ultra.

  • cloud_ssd: SSD padrão.

  • cloud_essd: ESSD.

  • cloud: disco básico.

  • cloud_auto: disco ESSD AutoPL.

  • cloud_regional_disk_auto: ESSD regional.

  • cloud_essd_entry: disco ESSD Entry.
    Nota

    Este parâmetro pode ser definido como cloud_essd_entry apenas quando InstanceType está definido como um tipo de instância na família de instâncias ecs.u1 ou ecs.e.

  • elastic_ephemeral_disk_standard: disco efêmero elástico padrão.

  • elastic_ephemeral_disk_premium: disco efêmero elástico Premium Edition.

Valores padrão: cloud_efficiency para instâncias otimizadas para E/S e cloud para instâncias não otimizadas para E/S. Descrição do valor padrão:

  • Se o tipo de instância for um tipo de instância descontinuado e não otimizado para E/S, o valor padrão é cloud.

  • Em outros casos, o valor padrão é cloud_efficiency.

cloud_ssd

DeleteWithInstance

boolean

Não

Especifica se o disco de dados deve ser liberado quando a instância for liberada. Valores válidos:

  • true: libera o disco de dados quando a instância é liberada.

  • false: não libera o disco de dados quando a instância é liberada.

Valor padrão: true.

true

Encrypted

string

Não

Especifica se o disco de dados deve ser criptografado.

false

AutoSnapshotPolicyId

string

Não

O ID da política de snapshot automático aplicada ao disco de dados.

sp-m5e7fa9ute44ssa****

ProvisionedIops

integer

Não

O IOPS de leitura/gravação provisionado do disco ESSD AutoPL. Valores válidos: 0 a min{50000, 1000 × Capacity - Baseline performance}.

Baseline performance = min{1800 + 50 × Capacity, 50000}.

Nota

Este parâmetro é suportado apenas quando DiskCategory está definido como cloud_auto. Para obter mais informações, consulte Discos ESSD AutoPL e Modificar as informações provisionadas de um disco ESSD AutoPL.

50000

BurstingEnabled

boolean

Não

Especifica se o recurso de pico de desempenho deve ser ativado. Valores válidos:

  • true: ativa o recurso.

  • false: desativa o recurso.

true

KMSKeyId

string

Não

O ID da chave do Key Management Service (KMS) usada para criptografar o disco de dados.

0e478b7a-4262-4802-b8cb-00d****

NetworkInterface

array<object>

Não

As informações da Elastic Network Interface (ENI).

object

Não

As informações da Elastic Network Interface (ENI).

VSwitchId

string

Não

O ID do vSwitch ao qual a ENI pertence.

Nota:

  • Valores válidos de N: 1 a 2. Ao configurar uma ENI, você pode configurar uma ENI primária ou uma ENI secundária. Ao configurar duas ENIs, você pode configurar apenas uma ENI primária e uma ENI secundária ao mesmo tempo.

  • Se NetworkInterface.N.InstanceType estiver definido como Primary, você deve especificar este parâmetro. Nesse caso, este parâmetro tem a mesma finalidade que VSwitchId, mas você não pode especificar VSwitchId e este parâmetro ao mesmo tempo.

  • Se NetworkInterface.N.InstanceType estiver definido como Secondary ou deixado vazio, este parâmetro é opcional. O valor padrão é o vSwitch ao qual a instância ECS pertence.

vsw-bp1s5fnvk4gn2tws0****

NetworkInterfaceName

string

Não

O nome da ENI.

Nota:

  • Valores válidos de N: 1 a 2. Ao configurar uma ENI, você pode configurar uma ENI primária ou uma ENI secundária. Ao configurar duas ENIs, você pode configurar apenas uma ENI primária e uma ENI secundária ao mesmo tempo.

  • Se NetworkInterface.N.InstanceType estiver definido como Primary, você não precisa especificar este parâmetro.

testEniName

Description

string

Não

A descrição da ENI secundária. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://. O valor de N em NetworkInterface.N não pode ser maior que 1.

testEniDescription

SecurityGroupId

string

Não

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

Nota:

  • Valores válidos de N: 1 a 2. Ao configurar uma ENI, você pode configurar uma ENI primária ou uma ENI secundária. Ao configurar duas ENIs, você pode configurar apenas uma ENI primária e uma ENI secundária ao mesmo tempo.

  • Se NetworkInterface.N.InstanceType estiver definido como Primary, você deve especificar este parâmetro. Nesse caso, este parâmetro tem a mesma finalidade que SecurityGroupId, mas você não pode especificar SecurityGroupId, SecurityGroupIds.N ou NetworkInterface.N.SecurityGroupIds.N ao mesmo tempo.

  • Se NetworkInterface.N.InstanceType estiver definido como Secondary ou deixado vazio, este parâmetro é opcional. O valor padrão é o grupo de segurança ao qual a instância ECS pertence.

sg-bp15ed6xe1yxeycg****

PrimaryIpAddress

string

Não

Adiciona uma ENI e configura o endereço IP primário.

Nota:

  • Valores válidos de N: 1 a 2:

    • Ao configurar uma ENI, você pode configurar uma ENI primária ou uma ENI secundária. Se o parâmetro Amount estiver definido com um valor maior que 1, e você configurar uma ENI primária e especificar este parâmetro, endereços IP primários consecutivos começando a partir do endereço IP primário especificado serão alocados para várias instâncias ECS criadas em lote. Observe que você não pode vincular ENIs secundárias às instâncias neste caso.

    • Ao configurar duas ENIs, você pode configurar apenas uma ENI primária e uma ENI secundária ao mesmo tempo. Observe que, se o parâmetro Amount estiver definido com um valor maior que 1 e você especificar este parâmetro para a ENI primária, não poderá configurar uma ENI secundária (ou seja, não pode definir NetworkInterface.2.InstanceType=Secondary).

  • Se NetworkInterface.N.InstanceType estiver definido como Primary, este parâmetro tem a mesma finalidade que PrivateIpAddress, mas você não pode especificar PrivateIpAddress e este parâmetro ao mesmo tempo.

  • Se NetworkInterface.N.InstanceType estiver definido como Secondary ou deixado vazio, este parâmetro especifica o endereço IP primário para a ENI secundária. Por padrão, um endereço IP é selecionado aleatoriamente do bloco CIDR do vSwitch ao qual a ENI pertence.

Nota

Ao criar uma instância ECS, você pode adicionar apenas uma ENI secundária. Após a criação da instância, você pode chamar as operações CreateNetworkInterface e AttachNetworkInterface para adicionar mais ENIs secundárias.

192.168.**.**

SecurityGroupIds

array

Não

Os IDs de um ou mais grupos de segurança aos quais a ENI pertence.

  • Os valores válidos do primeiro N são de 1 a 2. Ao configurar uma ENI, você pode configurar uma ENI primária ou uma ENI secundária. Ao configurar duas ENIs, você pode configurar apenas uma ENI primária e uma ENI secundária ao mesmo tempo.

  • O segundo N especifica um ou mais IDs de grupo de segurança. Os valores válidos de N dependem da cota de grupos de segurança aos quais uma instância pode ser adicionada. Para mais informações, consulte Limites de grupos de segurança.

Nota:

  • Se NetworkInterface.N.InstanceType estiver definido como Primary, você deve especificar este parâmetro ou NetworkInterface.N.SecurityGroupId. Nesse caso, este parâmetro tem a mesma finalidade que SecurityGroupIds.N, mas você não pode especificar SecurityGroupId, SecurityGroupIds.N ou NetworkInterface.N.SecurityGroupId ao mesmo tempo.

  • Se NetworkInterface.N.InstanceType estiver definido como Secondary ou deixado vazio, este parâmetro é opcional. O valor padrão é o grupo de segurança ao qual a instância ECS pertence.

sg-bp67acfmxazb4p****

string

Não

Os IDs de um ou mais grupos de segurança aos quais a ENI pertence.

  • Os valores válidos do primeiro N são de 1 a 2. Ao configurar uma ENI, você pode configurar uma ENI primária ou uma ENI secundária. Ao configurar duas ENIs, você pode configurar apenas uma ENI primária e uma ENI secundária ao mesmo tempo.

  • O segundo N especifica um ou mais IDs de grupo de segurança. Os valores válidos de N dependem da cota de grupos de segurança aos quais uma instância pode ser adicionada. Para mais informações, consulte Limites de grupos de segurança.

Nota:

  • Se NetworkInterface.N.InstanceType estiver definido como Primary, você deve especificar este parâmetro ou NetworkInterface.N.SecurityGroupId. Nesse caso, este parâmetro tem a mesma finalidade que SecurityGroupIds.N, mas você não pode especificar SecurityGroupId, SecurityGroupIds.N ou NetworkInterface.N.SecurityGroupId ao mesmo tempo.

  • Se NetworkInterface.N.InstanceType estiver definido como Secondary ou deixado vazio, este parâmetro é opcional. O valor padrão é o grupo de segurança ao qual a instância ECS pertence.

sg-bp67acfmxazb4p****

InstanceType

string

Não

O tipo da ENI. Valores válidos de N: 1 a 2. Ao configurar uma ENI, você pode configurar uma ENI primária ou uma ENI secundária. Ao configurar duas ENIs, você pode configurar apenas uma ENI primária e uma ENI secundária ao mesmo tempo.

Valores válidos do parâmetro:

  • Primary: ENI primária.

  • Secondary: ENI secundária.

Valor padrão: Secondary.

Secondary

NetworkInterfaceTrafficMode

string

Não

O modo de comunicação da ENI primária. Valores válidos:

  • Standard: usa o modo de comunicação TCP.

  • HighPerformance: ativa a Elastic RDMA Interface (ERI) e usa o modo de comunicação RDMA.

Standard

DeleteOnRelease

boolean

Não

Especifica se a ENI deve ser retida quando a instância for liberada. Valores válidos:

  • true: não retém a ENI.

  • false: retém a ENI.

Valor padrão: true.

Nota

Este parâmetro só entra em vigor para ENIs secundárias.

true

Tag

array<object>

Não

As informações de tag das instâncias, discos em nuvem e ENIs primárias criados usando esta versão do modelo de inicialização.

Cenários

Depois de chamar a operação CreateLaunchTemplate para criar um modelo de inicialização e usar a versão padrão gerada automaticamente para criar instâncias, esta tag é usada para marcar as instâncias, os discos em nuvem e as ENIs primárias.

object

Não

As informações de tag das instâncias, discos em nuvem e ENIs primárias criados usando esta versão do modelo de inicialização.

Key

string

Não

A chave da tag das instâncias, discos em nuvem e ENIs primárias criados usando esta versão do modelo de inicialização. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Pode ter até 128 caracteres e não pode começar com aliyun ou acs:. Não pode conter http:// ou https://.

TestKey

Value

string

Não

O valor da tag das instâncias, discos em nuvem e ENIs primárias criados usando esta versão do modelo de inicialização. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia. Pode ter até 128 caracteres e não pode conter http:// ou https://.

TestValue

SecurityGroupIds

array

Não

Os IDs de um ou mais grupos de segurança aos quais a instância é adicionada. Os valores válidos de N dependem da cota de grupos de segurança aos quais uma instância pode ser adicionada. Para mais informações, consulte Limites.

Nota

Você não pode especificar SecurityGroupId e SecurityGroupIds.N ao mesmo tempo.

sg-bp15ed6xe1yxeycg7****

string

Não

Os IDs de um ou mais grupos de segurança aos quais a instância é adicionada. Os valores válidos de N dependem da cota de grupos de segurança aos quais uma instância pode ser adicionada. Para mais informações, consulte Limites.

Nota

Você não pode especificar SecurityGroupId e SecurityGroupIds.N ao mesmo tempo.

sg-bp15ed6xe1yxeycg7****

SystemDisk.Encrypted

string

Não

Especifica se o disco do sistema deve ser criptografado. Valores válidos:

  • true: criptografa o disco do sistema.

  • false: não criptografa o disco do sistema.

Valor padrão: false.

Nota

Você não pode criptografar o disco do sistema ao criar uma instância na Zona D da região de Hong Kong (China) ou na Zona A da região de Cingapura.

false

DeletionProtection

boolean

Não

A propriedade de proteção contra liberação da instância. Especifica se a instância pode ser liberada usando o console ou chamando a operação DeleteInstance. Valores válidos:

  • true: ativa a proteção contra liberação para a instância.

  • false: desativa a proteção contra liberação para a instância.

Valor padrão: false.

Nota

Esta propriedade se aplica apenas a instâncias pay-as-you-go. Ela pode impedir apenas operações de liberação manuais, mas não operações de liberação do sistema.

false

CreditSpecification

string

Não

O modo de desempenho da instância burstable. Valores válidos:

Standard

AutoRenew

boolean

Não

Especifica se a renovação automática deve ser ativada. Valores válidos:

  • true: ativa a renovação automática.

  • false: desativa a renovação automática.

Valor padrão: false.

Nota

Este parâmetro só entra em vigor quando o parâmetro InstanceChargeType está definido como PrePaid.

true

AutoRenewPeriod

integer

Não

A duração da renovação automática. Valores válidos:

Valores válidos quando PeriodUnit está definido como Month: 1, 2, 3, 6, 12, 24, 36, 48 e 60.

Valor padrão: 1.

1

PeriodUnit

string

Não

A unidade de tempo para os métodos de cobrança por assinatura. Valores válidos:

Month (padrão).

Month

HttpEndpoint

string

Não

Especifica se o canal de acesso para metadados da instância deve ser ativado. Valores válidos:

  • enabled: ativa o canal de acesso.

  • disabled: desativa o canal de acesso.

Valor padrão: enabled.

Nota

Para mais informações sobre metadados da instância, consulte Visão geral dos metadados da instância.

enabled

HttpTokens

string

Não

Especifica se o modo de reforço de segurança (IMDSv2) deve ser usado obrigatoriamente para acessar os metadados da instância. Valores válidos:

  • optional: não usa obrigatoriamente o modo de reforço de segurança.

  • required: usa obrigatoriamente o modo de reforço de segurança. Depois de definir este parâmetro como required, você não pode acessar os metadados da instância no modo normal.

Valor padrão: optional.

Nota

Para mais informações sobre os modos de acesso aos metadados da instância, consulte Visão geral dos metadados da instância.

optional

HttpPutResponseHopLimit

integer

Não

Nota

Este parâmetro não está disponível.

3

SystemDisk.KMSKeyId

string

Não

O ID da chave KMS do disco do sistema.

0e478b7a-4262-4802-b8cb-00d3fb40****

ImageOptions

object

Não

As informações de propriedade relacionadas à imagem.

LoginAsNonRoot

boolean

Não

Especifica se a instância que usa esta imagem oferece suporte ao login como o usuário ecs-user. Valores válidos:

  • true: sim.

  • false: não.

false

SecurityOptions

object

Não

As opções de segurança.

TrustedSystemMode

string

Não

O padrão de sistema confiável. Valor válido: vTPM.

Atualmente, o padrão de sistema confiável oferece suporte às seguintes famílias de instâncias:

  • g7, c7 e r7.

  • famílias de instâncias com segurança aprimorada (g7t, c7t e r7t).

Ao criar uma instância ECS das famílias de instâncias anteriores, você deve configurar este parâmetro. Detalhes:

  • Se você usar o sistema confiável do Alibaba Cloud, configure este parâmetro como vTPM. Dessa forma, o sistema confiável do Alibaba Cloud realiza a verificação de confiança quando a instância é iniciada.

  • Se você não usar o sistema confiável do Alibaba Cloud, poderá deixar este parâmetro vazio. No entanto, se a instância ECS que você criar usar o padrão de computação confidencial Enclave (SecurityOptions.ConfidentialComputingMode=Enclave), o sistema confiável também será ativado para a instância ECS.

  • Ao criar uma instância ECS com o sistema confiável ativado chamando uma operação de API, você só pode chamar a operação RunInstances. A operação CreateInstance não oferece suporte à configuração do parâmetro SecurityOptions.TrustedSystemMode.

Nota

Se você especificar uma instância como uma instância confiável ao criá-la, só poderá usar uma imagem que ofereça suporte ao sistema confiável ao substituir o disco do sistema.

Para mais informações sobre o sistema confiável, consulte Visão geral do recurso de confiança para famílias de instâncias com segurança aprimorada.

vTPM

EnableSecureBoot

boolean

Não

Especifica se a inicialização segura deve ser ativada.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

LaunchTemplateId

string

O ID do modelo de inicialização.

lt-m5eiaupmvm2op9d****

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

LaunchTemplateVersionNumber

integer

O número da versão do modelo de inicialização.

20

Exemplos

Resposta de sucesso

JSON formato

{
  "LaunchTemplateId": "lt-m5eiaupmvm2op9d****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "LaunchTemplateVersionNumber": 20
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidRegion.NotExist %s A região especificada não existe. Verifique se o parâmetro está correto.
400 MissingParameter %s Um parâmetro obrigatório está ausente.
400 InvalidParameter %s Os parâmetros da solicitação atual são inválidos. Tente novamente.
400 InvalidLaunchTemplateName.Malformed The specified parameter LaunchTemplateName is not valid. O parâmetro LaunchTemplateName especificado é inválido.
400 InvalidDescription.Malformed The specified parameter "VersionDescription" is not valid.
400 InvalidUserData.SizeExceeded %s O UserData especificado excede o limite de tamanho.
400 InvalidUserData.Base64FormatInvalid %s O UserData especificado é inválido.
400 Duplicate.TagKey The Tag.N.Key contain duplicate key. Existem chaves duplicadas nas tags. Certifique-se de que as chaves sejam únicas.
400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. O parâmetro de chave de tag especificado é inválido.
400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. O parâmetro de valor da tag especificado é inválido.
400 InvalidHostName.Malformed The specified parameter "HostName" is not valid. O parâmetro HostName especificado é inválido.
400 InvalidParams.CreateEniParams %s
500 InternalError The request processing has failed due to some unknown error.
403 LaunchTemplateLimitExceed %s O número de modelos de inicialização excede o limite.
403 LaunchTemplateName.Duplicated %s O nome do modelo de inicialização especificado já existe.
403 QuotaExceed.Tags %s O número de tags excede o limite máximo configurável. %s é uma variável que retorna dinamicamente uma mensagem de erro com base na situação real quando você chama a API.
403 InvalidOperation.InstanceTypeSecureBootUnsupported The instance type does not support secure boot. O tipo de instância não oferece suporte ao Secure Boot.
403 InvalidOperation.SecureBootRegionNotSupported Secure Boot is not available in the specified region. O Secure Boot para instâncias não é suportado na região atual.
404 InvalidResourceGroup.NotFound The ResourceGroup provided does not exist in our records. O grupo de recursos especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.