禁用子账号
描述
用户登录父账号后,通过本接口禁用指定子账号,仅限于父账号使用。
请求
请求语法
POST /v1/user/disable-child HTTP/1.1
Host: api.qiniu.com
Content-Type: application/x-www-form-urlencoded
Authorization: Qiniu <管理凭证>
<UserDisableChildRequestParams>
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
Host | 是 | 固定为 api.qiniu.com ,必须以 HTTPS 方式 访问。 |
Content-Type | 是 | 固定为 application/x-www-form-urlencoded 。 |
Authorization | 是 | 账号管理凭证,该参数应严格按照账号管理凭证格式进行填充,否则会返回 401 错误码。 文档地址 |
请求参数
请求参数以表单形式组织,作为请求内容提交,格式如下:
uid=<uid>&reason=<UrlEncodedReason>
参数名称 | 必填 | 说明 |
---|---|---|
uid | 是 | 禁用对象子账号的数字 UUID。 |
reason | 是 | 禁用理由,注意七牛服务器仅保存最后一次禁用的理由。 |
响应
响应语法
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
<UserDisableChildResponseContent>
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
Content-Type | 是 | 正常情况下该值将被设为 application/json; charset=UTF-8 ,表示返回 JSON 格式的文本信息。 |
响应内容
■ 如果请求成功,返回包含如下内容的 JSON 字符串(已格式化,便于阅读):
{
"code": 200,
"message": ""
}
字段名称 | 必填 | 说明 |
---|---|---|
code | 是 | 状态码。 |
message | 是 | 信息说明。 |
■ 如果请求失败,返回包含如下内容的 JSON 字符串(已格式化,便于阅读):
{
"code": <ErrCode int>,
"message": "<ErrMsg string>"
}
HTTP 状态码 | code | message | description |
---|---|---|---|
200 | 200 | 成功。 | |
200 | 400 | invalid args | 请求参数错误,或者数据未通过验证。 |
200 | 500 | response result error | 请求结果发生错误。 如遇此错误,请将完整错误信息(包括所有 HTTP 响应头部)通过邮件发送 给我们。 |
200 | 10905 | user not exist | 请求被禁用的账号不存在。 |
200 | 11308 | user already disabled | 请求被禁用的账号已经禁用。 |
200 | 11314 | not your child | 请求被禁用的账号不是当前父账号的子账号。 |
文档反馈
(如有产品使用问题,请 提交工单)