全部產品
Search
文件中心

Data Security Center:DescribeInstances - 查詢資料資產執行個體列表

更新時間:Dec 20, 2025

擷取串連授權的MaxCompute、RDS、OSS資料資產執行個體列表。

介面說明

在調用 DescribeInstances 介面時,您可以設定搜尋關鍵詞、資料資產執行個體的風險等級等參數來擷取符合要求的資料資產執行個體的列表資訊。

QPS 限制

本介面的單使用者 QPS 限制為 10 次/秒。超過限制,API 呼叫將會被限流,這可能影響您的業務,請合理調用。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-sddp:DescribeInstances

get

*全部資源

*

請求參數

名稱

類型

必填

描述

樣本值

Lang

string

佈建要求和接收訊息的語言類型,預設為zh_cn。 取值:

  • zh_cn:中文(簡體)

  • en_us:英文(美國)

zh_cn

Name

string

設定搜尋的關鍵詞,支援模糊比對。例如,輸入 data,會搜尋出搜尋項中包含 data 的全部資料資訊。

data

ProductId

integer

設定資料資產執行個體所屬產品的 ID。您可以通過調用 DescribeDataAssets 介面擷取產品識別碼。

1

RiskLevelId

integer

設定資料資產執行個體的風險等級 ID。風險等級 ID 越高,表示識別出的資料越敏感。取值:

  • 1:表示未識別到敏感性資料,無風險。

  • 2:表示 1 級敏感性資料風險。

  • 3:表示 2 級敏感性資料風險。

  • 4:表示 3 級敏感性資料風險。

  • 5:表示 4 級敏感性資料風險。

  • 6:表示 5 級敏感性資料風險。

  • 7:表示 6 級敏感性資料風險。

  • 8:表示 7 級敏感性資料風險。

  • 9:表示 8 級敏感性資料風險。

  • 10:表示 9 級敏感性資料風險。

  • 11:表示 10 級敏感性資料風險。

2

RuleId

integer

設定資料資產執行個體命中的敏感性資料識別規則 ID。該敏感性資料識別規則的 ID 可調用 DescribeRules 介面,查看返回參數 Id 擷取。

1111111

ServiceRegionId

string

設定資料資產執行個體的地區。更多資訊,請參見支援的地區

cn-hangzhou

FeatureType

integer

此參數已廢棄。

1

ProductCode

string

設定資料資產執行個體所屬產品的名稱,包括 MaxCompute、OSS、RDS 等。關於支援的產品名稱,請參見支援識別敏感性資料的資料類型

RDS

PageSize

integer

分頁查詢時,設定列表中每頁顯示的資料資產執行個體的最大條數。預設值:10

10

CurrentPage

integer

分頁查詢時,設定當前頁面的頁碼。預設值:1

1

返回參數

名稱

類型

描述

樣本值

object

CurrentPage

integer

當前頁面的頁碼。

1

RequestId

string

結果的請求 ID。

71064826-726F-4ADA-B879-05D8055476FB

PageSize

integer

列表中每頁顯示的資料資產執行個體的數量。

10

TotalCount

integer

查詢到的資料資產執行個體的總數量。

231

Items

array<object>

查詢到的資料資產執行個體詳情。

array<object>

CreationTime

integer

建立該資料資產執行個體的時間。使用時間戳表示,單位:毫秒。

1637226782000

LastFinishTime

integer

最近一次掃描資料資產執行個體的完成時間。使用時間戳表示,單位:毫秒。

1637622793000

Owner

string

擁有該資料資產執行個體的阿里雲帳號。

dtdep-239-******

TenantName

string

租戶的名稱。

tenant

Protection

boolean

資料資產執行個體的防護狀態。取值:

  • true:防護中

  • false:未防護

false

DepartName

string

資料資產執行個體所屬部門的名稱。

***DemoCenter

Labelsec

boolean

資料資產執行個體的安全狀態。取值:

  • true:安全

  • false:非安全

true

RiskLevelId

integer

資料資產執行個體的風險等級 ID。風險等級 ID 越高,表示識別出的資料越敏感。

  • 1:表示未識別到敏感性資料,無風險。

  • 2:表示 1 級敏感性資料風險。

  • 3:表示 2 級敏感性資料風險。

  • 4:表示 3 級敏感性資料風險。

  • 5:表示 4 級敏感性資料風險。

  • 6:表示 5 級敏感性資料風險。

  • 7:表示 6 級敏感性資料風險。

  • 8:表示 7 級敏感性資料風險。

  • 9:表示 8 級敏感性資料風險。

  • 10:表示 9 級敏感性資料風險。

  • 11:表示 10 級敏感性資料風險。

2

ProductId

string

資料資產執行個體所屬產品的 ID。

5

Name

string

資料資產執行個體的名稱。

gxdata

TotalCount

integer

資料資產執行個體中的資料總數。例如:當資料資產為 RDS 時,表示該執行個體中資料庫的總表數。

231

InstanceDescription

string

資料資產執行個體的描述資訊。

instance dscription

RuleName

string

資料資產執行個體命中的敏感性資料識別規則的名稱。

*** rule

Sensitive

boolean

資料資產執行個體中是否包含敏感性資料。取值:

  • true:包含

  • false:不包含

true

RiskLevelName

string

資料資產執行個體的風險等級名稱。

S1

OdpsRiskLevelName

string

此參數已廢棄。

1

SensitiveCount

integer

資料資產執行個體中包含的敏感性資料總數。例如:當資料資產為 RDS 時,表示該執行個體中資料庫的敏感總表數。

123

Id

integer

資料資訊安全中心服務中記錄的資料資產執行個體的唯一標識 ID。

11111

ProductCode

string

資料資產執行個體所屬產品的名稱,包括 MaxCompute、OSS、RDS 等。關於支援的具體產品名稱,請參見支援識別敏感性資料的資料類型

RDS

ModelTags

array<object>

資料標籤列表。

object

資料標籤對象。

Id

integer

資料標籤 ID。取值:

  • 101:個人敏感資訊

  • 102:個人資訊

  • 107:通用資訊

101

Name

string

資料標籤名稱。取值:

  • 個人敏感資訊

  • 個人資訊

  • 通用資訊

personal sensitive data

MemberAliUid

string

如果管理帳號開通了多帳號,且該資產屬於其他成員帳號,該欄位展示的為成員帳號的 UID。

12567890126

樣本

正常返回樣本

JSON格式

{
  "CurrentPage": 1,
  "RequestId": "71064826-726F-4ADA-B879-05D8055476FB",
  "PageSize": 10,
  "TotalCount": 231,
  "Items": [
    {
      "CreationTime": 1637226782000,
      "LastFinishTime": 1637622793000,
      "Owner": "dtdep-239-******",
      "TenantName": "tenant",
      "Protection": false,
      "DepartName": "***DemoCenter",
      "Labelsec": true,
      "RiskLevelId": 2,
      "ProductId": "5",
      "Name": "gxdata",
      "TotalCount": 231,
      "InstanceDescription": "instance dscription",
      "RuleName": "*** rule",
      "Sensitive": true,
      "RiskLevelName": "S1",
      "OdpsRiskLevelName": "1",
      "SensitiveCount": 123,
      "Id": 11111,
      "ProductCode": "RDS",
      "ModelTags": [
        {
          "Id": 101,
          "Name": "personal sensitive data"
        }
      ],
      "MemberAliUid": "12567890126"
    }
  ]
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情