接口介绍
查看存储空间（Bucket）的防盗链（Referer）相关配置。
接口约束
无
请求URI
GET /v1/resourceObject/bucket/Referer
路径参数
无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionCode | 是 | String | 区域编码 | 0001 | |
| bucketName | 是 | String | 桶名 | bucket1 |
注： 如果query中的参数为固定参数，可以传参数名或传空。
请求参数
请求头header参数
无
请求体body参数
无
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Integer | 本次请求的结果码 | 0 | |
| error | 是 | String | 错误码，创建成功时，不返回该字段 | ||
| message | 是 | String | 错误文本信息，创建成功时，为空字符串 | ||
| returnObj | 是 | String of Object | 返回结果 | returnObj |
表 returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| code | 是 | String | 业务返回码，0表示业务成功 | 0 | |
| content | 是 | Array of Objects | 业务返回数据 | data | |
| message | 是 | String | 业务消息 |
表 data
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Condition | 是 | Object | 域名匹配条件 | StringNotLike | |
| Action | 是 | String | s3协议操作 | s3:GetObject | |
| Resource | 是 | String | s3资源对象 | arn:aws:s3:::test-0914/* | |
| Effect | 是 | String | 是否生效 | Deny | |
| Principal | 是 | String | 策略 | * | |
| Sid | 是 | String | 规则id | Referer#e212d215-dfa0-4ff1-8bd1-6d452d8f9449 |
表 StringNotLike
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| StringNotLike | 是 | Array of Objects | 限制或允许的域名组 | aws:Referer |
表 aws:Referer
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| aws:Referer | 是 | Array of Strings | 相关域名组 |
请求示例
GET /v1/resourceObject/bucket/Referer?regionCode=0001&bucketName=test
请求头header
无
请求体body
无
响应示例
{
"statusCode": "0",
"message": "",
"returnObj": {
"code": "0",
"message": "",
"content": [{
"Condition": {
"StringNotLike": [{
"aws:Referer": ["https://example1.ctyun.cn*"]
}, {
"aws:Referer": ["https://example2.ctyun.cn*"]
}, {
"aws:Referer": ["https://example3.ctyun.cn*"]
}]
},
"Action": "s3:GetObject",
"Resource": "arn:aws:s3:::bbb/*",
"Effect": "Deny",
"Principal": "*",
"Sid": "Referer#e212d215-dfa0-4ff1-8bd1-6d452d8f9449"
}]
}
}
状态码
| 状态码 | 描述 |
|---|---|
| 0 | 表示业务成功 |
| 400 | 请求参数有误 |
| 403 | 用户鉴权失败，用户无操作权限 |
| 404 | 请求的资源不存在，输入错误的URL |
| 500 | 业务执行异常 |
