企业版实例
更新时间：2025-05-26
查询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实例列表。
Plain Text
1args := &ListInstancesArgs{
2 KeywordType: "clusterName",
3 Keyword: "",
4 PageNo: 1,
5 PageSize: 10,
6}
7resp, err := ccrClient.ListInstances(args)响应示例
Plain Text
1{
2 "total": 1,
3 "pageNo": 1,
4 "pageSize": 10,
5 "instances": [
6 {
7 "id": "ccr-4k74gw7d",
8 "instanceType": "BASIC",
9 "name": "demo-instance",
10 "status": "running",
11 "createTime": "2022-07-25T19:28:45+08:00",
12 "region": "bd",
13 "publicURL": "ccr-4k74gw7d-pub.cnc.bd.baidubce.com"
14 "tags":[
15 {
16 "tagKey":"key",
17 "tagValue":"value"
18 }
19 ]
20 }
21 ]
22}查询单个CCR实例详情
接口描述
查询某CCR实例详情信息。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| bucket | String | bos bucket |
| region | String | 地域 |
| info | Instance | 实例详情 |
| statistic | InstanceStatistic | 实例统计 |
| quota | InstanceQuota | 实例限额 |
请求示例
使用以下代码查询该实例详情。
Plain Text
1instanceId := "ccr-4k74gw7d"
2resp, err := ccrClient.GetInstanceDetail(instanceId)响应示例
Plain Text
1{
2 "info": {
3 "id": "ccr-4k74gw7d",
4 "instanceType": "BASIC",
5 "name": "demo-instance",
6 "status": "running",
7 "createTime": "2022-07-25T19:28:45+08:00",
8 "region": "",
9 "publicURL": "ccr-4k74gw7d-pub.cnc.bd.baidubce.com"
10 "tags":[
11 {
12 "tagKey":"key",
13 "tagValue":"value"
14 }
15 ]
16 },
17 "statistic": {
18 "repo": 6,
19 "chart": 0,
20 "namespace": 6,
21 "storage": 79026796
22 },
23 "quota": {
24 "repo": 1000,
25 "chart": 1000,
26 "namespace": 50
27 },
28 "bucket": "ccr-4k74gw7d",
29 "region": "bd"
30}更改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 | 标签信息 |
请求示例
使用以下代码更改实例信息。
Plain Text
1args := &UpdateInstanceArgs{
2 Name: "InstanceName",
3}
4instanceId := "ccr-4k74gw7d"
5resp, err := ccrClient.UpdateInstance(instanceId, args)响应示例
Plain Text
1{
2 "id": "ccr-4k74gw7d",
3 "instanceType": "BASIC",
4 "name": "demo-instance",
5 "status": "running",
6 "createTime": "2022-07-25T19:28:45+08:00",
7 "region": "bd",
8 "publicURL": "ccr-4k74gw7d-pub.cnc.bd.baidubce.com"
9 "tags": [
10 {
11 "tagKey":"tagKey",
12 "tagValue":"tagValue"
13 }
14}更改CCR实例标签
接口描述
更改CCR企业版实例标签。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| tags | List<LogicalTag> | 是 | Body参数 | 标签键值对信息 |
响应参数
无
请求示例
使用以下代码更改CCR企业版实例标签。
Plain Text
1args := &AssignTagsRequest{
2 Tags: []Tag{
3 {
4 TagKey: "key1",
5 TagValue: "value1",
6 },
7 },
8}
9instanceId := "ccr-4k74gw7d"
10err := ccrClient.AssignInstanceTag(instanceId, args)