ListTagResources - Serverless App Engine: Central de Documentação do Alibaba Cloud

Chama a API ListTagResources para listar as tags associadas às suas aplicações.

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

sae:ListTagResources

get

*All Resource

*

Nenhuma

Sintaxe da solicitação

GET /tags HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região.	cn-beijing
ResourceType	string	Sim	O tipo de recurso. Somente `application` é suportado.	application
NextToken	string	Não	Uma consulta pode retornar no máximo 50 resultados. Se o número de resultados exceder esse limite, a resposta incluirá um NextToken. Para recuperar a próxima página de resultados, passe esse token na sua próxima solicitação.	A2RN
ResourceIds	string	Não	Os IDs dos recursos, especificados como um array JSON de strings. Este parâmetro é obrigatório se o parâmetro Tags não for especificado.	["d42921c4-5433-4abd-8075-0e536f8b****"]
Tags	string	Não	As tags usadas para filtrar recursos. Este parâmetro é obrigatório se o parâmetro ResourceIds não for especificado. Uma tag é um par chave-valor. key: A chave da tag. A chave pode ter de 1 a 128 caracteres de comprimento. value: O valor da tag. O valor pode ter de 1 a 128 caracteres de comprimento. As chaves e os valores das tags diferenciam maiúsculas de minúsculas. Se você especificar várias tags, a operação retornará apenas os recursos que possuem todas as tags especificadas. Uma chave de tag não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.	[{"key":"k1","value":"v1"}]

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados retornados.
RequestId	string	O ID da solicitação.	7414187F-4F59-4585-9BCF-5F0804E4****
Message	string	A mensagem retornada para a solicitação. Se a solicitação for bem-sucedida, success será retornado. Se a solicitação falhar, uma mensagem de erro será retornada.	success
TraceId	string	O ID de rastreamento usado para consultar os detalhes de uma solicitação.	0bc5f84e15916043198032146d****
Data	object	Os dados retornados.
NextToken	string	O token usado para recuperar a próxima página de resultados. Uma consulta retorna no máximo 50 resultados. Se os resultados forem truncados, você pode usar esse token em uma solicitação subsequente para recuperar a próxima página de resultados.	""
TagResources	array<object>	A lista de tags e seus recursos associados.
	object	Os detalhes de uma tag e o recurso ao qual a tag é adicionada.
ResourceType	string	The type of the resource. The value is fixed as `application`.	ALIYUN::SAE::APPLICATION
TagValue	string	The value of the tag.	v1
ResourceId	string	The ID of the application.	d42921c4-5433-4abd-8075-0e536f8b****
TagKey	string	The key of the tag.	k1
ErrorCode	string	O código de erro. Este parâmetro é retornado apenas se a solicitação falhar. Para mais informações, consulte a seção Códigos de erro deste tópico.
Code	string	O código de status HTTP. 2xx indica que a solicitação foi bem-sucedida. 3xx indica que a solicitação foi redirecionada. 4xx indica que ocorreu um erro no lado do cliente. 5xx indica que ocorreu um erro no lado do servidor.	200
Success	boolean	Indica se a solicitação foi bem-sucedida. Valores válidos: true false	true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "7414187F-4F59-4585-9BCF-5F0804E4****",
  "Message": "success",
  "TraceId": "0bc5f84e15916043198032146d****",
  "Data": {
    "NextToken": "\"\"",
    "TagResources": [
      {
        "ResourceType": "ALIYUN::SAE::APPLICATION",
        "TagValue": "v1",
        "ResourceId": "d42921c4-5433-4abd-8075-0e536f8b****",
        "TagKey": "k1"
      }
    ]
  },
  "ErrorCode": "",
  "Code": "200",
  "Success": true
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro
400	InvalidParameter.Obviously	The specified parameter is invalid {%s}.
400	InvalidResourceType.NotFound	The specified resource type is not supported.
400	NumberExceed.Tags	The specified parameter Tags count exceed.
400	Invalid.Param.Tag.Scope	The specified parameter is invalid: tag scope.
400	No.Permission	The account has no permission.
400	NumberExceed.ResourceIds	The number of resource IDs cannot exceed 50.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.