企业版实例
更新时间：2024-06-18
创建CCR实例
接口描述
创建一个CCR企业版实例。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| name | String | 是 | Body参数 | 实例名称 |
| type | String | 是 | Body参数 | 实例类型，取值范围：BASIC、STANDARD、ADVANCED，分别表示基础版、标准版、高级版 |
| bucket | String | 否 | Body参数 | bos bucket，默认会在用户账号下自动创建出bos bucket |
| tags | List<LogicalTag> | 否 | Body参数 | 待创建的标签键值对列表 |
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| instanceID | String | 实例ID |
请求示例
使用以下代码创建一个企业版CCR实例。
billing := Billing{
ReservationTimeUnit: "MONTH",
ReservationTime: 1,
AutoRenew: false,
AutoRenewTimeUnit: "MONTH",
AutoRenewTime: 1,
}
args := &CreateInstanceArgs{
Type: "BASIC",
Name: "instanceName",
Bucket: "",
PaymentTiming: "prepay",
Billing: billing,
PaymentMethod: []PaymentMethod{},
Tags: []Tag{},
}
resp, err := ccrClient.CreateInstance(args)响应示例
{
"instanceID": "ccr-4k74gw7d"
}列举CCR实例
接口描述
列举CCR实例列表。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| pageNo | Integer | 否 | Query参数 | 当前页 |
| pageSize | Integer | 否 | Query参数 | 每页记录数，默认10 |
| keywordType | String | 否 | Query参数 | 关键字类型，取值范围：id、name，分别表示按实例ID查询、或按实例名称查询 |
| keyword | String | 否 | Query参数 | 关键字 |
| acrossregion | String | 否 | Query参数 | 是否在全区域内搜索,取值范围：true、false，默认为false |
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| total | Integer | 记录总数 |
| pageNo | Integer | 当前页 |
| pageSize | Integer | 每页记录数 |
| instances | List<Instance> | 结果列表 |
请求示例
使用以下代码查询CCR实例列表。
args := &ListInstancesArgs{
KeywordType: "clusterName",
Keyword: "",
PageNo: 1,
PageSize: 10,
}
resp, err := ccrClient.ListInstances(args)响应示例
{
"total": 1,
"pageNo": 1,
"pageSize": 10,
"instances": [
{
"id": "ccr-4k74gw7d",
"instanceType": "BASIC",
"name": "demo-instance",
"status": "running",
"createTime": "2022-07-25T19:28:45+08:00",
"region": "bd",
"publicURL": "ccr-4k74gw7d-pub.cnc.bd.baidubce.com"
"tags":[
{
"tagKey":"key",
"tagValue":"value"
}
]
}
]
}查询单个CCR实例详情
接口描述
查询某CCR实例详情信息。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| bucket | String | bos bucket |
| region | String | 地域 |
| info | Instance | 实例详情 |
| statistic | InstanceStatistic | 实例统计 |
| quota | InstanceQuota | 实例限额 |
请求示例
使用以下代码查询该实例详情。
instanceId := "ccr-4k74gw7d"
resp, err := ccrClient.GetInstanceDetail(instanceId)响应示例
{
"info": {
"id": "ccr-4k74gw7d",
"instanceType": "BASIC",
"name": "demo-instance",
"status": "running",
"createTime": "2022-07-25T19:28:45+08:00",
"region": "",
"publicURL": "ccr-4k74gw7d-pub.cnc.bd.baidubce.com"
"tags":[
{
"tagKey":"key",
"tagValue":"value"
}
]
},
"statistic": {
"repo": 6,
"chart": 0,
"namespace": 6,
"storage": 79026796
},
"quota": {
"repo": 1000,
"chart": 1000,
"namespace": 50
},
"bucket": "ccr-4k74gw7d",
"region": "bd"
}更改CCR实例信息
接口描述
更改CCR实例信息。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| name | String | 是 | Body参数 | 实例名称 |
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 实例ID |
| name | String | 实例名称 |
| instanceType | String | 实例类型 |
| publicURL | String | 公共访问地址 |
| region | String | 地域 |
| status | String | 实例状态 |
| createTime | String | 创建时间 |
| tags | LogicalTag | 标签信息 |
请求示例
使用以下代码更改实例信息。
args := &UpdateInstanceArgs{
Name: "InstanceName",
}
instanceId := "ccr-4k74gw7d"
resp, err := ccrClient.UpdateInstance(instanceId, args)响应示例
{
"id": "ccr-4k74gw7d",
"instanceType": "BASIC",
"name": "demo-instance",
"status": "running",
"createTime": "2022-07-25T19:28:45+08:00",
"region": "bd",
"publicURL": "ccr-4k74gw7d-pub.cnc.bd.baidubce.com"
"tags": [
{
"tagKey":"tagKey",
"tagValue":"tagValue"
}
}升级CCR实例
接口描述
升级CCR企业版实例规格。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| type | String | 是 | Body参数 | 实例类型，可取值有STANDARD、ADVANCED，分别表示标准版、高级版 |
响应参数
无
请求示例
使用以下代码升级CCR企业版实例规格。
args := &UpgradeInstanceArgs{
Type: "STANDARD",
PaymentMethod: []PaymentMethod{},
}
instanceId := "ccr-4k74gw7d"
resp, err := ccrClient.UpgradeInstance(instanceId, args)更改CCR实例标签
接口描述
更改CCR企业版实例标签。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| tags | List<LogicalTag> | 是 | Body参数 | 标签键值对信息 |
响应参数
无
请求示例
使用以下代码更改CCR企业版实例标签。
args := &AssignTagsRequest{
Tags: []Tag{
{
TagKey: "key1",
TagValue: "value1",
},
},
}
instanceId := "ccr-4k74gw7d"
err := ccrClient.AssignInstanceTag(instanceId, args)