本接口用于无影应用中心通知ISV取消用户的软件授权,即回收用户已有的软件License。
接口说明
无影应用中心的用户分为便捷用户和AD用户,取消授权时,至少需要提供其中一种类型的用户列表,即edsSimpleUserList和edsAdUserList中,至少配置一个。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
action | String | 是 | CREATE_ORDER | 请求操作类型。取值:LICENSE_DELETE_USERS。 |
orderId | Long | 是 | 1234512345 | 订单ID。 |
buyerId | Long | 是 | 123451234512345 | 买家ID。 |
hashBuyerId | String | 是 | abc123abc123abc123 | 买家ID经过Hash算法转换后生成的值。 |
edsUserType | String | 是 | SIMPLE | 用户类型。取值范围:
|
edsSimpleUserList | String | 否 | [{ "userId": "1234", "userName": "alice", "userEmail": "a***@example.net"}] | 要取消授权的便捷用户列表。包含以下参数:
|
edsAdUserList | String | 否 | [{ "userName": "alice", "workspaceName": "cn-hangzhou+dir-5628123***"}] | 要取消授权的AD用户列表。包含以下参数:
|
请求示例如下:
{
"action": "LICENSE_ADD_USERS",
"orderId": 1234512345,
"buyerId": 123451234512345,
"hashBuyerId": "abc123abc123abc123",
"edsUserType": "SIMPLE",
"edsSimpleUserList": [{ "userId": "1234", "userName": "alice", "userEmail": "a***@example.net"}],
"edsAdUserList": [{ "userName": "alice", "workspaceName": "cn-hangzhou+dir-5628123***"}]
}
返回数据
名称 | 类型 | 示例值 | 描述 |
success | Boolean | true | 是否成功取消授权。可能值:
|
edsSimpleUserList | String | [{ "userId": "1234", "userName": "alice", "userEmail": "a***@example.net"}] | 如果取消授权成功,则返回所有已授权的便捷用户列表。包含以下参数:
|
edsAdUserList | String | [{ "userName": "alice", "workspaceName": "cn-hangzhou+dir-5628123***"}] | 如果取消授权成功,则返回所有已授权的AD用户列表。包含以下参数:
|
errorMessage | String | error msg | 如果取消授权失败,则返回具体的错误信息。 |
errorCode | String | XXXX_YYYY | 如果取消授权失败,则返回具体的错误码。 |
返回示例如下:
取消授权成功
{ "success": true, "edsSimpleUserList": [{ "userId": "1234", "userName": "alice", "userEmail": "a***@example.net"}], "edsAdUserList": [{ "userName": "alice", "workspaceName": "cn-hangzhou+dir-5628123***"}], "errorMessage": null, "errorCode": null }
取消授权失败
{ "success": false, "edsSimpleUserList": [], "edsAdUserList": [], "errorMessage": "error msg", "errorCode": "XXXX_YYYY" }