更新授权模式
功能介绍
更新授权模式接口用于修改指定资源或功能的授权方式和权限配置信息。该接口适用于以下场景:当系统管理员需要调整资源的访问权限、开发者需要更新授权策略以适应新的业务需求,或安全审计人员需要修改授权配置以符合新的安全规范时,可通过此接口更新授权模式的详细信息。使用该接口的前提条件是用户具有更新权限且目标资源或功能的授权模式已存在。调用成功后,接口将更新目标资源的授权模式,并返回更新后的授权模式信息。若用户无权限访问该接口,或目标资源的授权模式不存在,接口将返回相应的错误信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
PUT /v1/auth-mode
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值,获取方式请参见获取token。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
mode |
是 |
String |
参数解释:更新的模式类型。 取值范围:
|
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
domain_id |
String |
参数解释:账号domainId。 取值范围:不涉及。 |
|
mode |
String |
参数解释:授权模式。 取值范围:
|
请求示例
更新为严格模式
POST https://{endpoint}/v1/auth-mode
{
"mode" : "strict"
}
响应示例
状态码:200
查询授权模式响应体
{
"domain_id" : "06024304b180d5090fbac00141b6cae0",
"mode" : "strict"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询授权模式响应体 |
错误码
请参见错误码。