查询微服务详情

最近更新时间: 2026-10-11 00:12:04

1. 接口描述

接口请求域名： tsf.api3.fincloud.tencent.com。

查询微服务详情

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

接口更新时间：2025-08-06 23:23:55。

接口只验签名不鉴权。

2. 输入参数

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

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeMicroservice
Version	是	否	String	公共参数，本接口取值：2018-03-26
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
MicroserviceId	是	否	String	微服务ID 示例值：
Offset	否	否	Int64	偏移量示例值：
Limit	否	否	Int64	分页个数示例值：
GroupIds	否	否	Array of String	可选，根据部署组ID进行过滤示例值：
Filters	否	否	Array of Filter	过滤条件。多个 filter 之间是与关系，单个 filter 多个 value 之间是或关系。filter name 取值有：id（实例id）、name（实例名）、lan-ip（内网ip）、node-ip（所在节点ip）示例值：查看

3. 输出参数

参数名称	类型	描述
Result	TsfPageMsInstance	微服务详情实例列表示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码	描述
FailedOperation.ServiceQueryFailed	服务查询失败。
ResourceNotFound.ServiceNotExist	无法获取服务，无法执行该操作。
UnauthorizedOperation.NoPrivilege	用户无权限访问该接口。。
FailedOperation.GroupQueryFaild	部署组查询失败。
FailedOperation.TsfPrivilegeError	TSF权限模块异常，请联系系统管理员。。
InternalError.CloudApiProxyError	TSF云API请求调用失败。
InternalError.UnhandledException	[%s]模块未处理异常。。
MissingParameter.ServiceIdRequired	未填写服务Id。
ResourceNotFound.MicroserviceOffline	目标微服务已离线[%s]。。
UnauthorizedOperation.NoLicense	缺少License。。
FailedOperation.UnhandledException	模块未处理异常。

5. 示例

示例1 查询微服务实例详情

输入示例

POST / HTTP/1.1
Host: tsf.api3.fincloud.tencent.com
Content-Type: application/json
X-TC-Action: DescribeMicroservice
<Common Parameters>

{
  "MicroserviceId": "ms-a78gk87b",
  "Offset": 0,
  "Limit": 10,
  "GroupIds": [
    "group-yx87px4a"
  ],
  "Filters": [
    {
      "Name": "LanIp",
      "Values": [
        "172.16.16.139"
      ]
    }
  ]
}

输出示例

{
  "Response": {
    "RequestId": "80479d6c-27db-4d6c-b5f0-5ec576d2105f",
    "Result": {
      "Content": [
        {
          "AppMicroServiceType": "G",
          "ApplicationId": "application-ydopqnxa",
          "ApplicationName": "app-gw",
          "ApplicationPackageVersion": "20241223011040",
          "ApplicationType": "V",
          "ClusterId": "cluster-2vz3nd3a",
          "ClusterName": "cls_name",
          "ClusterType": "V",
          "GroupId": "group-yx87px4a",
          "GroupName": "zuul-2",
          "HealthCheckUrl": null,
          "HiddenStatus": "unhidden",
          "InstanceAvailableStatus": null,
          "InstanceId": "ins-7wy598p8",
          "InstanceName": "app22",
          "InstanceStatus": null,
          "LanIp": "172.16.16.139",
          "LastHeartbeatTime": 1734943598,
          "MetaJson": "H4sIAAAAAAAAAGXQUU+DMBQF4P/SZ7tAh2nxjUDHiFtpWmbiXki3EUaibdmGgsb/LpPOmPh8vntycj9BIRdlxPkqi6Miy1mZJeABKGtfmr26NEbD4WBsq3sF7n5sLOgEi2xNR+rjeUAIxgFxIBX5hk819cl0Fg49wbYPbgUZkwWLYjqRRp8hfh/uQ2JvBSxaU8l/hVav1dmqfQVbtcO7Nnz754pnfp2S0IWLuMjT8okKOQ4dA+ShwEdo7vm+F3jOCJpOqbKw7pSuP46mc5lMHv+c+zMUzpAHl6a/jA9ZNvWxOkFBVzSS1F1sc3adAL6+AZBHey5SAQAA",
          "NamespaceId": null,
          "NamespaceName": null,
          "Port": "8080",
          "RegistrationId": "ins-7wy598p8",
          "RegistrationTime": 1734887748,
          "ServiceInstanceStatus": "Running",
          "ServiceStatus": "passing",
          "WanIp": "43.139.245.156"
        }
      ],
      "TotalCount": 1
    }
  }
}