获取机器信息

最近更新时间: 2026-09-17 00:02:44

1. 接口描述

接口请求域名： cwp.api3.fincloud.tencent.cn。

获取机器信息

默认接口请求频率限制：20次/秒。

接口更新时间：0001-01-01 00:00:00。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeMachineInfoByHashKey
Version	是	否	String	公共参数，本接口取值：2018-02-28
Region	是	否	String	公共参数，地域信息本接口不需要传递此参数。
MachineKey	否	否	String	主机HashKey 示例值： 539844622

3. 输出参数

参数名称	类型	描述
HostIp	String	内网IP 示例值： 10.0.0.11
InstanceId	String	实例ID 示例值： ins-dsdbhjqf
InstanceName	String	实例名示例值： redis_node_cvm
Quuid	String	主机Quuid 示例值： acdd5474-6360-4fd4-bfc7-843162cb8116
Region	String	地域示例值： ap-region1
Uuid	String	主机uuid 示例值： acdd5474-6360-4fd4-bfc7-843162cb8116
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InternalError	内部错误。
MissingParameter	缺少参数错误。
ResourceNotFound	资源不存在。
InvalidParameter	参数错误。
OperationDenied	操作被拒绝。
InvalidParameterValue	参数取值错误。

5. 示例

示例1 succ

输入示例

POST / HTTP/1.1
Host: cwp.api3.fincloud.tencent.cn
Content-Type: application/json
X-TC-Action: DescribeMachineInfoByHashKey
<Public request parameters>

{"MachineKey":"fc702c8398071ea3697d449c2b894dae"}

输出示例

{
 "Response": {
  "HostIp": "10.1.1.1",
  "InstanceId": "ins-dgdsgh",
  "InstanceName": "testafet",
  "Quuid": "acdd5474-6360-4fd4-bfc7-843162cb8116",
  "Region": "ap-region1",
  "RequestId": "fc702c8398071ea3697d449c2b894dae",
  "Uuid": "acdd5474-6360-4fd4-bfc7-843162cb8116"
 }
}