全部產品
Search

搜尋本產品

    Data Security Center：DescribeInstances

    文件中心

    Data Security Center：DescribeInstances

    更新時間：Jul 07, 2026

    取得已獲連線授權的 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

    *全部資源。

    *
    • acs:ResourceGroupId
    		 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Lang

    string

    否

    設定請求與接收訊息的語言類型，預設為 zh_cn。 取值：

    • zh_cn：中文（簡體）

    • en_us：英文（美國）

    zh_cn
    Name

    string

    否

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

    data
    ProductId

    integer

    否

    設定資料資產執行個體所屬產品的 ID。您可以透過呼叫 DescribeDataAssets 介面取得產品 ID。

    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"
    }
  ]
}

    錯誤碼

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

    變更歷史

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