Skip to content

Latest commit

 

History

History
1525 lines (1356 loc) · 48.2 KB

BBC.md

File metadata and controls

1525 lines (1356 loc) · 48.2 KB

BBC服务

概述

本文档主要介绍BBC GO SDK的使用。在使用本文档前,您需要先了解BBC的一些基本知识。若您还不了解BBC,可以 参考产品描述操作指南

初始化

确认Endpoint

在确认您使用SDK时配置的Endpoint时,可先阅读开发人员指南中关于 BBC访问域名的部分, 理解Endpoint相关的概念。百度云目前开放了多区域支持,请参考区域选择说明

由于BBC维修任务并不按照区域区分,在访问维修任务相关接口时,Endpoint统一使用北京区域的BBC访问域名。

获取密钥

要使用百度云BBC,您需要拥有一个有效的AK(Access Key ID)和SK(Secret Access Key)用来进行签名认证。 AK/SK是由系统分配给用户的,均为字符串,用于标识用户,为访问BBC做签名验证。

可以通过如下步骤获得并了解您的AK/SK信息:

注册百度云账号

创建AK/SK

新建BBC Client

BBC Client是BBC服务的客户端,为开发者与BBC服务进行交互提供了一系列的方法。

使用AK/SK新建BBC Client

通过AK/SK方式访问BBC,用户可以参考如下代码新建一个Bbc Client:

import "github.com/baidubce/bce-sdk-go/services/bbc"

func main() {
	// 用户的Access Key ID和Secret Access Key
	AK, SK := <your-access-key-id>, <your-secret-access-key>

	// 用户指定的Endpoint
	ENDPOINT := <domain-name>

	// 初始化一个BBClient
	bbcClient, err := bbc.NewClient(AK, SK, ENDPOINT)
}

在上面代码中,AK对应控制台中的“Access Key ID”,SK对应控制台中的“Access Key Secret”, 获取方式请参考获取AKSK。 第三个参数ENDPOINT支持用户自己指定域名,如果设置为空字符串,会使用默认域名作为BBC的服务地址。

注意:ENDPOINT参数需要用指定区域的域名来进行定义,如服务所在区域为北京,则为bbc.bj.baidubce.com

配置HTTPS协议访问BBC

BBC支持HTTPS传输协议,您可以通过在创建BBC Client对象时指定的Endpoint中指明HTTPS的方式,在BBC GO SDK中使用HTTPS访问BBC服务:

import "github.com/baidubce/bce-sdk-go/services/bbc"

ENDPOINT := "https://bbc.bj.baidubce.com" //指明使用HTTPS协议
AK, SK := <your-access-key-id>, <your-secret-access-key>
bbcClient, _ := bbc.NewClient(AK, SK, ENDPOINT)

设置网络参数

用户可以通过如下的示例代码进行网络参数的设置:

import "github.com/baidubce/bce-sdk-go/services/bbc"

AK, SK := <your-access-key-id>, <your-secret-access-key>
ENDPOINT := "bbc.bj.baidubce.com"
client, _ := bbc.NewClient(AK, SK, ENDPOINT)

// 配置不进行重试,默认为Back Off重试
client.Config.Retry = bce.NewNoRetryPolicy()

// 配置连接超时时间为30秒
client.Config.ConnectionTimeoutInMillis = 30 * 1000

配置生成签名字符串选项

// import "github.com/baidubce/bce-sdk-go/services/bbc"

AK, SK := <your-access-key-id>, <your-secret-access-key>
ENDPOINT := "bbc.bj.baidubce.com"
client, _ := bbc.NewClient(AK, SK, ENDPOINT)

// 配置签名使用的HTTP请求头为`Host`
headersToSign := map[string]struct{}{"Host": struct{}{}}
client.Config.SignOption.HeadersToSign = HeadersToSign

// 配置签名的有效期为30秒
client.Config.SignOption.ExpireSeconds = 30

参数说明

用户使用GO SDK访问BBC时,创建的BBC Client对象的Config字段支持的所有参数如下表所示:

配置项名称 类型 含义
Endpoint string 请求服务的域名
ProxyUrl string 客户端请求的代理地址
Region string 请求资源的区域
UserAgent string 用户名称,HTTP请求的User-Agent头
Credentials *auth.BceCredentials 请求的鉴权对象,分为普通AK/SK与STS两种
SignOption *auth.SignOptions 认证字符串签名选项
Retry RetryPolicy 连接重试策略
ConnectionTimeoutInMillis int 连接超时时间,单位毫秒,默认20分钟

说明:

  1. Credentials字段使用auth.NewBceCredentialsauth.NewSessionBceCredentials函数创建,默认使用前者. 后者为使用STS鉴权时使用
  2. SignOption字段为生成签名字符串时的选项,详见下表说明:
名称 类型 含义
HeadersToSign map[string]struct{} 生成签名字符串时使用的HTTP头
Timestamp int64 生成的签名字符串中使用的时间戳,默认使用请求发送时的值
ExpireSeconds int 签名字符串的有效期
 其中,HeadersToSign默认为`Host`,`Content-Type`,`Content-Length`,`Content-MD5`;TimeStamp一般为零值,表示使用调用生成认证字符串时的时间戳,用户一般不应该明确指定该字段的值;ExpireSeconds默认为1800秒即30分钟。
  1. Retry字段指定重试策略,目前支持两种:NoRetryPolicyBackOffRetryPolicy。默认使用后者,该重试策略是指定最大重试次数、最长重试时间和重试基数,按照重试基数乘以2的指数级增长的方式进行重试,直到达到最大重试测试或者最长重试时间为止。

主要接口

云服务器BCC(Baidu Cloud Compute)是处理能力可弹性伸缩的计算服务。 管理方式比物理服务器更简单高效,可根据您的业务需要创建、释放任意多台云服务器实例,提升运维效率。

实例

创建实例

使用以下代码可以创建一个物理机实例:

createInstanceArgs := &CreateInstanceArgs{
    // 输入你选择的flavor(套餐)ID,通过SDK获取可用flavor id的方法详见套餐章节
    FlavorId:         "your-choose-flavor-id",
    // 输入你要创建instance使用的镜像ID,通过SDK获取可用镜像ID的方法详见镜像章节
    ImageId:          "your-choose-image-id",
    // 输入你要创建instance使用的raid ID,通过SDK获取可用raid id的方法详见套餐章节
    RaidId:           "your-choose-raid-id",
    // 输入待创建物理磁盘的大小,单位为GB,缺省为20
    RootDiskSizeInGb: 20,
    // 批量创建(购买)的虚拟机实例个数,必须为大于0的整数,可选参数,缺省为1
    PurchaseCount:    1,
    // 可用区,格式为:国家-区域-可用区,如'中国-北京-可用区A'就是'cn-bj-a'
    ZoneName:         "cn-bj-a",
    // 指定子网 ID,必填参数
    SubnetId:         "your-choose-subnet-id",
    // 设置内网IP(只有智能卡套餐支持自定义内网IP)
    InternalIps           []string         internalIps
    // 指定安全组id,可选参数
    SecurityGroupId:  "your-choose-security-group-id"
    // 使用 uuid 生成一个长度不超过64位的ASCII字符串
    ClientToken:      "random-uuid",
    //创建实例支持幂等的token,永久有效
    RequestToken     string  "requestToken"
    // 选择付费方式
    Billing: Billing{
        PaymentTiming: PaymentTimingPostPaid,
        Reservation: Reservation{
            Length: 1,
            TimeUnit: "Month",
        },
    },
    // 指定使用的部署集id,可选参数,通过SDK获取可用部署集id的方法详见部署集章节
    DeploySetId: "your-choose-raid-id",
    // 设置实例管理员密码(8-16位字符,英文,数字和符号必须同时存在,符号仅限!@#$%^*())
    AdminPass:   "your-admin-pass",
    // 实例名称
    Name:        "your-choose-instance-name",
    // 实例主机名,可选参数,若不选则主机名和实例名称保持一致(实例名称不包含中文名时)
    // 仅支持小写字母、数字以及- . 特殊字符,不可连续使用特殊符号,不支持特殊符号开头或结尾,长度2-64
    Hostname:        "your-choose-instance-hostname",
    // 支持幂等的token
    RequestToken: "requestToken",
    // 指定是否开启numa true为开启,false为关闭
    EnableNuma:  true,
    // 指定系统盘文件系统,当前合法值:xfs,ext4
    RootPartitionType: "your-choose-rootPartitionType", 
    // 指定数据盘文件系统,当前合法值:xfs,ext4
    DataPartitionType: "your-choose-dataPartitionType",
    // 指定实例绑定标签
    Tags: []model.TagModel{
        {
            TagKey:   "tagKey",
            TagValue: "tagVaule",
        },
    },
}
if res, err := bbcClient.CreateInstance(createInstanceArgs); err != nil {
    fmt.Println("create instance failed: ", err)
} else {
    fmt.Println("create instance success, instanceId: ", res.InstanceIds[0])
}

注意: 付费方式(PaymentTiming)可选:

  • 后付费: PaymentTimingPostPaid
  • 预付费: PaymentTimingPrePaid

查询实例列表

使用以下代码查询所有BBC实例的列表及详情信息:

listArgs := &ListInstancesArgs{
    // 批量获取列表的查询起始位置,是一个由系统产生的字符串
    Marker: "your-marker",
    // 设置返回数据大小,缺省为1000
    MaxKeys: 100,
    // 通过internal Ip过滤BBC列表
    InternalIp: "your-choose-internal-ip",
}
if res, err := bbcClient.ListInstances(listArgs); err != nil {
    fmt.Println("list instances failed: ", err)
} else {
    fmt.Println("list instances success, result: ", res)
}

查询实例详情

使用以下代码可以查询指定BBC实例的详细信息:

// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
//设置是否展示部署集字段
isDeploySet := "your-isDeploySet"
if res, err := bbcClient.GetInstanceDetail(instanceId); err != nil {
    fmt.Println("get instance detail failed: ", err)
} else {
    fmt.Println("get instance detail success, result: ", res)
}

查询带部署集相关字段实例详情

查询带部署集相关字段实例详情:

// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
//设置是否展示部署集字段true or false
isDeploySet := "your-isDeploySet"

if res, err := bccClient.GetInstanceDetailWithDeploySet(instanceId,isDeploySet); err != nil {
    fmt.Println("get instance detail failed: ", err)
} else {
    fmt.Println("get instance detail success, result: ", res)
}

启动实例

使用以下代码可以启动指定BBC实例,实例状态必须为 Stopped,调用此接口才可以成功返回,否则提示409错误:

// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
if err := bbcClient.StartInstance(instanceId); err != nil {
    fmt.Println("start instance failed: ", err)
} else {
    fmt.Println("start instance success.")
}

停止实例

使用以下代码可以停止指定BBC实例,只有状态为 Running 的实例才可以进行此操作,否则提示 409 错误:

// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
// 是否强制停止实例,为True代表强制停止
forceStop := true
if err := bbcClient.StopInstance(instanceId, forceStop); err != nil {
    fmt.Println("stop instance failed: ", err)
} else {
    fmt.Println("stop instance success.")
}

重启实例

使用以下代码可以重启指定BBC实例,只有状态为 Running 的实例才可以进行此操作,否则提示 409 错误:

// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
// 是否强制停止实例,为True代表强制停止
forceStop := true
if err := bbcClient.RebootInstance(instanceId, forceStop); err != nil {
    fmt.Println("reboot instance failed: ", err)
} else {
    fmt.Println("reboot instance success.")
}

修改实例名称

使用以下代码可以修改指定BBC实例的名称:

modifyInstanceNameArgs := &ModifyInstanceNameArgs{
    Name: "new_bbc_name",
}
// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
if err := bbcClient.ModifyInstanceName(instanceId, modifyInstanceNameArgs); err != nil {
    fmt.Println("modify instance name failed: ", err)
} else {
    fmt.Println("modify instance name success.")
}

修改实例描述

使用以下代码可以修改指定BBC实例的描述:

modifyInstanceDescArgs := &ModifyInstanceDescArgs{
    Description: "new_bbc_description",
}
// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
if err := bbcClient.ModifyInstanceDesc(instanceId, modifyInstanceDescArgs); err != nil {
    fmt.Println("modify instance desc failed: ", err)
} else {
    fmt.Println("modify instance desc success.")
}

实例变更子网

如下代码可以变更实例的子网

instanceChangeVpcArgs := &api.InstanceChangeSubnetArgs{
	InstanceId: instanceId,
	SubnetId:   subnetId, 
	InternalIp: internalIp,
	Reboot:     false,
}
err := bbcClient.InstanceChangeSubnet(args)
if err != nil {
    fmt.Println("change instance subnet failed:", err)
} else {
    fmt.Println("change instance subnet success")
}

提示:

  • 变更子网后默认自动重启,用户选择是否执行该操作。
  • 变更子网的范围目前仅支持在同AZ下变更子网,不支持跨AZ或跨VPC变更子网。

修改实例VPC

使用以下代码可以修改指定BBC实例所在的VPC:

instanceChangeVpcArgs := &InstanceChangeVpcArgs{
    InstanceId: "your-choose-instance-id",
    SubnetId: "new_subnet_id_in_vpc", 
    InternalIp: internalIp,
    Reboot: true,
}
if err := bbcClient.InstanceChangeVpc(instanceChangeVpcArgs); err != nil {
    fmt.Println("modify instance vpc failed: ", err)
} else {
    fmt.Println("modify instance vpc success.")
}

提示:

  • 变更VPC后默认自动重启,用户选择是否执行该操作。
  • 变更VPC后仅保留主网卡主IP(在新子网中自动分配),实例上的辅助IP和安全组等信息不跟随主体迁移。

重装实例

使用以下代码可以使用镜像重建指定BBC实例:

rebuildArgs := &RebuildInstanceArgs{
    // 设置使用的镜像id
    ImageId:        "your-choose-image-id",
    // 设置管理员密码
    AdminPass:      "your-new-admin-pass",
    // 是否保留数据。当该值为true时,raidId和sysRootSize字段不生效
    IsPreserveData: false,
    // 此参数在isPreserveData为false时为必填,在isPreserveData为true时不生效
    RaidId:         "your_raid_id",
    // 系统盘根分区大小,默认为20G,取值范围为20-100。此参数在isPreserveData为true时不生效
    SysRootSize: 20,
    // 指定系统盘文件系统,当前合法值:xfs,ext4
    RootPartitionType: "your-choose-rootPartitionType",
    // 指定数据盘文件系统,当前合法值:xfs,ext4
    DataPartitionType: "your-choose-dataPartitionType",
}
// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
// 设置是否保留数据
isPreserveData = false
if err := bbcClient.RebuildInstance(instanceId, isPreserveData, rebuildArgs); err != nil {
    fmt.Println("rebuild instance failed: ", err)
} else {
    fmt.Println("rebuild instance success.")
}

注意: IsPreserveData表示是否保留数据:

  • 当IsPreserveData设置为 false 时,RaidId 和 SysRootSize 是必填参数
  • 当IsPreserveData设置为 true 时,RaidId、SysRootSize 和 DataPartitionType 参数不生效

批量重装实例

使用以下代码可以使用镜像批量重建指定BBC实例:

rebuildArgs := &BatchRebuildInstanceArgs{
    // 设置重装BBC的实例ID
    InstanceIds:    []string{"your-choose-instance-id"},
    // 设置使用的镜像id
    ImageId:        "your-choose-image-id",
    // 设置管理员密码
    AdminPass:      "your-new-admin-pass",
    // 是否保留数据。当该值为true时,raidId和sysRootSize字段不生效
    IsPreserveData: false,
    // 此参数在isPreserveData为false时为必填,在isPreserveData为true时不生效
    RaidId:         "your_raid_id",
    // 系统盘根分区大小,默认为20G,取值范围为20-100。此参数在isPreserveData为true时不生效
    SysRootSize: 20,
    // 指定系统盘文件系统,当前合法值:xfs,ext4
    RootPartitionType: "your-choose-rootPartitionType",
    // 指定数据盘文件系统,当前合法值:xfs,ext4
    DataPartitionType: "your-choose-dataPartitionType",
}
if res, err := bbcClient.BatchRebuildInstance(rebuildArgs); err != nil {
    fmt.Println("batch rebuild instance failed: ", err)
} else {
    fmt.Println("batch rebuild instance success, result: %s", res)
}

注意: IsPreserveData表示是否保留数据:

  • 当IsPreserveData设置为 false 时,RaidId 和 SysRootSize 是必填参数
  • 当IsPreserveData设置为 true 时,RaidId、SysRootSize 和 DataPartitionType 参数不生效

实例续费

对BBC实例的续费操作,可以延长过期时长,或者从回收站恢复预付费BBC实例,以下代码可以对实例进行续费

args := &PurchaseReservedArgs {
    Billing: Billing{
        PaymentTiming: PaymentTimingPrePaid,
        Reservation: Reservation{
            Length: 1,
            TimeUnit: "Month",
        },
    },
}
// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"

if err := bbcClient.InstancePurchaseReserved(instnaceId, args); err != nil {
    fmt.Println("Renew Instance failed: ", err)
} else {
    fmt.Println("Renew Instance success.")
}

提示:

  • 续费时若实例已欠费停机,续费成功后有个BBC实例启动的过程。
  • 该接口是一个异步接口。

释放实例

对于后付费Postpaid以及预付费Prepaid过期的BBC实例,可以使用以下代码将其释放:

// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
if err := bbcClient.DeleteInstance(instanceId); err != nil {
    fmt.Println("release instance failed: ", err)
} else {
    fmt.Println("release instance success.")
}

释放实例(包含预付费实例)

不区分后付费还是预付费实例,释放bbc以及关联的eip,可以使用以下代码将其释放:

	args := &DeleteInstanceIngorePaymentArgs{
		InstanceId:      "instanceid",
		RelatedReleaseFlag: relatedReleaseFlag, //true or false
        //设置是否立即释放,默认false,实例进入回收站,关联eip资源解绑;为true时,实例和设置了关联释放的eip资源,一起立即释放
        DeleteImmediate: false,
	}
	if res, err := BBC_CLIENT.DeleteInstanceIngorePayment(args); err != nil {
		fmt.Println("delete instance failed: ", err)
	} else {
		fmt.Printf("delelte instance success, result: %s", res)
	}

批量释放或进入回收站实例(不包含预付费实例)

释放或者进入回收站bbc实例,可以使用以下代码将其释放:

	instanceIds := []string{"instanceId"}
	queryArgs := &DeleteInstanceArgs{
		BbcRecycleFlag: bbcRecycleFlag,  // true or false, true recycled the bbc
		InstanceIds:    instanceIds,
	}
	if err := BBC_CLIENT.DeleteInstances(queryArgs); err != nil {
		fmt.Println("delete instances failed: ", err)
	} else {
		fmt.Println("delete instances success")
	}

查询回收站实例列表

使用以下代码查询所有BBC回收站实例的列表及详情信息

	queryArgs := &ListRecycledInstancesArgs{
		Marker:        "your marker",
		PaymentTiming: "your paymentTiming",   
		RecycleBegin:  "RecycleBegin",  // recycled begin time ,eg: 2020-11-23T17:18:24Z
		RecycleEnd:    "RecycleEnd",
		MaxKeys:       10,
		InstanceId:    "InstanceId",
		Name:          "InstanceName",
	}
	if res, err := BBC_CLIENT.ListRecycledInstances(queryArgs); err != nil {
		fmt.Println("list recycled bbc failed: ", err)
	} else {
		fmt.Println("list recycled bbc success, result: ", res)
	}

释放回收站实例

回收站实例7天后自动释放,清理回收站资源,可以使用以下代码将其释放:

// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
if err := bbcClient.DeleteRecycledInstance(instanceId); err != nil {
    fmt.Println("release instance failed: ", err)
} else {
    fmt.Println("release instance success.")
}

后付费回收站bbc实例恢复计费

使用以下代码可以恢复后付费回收站bbc实例,再次使用。 备注: 预付费回收站实例使用预付费续费接口即可

	instanceIds := []string{"instanceId"}
	queryArgs := &RecoveryInstancesArgs{
		InstanceIds: instanceIds,
	}
	if err := BBC_CLIENT.RecoveryInstances(queryArgs); err != nil {
		fmt.Println("recovery instance failed: ", err)
	} else {
		fmt.Println("recovery instance success")
	}

修改实例密码

使用以下代码可以修改指定BBC实例的管理员密码:

modifyInstancePasswordArgs := &ModifyInstancePasswordArgs{
    AdminPass: "your_new_password",
}
// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
if err := bbcClient.ModifyInstancePassword(instanceId, modifyInstancePasswordArgs); err != nil {
    fmt.Println("modify instance password failed: ", err)
} else {
    fmt.Println("modify instance password success.")
}

查询实例VNC地址

如下代码可以查询实例的VNC地址

result, err := client.GetInstanceVNC(instanceId)
if err != nil {
    fmt.Println("get instance VNC url failed:", err)
} else {
    fmt.Println("get instance VNC url success: ", result)
}

提示:

  • VNC地址一次使用后即失效
  • URL地址有效期为10分钟

注意: BBC 实例密码要求:

  • 8-16位字符,英文,数字和符号必须同时存在,符号仅限!@#$%^*()

查询实例VPC/Subnet信息

使用以下代码可以通过BBC实例id查询VPC/Subnet信息:

// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
getVpcSubnetArgs := &GetVpcSubnetArgs{
    BbcIds: []string{instanceId},
}
if res, err := bbcClient.GetVpcSubnet(getVpcSubnetArgs); err != nil {
    fmt.Println("get vpc subnet failed: ", err)
} else {
    fmt.Println("get vpc subnet success. res: ", res)
}

智能卡实例绑定安全组

使用以下代码可以将智能卡实例绑定安全组:

args := &BindSecurityGroupsArgs{
    InstanceIds: ["instanceId"],
    SecurityGroups: ["SecurityGroup"],
}
if err := bbcClient.BindSecurityGroups(args); err != nil {
    fmt.Println("BindSecurityGroups failed: ", err)
} else {
    fmt.Println("BindSecurityGroups success.")
}

智能卡实例解绑安全组

使用以下代码可以将智能卡实例解绑安全组:

args := &UnBindSecurityGroupsArgs{
    InstanceId: "",
    SecurityGroupId: "",
}
if err := bbcClient.UnBindSecurityGroups(args); err != nil {
    fmt.Println("UnBindSecurityGroups failed: ", err)
} else {
    fmt.Println("UnBindSecurityGroups success.")
}

批量增加辅助IP

使用以下代码对实例增加辅助IP:

batchAddIpArgs := &BatchAddIpArgs{
    // 实例ID
    InstanceId string "instanceId"
    // 辅助IP,和SecondaryPrivateIpAddressCount不可同时使用
	PrivateIps []string "privateIps"
    // 自动分配IP数量,和PrivateIps不可同时使用
    SecondaryPrivateIpAddressCount int 1
    // 幂等性Token,使用 uuid 生成一个长度不超过64位的ASCII字符串,可选参数
    ClietnToken string "clientToken"
}

if res, err := bbcClient.BatchAddIP(batchAddIpArgs); err != nil {
    fmt.Println("BatchAddIP failed: ", err)
} else {
    fmt.Println("BatchAddIP success, result: ", res)
}

批量删除指定实例的ip

privateIps := []string{"192.168.1.25"}
instanceId := "your-choose-instance-id"
// 幂等性Token,使用 uuid 生成一个长度不超过64位的ASCII字符串,可选参数
clientToken := "clientToken"
batchDelIpArgs := &BatchDelIpArgs{
	InstanceId:     instanceId,
	PrivateIps:     privateIps,
    ClientToken:    clientToken,
}
if err := bbcClient.BatchDelIP(batchDelIpArgs); err != nil {
    fmt.Println("delete ips failed: ", err)
} else {
    fmt.Println("delete ips success.")
}

开通自动续费(包含关联产品)

自动续费仅限预付费产品

bbcCreateAutoRenewArgs := &BbcCreateAutoRenewArgs{
    // 实例ID
    InstanceId: instanceId,
    // 续费单位,month,year
    RenewTimeUnit: "month",
    // 续费时长,单位:month,支持1, 2, 3, 4, 5, 6, 7, 8, 9;单位:year,支持1, 2, 3
    RenewTime: 1,
}

if err := bbcClient.BatchCreateAutoRenewRules(bbcCreateAutoRenewArgs); err != nil {
    fmt.Println("BatchCreateAutoRenewRules failed: ", err)
} else {
    fmt.Println("BatchCreateAutoRenewRules success.")
}

关闭自动续费(包含关联产品)

自动续费仅限预付费产品

bbcDeleteAutoRenewArgs := &BbcDeleteAutoRenewArgs{
	// 实例ID
	InstanceId: instanceId,
}

if err := bbcClient.BatchDeleteAutoRenewRules(bbcCreateAutoRenewArgs); err != nil {
    fmt.Println("BatchDeleteAutoRenewRules failed: ", err)
} else {
    fmt.Println("BatchDeleteAutoRenewRules success.")
}

查询实例绑定的弹性网卡列表

使用以下代码可以查询实例绑定的弹性网卡列表

// 设置你要操作的instanceId
instanceId := ""
if res, err := bbcClient.GetInstanceEni(instanceId); err != nil {
    fmt.Println("Get specific instance eni failed: ", err)
} else {
    fmt.Println("Get specific instance eni success, result: ", res)
}

标签

实例解绑标签

通过以下代码解绑实例已有的标签

unbindTagsArgs := &UnbindTagsArgs{
    // 设置您要解绑的标签
    ChangeTags: []model.TagModel{
        {
            TagKey:   "tag1",
            TagValue: "var1",
        },
    },
}
// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
if err := BBC_CLIENT.UnbindTags(instanceId, unbindTagsArgs); err != nil {
    fmt.Println("unbind instance tags failed: ", err)
} else {
    fmt.Println("unbind instance tags success.")
}

套餐

查询套餐列表

使用以下代码查询所有BBC套餐的列表及详情信息

if res, err := bbcClient.ListFlavors(); err != nil {
    fmt.Println("List flavors failed: ", err)
} else {
    fmt.Println("List flavors success, result: ", res)
}

查询套餐详情

使用以下代码可以查询指定套餐的详细信息

// 设置你要操作的flavorId
flavorId := "your-choose-flavor-id"
if res, err := bbcClient.GetFlavorDetail(testFlavorId); err != nil {
    fmt.Println("Get flavor failed: ", err)
} else {
    fmt.Println("Get flavor success, result: ", res)
}

查询RAID详情

使用以下代码可以查询指定套餐的RAID方式及磁盘大小

// 设置你要操作的flavorId
flavorId := "your-choose-flavor-id"
if res, err := bbcClient.GetFlavorRaid(testFlavorId); err != nil {
    fmt.Println("Get raid failed: ", err)
} else {
    fmt.Println("Get raid success, result: ", res)
}

查询套餐支持的可用区

使用以下代码可以查询指定套餐支持的可用区列表

// 设置你要操作的flavorId
flavorId := ""
queryArgs := &ListFlavorZonesArgs{
    FlavorId: flavorId,
}
if res, err := bbcClient.ListFlavorZones(queryArgs); err != nil {
    fmt.Println("Get flavor zoneName failed: ", err)
} else {
    fmt.Println("Get flavor zoneName success, result: ", res)
}

查询可用区支持的套餐

使用以下代码可以查询指定可用区支持的套餐列表

// 设置你要操作的zoneName,可以使用cn-bj-a 等
zoneName := ""
queryArgs := &ListZoneFlavorsArgs{
    ZoneName: zoneName,
}
if res, err := bbcClient.ListZoneFlavors(queryArgs); err != nil {
    fmt.Println("Get the specific zone flavor failed: ", err)
} else {
    fmt.Println("Get the specific zone flavor success, result: ", res)
}

镜像

通过实例创建自定义镜像

  • 用于创建自定义镜像,默认每个账号配额20个,创建后的镜像可用于创建实例
  • 只有 Running 或 Stopped 状态的实例才可以执行成功 使用以下代码可以从指定的实例创建镜像
// 用于创建镜像的实例ID
instanceId := "i-3EavdPl8"
// 设置创建镜像的名称
imageName := "testCreateImage"
queryArgs := &CreateImageArgs{
    ImageName:  testImageName,
    InstanceId: testInstanceId,
}
if res, err := bbcClient.CreateImageFromInstanceId(queryArgs); err != nil {
    fmt.Println("Create image failed: ", err)
} else {
    fmt.Println("Create image success, result: ", res)
}

查询镜像列表

  • 用于查询用户所有的镜像信息
  • 查询的镜像信息中包括系统镜像、自定义镜像和服务集成镜像
  • 支持按 imageType 来过滤查询,此参数非必需,未设置时默认为 All,即查询所有类型的镜像 使用以下代码可以查询镜像列表
// 指定要查询何种类型的镜像
// All(所有)
// System(系统镜像/公共镜像)
// Custom(自定义镜像)
// Integration(服务集成镜像)
// Sharing(共享镜像)
imageType := "All"
// 批量获取列表的查询的起始位置 
marker := "your-marker"
// 每页包含的最大数量
maxKeys := 100
queryArgs := &ListImageArgs{
    Marker:    marker, 
    MaxKeys:   maxKeys,
    ImageType: imageType,
}
if res, err := bbcClient.ListImage(queryArgs); err != nil {
    fmt.Println("List image failed: ", err)
} else {
    fmt.Println("List image success, result: ", res)
}

查询镜像详情

  • 用于根据指定镜像ID查询单个镜像的详细信息 使用以下代码可以查询镜像详情
// 待查询镜像ID
image_id :="your-choose-image-id"
if res, err := bbcClient.GetImageDetail(testImageId); err != nil {
    fmt.Println("Get image failed: ", err)
} else {
    fmt.Println("Get image success, result: ", res.Result)
}

删除自定义镜像

  • 用于删除用户自己的指定的自定义镜像,仅限自定义镜像,系统镜像和服务集成镜像不能删除
  • 镜像删除后无法恢复,不能再用于创建、重置实例 使用以下代码可以删除指定镜像
// 待删除镜像ID
imageId := "your-choose-image-id"
if err := bbcClient.DeleteImage(testImageId); err != nil {
    fmt.Println("Delete image failed: ", err)
}

获取套餐的公共镜像

  • 如果不传套餐id,获取所有套餐的镜像列表 使用以下代码可以获取指定套餐可选的公共镜像列表
// 物理机套餐Id列表
flavorIds := []string{""}
queryArgs := &GetFlavorImageArgs{
    FlavorIds: flavorIds,
}
if res, err := bbcClient.GetCommonImage(queryArgs); err != nil {
    fmt.Println("Get specific flavor common image failed: ", err)
} else {
    fmt.Println("Get specific flavor common image success, result: ", res)
}

获取套餐的自定义镜像

  • 如果不传套餐id,获取所有套餐的镜像列表 使用以下代码可以获取指定套餐可选的自定义镜像列表
// 物理机套餐Id列表
flavorIds := []string{"BBC-S3-02"}
queryArgs := &GetFlavorImageArgs{
    FlavorIds: flavorIds,
}
if res, err := bbcClient.GetCustomImage(queryArgs); err != nil {
    fmt.Println("Get specific flavor common image failed: ", err)
} else {
    fmt.Println("Get specific flavor common image success, result: ", res)
}

共享自定义镜像

  • 该接口用于共享用户自己的指定的自定义镜像,仅限自定义镜像,系统镜像和服务集成镜像不能共享。
  • imageId 所指定的镜像不存在,提示404错误。
  • 镜像共享后,被共享的用户可以使用此镜像创建、重置实例。
  • 请求参数中的account和accountId均为可选参数,但不能全部为空,当两个参数同时出现时,服务端会自动去重。
// 待共享的用户id
accountId := "your-accountId"
//待共享的用户名
account := "your-account"
// 待共享的镜像ID
imageId := "your-imageId"

args := &api.SharedUser{
	AccountId:  accountId,
    Account:    account,
}
if  err := bbcClient.ShareImage(imageId,args); err != nil {
    fmt.Println("ShareImage failed: ", err)
} else {
    fmt.Println("ShareImage success")
}

取消共享自定义镜像

  • 该接口用于取消共享用户自己的指定的自定义镜像,仅限自定义镜像,系统镜像和服务集成镜像不能共享。
  • imageId 所指定的镜像不存在,提示404错误。
  • 镜像取消共享后,被取消共享的用户不能再使用此镜像创建、重置实例。
  • 请求参数中的account和accountId均为可选参数,但不能全部为空,当两个参数同时出现时,服务端会自动去重。
// 待共享的用户id
accountId := "your-accountId"
//待共享的用户名
account := "your-account"
// 待共享的镜像ID
imageId := "your-imageId"

args := &api.SharedUser{
	AccountId:  accountId,
    Account:    account,
}
if  err := bbcClient.UnShareImage(imageId,args); err != nil {
    fmt.Println("UnShareImage failed: ", err)
} else {
    fmt.Println("UnShareImage success")
}

跨区域复制自定义镜像

  • 用于用户跨区域复制自定义镜像,仅限自定义镜像,系统镜像和服务集成镜像不能复制
  • regions如北京"bj",广州"gz",苏州"su",可多选:
 args := RemoteCopyImageArgs{
    Name:       "test2",
    DestRegion: []string{"gz"},
 }
 err := bbcClient.RemoteCopyImage(imageId, args)
 if err != nil {
     fmt.Println("remote copy image failed:", err)
 } else {
     fmt.Println("remote copy image success")
 }

跨区域复制自定义镜像并返回目的region的镜像镜像id

  • 用于用户跨区域复制自定义镜像,仅限自定义镜像,系统镜像和服务集成镜像不能复制
  • regions如北京"bj",广州"gz",苏州"su",可多选:
args := &api.RemoteCopyImageArgs{
    Name:       "test2",
    DestRegion: []string{"gz"},
 }
result, err := bbcClient.RemoteCopyImageReturnImageIds(imageId, args)
 if err != nil {
     fmt.Println("remote copy image failed:", err)
 } else {
     fmt.Println("remote copy image success")
 }

取消跨区域复制自定义镜像

用于取消跨区域复制自定义镜像,仅限自定义镜像,系统镜像和服务集成镜像不能复制:

err := bbcClient.CancelRemoteCopyImage(imageId)
if err != nil {
    fmt.Println("cancel remote copy image failed:", err)
} else {
    fmt.Println("cancel remote copy image success")
}

查询自定义镜像已共享的用户

  • 该接口用于查询自定义镜像已共享的用户列表
  • imageId 待查询的自定义镜像Id
// 待查询的自定义镜像ID
imageId := "your-imageId"

if  users, err := bbcClient.GetImageSharedUser(imageId); err != nil {
    fmt.Println("GetImageSharedUser failed: ", err)
} else {
    fmt.Println("GetImageSharedUser success: ", users)
}

操作日志

查询操作日志

通过以下代码查询指定操作日志

// 批量获取列表的查询的起始位置,是一个由系统生成的字符串
marker := "your-marker"
// 每页包含的最大数量,最大数量通常不超过1000。缺省值为100
maxKeys := 100
// 需查询物理机操作的起始时间(UTC时间),格式 yyyy-MM-dd'T'HH:mm:ss'Z' ,为空则查询当日操作日志
startTime := ""
// 需查询物理机操作的终止时间(UTC时间),格式 yyyy-MM-dd'T'HH:mm:ss'Z' ,为空则查询当日操作日志
endTime := ""
queryArgs := &GetOperationLogArgs{
    Marker:    marker,
    MaxKeys:   maxKeys,
    StartTime: startTime,
    EndTime:   endTime,
}
if res, err := bbcClient.ListImage(queryArgs); err != nil {
    fmt.Println("Get Operation Log failed: ", err)
} else {
    fmt.Println("Get Operation Log success, result: ", res)
}

部署集

创建部署集

通过以下代码根据指定的部署集策略和并发度创建部署集

// 设置创建部署集的名称
deploySetName := "your-deploy-set-name"
// 设置创建的部署集的描述信息
deployDesc := "your-deploy-set-desc"
// 设置部署集并发度,范围 [1,5]
concurrency := 1
// 设置创建部署集的策略,BBC实例策略只支持:"tor_ha"
strategy := "tor_ha"
queryArgs := &CreateDeploySetArgs{
    Strategy:    strategy,
    Concurrency: concurrency,
    Name:        deploySetName,
    Desc:        deployDesc,
}
if res, err := bbcClient.CreateDeploySet(queryArgs); err != nil {
    fmt.Println("Create deploy set failed: ", err)
} else {
    fmt.Println("Create deploy set success, result: ", res)
}

查询部署集列表

使用以下代码查询所有部署集实例的列表及详情信息

if res, err := bbcClient.ListDeploySets(); err != nil {
    fmt.Println("List deploy sets failed: ", err)
} else {
    fmt.Println("List deploy sets success, result: ", res)
}

查询部署集列表

使用以下代码分页过滤查询所有部署集实例的列表及详情页面

queryArgs := &ListDeploySetsArgs{
    // 批量获取列表的查询起始位置,是一个由系统产生的字符串
    Marker: "your-marker",
    // 设置返回数据大小,缺省为1000
    MaxKeys: 100,
    // 通过internal Ip过滤维修任务列表
    Strategy: "your-choose-strategy",
}
if res, err := bbcClient.ListDeploySetsPage(queryArgs); err != nil {
    fmt.Println("List deploy sets failed: ", err)
} else {
    fmt.Println("List deploy sets success, result: ", res)
}

查询部署集详情

使用以下代码可以查询指定套餐的详细信息

// 设置你要查询的deploySetID
deploySetID := "your-choose-deploy-set-id"
if res, err := bbcClient.GetDeploySet(deploySetID); err != nil {
    fmt.Println("Get deploy set failed: ", err)
} else {
    fmt.Println("Get deploy set success, result: ", res)
}

删除指定的部署集

使用以下代码删除用户自己的指定的部署集

// 设置你要删除的deploySetID
deploySetID := "your-choose-deploy-set-id"
if err := bbcClient.DeleteDeploySet(deploySetID); err != nil {
    fmt.Println("Delete deploy set failed: ", err)
}

##标签

实例绑定标签

通过以下代码绑定实例想要绑定的标签

bindTagsArgs := &BindTagsArgs{
    // 设置您要绑定的标签
    ChangeTags: []model.TagModel{
        {
            TagKey:   "tag1",
            TagValue: "var1",
        },
    },
}
// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
if err := BBC_CLIENT.BindTags(instanceId, bindTagsArgs); err != nil {
    fmt.Println("bind instance tags failed: ", err)
} else {
    fmt.Println("bind instance tags success.")
}

实例解绑标签

通过以下代码解绑实例已有的标签

unbindTagsArgs := &UnbindTagsArgs{
    // 设置您要解绑的标签
    ChangeTags: []model.TagModel{
        {
            TagKey:   "tag1",
            TagValue: "var1",
        },
    },
}
// 设置你要操作的instanceId
instanceId := "your-choose-instance-id"
if err := BBC_CLIENT.UnbindTags(instanceId, unbindTagsArgs); err != nil {
    fmt.Println("unbind instance tags failed: ", err)
} else {
    fmt.Println("unbind instance tags success.")
}

查询物理机套餐库存

查询物理机套餐库存

// 套餐id
flavorId := "flavorId"
// 可用区名称
zoneName := "zoneName"

args := &api.CreateInstanceStockArgs{
    FlavorId:     flavorId,
    ZoneName: zoneName,
}
if res, err := bbcClient.GetInstanceCreateStock(args); err != nil {
    fmt.Println("GetInstanceCreateStock failed: ", err)
} else {
    fmt.Println("GetInstanceCreateStock success: ", res)
}

查询物理机套餐价格

套餐询价接口

// 套餐id
flavorId := "flavorId"
// 购买数量
purchaseCount := "purchaseCount"
//价格相关参数
billing: = Billing{
    PaymentTiming: "Prepaid",
    Reservation: Reservation{
    Length: 4,
       },
  },

args := &api.InstancePirceArgs{
    FlavorId:     flavorId,
    PurchaseCount: purchaseCount,
    Billing: billing,
}
if res, err := bbcClient.GetInstancePirce(args); err != nil {
    fmt.Println("GetInstancePirce failed: ", err)
} else {
    fmt.Println("GetInstancePirce success: ", res)
}

物理机额外套餐查询

物理机套餐参数查询接口

// 物理机id
instanceIds := []string{"your-instanceId"}

args := &api.SimpleFlavorArgs{
    InstanceIds:    instanceIds,
}
if res, err := bbcClient.GetSimpleFlavor(args); err != nil {
    fmt.Println("GetSimpleFlavor failed: ", err)
} else {
    fmt.Println("GetSimpleFlavor success: ", res)
}

查询BBC维修任务列表

使用以下代码查询所有未关闭的故障bbc维修任务的列表及详情信息:

listArgs := &ListRepairTaskArgs{
    // 批量获取列表的查询起始位置,是一个由系统产生的字符串
    Marker: "your-marker",
    // 设置返回数据大小,缺省为1000
    MaxKeys: 100,
    // 通过internal Ip过滤维修任务列表
    InstanceId: "your-choose-instance-id",
    // 通过故障名称过滤维修任务列表
    ErrResult: "your-choose-errResult",
}
if res, err := bbcClient.ListRepairTasks(listArgs); err != nil {
    fmt.Println("list tasks failed: ", err)
} else {
    fmt.Println("list tasks success, result: ", res)
}

查询关闭的维修任务列表

使用以下代码查询关闭的任务列表

args := &bbc.ListClosedRepairTaskArgs {
	  // 返回数据大小
      MaxKeys: 100,
    }
if res, err := bbcClient.ListClosedRepairTasks(args); err != nil{
  fmt.Println("Get the closed repaired tasks failed: ", err)
} else {
  fmt.Println("Get the closed repaired tasks success: ", res)
}

查询维修任务详情

使用以下代码可以查询指定BBC维修任务的详细信息:

// 设置你要查询的taskId
taskId := "your-choose-task-id"
if res, err := bbcClient.GetRepairTaskDetail(taskId); err != nil {
    fmt.Println("get task detail failed: ", err)
} else {
    fmt.Println("get task detail success, result: ", res)
}

维修任务授权维修

使用以下代码可以授权指定BBC维修任务,实例状态必须为 unauthorized 或 ignored,调用此接口才可以成功返回,否则提示409错误:

taskIdArgs := &TaskIdArgs{
    // 设置你要操作的taskId
    taskId : "your-choose-task-id",
}
if err := bbcClient.AuthorizeRepairTask(taskIdArgs); err != nil {
    fmt.Println("authorize task failed: ", err)
} else {
    fmt.Println("authorize task success.")
}

维修任务授权维修

使用以下代码可以授权指定BBC维修任务,实例状态必须为 unauthorized 或 ignored,调用此接口才可以成功返回,否则提示409错误:

taskIdArgs := &TaskIdArgs{
    // 设置你要操作的taskId
    taskId : "your-choose-task-id",
}
if err := bbcClient.AuthorizeRepairTask(taskIdArgs); err != nil {
    fmt.Println("authorize task failed: ", err)
} else {
    fmt.Println("authorize task success.")
}

维修任务暂不授权维修

使用以下代码可以暂不授权指定BBC维修任务,实例状态必须为 unauthorized,调用此接口才可以成功返回,否则提示409错误:

taskIdArgs := &TaskIdArgs{
    // 设置你要操作的taskId
    taskId :"your-choose-task-id",
}
if err := bbcClient.UnAuthorizeRepairTask(taskIdArgs); err != nil {
    fmt.Println("unauthorize task failed: ", err)
} else {
    fmt.Println("unauthorize task success.")
}

维修任务确认恢复

使用以下代码可以确认指定BBC维修任务已恢复,实例状态必须为 processing,调用此接口才可以成功返回,否则提示409错误:

taskIdArgs := &TaskIdArgs{
    // 设置你要操作的taskId
    taskId :"your-choose-task-id",
}
if err := bbcClient.ConfirmRepairTask(taskIdArgs); err != nil {
    fmt.Println("confirm task failed: ", err)
} else {
    fmt.Println("confirm task success.")
}

维修任务确认未恢复

使用以下代码可以确认指定BBC维修任务未恢复,实例状态必须为 processing,调用此接口才可以成功返回,否则提示409错误:

taskIdArgs := &TaskIdArgs{
    // 设置你要操作的taskId
    taskId :"your-choose-task-id",
    // 设置你要报修的新故障
    newErrResult :"your-new-errResult",
}
if err := bbcClient.DisconfirmTaskArgs(taskIdArgs); err != nil {
    fmt.Println("disconfirm task failed: ", err)
} else {
    fmt.Println("disconfirm task success.")
}

维修任务操作详情

使用以下代码可以查看指定BBC维修任务操作详情:

taskIdArgs := &TaskIdArgs{
    // 设置你要操作的taskId
    taskId :"your-choose-task-id",
}
if err := bbcClient.GetRepairTaskRecord(taskIdArgs); err != nil {
    fmt.Println("get task record failed: ", err)
} else {
    fmt.Println("get task record success.")
}

查询BBC已完成的维修任务列表

使用以下代码查询所有已关闭的故障bbc维修任务的列表及详情信息:

listArgs := &ListRepairTaskArgs{
    // 批量获取列表的查询起始位置,是一个由系统产生的字符串
    Marker: "your-marker",
    // 设置返回数据大小,缺省为1000
    MaxKeys: 100,
    // 通过internal Ip过滤维修任务列表
    InstanceId: "your-choose-instance-id",
    // 通过故障名称过滤维修任务列表
    ErrResult: "your-choose-errResult",
    // 通过任务id过滤维修任务列表
    TaskId: "your-choose-task-id",
}
if res, err := bbcClient.ListRepairTasks(listArgs); err != nil {
    fmt.Println("list tasks failed: ", err)
} else {
    fmt.Println("list tasks success, result: ", res)
}

获取维修平台预授权规则列表

通过以下代码获取维修平台预授权规则列表

args := &ListRuleArgs{
    // 批量获取列表的查询起始位置,是一个由系统产生的字符串
    Marker:   "your-marker",
    // 设置返回数据大小,缺省为1000
    MaxKeys:   100,
    // 通过rule name筛选规则列表
    RuleName: "your-choose-rule-name",
    // 通过rule id筛选规则列表
    RuleId:   "your-choose-rule-id",
}
if res, err := bbcClient.ListRule(args); err != nil {
    fmt.Println("list rules failed: ", err)
} else {
    fmt.Println("list rules success, result: ", res)
}

获取维修平台预授权规则详情

通过以下代码获取维修平台预授权规则详情

// 设置查询rule id
ruleId := "your-choose-rule-id"
if res, err := bbcClient.GetRuleDetail(ruleId); err != nil {
    fmt.Println("get rule failed: ", err)
} else {
    fmt.Println("get rule success, result: ", res)
}

创建维修平台预授权规则

通过以下代码创建维修平台预授权规则

args := &CreateRuleArgs{
    // 设置规则名称
    RuleName: "your-choose-rule-name",
    // 设置授权上线
    Limit:    2,
    // 规则是否启用,1表示启用,0表示禁用
    Enabled:  1,
    // 设置规则关联标签,tagKey:tagValue
    TagStr:   "tagKey:tagValue",
    // 设置备注
    Extra:    "extra",
}
if res, err := bbcClient.CreateRule(args); err != nil {
    fmt.Println("create rule failed: ", err)
} else {
    fmt.Println("create rule success, result: ", res)
}

删除维修平台预授权规则

  • 规则Enabled时不能删除

通过以下代码删除维修平台预授权规则

args := &DeleteRuleArgs{
    // 设置要删除的rule id
    RuleId: "your-choose-rule-id",
}
if err := bbcClient.DeleteRule(args); err != nil {
    fmt.Println("delete rule failed: ", err)
} else {
    fmt.Println("delete rule success")
}

禁用维修平台预授权规则

通过以下代码禁用维修平台预授权规则

args := &DisableRuleArgs{
    // 设置要禁用的rule id
    RuleId: "your-choose-rule-id",
}
if err := bbcClient.CreateRule(args); err != nil {
    fmt.Println("disable rule failed: ", err)
} else {
    fmt.Println("disable rule success")
}

获取bbc本地盘信息列表

通过以下代码可以分页获取bbc本地盘信息列表

queryArgs := &ListCDSVolumeArgs{
	MaxKeys:    100,
	InstanceId: "InstanceId",
	Marker:     "VolumeId",
	ZoneName:   "zoneName",
}
if res, err := BBC_CLIENT.ListCDSVolume(queryArgs); err != nil {
	fmt.Println("list volume failed: ", err)
} else {
	fmt.Println("list volume success, result: ", res)
}

启用维修平台预授权规则

通过以下代码启用维修平台预授权规则

args := &EnableRuleArgs{
    // 设置要启用的rule id
    RuleId: "your-choose-rule-id",
}
if err := bbcClient.EnableRule(args); err != nil {
    fmt.Println("enable rule failed: ", err)
} else {
    fmt.Println("enable rule success")
}

获取基于部署集粒度的bbc资源余量

通过以下代码可以分页获取基于部署集粒度的bbc资源余量。由于bbc现只支持单部署集创建,要求部署集参数传一个。

queryArgs := &GetBbcStockArgs{
		Flavor:     "BBC-S3-02",
		DeploySetIds: []string{"dset-0RHZYUfF"},
	}
if res, err := BBC_CLIENT.GetBbcStockWithDeploySet(queryArgs); err != nil {
		fmt.Println("get bbc stock failed: ", err)
} else {
	fmt.Println("list volume success, result: ", res)
}