使用ListTagResources查询应用和标签的对应关系-Serverless应用引擎-阿里云-Serverless 应用引擎(SAE)-阿里云帮助中心

调用ListTagResources接口查询应用和标签的对应关系。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

sae:ListTagResources

get

*全部资源

*

无

请求语法

GET /tags HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	地域 ID。	cn-beijing
ResourceType	string	是	资源类型，仅支持`application`。	application
NextToken	string	否	一次查询最多返回 50 条结果，当结果超过 50 条时，会同时返回一个 NextToken，下一次查询使用该 NextToken 即可查询前 50 条结果之外的结果。	A2RN
ResourceIds	string	否	资源 ID。可填写多个资源 ID，用英文逗号（,）分隔。当您未输入 Tags 参数时必填。	["d42921c4-5433-4abd-8075-0e536f8b****"]
Tags	string	否	标签键值对，当您未输入 ResourceIds 参数时必填。取值说明如下： key：标签键，字符长度范围[1,128]。 value：标签值，字符长度范围[1,128]。区分大小写。如果指定多个标签，则会为指定资源同时创建并绑定多个标签。同一个资源上的同一个标签键只能对应一个标签值。如果您尝试添加已有标签键，则对应的标签值会更新为新值。不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。	[{"key":"k1","value":"v1"}]

返回参数

名称	类型	描述	示例值
	object	返回数据。
RequestId	string	请求 ID。	7414187F-4F59-4585-9BCF-5F0804E4****
Message	string	附加信息。取值说明如下：请求正常，返回 success。请求异常，返回具体异常错误码。	success
TraceId	string	调用链 ID，可用于精确查询调用信息。	0bc5f84e15916043198032146d****
Data	object	返回数据。
NextToken	string	一次查询最多返回 50 条结果，当结果超过 50 条时，会同时返回一个 NextToken，下一次查询使用该 NextToken 即可查询前 50 条结果之外的结果。	""
TagResources	array<object>	应用和标签的对应关系。
	object	返回数据。
ResourceType	string	资源类型，仅支持`application`。	ALIYUN::SAE::APPLICATION
TagValue	string	标签值。	v1
ResourceId	string	应用 ID。	d42921c4-5433-4abd-8075-0e536f8b****
TagKey	string	标签键。	k1
ErrorCode	string	错误码。取值说明如下：请求成功：不返回 ErrorCode 字段。请求失败：返回 ErrorCode 字段。具体信息，请参见本文的错误码列表。
Code	string	接口状态或 POP 错误码。取值说明如下： 2xx：成功。 3xx：重定向。 4xx：请求错误。 5xx：服务器错误。	200
Success	boolean	查询应用和标签的对应关系是否成功。取值说明如下： true：查询成功。 false：查询失败。	true

示例

正常返回示例

JSON格式

{
  "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
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter.Obviously	The specified parameter is invalid {%s}.	不合法的参数{%s}。
400	InvalidResourceType.NotFound	The specified resource type is not supported.	不支持指定的资源类型。
400	NumberExceed.Tags	The specified parameter Tags count exceed.	单个资源最大Tag数超限，最大20个标签。
400	Invalid.Param.Tag.Scope	The specified parameter is invalid: tag scope.	scope参数有误。
400	No.Permission	The account has no permission.	该账号没有操作权限。
400	NumberExceed.ResourceIds	The number of resource IDs cannot exceed 50.	资源ID个数不能超过50。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。