修改策略
更新时间 2025-06-11 14:55:30
最近更新时间: 2025-06-11 14:55:30
接口介绍
修改策略，若该策略已被绑定到角色下，该角色下的该策略也会被修改
接口约束
支持的线上资源池 ：合肥2、西安5
URI
POST /v4/oss/put-policy
请求参数
请求体 JSON Body 参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| regionID | 是 | String | 区域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| policyName | 是 | String | 角色名 | policy2 |
| policyDocument | 是 | String | 角色承接策略 | 见请求示例 |
表 policyDocument
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Version | 是 | String | 当前支持"2012-10-17" | 2012-10-17 | |
| Statement | 是 | String | 桶策略描述，定义完整的权限控制。每条桶策略的Statement可由多条描述组成，每条描述是一个dict，每条描述可包含以下字段： Sid Effect Action ReSource Condition | Statement |
表 Statement
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Sid | 否 | String | 本条桶策略描述的ID | S3PolicyId1 | |
| Effect | 是 | String | 桶策略的效果，即指定本条桶策略描述的权限是接受请求还是拒绝请求。 接受请求：配置为"Allow"， 拒绝请求：配置为"Deny" | Deny | |
| Action | 是 | String | 操作，即指定本条桶策略描述所作用的oss操作。以列表形式表示，可配置多条操作，以逗号间隔。支持通配符"*"，表示该资源能进行的所有操作。常用的Action有"s3:GetObject"，"s3:PutObject"，"s3:*"等。根据需要本参数也可使用Array of Strings类型 | s3:* | |
| Condition | 否 | String | 条件语句，指定本条桶策略所限制的条件。可以通过Condition对oss资源各种策略 | 见响应示例 | |
| Resource | 是 | String | 此条策略所作用的资源，如桶、对象等。根据需要本参数也可使用Array of Strings类型 | 见响应示例 |
响应参数
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| statusCode | Long | 返回状态码(800为成功，900为处理中/失败) | 800 |
| message | String | 状态描述 | SUCCESS |
| description | String | 状态描述，一般为中文 | 成功 |
| errorCode | String | 业务细分码（仅失败时具有此参数），为product.module.code三段式码 | openapi.userPermission.accessFailed |
| error | String | 业务细分码（大驼峰形式，仅失败时具有此参数），为 Product.Module.Code 三段式码 | Openapi.UserPermission.AccessFailed |
请求示例
{
"regionID": "332232eb-63aa-465e-9028-52e5123866f0",
"policyName": "policy1",
"policyDocument": "{\"Version\": \"2012-10-17\", \"Statement\": {\"Action\": [\"s3:GetObject\"], \"Resource\": \"arn:aws:s3:::bucket-sts/*\", \"Effect\": \"Allow\"}}"
}
响应示例
{
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
| 状态码 | 描述 |
|---|---|
| 800 | 表示请求成功。 |
| 900 | 表示请求失败。 |
错误码
errorCode 枚举值，见错误码总表
