获取分布式数据库UDDB的详细信息-DescribeUDDBInstance

获取分布式数据库UDDB的详细信息

Request Parameters

Parameter nameTypeDescriptionRequired
Regionstring地域。 参见 地域和可用区列表Yes
Zonestring可用区。参见 可用区列表Yes
UDDBIdstringUDDB实例IDYes

Response Elements

Parameter nameTypeDescriptionRequired
RetCodeint操作返回码Yes
Actionstring操作名称Yes
Messagestring如果执行失败, 失败的错误消息No
DataSetarrayUDDB实例信息列表, 参见DataSetUDDB项定义No

DataSetUDDB

Parameter nameTypeDescriptionRequired
ZonestringUDDB实例对应的可用区No
UDDBIdstringUDDB实例IDNo
NamestringUDDB实例名称No
DBTypeIdstringUDDB的数据库版本No
AdminUserstring管理员帐户名,默认rootNo
VirtualIPstringUDDB实例访问的虚IPNo
PortstringUDDB实例访问的端口号No
StatestringUDDB状态, 状态列表如下: Init: 初始化中 InitFail: 初始化失败 Starting: 启动中 Running: 系统正常运行中 Abnormal: 系统运行中, 有异常, 还能提供服务 Error: 系统运行中, 但不能正常提供服务 Shutdown: 关闭中 Shutoff: 已关闭 Deleted: 已删除 UpgradingUDDB: 升降级UDDB配置中 UpgradingDataNode: 升降级UDDB节点配置中 ChangingSlaveCount: 改变只读实例数量中 ScalingOutUDDB: 水平扩展中No
CreateTimestringUDDB实例创建时间,采用UTC计时时间戳No
ExpiredTimestringUDDB实例过期时间,采用UTC计时时间戳No
ChargeTypestring付费类型,可选值如下: Year: 按年付费 Month: 按月付费 Dynamic: 按需付费(单位: 小时) Trial: 免费试用No
RouterVersionstringUDDB路由节点的版本。分为三种: Trival(免费版): 2中间件节点; QPS:1.5W FellFree(标准版): 固定为4中间件节点,后续将根据业务请求量自动扩展,最多扩展到12个节点,QPS为3w - 10w; EnjoyAlone(物理机版):专享物理机,节点数让客户可选No
RouterNodeNumint各版本下的节点个数。体验版: 固定为2节点; 畅享版:固定为4节点(后续可通过管理API调整);专享版:物理机台数No
RefQpsint参考QPS。 免费版: 15000; 畅享版: 30000 - 100000 (根据节点数而定); 专享版: 节点数 * 10w qpsNo
DataNodeCountstring数据节点个数No
DataNodeMemorystring数据节点的内存配置, 单位:MBNo
DataNodeDiskSpacestring数据节点的磁盘大小配置. 单位: GBNo
DataNodeSlaveCountstring每个数据节点的只读实例个数.No
DataNodeListarrayUDDB实例的数据节点的信息列表No
InstanceModestring存储节点的高可用模式, 分为高可用UDB(HA)和普通UDB(Normal),如果不填, 则默认为HANo
InstanceTypestring存储节点和只读实例的磁盘类型。分为:SSD磁盘(SATA_SSD)或普通磁盘(Normal)。 如果不填,则默认为SATA_SSDNo

DataNodeInfo

Parameter nameTypeDescriptionRequired
Idstring数据节点IDNo
Memorystring数据节点的内存配置, 单位:MBNo
DiskSpacestring数据节点的磁盘大小配置. 单位: GBNo
SlaveCountstring数据节点的只读实例个数.No
Statestring数据分片状态, 状态列表如下: Init: 初始化中 Fail: 安装失败 Starting: 启动中 Running: 系统正常运行中 Shutdown: 关闭中 Shutoff: 已关闭 Deleted: 已删除 Upgrading: 系统升级中No
SlaveInfosarray只读实例信息列表No
LastTransTaskIdstring最近一次数据迁移任务idNo
CreateTimestring节点的创建时间No

SlaveInfo

Parameter nameTypeDescriptionRequired
Idstring只读实例IDNo
DataNodeIdstring对应数据节点的IDNo
Statestring只读实例状态, 状态列表如下: Init: 初始化中 Fail: 安装失败 Starting: 启动中 Running: 系统正常运行中 Shutdown: 关闭中 Shutoff: 已关闭 Deleted: 已删除 Upgrading: 系统升级中No

Request Example

https://api.ucloud.cn/?Action=DescribeUDDBInstance
&Region=cn-zj
&Zone=cn-zj-01
&UDDBId=SyzHzCdW

Response Example

{
    "Action": "DescribeUDBInstanceResponse",
    "RetCode": 0,
    "DataSet": {
        "DBTypeId": "mysql-5.6",
        "DataNodeDiskSpace": 100,
        "DataNodeMemory": 6000,
        "AdminUser": "root",
        "CPUCores": 4,
        "DataNodeList": [
            {
                "DiskSpace": 50,
                "SlaveCount": 1,
                "State": "Running",
                "Memory": 3000,
                "Id": "uddbnode-mst001",
                "SlaveInfos": [
                    {
                        "DataNodeId": "uddbnode-mst001",
                        "State": "Running",
                        "Id": "uddbnode-slv001"
                    }
                ]
            },
            {
                "DiskSpace": 50,
                "SlaveCount": 1,
                "State": "Running",
                "Memory": 3000,
                "Id": "uddbnode-mst002",
                "SlaveInfos": [
                    {
                        "DataNodeId": "uddbnode-mst002",
                        "State": "Running",
                        "Id": "uddbnode-slv002"
                    }
                ]
            }
        ],
        "DBId": "udb-abcdef",
        "VirtualIP": "10.19.123.123",
        "InstanceMode": "HA",
        "State": "Running",
        "ExpiredTime": 1501516800,
        "DataNodeCount": 2,
        "CreateTime": 1403249482,
        "Memory": 8000,
        "DataNodeSlaveCount": 1,
        "Port": 3306,
        "InstanceType": "SATA_SSD",
        "Name": "my_test_uddb1"
    }
}