CreateLaunchTemplate - : Central de Documentação do Alibaba Cloud

Observações de uso

Os modelos de inicialização contêm configurações predefinidas para criar instâncias, como região, ID da imagem, tipo de instância, ID do grupo de segurança e configurações de largura de banda pública. Caso o modelo não inclua um parâmetro específico necessário, especifique-o ao usar o modelo para criar uma instância.

Ao criar um modelo de inicialização com a operação CreateLaunchTemplate, o número da versão é definido como 1 por padrão. É possível criar várias versões chamando a operação CreateLaunchTemplateVersion para o modelo. Os números de versão começam em 1 e incrementam de um em um. Se você não especificar um número de versão ao criar instâncias usando um modelo de inicialização por meio da operação RunInstances, o sistema usará a versão padrão.

Observe os seguintes itens:

É permitido criar até 30 modelos de inicialização em cada região. Cada modelo pode ter até 30 versões.
A maioria dos parâmetros nos modelos de inicialização é opcional. Durante a criação do modelo, o ECS não verifica a existência ou a validade dos valores especificados. A validação ocorre apenas quando se usa o modelo para criar instâncias.
Se você configurar um parâmetro específico em um modelo de inicialização, não será possível filtrá-lo ao usar o modelo para criar instâncias com a operação RunInstances. Por exemplo, se definir HostName como LocalHost no modelo, mas não especificar HostName ao chamar a operação RunInstances para criar instâncias a partir desse modelo, o nome do host da instância ainda será LocalHost. Para substituir o valor LocalHost de HostName fornecido pelo modelo, defina HostName como MyHost ou outro valor ao chamar a operação RunInstances.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Yes	CreateLaunchTemplate	A operação a ser executada. Defina o valor como CreateLaunchTemplate.
RegionId	String	Yes	cn-hangzhou	O ID da região do modelo de inicialização. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
TemplateTag.N.Key	String	No	TestKey	A chave da tag N a ser adicionada ao 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 conter `http://` ou `https://`. Também não pode começar com `acs`: ou `aliyun`.
TemplateTag.N.Value	String	No	TestValue	O valor da tag N a ser adicionado ao 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://`. Também não pode começar com `acs`: ou `aliyun`.
LaunchTemplateName	String	Yes	testLaunchTemplateName	O nome do modelo de inicialização. Deve ter entre 2 e 128 caracteres. Precisa começar com uma letra, mas não pode iniciar com `http://` ou `https://`. O nome pode conter letras, dígitos, dois-pontos (:), sublinhados (_) e hifens (-).
VersionDescription	String	No	testVersionDescription	A descrição da versão do modelo de inicialização. Deve ter entre 2 e 256 caracteres e não pode começar com `http://` ou `https://`.
ImageId	String	No	win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd	O ID da imagem. Chame a operação DescribeImages para consultar as imagens disponíveis.
ImageOwnerAlias	String	No	system	A source da imagem. Valores válidos: system: imagens públicas fornecidas pela Alibaba Cloud. self: imagens personalizadas criadas por você. others: imagens compartilhadas de outras contas da Alibaba Cloud. marketplace: imagens do Alibaba Cloud Marketplace. Se houver imagens do Alibaba Cloud Marketplace disponíveis, você poderá usá-las sem precisar assiná-las. Observe os detalhes de faturamento das imagens do Alibaba Cloud Marketplace.
PasswordInherit	Boolean	No	false	Define se a senha predefinida na imagem deve ser usada. Nota Se usar este parâmetro, deixe Password vazio e certifique-se de que a imagem selecionada possua uma senha predefinida.
InstanceType	String	No	ecs.g5.large	O tipo da instância. Para obter mais informações, consulte Famílias de instâncias. Você também pode chamar a operação DescribeInstanceTypes para consultar a lista de tipos de instância mais recente.
SecurityGroupId	String	No	sg-bp15ed6xe1yxeycg****	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. Cada grupo de segurança pode conter até 1.000 instâncias. Nota Não é possível especificar `SecurityGroupId` e `SecurityGroupIds.N` simultaneamente.
VpcId	String	No	vpc-bp12433upq1y5scen****	O ID da virtual private cloud (VPC).
VSwitchId	String	No	vsw-bp1s5fnvk4gn2tws0****	O ID do vSwitch ao qual conectar a instância. Este parâmetro é obrigatório se você especificar VpcId.
InstanceName	String	No	testInstanceName	O nome da instância. Deve ter entre 2 e 128 caracteres. Precisa começar com uma letra, mas não pode iniciar com `http://` ou `https://`. O nome pode conter letras, dígitos, dois-pontos (:), sublinhados (_) e hifens (-).
Description	String	No	testECSDescription	A descrição da instância. Deve ter entre 2 e 256 caracteres e não pode começar com `http://` ou `https://`.
InternetMaxBandwidthIn	Integer	No	10	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, os valores válidos deste parâmetro são de 1 a 10, sendo o valor padrão 10. Se a largura de banda pública de saída adquirida for maior que 10 Mbit/s, os valores válidos variam de 1 até o valor de `InternetMaxBandwidthOut`, sendo o valor padrão igual ao valor de `InternetMaxBandwidthOut`.
InternetMaxBandwidthOut	Integer	No	10	A largura de banda pública de saída máxima. Unidade: Mbit/s. Valores válidos: 0 a 100.
HostName	String	No	testHostName	O nome do host da instância. O nome do host não pode começar ou terminar com ponto (.) ou hífen (-). Também não pode conter pontos (.) ou hifens (-) consecutivos. Para instâncias Windows, o nome do host deve ter entre 2 e 15 caracteres, não pode conter pontos (.) nem ser composto apenas por dígitos. Pode conter letras, dígitos e hifens (-). Para instâncias com outros sistemas operacionais, como Linux, o nome do host deve ter entre 2 e 64 caracteres. Divida o nome do host em vários segmentos separados por pontos (.). Cada segmento pode conter letras, dígitos e hifens (-).
ZoneId	String	No	cn-hangzhou-g	O ID da zona da instância.
SystemDisk.Category	String	No	cloud_ssd	A categoria do disco do sistema. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra. cloud_ssd: SSD. cloud_essd: SSD aprimorado (ESSD). Use `SystemDisk.PerformanceLevel` para definir o nível de desempenho do ESSD usado como disco do sistema. Para instâncias não otimizadas para E/S de um tipo descontinuado, o valor padrão é cloud. Para outros tipos de instâncias, o valor padrão é cloud_efficiency.
SystemDisk.Size	Integer	No	40	O tamanho do disco do sistema. Unidade: GiB. Valores válidos: 20 a 500. O valor deste parâmetro deve ser de pelo menos 20 e maior ou igual ao tamanho da imagem.
SystemDisk.DiskName	String	No	testSystemDiskName	O nome do disco do sistema. Deve ter entre 2 e 128 caracteres e pode conter letras, dígitos, pontos (.), dois-pontos (:), sublinhados (_) e hifens (-). Precisa começar com uma letra, mas não pode iniciar com `http://` ou `https://`.
SystemDisk.Description	String	No	testSystemDiskDescription	A descrição do disco do sistema. Deve ter entre 2 e 256 caracteres e não pode começar com `http://` ou `https://`.
SystemDisk.Iops	Integer	No	null	Nota Este parâmetro está em prévia por convite e não está disponível publicamente.
SystemDisk.PerformanceLevel	String	No	PL0	O nível de desempenho do ESSD usado como disco do sistema. Valores válidos: PL0 (padrão): Um único ESSD pode entregar até 10.000 IOPS de leitura/gravação aleatória. PL1: Um único ESSD pode entregar até 50.000 IOPS de leitura/gravação aleatória. PL2: Um único ESSD pode entregar até 100.000 IOPS de leitura/gravação aleatória. PL3: Um único ESSD pode entregar até 1 milhão de IOPS de leitura/gravação aleatória. Para obter mais informações sobre os níveis de desempenho do ESSD, consulte ESSDs.
SystemDisk.DeleteWithInstance	Boolean	No	true	Define se o disco do sistema deve ser liberado quando a instância for liberada. Valores válidos: true false Valor padrão: true.
SystemDisk.AutoSnapshotPolicyId	String	No	sp-gc7c37d4ylw7mtnk****	O ID da política de snapshot automático a ser aplicada ao disco do sistema.
SystemDisk.ProvisionedIops	Long	No	50000	As IOPS de leitura/gravação provisionadas do disco ESSD AutoPL. Valores válidos: 0 a min{50.000, 1.000 × Capacidade - IOPS Baseline}. IOPS Baseline = min{1.800 + 50 × Capacidade, 50.000}. Nota Este parâmetro está disponível apenas se SystemDisk.Category estiver definido como cloud_auto. Para obter mais informações, consulte Discos ESSD AutoPL e Modificar as configurações de desempenho de um disco ESSD AutoPL.
SystemDisk.BurstingEnabled	Boolean	No	true	Define se o recurso de aumento temporário de desempenho (burst) deve ser ativado. Valores válidos: true false
IoOptimized	String	No	optimized	Define se a instância é otimizada para E/S. Valores válidos: none: A instância não é otimizada para E/S. optimized: A instância é otimizada para E/S.
InstanceChargeType	String	No	PrePaid	O método de faturamento da instância. Valores válidos: PrePaid: assinatura. Se definir este parâmetro como PrePaid, certifique-se de que sua conta tenha créditos suficientes. Caso contrário, um erro `InvalidPayMethod` será retornado. PostPaid: pagamento conforme o uso.
Period	Integer	No	1	A duração da assinatura da instância. Unidade: meses. Este parâmetro entra em vigor e é obrigatório apenas se você definir `InstanceChargeType` como `PrePaid`. Valores válidos: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48 e 60.
InternetChargeType	String	No	PayByTraffic	O método de faturamento para uso de rede. Valores válidos: PayByBandwidth PayByTraffic Nota Se o método de faturamento pagamento por tráfego for usado para a rede, as larguras de banda de entrada e saída máximas funcionam como limites superiores, e não como desempenho garantido. Em cenários onde a demanda excede a oferta de recursos, os valores máximos de largura de banda podem não ser atingidos. Se precisar de largura de banda garantida para suas instâncias, utilize o método de faturamento pagamento por largura de banda.
EnableVmOsConfig	Boolean	No	false	Define se as configurações do sistema operacional da instância devem ser ativadas. Nota Este parâmetro será removido no futuro. Para garantir compatibilidade futura, recomendamos o uso de outros parâmetros.
NetworkType	String	No	vpc	O tipo de rede da instância. Valores válidos: classic: rede clássica. vpc: VPC.
UserData	String	No	ZWNobyBoZWxsbyBlY3Mh	Os dados de usuário da instância. Devem estar codificados em Base64. O tamanho máximo dos dados brutos é de 16 KB.
KeyPairName	String	No	testKeyPairName	O nome do par de chaves. Para instâncias Windows, este parâmetro é ignorado. `Password` entra em vigor independentemente de você especificar KeyPairName. Para instâncias Linux, o método de autenticação por senha é desativado por padrão.
RamRoleName	String	No	testRamRoleName	O nome da função do Resource Access Management (RAM) da instância. Chame a operação ListRoles fornecida pelo RAM para consultar as funções RAM da instância que você criou.
AutoReleaseTime	String	No	2018-01-01T12:05:00Z	O horário de liberação automática da instância. Especifique o horário no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. Se o valor de `ss` não for `00`, o horário será automaticamente arredondado para o minuto mais próximo com base no valor de `mm`. O horário especificado deve ser pelo menos 30 minutos posterior ao horário atual. O horário especificado pode ser de até três anos a partir do horário atual.
SpotStrategy	String	No	NoSpot	A política de preempção para a instância de pagamento conforme o uso. Este parâmetro entra em vigor apenas se você definir `InstanceChargeType` como `PostPaid`. Valores válidos: NoSpot: A instância é uma instância de pagamento conforme o uso. SpotWithPriceLimit: A instância é preemptível com um preço máximo por hora definido pelo usuário. SpotAsPriceGo: A instância é preemptível e utiliza automaticamente o preço de mercado no momento da compra como preço de lance.
SpotPriceLimit	Float	No	0.97	O preço máximo por hora da instância. O valor deve ter precisão de três casas decimais. Este parâmetro entra em vigor apenas se você definir `SpotStrategy` como `SpotWithPriceLimit`.
SpotDuration	Integer	No	1	O período de proteção da instância preemptível. Unidade: horas. Valor padrão: 1. Valores válidos: 1: Após a criação de uma instância preemptível, a Alibaba Cloud garante que ela não seja liberada automaticamente dentro de 1 hora. Após o término desse 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 a instância deve ser mantida ou liberada. 0: Após a criação de uma instância preemptível, a Alibaba Cloud não garante que ela execute 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 decidir se mantém ou libera a instância. A Alibaba Cloud envia eventos de sistema do ECS para notificá-lo 5 minutos antes da liberação da instância. Instâncias preemptíveis são faturadas por segundo. Recomendamos especificar um período de proteção com base nos requisitos do seu negócio. Nota Se você definir SpotStrategy como SpotWithPriceLimit ou SpotAsPriceGo, este parâmetro entrará em vigor.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	O ID do grupo de recursos ao qual a instância, o dispositivo Elastic Block Storage (EBS) e a interface de rede elástica (ENI) pertencem.
TemplateResourceGroupId	String	No	rg-bp67acfmxazb4p****	O ID do grupo de recursos ao qual o modelo de inicialização pertence.
SecurityEnhancementStrategy	String	No	Deactive	Define se o reforço de segurança do sistema operacional deve ser ativado. Valores válidos: Active: ativa o reforço de segurança do sistema operacional. Deactive: desativa o reforço de segurança do sistema operacional.
PrivateIpAddress	String	No	10.1..	O endereço IP privado da instância. Para atribuir um endereço IP privado a uma instância residente em uma VPC, certifique-se de que o endereço IP esteja livre dentro do bloco CIDR do vSwitch especificado por `VSwitchId`.
DeploymentSetId	String	No	ds-bp1brhwhoqinyjd6****	O ID do conjunto de implantação.
Ipv6AddressCount	Integer	No	1	A quantidade de endereços IPv6 a serem gerados aleatoriamente para a interface de rede elástica (ENI) primária. Valores válidos: 1 a 10.
DataDisk.N.PerformanceLevel	String	No	PL1	O nível de desempenho do ESSD N usado como disco de dados. O valor de N deve ser o mesmo que em `DataDisk.N.Category` se você definir DataDisk.N.Category como cloud_essd. Valores válidos: PL0: Um único ESSD pode entregar até 10.000 IOPS de leitura/gravação aleatória. PL1 (padrão): Um único ESSD pode entregar até 50.000 IOPS de leitura/gravação aleatória. PL2: Um único ESSD pode entregar até 100.000 IOPS de leitura/gravação aleatória. PL3: Um único ESSD pode entregar até 1 milhão de IOPS de leitura/gravação aleatória. Para obter mais informações sobre os níveis de desempenho do ESSD, consulte ESSDs.
DataDisk.N.Description	String	No	testDataDiskDescription	A descrição do disco de dados N. Deve ter entre 2 e 256 caracteres e não pode começar com `http://` ou `https://`.
DataDisk.N.SnapshotId	String	No	s-bp17441ohwka0yuh****	O ID do snapshot a ser usado para criar o disco de dados N. Valores válidos de N: 1 a 16. Se você especificar `DataDisk.N.SnapshotId`, `DataDisk.N.Size` será ignorado. O disco de dados será criado com base no tamanho do snapshot especificado. Nota Utilize snapshots criados após 15 de julho de 2013. Caso contrário, um erro será retornado e sua solicitação será rejeitada.
DataDisk.N.Size	Integer	No	2000	O tamanho do disco de dados N. Valores válidos de N: 1 a 16. Unidade: GiB. Valores válidos: Valores válidos se você definir DataDisk.N.Category como cloud: 5 a 2000. Valores válidos se você definir DataDisk.N.Category como cloud_efficiency: 20 a 32768. Valores válidos se você definir DataDisk.N.Category como cloud_ssd: 20 a 32768. Valores válidos se você definir DataDisk.N.Category como cloud_essd: variam conforme o valor de `DataDisk.N.PerformanceLevel`. Valores válidos se você definir DataDisk.N.PerformanceLevel como PL0: 40 a 32768. Valores válidos se você definir DataDisk.N.PerformanceLevel como PL1: 20 a 32768. Valores válidos se você definir DataDisk.N.PerformanceLevel como PL2: 461 a 32768. Valores válidos se você definir DataDisk.N.PerformanceLevel como PL3: 1261 a 32768. O valor deste parâmetro deve ser maior ou igual ao tamanho do snapshot especificado por `DataDisk.N.SnapshotId`.
DataDisk.N.Device	String	No	null	Nota Este parâmetro será removido no futuro. Recomendamos o uso de outros parâmetros para garantir compatibilidade futura.
DataDisk.N.DiskName	String	No	testDataDiskName	O nome do disco de dados N. Deve ter entre 2 e 128 caracteres. Precisa começar com uma letra, mas não pode iniciar com `http://` ou `https://`. O nome pode conter letras, dígitos, dois-pontos (:), sublinhados (_) e hifens (-).
DataDisk.N.Category	String	No	cloud_ssd	A categoria do disco de dados N. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra cloud_ssd: SSD. cloud_essd: SSD aprimorado (ESSD). Para instâncias otimizadas para E/S, o valor padrão é cloud_efficiency. Para instâncias não otimizadas para E/S, o valor padrão é cloud.
DataDisk.N.DeleteWithInstance	Boolean	No	true	Define se o disco de dados N deve ser liberado quando a instância for liberada. Valores válidos: true false Valor padrão: true.
DataDisk.N.Encrypted	String	No	false	Define se o disco de dados N deve ser criptografado.
DataDisk.N.AutoSnapshotPolicyId	String	No	sp-m5e7fa9ute44ssa****	O ID da política de snapshot automático a ser aplicada ao disco de dados N.
DataDisk.N.ProvisionedIops	Long	No	50000	As IOPS de leitura/gravação provisionadas do disco ESSD AutoPL. Valores válidos: 0 a min{50.000, 1.000 × Capacidade - IOPS Baseline}. IOPS Baseline = min{1.800 + 50 × Capacidade, 50.000}. Nota Este parâmetro está disponível apenas se você definir SystemDisk.Category como cloud_auto. Para obter mais informações, consulte Discos ESSD AutoPL e Modificar as configurações de desempenho de um disco ESSD AutoPL.
DataDisk.N.BurstingEnabled	Boolean	No	true	Define se o recurso de aumento temporário de desempenho (burst) deve ser ativado. Valores válidos: true false
NetworkInterface.N.VSwitchId	String	No	vsw-bp1s5fnvk4gn2tws0****	O ID do vSwitch ao qual associar a ENI N. Observe os seguintes itens: Valores válidos de N: 1 e 2. Se o valor de N for 1, você pode especificar uma ENI primária ou secundária. Se o valor de N for 2, você deve especificar uma ENI primária e uma secundária. Se você definir `NetworkInterface.N.InstanceType` como `Primary`, este parâmetro é obrigatório. Nesse caso, ele equivale a `VSwitchId`. Não é possível especificar NetworkInterface.N.VSwitchId e `VSwitchId` simultaneamente. Se você definir `NetworkInterface.N.InstanceType` como `Secondary` ou deixar o parâmetro vazio, este parâmetro é opcional. O valor padrão é o ID do vSwitch ao qual a instância será conectada.
NetworkInterface.N.NetworkInterfaceName	String	No	testEniName	O nome da ENI N. Observe os seguintes itens: Valores válidos de N: 1 e 2. Se o valor de N for 1, uma ENI primária ou secundária pode ser configurada. Se o valor de N for 2, uma ENI primária e uma secundária devem ser configuradas. Se você definir `NetworkInterface.N.InstanceType` como `Primary`, não é necessário definir este parâmetro.
NetworkInterface.N.Description	String	No	testEniDescription	A descrição da ENI secundária N. Deve ter entre 2 e 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.
NetworkInterface.N.SecurityGroupId	String	No	sg-bp15ed6xe1yxeycg****	O ID do grupo de segurança ao qual a ENI N pertence. Observe os seguintes itens: Valores válidos de N: 1 e 2. Se o valor de N for 1, uma ENI primária ou secundária pode ser configurada. Se o valor de N for 2, uma ENI primária e uma secundária devem ser configuradas. Se `NetworkInterface.N.InstanceType` estiver definido como `Primary`, este parâmetro é obrigatório. Nesse caso, ele equivale a `SecurityGroupId`. Não é possível especificar `SecurityGroupId`, `SecurityGroupIds.N` ou `NetworkInterface.N.SecurityGroupIds.N`. Se você definir `NetworkInterface.N.InstanceType` como `Secondary` ou deixar este parâmetro vazio, NetworkInterface.SecurityGroupIds é opcional. O valor padrão é o ID do grupo de segurança ao qual a instância pertence.
NetworkInterface.N.PrimaryIpAddress	String	No	192.168..	O endereço IP primário da ENI N. Observe os seguintes itens: Valores válidos de N: 1 e 2. Se o valor de N for 1, você pode especificar uma ENI primária ou secundária. Se este parâmetro for especificado, `Amount` estiver definido como um valor numérico maior que 1 e NetworkInterface.N.InstanceType estiver definido como Primary, o número especificado de instâncias será criado e endereços IP primários consecutivos, começando pelo especificado, serão atribuídos às instâncias. Nesse caso, não é possível vincular ENIs secundárias a essas instâncias. Se o valor de N for 2, uma ENI primária e uma secundária devem ser configuradas. Se este parâmetro for especificado, `Amount` estiver definido como um valor numérico maior que 1 e NetworkInterface.N.InstanceType estiver definido como Primary, você não poderá definir `NetworkInterface.2.InstanceType` como Secondary para anexar uma ENI secundária. Se `NetworkInterface.N.InstanceType` estiver definido como `Primary`, este parâmetro equivale a `PrivateIpAddress`. Não é possível especificar NetworkInterface.N.PrimaryIpAddress e `PrivateIpAddress` simultaneamente. Se `NetworkInterface.N.InstanceType` estiver definido como `Secondary` ou deixado vazio, o endereço IP primário especificado será atribuído à ENI secundária. O valor padrão é um endereço IP selecionado aleatoriamente dentro do bloco CIDR do vSwitch ao qual a ENI secundária será associada. Nota Você pode anexar apenas uma única ENI secundária ao criar uma instância. Após a criação da instância, chame as operações CreateNetworkInterface e AttachNetworkInterface para anexar mais ENIs secundárias à instância.
NetworkInterface.N.SecurityGroupIds.N	String	No	sg-bp67acfmxazb4p****	O ID do grupo de segurança N ao qual atribuir a ENI N. Valores válidos do primeiro N: 1 e 2. Se o valor do primeiro N for 1, você pode configurar uma ENI primária ou secundária. Se o valor do primeiro N for 2, você deve configurar uma ENI primária e uma secundária. O segundo N indica que um ou mais IDs de grupo de segurança podem ser especificados. Os valores válidos do segundo N variam conforme o número máximo de grupos de segurança aos quais uma instância pode pertencer. Para obter mais informações, consulte a seção "Limites de grupos de segurança" em Limites. Observe os seguintes itens: Se `NetworkInterface.N.InstanceType` estiver definido como `Primary`, este parâmetro ou `NetworkInterface.N.SecurityGroupId` é obrigatório. Nesse caso, este parâmetro equivale a `SecurityGroupIds.N`. Não é possível especificar `SecurityGroupId`, `SecurityGroupIds.N` ou `NetworkInterface.N.SecurityGroupId`. Se você definir `NetworkInterface.N.InstanceType` como `Secondary` ou deixar este parâmetro vazio, NetworkInterface.SecurityGroupIds é opcional. O valor padrão é o ID do grupo de segurança ao qual a instância pertence.
NetworkInterface.N.InstanceType	String	No	Secondary	O tipo da ENI N. Valores válidos de N: 1 e 2. Se o valor de N for 1, você pode especificar uma ENI primária ou secundária. Se o valor de N for 2, você deve especificar uma ENI primária e uma secundária. Valores válidos: Primary Secondary Valor padrão: Secondary.
NetworkInterface.N.NetworkInterfaceTrafficMode	String	No	Standard	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 remote direct memory access (RDMA).
Tag.N.Key	String	No	TestKey	A chave da tag N a ser adicionada à instância, ao dispositivo EBS ou à ENI. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia. Pode ter até 64 caracteres e não pode começar com `acs:` ou `aliyun`. A chave da tag não pode conter `http://` ou `https://`.
Tag.N.Value	String	No	TestValue	O valor da tag N a ser adicionado à instância, ao dispositivo EBS ou à ENI. 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 começar com acs: ou aliyun. O valor da tag não pode conter http:// ou https://.
SecurityGroupIds.N	String	No	sg-bp15ed6xe1yxeycg7****	O ID do grupo de segurança N ao qual a instância pertence. Os valores válidos de N variam conforme o número máximo de grupos de segurança aos quais uma instância pode pertencer. Para obter mais informações, consulte a seção "Limites de grupos de segurança" em Limites. Nota Não é possível especificar `SecurityGroupId` e `SecurityGroupIds.N` ao mesmo tempo.
SystemDisk.Encrypted	String	No	false	Define se o disco do sistema deve ser criptografado. Valores válidos: true false Valor padrão: false. Nota Se você criar instâncias na Zona D de Hong Kong ou na Zona A de Singapura, não será possível criptografar os discos do sistema.
DeletionProtection	Boolean	No	false	Define se a proteção contra liberação deve ser ativada para a instância. Este parâmetro determina se você pode usar o console do ECS ou chamar a operação DeleteInstance para liberar a instância. Valores válidos: true false Valor padrão: false. Nota Este parâmetro aplica-se apenas a instâncias de pagamento conforme o uso. Ele protege as instâncias contra liberações manuais, mas não contra liberações automáticas.
CreditSpecification	String	No	Standard	O modo de desempenho da instância com capacidade de aumento temporário (burstable). Valores válidos: Standard: modo padrão. Para obter mais informações, consulte a seção "Modo padrão" em Instâncias com capacidade de aumento temporário. Unlimited: modo ilimitado. Para obter mais informações, consulte a seção "Modo ilimitado" em Instâncias com capacidade de aumento temporário.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
LaunchTemplateId	String	lt-m5eiaupmvm2op9d****	O ID do modelo de inicialização.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	O ID da solicitação.
LaunchTemplateVersionNumber	Long	2	O número da versão do modelo de inicialização.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=CreateLaunchTemplate
&LaunchTemplateName=testLaunchTemplateName
&RegionId=cn-hangzhou
&TemplateTag.1.Key=TestKey
&TemplateTag.1.Value=TestValue
&VersionDescription=testVersionDescription
&ImageId=win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd
&InstanceType=ecs.g5.large
&SecurityGroupId=sg-bp15ed6xe1yxeycg****
&VpcId=vpc-bp12433upq1y5scen****
&VSwitchId=vsw-bp1s5fnvk4gn2tws03****
&InstanceName=testInstanceName
&Description=testECSDescription
&InternetMaxBandwidthIn=10
&InternetMaxBandwidthOut=10
&HostName=testHostName
&ZoneId=cn-hangzhou-g
&SystemDisk.Category=cloud_ssd
&SystemDisk.Size=40
&SystemDisk.DiskName=testSystemDiskName
&SystemDisk.Description=TestDisk
&DataDisk.1.Size=2000
&DataDisk.1.SnapshotId=s-bp17441ohwka0yuh****
&DataDisk.1.Category=cloud_ssd
&DataDisk.1.Encrypted=false
&DataDisk.1.DiskName=testDataDiskName
&DataDisk.1.Description=testDataDiskDescription
&DataDisk.1.DeleteWithInstance=true
&IoOptimized=optimized
&NetworkInterface.1.PrimaryIpAddress=192.168.**.**
&NetworkInterface.1.VSwitchId=vsw-bp1s5fnvk4gn2tws0****
&NetworkInterface.1.SecurityGroupId=sg-bp15ed6xe1yxeycg****
&NetworkInterface.1.NetworkInterfaceName=testEniName
&NetworkInterface.1.Description=testEniDescription
&PrivateIpAddress=10.1.**.**
&InstanceChargeType=PrePaid
&Period=1
&InternetChargeType=PayByTraffic
&NetworkType=vpc
&UserData=ZWNobyBoZWxsbyBlY3Mh
&RamRoleName=testRamRoleName
&AutoReleaseTime=2018-01-01T12:05:00Z
&SpotStrategy=NoSpot
&SpotPriceLimit=0.97
&SecurityEnhancementStrategy=Deactive
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<Common request parameters>

Exemplos de respostas de sucesso

XML formato

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateLaunchTemplateResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <LaunchTemplateId>lt-m5eiaupmvm2op9d****</LaunchTemplateId>
    <LaunchTemplateVersionNumber>2</LaunchTemplateVersionNumber>
</CreateLaunchTemplateResponse>

JSON formato

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de erro

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidRegion.NotExist	%s	A região especificada não existe.
400	MissingParameter	%s	Um parâmetro obrigatório não foi especificado.
400	InvalidParameter	%s	Valor de parâmetro inválido.
400	InvalidLaunchTemplateName.Malformed	The specified parameter LaunchTemplateName is not valid.	Valor de LaunchTemplateName inválido.
400	InvalidUserData.SizeExceeded	%s	O tamanho máximo dos dados de usuário foi excedido.
400	InvalidUserData.Base64FormatInvalid	%s	Formato de UserData inválido.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	A chave da tag já existe. As chaves de tag devem ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor de Tag.N.Key inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor de Tag.N.Value inválido.
403	LaunchTemplateLimitExceed	%s	O número máximo de modelos de inicialização foi excedido.
403	LaunchTemplateName.Duplicated	%s	O nome do modelo de inicialização especificado já existe.
403	QuotaExceed.Tags	%s	O número máximo de tags foi excedido. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	O ID do grupo de recursos não existe.
500	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.