Cria uma versão para um modelo de inicialização.
Observações de uso
Para modificar os parâmetros de uma versão do modelo de inicialização, crie outra versão com configurações diferentes para o mesmo modelo. Cada modelo de inicialização aceita até 30 versões.
Depuração
Parâmetros de solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
| Action | String | Yes | CreateLaunchTemplateVersion |
A operação a ser executada. Defina o valor como CreateLaunchTemplateVersion. |
| RegionId | String | Yes | cn-hangzhou |
O ID da região do modelo de inicialização. Chame a operação DescribeRegions para consultar a lista mais recente de regiões. |
| LaunchTemplateId | String | No | lt-m5eiaupmvm2op9d**** |
O ID do modelo de inicialização. Para obter mais informações, chame a operação DescribeLaunchTemplates. Especifique |
| LaunchTemplateName | String | No | testLaunchTemplateName |
O nome do modelo de inicialização. Deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com |
| VersionDescription | String | No | testVersionDescription |
A descrição da versão do modelo de inicialização. Deve ter de 2 a 256 caracteres e não pode começar com |
| ImageId | String | No | win2008r2_64_ent_sp1_en-us_40G_alibase_20170915.vhd |
O ID da imagem usada para criar instâncias do Elastic Compute Service (ECS). Chame a operação DescribeImages para consultar as imagens disponíveis. |
| ImageOwnerAlias | String | No | system |
A origem da imagem. Nota Este parâmetro será removido futuramente. Recomendamos usar outros parâmetros para garantir compatibilidade futura. |
| PasswordInherit | Boolean | No | false |
Define se a senha predefinida na imagem deve ser usada. Valores válidos:
Valor padrão: false. Nota Se PasswordInherit for especificado, deixe Password vazio e certifique-se de que a imagem selecionada possui uma senha predefinida. |
| InstanceType | String | No | ecs.g5.large |
O tipo de instância. Para obter mais informações, consulte Visão geral das famílias de instâncias ou chame a operação DescribeInstanceTypes para consultar a lista mais recente de tipos de instância. |
| SecurityGroupId | String | No | sg-bp15ed6xe1yxeycg**** |
O ID do grupo de segurança ao qual a instância será atribuída. Instâncias no mesmo grupo de segurança podem acessar umas às outras. 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 VpcId for especificado. |
| InstanceName | String | No | testInstanceName |
O nome da instância. Deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com |
| Description | String | No | testDescription |
A descrição da instância. Deve ter de 2 a 256 caracteres e não pode começar com |
| InternetMaxBandwidthIn | Integer | No | 50 |
A largura de banda pública de entrada máxima. Unidade: Mbit/s. Valores válidos:
|
| InternetMaxBandwidthOut | Integer | No | 5 |
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.
|
| ZoneId | String | No | cn-hangzhou-g |
O ID da zona onde criar a instância. |
| SystemDisk.Category | String | No | cloud_ssd |
A categoria do disco do sistema. Valores válidos:
Para instâncias não otimizadas para E/S de um tipo descontinuado, o valor padrão é cloud. Para os demais tipos, 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 deve ser pelo menos 20 e maior ou igual ao tamanho da imagem. |
| SystemDisk.DiskName | String | No | cloud_ssdSystem |
O nome do disco do sistema. Deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com |
| SystemDisk.Description | String | No | testSystemDiskDescription |
A descrição do disco do sistema. Deve ter de 2 a 256 caracteres e não pode começar com |
| SystemDisk.Iops | Integer | No | 30000 |
Nota Este parâmetro 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:
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:
Valor padrão: true. |
| SystemDisk.AutoSnapshotPolicyId | String | No | sp-bp1dgzpaxwc4load**** |
O ID da política de snapshot automático aplicada ao disco do sistema. |
| SystemDisk.ProvisionedIops | Long | No | 50000 |
Os IOPS de leitura/gravação provisionados do disco ESSD AutoPL usado como disco de dados N. Valores válidos: 0 a min{50.000, 1.000 × Capacidade - Desempenho base} Desempenho base = min{1.800 + 50 × Capacidade, 50.000} Nota Este parâmetro está disponível apenas se DataDisk.N.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 pico de desempenho deve ser ativado. Valores válidos:
|
| IoOptimized | String | No | optimized |
Define se a instância é otimizada para E/S. Valores válidos:
|
| InstanceChargeType | String | No | PrePaid |
O método de faturamento da instância. Valores válidos:
|
| Period | Integer | No | 1 |
A duração da assinatura da instância. Unidade: mês. Este parâmetro é válido e obrigatório apenas quando |
| InternetChargeType | String | No | PayByTraffic |
O método de faturamento para uso de rede. Valores válidos:
Nota No método de faturamento pagamento por tráfego, as larguras de banda máxima de entrada e saída funcionam como limites superiores, e não como especificações de desempenho garantido. Em cenários de alta demanda, os valores máximos podem ser limitados. Para largura de banda garantida, utilize o método pagamento por largura de banda. |
| EnableVmOsConfig | Boolean | No | false |
Define se a configuração do sistema operacional da instância deve ser ativada. |
| NetworkType | String | No | vpc |
O tipo de rede da instância. Valores válidos:
|
| UserData | String | No | ZWNobyBoZWxsbyBl**** |
Os dados de usuário da instância. Devem estar codificados em Base64. O tamanho máximo dos dados brutos é 16 KB. |
| KeyPairName | String | No | testKeyPairName |
O nome do par de chaves.
|
| 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 criadas por você. |
| 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.
|
| SpotStrategy | String | No | NoSpot |
A política de preempção para a instância de pagamento conforme o uso. Este parâmetro só tem efeito quando
|
| SpotPriceLimit | Float | No | 0.97 |
O preço máximo por hora da instância preemptível. São permitidas até três casas decimais. |
| SpotDuration | Integer | No | 1 |
O período de proteção da instância preemptível. Unidade: horas. Valor padrão: 1. Valores válidos:
O Alibaba Cloud envia um evento de sistema 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 adequado às necessidades 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. |
| SecurityEnhancementStrategy | String | No | Active |
Define se o reforço de segurança do sistema operacional deve ser ativado. Valores válidos:
|
| PrivateIpAddress | String | No | 10.1.**.** |
O endereço IP privado a ser atribuído à instância. Para atribuir um endereço IP privado a uma instância em uma VPC, certifique-se de que o endereço esteja livre dentro do bloco CIDR do vSwitch especificado por |
| Ipv6AddressCount | Integer | No | 1 |
A quantidade de endereços IPv6 gerados aleatoriamente para a interface de rede elástica (ENI) primária. Valores válidos: 1 a 10. |
| DeploymentSetId | String | No | ds-bp1brhwhoqinyjd6**** |
O ID do conjunto de implantação onde a instância será implantada. |
| DataDisk.N.PerformanceLevel | String | No | PL1 |
O nível de desempenho do ESSD usado como disco de dados N. O valor de N deve ser igual ao de
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 de 2 a 256 caracteres e não pode começar com |
| DataDisk.N.SnapshotId | String | No | s-bp17441ohwka0yuh**** |
O ID do snapshot usado para criar o disco de dados N. Valores válidos de N: 1 a 16. Se 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:
O valor deve ser maior ou igual ao tamanho do snapshot especificado por |
| DataDisk.N.Device | String | No | null |
Nota Este parâmetro será removido futuramente. Recomendamos usar outros parâmetros para garantir compatibilidade futura. |
| DataDisk.N.DiskName | String | No | testDataDiskName |
O nome do disco de dados N. Deve ter de 2 a 128 caracteres, começar com uma letra e não pode iniciar com |
| DataDisk.N.Category | String | No | cloud_ssd |
A categoria do disco de dados N. Valores válidos:
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:
Valor padrão: true. |
| DataDisk.N.Encrypted | String | No | false |
Define se o disco de dados N deve ser criptografado. |
| DataDisk.N.ProvisionedIops | Long | No | 50000 |
Os IOPS de leitura/gravação provisionados do disco ESSD AutoPL usado como disco de dados N. Valores válidos: 0 a min{50.000, 1.000 × Capacidade - Desempenho base} Desempenho base = min{1.800 + 50 × Capacidade, 50.000} Nota Este parâmetro está disponível apenas se DataDisk.N.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. |
| DataDisk.N.BurstingEnabled | Boolean | No | true |
Define se o recurso de pico de desempenho deve ser ativado. Valores válidos:
|
| DataDisk.N.AutoSnapshotPolicyId | String | No | sp-bp67acfmxazb4p**** |
O ID da política de snapshot automático aplicada ao disco de dados N. |
| NetworkInterface.N.VSwitchId | String | No | vsw-bp1s5fnvk4gn2tws0**** |
O ID do vSwitch ao qual conectar a ENI secundária. A instância e a ENI secundária devem residir na mesma zona da mesma VPC, mas podem estar conectadas a vSwitches diferentes. O valor de N em |
| NetworkInterface.N.NetworkInterfaceName | String | No | testNetworkInterfaceName |
O nome da ENI secundária. O valor de N em |
| NetworkInterface.N.Description | String | No | testNetworkInterfaceDescription |
A descrição da ENI secundária. Deve ter de 2 a 256 caracteres e não pode começar com |
| NetworkInterface.N.SecurityGroupId | String | No | sg-bp15ed6xe1yxeycg**** |
O ID do grupo de segurança ao qual atribuir a ENI secundária. Os grupos de segurança da ENI secundária e da instância devem pertencer à mesma VPC. O valor de N em Nota Não é possível especificar NetworkInterface.N.SecurityGroupId e NetworkInterface.N.SecurityGroupIds.N simultaneamente. |
| NetworkInterface.N.PrimaryIpAddress | String | No | 192.168.**.** |
O endereço IP privado primário da ENI secundária. O valor de N em |
| NetworkInterface.N.SecurityGroupIds.N | String | No | sg-bp67acfmxazb4p**** |
O ID do grupo de segurança N ao qual atribuir a ENI secundária. O grupo de segurança e a ENI secundária devem pertencer à mesma VPC. Os valores válidos de N em Nota Não é possível especificar NetworkInterface.N.SecurityGroupId e NetworkInterface.N.SecurityGroupIds.N simultaneamente. |
| NetworkInterface.N.InstanceType | String | No | Secondary |
O tipo da ENI N. Valores válidos de N: 1 e 2. Se N for 1, configure uma ENI primária ou secundária. Se N for 2, configure uma ENI primária e uma secundária. Valores válidos:
Valor padrão: Secondary. |
| NetworkInterface.N.NetworkInterfaceTrafficMode | String | No | Standard |
O modo de comunicação da ENI primária. Valores válidos:
|
| Tag.N.Key | String | No | TestKey |
A chave da tag N adicionada à instância, aos dispositivos Elastic Block Storage (EBS) ou à ENI primária. Valores válidos de N: 1 a 5. A chave da tag não pode ser uma string vazia. Pode ter até 64 caracteres e não pode começar com |
| Tag.N.Value | String | No | TestValue |
O valor da tag N adicionado à instância, aos dispositivos EBS ou à ENI primária. Valores válidos de N: 1 a 5. O valor da tag pode ser uma string vazia. Pode ter até 128 caracteres e não pode começar com |
| SecurityGroupIds.N | String | No | sg-bp15ed6xe1yxeycg7**** |
O ID do grupo de segurança N ao qual atribuir a instância. 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 Limites. Nota Não é possível especificar SecurityGroupId e SecurityGroupIds.N simultaneamente. |
| SystemDisk.Encrypted | String | No | false |
Define se o disco do sistema deve ser criptografado. Valores válidos:
Valor padrão: false. Nota Ao criar instâncias na Zona D de Hong Kong ou na Zona A de Singapura, não é 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 ECS ou chamar a operação DeleteInstance para liberar a instância. Valores válidos:
Valor padrão: false. Nota Este parâmetro aplica-se apenas a instâncias de pagamento conforme o uso. 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 pico. Valores válidos:
|
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
LaunchTemplateVersionNumber |
Long |
2 |
O número da versão do modelo de inicialização. |
|
RequestId |
String |
473469C7-AA6F-4DC5-B3DB-A3DC0DEX**** |
O ID da solicitação. |
|
LaunchTemplateId |
String |
lt-bp1apo0bbbkuy0rj**** |
O ID do modelo de inicialização. Para obter mais informações, consulte DescribeLaunchTemplates. Especifique LaunchTemplateId ou LaunchTemplateName para identificar um modelo de inicialização. |
Exemplos
Solicitações de exemplo
http(s)://ecs.aliyuncs.com/?Action=CreateLaunchTemplateVersion
&RegionId=cn-hangzhou
&LaunchTemplateId=lt-m5eiaupmvm2op9d****
&LaunchTemplateName=testLaunchTemplateName
&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-bp1s5fnvk4gn2tws0****
&InstanceName=testInstanceName
&Description=testDescription
&InternetMaxBandwidthIn=50
&InternetMaxBandwidthOut=5
&HostName=testHostName
&ZoneId=cn-hangzhou-g
&SystemDisk.Category=cloud_ssd
&SystemDisk.Size=40
&SystemDisk.DiskName=testSystemDiskName
&SystemDisk.Description=testSystemDiskDescription
&DataDisk.1.Size=2000
&DataDisk.1.SnapshotId=s-bp17441ohwka0yuh****
&DataDisk.1.Category=cloud_ssd
&DataDisk.1.Encrypted=false
&DataDisk.1.DiskName=cloud_ssdData
&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=testNetworkInterfaceName
&NetworkInterface.1.Description=testNetworkInterfaceDescription
&PrivateIpAddress=10.1.**.**
&InstanceChargeType=PrePaid
&Period=1
&InternetChargeType=PayByTraffic
&NetworkType=vpc
&UserData=ZWNobyBoZWxsbyBl****
&RamRoleName=testRamRoleName
&AutoReleaseTime=2020-02-02T12:05:00Z
&SpotStrategy=NoSpot
&SpotPriceLimit=0.97
&SecurityEnhancementStrategy=Active
&Tag.1.Key=TestKey
&Tag.1.Value=TestValue
&<Common request parameters>
Respostas de sucesso de exemplo
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateLaunchTemplateVersionResponse>
<LaunchTemplateVersionNumber>2</LaunchTemplateVersionNumber>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DEX****</RequestId>
<LaunchTemplateId>lt-bp1apo0bbbkuy0rj****</LaunchTemplateId>
</CreateLaunchTemplateVersionResponse>
Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"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 foi encontrada. |
|
400 |
MissingParameter |
%s |
Um parâmetro obrigatório não foi especificado. |
|
400 |
InvalidParameter |
%s |
Valor de parâmetro inválido. |
|
400 |
InvalidDescription.Malformed |
The specified parameter "Description" is not valid. |
Formato de descrição inválido. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://. |
|
400 |
InvalidUserData.SizeExceeded |
%s |
O tamanho máximo dos dados de usuário especificados 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. |
|
403 |
LaunchTemplateVersionLimitExceed |
%s |
O número máximo de versões do modelo de inicialização foi excedido. |
|
404 |
InvalidLaunchTemplate.NotFound |
%s |
O modelo de inicialização especificado não foi encontrado. Verifique se o valor do parâmetro está correto. |
|
404 |
InvalidResourceGroup.NotFound |
The ResourceGroup provided does not exist in our records. |
O grupo de recursos não foi encontrado. |
|
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.