StopAppResources - 关闭应用资源

前置条件

调用本接口前，需先完成用户登录认证，取得 LoginToken 和 SessionId。本接口 StopAppResources 使用 appstream-center 的 2021-09-03 版本；前置登录接口使用 2021-02-20 版本的 GetLoginToken 。请分别使用各自的 API 版本。

1. 准备企业标识符与账号信息

以下流程适用于使用企业标识符登录的便捷账号或 AD 域账号账密认证。

2. 按返回的认证阶段继续登录

首次调用 GetLoginToken 后，保存返回的 SessionId。该值仅在同一登录会话第一次调用时返回；需要继续认证时，后续请求携带已保存的 SessionId，不要因后续响应未返回该字段而将其清空。

根据响应中的 NextStage 判断是否还需认证，并将要求的下一认证阶段作为后续请求的 CurrentStage。例如：

认证阶段由账号配置及本次登录结果决定，并非每次登录都必须依次经过上述所有阶段。仅在登录认证完成并取得 LoginToken 后调用 StopAppResources；认证失败或尚有待完成的认证阶段时，不继续关闭资源。

3. 调用序列示例

以下为参数传递伪代码，不是可直接执行的 SDK 示例。clientId、tenantAlias、endUserId、password 和 authenticationCode 均为调用方运行时变量；resourceIds、productType、appInstanceGroupId 为本次操作的业务参数。请勿在示例或日志中写入真实密码、验证码或登录凭证。

login1 = GetLoginToken(version="2021-02-20",
    ClientId=clientId, LoginIdentifier=tenantAlias,
    CurrentStage="ADPassword", EndUserId=endUserId, Password=password)
sessionId = login1.SessionId
loginResult = login1

if loginResult.NextStage == "MFAVerify":
    loginResult = GetLoginToken(version="2021-02-20",
        ClientId=clientId, LoginIdentifier=tenantAlias,
        SessionId=sessionId, CurrentStage="MFAVerify",
        AuthenticationCode=authenticationCode)

如仍要求其他认证阶段，继续按 NextStage 处理；不要把上述一次 MFA 调用视为固定终点。登录完成后，使用本次登录取得的 LoginToken 和已保存的 SessionId 调用本接口：

StopAppResources(version="2021-09-03",
    ClientId=clientId, LoginToken=loginResult.LoginToken, SessionId=sessionId,
    ProductType=productType, AppInstanceGroupId=appInstanceGroupId,
    ResourceIds=resourceIds)

Password、LoginIdentifier 和 CurrentStage 属于前置登录请求，不是 StopAppResources 的请求参数。本接口其他参数及资源 ID 的填写规则见下方请求参数表。