如果你已创建应用，你可以控制该应用的启用/停用状态。你可以使用 ModifyAppStatus 这个 OpenAPI 实现这一功能。

接口行为

你可以调用 ModifyAppStatus 这个 OpenAPI 修改 AppId 对应 App 的状态，状态分为启用和停用两种。

启用：正常使用状态，为新创建 AppID 的默认状态。
停用：变更后的状态，只表示当前 AppID 功能不可用（参看注释1），但不影响控制台正常显示该 AppID 信息。

1. 当前 AppID 功能不可用：指 RTC 的基础功能和增值功能都不可用，包括用户无法加入房间、后处理的功能无法开启等。

不论当前 AppID 是启用 or 停用状态，都会显示在控制台上。

调用接口

关于调用接口的服务地址、通信协议、字符编码和签名机制，参看调用 OpenAPI。

接口限制

QPS 不得超过 20。

请求方式

使用 POST 方式发起请求。

请求参数

Query

参数名	类型	必填	示例值	描述
Action	String	是	`ModifyAppStatus`	接口名称
Version	String	是	`2020-12-01`	OpenAPI 版本

Body

参数名	类型	必填	示例值	描述
AppId	String	是	`Your_AppId`	需要停用/启用的 AppId
Status	Int	是	`1`	`1`：将 App 状态设置为启用； `2`：将 App 状态设置为停用；

请求示例代码

Query

https://rtc.volcengineapi.com?Action=ModifyAppStatus&Version=2020-12-01
postscript

Body

{
    "AppId": "Your_AppId",
    "Status": "Your_AppStatus"
}
json

返回调用结果

返回值Result仅在请求成功时返回 "success",失败时为空。

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "2021081717484101022524310002120A9F",
        "Action": "ModifyAppStatus",
        "Version": "2020-12-01",
        "Service": "rtc",
        "Region": "cn-north-1"
    },
    "Result": "success"
}
json