实例操作
更新时间：2025-08-21
创建实例
描述
创建一个实例，要求名称不能和同Region内现有任何一个Instance重名，限制字符个数3-255，满足正则：[a-zA-Z_][a-za-z0-9\_]{2,254}。 实例名称不能包含 [‘baidu’, ‘bidu’, ‘bce’, ‘bts’] 这几个单词，不能以‘__’（两个下划线）开头。
请求参数
| 参数 | 参数类型 | 说明 |
|---|---|---|
| storage_type | String | 该Instance下表的默认存储类型 |
返回参数
无
示例
Plain Text
1if __name__ == "__main__":
2 client = BtsClient(bts_sample_conf.config)
3 instance_name = b'instance1'
4 createInstanceArgs = CreateInstanceArgs('CommonPerformance')
5 response = client.create_instance(instance_name, createInstanceArgs)
6 print(response)删除实例
描述
删除一个实例，要求实例下不存在任何表，否则删除失败。删除实例是一个同步操作过程，一旦返回成功，实例将不复存在。
请求参数
无
返回参数
无
示例
Plain Text
1if __name__ == "__main__":
2 client = BtsClient(bts_sample_conf.config)
3 instance_name = b'instance2'
4 response = client.drop_instance(instance_name)
5 print(response)列举实例
描述
列出账户一个Region内创建的所有实例。
请求参数
无
返回参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| instances | List | 实例列表 |
| +id | String | 实例ID |
| +name | String | 实例名称 |
| +region | String | 所属百度智能云region |
| +state | String | instance当前状态，目前只有Normal状态： - Normal：instance处于正常状态 |
| +create_time | String | instance创建的UTC时间 |
| +storage_type | String | 该Instance下表的默认存储类型，可取以下值： HighPerformance：SSD存储 CommonPerformance：SATA存储 |
示例
Plain Text
1if __name__ == "__main__":
2 client = BtsClient(bts_sample_conf.config)
3 response = client.list_instances()
4 print(response)显示实例信息
描述
显示指定实例信息。
请求参数 无
返回参数
| 参数名称 | 参数类型 | 说明 |
|---|---|---|
| id | String | 实例ID |
| name | String | 实例名称 |
| region | String | 所属百度智能云region |
| state | String | instance当前状态，目前只有Normal状态： - Normal：instance处于正常状态 |
| create_time | String | instance创建的UTC时间 |
| storage_type | String | 该Instance下表的默认存储类型，可取以下值： HighPerformance：SSD存储 CommonPerformance：SATA存储 |
示例
Plain Text
1if __name__ == "__main__":
2 client = BtsClient(bts_sample_conf.config)
3 instance_name = b'instance1'
4 response = client.show_instance(instance_name)
5 print(response)