调用GetRegisteredServiceEndpoints获取注册服务端点信息。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String GetRegisteredServiceEndpoints

系统规定参数。取值:GetRegisteredServiceEndpoints

ServiceMeshId String c08ba3fd1e6484b0f8cc1ad8fe10d****

服务网格实例ID

Namespace String default

命名空间

ClusterIds String c8b054ee8c3914d079b5ce9733328****,c58faedb8a78640d3aeb0372e4c02****

集群ID列表,用逗号分隔

Name String reviews

服务名称

ServiceType String Kubernetes

服务类型,取值:

  • ServiceEntry:为服务网格ServiceEntry中注册的服务
  • Kubernetes:为数据面Kubernetes集群注册的服务

返回数据

名称 类型 示例值 描述
ServiceEndpoints Array of ServiceEndpoint

服务端点信息列表

Address String 192.168.25.153

服务地址

ClusterId String c80f45444b3da447da60a911390c2****

数据面集群ID

EndPointSlice Object

服务端点详细信息列表

ServiceName String reviews

服务名称

Namespace String default

命名空间

Location String MESH_INTERNAL

服务所在的位置。可选参数:

  • MESH_INTERNAL:服务在网格内部
  • MESH_EXTERNAL:服务在网格外部
EndpointsDetails Array of endpointsDetail

服务端点详细信息列表

PodName String provider-v1-8c86b6898-h***

pod名称

Address String 127.2.**.**

服务端点地址

Ports Array of Integer 9090

服务端口

Hostname String www.demo.com

服务地址

Region String cn-hangzhou

地域ID

SidecarInjected Boolean false

是否注入Sidecar代理,取值:

  • true:注入Sidecar代理
  • false:不注入Sidecar代理
RequestId String 31d3a0f0-07ed-4f6e-9004-1804498c****

请求ID

示例

请求示例

http(s)://[Endpoint]/?Action=GetRegisteredServiceEndpoints
&ServiceMeshId=c08ba3fd1e6484b0f8cc1ad8fe10d****
&Namespace=default
&ClusterIds=c8b054ee8c3914d079b5ce9733328****,c58faedb8a78640d3aeb0372e4c02****
&Name=reviews
&ServiceType=Kubernetes
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetRegisteredServiceEndpointsResponse>
    <ServiceEndpoints>
        <Address>192.168.25.153</Address>
        <ClusterId>c80f45444b3da447da60a911390c2****</ClusterId>
    </ServiceEndpoints>
    <EndPointSlice>
        <ServiceName>reviews</ServiceName>
        <Namespace>default</Namespace>
        <Location>MESH_INTERNAL</Location>
        <EndpointsDetails>
            <PodName>provider-v1-8c86b6898-h***</PodName>
            <Address>127.2.**.**</Address>
            <Ports>9090</Ports>
            <Hostname>www.demo.com</Hostname>
            <Region>cn-hangzhou</Region>
            <SidecarInjected>false</SidecarInjected>
        </EndpointsDetails>
    </EndPointSlice>
    <RequestId>31d3a0f0-07ed-4f6e-9004-1804498c****</RequestId>
</GetRegisteredServiceEndpointsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ServiceEndpoints" : {
    "Address" : "192.168.25.153",
    "ClusterId" : "c80f45444b3da447da60a911390c2****"
  },
  "EndPointSlice" : {
    "ServiceName" : "reviews",
    "Namespace" : "default",
    "Location" : "MESH_INTERNAL",
    "EndpointsDetails" : {
      "PodName" : "provider-v1-8c86b6898-h***",
      "Address" : "127.2.**.**",
      "Ports" : 9090,
      "Hostname" : "www.demo.com",
      "Region" : "cn-hangzhou",
      "SidecarInjected" : false
    }
  },
  "RequestId" : "31d3a0f0-07ed-4f6e-9004-1804498c****"
}

错误码

HttpCode 错误码 错误信息 描述
500 ERR500 An internal server error occurred. 后端服务异常

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