主要接口
更新时间:2025-04-03
资源管理API对于每个HTTP请求,认证签名放在Authorization头域中,后端统一认证。且后端在Response头域中会添加x-bce-request-id,作为请求唯一标识,方便追踪定位问题。
目前支持的资源管理API接口如下:
- 创建资源分组
- 资源加入资源分组
- 资源从资源分组移除
- 变更资源绑定的资源分组
- 查询资源分组列表
- 查询资源绑定的资源分组
创建资源分组
使用以下代码可以创建资源分组
Go
1args := &CreateResourceGroupArgs{
2 // 资源组名称
3 Name: "资源组名称",
4 // 资源组的备注
5 Extra: "备注",
6}
7
8result, err := client.CreateResourceGroup(args)
9if err != nil {
10 fmt.Println("CreateResourceGroup failed:", err)
11} else {
12 fmt.Println("CreateResourceGroup success: ", result)
13}
提示:
- 接口详细描述请参考资源管理API文档。
- 资源组的名称,同一用户下不能重复,支持中英文及常见符号-_ /.,1~20个字符,必填。
- 资源组的备注,可以为空。最多存储 256 个字符的文本。
资源加入资源分组
使用以下代码可以将资源加入资源分组
Go
1args := &BindResourceToGroupArgs{
2 ResourceBrief:[]ResourceBrief{
3 {
4 // 资源ID
5 ResourceId:"123.org",
6 // 资源类型
7 ResourceType:"CDN",
8 // 资源区域
9 ResourceRegion: "global",
10 // 资源分组ID
11 GroupId:"group-123",
12 },
13 },
14 }
15
16result, err := client.BindResourceToGroup(args)
17if err != nil {
18 fmt.Println("BindResourceToGroup failed:", err)
19} else {
20 fmt.Println("BindResourceToGroup success: ", result)
21}
提示:
- 接口详细描述请参考资源管理API文档。
资源从资源分组移除
使用以下代码可以将资源从资源分组移除
Go
1args := &BindResourceToGroupArgs{
2 ResourceBrief:[]ResourceBrief{
3 {
4 // 资源ID
5 ResourceId:"123.org",
6 // 资源类型
7 ResourceType:"CDN",
8 // 资源区域
9 ResourceRegion: "global",
10 // 资源分组ID
11 GroupId:"group-123",
12 },
13 },
14 }
15
16result, err := client.RemoveResourceFromGroup(args)
17if err != nil {
18 fmt.Println("RemoveResourceFromGroup failed:", err)
19} else {
20 fmt.Println("RemoveResourceFromGroup success: ")
21}
提示:
- 接口详细描述请参考资源管理API文档。
变更资源绑定的资源分组
使用以下代码变更资源绑定的资源分组
Go
1args := &ChangeResourceGroupArgs{
2 MoveResModels:[]MoveResModels{
3 {
4 // 目标分组
5 TargetGroupId: "group-456",
6 // 原有的绑定关系信息
7 OldGroupResInfo: OldGroupResInfo{
8 // 资源ID
9 ResourceId: "123.org",
10 // 资源类型
11 ResourceType: "CDN",
12 // 资源区域
13 ResourceRegion: "global",
14 // 资源分组ID
15 GroupId: "group-123",
16 },
17 },
18 },
19 }
20
21result, err := client.ChangeResourceGroup(args)
22if err != nil {
23 fmt.Println("ChangeResourceGroup failed:", err)
24} else {
25 fmt.Println("ChangeResourceGroup success: ", result)
26}
提示:
- 接口详细描述请参考资源管理API文档。
查询资源分组列表
使用以下代码可以查询资源分组的列表
Go
1// 资源分组名称
2name := "test"
3
4result, err := client.QueryGroupList(name)
5if err != nil {
6 fmt.Println("QueryGroupList failed:", err)
7} else {
8 fmt.Println("QueryGroupList success: ", result)
9}
提示:
- 接口详细描述请参考资源管理API文档。
批量查询资源所属的分组
使用以下代码可以查询资源绑定的资源分组
Go
1args := &ResGroupDetailRequest{
2 ResourceBrief:[]ResourceBrief{
3 {
4 // 资源ID
5 ResourceId:"123.org",
6 // 资源类型
7 ResourceType:"CDN",
8 // 资源区域
9 ResourceRegion: "global",
10 },
11 },
12 }
13
14result, err := client.GetResGroupBatch(args)
15if err != nil {
16 fmt.Println("GetResGroupBatch failed:", err)
17} else {
18 fmt.Println("GetResGroupBatch success: ", result)
19}
提示:
- 资源ID查询资源分组接口支持批量查询,一次最多支持查询1000个资源。
- 仅能查询当前账号资源,也就是根据AK, SK签名解析的账号下的资源。
- 接口详细描述请参考资源管理API文档。