全部產品
Search
文件中心

Alibaba Cloud Service Mesh:GetRegisteredServiceEndpoints - 擷取註冊到網格內的服務端點資訊

更新時間:Nov 24, 2025

調用GetRegisteredServiceEndpoints擷取註冊服務端點資訊。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

servicemesh:GetRegisteredServiceEndpoints

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

ServiceMeshId

string

服務網格執行個體 ID

c08ba3fd1e6484b0f8cc1ad8fe10d****

Namespace

string

命名空間

default

ClusterIds

string

叢集 ID 列表,用逗號分隔

c8b054ee8c3914d079b5ce9733328****,c58faedb8a78640d3aeb0372e4c02****

Name

string

服務名稱

reviews

ServiceType

string

服務類型,取值:

  • ServiceEntry:為服務網格 ServiceEntry 中註冊的服務

  • Kubernetes:為資料面 Kubernetes 叢集註冊的服務

Kubernetes

返回參數

名稱

類型

描述

樣本值

object

響應體

ServiceEndpoints

array<object>

服務端點資訊列表

object

服務端點資訊

Address

string

服務地址

192.168.25.153

ClusterId

string

資料面叢集 ID

c80f45444b3da447da60a911390c2****

EndPointSlice

object

服務端點詳細資料列表

ServiceName

string

服務名稱

reviews

Namespace

string

命名空間

default

Location

string

服務所在的位置。選擇性參數:

  • MESH_INTERNAL:服務在網格內部

  • MESH_EXTERNAL:服務在網格外部

MESH_INTERNAL

EndpointsDetails

array<object>

服務端點詳細資料列表

object

服務端點詳細資料

PodName

string

pod 名稱

provider-v1-8c86b6898-h***

Address

string

服務端點地址

127.2.**.**

Ports

array

連接埠列表

integer

服務連接埠

9090

Hostname

string

服務地址

www.demo.com

Region

string

地區 ID

cn-hangzhou

SidecarInjected

boolean

是否注入 Sidecar 代理,取值:

  • true:注入 Sidecar 代理

  • false:不注入 Sidecar 代理

false

RequestId

string

請求 ID

31d3a0f0-07ed-4f6e-9004-1804498c****

樣本

正常返回樣本

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****"
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

500 ERR500 An internal server error occurred. 後端服務異常

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情