Kafka 公开API目录

API概览

Kafka产品提供以下相关API接口。

实例

API 描述
GetKafkaList 获取Kafka实例列表

访问地址

地区 访问地址
中国大陆 cdsapi.capitalonline.net
亚太地区 cdsapi-asia.capitalonline.net
欧美地区 cdsapi-us.capitalonline.net

1.GetKafkaList

Action: GetKafkaList

描述: 获取Kafka实例列表

请求地址: cdsapi.capitalonline.net/kafka

请求方法: POST

请求参数:

参数名 必选 类型 说明
RegionId string 站点编号
VdcId string 数据中心的编号
ProjectId string 项目编号
InstanceId list 目标实例编号列表

请求示例:

  1. def get_kafka_list():
  2. """
  3. 获取Kafka实例列表
  4. """
  5. action = "GetKafkaList"
  6. method = "POST"
  7. param = {
  8. }
  9. url = get_signature(action, self.AK, self.AccessKeySecret, method, self.KafkaUrl, param)
  10. body = {
  11. "ProjectId": "b9661xxx-59fe-11eb-b7e7-46d055d59xxx",
  12. "RegionId": "APAC_Singapore_D",
  13. "InstanceId": ["94c08xxx-6095-11eb-b408-0242ac11xxxx"]
  14. }
  15. res = requests.post(url, json=body)
  16. print(res.content)
  17. result = json.loads(res.content)
  18. print(result)

返回示例:

  1. {
  2. "Code": "Success",
  3. "Data": [
  4. {
  5. "CreateTime": "2021-03-05 15:22:48",
  6. "DiskSize": 100,
  7. "DiskType": "ssd_disk",
  8. "Endpoint": "xxxxxx1.kafka.yun-paas.com.:9093,xxxxxxxx2.kafka.yun-paas.com.:9093,xxxxxxxx3.kafka.yun-paas.com.:9093",
  9. "ExpiredTime": "2099-01-01T00:00:00Z",
  10. "InstanceDeployType": "公网",
  11. "InstanceId": "968f8714-7d83-11eb-8946-xxxxxxxxxx",
  12. "InstanceName": "Test",
  13. "IopsPkg": "1个",
  14. "KafkaSpec": "4C8G",
  15. "KafkaVersion": "v2.2.0",
  16. "MsgRetain": "24小时",
  17. "NodeNumber": 3,
  18. "NodesList": [
  19. {
  20. "BrokerId": 1,
  21. "CreateTime": "2021-03-05 15:22:48",
  22. "NodeId": "0322b342-5ec3-4511-9397-xxxxxxxxxx",
  23. "NodeSpec": "4C8G",
  24. "NodeStatus": "run",
  25. "PrivateIP": "10.240.xx.xx",
  26. "UpdateTime": "2021-03-05 15:27:26"
  27. },
  28. {
  29. "BrokerId": 2,
  30. "CreateTime": "2021-03-05 15:22:48",
  31. "NodeId": "1865d66b-c84d-4b87-bcfa-xxxxxxxxxx",
  32. "NodeSpec": "4C8G",
  33. "NodeStatus": "run",
  34. "PrivateIP": "10.240.xx.xx",
  35. "UpdateTime": "2021-03-05 15:27:26"
  36. },
  37. {
  38. "BrokerId": 3,
  39. "CreateTime": "2021-03-05 15:22:48",
  40. "NodeId": "9be45f93-6818-4ed1-bad9-xxxxxxxxxx",
  41. "NodeSpec": "4C8G",
  42. "NodeStatus": "run",
  43. "PrivateIP": "10.240.xx.xx",
  44. "UpdateTime": "2021-03-05 15:27:26"
  45. }
  46. ],
  47. "PayType": "按需",
  48. "RegionId": "CN_Guangzhou_A",
  49. "RegionName": "中国大陆-广州-可用区A",
  50. "ServiceStatus": "run",
  51. "UpdateTime": "2021-03-05 15:27:26",
  52. "VdcId": "4538821a-5bea-42be-b255-xxxxxxxxxx",
  53. "VdcName": "TestGuangZhou"
  54. }
  55. ],
  56. "Message": "获取kafka集群列表成功!"
  57. }

返回参数说明:

参数名 类型 说明
Code string 状态码
Data dict 数据
CreateTime string 创建时间
DiskSize int 磁盘大小
DiskType string 磁盘类型
Endpoint string 链接地址
ExpiredTime string 过期时间
InstanceId string 实例ID
InstanceName string 名称
IopsPkg string IO增强包数量
KafkaSpec string 实例规格
KafkaVersion string 实例版本
MsgRetain string 消息保留时长
NodeNumber string 节点数量
NodesList list 节点列表
BrokerId int Broker ID
NodeId string 节点ID
NodeSpec string 节点规格
NodeStatus string 节点状态
PrivateIP string 节点内网IP
UpdateTime string 更新时间
PayType string 计费类型:按需,包年包月
RegionId string 可用区ID
RegionName string 可用区名称
ServiceStatus string 实例状态
VdcId string VDC ID
VdcName string VDC名称
Message string 信息描述

状态码说明: | 错误码 | 错误信息 | 说明 | | :—————- | :—- | ——————————————————————— | | 20001 | 参数错误 | 请确认VDC信息 |