Consulta informações sobre as versões do modelo de inicialização de instâncias ECS, como o número total de modelos de inicialização de instâncias, nomes dos modelos e números de versão dos modelos.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
ecs:DescribeLaunchTemplateVersions |
list |
Modelo de execução.
Modelo de execução.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| RegionId |
string |
Sim |
O ID da região do modelo de inicialização. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente. |
cn-hangzhou |
| LaunchTemplateVersion |
array |
Não |
Um ou mais números de versão do modelo de inicialização. |
1 |
|
integer |
Não |
Um ou mais números de versão do modelo de inicialização. |
1 |
|
| LaunchTemplateId |
string |
Não |
O ID do modelo de inicialização. Você deve especificar LaunchTemplateId ou LaunchTemplateName para determinar o modelo. |
lt-bp168lnahrdwl39p**** |
| LaunchTemplateName |
string |
Não |
O nome do modelo de inicialização. Você deve especificar LaunchTemplateId ou LaunchTemplateName para determinar o modelo. |
testLaunchTemplateName |
| MinVersion |
integer |
Não |
O número de versão mínimo usado para filtrar os resultados da consulta. Usado junto com MaxVersion para consultar informações de versão dentro do intervalo entre os números de versão mínimo e máximo. |
1 |
| MaxVersion |
integer |
Não |
O número de versão máximo usado para filtrar os resultados da consulta. Usado junto com MinVersion para consultar informações de versão dentro do intervalo entre os números de versão mínimo e máximo. |
10 |
| DefaultVersion |
boolean |
Não |
Especifica se a versão padrão deve ser consultada. |
true |
| DetailFlag |
boolean |
Não |
Especifica se as informações detalhadas de configuração do modelo devem ser consultadas. Valores válidos:
Valor padrão: true. |
true |
| PageNumber |
integer |
Não |
O número da página da lista de modelos de inicialização. Valor mínimo: 1. Valor padrão: 1. |
1 |
| PageSize |
integer |
Não |
O número de entradas por página em uma consulta paginada. Define o número de linhas por página para consultas paginadas. Valor padrão: 10. |
10 |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
A coleção de informações de versão. |
||
| PageSize |
integer |
O número de entradas por página. Este valor é definido para consultas paginadas. |
10 |
| RequestId |
string |
O ID da solicitação. |
3989ED0C-20A1-4351-A127-2067FF8390AX |
| PageNumber |
integer |
O número da página atual. |
1 |
| TotalCount |
integer |
O número total de modelos de execução. |
1 |
| LaunchTemplateVersionSets |
object |
||
| LaunchTemplateVersionSet |
array<object> |
As informações sobre as versões do modelo. |
|
|
array<object> |
As informações sobre as versões do modelo. |
||
| LaunchTemplateName |
string |
O nome do modelo. |
testLaunchTemplateName |
| DefaultVersion |
boolean |
Indica se o modelo é a versão padrão. |
true |
| VersionNumber |
integer |
O número da versão do modelo. |
1 |
| ModifiedTime |
string |
A hora em que o modelo foi modificado. A hora é exibida no formato ISO 8601 em UTC. |
2022-01-17T08:40:00Z |
| LaunchTemplateId |
string |
O ID do modelo. |
lt-bp67acfmxazb4p**** |
| CreateTime |
string |
A hora em que o modelo foi criado. A hora é exibida no formato ISO 8601 em UTC. |
2022-01-17T08:22:43Z |
| CreatedBy |
string |
O criador do modelo, que é o ID da conta Alibaba Cloud. |
123456789**** |
| VersionDescription |
string |
A descrição da versão do modelo. |
testVersionDescription |
| LaunchTemplateData |
object |
As configurações específicas do modelo. |
|
| DeploymentSetId |
string |
O ID do conjunto de implantação. |
ds-bp1brhwhoqinyjd6**** |
| VpcId |
string |
O ID da VPC. |
v-bp67acfmxazb4p**** |
| SystemDisk.PerformanceLevel |
string |
As configurações de nível de desempenho (PL) para o SSD empresarial (ESSD) usado como disco do sistema. Valores válidos:
Para mais informações sobre como selecionar um nível de desempenho de ESSD, consulte ESSD. |
PL0 |
| KeyPairName |
string |
O nome do par de chaves. |
testKeyPairName |
| SecurityGroupId |
string |
O ID do grupo de segurança da instância. Nota
SecurityGroupId e SecurityGroupIds não são retornados ao mesmo tempo. |
sg-bp67acfmxazb4p**** |
| NetworkType |
string |
O tipo de rede. Valores válidos:
|
vpc |
| SpotStrategy |
string |
A política de lance para instâncias pay-as-you-go. Valores válidos:
|
NoSpot |
| EnableVmOsConfig |
boolean |
Indica se a configuração do sistema operacional da instância está ativada. |
false |
| Description |
string |
A descrição da instância. |
testInstanceDescription |
| SpotDuration |
integer |
O período de proteção da instância spot. Unidade: horas. Valores válidos:
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. Selecione um período de proteção adequado com base na duração esperada da execução da tarefa. Nota
Este parâmetro é retornado apenas quando SpotStrategy é definido como SpotWithPriceLimit ou SpotAsPriceGo. |
1 |
| InstanceName |
string |
O nome da instância. |
testInstanceName |
| SecurityEnhancementStrategy |
string |
Especifica se o reforço de segurança está ativado. |
active |
| UserData |
string |
Os dados do usuário da instância, que são codificados em Base64. |
SGVsbG9FQ1M= |
| SystemDisk.DiskName |
string |
O nome do disco do sistema. |
testSystemDiskName |
| SystemDisk.Size |
integer |
O tamanho do disco do sistema. Unidade: GiB. |
40 |
| SpotPriceLimit |
number |
O preço máximo por hora da instância. |
0.98 |
| PasswordInherit |
boolean |
Indica se o par de nome de usuário e senha predefinido na imagem é herdado. |
true |
| PrivateIpAddress |
string |
O endereço IP privado da instância. |
10.1.**.** |
| ImageId |
string |
O ID da imagem usada pela instância. |
m-bp67acfmxazb4p**** |
| SystemDisk.DeleteWithInstance |
boolean |
Indica se o disco do sistema é liberado quando a instância é liberada. Valores válidos:
|
true |
| SystemDisk.Category |
string |
A categoria do disco do sistema. Valores válidos:
Para tipos de instância descontinuados que não são instâncias com otimização de I/O, o valor padrão é cloud. Para outros tipos de instância, o valor padrão é cloud_efficiency. |
cloud_ssd |
| AutoReleaseTime |
string |
A hora de liberação automática. A hora é exibida no formato ISO 8601 em UTC. |
2018-05-14T14:18:00Z |
| SystemDisk.Description |
string |
A descrição do disco do sistema. |
testSystemDiskDescription |
| ImageOwnerAlias |
string |
A origem da imagem. Valores válidos:
|
system |
| HostName |
string |
O nome do host da instância. |
testHostName |
| SystemDisk.Iops |
integer |
O total de IOPS do disco do sistema. |
101800 |
| SystemDisk.AutoSnapshotPolicyId |
string |
O ID da política de snapshot automático. |
sp-bp1j0alc2z1fhvie**** |
| InternetMaxBandwidthOut |
integer |
A largura de banda pública de saída máxima. |
100 |
| InternetMaxBandwidthIn |
integer |
A largura de banda pública de entrada máxima. |
5 |
| InstanceType |
string |
O tipo de instância. |
ecs.g5.large |
| Period |
integer |
A duração do recurso adquirido. |
1 |
| InstanceChargeType |
string |
O método de cobrança da instância. Valores válidos:
|
Postpaid |
| IoOptimized |
string |
Indica se a instância é uma instância com otimização de I/O. |
none |
| RamRoleName |
string |
O nome da função RAM da instância. |
testRamRoleName |
| VSwitchId |
string |
O ID do vSwitch ao qual a instância pertence. |
vsw-bp67acfmxazb4p**** |
| ResourceGroupId |
string |
O ID do grupo de recursos ao qual o modelo de execução pertence. |
rg-bp67acfmxazb4p**** |
| InternetChargeType |
string |
Os métodos de cobrança para largura de banda pública. |
PayByTraffic |
| ZoneId |
string |
O ID da zona. |
cn-hangzhou-g |
| Ipv6AddressCount |
integer |
O número de endereços IPv6 atribuídos à instância. |
1 |
| DataDisks |
object |
||
| DataDisk |
array<object> |
A coleção de discos de dados. |
|
|
object |
A coleção de discos de dados. |
||
| PerformanceLevel |
string |
As configurações de nível de desempenho (PL) para o SSD empresarial usado como disco de dados. Este parâmetro é retornado apenas quando Category=cloud_essd. Valores válidos:
|
PL1 |
| Description |
string |
A descrição do disco de dados. |
testDiskDescription |
| SnapshotId |
string |
O ID do snapshot usado pelo disco de dados. |
s-bp67acfmxazb4p**** |
| Device |
string |
O ponto de montagem do disco de dados. A convenção de nomenclatura varia com base no número de discos de dados anexados:
Nota
Este parâmetro é usado apenas para imagens completas (imagens de máquina inteira). Você pode definir este parâmetro como o ponto de montagem do disco de dados na imagem completa e modificar os parâmetros DataDisk.N.Size e DataDisk.N.Category correspondentes para alterar a categoria e o tamanho do disco de dados na imagem completa. |
/dev/xvdb |
| Size |
integer |
O tamanho do disco de dados. |
2000 |
| DiskName |
string |
O nome do disco de dados. |
testDiskName |
| Category |
string |
A categoria do disco de dados N. Valores válidos:
Para instâncias com otimização de I/O, o valor padrão é cloud_efficiency. Para instâncias sem otimização de I/O, o valor padrão é cloud. Descrição do valor padrão:
|
cloud_ssd |
| DeleteWithInstance |
boolean |
Indica se o disco de dados é liberado quando a instância é liberada. |
true |
| Encrypted |
string |
Indica se o disco de dados é criptografado. |
false |
| ProvisionedIops |
integer |
Especifica se deve modificar os IOPS de leitura/gravação provisionados do disco ESSD AutoPL. 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 é suportado apenas quando DiskCategory é definido como cloud_auto. Para mais informações, consulte Disco ESSD AutoPL e Modificar o desempenho provisionado de um disco ESSD AutoPL. |
50000 |
| BurstingEnabled |
boolean |
Indica se o recurso de burst de desempenho está ativado. Valores válidos:
|
true |
| AutoSnapshotPolicyId |
string |
O ID da política de snapshot automático. |
sp-wz91dz3ghear2a5s**** |
| KMSKeyId |
string |
O ID da chave do Key Management Service (KMS) do disco de dados. |
0e478b7a-4262-4802-b8cb-00d3fb40**** |
| NetworkInterfaces |
object |
||
| NetworkInterface |
array<object> |
A coleção de configurações de propriedades para controladores de interface de rede (NICs) secundários. |
|
|
array<object> |
A coleção de configurações de propriedades para controladores de interface de rede (NICs) secundários. |
||
| NetworkInterfaceName |
string |
O nome do controlador de interface de rede (NIC) secundário. |
testNetworkInterfaceName |
| VSwitchId |
string |
O ID do vSwitch ao qual o controlador de interface de rede (NIC) pertence. |
vsw-bp67acfmxazb4p**** |
| Description |
string |
A descrição do controlador de interface de rede (NIC) secundário. |
testNetworkInterfacesDescription |
| PrimaryIpAddress |
string |
O endereço IP privado principal do controlador de interface de rede (NIC) secundário. |
203.0.*.* |
| SecurityGroupId |
string |
O ID do grupo de segurança do controlador de interface de rede (NIC) secundário. O grupo de segurança deve pertencer à mesma VPC. Nota
SecurityGroupId e SecurityGroupIds não são retornados ao mesmo tempo. |
sg-bp67acfmxazb4p**** |
| SecurityGroupIds |
object |
||
| SecurityGroupId |
array |
Um ou mais grupos de segurança aos quais o controlador de interface de rede (NIC) secundário pertence. Nota
SecurityGroupId e SecurityGroupIds não são retornados ao mesmo tempo. |
|
|
string |
Um ou mais grupos de segurança aos quais o controlador de interface de rede (NIC) secundário pertence. Nota
SecurityGroupId e SecurityGroupIds não são retornados ao mesmo tempo. |
["sg-bp15ed6xe1yxeycg7****"] |
|
| InstanceType |
string |
O tipo de instância. |
ecs.s2.xlarge |
| NetworkInterfaceTrafficMode |
string |
O modo de comunicação da ENI primária. Valores válidos:
|
Standard |
| DeleteOnRelease |
boolean |
Indica se a ENI é retida quando a instância é liberada. Valores válidos:
|
true |
| Tags |
object |
||
| InstanceTag |
array<object> |
As tags da instância. |
|
|
object |
As tags da instância. |
||
| Key |
string |
A chave da tag da instância. |
TestKey |
| Value |
string |
O valor da tag da instância. |
TestValue |
| SecurityGroupIds |
object |
||
| SecurityGroupId |
array |
Os IDs dos grupos de segurança aos quais a instância pertence. Nota
|
|
|
string |
Os IDs dos grupos de segurança aos quais a instância pertence. Nota
|
["sg-bp15ed6xe1yxeycg7****"] |
|
| SystemDisk.ProvisionedIops |
integer |
Os IOPS de leitura/gravação provisionados do disco ESSD AutoPL. 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 é 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 |
Indica se o recurso de burst de desempenho está ativado. Valores válidos:
|
true |
| SystemDisk.Encrypted |
string |
Indica se o disco do sistema está criptografado. Valores válidos:
Valor padrão: false. Nota
A Zona D de Hong Kong (China) e a Zona A de Singapura não suportam a criptografia do disco do sistema ao criar uma instância. |
false |
| DeletionProtection |
boolean |
O atributo de proteção contra liberação da instância. Este parâmetro especifica se a instância pode ser liberada no console do ECS ou chamando a operação DeleteInstance. Valores válidos:
Valor padrão: false. Nota
Este atributo se aplica apenas a instâncias pay-as-you-go. Ele pode impedir apenas a liberação manual, não a liberação iniciada pelo sistema. |
false |
| CreditSpecification |
string |
O modo de desempenho da instância burstable. Valores válidos:
|
Standard |
| AutoRenew |
boolean |
Indica se a renovação automática está ativada. Este parâmetro entra em vigor apenas quando
Valor padrão: false. |
true |
| AutoRenewPeriod |
integer |
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 |
A unidade do período dos métodos de cobrança por assinatura. Valores válidos: Month (padrão). |
Month |
| HttpEndpoint |
string |
Indica se o canal de acesso para metadados da instância está ativado. Valores válidos:
Valor padrão: enabled. Nota
Para mais informações sobre metadados da instância, consulte Visão geral dos metadados da instância. |
enabled |
| HttpTokens |
string |
Especifica se o modo reforçado (IMDSv2) é necessário ao acessar os metadados da instância. Valores válidos:
Valor padrão: optional. Nota
Para mais informações sobre os padrões de acesso aos metadados da instância, consulte Visão geral dos metadados da instância. |
optional |
| HttpPutResponseHopLimit |
integer |
Nota
Este parâmetro não está disponível para uso. |
3 |
| SystemDisk.KMSKeyId |
string |
O ID da chave KMS do disco do sistema. |
0e478b7a-4262-4802-b8cb-00d3fb40**** |
| ImageOptions |
object |
As informações de propriedade relacionadas à imagem. |
|
| LoginAsNonRoot |
boolean |
Indica se a instância que usa esta imagem suporta login com o usuário ecs-user. Valores válidos:
|
false |
| SecurityOptions |
object |
As opções de segurança. |
|
| TrustedSystemMode |
string |
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:
Ao criar instâncias ECS das famílias de instâncias anteriores, você deve definir este parâmetro. Observe os seguintes itens:
Nota
Se você especificar a instância como uma instância confiável ao criá-la, poderá substituir o disco do sistema apenas por uma imagem que suporte o sistema confiável. Para mais informações sobre o sistema confiável, consulte Visão geral dos recursos confiáveis para instâncias com segurança aprimorada. |
vTPM |
Exemplos
Resposta de sucesso
JSON formato
{
"PageSize": 10,
"RequestId": "3989ED0C-20A1-4351-A127-2067FF8390AX",
"PageNumber": 1,
"TotalCount": 1,
"LaunchTemplateVersionSets": {
"LaunchTemplateVersionSet": [
{
"LaunchTemplateName": "testLaunchTemplateName",
"DefaultVersion": true,
"VersionNumber": 1,
"ModifiedTime": "2022-01-17T08:40:00Z",
"LaunchTemplateId": "lt-bp67acfmxazb4p****",
"CreateTime": "2022-01-17T08:22:43Z",
"CreatedBy": "123456789****",
"VersionDescription": "testVersionDescription",
"LaunchTemplateData": {
"DeploymentSetId": "ds-bp1brhwhoqinyjd6****",
"VpcId": "v-bp67acfmxazb4p****",
"SystemDisk.PerformanceLevel": "PL0",
"KeyPairName": "testKeyPairName",
"SecurityGroupId": "sg-bp67acfmxazb4p****",
"NetworkType": "vpc",
"SpotStrategy": "NoSpot",
"EnableVmOsConfig": false,
"Description": "testInstanceDescription",
"SpotDuration": 1,
"InstanceName": "testInstanceName",
"SecurityEnhancementStrategy": "active",
"UserData": "SGVsbG9FQ1M=",
"SystemDisk.DiskName": "testSystemDiskName",
"SystemDisk.Size": 40,
"SpotPriceLimit": 0.98,
"PasswordInherit": true,
"PrivateIpAddress": "10.1.**.**",
"ImageId": "m-bp67acfmxazb4p****",
"SystemDisk.DeleteWithInstance": true,
"SystemDisk.Category": "cloud_ssd",
"AutoReleaseTime": "2018-05-14T14:18:00Z",
"SystemDisk.Description": "testSystemDiskDescription",
"ImageOwnerAlias": "system",
"HostName": "testHostName",
"SystemDisk.Iops": 101800,
"SystemDisk.AutoSnapshotPolicyId": "sp-bp1j0alc2z1fhvie****",
"InternetMaxBandwidthOut": 100,
"InternetMaxBandwidthIn": 5,
"InstanceType": "ecs.g5.large",
"Period": 1,
"InstanceChargeType": "Postpaid",
"IoOptimized": "none",
"RamRoleName": "testRamRoleName",
"VSwitchId": "vsw-bp67acfmxazb4p****",
"ResourceGroupId": "rg-bp67acfmxazb4p****",
"InternetChargeType": "PayByTraffic",
"ZoneId": "cn-hangzhou-g",
"Ipv6AddressCount": 1,
"DataDisks": {
"DataDisk": [
{
"PerformanceLevel": "PL1",
"Description": "testDiskDescription",
"SnapshotId": "s-bp67acfmxazb4p****",
"Device": "/dev/xvdb",
"Size": 2000,
"DiskName": "testDiskName",
"Category": "cloud_ssd",
"DeleteWithInstance": true,
"Encrypted": "false",
"ProvisionedIops": 50000,
"BurstingEnabled": true,
"AutoSnapshotPolicyId": "sp-wz91dz3ghear2a5s****",
"KMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****"
}
]
},
"NetworkInterfaces": {
"NetworkInterface": [
{
"NetworkInterfaceName": "testNetworkInterfaceName",
"VSwitchId": "vsw-bp67acfmxazb4p****",
"Description": "testNetworkInterfacesDescription",
"PrimaryIpAddress": "203.0.*.*",
"SecurityGroupId": "sg-bp67acfmxazb4p****",
"SecurityGroupIds": {
"SecurityGroupId": [
"[\"sg-bp15ed6xe1yxeycg7****\"]"
]
},
"InstanceType": "ecs.s2.xlarge",
"NetworkInterfaceTrafficMode": "Standard",
"DeleteOnRelease": true
}
]
},
"Tags": {
"InstanceTag": [
{
"Key": "TestKey",
"Value": "TestValue"
}
]
},
"SecurityGroupIds": {
"SecurityGroupId": [
"[\"sg-bp15ed6xe1yxeycg7****\"]"
]
},
"SystemDisk.ProvisionedIops": 50000,
"SystemDisk.BurstingEnabled": true,
"SystemDisk.Encrypted": "false",
"DeletionProtection": false,
"CreditSpecification": "Standard",
"AutoRenew": true,
"AutoRenewPeriod": 1,
"PeriodUnit": "Month",
"HttpEndpoint": "enabled",
"HttpTokens": "optional",
"HttpPutResponseHopLimit": 3,
"SystemDisk.KMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****\n",
"ImageOptions": {
"LoginAsNonRoot": false
},
"SecurityOptions": {
"TrustedSystemMode": "vTPM"
}
}
}
]
}
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidRegion.NotExist | %s | A região especificada não existe. Verifique se o parâmetro está correto. |
| 400 | MissingParameter | %s | Um parâmetro obrigatório está ausente. |
| 400 | InvalidParameter | %s | Os parâmetros da solicitação atual são inválidos. Tente novamente. |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | Ocorreu um erro interno. Tente novamente. |
| 403 | InnerServiceFailed | %s | Falha na invocação de serviço interno. |
| 404 | InvalidLaunchTemplate.NotFound | The specified LaunchTemplate is not found. | O modelo de inicialização especificado não foi encontrado. Verifique se os parâmetros estão corretos. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.