全部產品
Search

搜尋本產品

    Platform For AI：ListServiceInstances - 查詢服務執行個體列表

    文件中心

    Platform For AI：ListServiceInstances - 查詢服務執行個體列表

    更新時間：Jan 07, 2026

    擷取指定服務的執行個體列表。

    介面說明

    請確保在使用該介面前，已充分瞭解 EAS 產品的收費方式和價格。

    調試

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

    調試

    授權資訊

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

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

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    eas:ListServiceInstances

    get

    *Service

    acs:eas:{#regionId}:{#accountId}:service/{#ServiceName}

    		 無 無

    請求文法

    GET /api/v2/services/{ClusterId}/{ServiceName}/instances HTTP/1.1

    路徑參數

    名稱

    類型

    必填

    描述

    樣本值
    ClusterId

    string

    是

    服務所在地區 ID。

    cn-shanghai
    ServiceName

    string

    是

    服務名稱。如何擷取服務名稱，請參見ListServices 。

    foo

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    PageNumber

    integer

    否

    服務執行個體列表的頁，預設值為 1。

    1
    PageSize

    integer

    否

    分頁查詢時設定的每頁顯示的執行個體數量，預設為 100。

    20
    Filter

    string

    否

    關鍵字搜尋。支援按執行個體名、執行個體 IP、執行個體所在的機器的 IP、執行個體規格搜尋。

    10.118.xx.xx
    ResourceType

    string

    否

    服務執行個體所在的資源群組類型。

    枚舉值：

    • PublicResource :

      公用資源群組

    • DedicatedResource :

      專屬資源群組

    PublicResource
    InstanceType

    string

    否

    執行個體規格。

    ecs.c7.large
    InstanceStatus

    string

    否

    服務執行個體的狀態。

    Running
    InstanceIP

    string

    否

    服務執行個體的 IP。

    10.224.xx.xx
    InstanceName

    string

    否

    服務執行個體的名字。

    foo-bdc5xxxx-8l7rk
    HostIP

    string

    否

    服務執行個體所在機器的 IP。

    10.224.xx.xx
    IsSpot

    boolean

    否

    是否為搶佔式執行個體。

    false
    Role

    string

    否

    服務的角色。

    枚舉值：

    • DataSet :

      資料集服務

    • SDProxy :

      Stable-Diffusion 代理服務

    • Standard :

      普通預測服務

    • Queue :

      佇列服務

    Queue
    Sort

    string

    否

    排序欄位。

    枚舉值：

    • StartTime :

      建立時間

    StartTime
    Order

    string

    否

    排序次序。

    枚舉值：

    • asc :

      升序

    • desc :

      降序

    desc
    MemberType

    string

    否

    子服務的類型(只有在彙總服務的情境下有效)。

    LLMDecode
    ListReplica

    boolean

    否

    是否查詢執行個體單元列表。

    true
    ReplicaName

    string

    否

    執行個體單元的名稱。

    cbh-qwen3-a1bc-prefill-ep1tp4dp
    QuotaId

    string

    否

    配額 ID。

    quota1****

    Resource

    string

    否

    執行個體所在的資源群組。

    eas-r-xxxxxxx

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    40325405-579C-4D82****
    Instances

    array

    服務執行個體列表。

    Instance

    服務執行個體。

    PageNumber

    integer

    返回查詢的執行個體列表的當前頁碼。

    1
    PageSize

    integer

    返回每頁顯示的執行個體數量。

    20
    TotalCount

    integer

    執行個體總數。

    1

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "40325405-579C-4D82****",
  "Instances": [
    {
      "HostIP": "11.0.XX.XX",
      "HostName": "smart-scene-cls-854dbdc99d-****",
      "InnerIP": "172.17.0.17",
      "InstanceName": "foo-5fc8946767-v****",
      "InstancePort": 8080,
      "LastState": [
        []
      ],
      "Namespace": "foo",
      "Reason": "RUNNING",
      "RestartCount": 1,
      "Status": "Running",
      "TotalProcesses": 1,
      "ReadyProcesses": 1,
      "StartAt": "2021-05-27T09:46:05Z",
      "Role": "Standard",
      "ResourceType": "PublicResource",
      "TenantInstanceIP": "192.168.xx.xx",
      "TenantHostIP": "192.168.xx.xx",
      "IsSpot": false,
      "CurrentAmount": 0.444,
      "OriginalAmount": 2.2,
      "Isolated": false,
      "Zone": "cn-shanghai-a",
      "ExternalIP": "192.168.1.100",
      "ExternalInstancePort": 8080,
      "StartTime": "2021-05-27T09:46:05Z",
      "InstanceType": "ecs.c7.large"
    }
  ],
  "PageNumber": 1,
  "PageSize": 20,
  "TotalCount": 1
}

    錯誤碼

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

    變更歷史

    更多資訊，參考變更詳情。