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

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeLaunchTemplates	Operação a ser executada. Defina o valor como DescribeLaunchTemplates.
RegionId	String	Sim	cn-hangzhou	ID da região do modelo de inicialização. Chame a operação DescribeRegions para obter a lista de regiões mais recente.
TemplateTag.N.Key	String	Não	TestKey	Chave da tag N do modelo de inicialização. Valores válidos de N: 1 a 20. Ao especificar uma única tag na consulta, a resposta exibe até 1.000 recursos associados a ela. Se houver múltiplas tags, retornam-se até 1.000 recursos que contenham todas as tags informadas. Para consultar mais de 1.000 recursos com tags específicas, chame a operação ListTagResources.
TemplateTag.N.Value	String	Não	TestValue	Valor da tag N do modelo de inicialização. Valores válidos de N: 1 a 20.
PageNumber	Integer	Não	1	Número da página a retornar. A numeração inicia em 1. Valor padrão: 1.
PageSize	Integer	Não	10	Número de entradas a retornar por página. Valor padrão: 10.
TemplateResourceGroupId	String	Não	rg-acfmxazb4p****	ID do grupo de recursos ao qual o modelo de inicialização pertence. Ao usar este parâmetro na consulta, a resposta pode exibir até 1.000 recursos do grupo especificado. Nota Recursos do grupo de recursos padrão aparecem na resposta independentemente da configuração deste parâmetro.
LaunchTemplateId.N	String	Não	lt-m5e3ofjr1zn1aw7q****	IDs de um ou mais modelos de inicialização. É possível especificar até 100 IDs. Use LaunchTemplateId.N ou LaunchTemplateName.N para identificar os modelos desejados.
LaunchTemplateName.N	String	Não	wd-152630748****	Nomes de um ou mais modelos de inicialização. O limite é de 100 nomes por solicitação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PageSize	Integer	10	Número de entradas retornadas por página.
RequestId	String	04F0F334-1335-436C-A1D7-6C044FE12CBA	ID da solicitação.
PageNumber	Integer	1	Número da página retornada.
TotalCount	Integer	1	Quantidade total de modelos de inicialização.
LaunchTemplateSets	Array of LaunchTemplateSet		Detalhes dos modelos de inicialização.
LaunchTemplateSet
LaunchTemplateName	String	wd-152630748****	Nome do modelo de inicialização.
DefaultVersionNumber	Long	1	Número da versão padrão do modelo de inicialização.
ModifiedTime	String	2018-05-14T14:18:00Z	Data e hora da última modificação do modelo de inicialização.
LaunchTemplateId	String	lt-m5e3ofjr1zn1aw7q****	ID do modelo de inicialização.
CreateTime	String	2018-05-14T14:18:00Z	Data e hora de criação do modelo de inicialização.
ResourceGroupId	String	rg-acfmxazb4p****	ID do grupo de recursos ao qual o modelo pertence.
CreatedBy	String	1234567890	Criador do modelo de inicialização.
LatestVersionNumber	Long	1	Número da versão mais recente do modelo de inicialização.
Tags	Array of Tag		Tags associadas ao modelo de inicialização.
Tag
TagValue	String	TestValue	Valor da tag do modelo de inicialização.
TagKey	String	TestKey	Chave da tag do modelo de inicialização.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DescribeLaunchTemplates
&RegionId=cn-hangzhou
&TemplateTag.1.Key=TestKey
&TemplateTag.1.Value=TestValue
&LaunchTemplateId.1=lt-m5e3ofjr1zn1aw7q****
&LaunchTemplateName.1=wd-152630748****
&PageNumber=1
&PageSize=10
&TemplateResourceGroupId=rg-acfmxazb4p****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeLaunchTemplatesResponse>
	<RequestId>04F0F334-1335-436C-A1D7-6C044FE12CBA</RequestId>
	<TotalCount>1</TotalCount>
	<PageNumber>1</PageNumber>
	<PageSize>10</PageSize>
	<LaunchTemplateSets>
		<LaunchTemplateSet>
			<CreateTime>2018-05-14T14:18:00Z</CreateTime>
			<ModifiedTime>2018-05-14T14:18:00Z</ModifiedTime>
			<LaunchTemplateid>lt-m5e3ofjr1zn1aw7****</LaunchTemplateid>
			<LaunchTemplateName>wd-152630748****</LaunchTemplateName>
			<DefaultVersionNumber>1</DefaultVersionNumber>
			<LatestVersionNumber>1</LatestVersionNumber>
			<CreatedBy>194211134971****</CreatedBy>
		</LaunchTemplateSet>
	</LaunchTemplateSets>
</DescribeLaunchTemplatesResponse>

Formato JSON

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

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE12CBA",
  "TotalCount" : 1,
  "PageNumber" : 1,
  "PageSize" : 10,
  "LaunchTemplateSets" : {
    "LaunchTemplateSet" : [ {
      "LaunchTemplateName" : "wd-152630748****",
      "CreatedBy" : "194211134971****",
      "ModifiedTime" : "2018-05-14T14:18:00Z",
      "LatestVersionNumber" : 1,
      "CreateTime" : "2018-05-14T14:18:00Z",
      "LaunchTemplateId" : "lt-m5e3ofjr1zn1aw7q****",
      "DefaultVersionNumber" : 1
    } ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidRegion.NotExist	%s	Mensagem retornada porque o parâmetro RegionId especificado não existe.
400	MissingParameter	%s	Mensagem retornada devido à ausência de um parâmetro obrigatório.
400	InvalidParameter	%s	Mensagem retornada porque um parâmetro especificado é inválido.
403	InnerServiceFailed	%s	Mensagem retornada quando não é possível chamar um serviço interno.

Para obter uma lista de códigos de erro, visite o Error Center.