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分钟

说明：

Credentials字段使用auth.NewBceCredentials与auth.NewSessionBceCredentials函数创建，默认使用前者. 后者为使用STS鉴权时使用
SignOption字段为生成签名字符串时的选项，详见下表说明：

名称	类型	含义
HeadersToSign	map[string]struct{}	生成签名字符串时使用的HTTP头
Timestamp	int64	生成的签名字符串中使用的时间戳，默认使用请求发送时的值
ExpireSeconds	int	签名字符串的有效期

 其中，HeadersToSign默认为`Host`，`Content-Type`，`Content-Length`，`Content-MD5`；TimeStamp一般为零值，表示使用调用生成认证字符串时的时间戳，用户一般不应该明确指定该字段的值；ExpireSeconds默认为1800秒即30分钟。

Retry字段指定重试策略，目前支持两种：NoRetryPolicy和BackOffRetryPolicy。默认使用后者，该重试策略是指定最大重试次数、最长重试时间和重试基数，按照重试基数乘以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"
    // 设置创建BCC使用的企业安全组，不允许同时设置企业安全组和普通安全组
    EnterpriseSecurityGroupId:  "enterpriseSecurityGroupId"
    // 使用 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
    // 启用后主网卡新增ip地址为ipv6，请确认子网已分配IPv6网段，默认false
    AllocateMultiIpv6Addr false
    // 幂等性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)
}

Files

BBC.md

Latest commit

History

BBC.md

File metadata and controls

BBC服务

概述

初始化

确认Endpoint

获取密钥

新建BBC Client

使用AK/SK新建BBC Client

配置HTTPS协议访问BBC

设置网络参数

配置生成签名字符串选项

主要接口

实例

创建实例

查询实例列表

查询实例详情

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

启动实例

停止实例

重启实例

修改实例名称

修改实例描述

实例变更子网

修改实例VPC

重装实例

批量重装实例

实例续费

释放实例

释放实例（包含预付费实例）

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

查询回收站实例列表

释放回收站实例

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

修改实例密码

查询实例VNC地址

查询实例VPC/Subnet信息

智能卡实例绑定安全组

智能卡实例解绑安全组

批量增加辅助IP

批量删除指定实例的ip

开通自动续费（包含关联产品）

关闭自动续费（包含关联产品）

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

标签

实例解绑标签

套餐

查询套餐列表

查询套餐详情

查询RAID详情

查询套餐支持的可用区

查询可用区支持的套餐

镜像

通过实例创建自定义镜像

查询镜像列表

查询镜像详情

删除自定义镜像

获取套餐的公共镜像

获取套餐的自定义镜像

共享自定义镜像

取消共享自定义镜像

跨区域复制自定义镜像

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

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

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

操作日志

查询操作日志

部署集

创建部署集

查询部署集列表

查询部署集列表

查询部署集详情

删除指定的部署集

实例绑定标签

实例解绑标签

查询物理机套餐库存