文档

DeleteTraceApp - 删除指定ID和类型的应用

更新时间:

删除指定ID或类型的应用。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
arms:DeleteTraceApp
  • TraceApp
    acs:arms:{#regionId}:{#AccountId}:traceapp/{#Pid}

请求参数

名称类型必填描述示例值
AppIdstring

需要删除的应用的 ID,可调用 SearchTraceAppByName 接口获取。

5406**
RegionIdstring

地域 ID。

cn-hangzhou
Typestring

需要删除的应用的类型,可调用 SearchTraceAppByName 接口获取,更多信息,请参见 SearchTraceAppByName。包括以下类型:

  • TRACE:应用监控
  • RETCODE:前端监控
TRACE
Pidstring

应用 ID。

在 ARMS 控制台的应用监控>应用列表页面单击目标应用名称。此时浏览器地址栏中的 URL 即包含应用的 pid,格式为 pid=xxx。由于浏览器进行了编码,因此需要对 pid 稍作修改。例如,如果 URL 中包含的 pid 为 xxx%4074xxx,则需要将%40 替换为@,即:xxx@74xxx。

9w0sc5gxxz@edcsd447c2f****
DeleteReasonobject

删除原因。

Remarkstring

其他删除原因的备注信息。

业务场景覆盖不全
ReasonIdsarray<object>

删除原因 ID。

object
Idinteger

删除理由的 ID。

0
Namestring

删除理由描述。

删除理由描述,ID和Name的对应关系: "id":0,"name":"功能不完善,无法定位到问题根本原因。" "id":1,"name":"Agent不稳定,影响应用运行。" "id":2,"name":"服务不稳定,经常打不开界面。" "id":3,"name":"报警相关问题。" "id":4,"name":"价格太贵" "id":5,"name":"其他原因"

返回参数

名称类型描述示例值
object
Datastring

JSON 格式的返回结果,包含 HTTP 状态码、错误码、返回消息、TraceId 等。

{\"code\":200,\"data\":\"{\\\"code\\\":200,\\\"data\\\":true,\\\"errorCode\\\":\\\"删除应用成功\\\",\\\"message\\\":\\\"删除应用成功\\\",\\\"success\\\":true,\\\"traceId\\\":\\\"0bc0594d15954826692915817e****\\\"}\",\"errorCode\":\"删除应用成功\",\"message\":\"删除应用成功\",\"success\":true,\"traceId\":\"0ab2646915954826692568137d****\"}
RequestIdstring

请求 ID。

46355DD8-FC56-40C5-BFC6-269DE4F9****
Messagestring

返回结果的提示信息。

message
Codelong

接口状态码:2XX:成功 3XX:重定向 4XX:请求错误 5XX:服务器错误

200
Successboolean

操作是否成功:

  • true:操作成功
  • false:操作失败
true

示例

正常返回示例

JSON格式

{
  "Data": "{\\\"code\\\":200,\\\"data\\\":\\\"{\\\\\\\"code\\\\\\\":200,\\\\\\\"data\\\\\\\":true,\\\\\\\"errorCode\\\\\\\":\\\\\\\"删除应用成功\\\\\\\",\\\\\\\"message\\\\\\\":\\\\\\\"删除应用成功\\\\\\\",\\\\\\\"success\\\\\\\":true,\\\\\\\"traceId\\\\\\\":\\\\\\\"0bc0594d15954826692915817e****\\\\\\\"}\\\",\\\"errorCode\\\":\\\"删除应用成功\\\",\\\"message\\\":\\\"删除应用成功\\\",\\\"success\\\":true,\\\"traceId\\\":\\\"0ab2646915954826692568137d****\\\"}",
  "RequestId": "46355DD8-FC56-40C5-BFC6-269DE4F9****",
  "Message": "message",
  "Code": 200,
  "Success": true
}

错误码

HTTP status code错误码错误信息描述
403IllegalUserAccessIllegal user access.非法的用户访问
406AgentNotUninstalledagent not uninstalled.应用挂载的探针未正常卸载掉
500InternalErrorInternal error. Please try again. Contact the DingTalk service account if the issue persists after multiple retries.内部错误,建议重试。如果多次重试报错请联系钉钉服务账号。

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

变更历史

变更时间变更内容概要操作
2024-05-28OpenAPI 错误码发生变更查看变更详情
2023-08-03OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情