DescribeDBInstanceAttribute - 查询实例详情

更新时间:

查询AnalyticDB PostgreSQL版实例详情。

接口说明

使用说明

本接口一般用于查看 AnalyticDB PostgreSQL 版实例的规格、网络类型、实例状态等信息。

QPS 限制

本接口的单用户 QPS 限制默认为 1000 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。

本文档中的 QPS 仅为默认参考值,准确信息请参见 API 速率配额列表

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ResourceGroupIdstring

该参数已废弃,无需传入该参数。

null
DBInstanceIdstring

实例 ID。

说明 您可以调用 DescribeDBInstances 接口查看目标地域下所有的 AnalyticDB PostgreSQL 实例的实例 ID。
gp-bp13ue79qk8y1****

返回参数

名称类型描述示例值
object
Itemsarray<object>

实例详情列表。

DBInstanceAttributeobject

详情。

AvailabilityValuestring

查询当前实例可用性状态,单位:百分比(%)。

说明 该参数仅适用存储预留模式的实例。
100.0%
ConnectionModestring

访问模式,取值说明:

  • Performance:标准访问模式。
  • Safty:高安全访问模式。
  • LVS:LVS 链路模式。
LVS
ConnectionStringstring

实例连接地址。

gp-bp13ue79qk8y1****-master.gpdb.rds.aliyuncs.com
CoreVersionstring

内核小版本号。

mm.v6.3.10.1-202207141918
CpuCoresinteger

计算节点 CPU 核数,单位 Core。

2
CpuCoresPerNodeinteger

单节点的 CPU 核数。

说明 该参数仅适用存储预留模式的实例。
0
CreationTimestring

实例创建时间。

2022-08-11T09:16:26Z
DBInstanceCategorystring

实例系列,取值说明:

  • Basic:基础版。
  • HighAvailability:高可用版。
HighAvailability
DBInstanceClassstring

实例规格。

说明 该参数仅适用存储预留模式的实例。
gpdb.group.segsdx1
DBInstanceClassTypestring

实例规格族,取值说明:

  • s:共享型。
  • x:通用型。
  • d:独享套餐。
  • h:独占物理机。
x
DBInstanceCpuCoresinteger

CPU 核数。

2
DBInstanceDescriptionstring

实例描述。

gp-bp13ue79qk8y1****
DBInstanceDiskMBPSlong

计算组最大的 BPS(磁盘吞吐量),单位:Mbps。

说明 该参数仅适用存储预留模式的实例。
0
DBInstanceGroupCountstring

计算组数量。

说明 该参数仅适用存储预留模式的实例。
0
DBInstanceIdstring

实例 ID。

gp-bp13ue79qk8y1****
DBInstanceMemorylong

计算节点的内存。

说明 存储预留模式的单位为 MB;Serverless 和存储弹性模式单位为 GB。
16
DBInstanceModestring

实例资源类型,取值说明:

  • Serverless:Serverless 模式。
  • StorageElastic:存储弹性模式。
  • Classic:存储预留模式。
StorageElastic
DBInstanceNetTypestring

该参数已废弃,不会返回参数值。

null
DBInstanceStatusstring

实例状态,详细说明请参见 DBInstanceStatus 参数补充说明。

Running
DBInstanceStoragelong

单个副本的最大存储空间,单位:GB。

50
DeployModestring

部署模式

single
EncryptionKeystring

加密密钥。

说明 仅开启云盘加密的实例会返回该参数。
0d2470df-da7b-4786-b981-************
EncryptionTypestring

加密类型,取值说明:

  • CloudDisk:云盘加密。
说明 仅云盘加密的实例会返回该参数。
CloudDisk
Enginestring

数据库引擎。

gpdb
EngineVersionstring

数据库版本。

6.0
ExpireTimestring

实例到期时间(UTC 时间)。

说明 按量付费实例的到期时间为2999-09-08T16:00:00Z
2999-09-08T16:00:00Z
HostTypestring

计算组机器类型,取值说明:

  • 0:SSD
  • 1:HDD
说明 该参数仅适用存储预留模式的实例。
0
IdleTimeinteger

空闲释放等待时长。单位为秒。

说明 仅 Serverless 自动调度模式实例返回该参数。
600
InstanceNetworkTypestring

实例网络类型,取值说明:

  • Classic:经典网络。
  • VPC:VPC 网络。
VPC
LockModestring

锁定方式,取值说明:

  • Unlock:正常 。
  • ManualLock:手动触发锁定。
  • LockByExpiration:实例过期自动锁定。
  • LockByRestoration:实例回滚前的自动锁定。
  • LockByDiskQuota:实例空间满自动锁定。
Unlock
LockReasonstring

该参数已废弃,故不会返回参数值。

null
MaintainEndTimestring

可维护结束时间。

22:00Z
MaintainStartTimestring

可维护开始时间。

18:00Z
MasterCUinteger

Master 资源。

4
MasterNodeNuminteger

Master 节点数量。

1
MaxConnectionsinteger

实例的最大并发连接数。

说明 该参数仅适用存储预留模式的实例。
500
MemoryPerNodeinteger

单副本的内存大小,单位请参见 MemoryUnit 参数。

说明 该参数仅适用存储预留模式的实例。
0
MemorySizelong

计算节点内存大小。

说明 存储预留模式的单位为 MB;Serverless 和存储弹性模式单位为 GB。
16
MemoryUnitstring

内存单位。

说明 该参数仅适用存储预留模式的实例。
GB
MinorVersionstring

内核小版本。

6.3.10.1-202207141918
PayTypestring

计费类型,取值说明:

  • Postpaid:按量付费。
  • Prepaid:包年包月。
Postpaid
Portstring

实例的端口号。

5432
ProdTypestring

产品类型

standard
ReadDelayTimestring

该参数已废弃,故不会返回参数值。

null
RegionIdstring

地域 ID。

cn-hangzhou
ResourceGroupIdstring

实例所在的资源组 ID。

rg-bp67acfmxazb4p****
RunningTimestring

实例运行时长。

4 days 22:58:55
SecurityIPListstring

该参数已废弃,不会返回参数值。

null
SegDiskPerformanceLevelstring

性能级别 PL(Performance Level),目前仅支持 PL1

PL1
SegNodeNuminteger

Segment 节点数量。

说明 该参数仅适用存储弹性模式和 Serverless 手动调度模式的实例。
4
SegmentCountsinteger

计算组个数。

说明 该参数仅适用存储预留模式的实例。
0
ServerlessModestring

Serverless 实例的模式,取值如下:

  • Manual:手动调度。
  • Auto:自动调度。
说明 仅 Serverless 模式实例返回该参数。
Auto
ServerlessResourceinteger

计算资源阈值。单位为 ACU。

说明 仅 Serverless 自动调度模式实例返回该参数。
32
StandbyZoneIdstring

备可用区 ID

cn-hangzhou-i
StartTimestring

实例开始运行的时间。

2022-08-11T09:26:43Z
StoragePerNodeinteger

单副本的存储大小,单位请参见 StorageUnit 参数。

说明 该参数仅适用存储预留模式的实例。
0
StorageSizelong

存储空间大小,单位 GB。

50
StorageTypestring

存储类型,取值说明:

  • cloud_essd:ESSD 云盘。
  • cloud_efficiency:高效云盘。
说明 该参数仅适用存储弹性模式的实例。
cloud_essd
StorageUnitstring

存储单位,取值说明:

  • GB SSD
  • TB SSD
  • GB HDD
说明 该参数仅适用存储预留模式的实例。
GB SSD
SupportRestoreboolean

是否支持备份恢复,取值说明:

  • true:支持备份恢复。
  • false:不支持备份恢复。
true
Tagsarray<object>

标记键值对。

Tagobject

标签详情如下。

Keystring

标签键。

test-key
Valuestring

标签值。

test-value
VSwitchIdstring

vSwitch ID。

vsw-bp1cpq8mr64paltkb****
VectorConfigurationStatusstring

是否开启向量引擎优化,取值说明:

  • enabled:表示开启向量引擎优化。
  • disabled:表示已关闭向量引擎优化。
enabled
VpcIdstring

VPC ID。

vpc-bp19ame5m1r3oejns****
ZoneIdstring

可用区 ID。

cn-hangzhou-j
RequestIdstring

请求 ID。

5E6EDEB8-D73E-5F2D-B948-86C8AEB05A68

DBInstanceStatus 参数补充说明

DBInstanceStatus 取值如下:

  • Creating:创建中。
  • Running:使用中。
  • Deleting:删除中。
  • Rebooting:重启中。
  • DBInstanceClassChanging:升降级中。
  • Transfering:迁移中。
  • EngineVersionUpgrading:迁移版本中。
  • TransferingToOtherInstance:迁移数据到其他 AnalyticDB for PostgreSQL 中。
  • GuardDBInstanceCreating:创建灾备实例中。
  • Restoring:备份恢复中。
  • Importing:数据导入中。
  • ImportingFromOtherInstance:从其他 AnalyticDB for PostgreSQL 实例导入数据中。
  • DBInstanceNetTypeChangin:内外网切换中。
  • GuardSwitching:容灾切换中。

示例

正常返回示例

JSON格式

{
  "Items": {
    "DBInstanceAttribute": [
      {
        "AvailabilityValue": "100.0%",
        "ConnectionMode": "LVS",
        "ConnectionString": "gp-bp13ue79qk8y1****-master.gpdb.rds.aliyuncs.com",
        "CoreVersion": "mm.v6.3.10.1-202207141918",
        "CpuCores": 2,
        "CpuCoresPerNode": 0,
        "CreationTime": "2022-08-11T09:16:26Z",
        "DBInstanceCategory": "HighAvailability",
        "DBInstanceClass": "gpdb.group.segsdx1",
        "DBInstanceClassType": "x",
        "DBInstanceCpuCores": 2,
        "DBInstanceDescription": "gp-bp13ue79qk8y1****",
        "DBInstanceDiskMBPS": 0,
        "DBInstanceGroupCount": "0",
        "DBInstanceId": "gp-bp13ue79qk8y1****",
        "DBInstanceMemory": 16,
        "DBInstanceMode": "StorageElastic",
        "DBInstanceNetType": "null",
        "DBInstanceStatus": "Running",
        "DBInstanceStorage": 50,
        "DeployMode": "single",
        "EncryptionKey": "0d2470df-da7b-4786-b981-************",
        "EncryptionType": "CloudDisk",
        "Engine": "gpdb",
        "EngineVersion": "6.0",
        "ExpireTime": "2999-09-08T16:00:00Z",
        "HostType": "0",
        "IdleTime": 600,
        "InstanceNetworkType": "VPC",
        "LockMode": "Unlock",
        "LockReason": "null",
        "MaintainEndTime": "22:00Z",
        "MaintainStartTime": "18:00Z",
        "MasterCU": 4,
        "MasterNodeNum": 1,
        "MaxConnections": 500,
        "MemoryPerNode": 0,
        "MemorySize": 16,
        "MemoryUnit": "GB",
        "MinorVersion": "6.3.10.1-202207141918",
        "PayType": "Postpaid",
        "Port": "5432",
        "ProdType": "standard",
        "ReadDelayTime": "null",
        "RegionId": "cn-hangzhou",
        "ResourceGroupId": "rg-bp67acfmxazb4p****",
        "RunningTime": "4 days 22:58:55",
        "SecurityIPList": "null",
        "SegDiskPerformanceLevel": "PL1",
        "SegNodeNum": 4,
        "SegmentCounts": 0,
        "ServerlessMode": "Auto",
        "ServerlessResource": 32,
        "StandbyZoneId": "cn-hangzhou-i",
        "StartTime": "2022-08-11T09:26:43Z",
        "StoragePerNode": 0,
        "StorageSize": 50,
        "StorageType": "cloud_essd",
        "StorageUnit": "GB SSD",
        "SupportRestore": true,
        "Tags": {
          "Tag": [
            {
              "Key": "test-key",
              "Value": "test-value"
            }
          ]
        },
        "VSwitchId": "vsw-bp1cpq8mr64paltkb****",
        "VectorConfigurationStatus": "enabled",
        "VpcId": "vpc-bp19ame5m1r3oejns****",
        "ZoneId": "cn-hangzhou-j"
      }
    ]
  },
  "RequestId": "5E6EDEB8-D73E-5F2D-B948-86C8AEB05A68"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-10-11OpenAPI 返回结构发生变更查看变更详情
2024-01-04OpenAPI 返回结构发生变更查看变更详情
2023-08-17OpenAPI 返回结构发生变更查看变更详情
2023-05-23OpenAPI 返回结构发生变更查看变更详情