全部產品
Search

搜尋本產品

    Hologres：ListLeaderInstances

    文件中心

    Hologres：ListLeaderInstances

    更新時間：Sep 17, 2026

    取得可能的主執行個體 ID 清單。

    介面說明

    取得可與指定 Hologres 從執行個體綁定的主執行個體清單。instanceId 為路徑參數，呼叫時必須提供。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    hologram:ListLeaderInstances

    list

    *Instance

    acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

    		 無 無

    請求文法

    GET /api/v1/instances/{instanceId}/primaryInstances HTTP/1.1

    路徑參數

    名稱

    類型

    必填

    描述

    樣本值
    instanceId

    string

    否

    執行個體 ID。該參數位於請求路徑中，呼叫時必須提供。

    hgprecn-cn-zxu3001jn00d

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    否

    地域 ID。

    cn-hangzhou

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    Id of the request

    5600196E-78E2-50F2-B2A1-C44D3B665438
    InstanceList

    array<object>

    執行個體清單。

    array<object>

    角色清單。

    ChargeType

    string

    付費類型。

    枚舉值：

    • PostPaid :

      包年包月。

    • PrePaid :

      按量付費。

    PostPaid
    CommodityCode

    string

    商品 Code。

    hologram_combo_public_cn
    CreationTime

    string

    建立時間。採用 ISO 8601 格式的 UTC 時間。

    2022-07-25T02:15:35Z
    ExpirationTime

    string

    到期時間（按量付費類型沒有到期時間）。採用 ISO 8601 格式的 UTC 時間。

    2022-07-25T02:15:35Z
    InstanceId

    string

    執行個體 ID。

    hgpostcn-cn-tl32vsdir00h
    InstanceName

    string

    執行個體名稱。

    user_defined_name
    InstanceStatus

    string

    執行個體狀態。

    枚舉值：

    • Creating :

      正在建立。

    • Running :

      正常運行。

    • Suspended :

      停機。

    • Allocating :

      正在處理，部分介面可能不允許操作。

    Running
    InstanceType

    string

    執行個體類型。

    枚舉值：

    • Follower :

      唯讀從執行個體。

    • Standard :

      普通型。

    Standard
    Tags

    array<object>

    標籤清單。

    object

    標籤清單。

    Key

    string

    標籤鍵。

    tagKey
    Value

    string

    標籤值。

    value
    BindingCode

    string

    主執行個體和從執行個體的匹配程度。0 表示完美匹配，其他表示不匹配。

    0
    Success

    string

    請求結果，表示此次請求是否發生異常，與業務無關。

    枚舉值：

    • true :

      成功。

    • false :

      失敗。

    true
    ErrorCode

    string

    錯誤碼。

    404
    ErrorMessage

    string

    錯誤資訊。

    Internal server error.
    HttpStatusCode

    string

    HTTP 狀態碼。

    200

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "5600196E-78E2-50F2-B2A1-C44D3B665438",
  "InstanceList": [
    {
      "ChargeType": "PostPaid",
      "CommodityCode": "hologram_combo_public_cn",
      "CreationTime": "2022-07-25T02:15:35Z",
      "ExpirationTime": "2022-07-25T02:15:35Z",
      "InstanceId": "hgpostcn-cn-tl32vsdir00h",
      "InstanceName": "user_defined_name",
      "InstanceStatus": "Running",
      "InstanceType": "Standard",
      "Tags": [
        {
          "Key": "tagKey",
          "Value": "value"
        }
      ],
      "BindingCode": "0"
    }
  ],
  "Success": "true",
  "ErrorCode": "404",
  "ErrorMessage": "Internal server error.",
  "HttpStatusCode": "200"
}

    錯誤碼

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

    變更歷史

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