Todos os produtos
Search

Este produto

    Elastic Compute Service:CreateLaunchTemplate

    Central de documentação

    Elastic Compute Service:CreateLaunchTemplate

    Última atualização: Jul 03, 2026

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

    Descrição da operação

    Após chamar CreateLaunchTemplate para criar um modelo, uma versão padrão com o número de versão 1 é gerada automaticamente. Você pode então criar várias versões com base neste modelo (CreateLaunchTemplateVersion), com números de versão incrementando sequencialmente a partir de 1. Se você não especificar uma versão do modelo ao criar instâncias (RunInstances), a versão padrão será usada.

    Uma versão do modelo de inicialização contém as configurações para criar instâncias, 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 não for especificada na versão, você deverá especificá-la ao criar instâncias.

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

    • Cada conta pode criar até 30 modelos de inicialização por região, e cada modelo pode ter até 30 versões.

    • A maioria dos parâmetros em um modelo de inicialização é opcional. Ao criar um modelo, o Alibaba Cloud não verifica a existência ou a validade dos valores dos parâmetros. A validade dos valores dos parâmetros é verificada apenas quando você cria instâncias.

    • Se uma configuração for especificada no modelo de inicialização, ela não poderá ser filtrada ao criar instâncias (RunInstances). Por exemplo, se o modelo especificar HostName=LocalHost e o valor de HostName for deixado em branco em RunInstances, o nome do host da instância ainda será LocalHost. Para substituir a configuração HostName=LocalHost, defina HostName=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

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    ecs:CreateLaunchTemplate

    create

    *LaunchTemplate

    acs:ecs:{#regionId}:{#accountId}:launchtemplate/*

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    RegionId

    string

    Sim

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

    cn-hangzhou
    TemplateTag

    array<object>

    Não

    Os pares chave-valor de tag do próprio modelo de inicialização.

    Nota

    Atualmente, você pode criar e consultar tags para modelos de inicialização apenas usando operações de API. O console não oferece suporte à criação ou visualização dessas tags.

    object

    Não

    Os pares chave-valor de tag do próprio modelo de inicialização.

    Key

    string

    Não

    A chave de tag do modelo de inicialização. Valores válidos de N: 1 a 20. A chave de tag não pode ser uma string vazia. A chave de tag pode ter até 128 caracteres e não pode começar com aliyun ou acs:. A chave de tag não pode conter http:// ou https://.

    TestKey
    Value

    string

    Não

    O valor de tag do modelo de inicialização. Valores válidos de N: 1 a 20. O valor de tag pode ser uma string vazia. O valor de tag pode ter até 128 caracteres e não pode começar com aliyun ou acs:. O valor de tag não pode conter http:// ou https://.

    TestValue
    RegionId

    string

    Sim

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

    cn-hangzhou
    LaunchTemplateName

    string

    Sim

    O nome do modelo de inicialização. O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra e não pode começar com http:// ou https://. O nome 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. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.

    testVersionDescription
    ImageId

    string

    Não

    O ID da imagem. Você pode chamar 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: uma imagem pública fornecida pelo Alibaba Cloud.

    • self: uma imagem personalizada que você criou.

    • others: uma imagem compartilhada de outra conta do Alibaba Cloud.

    • marketplace: uma imagem do Alibaba Cloud Marketplace. Você pode usar imagens do Alibaba Cloud Marketplace diretamente sem precisar assiná-las primeiro. Verifique os detalhes de cobrança da imagem do Alibaba Cloud Marketplace por conta própria.

    system
    PasswordInherit

    boolean

    Não

    Especifica se deve ser usada a senha predefinida na imagem.

    Nota

    Ao usar este parâmetro, o parâmetro Password deve estar vazio. Certifique-se de que a imagem usada tenha uma senha configurada.

    false
    InstanceType

    string

    Não

    O tipo de instância. Para mais informações, consulte Família de instâncias. Você também pode invocar DescribeInstanceTypes para consultar 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 instância pertence. Instâncias no mesmo grupo de segurança podem se comunicar entre si. Um grupo de segurança pode conter até 1.000 instâncias.

    Nota

    Você não pode especificar SecurityGroupId e SecurityGroupIds.N simultaneamente.

    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 ao criar uma instância conectada à VPC.

    vsw-bp1s5fnvk4gn2tws0****
    InstanceName

    string

    Não

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

    Ao criar várias instâncias ECS, você pode especificar nomes de instância sequenciais. Os nomes podem conter colchetes ([]) e vírgulas (,). Para mais informações, consulte Especificar 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 e 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:

    • Se 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.

    • Se 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.

    • Instâncias Windows: O nome do host deve ter de 2 a 15 caracteres e não pode conter pontos (.) ou consistir inteiramente em dígitos. Pode conter letras, dígitos e hifens (-).

    • Outras instâncias (como Linux): O nome do host deve ter de 2 a 64 caracteres. Pode conter vários pontos (.), com cada segmento entre pontos permitindo letras, 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: ultra disco.

    • cloud_ssd: SSD padrão.

    • cloud_essd: SSD empresarial (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.

    Para tipos de instância descontinuados que não são otimizados para I/O, o valor padrão é cloud. Caso contrário, o valor padrão é cloud_efficiency.

    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. Deve começar com uma letra e não pode começar com http:// ou https://. O nome 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 e não pode começar com http:// ou https://.

    testSystemDiskDescription
    SystemDisk.Iops

    integer

    Não

    Nota

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

    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 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.

    Para obter informações sobre como selecionar um nível de desempenho de ESSD, consulte SSDs empresariais.

    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{1,800 + 50 × Capacity, 50,000}

    Nota

    Este parâmetro é suportado apenas quando DiskCategory está definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL e Modificar o desempenho provisionado 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 de pico de desempenho.

    • false: não ativa o recurso de pico de desempenho.

    true
    IoOptimized

    string

    Não

    Especifica se a instância é otimizada para I/O. Valores válidos:

    • none: não otimizada para I/O.

    • optimized: otimizada para I/O.

    optimized
    InstanceChargeType

    string

    Não

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

    • PrePaid: assinatura. Se você definir este parâmetro como PrePaid, confirme se sua conta oferece suporte a pagamentos de crédito. Caso contrário, um erro InvalidPayMethod será retornado.

    • PostPaid: pós-pago.

    PrePaid
    Period

    integer

    Não

    A duração da assinatura do recurso. Unidade: meses. Este parâmetro entra em vigor 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: pagamento por largura de banda.

    • PayByTraffic: pagamento por tráfego.

    Nota

    No modo pagamento por tráfego, as larguras de banda de entrada e saída de pico são usadas como limites superiores de largura de banda em vez de métricas de serviço garantidas. Quando ocorre contenção de recursos, a largura de banda de pico pode ser limitada. Se suas cargas de trabalho exigirem largura de banda garantida, use o modo pagamento por largura de banda.

    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 melhor compatibilidade, use outros parâmetros.

    false
    NetworkType

    string

    Não

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

    • classic: rede clássica. Este recurso foi descontinuado. Para 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 devem ser codificados em Base64. O tamanho máximo dos dados brutos é 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 conteúdo de Password será usado.

    • Para instâncias Linux, o login baseado em senha é desativado durante a inicialização.

    testKeyPairName
    RamRoleName

    string

    Não

    O nome da função RAM da instância. Você pode chamar a API RAM ListRoles 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 dos segundos (ss) não for 00, a hora é automaticamente arredondada para baixo para o início do minuto atual (mm).

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

    • A hora de liberação mais tardia não pode ser superior a três anos a partir da hora atual.

    2018-01-01T12:05:00Z
    SpotStrategy

    string

    Não

    A política de preempção para a instância pós-paga. Este parâmetro entra em vigor quando InstanceChargeType está definido como PostPaid. Valores válidos:

    • NoSpot: A instância é uma instância pós-paga 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 no momento da compra é usado automaticamente como preço de lance.

    NoSpot
    SpotPriceLimit

    number

    Não

    O preço máximo por hora da instância. Este parâmetro suporta até três casas decimais e entra em vigor 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: Após a criação de uma instância spot, o Alibaba Cloud garante que a instância não seja liberada automaticamente dentro de 1 hora. Após o término do período de proteção de 1 hora, o sistema compara o preço de lance com o preço de mercado e verifica o inventário de recursos para determinar se deve reter ou liberar automaticamente a instância.

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

    O Alibaba Cloud envia uma notificação de evento do sistema ECS 5 minutos antes de a instância ser liberada. Instâncias spot são cobradas por segundo. Selecione um período de proteção apropriado com base na duração esperada de execução da tarefa.

    Nota

    Este parâmetro entra em vigor apenas quando SpotStrategy está definido como SpotWithPriceLimit ou SpotAsPriceGo.

    1
    ResourceGroupId

    string

    Não

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

    rg-bp67acfmxazb4p****
    TemplateResourceGroupId

    string

    Não

    O ID do grupo de recursos 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: não ativa 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 um endereço IP privado para uma instância ECS conectada à VPC, o endereço IP deve ser do bloco CIDR ocioso do vSwitch (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 gerados aleatoriamente para atribuir à ENI primária. Valores válidos: 1 a 10.

    1
    DataDisk

    array<object>

    Não

    A lista de informações do disco de dados.

    object

    Não

    A lista de informações do disco de dados.

    PerformanceLevel

    string

    Não

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

    • PL0: um único disco pode entregar até 10.000 IOPS de leitura/gravação aleatória.

    • PL1 (padrão): 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.

    Para obter informações sobre como selecionar um nível de desempenho de ESSD, consulte SSDs empresariais.

    PL1
    Description

    string

    Não

    A descrição do disco de dados. A descrição deve ter de 2 a 256 caracteres e 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. Após especificar DataDisk.N.SnapshotId, o parâmetro DataDisk.N.Size é 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. Tais solicitações são rejeitadas.

    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: O intervalo de valores válidos depende do 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 32.768.

    • cloud_essd_entry: 10 a 32.768.

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

    2000
    Device

    string

    Não

    O ponto de montagem do disco de dados. A convenção de nomenclatura 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, o 27º disco de dados é nomeado /dev/xvdab, e assim por diante.

    Nota

    Este parâmetro é destinado apenas a cenários de imagem completa (imagem de máquina inteira). Você pode definir este parâmetro para o ponto de montagem de um disco de dados na imagem completa e modificar os parâmetros correspondentes 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. Deve começar com uma letra e não pode começar com http:// ou https://. O nome 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: ultra disco.

    • cloud_ssd: SSD padrão.

    • cloud_essd: SSD empresarial.

    • cloud: disco básico.

    • cloud_auto: disco ESSD AutoPL.

    • cloud_regional_disk_auto: ESSD regional.

    • cloud_essd_entry: disco ESSD Entry.
      Nota

      O valor cloud_essd_entry é suportado apenas quando InstanceType está definido para a 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 - Edição Premium.

    Para instâncias otimizadas para I/O, o valor padrão é cloud_efficiency. Para instâncias não otimizadas para I/O, o valor padrão é cloud. Descrição do valor padrão:

    • Se InstanceType for um tipo de instância descontinuado que não é otimizado para I/O, o valor padrão deste parâmetro é 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{1,800 + 50 × Capacity, 50,000}

    Nota

    Este parâmetro é suportado apenas quando DiskCategory está definido como cloud_auto. Para mais informações, consulte Discos ESSD AutoPL e Modificar o desempenho provisionado 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 de pico de desempenho.

    • false: não ativa o recurso de pico de desempenho.

    true
    KMSKeyId

    string

    Não

    O ID da chave KMS para o disco de dados.

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

    array<object>

    Não

    As informações da controladora de interface de rede (NIC).

    object

    Não

    As informações da controladora de interface de rede (NIC).

    VSwitchId

    string

    Não

    O ID do vSwitch da controladora de interface de rede (NIC).

    Observe os seguintes itens:

    • Valores válidos de N: 1 a 2. Se você definir N como 1, poderá configurar uma NIC primária ou secundária. Se você definir N como 2, deverá configurar uma NIC primária e uma NIC secundária.

    • Se NetworkInterface.N.InstanceType estiver definido como Primary, este parâmetro é obrigatório. Este parâmetro tem o mesmo efeito que VSwitchId, mas você não pode especificar este parâmetro e VSwitchId simultaneamente.

    • Se NetworkInterface.N.InstanceType estiver definido como Secondary ou deixado em branco, este parâmetro é opcional. Valor padrão: o vSwitch da instância ECS.

    vsw-bp1s5fnvk4gn2tws0****
    NetworkInterfaceName

    string

    Não

    O nome da controladora de interface de rede (NIC).

    Observe os seguintes itens:

    • Valores válidos de N: 1 a 2. Se você definir N como 1, poderá configurar uma NIC primária ou secundária. Se você definir N como 2, deverá configurar uma NIC primária e uma NIC secundária.

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

    testEniName
    Description

    string

    Não

    A descrição da controladora de interface de rede (NIC) 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 controladora de interface de rede (NIC) pertence.

    Observe os seguintes itens:

    • Valores válidos de N: 1 a 2. Se você definir N como 1, poderá configurar uma NIC primária ou secundária. Se você definir N como 2, deverá configurar uma NIC primária e uma NIC secundária.

    • Se NetworkInterface.N.InstanceType estiver definido como Primary, você deve definir este parâmetro. Este parâmetro tem o mesmo efeito que SecurityGroupId, mas você não pode especificar SecurityGroupId, SecurityGroupIds.N ou NetworkInterface.N.SecurityGroupIds.N.

    • Se NetworkInterface.N.InstanceType estiver definido como Secondary ou deixado em branco, este parâmetro é opcional. Valor padrão: o grupo de segurança da instância ECS.

    sg-bp15ed6xe1yxeycg****
    PrimaryIpAddress

    string

    Não

    Adiciona uma controladora de interface de rede (NIC) e define o endereço IP primário.

    Observe os seguintes itens:

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

      • Se você definir N como 1, poderá configurar uma NIC primária ou secundária. Se o parâmetro Amount estiver definido como um valor maior que 1 e você configurar uma NIC primária com este parâmetro especificado, endereços IP primários consecutivos começando a partir do endereço IP especificado serão alocados para várias instâncias ECS em lote. Neste caso, você não pode anexar uma NIC secundária às instâncias.

      • Se você definir N como 2, deverá configurar uma NIC primária e uma NIC secundária. Se o parâmetro Amount estiver definido como um valor maior que 1 e este parâmetro for especificado para a NIC primária, você não poderá configurar uma NIC secundária (ou seja, não poderá definir NetworkInterface.2.InstanceType=Secondary).

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

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

    Nota

    Ao criar uma instância ECS, você pode anexar até uma NIC secundária. Após a criação da instância, você pode invocar CreateNetworkInterface e AttachNetworkInterface para anexar mais NICs secundárias.

    192.168.**.**
    SecurityGroupIds

    array

    Não

    Os IDs de um ou mais grupos de segurança aos quais a controladora de interface de rede (NIC) pertence.

    • O primeiro N tem um intervalo de valores válidos de 1 a 2. Se você definir N como 1, poderá configurar uma NIC primária ou secundária. Se você definir N como 2, deverá configurar uma NIC primária e uma NIC secundária.

    • O segundo N especifica um ou mais IDs de grupo de segurança. O intervalo de valores válidos de N depende do número máximo de grupos de segurança aos quais uma instância pode pertencer. Para mais informações, consulte Limites de grupo de segurança.

    Observe os seguintes itens:

    • Se NetworkInterface.N.InstanceType estiver definido como Primary, você deve definir este parâmetro ou NetworkInterface.N.SecurityGroupId. Este parâmetro tem o mesmo efeito que SecurityGroupIds.N, mas você não pode especificar SecurityGroupId, SecurityGroupIds.N ou NetworkInterface.N.SecurityGroupId.

    • Se NetworkInterface.N.InstanceType estiver definido como Secondary ou deixado em branco, este parâmetro é opcional. Valor padrão: o grupo de segurança da instância ECS.

    sg-bp67acfmxazb4p****

    string

    Não

    Os IDs de um ou mais grupos de segurança aos quais a controladora de interface de rede (NIC) pertence.

    • O primeiro N tem um intervalo de valores válidos de 1 a 2. Se você definir N como 1, poderá configurar uma NIC primária ou secundária. Se você definir N como 2, deverá configurar uma NIC primária e uma NIC secundária.

    • O segundo N especifica um ou mais IDs de grupo de segurança. O intervalo de valores válidos de N depende do número máximo de grupos de segurança aos quais uma instância pode pertencer. Para mais informações, consulte Limites de grupo de segurança.

    Observe os seguintes itens:

    • Se NetworkInterface.N.InstanceType estiver definido como Primary, você deve definir este parâmetro ou NetworkInterface.N.SecurityGroupId. Este parâmetro tem o mesmo efeito que SecurityGroupIds.N, mas você não pode especificar SecurityGroupId, SecurityGroupIds.N ou NetworkInterface.N.SecurityGroupId.

    • Se NetworkInterface.N.InstanceType estiver definido como Secondary ou deixado em branco, este parâmetro é opcional. Valor padrão: o grupo de segurança da instância ECS.

    sg-bp67acfmxazb4p****
    InstanceType

    string

    Não

    O tipo da controladora de interface de rede (NIC). Valores válidos de N: 1 a 2. Se você definir N como 1, poderá configurar uma NIC primária ou secundária. Se você definir N como 2, deverá configurar uma NIC primária e uma NIC secundária.

    Valores válidos:

    • Primary: NIC primária.

    • Secondary: NIC 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 entra em vigor apenas para ENIs secundárias.

    true
    Tag

    array<object>

    Não

    As tags para instâncias, discos e ENIs primárias criadas a partir desta versão do modelo.

    Cenários

    Após chamar CreateLaunchTemplate para criar um modelo, a versão padrão gerada automaticamente usa essas tags para marcar instâncias, discos e ENIs primárias quando você cria instâncias.

    object

    Não

    As tags para instâncias, discos e ENIs primárias criadas a partir desta versão do modelo.

    Key

    string

    Não

    A chave de tag para instâncias, discos e ENIs primárias criadas a partir desta versão do modelo. Valores válidos de N: 1 a 20. A chave de tag não pode ser uma string vazia. A chave de tag pode ter até 128 caracteres e não pode começar com aliyun ou acs:. A chave de tag não pode conter http:// ou https://.

    TestKey
    Value

    string

    Não

    O valor de tag para instâncias, discos e ENIs primárias criadas a partir desta versão do modelo. Valores válidos de N: 1 a 20. O valor de tag pode ser uma string vazia. O valor de tag 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 pertence. O intervalo de valores válidos de N depende do número máximo de grupos de segurança aos quais uma instância pode pertencer. Para mais informações, consulte Limites.

    Nota

    Você não pode especificar SecurityGroupId e SecurityGroupIds.N simultaneamente.

    sg-bp15ed6xe1yxeycg7****

    string

    Não

    Os IDs de um ou mais grupos de segurança aos quais a instância pertence. O intervalo de valores válidos de N depende do número máximo de grupos de segurança aos quais uma instância pode pertencer. Para mais informações, consulte Limites.

    Nota

    Você não pode especificar SecurityGroupId e SecurityGroupIds.N simultaneamente.

    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

    A Zona D em Hong Kong (China) e a Zona A em Singapura não suportam criptografia de disco do sistema ao criar instâncias.

    false
    DeletionProtection

    boolean

    Não

    O atributo de proteção contra liberação da instância. Especifica se a instância pode ser liberada a partir do console ou chamando DeleteInstance. Valores válidos:

    • true: ativa a proteção contra liberação.

    • false: desativa a proteção contra liberação.

    Valor padrão: false.

    Nota

    Este atributo se aplica apenas a instâncias pós-pagas. Ele pode restringir apenas operações de liberação manual e não afeta liberações iniciadas pelo sistema.

    false
    CreditSpecification

    string

    Não

    O modo de execução da instância com capacidade de pico. 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: não ativa a renovação automática.

    Valor padrão: false.

    Nota

    Este parâmetro entra em vigor apenas quando InstanceChargeType está definido como PrePaid.

    true
    AutoRenewPeriod

    integer

    Não

    O período de renovação automática. Valores válidos:

    Se PeriodUnit estiver definido como Month: 1, 2, 3, 6, 12, 24, 36, 48 e 60.

    Valor padrão: 1.

    1
    PeriodUnit

    string

    Não

    A unidade da duração dos 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 de inst Visão geral dos metadados de instância ECS

    enabled
    HttpTokens

    string

    Não

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

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

    • required: usa obrigatoriamente o modo de segurança reforçada. Após definir este valor, os metadados da instância não podem ser acessados no modo normal.

    Valor padrão: optional.

    Nota

    Para mais informações sobre os modos de Visão geral dos metadados de instância

    optional
    HttpPutResponseHopLimit

    integer

    Não

    Nota

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

    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

    Indica se a instância que usa esta imagem oferece suporte ao login com a conta ecs-user. Valores válidos:

    • true: com suporte.

    • false: sem suporte.

    false
    SecurityOptions

    object

    Não

    As opções de segurança.

    TrustedSystemMode

    string

    Não

    O modo de sistema confiável. Defina o valor como vTPM.

    As seguintes famílias de instâncias oferecem suporte ao modo de sistema confiável:

    • g7, c7 e r7.

    • Famílias de instâncias aprimoradas (g7t, c7t e r7t).

    Ao criar instâncias ECS dos tipos de instância anteriores, você deve configurar este parâmetro. Observe os seguintes itens:

    vTPM

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    LaunchTemplateId

    string

    The launch template ID.

    lt-m5eiaupmvm2op9d****
    RequestId

    string

    The request ID.

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

    integer

    The launch template version number.

    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 Pelo menos um dos parâmetros especificados deve ser fornecido. Eles não podem estar todos vazios.
    400 InvalidParameter %s A combinação de parâmetros especificada é inválida.
    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 tamanho dos dados especificado excede o valor máximo permitido.
    400 InvalidUserData.Base64FormatInvalid %s O parâmetro UserData especificado deve ser codificado em Base64.
    400 Duplicate.TagKey The Tag.N.Key contain duplicate key. Existem chaves duplicadas nas tags. Mantenha as chaves únicas.
    400 InvalidTagKey.Malformed The specified Tag.n.Key is not valid. A chave de tag especificada é inválida. A chave de tag não pode estar vazia ou ser nula, pode ter no máximo 128 caracteres e não pode começar com "aliyun" ou "acs:" nem conter "http://" ou "https://".
    400 InvalidTagValue.Malformed The specified Tag.n.Value is not valid. O valor de tag especificado é inválido. O valor de tag pode ter no máximo 128 caracteres e não pode conter "http://" ou "https://".
    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 máximo de modelos de execução foi excedido.
    403 LaunchTemplateName.Duplicated %s O nome do modelo de execução especificado já existe.
    403 QuotaExceed.Tags %s A cota de parâmetros de tag foi excedida. O valor máximo é 20.
    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.