查询指定实例 - ShowInstance
功能介绍
通过实例ID查询实例的详细信息。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
dcs:instance:get
Read
instance *
g:EnterpriseProjectId
-
-
URI
GET /v2/{project_id}/instances/{instance_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
instance_id |
是 |
String |
参数解释: 实例ID。可通过DCS控制台进入实例详情界面查看。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
project_id |
是 |
String |
参数解释: 项目ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
请求参数
无
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
vpc_name |
String |
参数解释: VPC的名称。 取值范围: 不涉及。 |
|
charging_mode |
Integer |
参数解释: 付费模式。 取值范围:
|
|
vpc_id |
String |
参数解释: Redis缓存实例所在的虚拟私有云ID。 取值范围: 不涉及。 |
|
user_name |
String |
参数解释: 实例所在的用户名。 取值范围: 不涉及。 |
|
created_at |
String |
参数解释: 完成创建时间。格式为:2017-03-31T12:24:46.297Z。 取值范围: 不涉及。 |
|
description |
String |
参数解释: 实例描述。 取值范围: 不涉及。 |
|
security_group_id |
String |
参数解释: Redis缓存实例绑定的安全组ID。 取值范围: 不涉及。 |
|
security_group_name |
String |
参数解释: 租户安全组名称。 取值范围: 不涉及。 |
|
max_memory |
Integer |
参数解释: 总内存,单位:MB。 取值范围: 不涉及。 |
|
used_memory |
Integer |
参数解释: 已使用的内存,单位:MB。 取值范围: 不涉及。 |
|
capacity |
Integer |
参数解释: 缓存实例的容量,单位:GB。 取值范围: 不涉及。 |
|
capacity_minor |
String |
参数解释: 小于1GB规格缓存实例的容量,单位:GB。 取值范围: 不涉及。 |
|
maintain_begin |
String |
参数解释: 维护时间窗开始时间,为UTC时间,格式为HH:mm:ss。 取值范围: 不涉及。 |
|
maintain_end |
String |
参数解释: 维护时间窗结束时间,为UTC时间,格式为HH:mm:ss。 取值范围: 不涉及。 |
|
engine |
String |
参数解释: 缓存实例的引擎类型。 取值范围: 不涉及。 |
|
no_password_access |
String |
参数解释: 是否允许免密码访问缓存实例。 取值范围:
|
|
ip |
String |
参数解释: 连接缓存实例的IP地址。如果是集群实例,返回多个IP地址,使用逗号分隔。如:192.168.0.1,192.168.0.2。 取值范围: 不涉及。 |
|
instance_backup_policy |
InstanceBackupPolicy object |
参数解释: 备份策略,实例类型为主备、读写分离和集群时支持。 取值范围: 不涉及。 |
|
az_codes |
Array of strings |
参数解释: 实例所在的可用区。返回"可用区Code"。 取值范围: 不涉及。 |
|
available_zones |
Array of strings |
参数解释: 实例所在的可用区ID。返回"可用区ID"。 取值范围: 不涉及。 |
|
access_user |
String |
参数解释: 通过密码认证访问缓存实例的认证用户名。 取值范围: 不涉及。 |
|
instance_id |
String |
参数解释: 实例ID。 取值范围: 不涉及。 |
|
port |
Integer |
参数解释: 连接缓存实例的端口号。 取值范围: 不涉及。 |
|
user_id |
String |
参数解释: 实例所在的用户ID。 取值范围: 不涉及。 |
|
name |
String |
参数解释: 实例名称。 取值范围: 不涉及。 |
|
spec_code |
String |
参数解释: 产品规格编码。 取值范围: 不涉及。 |
|
subnet_id |
String |
参数解释: Redis缓存实例绑定的子网ID。 取值范围: 不涉及。 |
|
subnet_name |
String |
参数解释: 子网名称。 取值范围: 不涉及。 |
|
subnet_cidr |
String |
参数解释: 子网网段。 取值范围: 不涉及。 |
|
engine_version |
String |
参数解释: 缓存版本。 取值范围: Redis缓存引擎的取值范围如下:
当缓存引擎为Memcached时,取值为空。 |
|
order_id |
String |
参数解释: 订单ID。 取值范围: 不涉及。 |
|
status |
String |
参数解释: 缓存实例的状态。 取值范围: 详细状态说明见缓存实例状态说明。 |
|
domain_name |
String |
参数解释: 实例的域名。 取值范围: 不涉及。 |
|
readonly_domain_name |
String |
参数解释: 实例的只读域名,只有主备实例有该字段。 取值范围: 不涉及。 |
|
enable_publicip |
Boolean |
参数解释: Redis 3.0缓存实例是否开启公网访问功能。 取值范围:
|
|
publicip_id |
String |
参数解释: Redis缓存实例绑定的弹性IP地址的ID。 如果未开启公网访问功能,该字段值为null。 取值范围: 不涉及。 |
|
publicip_address |
String |
参数解释: Redis缓存实例绑定的弹性IP地址。 如果未开启公网访问功能,该字段值为null。 取值范围: 不涉及。 |
|
enable_ssl |
Boolean |
参数解释: Redis缓存实例开启公网访问功能时,是否选择支持SSL。 取值范围:
|
|
service_upgrade |
Boolean |
参数解释: 实例是否存在升级任务。 取值范围:
|
|
service_task_id |
String |
参数解释: 升级任务的ID。
取值范围: 不涉及。 |
|
enterprise_project_id |
String |
参数解释: 企业项目ID。 取值范围: 不涉及。 |
|
backend_addrs |
String |
参数解释: 集群实例的后端服务地址。 取值范围: 不涉及。 |
|
features |
Features object |
参数解释: 实例支持特性。 取值范围: 不涉及。 |
|
domain_name_info |
DomainNameInfo object |
参数解释: 实例域名重建、公网解析操作相关信息。 取值范围: 不涉及。 |
|
transparent_client_ip_enable |
Boolean |
参数解释: 是否开启客户端IP透传。 取值范围: 不涉及。 |
|
sub_status |
String |
参数解释: 实例子状态。 取值范围: 不涉及。 |
|
tags |
Array of ResourceTags objects |
参数解释: 实例标签键值。 取值范围: 不涉及。 |
|
cpu_type |
String |
参数解释: 实例CPU类型。 取值范围:
|
|
enterprise_project_name |
String |
参数解释: 企业项目名称。 取值范围: 不涉及。 |
|
update_at |
String |
参数解释: 更新时间,形如2022-07-06T09:32:16.502Z。 取值范围: 不涉及。 |
|
product_type |
String |
参数解释: 产品类型。 取值范围:
|
|
storage_type |
String |
参数解释: 存储类型。 取值范围: 内存存储。 |
|
launched_at |
String |
参数解释: 启动时间,形如2022-07-06T09:32:16.502Z。 取值范围: 不涉及。 |
|
cache_mode |
String |
参数解释: 缓存实例类型。 取值范围:
|
|
support_slow_log_flag |
String |
参数解释: 是否支持慢日志。 取值范围:
|
|
db_number |
Integer |
参数解释: 数据库数量。 取值范围: 不涉及。 |
|
replica_count |
Integer |
参数解释: 副本数。 取值范围: 不涉及。 |
|
sharding_count |
Integer |
参数解释: 集群实例分片个数。 取值范围: 不涉及。 |
|
bandwidth_info |
BandwidthInfo object |
参数解释: 带宽信息。 取值范围: 不涉及。 |
|
cloud_service_type_code |
String |
参数解释: 云服务类型编码。 取值范围: 不涉及。 |
|
cloud_resource_type_code |
String |
参数解释: 云资源类型编码。 取值范围: 不涉及。 |
|
inquery_spec_code |
String |
参数解释: 运营系统中的规格编码。 取值范围: 不涉及。 |
|
free |
String |
参数解释: 该参数与if_free相同,未启用,返回null。 取值范围: 不涉及。 |
|
is_free |
String |
参数解释: 该参数未启用,返回null。 取值范围: 不涉及。 |
|
libos |
String |
参数解释: 该参数未启用,返回false。 取值范围: 不涉及。 |
|
crr_role |
String |
参数解释: 该参数未启用,返回null。 取值范围: 不涉及。 |
|
active_active |
ActiveActiveInfo object |
参数解释: 实例AA多活特性,该参数未启用,返回null。 取值范围: 不涉及。 |
|
task |
AnyType |
参数解释: 实例当前任务。 取值范围: 不涉及。 |
|
proxy_links |
Array of ProxyLink objects |
参数解释: 实例proxy节点连接情况,该参数未启用,返回null。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
backup_policy_id |
String |
参数解释: 备份策略ID。 取值范围: 不涉及。 |
|
created_at |
String |
参数解释: 创建时间。格式为:2022-04-11T09:45:24.790Z。 取值范围: 不涉及。 |
|
updated_at |
String |
参数解释: 更新时间。格式为:2022-04-12T02:22:03.269Z。 取值范围: 不涉及。 |
|
policy |
BackupPolicyResp object |
参数解释: 备份策略。 取值范围: 不涉及。 |
|
tenant_id |
String |
参数解释: 租户ID。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
backup_type |
String |
参数解释: 备份类型。 取值范围:
|
|
save_days |
Integer |
参数解释: 保留天数,单位:天。由自动备份切换为手动备份时,保留自动备份策略信息。 取值范围: 1-7 |
|
periodical_backup_plan |
BackupPlan object |
参数解释: 备份计划。由自动备份切换为手动备份时,保留自动备份策略信息。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
timezone_offset |
String |
参数解释: 备份的时区。该参数已废弃,没有实际作用。 取值范围: 不涉及。 |
|
backup_at |
Array of integers |
参数解释: 每周的周几开始备份。由自动切换为手动时,保留自动备份策略信息。 取值范围: 1-7,分别表示星期一到星期日。 |
|
period_type |
String |
参数解释: 备份周期类型,目前支持“weekly”。由自动切换为手动时,保留自动备份策略信息。 取值范围: 不涉及。 |
|
begin_at |
String |
参数解释: 备份开始执行时间,该时间为UTC时间,例如“00:00-01:00”代表UTC时间0点开始执行备份。只能是整点时间段,间隔时间限定为一个小时。由自动切换为手动时,保留自动备份策略信息。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
support_acl |
Boolean |
参数解释: 实例是否支持ACL。 取值范围:
|
|
support_transparent_client_ip |
Boolean |
参数解释: 实例是否支持客户端IP透传。 取值范围:
|
|
support_ssl |
Boolean |
参数解释: 实例是否支持SSL。 取值范围:
|
|
support_acl_read_policy |
Boolean |
参数解释: 实例是否支持ACL只读路由策略。 取值范围:
|
|
support_audit_log |
Boolean |
参数解释: 实例是否支持审计日志。 取值范围:
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
support_public_resolve |
Boolean |
参数解释: 是否开启公网域名解析。 取值范围:
|
|
is_latest_rules |
Boolean |
参数解释: 当前域名是否已为最新。 取值范围:
|
|
zone_name |
String |
参数解释: 域名的区域后缀。 取值范围: 不涉及。 |
|
history_domain_names |
Array of DomainNameEntity objects |
参数解释: 历史域名信息。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
domain_name |
String |
参数解释: 实例历史域名。 取值范围: 不涉及。 |
|
is_readonly |
Boolean |
参数解释: 是否只读域名。 取值范围:
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
begin_time |
Long |
参数解释: 临时扩容开始时间。 取值范围: 不涉及。 |
|
end_time |
Long |
参数解释: 临时扩容结束时间。 取值范围: 不涉及。 |
|
current_time |
Long |
参数解释: 当前时间。 取值范围: 不涉及。 |
|
bandwidth |
Integer |
参数解释: 当前带宽值,单位为Mbit/s。 取值范围: 不涉及。 |
|
next_expand_time |
Long |
参数解释: 下一个扩容时间。 取值范围: 不涉及。 |
|
expand_count |
Integer |
参数解释: 扩容数量。 取值范围: 不涉及。 |
|
expand_effect_time |
Long |
参数解释: 临时扩容时间间隔。 取值范围: 不涉及。 |
|
expand_interval_time |
Long |
参数解释: 下一次可以扩容间隔时间。 取值范围: 不涉及。 |
|
max_expand_count |
Integer |
参数解释: 最大扩容数量。 取值范围: 不涉及。 |
|
task_running |
Boolean |
参数解释: 任务是否运行。 取值范围: 不涉及。 |
|
assured_bandwidth |
Integer |
参数解释: 实例基准带宽,单位:Mbit/s。 取值范围: 不涉及。 |
|
max_bandwidth_for_node |
Integer |
参数解释: 节点最大带宽,单位:Mbit/s。 取值范围: 不涉及。 |
请求示例
GET https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}
响应示例
状态码:200
查询指定实例成功。
{
"publicip_id" : null,
"vpc_name" : "dcs-beta",
"charging_mode" : 0,
"enterprise_project_name" : "default",
"vpc_id" : "5e37b3be-950a-48e1-b498-65b63d336481",
"user_name" : "clouduser",
"created_at" : "2022-08-29T08:53:47.319Z",
"description" : null,
"cache_mode" : "ha",
"security_group_id" : "securityGroupId",
"enable_ssl" : false,
"max_memory" : 128,
"publicip_address" : null,
"capacity" : 0,
"maintain_begin" : "18:00:00",
"engine" : "Redis",
"maintain_end" : "19:00:00",
"capacity_minor" : ".125",
"service_upgrade" : false,
"subnet_name" : "dcs-beta",
"no_password_access" : "true",
"service_task_id" : null,
"ip" : "192.168.0.251",
"subnet_cidr" : "192.168.0.0/24",
"used_memory" : 2,
"security_group_name" : "securityGroupId",
"instance_backup_policy" : null,
"az_codes" : [ "xx-xxxxx-xx" ],
"available_zones" : [ "d539378ec1314c85b76fefa3f7071458" ],
"access_user" : null,
"enterprise_project_id" : "0",
"instance_id" : "a4c545cd-10b2-4efc-b0ab-a9b554ca0621",
"enable_publicip" : false,
"port" : 6379,
"user_id" : "d53977d1adfb49c5b025ba7d33a13fd7",
"domain_name" : "redis-a4c545cd-10b2-4efc-b0ab-a9b554ca0621.dcs.example.com",
"name" : "dcs-billing",
"spec_code" : "redis.ha.xu1.tiny.r2.128",
"subnet_id" : "a4112635-3ec0-471c-95c3-5cf49b9533af",
"engine_version" : "5.0",
"order_id" : null,
"status" : "RUNNING",
"features" : {
"support_acl" : true,
"support_transparent_client_ip" : true,
"support_ssl" : false,
"support_audit_log" : false
},
"domain_name_info" : {
"support_public_resolve" : true,
"is_latest_rules" : true,
"zone_name" : "dcs.example.com",
"history_domain_names" : null
},
"transparent_client_ip_enable" : true,
"sub_status" : "normal",
"cpu_type" : "x86_64",
"cloud_service_type_code" : "hws.service.type.dcs",
"cloud_resource_type_code" : "hws.resource.type.dcs3",
"inquery_spec_code" : "redis.ha.xu1.tiny.r2.128",
"free" : null,
"is_free" : null,
"libos" : false,
"crr_role" : null,
"active_active" : null,
"task" : "EXTENDING",
"proxy_links" : null
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询指定实例成功。 |
|
400 |
非法请求。 |
|
500 |
内部服务错误。 |
错误码
请参见错误码。