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

Chama a operação DescribeLaunchTemplates. Você pode especificar parâmetros como TemplateTag, TemplateResourceGroupId e LaunchTemplateId para consultar informações sobre um ou mais modelos de execução, incluindo o número total de modelos de execução, hora de criação do modelo e número da versão mais recente.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:DescribeLaunchTemplates

get

LaunchTemplate

acs:ecs:{#regionId}:{#accountId}:launchtemplate/*

LaunchTemplate

acs:ecs:{#regionId}:{#accountId}:launchtemplate/{#launchtemplateId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
TemplateTag	array<object>	Não	A lista de pares chave-valor de tag do modelo de execução. Nota Atualmente, você pode criar e consultar tags de modelos de execução apenas chamando operações de API. O console não oferece suporte à criação ou visualização de tags de modelos de execução.
	object	Não	As informações do par chave-valor de tag do modelo de execução.
Key	string	Não	A chave de tag do modelo de execução. Valores válidos de N: 1 a 20. Se você usar uma única tag para filtrar recursos, o número de recursos com a tag especificada não pode exceder 1000. Se você usar várias tags para filtrar recursos, o número de recursos vinculados a todas as tags especificadas não pode exceder 1000. Se o número de recursos exceder 1000, chame a operação ListTagResources para consultá-los.	TestKey
Value	string	Não	O valor de tag do modelo de execução. Valores válidos de N: 1 a 20.	TestValue
PageNumber	integer	Não	O número da página da lista de modelos de execução. Valor mínimo: 1. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página para uma consulta paginada. Valor padrão: 10.	10
TemplateResourceGroupId	string	Não	O ID do grupo de recursos ao qual o modelo de execução pertence. Quando você usa este parâmetro para filtrar recursos, o número de recursos não pode exceder 1000. Nota Não há suporte para filtragem pelo grupo de recursos padrão.	rg-acfmxazb4p****
LaunchTemplateId	array	Não	Um array de um ou mais IDs de modelos de execução. Você pode consultar até 100 modelos de execução por vez. Você deve especificar LaunchTemplateId ou LaunchTemplateName para determinar os modelos.	lt-m5e3ofjr1zn1aw7q****
	string	Não	O ID do modelo de execução. Você pode consultar até 100 modelos de execução por vez. Você deve especificar LaunchTemplateId ou LaunchTemplateName para determinar os modelos.	lt-m5e3ofjr1zn1aw7q****
LaunchTemplateName	array	Não	Um array de um ou mais nomes de modelos de execução. Você pode consultar até 100 modelos de execução por vez. Você deve especificar LaunchTemplateId ou LaunchTemplateName para determinar os modelos.	wd-152630748****
	string	Não	O nome do modelo de execução. Você pode consultar até 100 modelos de execução por vez. Você deve especificar LaunchTemplateId ou LaunchTemplateName para determinar os modelos.	wd-152630748****

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PageSize	integer	O número de entradas por página.	10
RequestId	string	O ID da solicitação.	04F0F334-1335-436C-A1D7-6C044FE12CBA
PageNumber	integer	O número da página atual.	1
TotalCount	integer	O número total de modelos de execução.	1
LaunchTemplateSets	object
LaunchTemplateSet	array<object>	A lista de informações dos modelos de execução.
	array<object>	As informações do modelo de execução.
LaunchTemplateName	string	The template name.	wd-152630748****
DefaultVersionNumber	integer	The default version number of the template.	1
ModifiedTime	string	The time when a version of the template was created or deleted. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.	2018-05-14T14:18:00Z
LaunchTemplateId	string	The template ID.	lt-m5e3ofjr1zn1aw7q****
CreateTime	string	The time when the launch template was created. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.	2018-05-14T14:18:00Z
ResourceGroupId	string	The ID of the resource group to which the launch template belongs.	rg-acfmxazb4p****
CreatedBy	string	The creator of the template, which is the Alibaba Cloud account ID.	20169351435666****
LatestVersionNumber	integer	The latest version number of the template.	1
Tags	object
Tag	array<object>	The list of tag key-value pairs of the launch template. Nota Currently, you can create and query launch template tags only by calling API operations. The console does not support creating or viewing launch template tags.
	object	The tag key-value pair information of the launch template.
TagValue	string	The tag value of the launch template.	TestValue
TagKey	string	The tag key of the launch template.	TestKey

Exemplos

Resposta de sucesso

JSON formato

{
  "PageSize": 10,
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE12CBA",
  "PageNumber": 1,
  "TotalCount": 1,
  "LaunchTemplateSets": {
    "LaunchTemplateSet": [
      {
        "LaunchTemplateName": "wd-152630748****",
        "DefaultVersionNumber": 1,
        "ModifiedTime": "2018-05-14T14:18:00Z",
        "LaunchTemplateId": "lt-m5e3ofjr1zn1aw7q****",
        "CreateTime": "2018-05-14T14:18:00Z",
        "ResourceGroupId": "rg-acfmxazb4p****",
        "CreatedBy": "20169351435666****",
        "LatestVersionNumber": 1,
        "Tags": {
          "Tag": [
            {
              "TagValue": "TestValue",
              "TagKey": "TestKey"
            }
          ]
        }
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidRegion.NotExist	%s	The specified region does not exist.
400	MissingParameter	%s	A parameter is not specified.
400	InvalidParameter	%s	The specified parameter is invalid.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error has occurred. Try again later.
403	InnerServiceFailed	%s	An internal service cannot be called.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.