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

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 de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeLaunchTemplateVersions	A operação a ser executada. Defina o valor como DescribeLaunchTemplateVersions.
RegionId	String	Sim	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.
LaunchTemplateVersion.N	Long	Não	1	A versão N do modelo de inicialização.
LaunchTemplateId	String	Não	lt-bp168lnahrdwl39p****	O ID do modelo de inicialização. Configure LaunchTemplateId ou LaunchTemplateName para especificar um modelo de inicialização.
LaunchTemplateName	String	Não	testLaunchTemplateName	O nome do modelo de inicialização.
MinVersion	Long	Não	1	O número mínimo de versão no intervalo de versões a ser consultado.
MaxVersion	Long	Não	10	O número máximo de versão no intervalo de versões a ser consultado.
DefaultVersion	Boolean	Não	true	Indica se a versão padrão deve ser consultada.
DetailFlag	Boolean	Não	true	Indica se as configurações do modelo de inicialização devem ser consultadas. Valores válidos: true: consulta as informações básicas e outros detalhes do modelo de inicialização, incluindo o ID da imagem e o tamanho do disco do sistema. false: consulta apenas as informações básicas do modelo de inicialização, que incluem o ID do modelo, o nome do modelo e a versão padrão. Valor padrão: true.
PageNumber	Integer	Não	1	O número da página. As páginas começam na página 1. Valor padrão: 1.
PageSize	Integer	Não	10	O número de entradas por página. Valor padrão: 10.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PageSize	Integer	10	O número de entradas por página.
RequestId	String	3989ED0C-20A1-4351-A127-2067FF8390AX	O ID da solicitação.
PageNumber	Integer	1	O número da página.
TotalCount	Integer	1	O número total de modelos de inicialização.
LaunchTemplateVersionSets	Array of LaunchTemplateVersionSet		Os detalhes sobre as versões do modelo de inicialização.
LaunchTemplateVersionSet
LaunchTemplateName	String	testLaunchTemplateName	O nome do modelo de inicialização.
DefaultVersion	Boolean	true	Indica se a versão do modelo de inicialização é a versão padrão.
VersionNumber	Long	1	O número da versão do modelo de inicialização.
ModifiedTime	String	2022-01-17T08:40:00Z	A hora em que o modelo de inicialização foi modificado.
LaunchTemplateId	String	lt-bp67acfmxazb4p****	O ID do modelo de inicialização.
CreateTime	String	2022-01-17T08:22:43Z	A hora em que o modelo de inicialização foi criado.
CreatedBy	String	123456789****	O criador do modelo de inicialização.
VersionDescription	String	testVersionDescription	A descrição da versão do modelo de inicialização.
LaunchTemplateData	Object		As configurações do modelo de inicialização.
DeploymentSetId	String	ds-bp1brhwhoqinyjd6****	O ID do conjunto de implantação.
VpcId	String	v-bp67acfmxazb4p****	O ID da Virtual Private Cloud (VPC).
SystemDisk.PerformanceLevel	String	PL0	O nível de desempenho do ESSD usado como disco do sistema. Valores válidos: PL0 (padrão): Um único ESSD pode oferecer até 10.000 IOPS de leitura/gravação aleatória. PL1: Um único ESSD pode oferecer até 50.000 IOPS de leitura/gravação aleatória. PL2: Um único ESSD pode oferecer até 100.000 IOPS de leitura/gravação aleatória. PL3: Um único ESSD pode oferecer até 1.000.000 IOPS de leitura/gravação aleatória. Para obter mais informações sobre os níveis de desempenho do ESSD, consulte ESSDs.
KeyPairName	String	testKeyPairName	O nome do par de chaves.
SecurityGroupId	String	sg-bp67acfmxazb4p****	O ID do grupo de segurança ao qual atribuir a instância. Nota Os parâmetros `SecurityGroupId` e `SecurityGroupIds` são mutuamente exclusivos na resposta.
NetworkType	String	vpc	O tipo de rede. Valores válidos: classic: rede clássica vpc: VPC
SpotStrategy	String	NoSpot	A política de lance para a instância de pagamento conforme o uso. Valores válidos: NoSpot: A instância é criada como uma instância de pagamento conforme o uso. SpotWithPriceLimit: A instância é criada como uma instância preemptiva com um preço máximo por hora definido pelo usuário. SpotAsPriceGo: A instância é criada como uma instância preemptiva cujo preço de mercado no momento da compra é usado automaticamente como preço do lance.
EnableVmOsConfig	Boolean	false	Indica se a configuração do sistema operacional da instância deve ser ativada.
Description	String	testInstanceDescription	A descrição da instância.
SpotDuration	Integer	1	O período de proteção da instância preemptiva. Unidade: horas. Valores válidos: 0, 1, 2, 3, 4, 5 e 6. Observe os seguintes itens: Os seguintes períodos de proteção estão em visualização por convite: 2, 3, 4, 5 e 6 horas. Se quiser especificar um desses valores, envie um ticket. Um valor de 0 indica que nenhum período de proteção está configurado para a instância preemptiva.
InstanceName	String	testInstanceName	O nome da instância.
SecurityEnhancementStrategy	String	active	Indica se o reforço de segurança deve ser ativado.
UserData	String	SGVsbG9FQ1M=	Os dados do usuário da instância, codificados em Base64.
SystemDisk.DiskName	String	testSystemDiskName	O nome do disco do sistema.
SystemDisk.Size	Integer	40	O tamanho do disco do sistema. Unidade: GiB.
SpotPriceLimit	Float	0.98	O preço máximo por hora da instância preemptiva.
PasswordInherit	Boolean	true	Indica se o nome de usuário e a senha predefinidos na imagem devem ser usados.
PrivateIpAddress	String	10.1..	O endereço IP privado a ser atribuído à instância.
ImageId	String	m-bp67acfmxazb4p****	O ID da imagem.
SystemDisk.DeleteWithInstance	Boolean	true	Indica se o disco do sistema deve ser liberado quando a instância for liberada. Valores válidos: true false
SystemDisk.Category	String	cloud_ssd	A categoria do disco do sistema. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra. cloud_ssd: SSD padrão. cloud_essd: ESSD. cloud_auto: disco ESSD AutoPL. Use o parâmetro 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 de instância desativado, o valor padrão é cloud. Para outros tipos de instâncias, o valor padrão é cloud_efficiency.
AutoReleaseTime	String	2018-05-14T14:18:00Z	A hora para liberar automaticamente a instância.
SystemDisk.Description	String	testSystemDiskDescription	A descrição do disco do sistema.
ImageOwnerAlias	String	system	A origem 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
HostName	String	testHostName	O nome do host da instância.
SystemDisk.Iops	Integer	101800	O número de IOPS no disco do sistema.
SystemDisk.AutoSnapshotPolicyId	String	sp-bp1j0alc2z1fhvie****	O ID da política de snapshot automático.
InternetMaxBandwidthOut	Integer	100	A largura de banda pública de saída máxima.
InternetMaxBandwidthIn	Integer	5	A largura de banda pública de entrada máxima.
InstanceType	String	ecs.g5.large	O tipo de instância.
Period	Integer	1	A duração da assinatura.
InstanceChargeType	String	Postpaid	O método de faturamento da instância. Valores válidos: PrePaid: assinatura PostPaid: pagamento conforme o uso
IoOptimized	String	none	Indica se a instância é otimizada para E/S.
RamRoleName	String	testRamRoleName	O nome da função do Resource Access Management (RAM) da instância.
VSwitchId	String	vsw-bp67acfmxazb4p****	O ID do vSwitch ao qual conectar a instância.
ResourceGroupId	String	rg-bp67acfmxazb4p****	O ID do grupo de recursos ao qual atribuir o modelo de inicialização.
InternetChargeType	String	PayByTraffic	O método de faturamento para uso de rede.
ZoneId	String	cn-hangzhou-g	O ID da zona.
Ipv6AddressCount	Integer	1	O número de endereços IPv6 a serem atribuídos à instância.
DataDisks	Array of DataDisk		Os detalhes sobre os discos de dados.
DataDisk
PerformanceLevel	String	PL1	O nível de desempenho do ESSD usado como disco de dados. Este parâmetro é retornado apenas quando o valor de `Category` é cloud_essd. Valores válidos: PL0: Um único ESSD pode oferecer até 10.000 IOPS de leitura/gravação aleatória. PL1: Um único ESSD pode oferecer até 50.000 IOPS de leitura/gravação aleatória. PL2: Um único ESSD pode oferecer até 100.000 IOPS de leitura/gravação aleatória. PL3: Um único ESSD pode oferecer até 1.000.000 IOPS de leitura/gravação aleatória.
Description	String	testDiskDescription	A descrição do disco de dados.
SnapshotId	String	s-bp67acfmxazb4p****	O ID do snapshot a ser usado para criar o disco de dados.
Device	String	/dev/xvda	O nome do dispositivo do disco de dados. Nota Este parâmetro será removido no futuro. Recomendamos usar outros parâmetros para garantir compatibilidade futura.
Size	Integer	2000	O tamanho do disco de dados.
DiskName	String	testDiskName	O nome do disco de dados.
Category	String	cloud_ssd	A categoria do disco de dados.
DeleteWithInstance	Boolean	true	Indica se o disco de dados deve ser liberado quando a instância for liberada.
Encrypted	String	false	Indica se o disco de dados deve ser criptografado.
ProvisionedIops	Long	50000	Os IOPS de leitura/gravação provisionados do disco ESSD AutoPL. Valores válidos: 0 a min{50.000, 1.000 × Capacidade - IOPS de linha de base}. IOPS de linha de base = min{1.800 + 50 × Capacidade, 50.000}. Nota Este parâmetro é retornado apenas se o parâmetro de categoria de disco correspondente 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.
BurstingEnabled	Boolean	true	Indica se o recurso de pico de desempenho deve ser ativado. Valores válidos: true false
AutoSnapshotPolicyId	String	sp-wz91dz3ghear2a5s****	O ID da política de snapshot automático.
NetworkInterfaces	Array of NetworkInterface		Os detalhes sobre as interfaces de rede elásticas (ENIs) secundárias.
NetworkInterface
NetworkInterfaceName	String	testNetworkInterfaceName	O nome da ENI secundária.
VSwitchId	String	vsw-bp67acfmxazb4p****	O ID do vSwitch ao qual conectar a ENI secundária.
Description	String	testNetworkInterfacesDescription	A descrição da ENI secundária.
PrimaryIpAddress	String	203.0..	O endereço IP privado principal da ENI secundária.
SecurityGroupId	String	sg-bp67acfmxazb4p****	O ID do grupo de segurança ao qual atribuir a ENI secundária. O grupo de segurança e a ENI devem pertencer à mesma VPC. Nota Os parâmetros SecurityGroupId e SecurityGroupIds são mutuamente exclusivos na resposta.
SecurityGroupIds	Array of String	["sg-bp15ed6xe1yxeycg7****"]	Os IDs dos grupos de segurança aos quais atribuir a ENI secundária. Nota Os parâmetros SecurityGroupId e SecurityGroupIds são mutuamente exclusivos na resposta.
InstanceType	String	ecs.s2.xlarge	O tipo de instância.
NetworkInterfaceTrafficMode	String	Standard	O modo de comunicação da ENI principal. 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).
Tags	Array of InstanceTag		As tags a serem adicionadas à instância.
InstanceTag
Key	String	TestKey	A chave da tag a ser adicionada à instância.
Value	String	TestValue	O valor da tag a ser adicionada à instância.
SecurityGroupIds	Array of String	["sg-bp15ed6xe1yxeycg7****"]	Os IDs dos grupos de segurança aos quais atribuir a instância. Nota Os parâmetros `SecurityGroupId` e `SecurityGroupIds` são mutuamente exclusivos na resposta.
SystemDisk.ProvisionedIops	Long	50000	Os IOPS de leitura/gravação provisionados do disco ESSD AutoPL. Valores válidos: 0 a min{50.000, 1.000 × Capacidade - IOPS de linha de base}. IOPS de linha de base = min{1.800 + 50 × Capacidade, 50.000}. Nota Este parâmetro é retornado apenas se o parâmetro de categoria de disco correspondente 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	true	Indica se o recurso de pico de desempenho deve ser ativado. Valores válidos: true false
SystemDisk.Encrypted	String	false	Indica se o disco do sistema deve ser criptografado. Valores válidos: true false 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	false	Indica 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 Elastic Compute Service (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	Standard	O modo de desempenho da instância com capacidade de pico. Valores válidos: Standard: modo padrão. Para obter mais informações, consulte a seção "Modo padrão" no tópico Instâncias com capacidade de pico. Unlimited: modo ilimitado. Para obter mais informações, consulte a seção "Modo ilimitado" em Instâncias com capacidade de pico.

Exemplos

Solicitações de exemplo

http(s)://ecs.aliyuncs.com/?Action=DescribeLaunchTemplateVersions
&RegionId=cn-hangzhou
&LaunchTemplateId=lt-bp168lnahrdwl39p****
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<DescribeLaunchTemplateVersionsResponse>
    <PageSize>10</PageSize>
    <RequestId>3989ED0C-20A1-4351-A127-2067FF8390AX</RequestId>
    <PageNumber>1</PageNumber>
    <TotalCount>1</TotalCount>
    <LaunchTemplateVersionSets>
        <LaunchTemplateName>testLaunchTemplateName</LaunchTemplateName>
        <DefaultVersion>true</DefaultVersion>
        <VersionNumber>1</VersionNumber>
        <ModifiedTime>2022-01-17T08:40:00Z</ModifiedTime>
        <LaunchTemplateId>lt-bp67acfmxazb4p****</LaunchTemplateId>
        <CreateTime>2022-01-17T08:22:43Z</CreateTime>
        <CreatedBy>123456789****</CreatedBy>
        <VersionDescription>testVersionDescription</VersionDescription>
        <LaunchTemplateData>
            <DeploymentSetId>ds-bp1brhwhoqinyjd6****</DeploymentSetId>
            <VpcId>v-bp67acfmxazb4p****</VpcId>
            <SystemDisk.PerformanceLevel>PL0</SystemDisk.PerformanceLevel>
            <KeyPairName>testKeyPairName</KeyPairName>
            <SecurityGroupId>sg-bp67acfmxazb4p****</SecurityGroupId>
            <NetworkType>vpc</NetworkType>
            <SpotStrategy>NoSpot</SpotStrategy>
            <EnableVmOsConfig>false</EnableVmOsConfig>
            <Description>testInstanceDescription</Description>
            <SpotDuration>1</SpotDuration>
            <InstanceName>testInstanceName</InstanceName>
            <SecurityEnhancementStrategy>active</SecurityEnhancementStrategy>
            <UserData>SGVsbG9FQ1M=</UserData>
            <SystemDisk.DiskName>testSystemDiskName</SystemDisk.DiskName>
            <SystemDisk.Size>40</SystemDisk.Size>
            <SpotPriceLimit>0.98</SpotPriceLimit>
            <PasswordInherit>true</PasswordInherit>
            <PrivateIpAddress>10.1.**.**</PrivateIpAddress>
            <ImageId>m-bp67acfmxazb4p****</ImageId>
            <SystemDisk.DeleteWithInstance>true</SystemDisk.DeleteWithInstance>
            <SystemDisk.Category>cloud_ssd</SystemDisk.Category>
            <AutoReleaseTime>2018-05-14T14:18:00Z</AutoReleaseTime>
            <SystemDisk.Description>testSystemDiskDescription</SystemDisk.Description>
            <ImageOwnerAlias>system</ImageOwnerAlias>
            <HostName>testHostName</HostName>
            <SystemDisk.Iops>101800</SystemDisk.Iops>
            <InternetMaxBandwidthOut>100</InternetMaxBandwidthOut>
            <InternetMaxBandwidthIn>5</InternetMaxBandwidthIn>
            <InstanceType>ecs.g5.large</InstanceType>
            <Period>1</Period>
            <InstanceChargeType>Postpaid</InstanceChargeType>
            <IoOptimized>none</IoOptimized>
            <RamRoleName>testRamRoleName</RamRoleName>
            <VSwitchId>vsw-bp67acfmxazb4p****</VSwitchId>
            <ResourceGroupId>rg-bp67acfmxazb4p****</ResourceGroupId>
            <InternetChargeType>PayByTraffic</InternetChargeType>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <Ipv6AddressCount>1</Ipv6AddressCount>
            <DataDisks>
                <PerformanceLevel>PL1</PerformanceLevel>
                <Description>testDiskDescription</Description>
                <SnapshotId>s-bp67acfmxazb4p****</SnapshotId>
                <Device>/dev/xvda</Device>
                <Size>2000</Size>
                <DiskName>testDiskName</DiskName>
                <Category>cloud_ssd</Category>
                <DeleteWithInstance>true</DeleteWithInstance>
                <Encrypted>false</Encrypted>
            </DataDisks>
            <NetworkInterfaces>
                <NetworkInterfaceName>testNetworkInterfaceName</NetworkInterfaceName>
                <VSwitchId>vsw-bp67acfmxazb4p****</VSwitchId>
                <Description>testNetworkInterfacesDescription</Description>
                <PrimaryIpAddress>203.0.*.*</PrimaryIpAddress>
                <SecurityGroupId>sg-bp67acfmxazb4p****</SecurityGroupId>
                <SecurityGroupIds>["sg-bp15ed6xe1yxeycg7****"]</SecurityGroupIds>
            </NetworkInterfaces>
            <Tags>
                <Key>TestKey</Key>
                <Value>TestValue</Value>
            </Tags>
            <SecurityGroupIds>["sg-bp15ed6xe1yxeycg7****"]</SecurityGroupIds>
        </LaunchTemplateData>
    </LaunchTemplateVersionSets>
</DescribeLaunchTemplateVersionsResponse>

Formato JSON

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

{
  "PageSize" : 10,
  "RequestId" : "3989ED0C-20A1-4351-A127-2067FF8390AX",
  "PageNumber" : 1,
  "TotalCount" : 1,
  "LaunchTemplateVersionSets" : [ {
    "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,
      "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" : [ {
        "PerformanceLevel" : "PL1",
        "Description" : "testDiskDescription",
        "SnapshotId" : "s-bp67acfmxazb4p****",
        "Device" : "/dev/xvda",
        "Size" : 2000,
        "DiskName" : "testDiskName",
        "Category" : "cloud_ssd",
        "DeleteWithInstance" : true,
        "Encrypted" : "false"
      } ],
      "NetworkInterfaces" : [ {
        "NetworkInterfaceName" : "testNetworkInterfaceName",
        "VSwitchId" : "vsw-bp67acfmxazb4p****",
        "Description" : "testNetworkInterfacesDescription",
        "PrimaryIpAddress" : "203.0.*.*",
        "SecurityGroupId" : "sg-bp67acfmxazb4p****",
        "SecurityGroupIds" : [ "[\"sg-bp15ed6xe1yxeycg7****\"]" ]
      } ],
      "Tags" : [ {
        "Key" : "TestKey",
        "Value" : "TestValue"
      } ],
      "SecurityGroupIds" : [ "[\"sg-bp15ed6xe1yxeycg7****\"]" ]
    }
  } ]
}

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 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.
403	InnerServiceFailed	%s	Não foi possível chamar um serviço interno.
404	InvalidLaunchTemplate.NotFound	The specified LaunchTemplate is not found.	O modelo de inicialização não foi encontrado.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente mais tarde.

Acesse o Centro de Erros para ver mais códigos de erro.