Memcached 公开API目录

API概览

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

实例

API 描述
CreateMemcachedInstance 创建一台或多台按需计费的memcached的机器
MemcachedInstanceList 获取memcached数据库实例列表页
DescribeMemcachedInstance 获取memcached数据库实例详情页
DeleteMemcachedInstance 删除memcached数据库实例
ClearMemcachedInstance 清空memcached数据库实例
UpdateMemcachedInstance 更新memcached数据库实例配置

访问地址

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

1.CreateMemcachedInstance

Action:CreateMemcached

描述 创建一台或多台按需计费的memcached的机器。

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

请求方法:POST

请求参数:

名称 类型 是否必选 示例 描述
InstanceName String test memcached实例名称
ConfSize String 1G memcached配置大小 可选大小1G-10G
VdcId string a58052bf-3bfc-4d0c-a3a5-0bcca72589f5 虚拟数据中心id
PipeId string 48de2f3c-b3df-11ec-8bed-e6717c813be8 虚拟数据中心网段主键ID
Amount int 1 创建的数据 可选1-10
RegionId string CN_Beijing_H 区域id

代码调用示例:

  1. def create_memcached_instance(ConfSize, VdcId, PipeId, RegionId, InstanceName="", Amount=1):
  2. action = "CreateMemcachedInstance"
  3. method = "POST"
  4. url = get_signature(action, AK, AccessKeySecret, method, CCS_URL, param={})
  5. body = {"ConfSize": ConfSize,
  6. "VdcId": VdcId,
  7. "PipeId": PipeId,
  8. "RegionId": RegionId}
  9. if InstanceName:
  10. body["InstanceName"] = InstanceName
  11. if Amount:
  12. body["Amount"] = Amount
  13. res = requests.post(url, json=body)
  14. result = json.loads(res.content)
  15. return result

返回示例:

  1. {
  2. "Code":"Success",
  3. "Data":{
  4. "InstanceIds":[
  5. "4e3bb828-c6a4-11ec-95eb-b2d9e44608b0"
  6. ],
  7. "TaskIds":[
  8. 915
  9. ]
  10. },
  11. "Message":"任务下发成功!"
  12. }

返回参数:

名称 类型 示例值 描述
Code string 0000 错误码
message string 任务下发成功! 任务信息
InstanceIds List [‘285656f8-c547-11ec-8cc4-4279b2da6491’] 实例id
TaskIds list [857] 任务id

错误码:

httpcode 错误码 错误信息 描述
20001 参数错误 参数缺失,conf_size,site_id ,app_id, pipe_id为必传参数 请求参数错误

2.MemcachedInstanceList

Action:MemcachedInstanceList

描述 获取memcached数据库实例列表页。

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

请求方法:POST

请求参数:

名称 类型 是否必选 示例 描述
VdcId string a58052bf-3bfc-4d0c-a3a5-0bcca72589f5 虚拟数据中心id
Keyword string Test 关键字查询,可以查ip,实例名称和实例id

代码调用示例:

  1. def memcached_instance_list(VdcId="", Keyword=""):
  2. action = "MemcachedInstanceList"
  3. method = "POST"
  4. url = get_signature(action, AK, AccessKeySecret, method, CCS_URL, param={})
  5. body = {}
  6. if VdcId:
  7. body["VdcId"] = VdcId
  8. if Keyword:
  9. body["Keyword"] = Keyword
  10. res = requests.post(url, json=body)
  11. result = json.loads(res.content)
  12. return result

返回示例:

  1. {
  2. "Code":"Success",
  3. "Data":{
  4. "CreatingTotal":0,
  5. "DeletingTotal":0,
  6. "ErrorTotal":0,
  7. "InstanceList":[
  8. {
  9. "Address":"10.240.166.8",
  10. "AppName":"wx-memcache",
  11. "BillMethod":"0",
  12. "ConfName":"Memcached单机版",
  13. "CreateTime":"2022-04-27 18:13:30",
  14. "InstanceConf":"1G",
  15. "InstanceId":"439b83f4-c612-11ec-95eb-b2d9e44608b0",
  16. "InstanceName":"api测试11-pre",
  17. "Port":"11211",
  18. "SiteName":"中国大陆-北京-可用区H",
  19. "Status":"running",
  20. "UpdateTime":"2022-04-27 18:10:28",
  21. "Version":"Memcached1.6"
  22. }
  23. ],
  24. "RunningTotal":1,
  25. "Total":1,
  26. "UpdatingTotal":0
  27. },
  28. "Message":"获取memcached列表成功!"
  29. }

返回参数:

名称 类型 示例值 描述
CreatingTotal Int 0 创建中实例的数量
DeletingTotal Int 0 删除中实例的数量
ErrorTotal Int 0 错误实例的数量
RunningTotal Int 0 运行中实例的数量
Total Int 0 实例的总数量
UpdatingTotal Int 0 更新中实例的总数量
SiteName string 亚太地区-中国香港-可用区B 节点信息
AppName string memcached服务端测试 vdc名称
InstanceId string 4733bae6-bc84-11ec-8ced-acde48001122 实例id
InstanceName string zn-test 实例名称
CreateTime string 2022-04-15 13:21:25 创建时间
UpdateTime string 2022-04-15 14:21:25 更新时间
BillMethod string 0 计费方式
Status string running 实例状态
Version string Memcached1.6 版本
ConfName string Memcached单机版 配置信息
Address string 10.240.12.29 内网地址
Port int 11211 端口
InstanceConf string 1G 实例配置

错误码:

httpcode 错误码 错误信息 描述
20001 参数错误 customer_id和user_id为必传参数 请求参数错误

3.DescribeMemcachedInstance

Action:DescribeMemcachedInstance

描述 获取memcached数据库实例详情页。

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

请求方法:POST

请求参数:

名称 类型 是否必选 示例 描述
InstanceId string a58052bf-3bfc-4d0c-a3a5-0bcca72589f5 实例id

代码调用示例:

  1. def describe_memcached_instance(InstanceId=""):
  2. action = "DescribeMemcachedInstance"
  3. method = "POST"
  4. url = get_signature(action, AK, AccessKeySecret, method, CCS_URL, param={})
  5. body = {"InstanceId": InstanceId}
  6. res = requests.post(url, json=body)
  7. result = json.loads(res.content)
  8. return result

返回示例:

  1. {
  2. "Code":"Success",
  3. "Data":{
  4. "Address":"10.240.166.7",
  5. "AppName":"wx-memcache",
  6. "BillMethod":"0",
  7. "Coon":10000,
  8. "CreateTime":"2022-04-27 10:31:39",
  9. "GoodsId":"17129",
  10. "InstanceConf":"2G",
  11. "InstanceId":"d37e3944-c5d1-11ec-b023-d21e41ec5741",
  12. "InstanceName":"api测试11-pre",
  13. "Port":"11211",
  14. "RunningTime":"0个月1天1小时1分47秒",
  15. "SiteId":"CN_Beijing_H",
  16. "SiteName":"中国大陆-北京-可用区H",
  17. "Status":"running",
  18. "Version":"Memcached1.6"
  19. },
  20. "Message":"获取Memcached详情成功!"
  21. }

返回参数:

名称 类型 示例值 描述
SiteName string 亚太地区-中国香港-可用区B 节点信息
SiteId String CN_Beijing_H 地域id
AppName string memcached服务端测试 vdc名称
InstanceId string 4733bae6-bc84-11ec-8ced-acde48001122 实例id
InstanceName string zn-test 实例名称
CreateTime string 2022-04-15 13:21:25 创建时间
update_time string 2022-04-15 14:21:25 更新时间
BillMethod string 0 计费方式
Status string running 实例状态
Version string Memcached1.6 版本
conf_name string Memcached单机版 配置信息
Address string 10.240.12.29 内网地址
Port int 11211 端口
InstanceConf string 1G 实例配置
Coon int 10000 最大连接数
RunningTime string 0个月2天0小时0分15秒 运行时间
GoodsId string 6055 商品id

错误码:

httpcode 错误码 错误信息 描述
20001 参数错误 customer_id和user_id为必传参数 请求参数错误

4.DeleteMemcachedInstance

Action:DeleteMemcachedInstance

描述 删除memcached数据库实例。

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

请求方法:POST

请求参数:

名称 类型 是否必选 示例 描述
InstanceId string a58052bf-3bfc-4d0c-a3a5-0bcca72589f5 实例id

代码调用示例:

  1. def delete_memcached_instance(InstanceId):
  2. action = "DeleteMemcachedInstance"
  3. method = "POST"
  4. url = get_signature(action, AK, AccessKeySecret, method, CCS_URL, param={})
  5. body = {"InstanceId": InstanceId}
  6. res = requests.post(url, json=body)
  7. result = json.loads(res.content)
  8. return result

返回示例:

  1. {
  2. "Code":"Success",
  3. "Data":{
  4. "TaskId":918
  5. },
  6. "Message":"删除实例任务下发成功!"
  7. }

返回参数:

名称 类型 示例值 描述
Code string 0000 错误码
Message string 任务下发成功! 任务信息
TaskId int 889 任务id

错误码:

httpcode 错误码 错误信息 描述
20001 参数错误 customer_id和user_id为必传参数 请求参数错误

5.ClearMemcachedInstance

Action:ClearMemcachedInstance

描述 清空memcached数据库实例。

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

请求方法:POST

请求参数:

名称 类型 是否必选 示例 描述
InstanceId string a58052bf-3bfc-4d0c-a3a5-0bcca72589f5 实例id

代码调用示例:

  1. def clear_memcached_instance(InstanceId):
  2. action = "ClearMemcachedInstance"
  3. method = "POST"
  4. url = get_signature(action, AK, AccessKeySecret, method, CCS_URL, param={})
  5. body = {"InstanceId": InstanceId}
  6. res = requests.post(url, json=body)
  7. result = json.loads(res.content)
  8. return result

返回示例:

  1. {
  2. "Code":"Success",
  3. "Data":{
  4. "TaskId":917
  5. },
  6. "Message":"清空memcached的数据信息成功"
  7. }

返回参数:

名称 类型 示例值 描述
Code string 0000 错误码
Message string 任务下发成功! 任务信息
TaskId Int 888 任务id

错误码:

httpcode 错误码 错误信息 描述
20001 参数错误 customer_id和user_id为必传参数 请求参数错误

6.UpdateMemcachedInstance

Action:UpdateMemcachedInstance

描述 更新memcached数据库实例配置。

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

请求方法:POST

请求参数:

名称 类型 是否必选 示例 描述
InstanceId string a58052bf-3bfc-4d0c-a3a5-0bcca72589f5 实例id
ConfSize string 2G 实例配置大小

代码调用示例:

  1. def UpdateMemcachedInstance(InstanceId, ConfSize):
  2. action = "UpdateMemcachedInstance"
  3. method = "POST"
  4. url = get_signature(action, AK, AccessKeySecret, method, CCS_URL, param={})
  5. body = {"InstanceId": InstanceId, "ConfSize": ConfSize}
  6. res = requests.post(url, json=body)
  7. result = json.loads(res.content)
  8. return result

返回示例:

  1. {
  2. "Code":"Success",
  3. "Data":{
  4. "TaskId":916
  5. },
  6. "Message":"清空memcached的数据信息成功"
  7. }

返回参数:

名称 类型 示例值 描述
Code string 0000 错误码
Message string 任务下发成功! 任务信息
TaskId int 885 任务id

错误码:

httpcode 错误码 错误信息 描述
20001 参数错误 customer_id和user_id为必传参数 请求参数错误