全部產品
Search

搜尋本產品

    ENS：DescribeARMServerInstances - 擷取ARM伺服器和AIC執行個體資訊

    文件中心

    ENS：DescribeARMServerInstances - 擷取ARM伺服器和AIC執行個體資訊

    更新時間：Mar 20, 2026

    擷取ARM伺服器和AIC執行個體資訊。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ens:DescribeARMServerInstances

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ServerIds

    array

    否

    伺服器執行個體 ID 列表。

    string

    否

    伺服器執行個體 ID 列表。

    cas-instance****
    EnsRegionIds

    array

    否

    ENS 節點 ID 列表。

    string

    否

    ENS 節點 ID 列表。

    cn-chengdu-telecom-4
    PageNumber

    integer

    否

    查詢列表的頁碼。起始值為 1。

    預設值：1。

    1
    PageSize

    integer

    否

    分頁查詢時設定的每頁行數，最大值為 100 行。

    預設值：10。

    10
    MinDate

    string

    否

    查詢起始時間，格式"2006-01-02"；預設無時間限制。

    2006-01-02
    MaxDate

    string

    否

    查詢終止時間，格式"2006-01-02"；預設無時間限制。

    2006-01-03
    States

    array

    否

    操作狀態列表。

    string

    否

    伺服器操作狀態。

    • success：成功。

    • failed：失敗。

    • creating：建立中。

    • releasing：釋放中。

    • rebooting：重啟中。

    • upgrading：升級中。

    success
    AICSpecs

    array

    否

    容器規格列表。

    string

    否

    容器規格。

    aic.cf53r.c2.np
    ServerSpecs

    array

    否

    伺服器規格列表。

    string

    否

    伺服器規格。

    cas.cf53r
    Name

    string

    否

    伺服器名稱。

    Server-Name
    Namespace

    string

    否

    命名空間。

    default
    Tags

    array<object>

    否

    標籤列表

    object

    否

    Key

    string

    否

    標籤鍵

    key-1
    Value

    string

    否

    標籤值

    value-1
    OrderByParams

    string

    否

    查詢結果排序方式，可設定按照 ServerIdSort（伺服器 ID）、ServerNameSort（伺服器名稱）、ExpireTimeSort（到期時間）、CreationTimeSort（建立時間）、EnsRegionIdSort（節點 ID）中的一個或者多個結果排序。

    取值含義：asc：升序， desc：降序。

    {"ServerIdSort":"desc","ServerNameSort":"desc","ExpireTimeSort":"asc"}
    DescribeAICInstances

    boolean

    否

    查詢結果是否包含容器資訊，取值：

    • true：包含。

    • false：不包含。

    true

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    4EC47282-1B74-4534-BD0E-403F3EE64CAF
    Servers

    array<object>

    由伺服器和 AIC 執行個體資訊組成的數組。

    array<object>

    CreationTime

    string

    執行個體建立時間。

    2022-05-07 11:59:09
    ExpiredTime

    string

    執行個體到期時間。

    2027-05-07 11:59:09
    AICInstances

    array<object>

    AIC 執行個體資訊組成的數組。

    array<object>

    Frequency

    integer

    AIC 執行個體重新整理率，單位 Hz。

    120
    ImageId

    string

    AIC 鏡像 ID。

    m-****
    InstanceId

    string

    AIC 執行個體 ID。

    aic-instance****
    NetworkAttributes

    object

    網路屬性。

    IpAddress

    string

    AIC 執行個體 IP 位址。

    192.168.XX.XX
    NetworkId

    string

    AIC 執行個體網路識別碼。

    n-*****
    VSwitchId

    string

    AIC 執行個體交換器 ID。

    vsw-****
    SdgDeployInfo

    object

    執行個體上部署的共用資料集（SDG）資訊。

    SDGId

    string

    SDG 的 ID。

    sdg-xxxxx
    Status

    string

    SDG 的部署狀態，取值：

    • sdg_deploying：部署中。

    • failed：部署失敗。

    • success：部署成功。

    success
    Resolution

    string

    AIC 執行個體解析度。

    1920*1080
    Spec

    string

    AIC 執行個體規格。

    aic.cf53r.c2.np
    State

    string

    AIC 執行個體操作狀態。

    • success：成功。

    • failed：失敗。

    • creating：建立中。

    • releasing：釋放中。

    • rebooting：重啟中。

    • reseting：重設中。

    success
    Status

    string

    AIC 執行個體運行狀態。

    • running：運行中。

    • pending：等待中。

    • terminating：終止中。

    running
    Name

    string

    容器名稱。

    AIC-Name
    LatestAction

    string

    最近一次操作。

    ServerCreate
    EnsRegionId

    string

    ENS 節點 ID。

    cn-hanghzou-27
    ServerId

    string

    伺服器 ID。

    cas-******
    SpecName

    string

    伺服器規格。

    cas.cf53r
    State

    string

    伺服器操作狀態。

    • success：成功。

    • failed：失敗。

    • creating：建立中。

    • releasing：釋放中。

    • rebooting：重啟中。

    • upgrading：升級中。

    success
    Status

    string

    伺服器運行狀態。

    • running：運行中。

    • stopping：停止中。

    • down：關機。

    • starting：啟動中。

    running
    Namespace

    string

    板卡所屬叢集 Namespace 名稱。

    default
    Name

    string

    伺服器名稱。

    Server-Name
    PayType

    string

    付費方式。

    prepay
    LatestAction

    string

    最近一次操作。

    ServerCreate
    Tags

    array<object>

    標籤集合。

    object

    標籤。

    Key

    string

    標籤鍵。

    key-1
    Value

    string

    標籤值。

    value-1
    PageNumber

    integer

    執行個體列表的頁碼。

    1
    PageSize

    integer

    輸入時設定的每頁行數。

    10
    TotalCount

    integer

    查詢到的執行個體總數。

    2

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
  "Servers": [
    {
      "CreationTime": "2022-05-07 11:59:09",
      "ExpiredTime": "2027-05-07 11:59:09",
      "AICInstances": [
        {
          "Frequency": 120,
          "ImageId": "m-****",
          "InstanceId": "aic-instance****",
          "NetworkAttributes": {
            "IpAddress": "192.168.XX.XX",
            "NetworkId": "n-*****",
            "VSwitchId": "vsw-****"
          },
          "SdgDeployInfo": {
            "SDGId": "sdg-xxxxx",
            "Status": "success"
          },
          "Resolution": "1920*1080",
          "Spec": "aic.cf53r.c2.np",
          "State": "success",
          "Status": "running",
          "Name": "AIC-Name",
          "LatestAction": "ServerCreate"
        }
      ],
      "EnsRegionId": "cn-hanghzou-27",
      "ServerId": "cas-******",
      "SpecName": "cas.cf53r",
      "State": "success",
      "Status": "running",
      "Namespace": "default",
      "Name": "Server-Name",
      "PayType": "prepay",
      "LatestAction": "ServerCreate",
      "Tags": [
        {
          "Key": "key-1",
          "Value": "value-1"
        }
      ]
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 2
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 Parameter.Invalid This service has not been activated. 未開通該產品服務
    400 Interface.Call.Error The interface call error 介面調用出錯
    400 Interface.Call.Failed %s. 請求失敗
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.

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

    變更歷史

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