全部產品
Search
文件中心

Cloud Backup:DescribeHanaInstances - 查詢合格SAP HANA執行個體

更新時間:Dec 23, 2025

查詢一個或多個合格SAP HANA執行個體。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

hbr:DescribeHanaInstances

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

VaultId

string

備份倉庫 ID。

v-000b0ov******6zs

ClusterId

string

SAP HANA 執行個體 ID。

cl-0001zfc******50pr3

PageNumber

integer

分頁頁碼。從 1 開始,預設值為 1。

1

PageSize

integer

分頁大小。最小值為 1,最大值為 99,預設值為 10。

10

Tag

array<object>

SAP HANA 執行個體標籤。

object

SAP HANA 執行個體標籤。

Key

string

標籤鍵。

ace:rm:rgld

Value

string

標籤值。

rg-acfmwutpyat2kwy

ResourceGroupId

string

資源群組 ID。

rg-aekz24ikcjyqjkq

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

4003DD68-3C3C-5071-B4FC-631A6C1BAC1C

Success

boolean

請求是否成功。

  • true:成功

  • false:失敗

true

Code

string

返回碼。200 表示成功。

200

Message

string

返回資訊描述,成功一般返回 successful,錯誤時會返回相應錯誤資訊。

successful

PageNumber

integer

分頁頁碼。從 1 開始,預設值為 1。

1

PageSize

integer

分頁大小。最小值為 1,最大值為 99,預設值為 10。

10

TotalCount

integer

總記錄數。

21

Hanas

object

Hana

array<object>

SAP HANA 執行個體列表。

array<object>

SAP HANA 執行個體。

Status

integer

SAP HANA 執行個體狀態:

  • INITIALIZING:初始化中。

  • INITIALIZED:登入。

  • INVALID_HANA_NODE:為無效的 HANA 節點。

  • INITIALIZE_FAILED:安裝用戶端失敗。

INITIALIZED

Host

string

SAP HANA 主節點的私人或內網 IP 位址。

47.100.XX.XX

VaultId

string

備份倉庫 ID。

v-0000s974******1hl

UseSsl

boolean

是否使用 SSL 安全連線方式串連資料庫。

  • true:使用 SSL 安全連線方式串連資料庫。

  • false:不使用 SSL 安全連線方式串連資料庫。

true

HanaName

string

SAP HANA 名稱。

HANA-DEV

InstanceNumber

integer

安裝 SAP HANA 時指定的執行個體編號。

00

ValidateCertificate

boolean

開啟驗證 SSL 憑證開關後,表示驗證資料庫服務端 SSL 憑證。

false

AlertSetting

string

警示設定。取值為 INHERITED,表示使用與備份庫一致的警示方式。

INHERITED

UserName

string

SYSTEMDB 資料庫的使用者名稱。

admin

StatusMessage

string

狀態資訊。

INSTALL_CLIENT_FAILED

ClusterId

string

SAP HANA 執行個體 ID。

cl-0004cf6g6******0yd7y

Tags

object

Tag

array<object>

SAP HANA 執行個體標籤。

object

SAP HANA 執行個體標籤。

Key

string

標籤鍵。

ace:rm:rgld

Value

string

標籤值。

rg-acfmwutpyat2kwy

ResourceGroupId

string

資源群組 ID。

rg-acfmvnf22m7itha

CrossAccountType

string

跨帳號備份類型。支援:

  • SELF_ACCOUNT:本帳號備份

  • CROSS_ACCOUNT:跨帳號備份

CROSS_ACCOUNT

CrossAccountUserId

integer

被當前帳號管理的跨帳號備份的原帳號 ID。

158975xxxxx4625

CrossAccountRoleName

string

被當前帳號管理的跨帳號備份的原帳號 RAM 中建立的角色名稱。

hbrcrossrole

樣本

正常返回樣本

JSON格式

{
  "RequestId": "4003DD68-3C3C-5071-B4FC-631A6C1BAC1C",
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 21,
  "Hanas": {
    "Hana": [
      {
        "Status": 0,
        "Host": "47.100.XX.XX",
        "VaultId": "v-0000s974******1hl",
        "UseSsl": true,
        "HanaName": "HANA-DEV",
        "InstanceNumber": 0,
        "ValidateCertificate": false,
        "AlertSetting": "INHERITED",
        "UserName": "admin",
        "StatusMessage": "INSTALL_CLIENT_FAILED",
        "ClusterId": "cl-0004cf6g6******0yd7y",
        "Tags": {
          "Tag": [
            {
              "Key": "ace:rm:rgld",
              "Value": "rg-acfmwutpyat2kwy"
            }
          ]
        },
        "ResourceGroupId": "rg-acfmvnf22m7itha",
        "CrossAccountType": "CROSS_ACCOUNT",
        "CrossAccountUserId": 0,
        "CrossAccountRoleName": "hbrcrossrole"
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情