全部产品
Search

搜索本产品

    ：ListTagResources - 查询应用和标签的对应关系

    文档中心

    ：ListTagResources - 查询应用和标签的对应关系

    更新时间：Nov 01, 2024

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

    调试

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

    授权信息

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

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

    请求语法

    GET /tags HTTP/1.1

    请求参数

    名称类型必填描述示例值
    RegionIdstring是

    地域 ID。

    		cn-beijing
    ResourceTypestring是

    资源类型，仅支持application。

    		application
    NextTokenstring否

    一次查询最多返回 50 条结果，当结果超过 50 条时，会同时返回一个 NextToken，下一次查询使用该 NextToken 即可查询前 50 条结果之外的结果。

    		A2RN
    ResourceIdsstring否

    资源 ID。可填写多个资源 ID，用英文逗号（,）分隔。当您未输入 Tags 参数时必填。

    		["d42921c4-5433-4abd-8075-0e536f8b****"]
    Tagsstring否

    标签键值对，当您未输入 ResourceIds 参数时必填。取值说明如下：

    • key：标签键，字符长度范围[1,128]。
    • value：标签值，字符长度范围[1,128]。

    区分大小写。如果指定多个标签，则会为指定资源同时创建并绑定多个标签。同一个资源上的同一个标签键只能对应一个标签值。如果您尝试添加已有标签键，则对应的标签值会更新为新值。

    不能以aliyun和acs:开头，不能包含http://或者https://。

    		[{"key":"k1","value":"v1"}]

    返回参数

    名称类型描述示例值
    object

    返回数据。

    RequestIdstring

    请求 ID。

    		7414187F-4F59-4585-9BCF-5F0804E4****
    Messagestring

    附加信息。取值说明如下：

    • 请求正常，返回 success。
    • 请求异常，返回具体异常错误码。
    		success
    TraceIdstring

    调用链 ID，可用于精确查询调用信息。

    		0bc5f84e15916043198032146d****
    Dataobject

    返回数据。

    NextTokenstring

    一次查询最多返回 50 条结果，当结果超过 50 条时，会同时返回一个 NextToken，下一次查询使用该 NextToken 即可查询前 50 条结果之外的结果。

    		""
    TagResourcesarray<object>

    应用和标签的对应关系。

    TagResourceobject

    返回数据。

    ResourceTypestring

    资源类型，仅支持application。

    		ALIYUN::SAE::APPLICATION
    TagValuestring

    标签值。

    		v1
    ResourceIdstring

    应用 ID。

    		d42921c4-5433-4abd-8075-0e536f8b****
    TagKeystring

    标签键。

    		k1
    ErrorCodestring

    错误码。取值说明如下：

    • 请求成功：不返回 ErrorCode 字段。
    • 请求失败：返回 ErrorCode 字段。具体信息，请参见本文的错误码列表。
    		空
    Codestring

    接口状态或 POP 错误码。取值说明如下：

    • 2xx：成功。
    • 3xx：重定向。
    • 4xx：请求错误。
    • 5xx：服务器错误。
    		200
    Successboolean

    查询应用和标签的对应关系是否成功。取值说明如下：

    • 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错误码错误信息描述
    400InvalidParameter.ObviouslyThe specified parameter is invalid {%s}.不合法的参数{%s}。
    400InvalidResourceType.NotFoundThe specified resource type is not supported.不支持指定的资源类型。
    400NumberExceed.TagsThe specified parameter Tags count exceed.单个资源最大Tag数超限，最大20个标签。
    400Invalid.Param.Tag.ScopeThe specified parameter is invalid: tag scope.scope参数有误。
    400No.PermissionThe account has no permission.该账号没有操作权限。
    400NumberExceed.ResourceIdsThe number of resource IDs cannot exceed 50.资源ID个数不能超过50。

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史