CreateLaunchTemplateVersion - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Cria uma nova versão em um modelo de inicialização do ECS especificado para a criação subsequente de instâncias ECS, grupos de dimensionamento elástico ou grupos de provisionamento automático.

Descrição da operação

Para modificar os parâmetros de uma versão específica, crie uma nova versão do modelo. Cada modelo de inicialização de instância suporta no máximo 30 versões.

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:CreateLaunchTemplateVersion

create

*LaunchTemplate

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

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
RegionId	string	Sim	O ID da região. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
LaunchTemplateId	string	Não	O ID do modelo de inicialização. Para obter mais informações, chame DescribeLaunchTemplates. Você deve especificar `LaunchTemplateId` ou `LaunchTemplateName` para determinar o modelo de inicialização.	lt-m5eiaupmvm2op9d****
LaunchTemplateName	string	Não	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://`. 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 usada para criar a instância. 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. Nota Este parâmetro será descontinuado. Para melhorar a compatibilidade, use outros parâmetros.	system
PasswordInherit	boolean	Não	Especifica se deve ser usada a senha predefinida da imagem. Valores válidos: true false Valor padrão: false. Nota Ao usar este parâmetro, o parâmetro Password deve estar vazio. Você também deve garantir que a imagem tenha uma senha predefinida.	false
InstanceType	string	Não	O tipo de instância. Para obter mais informações, consulte Família de instâncias. Você também pode chamar 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 criada com esta versão pertence. Instâncias no mesmo grupo de segurança podem se comunicar entre si. Nota Você não pode especificar `SecurityGroupId` e `SecurityGroupIds.N` simultaneamente.	sg-bp15ed6xe1yxeycg****
VpcId	string	Não	O ID da nuvem privada virtual (VPC) à qual a instância pertence.	vpc-bp12433upq1y5scen****
VSwitchId	string	Não	O ID do vSwitch. Você deve especificar este parâmetro 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 (que inclui caracteres de vários idiomas). 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 ao mesmo tempo, você pode configurar em lote nomes de instância sequenciais que contenham colchetes ([]) e vírgulas (,). Para obter mais informações, consulte Configurar em lote nomes ou nomes de host sequenciais para várias instâncias.	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://`.	testDescription
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`.	50
InternetMaxBandwidthOut	integer	Não	A largura de banda pública de saída máxima. Unidade: Mbit/s. Valores válidos: 0 a 100.	5
HostName	string	Não	O nome de host do servidor Elastic Compute Service (ECS). O nome de host não pode começar ou terminar com um ponto (.) ou hífen (-) e não pode conter pontos ou hifens consecutivos. Instâncias Windows: O nome de host deve ter de 2 a 15 caracteres e não pode conter pontos (.) nem consistir inteiramente em dígitos. Pode conter letras, dígitos e hifens (-). Outras instâncias (como Linux): O nome de host deve ter de 2 a 64 caracteres. Pode conter vários pontos (.), sendo que cada segmento entre pontos pode conter 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: disco ultra. cloud_ssd: SSD padrão. cloud_auto: disco ESSD AutoPL. cloud_essd: SSD empresarial (ESSD). Você pode usar o parâmetro `SystemDisk.PerformanceLevel` para configurar o nível de desempenho do disco. cloud_essd_entry: disco ESSD Entry. Para tipos de instância descontinuados que não são instâncias com otimização de E/S, o valor padrão é cloud. Para outros tipos de instância, 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://`. Pode conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-).	cloud_ssdSystem
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 não está disponível publicamente.	30000
SystemDisk.PerformanceLevel	string	Não	O nível de desempenho do ESSD usado como disco do sistema. Configure o nível de desempenho com base nos seguintes valores válidos: PL0 (padrão): Um único disco pode fornecer até 10.000 IOPS de leitura/gravação aleatória. PL1: Um único disco pode fornecer até 50.000 IOPS de leitura/gravação aleatória. PL2: Um único disco pode fornecer até 100.000 IOPS de leitura/gravação aleatória. PL3: Um único disco pode fornecer 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 ESSDs.	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-bp1dgzpaxwc4load****
SystemDisk.ProvisionedIops	integer	Não	O IOPS de leitura/gravação provisionado do disco ESSD AutoPL usado como disco do sistema. Valores válidos: 0 a min{50000, 1000 × Capacity - Baseline Performance}. Baseline Performance = min{1.800 + 50 × Capacity, 50.000}. Nota Este parâmetro está disponível apenas quando DiskCategory está definido como cloud_auto. Para obter 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 é uma instância com otimização de E/S. Valores válidos: none: A instância não tem otimização de E/S. optimized: A instância tem otimização de E/S ativada.	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 suporta pagamento por crédito. Caso contrário, uma falha `InvalidPayMethod` será retornada. PostPaid: pay-as-you-go.	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 largura de banda de saída da Internet. Valores válidos: PayByBandwidth: cobrança por largura de banda. PayByTraffic: cobrança por tráfego. Nota No modo cobrança por tráfego, 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. Quando ocorre contenção de recursos, as larguras de banda de pico podem ser limitadas. Se você deseja largura de banda garantida, use o modo cobrança por largura de banda.	PayByTraffic
EnableVmOsConfig	boolean	Não	Especifica se a configuração do sistema operacional da instância deve ser ativada.	false
NetworkType	string	Não	O tipo de rede da instância. Valores válidos: vpc: VPC. classic: rede clássica. A rede clássica foi descontinuada. Para obter mais informações, consulte Aviso de descontinuação.	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. Os dados brutos podem ter até 32 KB de tamanho.	ZWNobyBoZWxsbyBl****
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 do 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 será automaticamente arredondada 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 tarde 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 pay-as-you-go. Este parâmetro entra em vigor 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 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. São suportadas no máximo três casas decimais.	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. As instâncias spot são cobradas por segundo. Recomendamos que você selecione um período de proteção adequado com base na duração esperada da 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.	rg-bp67acfmxazb4p****
SecurityEnhancementStrategy	string	Não	Especifica se o endurecimento de segurança do 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.	Active
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..
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
DeploymentSetId	string	Não	O ID do conjunto de implantação.	ds-bp1brhwhoqinyjd6****
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 o mesmo que em `DataDisk.N.Category=cloud_essd`. Configure o nível de desempenho com base nos seguintes valores válidos: PL0: Um único disco pode fornecer até 10.000 IOPS de leitura/gravação aleatória. PL1 (padrão): Um único disco pode fornecer até 50.000 IOPS de leitura/gravação aleatória. PL2: Um único disco pode fornecer até 100.000 IOPS de leitura/gravação aleatória. PL3: Um único disco pode fornecer 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 ESSDs.	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. Quando `DataDisk.N.SnapshotId` é especificado, `DataDisk.N.Size` é ignorado. O tamanho real do disco criado é o tamanho do snapshot especificado. Snapshots criados em ou antes de 15 de julho de 2013 não podem ser usados. Solicitações que usam esses snapshots 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. As convenções de nomenclatura para pontos de montagem variam 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 é aplicável apenas a cenários de imagem completa (imagem do sistema). Você pode definir este parâmetro como o ponto de montagem do 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://`. 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: 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á configurado como um tipo de instância na família `ecs.u1` ou `ecs.e`. elastic_ephemeral_disk_standard: disco efêmero elástico - Standard. elastic_ephemeral_disk_premium: disco efêmero elástico - Premium Edition. Para instâncias com otimização de E/S, o valor padrão é cloud_efficiency. Para instâncias sem otimização de E/S, o valor padrão é cloud. Detalhes do valor padrão: Quando InstanceType está definido como um tipo de instância descontinuado que não tem otimização de E/S, o valor padrão do 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
ProvisionedIops	integer	Não	O IOPS de leitura/gravação provisionado do disco ESSD AutoPL usado como disco do sistema. Valores válidos: 0 a min{50000, 1000 × Capacity - Baseline Performance}. Baseline Performance = min{1.800 + 50 × Capacity, 50.000}. Nota Este parâmetro está disponível apenas quando DiskCategory está definido como cloud_auto. Para obter 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
AutoSnapshotPolicyId	string	Não	O ID da política de snapshot automático aplicada ao disco de dados.	sp-bp67acfmxazb4p****
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 do controlador de interface de rede (NIC).
	object	Não	As informações do controlador de interface de rede (NIC).
VSwitchId	string	Não	O ID do vSwitch ao qual o controlador de interface de rede (NIC) secundário pertence. A instância e o NIC secundário devem estar na mesma VPC e na mesma zona ativa, mas podem pertencer a vSwitches diferentes. O valor de N em `NetworkInterface.N` não pode ser maior que 1.	vsw-bp1s5fnvk4gn2tws0****
NetworkInterfaceName	string	Não	O nome do controlador de interface de rede (NIC) secundário. O valor de N em `NetworkInterface.N` não pode ser maior que 1.	testNetworkInterfaceName
Description	string	Não	A descrição do controlador de interface de rede (NIC) secundário. 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.	testNetworkInterfaceDescription
SecurityGroupId	string	Não	O ID do grupo de segurança ao qual o controlador de interface de rede (NIC) secundário pertence. O grupo de segurança do NIC secundário deve pertencer à mesma VPC que a instância. O valor de N em `NetworkInterface.N` não pode ser maior que 1. Nota Você não pode especificar `NetworkInterface.N.SecurityGroupId` e `NetworkInterface.N.SecurityGroupIds.N` simultaneamente.	sg-bp15ed6xe1yxeycg****
PrimaryIpAddress	string	Não	O endereço IP privado primário do controlador de interface de rede (NIC) secundário. O valor de N em `NetworkInterface.N` não pode ser maior que 1.	192.168..
SecurityGroupIds	array	Não	Os IDs de um ou mais grupos de segurança aos quais o controlador de interface de rede (NIC) secundário pertence. Os grupos de segurança e o NIC secundário devem pertencer à mesma VPC. Os valores válidos de N em `SecurityGroupIds.N` dependem da cota para o número máximo de grupos de segurança aos quais um NIC secundário pode pertencer. Para obter mais informações, consulte Limites. O valor de N em `NetworkInterface.N` não pode ser maior que 1. Nota Você não pode especificar `NetworkInterface.N.SecurityGroupId` e `NetworkInterface.N.SecurityGroupIds.N` simultaneamente.	sg-bp67acfmxazb4p****
	string	Não	Os IDs de um ou mais grupos de segurança aos quais o controlador de interface de rede (NIC) secundário pertence. Os grupos de segurança e o NIC secundário devem pertencer à mesma VPC. Os valores válidos de N em `SecurityGroupIds.N` dependem da cota para o número máximo de grupos de segurança aos quais um NIC secundário pode pertencer. Para obter mais informações, consulte Limites. O valor de N em `NetworkInterface.N` não pode ser maior que 1. Nota Você não pode especificar `NetworkInterface.N.SecurityGroupId` e `NetworkInterface.N.SecurityGroupIds.N` simultaneamente.	sg-bp67acfmxazb4p****
InstanceType	string	Não	O tipo da ENI. Valores válidos de N: 1 a 2. Se você configurar uma ENI, poderá configurar um controlador de interface de rede (NIC) primário ou uma ENI secundária. Se você configurar duas ENIs, deverá configurar um NIC primário e uma ENI secundária. Valores válidos: Primary: NIC primário. 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 entra em vigor apenas para ENIs secundárias.	true
Tag	array<object>	Não	As tags das instâncias, discos e ENIs primárias criados com esta versão.
	object	Não	As tags das instâncias, discos e ENIs primárias criados com esta versão.
Key	string	Não	A chave da tag das instâncias, discos e ENIs primárias criados com esta versã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 e ENIs primárias criados com esta versã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 pertence. Os valores válidos de N dependem do número máximo de grupos de segurança aos quais uma instância pode pertencer. Para obter 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. Os valores válidos de N dependem do número máximo de grupos de segurança aos quais uma instância pode pertencer. Para obter 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 criptografia do disco do sistema não é suportada na Zona D da região de Hong Kong (China) ou na Zona A da região de Cingapura ao criar uma instância.	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 é aplicável apenas a instâncias pay-as-you-go. Ele pode restringir apenas operações de liberação manual e não entra em vigor em operações de liberação iniciadas pelo sistema.	false
CreditSpecification	string	Não	O modo de execução da instância com capacidade de pico. Valores válidos: Standard: modo padrão. Para obter mais informações, consulte a seção de modo com restrição de desempenho em Visão geral das instâncias com capacidade de pico. Unlimited: modo ilimitado. Para obter mais informações, consulte a seção de modo ilimitado em Visão geral das instâncias com capacidade de pico.	Standard
AutoRenew	boolean	Não	Especifica se a renovação automática deve ser ativada. Este parâmetro entra em vigor apenas quando `InstanceChargeType` está definido como `PrePaid`. Valores válidos: true: ativa a renovação automática. false: não ativa a renovação automática. Valor padrão: false.	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 da 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 obter mais informações sobre metadados da instância, consulte Visão geral dos metadados da instância ECS.	enabled
HttpTokens	string	Não	Especifica se o modo de segurança reforçada (IMDSv2) deve ser usado obrigatoriamente para acessar 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, o modo normal não poderá ser usado para acessar metadados da instância. Valor padrão: optional. Nota Para obter mais informações sobre os modos de acesso aos metadados da instância, consulte Visão geral dos metadados da instância ECS.	optional
HttpPutResponseHopLimit	integer	Não	Nota Este parâmetro não está disponível publicamente.	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 as instâncias que usam esta imagem suportam login com o usuário ecs-user. Valores válidos: true: suportado. false: não suportado.	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 suportam o modo de sistema confiável: g7, c7 e r7. Família de instâncias com segurança aprimorada (g7t, c7t e r7t). Ao criar instâncias ECS das famílias de instâncias anteriores, você deve configurar este parâmetro. Detalhes: Para usar o Sistema Confiável do Alibaba Cloud, defina este parâmetro como vTPM. A verificação confiável é concluída pelo Sistema Confiável do Alibaba Cloud 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 modo de computação confidencial baseado em Enclave (`SecurityOptions.ConfidentialComputingMode=Enclave`), o sistema confiável também será ativado para a instância. Ao criar uma instância ECS confiável invocando uma operação de API, você só pode invocar `RunInstances`. `CreateInstance` não suporta a configuração do parâmetro `SecurityOptions.TrustedSystemMode`. Nota Se você especificar uma instância como uma instância confiável durante a criação, só poderá usar imagens que suportam o sistema confiável ao substituir o disco do sistema. Para obter mais informações sobre o sistema confiável, consulte Visão geral dos recursos confiáveis para instâncias com segurança aprimorada.	vTPM

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
LaunchTemplateVersionNumber	integer	O número da versão do modelo de inicialização que é criado.	2
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DEX****
LaunchTemplateId	string	O ID do modelo de inicialização. Para obter mais informações, consulte DescribeLaunchTemplates. Ao usar um modelo de inicialização para criar uma instância, você deve especificar `LaunchTemplateId` ou `LaunchTemplateName` para determinar o modelo de inicialização.	lt-bp1apo0bbbkuy0rj****

Exemplos

Resposta de sucesso

JSON formato

{
  "LaunchTemplateVersionNumber": 2,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DEX****",
  "LaunchTemplateId": "lt-bp1apo0bbbkuy0rj****"
}

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	InvalidDescription.Malformed	The specified parameter "Description" is not valid.	O parâmetro description especificado é inválido.
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	InvalidHostName.Malformed	The specified parameter "HostName" is not valid.	O parâmetro HostName especificado é inválido.
400	InvalidParams.CreateEniParams	%s
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Existem chaves duplicadas nas tags. Mantenha as chaves únicas.
500	InternalError	The request processing has failed due to some unknown error.
403	LaunchTemplateVersionLimitExceed	%s	O número máximo de versões do modelo de execução foi excedido.
404	InvalidLaunchTemplate.NotFound	%s	O modelo de execução especificado não foi encontrado. Verifique se o parâmetro é válido.
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.