ListInstances

更新時間:
Copy as MD

呼叫 ListInstances 介面,取得執行個體資訊列表。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

dms:ListInstances

list

*All Resource

*

請求參數

名稱

類型

必填

描述

樣本值

Tid

integer

租戶 ID,可透過呼叫介面 GetUserActiveTenant 取得該參數的值。

3***

SearchKey

string

搜尋關鍵字。

test

DbType

string

資料庫類型,取值請參見 DbType 參數說明

MySQL

EnvType

string

環境類型,取值如下:

  • product:生產環境

  • dev:開發環境

  • pre:預發環境

  • test:測試環境

  • sit:SIT 環境

  • uat:UAT 環境

  • pet:壓測環境

  • stag:STAG 環境。

product

InstanceSource

string

執行個體來源,取值如下:

  • PUBLIC_OWN:代表公網自建執行個體

  • RDS:代表 RDS 執行個體

  • ECS_OWN:代表 ECS 自建執行個體

  • VPC_IDC:代表 VPC IDC 自建執行個體。

RDS

NetType

string

執行個體網路類型,取值如下:

  • CLASSIC:經典網路

  • VPC:VPC 網路。

VPC

InstanceState

string

執行個體狀態,取值如下:

  • NORMAL:正常使用

  • DISABLE:停用。

NORMAL

PageNumber

integer

第幾頁。

1

PageSize

integer

每頁多少筆資料,取值不超過 100。

50

Region

string

執行個體所在的 regionId。

cn-hangzhou

RealLoginUserUid

string

實際呼叫 API 的使用者的阿里雲帳號 UID。

21400447956867****

返回參數

名稱

類型

描述

樣本值

object

描述。

TotalCount

integer

滿足條件的執行個體總個數。

1

RequestId

string

請求 ID。

B4B07137-F6AE-4756-8474-7F92BB6C4E04

ErrorCode

string

錯誤碼。

UnknownError

ErrorMessage

string

錯誤資訊。

UnknownError

InstanceList

object

Instance

array<object>

執行個體列表。

array<object>

執行個體資訊。

VpcId

string

執行個體所屬 VPC 的 ID。

vpc-o6wrloqsdqc9io3mg****

DatabaseUser

string

資料庫使用者名稱。

dbUser

DbaId

string

執行個體 DBA ID。

31****

UseDsql

integer

執行個體是否開啟跨庫查詢:

  • 0:不開啟

  • 1:開啟

1

Port

integer

執行個體串連連接埠。

3306

EcsInstanceId

string

執行個體 ECS ID。

150****

EnvType

string

執行個體環境類型,傳回值如下:

  • product:生產環境

  • dev:開發環境

  • pre:預發環境

  • test:測試環境

  • sit:SIT 環境

  • uat:UAT 環境

  • pet:壓測環境

  • stag:STAG 環境

product

Sid

string

執行個體 Sid。

test

OwnerIdList

object

OwnerIds

array

執行個體 Owner UserId 列表。

string

執行個體 Owner UserId。

12****

SafeRuleId

string

執行個體安全規則 ID。

1

OwnerNameList

object

OwnerNames

array

執行個體 Owner 暱稱列表。

string

執行個體 Owner 暱稱。

yuyang_test

DbaNickName

string

執行個體 DBA 暱稱。

dbaName

QueryTimeout

integer

執行個體查詢逾時時間。

60

InstanceSource

string

執行個體來源。

RDS

Host

string

執行個體串連地址。

****.mysql.rds.aliyuncs.com

State

string

執行個體狀態。

NORMAL

DataLinkName

string

DataLink 名稱。

dblink_test

ExportTimeout

integer

匯出逾時時間。

86400

InstanceId

string

執行個體 ID。

150***

InstanceType

string

執行個體 DB 類型。

mysql

DatabasePassword

string

資料庫使用者密碼。

******

InstanceAlias

string

執行個體別名。

test

DdlOnline

integer

執行個體 DdlOnline 配置。

1

EcsRegion

string

執行個體所屬地區。

cn-hangzhou

StandardGroup

object

執行個體對應的管控模式資訊。

GroupName

string

管控模式對應的安全規則名稱。

test

GroupMode

string

管控模式類型,取值如下:

  • COMMON:安全協同模式

  • NONE_CONTROL: 自由操作模式

  • STABLE:穩定變更模式

COMMON

SellSitd

boolean

Sensitive Data Discovery and Protection 是否開啟,取值:

  • true:開啟

  • false:關閉

true

SellTrust

string

是否開啟安全託管。取值:

  • true:開啟

  • false:關閉

true

Success

boolean

請求是否成功:

  • true:執行成功。

  • false:執行失敗。

true

樣本

正常返回樣本

JSON格式

{
  "TotalCount": 1,
  "RequestId": "B4B07137-F6AE-4756-8474-7F92BB6C4E04",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "InstanceList": {
    "Instance": [
      {
        "VpcId": "vpc-o6wrloqsdqc9io3mg****",
        "DatabaseUser": "dbUser",
        "DbaId": "31****",
        "UseDsql": 1,
        "Port": 3306,
        "EcsInstanceId": "150****",
        "EnvType": "product",
        "Sid": "test",
        "OwnerIdList": {
          "OwnerIds": [
            "12****"
          ]
        },
        "SafeRuleId": "1",
        "OwnerNameList": {
          "OwnerNames": [
            "yuyang_test"
          ]
        },
        "DbaNickName": "dbaName",
        "QueryTimeout": 60,
        "InstanceSource": "RDS",
        "Host": "****.mysql.rds.aliyuncs.com",
        "State": "NORMAL",
        "DataLinkName": "dblink_test",
        "ExportTimeout": 86400,
        "InstanceId": "150***",
        "InstanceType": "mysql",
        "DatabasePassword": "******",
        "InstanceAlias": "test",
        "DdlOnline": 1,
        "EcsRegion": "cn-hangzhou",
        "StandardGroup": {
          "GroupName": "test",
          "GroupMode": "COMMON"
        },
        "SellSitd": true,
        "SellTrust": "true"
      }
    ]
  },
  "Success": true
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情