更新时间:2024-11-26 GMT+08:00

查询指定实例

功能介绍

通过实例ID查询实例的详细信息。

URI

GET /v1.0/{project_id}/instances/{instance_id}

参数说明见表1
表1 参数说明

参数

类型

必选

说明

project_id

String

项目ID。获取方式,参考获取项目ID

instance_id

String

待查询的实例ID。

请求消息

请求参数

无。

请求示例

请求URL:

GET https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}

响应消息

响应参数

参数说明见表2

表2 参数说明

参数

类型

说明

name

String

实例名称。

engine

String

缓存实例的引擎类型。

capacity

Integer

缓存实例的容量(G Byte)。

ip

String

连接缓存实例的IP地址。如果是集群实例,返回多个IP地址,使用逗号分隔。如:192.168.0.1,192.168.0.2。

domainName

String

实例的域名。

port

Integer

缓存的端口。

status

String

缓存实例的状态。详细状态说明见缓存实例状态说明

libos

Boolean

  • true:该实例是libos实例。
  • false:该实例不是libos实例。

description

String

实例描述。

max_memory

Integer

总内存,单位:MB。

used_memory

Integer

已使用的内存,单位:MB。

instance_id

String

实例ID。

resource_spec_code

String

资源规格标识。

例如:

  • dcs.single_node:表示实例类型为单机。
  • dcs.master_standby:表示实例类型为主备。
  • dcs.cluster:表示实例类型为集群。

更多规格标识可查看 《分布式缓存服务用户指南》的“实例规格”章节,查找到对应的“产品规格编码”列。

engine_version

String

缓存版本。

internal_version

String

DCS内部版本号。

charging_mode

Integer

收费模式,0表示不计费。

capacity_minor

String

单机小规格的缓存容量。

vpc_id

String

VPC ID。

vpc_name

String

VPC的名称。

created_at

String

完成创建时间。格式为:2017-03-31T12:24:46.297Z。

error_code

String

实例创建失败或状态异常时的错误码,错误码说明见错误码

user_id

String

用户ID。

user_name

String

用户名。

maintain_begin

String

维护时间窗开始时间,格式为hh:mm:ss。

maintain_end

String

维护时间窗结束时间,格式为hh:mm:ss。

product_type

String

Redis缓存实例的产品类型。支持以下两种类型:

  • generic:表示标准版。
  • libos:表示高性能版。

cpu_type

String

CPU架构类型。支持x86_64和aarch_64。

storage_type

String

存储类型,支持DRAM和SCM。

cache_mode

String

缓存实例类型。取值范围如下:

  • single:表示单机
  • ha:表示主备实例
  • cluster:表示集群
  • proxy:表示Proxy集群

launched_at

String

实例运行时间的时间戳。

available_zones

Array

实例节点所在的可用区。返回“可用区ID”。

subnet_id

String

子网ID。

security_group_id

String

安全组ID。

cloud_service_type_code

String

云服务类型编码。

cloud_resource_type_code

String

云资源类型编码。

product_id

String

产品标识。

security_group_name

String

租户安全组名称。

subnet_name

String

子网名称。

subnet_cidr

String

子网网段。

order_id

String

订单ID。

instance_backup_policy

Object

备份策略,实例类型为主备和集群时支持。详情参考表3

表3 instance_backup_policy

参数

类型

说明

backup_policy_id

String

备份策略ID。

created_at

String

创建时间。

updated_at

String

更新时间。

policy

Object

详情参考表3表4

tenant_id

String

租户ID。

响应示例

{
    "name" : "dcs-a11e",
    "engine" : "Redis",
    "capacity" : 2,
    "ip" : "192.168.3.100",
    "port" : 6379,
    "status" : "RUNNING",
    "description" : "Create a instance",
    "instance_id" : "68d5745e-6af2-40e4-945d-fe449be00148",
    "resource_spec_code" : "dcs.single_node",
    "engine_version" : "3.0",
    "internal_version" : null,
    "charging_mode" : 0,
    "vpc_id" : "27d99e17-42f2-4751-818f-5c8c6c03ff15",
    "vpc_name" : "vpc_4944a40e-ac57-4f08-9d38-9786e2759458_192",
    "created_at" : "2017-03-31T12:24:46.297Z",
    "error_code" : null,
    "product_id" : "XXXXXX",
    "security_group_id" : "60ea2db8-1a51-4ab6-9e11-65b418c24583",
    "security_group_name" : "sg_6379_4944a40e-ac57-4f08-9d38-9786e2759458",
    "subnet_id" : "ec2f34b9-20eb-4872-85bd-bea9fc943128",
    "subnet_name" : "subnet_az_7f336767-10ec-48a5-9ae8-9cacde119318",
    "available_zones" : "XXXXXX",
    "max_memory" : 460,
    "used_memory" : 56,
    "user_id": "6d0977e4c9b74ae7b5a083a8d0d8fafa",
    "user_name": "user",
    "order_id": "XXXXXXXXX",
    "maintain_begin" : "22:00:00",
    "maintain_end" : "02:00:00"
}

状态码

操作成功的状态码如表4所示,其他响应见表1

表4 状态码

状态码

描述

200

查询指定实例成功。