文档首页/ 数据管理服务 DAS/ API参考/ API（公测中）/ 开发工具/ 取消共享链接 - ConsoleCancelShare
更新时间：2025-11-28 GMT+08:00
查看PDF
分享

取消共享链接 - ConsoleCancelShare

功能介绍

取消共享连接。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    das:connection:cancelShareConnections

    write

    connection

    -

    -

    -

URI

POST /v3.1/{project_id}/connections/cancel-share

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

shared_conn_id

是

String

参数解释：

共享连接ID。用户使用数据库账号与数据库建立的连接ID（数据库用户ID由创建实例连接接口创建）。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字、中划线组成，且长度为36个字符的UUID。

默认取值：

不涉及。

users

否

Array of ShareConnUserInfo objects

参数解释：

用户。

约束限制：

可组合，用逗号分隔。

取值范围：

不涉及。

默认取值：

不涉及。
表3 ShareConnUserInfo

参数

是否必选

参数类型

描述

user_id

是

String

参数解释：

用户ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

user_name

否

String

参数解释：

用户名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

status

Boolean

参数解释：

状态。

取值范围：

  • true：成功
  • false：失败

请求示例

POST https://das.cn-north-1.myhuaweicloud.com/v3.1/054e292c9880d4992f02c0196d3ea468/connections/cancel-share
{ 
  "shared_conn_id": "ee64e597-4f25-486f-bba1-0c850b3b59d6", 
  "users": [ 
    { 
      "user_id": "0852a89ae180d5401f5ac00271a4a02e", 
      "user_name": "username" 
    } 
  ] 
}

响应示例

状态码： 200

Success.

{
 "status" : true
}

状态码

状态码

描述

200

Success.

400

Client error.

500

Server error.

错误码

请参见错误码。

父主题： 开发工具

相关文档